Manual de Instalação do TOTVS Performance & Gestão (TPG) v4.1+

CONTEÚDO

01. VISÃO GERAL

Esta seção é dedicada a instalação e configuração do produto TOTVS Performance & Gestão. Você encontrará um passo a passo completo da instalação e configuração do produto, além dos requisitos mínimos necessários para o funcionamento.

O download do client, portais de administração e locais de instalação podem variar de acordo com o produto utilizando o TOTVS P&G.

02. REQUISITOS

A. Requisitos de Software

Software	Versão
Windows	Windows 7 ou maior - 64/32 bits
.Net Framework	= 4.6.1
Banco Oracle	11g ou superior

B. Pastas e Arquivos de Instalação

Pasta do Serviço: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico

Logs do Serviço: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Logs\Serviço

Logs do Client (para fins de debug): C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Client\Logs

Logs dos Clientes: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Logs\<Numero Identificador do Cliente>\recente.log

Logs Antigos dos Clientes: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Logs\<Numero Identificador do Cliente>\arquivado\<data.hora-minuto-segundo>.log

Arquivo de Configuração (criptografado): C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Config.json

Arquivo para Importação de Dados via Comando/Integração: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico\Empresas.json

03. GUIA DE INSTALAÇÃO

A. Instalação Via Instalador

Primeiramente, execute o instalador do TOTVS P&G, conforme a imagem abaixo:

2. Após executado, selecione a opção "Eu aceito o acordo" e, em seguida, clique em avançar.

3. Caso tenha a necessidade de importar as empresas cadastradas no Client antigo, marque a caixa e clique em avançar.

4. Tendo finalizado a etapa anterior, basta clicar no botão instalar para iniciar a instalação.

5. Após iniciado a instalação, uma barra de progresso irá aparecer como mostrado na figura abaixo.

OBS: Caso a máquina possua uma versão do .Net Framework inferior à 4.6.1 (ou não possua o software instalado), o instalador realizará o download e a instalação da versão automaticamente.

6. Tendo finalizado a instalação, basta clicar em concluir que o programa será inicializado.

7. Um ícone do produto será gerado em sua Área de Trabalho, que poderá ser executado após a instalação (caso opte por não inicializar ao término da instalação).

8. Ao término do processo de instalação, o Client será inicializado, como na interface abaixo.

OBS: Caso tenha optado por trazer as empresas cadastradas no passo 3, as empresas deverão aparecer listadas no Client.

OBS: Caso seja uma migração, o client antigo vai ser fechado, seus dados migrados e a pasta do client antigo vai ser renomeada para C:\PC Sistemas\myAudit\Client_OLD. É importante conferir se a pasta do client antigo foi renomeada pelo novo client pois dependendo das permissões do sistema, pode ser que a pasta não tenha sido renomeada, fazendo com que o client antigo cause conflito com o client novo.

B. **Instalação Via Linha de Comando (recomendado para cloud)**

Argumentos	Funcionalidade
/SILENT	Instalação com o mínimo de configurações visuais
/VERYSILENT	Instalação sem nenhuma informação visual
/LOG	Força a criação de log de instalação na pasta temp do usuário
/LOG="filename"	Criar arquivos de log de instalação com nome e local especifico

Para realizar a instalação via linha de comando, primeiramente baixe o executável do instalador e o execute via PROMPT passando os argumentos desejados. Por Exemplo:

c:\temp\Setup TOTVS Performance & Gestão - Client e Serviço.exe /SILENT /LOG=c:\temp\filename.txt

C. Importar Configuração Padrão Durante a Instalação

É possível instalar e importar uma configuração padrão, preenchendo o arquivo "Empresas.json" com as informações da empresa, e o arquivo "Config.json" com as informações de banco de dados (ambos fornecidos como templates para preenchimento) e colocando eles junto ao arquivo de instalação antes de iniciar a instalação.

Arquivo Empresas.json:

Arquivo Config.json:

OBS: O arquivo config.json só será importado caso não haja nenhuma empresa cadastrada anteriormente.

Ou tudo através do arquivo Empresas.json para empresa e banco de dados:

[
  {
    "CNPJ": "00.000.000/0000-00",
    "MaxRegistros": 1000,
    "Razao": "NOME DA RAZÃO SOCIAL",
    "Telefone": "(11) 90000-0000",
    "Ativo": true,
    "Email": "[email protected]",
    "Proxy": null,
    "isCloud": false,
    "BancoDeDadosCliente": {
      "sId": false,
      "Usuario": "usuario",
      "Banco": "192.00.00.00",
      "Senha": "senha",
      "Servico": "ORCL",
      "Porta": 1521,
      "WebService": "http://localhost:0000"
     }
   }
]

OBS: As empresas presentes no arquivo Empresas.json serão importadas independente de haver empresas cadastradas ou não.

OBS: Em caso de erro na importação, o arquivo "Empresas.json" continuará com as informações da empresa. Caso a importação tenha sido feita com sucesso, o arquivo ficará "em branco".

04. GUIA DE CONFIGURAÇÃO

Após ter realizado a instalação do P&G agora só falta configurar o client para fazer a utilização do produto TOTVS Performance & Gestão.

A. Configuração Visual

Tendo o Client inicializado, caso não haja uma empresa cadastrada ou deseje adicionar novas empresas, clique no botão "Adicionar Empresa" para cadastrar uma empresa no do sistema.

2. Preencha os campos indicando o usuário do banco, senha, IP, Porta e o Serviço para conexão com o banco de dados e clique em "Avançar".

3. Caso o banco não esteja disponível no momento da instalação, o alerta abaixo irá aparecer, basta clicar em "Sim" caso queira continuar com o processo.

4. Informe o endereço do webservice e o tempo de atualização dos dados do P&G Client, após isso, clique em "Avançar".

5. Informe o CNPJ da sua empresa para que o P&G Client busque e valide sua licença (Após preencher o CNPJ clique no campo ao lado, para que ele preencha automaticamente os outros campos), clique em "Salvar".

6. Tendo finalizado o processo, as informações da empresa ficarão dispostas na tela inicial, podendo ser editada, desativada/ativada, removida e tendo os logs exibidos.

OBS: Caso as informações estejam corretas e a empresa ativa, a sincronização iniciará imediatamente podendo ser acompanhada pela coluna PAs.

B. Configuração por Arquivo

A configuração por arquivo é feita escrevendo-se os dados da(s) empresa(s) diretamente no arquivo Empresas.json após a instalação e com o serviço já em execução.

O arquivo Empresas.json encontra-se na pasta de instalação do serviço (podendo estar em outros locais caso necessário), no seguinte local: C:\Program Files (x86)\TOTVS Performance e Gestao\Servico.

O arquivo Empresas.json deve ter a estrutura abaixo:

[
  {
    "CNPJ": "00.000.000/0000-00",
    "MaxRegistros": 1000,
    "Razao": "NOME DA RAZÃO SOCIAL",
    "Telefone": "(11) 90000-0000",
    "Ativo": true,
    "Email": "[email protected]",
    "Proxy": null,
    "isCloud": false,
    "BancoDeDadosCliente": {
      "sId": false,
      "Usuario": "usuario",
      "Banco": "192.00.00.00",
      "Senha": "senha",
      "Servico": "ORCL",
      "Porta": 1521,
      "WebService": "http://localhost:0000"
     }
   }
]

Importante: TODOS valores devem ser substituídos pelos valores da empresa. NENHUM dado pode ficar em branco e principalmente o EMAIL e o CNPJ devem estar corretos pois estes são chaves no banco de dados.

Após a inclusão dos dados neste arquivo, o serviço do windows com nome TOTVS P&G deve ser reiniciado para que a importação seja feita e a sincronização iniciada.
A importação com sucesso pode ser confirmada:
1. Validando se o arquivo Empresas.json ficou vazio após reiniciar o serviço;
2. Validando se a empresa em questão apareceu no portal Admin do TOTVS P&G;
3. Abrindo o client e validando se a empresa apareceu e se a quantidade de PAs sincronizadas esta subindo ou é maior que 0%;

Árvore de páginas