Versões comparadas

Chave

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

...

02. CONFIGURAÇÃO PASSO A PASSO 

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.

Segunda: Com ativação baseada nas credenciais da Carol.

Os passos descritos abaixo, dentro do tópico 2,  são necessários apenas se a ativação usar as credenciais da Carol. Caso contrário, o arquivo de configuração será obtido automaticamente pelo sistema e não é necessário alterar os configs do ambiente.

Configuração do RM.Host .Host.exe.config (Ativação baseada nas credenciais da Carol)

Nos arquivos de configuração do host (RM.Host.exe.config, RM.Host.Service.exe.config), adicione a TAG “FileServerPath”. Essa deverá apontar para um caminho compartilhado na rede, conforme abaixo:

...

Verifique se o serviço do Host possui permissão de leitura nesse caminho compartilhado


Cópia dos arquivos de Conceito

Todos os arquivos de conceito, com extensão “*.concept” disponíveis no projeto, deverão ser copiados para esse diretório compartilhado. O configurador fará automaticamente o download desses arquivos e os mesmos serão gravados na tabela GTOTVSAPPCONCEITO.CONCEITO.

Obs.: A partir dos patches mais recentes das versões 12.1.28 e 12.1.29 não é necessário deixar os conceitos nesse diretório, pois serão obtidos automaticamente pelo sistema.


Arquivo de configuração do projeto

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.

...

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".

Para configuração das credenciais da Carol:

  • Informe o endereço da Carol:
    ex: https://totvstechfindev.carol.ai/
  • Informe o Id do Connector da Carol:
    ex: 09ddb0e29e604e599a1356dab2f89df9
  • Informe o token da Carol: Esse token, deverá ser recuperado do ambiente Carol, conforme este link.

Para configuração das credenciais do RAC, os dados da Carol não precisam ser preenchidos, pois o sistema usará a autenticação RAC para buscar as credenciais da Carol. 

...

  • Será gravada uma linha na tabela GTOTVSAPP contendo informações globais de da configuração.
  • Os conceitos disponíveis no caminho de rede ou obtidos pelo sistema de forma automática e que estão mapeados no arquivo de configuração serão baixados e gravados na tabela “GTOTVSAPPCONCEITO”;
  • Será criado um Job agendado e recorrente para execução conforme informações de agendamento disponíveis no arquivo de config;
  • As stored Procedures de softDelete serão executadas para as tabelas mapeadas para criação automática das estruturas de softDelete;
  • As tabelas mapeadas serão atualizadas na colulna “RECMODIFIEDON” para a data “1900/01/01” em caso de possuir o valor null;

...

  • Os conceitos serão executados e os dados serão enviados para Carol conforme definido nos conceitos;
  • Será gravada uma linha na tabela “GTOTVSAPPCONCEITOHST” conforme informações de execução de cada conceito (sucesso ou erro e mensagem de erro);
  • Em caso de sucesso, a coluna “GTOTVSAPPCONCEITOHST.DATAULTEXEC” será atualizada para a data de início da execução do processo
  • O status da execução pode ser consultado também na coluna “GTOTVSAPPCONCEITOHST.STATUS” (1 - sucesso, 2 - falha, 0 - não executado). E na coluna "GTOTVSAPPCONCEITOHST.MENSAGEM" a mensagem do erro ou de sucesso.


Aviso
titleAtenção

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:

...

Através da ferramenta de Conceito o RM envia para a CarolCarol (Inteligência artificial da TOTVS) informações chaves baseadas nas configurações dos conceitos de cada integração.

...