Histórico da Página
| Índice |
|---|
CONTEÚDO
- Visão Geral
- Configuração passo a passo
- Assistente de ativação / desativação do processo
- Como Funciona
- Visualização de Log
- Habilitar log TLC
- Mecanismo de execução da integração com o TLC
01. VISÃO GERAL
A partir da versão 12.1.28 é possível realizar a integração do RM com o TOTVS App (Carol).
...
| Informações | ||
|---|---|---|
| ||
Para a ativação da integração funcionar corretamente em bases Oracle é necessário ter a versão igual ou superior ao Oracle12.2. |
02. CONFIGURAÇÃO PASSO A PASSO
É necessário que o ambiente possua ao menos um JobServer no ambiente para que a integração seja habilitada. TDN : https://tdn.totvs.com/x/Gy8ZE |
02. CONFIGURAÇÃO PASSO A PASSO
Existem 2 formas de integrar o RM ambiente com Existem 2 formas de integrar o RM ambiente com o TOTVS App.
Primeira: Com a ativação baseada no Client Id e Client Secret do RAC. Dessa forma é necessário um ambiente provisionado (RAC ou Carol). Esta é a opção indicada para novas integrações.
...
.Arquivo de configuração do projeto
| Aviso | ||
|---|---|---|
| ||
A partir da versão 12.1.34, a rotina de agendamento(ScheduleInfo), somente irá realizar o download dos arquivos de configurações quando houver alteração em pelo ao menos um arquivo de conceito. Essa nova funcionalidade visa economizar download desnecessário, quando não há mudanças. |
Será disponibilizado um modelo de arquivo de configuração Json do projeto. Esse arquivo deve ter obrigatoriamente o nome de “totvsAppConfig.json”. Ele deve ser copiado para o mesmo caminho de Será disponibilizado um modelo de arquivo de configuração Json do projeto. Esse arquivo deve ter obrigatoriamente o nome de “totvsAppConfig.json”. Ele deve ser copiado para o mesmo caminho de rede descrito acima.
O correto preenchimento do mesmo é muito importante para o funcionamento do processo. Segue abaixo uma explicação de cada item da configuração:
...
a) ConceptID: guid contendo a identificação única do conceito. Com esse atributo, poderemos resolver a situação de um conceito ser utilizado por várias integrações (businessDomain). Daí ele será executado apenas uma única vez. Ex: conceito para exportação de dados da GColigada/GFilial.
b) ConceptFileName: Nome físico do arquivo de conceito “*.concept” gravado no caminho de rede compartilhado. Esse nome tem que ser exatamente igual, contendo a extensão.
ex: "ConceptFileName": "ExportacaoFuncionarios.concept",
c) ConceptVersion: guid representando a versão do arquivo de conceito. Se o conceito sofrer alguma alteração que necessita do mesmo ser baixado novamente, esse guid deverá ser modificado. (essa opção ainda não está sendo usada pelo processo)
d) ProcessingDependency: Ordem de dependência de execução dos conceito. Ou seja, o processo não poderá executar o conceito “A” se o conceito “B” não for executado com sucesso. (essa opção ainda não está sendo usada pelo processo)
03. ASSISTENTE DE ATIVAÇÃO / DESATIVAÇÃO DO PROCESSO
Permissão no item de menu
No RM, acesse a opção “Serviços globais / Perfis / Integração” e forneça as permissões para o perfil do usuário em questão.
...
Selecione o sistema “Integração / Totvs App / Ativação Totvs App” e verifique se o item de menu está habilitado.
Processo de ativação
Nos patches mais recentes são disponibilizados duas formas de autenticação no ambiente: Credenciais do RAC ou credenciais da Carol. Apenas 1 mecanismo de autenticação deve ser utilizado.
...
Na versão 12.1.28 está disponível apenas a integração com o "Consignado". A partir da versão 12.1.29 está disponível também o "Antecipa".
| Informações | ||
|---|---|---|
| ||
A partir da versão 12.1.33.295 também estará disponível a integração com o Painel Financeiro. |
Para Para configuração das credenciais da Carol:
...
| Aviso | ||
|---|---|---|
| ||
Após ativar a integração um serviço de monitoramento da saúde do processo será disparado com o intuito de manter o processo da integração executando de acordo com a configuração de periodicidade. Ver mais em: Serviço De Monitoração Da Saúde Da Integração RM x TOTVS App |
Processo de desativação
Após ativado, o usuário poderá a qualquer momento desativar o processo conforme opção abaixo:
...
- As informações das tabelas “GTOTVSAPP, GTOTVSAPPCONCEITO, GTOTVSAPPCONCEITOHST e GTOTVSAPPLOG " serão excluídas da base;
- O Job Executor do processo será finalizado e excluído;
- As tabelas de softDelete não serão mais alimentadas com informações de deleção.
| Aviso | ||
|---|---|---|
| ||
|
04. Como Funciona
Através da ferramenta de Conceito o RM envia para a Carol (Inteligência artificial da TOTVS) informações chaves baseadas nas configurações dos conceitos de cada integração.
Após a ativação da integração o processo ConTotvsAppActivatorProcess que configura a integração será disparado.
Após a execução do processo que configura a integração será iniciado o processo que Executa a integração ConTotvsAppExecutorProcess.
|
04. Como Funciona
Através da ferramenta de Conceito o RM envia para a Carol (Inteligência artificial da TOTVS) informações chaves baseadas nas configurações dos conceitos de cada integração.
Após a ativação da integração o processo ConTotvsAppActivatorProcess que configura a integração será disparado.
Após a execução do processo que configura a integração será iniciado o processo que Executa a integração ConTotvsAppExecutorProcess.
| Aviso | ||
|---|---|---|
| ||
Pelo fato da integração ser executada através de processos, os processos ConTotvsAppActivatorProcess e ConTotvsAppExecutorProcess NÃO podem ser manipulados pelo usuário. | ||
| Aviso | ||
| ||
Pelo fato da integração ser executada através de processos, os processos ConTotvsAppActivatorProcess e ConTotvsAppExecutorProcess NÃO podem ser manipulados pelo usuário. Os menus Iniciar / Parar / Desabilitar / Reiniciar da visão de gerenciamento de Job's foram desativados. Os WebServices que Executam / Agendam processos também foram bloqueados. A atividade ExecutarProcesso da Fórmula Visual também foi bloqueada para não permitir a execução dos processos citados. |
Caso o ambiente utilizado seja um ambiente 3 Camadas, o O processo será recorrente de acordo com a configuração de periodicidade utilizada no arquivo totvsAppConfig.json.
Caso o ambiente utilizado seja um ambiente Local, o processo não será recorrente porém o serviço de monitoramento da saúde do processo irá executar o processo em horários bem próximo da configuração de periodicidade.
| Informações | ||
|---|---|---|
| ||
Para entender como funciona o serviço de Monitoramento da saúde do processo acesse : https://tdn.totvs.com/x/27EMIg |
05. VISUALIZAÇÃO DE LOG
Na tabela GTOTVSAPPLOG é armazenado o log detalhado de cada execução dos conceitos e envios cadastrados na tabela GTOTVSAPPCONCEITOHST.
...
Para analisar os registros da tabela de log, é importante filtrar a busca pela chave GTOTVSAPPLOG.IDTOTVSAPPCONCEITOHST, relacionada a coluna GTOTVSAPPCONCEITOHST.ID
06. HABILITAR TLS
Em alguns casos é necessário ajustar o TLS do servidor.
Para ajustar basta criar um arquivo com a extensão .Reg e escrever o comando abaixo. Após criar o arquivo basta executar.
Importante que todos os servidores que processam Jobs estejam com essa configuração.
| Aviso | ||
|---|---|---|
| ||
| Aviso | ||
| ||
Antes de Executar é importante fazer o backup das todas as chaves descritas no bloco de código. |
| Bloco de código |
|---|
Windows Registry Editor Version 5.00
; 0x00000008 Habilitar o SSL 2.0 por padrão
; 0x00000020 Habilitar SSL 3.0 por padrão
; 0x00000080 Habilitar TLS 1.0 por padrão
; 0x00000200 Habilita o TLS 1.1 por padrão
; 0x00000800 Habilitar TLS 1.2 por padrão
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp]
"DefaultSecureProtocols"=dword:0x00000800
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp]
"DefaultSecureProtocols"=dword:0x00000800
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client]
"DisabledByDefault"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server]
"DisabledByDefault"=dword:00000000 |
Ferramentas de teste de solução de problemas de conexão SSL / TLS (Totvs App precisa de TLS1.2 handshake)
Existe um troubleshooting da Microsoft abordando diversas formas de se testar a comunicação:
Utilizando CURL
curl -v https://endpoint-registry.dev.totvs.app/api/v1/services --tlsv1.0
curl -v https://endpoint-registry.dev.totvs.app/api/v1/services --ciphers ECDHE-RSA-NULL-SHA --tlsv1.2
Resposta esperada (Sucesso)
...
07. MECANISMO DE EXECUÇÃO DA INTERGRAÇÃO COM O TLC
O campo "IDJOB" já existente na tabela "GTOTVSAPP" é responsável em fazer a subida dos dados para Carol (busca do RM e envia para Carol).
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas