CONTEÚDO

01. VISÃO GERAL

O objetivo deste programa é auxiliar na configuração para realizar aa integração entre o ERP Datasul e o serviço Totvs 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 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. 

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

...

-

...

Image Removed

Principais Campos e Parâmetros

...

Botão para iniciar o processo de validação do servidor RPW:

• Será criado um pedido de execução
• Após a execução do pedido de execução os itens de 'Pré-requisitos' serão alterados conforme resultado da execução.

O botão ficará desabilitado nas seguintes ocasiões:

• Não há nenhum servidor RPW selecionado no zoom
• Há uma validação em andamento.

...

Requisito a ser verificado. Possíveis valores: 

• Não validado: indica que ainda não foi executada a verificação dos pré-requisitos
• Sucesso: indica que foi executada a verificação dos pré-requisitos e o servidor RPW atende a versão mínima do Progress para execução da integração
• Falhou: indica que foi executada a verificação dos pré-requisitos e o servidor RPW não possui a versão mínima do Progress para execução da integração, será necessário atualizar a versão do Progress utilizado pelo servidor RPW. Clique para obter mais detalhes do erro.

...

Requisito a ser verificado. Possíveis valores:

• Não validado: indica que ainda não foi executada a verificação dos pré-requisitos
• Sucesso: indica que foi executada a verificação dos pré-requisitos e o servidor RPW possui no seu propath todas bibliotecas exigidas para realização da integração.
• Falhou: indica que foi executada a verificação dos pré-requisitos e o servidor RPW não possui no seu propath todas bibliotecas exigidas para realização da integração. Será necessário ajustar o propath do servidor RPW com as bibliotecas necessárias, que podem ser consultadas neste documento. Clique para obter mais detalhes do erro.

...

Requisito a ser verificado. Possíveis valores:

• Não validado: indica que ainda não foi executada a verificação dos pré-requisitos
• Sucesso: indica que o ambiente possui instalado o Gzip
• Falhou: indica que o ambiente não possui instalado o Gzip, será necessário instalar pois o programa é necessário para execução da integração. Clique para obter mais detalhes do erro.

Mais informações a respeito do Gzip, consulte a documentação oficial do projeto Gzip.

...

Requisito a ser verificado. Possíveis valores:

• Não validado: indica que ainda não foi executada a verificação dos pré-requisitos
• Sucesso: indica que a aplicação dos certificados foi realizada com sucesso
• Falhou: indica que não foi possível realizar a aplicação dos certificados. Clique para obter mais detalhes do erro.

Mais informações sobre aplicação de certificados podem ser consultadas neste documento. 

...

Requisito a ser verificado. Possíveis valores:

• Não validado: indica que ainda não foi executada a verificação dos pré-requisitos
• Sucesso: indica que foi possível conectar com as url's que serão utilizadas na integração com sucesso
• Falhou: indica que houve algum bloqueio na conexão com alguma url que será utilizada na integração. Clique para obter mais detalhes do erro.

Parametrizações

Image Added

04. TELA - Parametrizações

Image Removed

Principais Campos e Parâmetros

...

04.

...

TELA -

...

Jornalização

...

Image Added

Principais Campos e Parâmetros

05. TELA - Sincronização

Image Added

Principais Campos e Parâmetros

06. TELA - Conclusão

Principais Campos e Parâmetros

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 (Tomcat) ou deploy/datasul-byyou-11.5.X-SNAPSHOT.ear (Jboss);Caso seja Jboss, verificar se o totvs-fnd-wizard foi configurado corretamente nos arquivos deploy/datasul-byyou-11.5.X-SNAPSHOT.ear/META-INF/application.xml e conf/josso-agent-config.xml;

• application.xml deve conter o seguinte conteúdo dentro da tag <application>

  Bloco de código
  theme RDark
  <module> <web> <web-uri>totvs-fnd-wizard.war</web-uri> <context-root>totvs-fnd-wizard</context-root> </web> </module>

• conf/josso-agent-config.xml deve conter o seguinte conteúdo dentro da tag <partner-apps>

  Bloco de código
  theme RDark
  <partner-app> <context>/totvs-fnd-wizard</context> </partner-app>

• Reiniciar o servidor apagando os arquivos temporários:
  
  • log;
  • temp (Tomcat)tmp (Jboss);
  • 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 maquinas máquinas onde será necessário realizar a conexão com os serviços da carolCarol.

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:
  • <diretorio_instalação_progress>\gui\OpenEdge.BusinessLogic.pl;
  • <diretorio_instalação_progress>\gui\OpenEdge.Core.pl;
  • <diretorio_instalação_progress>\gui\OpenEdge.ServerAdmin.pl;
  • <diretorio_instalação_progress>\gui\netlib\OpenEdge.Net.pl.

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.