26 - Modulo Integrações
| Produto: | ||
|---|---|---|
| Linha de Produto: | ||
| Segmento: | ||
| Módulo: | 26 - Modulo Integrações | |
| Função: | Cadastro Centralizado de Integrações | |
| País: | Brasil | |
| Ticket: | ||
| Requisito/Story/Issue (informe o requisito relacionado) : | DINTVENDAS-36 |
O requisito é a Criação de nova rotina para integração com parceiros.
A necessidade é desenvolver uma rotina de cadastro centralizado de integrações no módulo 26. Embora o projeto inicial seja baseado nas necessidades do iFood, ele deve ser modelado e preparado para comportar outros parceiros futuramente.
O objetivo é fornecer uma rotina similar à 2302, onde todas as integrações configuradas possam ser gerenciadas em uma única tela, com cada integração representada por uma linha.
A solução implementada consiste na criação da rotina de cadastro centralizado no módulo 26. Esta funcionalidade resolve o problema de descentralização das configurações de integração, oferecendo um ponto único de gerenciamento.
A funcionalidade desenvolvida inclui:
1. Tela de Aterrissagem (Listagem): Segue o padrão cadastros modernizados, incluindo Filtros Ativo/Inativo e um GRID que lista código, descrição da integração e Status.
◦ O status (Ativo/Inativo) é controlado pelo campo DTEXCLUSAO na tabela de cabeçalhos.
◦ A ação de Inativar preenche o campo DTEXCLUSAO, e a ação de Reativar limpa o DTEXCLUSAO.
2. Tela de Inclusão / Edição: Utiliza o novo componente NG de abas para abrir uma tela com duas abas: Credenciais e Configurações.
◦ O cabeçalho exige campos obrigatórios como Descrição, Layout (Multi-seleção lendo da tabela PCINTEGRAECOMMERCE_LAYOUTC) e Filiais (Multi-seleção para vincular as filiais).
3. Configuração por Filial e Configuração Geral (GRIDs Configuráveis): Ambas as abas se comportam como GRIDs configuráveis, com lógica baseada na tabela PCINTEGRAECOMMERCE_LAYOUTI.
◦ Credenciais: A Filial é obrigatória, pois cada filial possui chaves distintas de autenticação. A GRID lista apenas os parâmetros com TIPO = 'CREDENCIAS'.
◦ Configurações: Permite a opção GERAL no multiseleção de filiais, aplicando uma regra padrão. A GRID lista os parâmetros com TIPO = 'CONFIGURACOES'.
◦ Validações: Parâmetros definidos como OBRIGATORIO são exibidos em negrito e bloqueiam a gravação caso estejam vazios.
4. Persistência: Os dados são gravados nas seguintes tabelas:
◦ PCINTEGRAECOMMERCE_CONFIG (Cabeçalho, incluindo DTEXCLUSAO).
◦ PCINTEGRAECOMMERCE_FILIAL (Vinculação de filiais).
◦ PCINTEGRAECOMMERCE_PARAMS (Parâmetros, onde o campo CODFILIAL pode ser nulo se for um parâmetro GERAL).
Sugestão: Devido à complexidade da configuração das GRIDs (Credenciais e Configurações), que envolvem lógica de ComboBox, recarregamento de parâmetros e validação de campos OBRIGATORIOS, sugere-se a utilização da macro TOTVS CUSTOM TABS BOX para melhor organização do PASSO A PASSO de utilização das abas.
|
• A rotina de cadastro centralizado de integrações foi modelada inicialmente para atender às necessidades do iFood, mas foi preparada para suportar a inclusão de outros parceiros futuramente.
• O sistema utiliza campos de metadados como ORDEMEXIBICAO (para o ORDER BY dos parâmetros) e EDITAVEL (que controla se o valor pode ser alterado) para configurar o comportamento da GRID, baseados na PCINTEGRAECOMMERCE_LAYOUTI.
• A persistência dos parâmetros (PCINTEGRAECOMMERCE_PARAMS) armazena o CODFILIAL, que pode ser nulo quando o parâmetro for configurado como GERAL na aba Configurações.
As versões estarão disponíveis para download na rotina 801 do WTA. https://centraldecontrole.pcinformatica.com.br/
|