Conceitos

Quase toda configuração do CMS combina os mesmos poucos objetos. Entender essa cadeia resolve a maior parte das dúvidas de uso.

Aplicação

Representa um sistema integrado (ERP, MES, WMS, balança, CLP…). Tem uma sigla curta — usada nas URLs e nos relatórios — e é a unidade de agrupamento do sistema: interfaces, definições, tokens, alertas e relatórios são sempre organizados por Aplicação.

A Aplicação também é a unidade de monitoramento de disponibilidade: o CMS verifica em ciclos a conexão dela (keep-alive), registra períodos online/offline e gera o relatório de uptime.

O seletor no topo da tela define a Aplicação em foco: escolhida uma, as telas passam a mostrar só o que pertence a ela, e a escolha acompanha a navegação.

As ferramentas de chamado (Help Desk) também são Aplicações, de uma categoria própria. Elas aparecem em Interfaces, Definição de Mensagem e nos filtros de Mensagens, mas ficam fora do seletor de Aplicação em foco e dos cadastros da fábrica.

Interface

Uma interface de processamento. Define como as mensagens daquele fluxo são consumidas:

• Ordem sequencial — uma mensagem por vez, preservando ordem de chegada.
• Paralela — várias mensagens simultâneas, com concorrência configurável.

A Interface pode ser bloqueada (manualmente ou automaticamente por uma regra de erro de negócio). Enquanto bloqueada, as mensagens continuam entrando mas não são entregues — o que evita disparar centenas de erros contra um sistema destino que já se sabe indisponível.

Definição de Entrega

O contrato de entrega: para onde a mensagem vai e como.

Tipo de entrega

Define o protocolo usado para entregar a mensagem no destino:

Campos comuns a todos os tipos

Campos por tipo de entrega

Definição de Coleta

O espelho da Definição de Entrega para o sentido inverso: em vez de esperar alguém enviar, o CMS vai buscar a mensagem.

Tipo de coleta

Define de onde e como o dado é obtido:

Campos comuns a todos os tipos

A periodicidade dos tipos pull pertence à Interface (intervalo em milissegundos ou expressão cron), não à Coleta. Ligar, desligar e executar na hora ficam na tela Agendadores.

Campos por tipo de coleta

O modo de resultado das consultas SQL decide a granularidade: LINHA_UNICA_PAYLOAD_UNICO (todo o resultado vira uma mensagem) ou UMA_LINHA_POR_PAYLOAD (cada linha vira uma mensagem independente).

Transformador

Script JavaScript executado em sandbox (node:vm dentro de worker_threads, num pool isolado) que recebe o payload e devolve outro: JSON ↔ XML, remapeamento de campos, cálculo de agregados.

O mesmo Transformador é reutilizável em Definições de Entrega e em Coletas. Pode ser escrito à mão no editor Monaco ou gerado por IA a partir de um exemplo de entrada, um de saída e um prompt — com histórico de gerações e aprovação explícita antes de entrar em uso.

Numa Entrega que recebe de vários sistemas em formatos diferentes, cada Aplicação produtora pode ter um Transformador próprio, que converte o formato dela para o da Entrega e roda antes do Transformador da Entrega — ver Transformador por Aplicação produtora.

Conexão Externa

Dados de conexão reutilizáveis, com botão de testar conexão. Coletas e Entregas apontam para uma Conexão em vez de repetir host/porta/usuário em cada configuração.

O tipo da conexão vinculada à Aplicação define quais tipos de Coleta e de Entrega ficam disponíveis nela — uma Aplicação com conexão MongoDB, por exemplo, só oferece Coleta MONGODB e Entrega MONGODB_WRITE.

Variáveis

Valores reutilizáveis que entram por {{nome}} nas configurações de Coletas, Entregas e Transformadores — endereços, códigos de centro, nomes que mudam de ambiente para ambiente. Existem em dois escopos: Globais (valem em todo o CMS) e Por Aplicação (valem só dentro dela). Quando o mesmo nome existe nos dois, vale o valor da Aplicação.

Servem para tirar de dentro de cada configuração o que muda entre ambientes: o que difere de desenvolvimento para produção fica num lugar só, em vez de espalhado por dezenas de definições.

Credencial

Credenciais de autenticação usadas nas chamadas de saída (HTTP/SOAP): basic, bearer, token em header, WS-Security. Ficam cifradas em repouso e nunca são reexibidas pela API.

Como tudo se conecta

Aplicação (MES)
 └── Interface (MES_PALLET)          ← ordem, concorrência, bloqueio
      ├── Definição (AnyToMES_Pallet) ← destino, timeout, tentativas, transformador
      │    ├── Credencial             ← como autenticar no destino
      │    └── Transformador          ← como converter o payload
      └── Coleta (SAP_ProdOrder)      ← origem externa + encaminhamentos
           └── Conexão Externa        ← host/porta/usuário do SAP, MQTT, OPC UA…