Árvore de páginas

CONTEÚDO

01. VISÃO GERAL

O objetivo deste programa é auxiliar na configuração para realizar a integração entre o ERP Datasul e o serviço TOTVS Apps (Plataforma TechFin).

O assistente de configuração auxiliará:

  • Na verificação de pré-requisitos para realizar a integração;
  • Na configuração dos dados referente ao TOTVS Apps;
  • Na configuração dos dados referente ao tipo de monitoramento utilizado;
  • Na ativação do monitoramento de dados;
  • Na criação e execução de uma agenda para realização da integração. 


É importante salientar as seguintes informações para que o assistente de configuração possa ser executado de forma ágil em todas as etapas:

  • É necessário que o servidor RPW onde será executada a Sincronização de dados Datasul x TOTVS Apps não tenha execuções pendentes ou em andamento em sua fila e;
  • Caso a jornalização seja feita com trigger é importante que os bancos de dados que serão integrados estejam disponíveis para receber alterações em sua estrutura: os bancos devem estar em execução monousuário ou, caso estejam servidos, nenhuma outra sessão poderá estar conectada ao banco no momento em que será executada a Geração de Triggers

02. EXEMPLO DE UTILIZAÇÃO

Para acessar o assistente de configuração, no menu, pesquise por "ConfigAppsWizard". O programa aparecerá na aba "Tarefas", para acessá-lo, basta clicar no programa e em seguida no botão "Executar". 

03. TELA - Parametrizações

Principais Campos e Parâmetros

CampoDescrição
Avançar Botão para avançar para o próximo passo do assistente de configuração. O botão somente ficará habilitado quando todos campos obrigatórios estiverem preenchidos.
Jornalização
Tipo de monitoramentoA jornalização dos dados pode ser feita utilizando o Openedge CDC ou por meio de Triggers. Para os ambientes que utilizam dataserver, apenas o tipo TRIGGER estará disponível. Para os ambientes que utilizam banco de dados Progress, apenas o tipo CDC estará disponível.
Data areaNome definido como padrão para as Data Areas destinadas ao CDC.
Index areaNome definido como padrão para as Index Areas destinadas ao CDC.
Integração
Tipo de ambiente TOTVS AppsTipo de ambiente utilizado para a integração.
Client Id do Racclient oAuth para a autenticação no RAC (necessário que seja um client oAuth e tenha permissão Resource Owner).
Secret do RacSenha do client oAuth.

04. TELA - Jornalização

04.2 Caso o tipo de monitoramento seja Trigger:

Principais Campos e Parâmetros

CampoDescrição
Avançar Botão para avançar para o próximo passo do assistente de configuração. 
Servidor RPW

Zoom para seleção do servidor RPW que será realizada a execução do programa AU0108 - Geração das Triggers

Validação dos bancos de dados

Ao clicar em 'Executar' realiza o cadastro dos bancos necessários para geração de triggers no Audit Trail. O cadastro pode ser revisado através do programa AU0001 Manutenção Base Dados. 

Importante

Esta opção só estará disponível caso o tipo de Jornalização selecionado no passo anterior seja 'Trigger'.

Criação de pedido de geração de triggers/policies

Ao clicar em 'Executar' será criado um pedido de execução para o programa AU0108 - Geração das Triggers.

Acesse o programa Monitor Pedido ExecuçãoAbre o programa Monitor Pedido Execução


04.2 Caso o tipo de monitoramento seja CDC:


Principais Campos e Parâmetros

CampoDescrição
Avançar Botão para avançar para o próximo passo do assistente de configuração.
Servidor RPW

Zoom para seleção do servidor RPW que será realizada a execução do programa AU0110RP (Geração de policies)

Executar - AU0110RP

Ao clicar em 'Executar' será criado um pedido de execução para o programa AU0110RP (Geração de policies)

Acesse o programa Monitor Pedido ExecuçãoAbre o programa Monitor Pedido Execução


05. TELA - Sincronização


Principais Campos e Parâmetros

CampoDescrição
Avançar Botão para avançar para o próximo passo do assistente de configuração
Servidor de execução

Zoom para seleção do servidor que será responsável pela execução do programa AU0109.

Será apresentado um zoom para seleção, para cada empresa vinculada ao usuário.

Executar - AU0109

Ao clicar em 'Executar' serão criados agendamentos automáticos recorrentes de pedidos de execução para o programa AU0109 para cada uma das empresas que serão integradas.

Resultado agendamentoPermite consultar o resultado da criação do pedido de cada uma das empresas

06. TELA - Conclusão

Principais Campos e Parâmetros

CampoDescrição
ConcluirFinaliza o assistente de configuração retornando ao passo inicial. 

07. FAQ

O assistente não aparece no menu

  • Verificar se os arquivos de menu foram importados corretamente - o assistente está no arquivo men_btb.d;
  • Verificar, no cadastro de programas, se o programa ConfigAppsWizard está com a flag visualiza menu marcada;
  • Verificar, no cadastro de procedimentos, se o procedimento ConfigAppsWizard está com a flag visualiza menu marcada;
  • Verificar as permissões do programa x grupos de usuário e usuário x grupo de usuário;
  • Executar o mer010aa se necessário.

O assistente aparece no menu mas não abre

  • Verificar se o arquivo totvs-fnd-wizard.war está disponível na pasta webapps;
  • Reiniciar o servidor apagando os arquivos temporários:
    • log;
    • temp;
    • work.

Não foi possível importar os certificados utilizando o assistente

  • Executar o processo manual de importação de certificados:
    • Acessar o proenv e, utilizando o comando 'certutil -format PEM -import <filename>', importar cada um dos certificados da pasta unividata/certs nas máquinas onde será necessário realizar a conexão com os serviços da Carol.

A versão do openedge é inferior a 11.7.5

  • Proceder com a atualização da versão do openedge conforme orientação da progress.

O propath não passou na validação

  • Disponibilizar as seguintes bibliotecas do Progress Openedge 11.7.5 ou superior no início do propath dos clients que deverão realizar a integração ou acessar qualquer um dos serviços:

As triggers não foram geradas

  • Avaliar no clientlog se não houve nenhum erro na conexão com os serviços do TOTVS Apps:
    • Caso haja o erro "unable to get local issuer certificate" deve-se executar, na maquina onde está sendo executado o au0108 o processo de importação manual citado anteriormente.
  • Avaliar o clientid e clientsecret do Totvs Rac estão corretos nas configurações de Integração (Propriedades do Sistema > Propriedades Integrações TOTVS);
  • Avaliar se os dados foram atualizados na tabela mgadt.tab_sincroniz_plataf (tabela com as informações de quais tabelas e bancos devem ser integrados):
    • Caso a tabela não possua dados, verifique se existem mensagens de erro no arquivo de resultado da execução de geração de triggers, pois isto indica que houve falha na recuperação das tabelas integradas.
  • Avaliar as configurações de bancos do audit trail considerando:
    • Os bancos unificados deverão ser configurados separados por alias e, caso seja necessária a auditoria além da integração, o cadastro de monitoramento de tabelas/ atributos - AU0002 - Monitoramento de Tabelas/Atributos deverá ser aplicada ao banco (alias) correspondente à tabela;
    • Caso hajam bancos cadastrados pelo alias:
      • Todos os bancos lógicos relacionados ao mesmo banco físico devem ter suas triggers geradas ao mesmo tempo, em uma mesma execução, para evitar a exclusão involuntária de arquivos;
      • Para evitar que a atribuição das triggers às tabela sejam excluídas involuntariamente, no cadastro dos bancos auditáveis - AU0001 - Manutenção Base de Dados, a opção ' Incorpora Base de Dados ao diretório de Triggers' não poderá ser utilizada.
    • Os bancos devem ser cadastrados com o alias relativo a tabela integrada informado no campo nome lógico do cadastro dos bancos auditáveis. Caso o banco seja Oracle ou SQL Server, o prefixo sh deve ser incluído ao nome logico. Ex: movind → shmovind.

As triggers foram geradas mas não foram aplicadas

  • Verificar se a licença do client onde está sendo aplicada a alteração na estrutura de bancos é compatível com a necessária (OE Studio);
  • Verificar se a pasta onde foram gerados as triggers está listada no propath;
  • Verificar se usuário que está aplicando as modificações tem permissão para modificar a estrutura dos bancos.

Como limitar a integração de empresas? 

  • Serão integradas as empresas as quais o usuário que criou o pedido de execução tenha acesso; 
  • Para incluir ou excluir uma empresa do processo de integração, basta incluir/ remover o relacionamento do usuário com a empresa no cadastro de usuários - Manutenção de Usuário (SEC000AA);
  • O processo de integração não realiza o filtro nas tabelas, sendo assim, tabelas multi empresas serão integradas por completo. Fica a cargo do processo de ETL na Carol desconsiderar os dados de empresas não integradas.

Ocorre o erro 7328 - banco campo must be a quoted constant or an unabbreviated, unambiguous buffer/field reference durante Sincronização Totvs Apps x Datasul (AU0109)

  • Caso ocorra a mensagem acima, verificar se a tabela a ser sincronizada está associada ao banco informado como alias. Caso não esteja, avaliar juntamente à equipe do Totvs Apps a correção do cadastro.