Parâmetros

Sumário

1. Conceito

No CONNECT podemos considerar que um parâmetro, baseia-se através de uma variável configurável utilizada dentro do fluxo de integração. Ele serve para armazenar e manipular valores - fixos ou dinâmicos - que podem ser aplicados em diversas etapas do fluxo como:

• Ações;
• Condições;
• Cálculos;
• Chamadas de API.

2. Formas de Uso dos Parâmetros

• Parâmetro de Entrada: Utilizados para receber valores ao iniciar um fluxo (ex: SKU, data inicial, ID do cliente).
• Parâmetro de Saída: Representam valores que serão retornados ao final da execução (ex: status de conclusão, código gerado).

• Parâmetro Local (Variável): Criados e utilizados apenas durante a execução do fluxo, muitas vezes atribuídos por ações Java ou resultados intermediários.

Exemplo de aplicação:

Suponha que você utilize um token de autenticação em diversas chamadas de API. Em vez de inseri-lo manualmente em cada ação:

jsonCopiarEditar"Authorization": "Bearer eyJ123456..."

É possível criar um parâmetro chamado token_api e referenciá-lo corretamente no CONNECT utilizando a seguinte sintaxe:

jsonCopiarEditar"Authorization": "Bearer #token_api#"

A notação #nome_do_parametro# é a forma correta de referenciar valores dinâmicos no CONNECT.

3. Benefícios do Uso de Parâmetros

• Centralização de valores: edite em um único ponto e aplique em todo o fluxo;
• Facilidade na manutenção: mais rápido para atualizar valores ou testar variações;
• Maior flexibilidade: o mesmo fluxo pode ser adaptado a diferentes contextos;
• Reutilização de lógica: torna os fluxos mais genéricos e reaproveitáveis.
• Testes otimizados: permite simular diferentes cenários com agilidade.

4. Configurando o CONNECT com Parâmetros

O CONNECT permite a utilização de parâmetros com nomes reservados. Esses parâmetros influenciam diretamente o comportamento da plataforma durante a execução das integrações.

Diferentemente dos fluxos do Workflow, não fazem parte da lógica de negócio, mas sim da configuração operacional do ambiente, podendo impactar aspectos como:

• nível de detalhamento de logs;
• retenção de dados de monitoramento;
• comportamento de execução do motor de integrações.

4.1 Parâmetros Suportados

ignoreDebug

• Tipo de Valor: S ou N.
• Escopo: Ambiente (Subtenant).
• Finalidade: Controle do modo de DEBUG das integrações.

O parâmetro ignoreDebug controla a ativação do modo DEBUG do integrador.

Quando configurado com valor:

• N: Ativa o modo DEBUG.
• S: O modo DEBUG é ignorado (comportamento padrão).

Quando o Modo DEBUG está ativo:

• O motor de execução passa a registrar logs mais detalhados;
• Cada ação executada no Workflow pode gerar informações adicionais de processamento;
• Os logs de monitoramento tornam-se mais completos para análise técnica.

Impactos e Recomendações

• O modo DEBUG aumenta significativamente o volume de logs;
• Pode impactar diretamente:
  • Na performance das execuções;
  • No tempo de resposta dos fluxos;
  • No consumo de armazenamento.

Boas Práticas

• Utilize o modo DEBUG apenas para análise pontual de problemas;
• Evite mantê-lo ativo continuamente e/ou indefinidamente;
• Linhas de log com conteúdo extenso podem ter seu conteúdo cortado a fim de evitar sobrecargas no módulo de monitoramento. Nessas situações, a recomendação é decompor a escrita desse conteúdo em múltiplos passos/mensagens de log;

ignoreInfo

• Tipo de Valor: S ou N.
• Escopo: Ambiente (Subtenant).
• Finalidade: Controle do modo de depuração (INFO) do monitoramento.

O parâmetro ignoreInfo controla a escrita de mensagens informativas no monitoramento do integrador.

Quando configurado com valor:

• N:Ativa as mensagens informativas (comportamento padrão).
• S:Mantém o modo INFO desativado.

Quando o monitoramento não escreve mensagens do tipo INFO:

Se o modo DEBUG também estiver desabilitado, o monitoramento pode não exibir nenhuma mensagem.

Impactos e Recomendações

• O CONNECT, por padrão, escreve poucas mensagens de escopo INFO. Ainda assim, damos a possibilidade de removê-las para que os desenvolvedores tenham total controle sobre informações disponíveis em seus logs de integração.

dias.limpeza.logs

• Tipo de Valor: Numérico inteiro (1,2,3, ...).
• Escopo: Subtenant On-Premise.
• Finalidade: Configuração da retenção de logs de monitoramento.

O parâmetro dias.limpeza.logs define o tempo de retenção dos logs de monitoramento, em dias, para ambientes On-Premise.

Após o período configurado:

• Logs mais antigos são elegíveis para remoção automática;
• O sistema mantém apenas os registros dentro da janela definida.

Impactos e Recomendações

Esse parâmetro é especialmente relevante para ambientes que:

• Possuem alto volume de execução de integrações;
• Geram grande quantidade de logs locais;
• Possuem restrições de armazenamento em disco.

Boas Práticas

• Definir um valor adequado ao volume de execução do ambiente;
• Monitorar o crescimento do uso de disco;
• Ajustar o valor conforme necessidade de auditoria vs. capacidade de armazenamento.

Importante:

• Esse parâmetro não afeta ambientes SaaS (cloud).
• Seu uso é exclusivo para SubTenants On-Premise.

5. Considerações Gerais

• Parâmetros reservados devem ser utilizados com entendimento claro do seu impacto;
• Eles fazem parte da governança operacional do CONNECT;
• Podem influenciar diretamente:
  • Monitoramento;
  • Observabilidade;
  • Performance;
  • Uso de infraestrutura.

Sempre que possível, alterações nesses parâmetros devem ser:

• Registradas;
• Acompanhadas;
• Revisadas periodicamente