Histórico da Página
CONTEÚDO
Índice | ||
---|---|---|
|
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.
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árionecessário que o servidor RPW onde será executada a Sincronização de dados Datasul x Totvs nãonã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
...
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
...
Nota | ||
---|---|---|
| ||
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. |
...
.
...
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.
TELA - Parametrizações
Principais Campos e Parâmetros
Campo | Descriçã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 monitoramento | A 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 dados | Table owner das tabelas do banco de dados, geralmente as tabelas são relacionados ao owner PUB |
(disponível apenas para ambientes Progress). | |
Data area | Nome definido como padrão para as Data Areas destinadas ao CDC. |
Index area | Nome definido como padrão para as Index Areas destinadas ao CDC . |
Integração | |
Tipo de ambiente TOTVS Apps | Tipo de ambiente utilizado para a integração. |
Client Id do Rac | client oAuth para a autenticação no RAC (necessário que seja um client oAuth e tenha permissão Resource Owner);. |
Secret do Rac | Senha do client oAuth;. |
...
04.
...
TELA -
...
Jornalização
...
Principais Campos e Parâmetros
Campo | Descriçã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ção | Abre o programa Monitor Pedido Execução |
05. TELA - Sincronização
Principais Campos e Parâmetros
Campo | Descriçã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 agendamento | Permite consultar o resultado da criação do pedido de cada uma das empresas |
Abrir manutenção da base de dados | Abre o programa AU0001 Manutenção Base Dados. |
Abrir geração de triggers | Abre o programa AU0108 Geração de Triggers. |
Abrir agenda automática | Abre o programa CD8600 Agenda automática. |
Abrir sincronizador de dados | Abre o programa AU0109 Sincronização de dados Datasul x Totvs Apps. |
06. TELA - Conclusão
Principais Campos e Parâmetros
Campo | Descrição |
---|---|
Concluir | Finaliza 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:
- <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;
- Avaliar o clientid e clientsecret do Totvs Rac estão corretos;
- 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.
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.