Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

Índice
minLevel2

01. VISÃO GERAL

O objetivo deste programa é auxiliar na configuração para realizar aintegraçã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. 


Informações

É 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

 necessário que o servidor RPW onde será executada a Sincronização de dados Datasul x

Totvs

TOTVS Apps

 não

não tenha execuções pendentes ou em andamento em sua

fila e;Que os bancos de dados que serão integrados estejam disponiveis para receber alterações em sua estrutura: os bancos devem estar em execução mono usuá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

fila para que o assistente de configuração possa ser executado de forma ágil em todas as etapas.

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.

...

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

...

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

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

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

Parametrizações

Image Added

Nota
titleDiretório Spool

O diretório spool do servidor RPW deverá ser uma pasta compartilhada acessível pelo AppServer Progress. Este compartilhamento é necessário porque o arquivo gerado com os dados da validação do ambiente será processado pelo servidor de aplicação.

04. TELA - Parametrizações

Image Removed

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 deverá ser feita utilizando o Openedge CDC ou por meio de Triggers. Para os ambientes que utilizam dataserver, apenas o tipo TRIGGER estará disponível
Administrador do banco de dadosTable owner das tabelas do banco de dados, geralmente as tabelas são relacionados ao owner PUB
(disponível apenas para ambientes Progress).
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

...

Image Added


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

Image Added


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
Abrir manutenção da base de dadosAbre o programa AU0001 Manutenção Base Dados. 
Abrir geração de triggersAbre o programa AU0108 Geração de Triggers.
Abrir agenda automáticaAbre o programa CD8600 Agenda automática.
Abrir sincronizador de dadosAbre o programa AU0109 Sincronização de dados Datasul x Totvs Apps.

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 (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;
  • 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

  • Eexecutar 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:

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;
  • 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 tab_sincroniz_plataf (tabela com as informações de quais tabelas e bancos devem ser integrados);
  • 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 incluido ao nome logico. Ex: movind → shmovind.

As triggers foram geradas mas não foram aplicadas

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
  • Verificar se a licença do client onde está sendo aplicada a alteração na estrutura de bancos é compativel com a necessária (OE Studio);
  • Verificar se usuário que está aplicando as modificações tem permissão para modificar a estrutura dos bancos.