01. DADOS GERAIS
| 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 |
|
|---|
02. SITUAÇÃO/REQUISITO
A necessidade é a Criação de nova rotina para integração com parceiros.
O requisito envolve criar uma rotina de cadastro centralizado de integrações. O projeto inicial está baseado nas necessidades do iFood, mas deve ser modelado e preparado para comportar outros parceiros futuramente.
O objetivo é centralizar as configurações de integração em uma única tela, onde todas as integrações ficam configuradas e cada uma é representada por uma linha.
03. SOLUÇÃO
A funcionalidade desenvolvida é a Rotina 2670 - Integrações E-commerce, um cadastro centralizado implementado no Módulo 26.
Esta rotina resolve o desafio de gerenciar múltiplas integrações em um único ponto, apresentando as seguintes características:
1. Interface Modernizada:
- A Tela de Aterrissagem segue o padrão cadastros modernizados, contendo Filtros Ativo/Inativo e um GRID que lista o código, descrição da integração e Status. O status é controlado pelo campo DTEXCLCLUSAO na tabela de cabeçalhos. O menu de 3 pontos oferece opções de Editar, Inativar (preenche DTEXCLUSAO), e Reativar (limpa DTEXCLUSAO para registros inativos). Ação de duplo clique também deve abrir a tela de edição.
2. Estrutura de Cadastro com Abas: A inclusão/edição abre uma tela com duas abas: Credenciais e Configurações, utilizando o novo componente NG de abas.
- 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 filiais à integração).
3. Configurabilidade por Filial (GRIDs Configuráveis): Ambas as abas se comportam como GRIDs configuráveis, com lógica baseada na tabela PCINTEGRAECOMMERCE_LAYOUTI.
- Credenciais (TIPO = 'CREDENCIAS'): A Filial é obrigatória, pois cada filial possui chaves distintas de autenticação.
- Configurações (TIPO = 'CONFIGURACOES'): Deve permitir a opção GERAL no multiseleção de filiais, aplicando uma regra padrão.
- Validação: Parâmetros definidos como OBRIGATORIO são exibidos em negrito e bloqueiam a gravação caso estejam vazios.
4. Persistência dos Dados: As configurações são gravadas 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).
Rotinas e Dependências: Abaixo estão as rotinas e tabelas necessárias para a funcionalidade: Tipo | Nome | Versão Mínima | Rotina | 2670 - Integrações E-commerce | 38.0.4.15 | Tabela | PCINTEGRAECOMMERCE_LAYOUTC | 07.00.03.00 | Tabela | PCINTEGRAECOMMERCE_LAYOUTI | 07.00.04.00 | Tabela | PCINTEGRAECOMMERCE_CONFIG (Cabeçalho) | 08.00.01.00 | Tabela | PCINTEGRAECOMMERCE_FILIAL (Vinculação) | 07.00.02.00 | Tabela | PCINTEGRAECOMMERCE_PARAMS (Parâmetros) | 07.00.03.00 | Tabela | INSERT__INTEGRACAO_ECOMMERCE | 08.00.01.00 | Rotina | ROTINA.2670 | 08.00.01.00 |
|
PASSO A PASSO: Criação e Gestão de Integrações Centralizadas
Este guia detalha o processo de utilização da Rotina 2670 (Cadastro Centralizado de Integrações). 1. Abertura da Rotina (Tela de Aterrissagem) - Acesse o Módulo 26 e abra a rotina ROTINA.2670.
- Utilize os Filtros Ativo/Inativo para listar os registros.
- Para criar uma nova integração, clique no Botão Novo.
- Para editar, use o Menu de 3 pontos (opção Editar) ou o duplo clique sobre a linha no GRID.
2. Tela de Inclusão / Edição (Cabeçalho) Preencha os campos obrigatórios: - Descrição: Informe o nome da integração.
- Layout: Utilize a Multi-seleção, buscando dados da tabela PCINTEGRAECOMMERCE_LAYOUTC. OBS: O sistema deve trazer a descrição da tabela e o código entre parênteses à frente do nome.
- Filiais: Use a Multi-seleção para vincular filiais à integração.
3. Aba Credenciais Esta aba configura os parâmetros de autenticação (TIPO = 'CREDENCIAS'): - No ComboBox, selecione a Filial. A seleção é obrigatória. O ComboBox listará apenas as filiais vinculadas no cabeçalho.
- Preencha o Valor do parâmetro para cada Nome do parâmetro (campo DESCRICAO_LIVRE).
- Campos em negrito (marcados como OBRIGATORIO) bloqueiam a gravação caso estejam vazios.
4. Aba Configurações Esta aba configura os parâmetros gerais e específicos (TIPO = 'CONFIGURACOES'): - No ComboBox, selecione a filial ou a opção GERAL, que aplica a regra padrão.
- Preencha os valores na GRID. A lógica de validação e o comportamento são os mesmos da Aba Credenciais.
5. Gravação da Configuração - Clique em Salvar (ou Cancelar), seguindo o padrão modernizado.
- O sistema exibirá a tela padrão de confirmação de gravação após salvar.
|
04. DEMAIS INFORMAÇÕES
• 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.
05. ASSUNTOS RELACIONADOS