Integração ERP DATASUL TOTVS

Para que seja possível utilizar a integração do ERP com o TOTVS App, é importante ter atenção para a carga dos certificados que serão responsáveis pela ativação das credenciais para autenticação da plataforma com os serviços utilizados no processo da integração (acesso ao RAC e Carol).  Estas credenciais serão enviadas através de um e-mail de registro dos dados provisionados para a equipe técnica do cliente.

Os certificados precisam ser baixados e importados para o progress através dos passos abaixo descritos neste documento:

Para quaisquer servidores que estejam instalados a equipe técnica deverá:

• Baixar e importar certificados dos serviços
• Acesse os 3 serviços (TOTVS RAC, TOTVS Apps e TOTVS Carol) através do seu navegador e baixe o certificado, faça o mesmo procedimento para os 3 serviços, seguindo os passos abaixo:

1. Acessar em um navegador a URL sugerida para o serviço Carol;
2. Selecionar o ícone de cadeado;

3. Selecionar "O certificado é válido";

4. Na tela que se abre selecionar a aba Detalhes;

5. Em Hierarquia de Certificados selecionar um dos 3 certificados, a mesma operação a partir deste passo deve ser feita para os 3 certificados;

6. Clicar no  botão Exportar;

7. Na janela que se abre vamos salvar o certificado no diretório de sua preferência, o nome do arquivo pode ser alterado, mas atenção para não alterar a extensão do certificado ".crt" ou ".pem". Uma dica é salvar em um diretório mais curto para facilitar os comandos dos passos seguintes;

8. Após fazer este procedimento para os 3 certificados, vamos abrir o proenv em modo administrador.

Para abrir o proenv: Como acessar o Proenv

Ou ainda pode localizar proenv.bat dentro de

mkhashfile

<diretório-instalação-progress>\bin

9. Uma tela DOS deve ser aberta, então execute o comando mkhashfile <diretório-do-certificado>\<nome-certificado> para cada certificado anteriormente salvo;

10. Em seguida execute o comando certutil -import <diretório-do-certificado>\<nome-certificado> para cada certificado anteriormente salvo;

Mais informações sobre importação de certificado: Aplicação de certificados no Progress

Seguir o passo a passo descrito em Configuração Automação de Tarefas Datasul - Novo RPW

Nas propriedades do sistema, localize as Propriedades de integrações TOTVS

Na seção TOTVS Apps marque Habilitar Integração e informe os dados de ClientID do RAC e Secret do RAC fornecidos pela Totvs e salve.

Nas propriedades do sistema, localize as Propriedades de Jornalização e informe os dados conforme orientação do manual

Caso use a opção Triggers siga para Config. Audit Trail, se for utilizar a opção CDC siga para Config. CDC

Configuração do Módulo Audit Trail

No programa AU0009 - Parametrização do Audit Trail informe o servidor RPW configurado no passo anterior.

Figura 12

No programa AU0001 - Manutenção Base de Dados configure as bases de dados necessárias para a integração. Os campos Base Dados, Descrição e Nome Lógico devem ser os mesmos das imagens abaixo.
O valor do campo Nome Físico pode ser encontrado no arquivo de alias no diretório <diretório-instalação>\ERP\scripts-8X80* normalmente nomeado *alias.p, abra o arquivo com um editor de texto e procure por CREATE ALIAS dthrpyc FOR DATABASE, o nome após DATABASE é o valor que usamos no campo Nome Físico. Faça o mesmo para mguni, dthrpmg e dthrgst.

Figura 13

Figura 14

• Executar o programa Geração das Triggers Audit Trail (au0108) para efetuar a criação das Triggers (Create, Write, Delete) vinculadas as tabelas/colunas configuradas anteriormente

  • Os Programas Triggers de Replication gerados devem ser encontrados pelo Propath de todos os ambientes em questão (Client, RPW e AppServer);
  • Pode-se rodar o programa Tabelas/Atributos Monitorados Audit Trail (AU0302) para verificar se os Programas Triggers de Replication foram associadas devidamente no dicionário de dados.

  
  

• Criar um agendamento em Agenda Automática Audit Trail (btb860aa) para que o mesmo seja executado por um servidor RPW.

IMPORTANTE:

• O diretório que está no campo Diretório Triggers, será onde as triggers serão geradas e este diretório deve estar apontado no Propath do servidor RPW e Appserver. Os propaths podem ser alterados nos arquivos .ini do diretório <diretório-instalação>\ERP\scripts-8X80\.
• Para correto funcionamento do módulo Audit Trail no arquivo .pf do appserver e do RPW altere o valor do parâmetro -tok para 32000. Se essa alteração não for feita no próximo passo será apresentado erro em tela.

Seguir os passos da documentação 11. Como Habilitar o OpenEdge CDC (Change Data Capture)

As databases que devem ter o CDC habilitado são mguni, dthrpyc, dthrpmg e dthrgst.

Após habilitar o CDC e configurar os campos Data Area e Index Area em Propriedades de Jornalização, execute o passo em Sincronização de Dados para realizar a integração de dados completa.

Então execute o programa Jornalização - Geração de policy CDC, a partir desse momento os registros que sofrerem alteração serão preparados para integração.

Executar o programa Sincronização de Dados Datasul x Totvs Apps - AU0109, selecione o servidor RPW configurado anteriormente e clique em Executar - AU0109RP;

Instalação/Atualização

Quando houver atualização do produto Datasul deve-se atentar para as seguintes necessidades:

• Quando Jornalização configurado por Triggers, executar novamente a tarefa AU0108 - Geração das Triggers;
• Quando Jornalização configurado por CDC, antes de gerar novas policies, é necessário garantir que os dados estejam integrados executando a tarefa AU0109 - Sincronização de Dados Datasul x TOTVS Apps.