Integrações

Páginas filhas
  • DSDEXPED-14 DT - Rotina para integração com TOTVS Carol

01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Linha Protheus

Segmento:

Backoffice

Módulo:

TOTVS Backoffice (Linha Protheus) - Gestão de Projetos (SIGAPMS)


Função:

FWizardIP - Função para integração com o TOTVS CAROL

País:BRASIL
Ticket:
Requisito/Story/Issue:DSDEXPED-14


02. SITUAÇÃO/REQUISITO

Criar rotina para que seja possível ativar no Protheus a comunicação via smartlink com TOTVS Carol. Necessidade da equipe de iPaaS.

03. SOLUÇÃO

Realizado a criação do wizard FWizardIP() que permite o cliente selecionar as empresas e (client_id e client_secret), e seguir com a criação do job FWTOTVSLINKJOB.

04. DEMAIS INFORMAÇÕES

Esse documento apresenta os passos necessários para ativação da integração de dados do Protheus para plataforma Carol.

Ao adquirir a oferta, internamente será iniciado o fluxo de provisionamento.

Finalizado o fluxo de provisionamento, o cliente recebe por e-mail as credenciais do RAC (client_id e client_secret) necessárias para executar o Wizard de configuração no Protheus.

Será necessária a atualização do ambiente seguindo a ordem descrita nos tópicos abaixo.


02. IMPLANTAÇÃO

Para iniciar a implementação da integração será necessário:

1) Verificar os requisitos mínimos:

Todos os artefatos (DbAccess, APPServer e Lib ) deverão estar atualizados com a última versão disponível no portal.

Release Protheus a partir da 12.1.2310

2) Aplicar a última expedição continua do Protheus, juntamente com o diferencial de dicionário através do UPDDISTR, de acordo com a sua versão da Release.

3) Executar o wizard de acordo com os passos listados no próximo tópico.

4) Ter liberação do servidor onde o schedule do Protheus é executado para os seguintes end-points:

https://endpoint-registry.totvs.app/api/v1/services
https://admin.rac.totvs.app/totvs.rac/connect/token
https://provisioning.totvs.app/api/carol-definitions/v1/entities
https://ingestion-smartlink.totvs.app
https://app.carol.ai
https://provisioning.totvs.app/api/carol-definitions/v1/carolcredentials
https://link.totvs.app
https://api-smartlink.totvs.app

03. WIZARD DE CONFIGURAÇÃO

    Para iniciar o Wizard de configuração, o usuário deverá informar o programa inicial: FWizardIP

    Clicar em Avançar

    Informar um usuário com poder de administrador e marcar as empresas que serão configuradas. Clicar em Avançar.



    Informar credenciais do RAC recebidos por e-mail

    Nesse último passo serão criados os campos de controle de alteração (S_T_A_M_P_) em todas as tabelas de integração.


    04. SCHEDULE

    Após execução do Wizard, o job FWTECHFINJOB de integração com a Carol será cadastrado automaticamente no Protheus.

    Será necessário finalizar as configurações do schedule de ambos os jobs e iniciar o serviço.

    Recorrência de execução

    Para que não haja delay no envio dos dados para a Carol  a Recorrência do job poderá ser cadastrada como 'Sempre ativo'; entretanto, não há uma regra quanto ao cadastro da recorrência da execução, a decisão quanto a isso depende da necessidade de disponibilidade desses dados, a partir do momento de geração deles. 
    Quanto maior a recorrência e empresas/filiais listadas para execução, maior a necessidade de recursos para processamento dos jobs.

    Schedule - Como agendar a execução de rotinas

    05. LOG DA INTEGRAÇÃO

    Com o schedule em execução, o job FWTECHFINJOB passa a enviar os registros para as staging tables da Carol. Toda alteração efetuada em qualquer registro no ERP automaticamente atualiza o timestamp, no campo S_T_A_M_P_, dessa forma o job reenvia o registro completo para atualizar a staging table.

    É possível ativar os logs do job, para avaliação do que esta sendo executado e enviado, para isso basta seguir os procedimentos descritos no link abaixo.

    https://tdn.totvs.com/display/public/framework/TechFin+Debug

    É recomendado ativar o log somente quando for necessária alguma avaliação, pois manter o log ligado poderá onerar a performance, além de criar muitos arquivos no rootpath do ambiente.


    Referências


    05. ASSUNTOS RELACIONADOS

    • Não há.