Integração Gesplan - Dados enviados e Pipelines

CONTEÚDO

1. Visão Geral
2. Data Models
3. Flex Fields
4. Demais informações

01. VISÃO GERAL

A Carol possui uma área de armazenamento onde ficam as staging tables, que são as tabelas que armazenam os dados brutos provenientes do ERP. Os Data Models são estrutura de dados definidas dentro da Carol, e nessas estruturas são armazenadas as informações resultantes do processamento das pipelines.

No tópico 02 abaixo, é apresentado um modelo visual de como as informação são trabalhadas dentro da Carol, antes de serem enviadas à Gesplam. Cada quadro apresentado dentro  da camada Pipeline, representa um conjunto nomeado e temporário de resultados, derivado de uma consulta sql (common table expression - CTE). São utilizadas como alternativa à, por exemplo,  subquerys e views, para melhor organização e manutenção das consultas.

Dentro do código das pipelines essas CTE's estão dispostas da seguinte forma:

WITH common_table_expression_1 (query_statement_1),
common_table_expression_2 ( query_statement_2 ),
common_table_expression_n ( query_statement_n )

Cada CTE armazena um conjunto intermediário de registros que são utilizados pelas CTEs seguintes , até que por fim é gerado um CTE final, que contém os registros que atendem à regra de negócio e que serão levados para o Data Models.

02. DATA MODELS

Principais tabelas e campos envolvidos:

Em todos os Data Models (exceto Movimento Bancário) esta previsto o envio do rateio Multi-natureza x Centro de Custo, caso esteja habilitado através dos parâmetros MV_MULNATP e MV_MULNATR.

Sendo assim, uma vez que  título possuir rateio, haverá o envio do registro divido na quantidade de linhas que o valor foi rateado; cada linha com o conteúdo da Natureza do título, Natureza do rateio (EV_NATUREZ) e Centro de Custo distribuído para a Natureza do rateio (EZ_CCUSTO).

03. FLEX FIELDS

A integração permite ainda que campos específicos (ou campos padrão que não fazem parte da integração) sejam levados à Gesplan.

Essa configuração, embora seja contemplada por uma funcionalidade padrão da Carol, deve ser realizada em conjunto com a equipe Gesplan,  para que haja um De/Para entre os sistemas, e a Gesplan seja capaz de identificar a que se refere esse novo dado.

Na Carol, essa configuração é feita dentro do App Settings do tenant do cliente, uma vez cadastrado os pipelines levarão o conteúdo desses campos das staging tables para os data models.

Cada Data Model suporte até 50 campos customizados. A configuração deve seguir uma nomenclatura e deve estar vinculado a um grupo de campo de nome fixo também, conforme descrito abaixo:

O cadastro dos flex fields esta restrito à campos somente das tabelas listadas na coluna Origem do dado. Qualquer outra configuração que indique um campos de outra tabela causará falha na execução do pipeline.

Os flex fields 001, 002 e 003 dos data models Pagar e Receber, não devem ser cadastrados no App settings, eles são reservados para uso exclusivo, já pré definido dentro de cada pipeline:

• Flex Field 001 - Natureza do título (E1 / E2 Natureza)
• Flex Field 002 - Natureza do Rateio do título (EV_NATUREZ)
• Flex Field 003 - Centro de custo do Rateio (EZ_CCUSTO)

4. DEMAIS INFORMAÇÕES

• TOTVS Carol Overview
• https://docs.carol.ai/ 
• Plugin do VSCode para codificação de pipelines SQL