Campos

O que é a área de Campos

A área de Campos é responsável por centralizar e administrar todos os campos utilizados na plataforma. Campos são elementos fundamentais que armazenam e transportam dados durante a execução de políticas, permitindo controle e flexibilidade no processo decisório.

Para utilizar campos de forma efetiva:

• Entenda a diferença entre campos mapeados para uso interno e campos internos de integrações
• Defina uma convenção de nomenclatura antes de criar campos
• Organize campos por categorias lógicas
• Documente adequadamente o propósito de cada campo

Tipos de Campos

Existem dois tipos de campos no sistema:

Campos mapeados via integração

Descrição: Utilizados para receber dados externos provenientes de integrações (REST, SOAP, CSV, etc.).

Características:

• Valor imutável durante a execução da política
• Recebem dados de fontes externas
• Garantem integridade dos dados originais
• Exemplo: cliente.cpf, api.response.id, csv.nome_usuario

Campos internos do sistema

Descrição: Campos que podem ser modificados ao longo da execução de uma política.

Características:

• Valor mutável durante a execução
• Funcionam como variáveis lógicas ou de controle
• Permitem armazenar resultados intermediários
• Exemplo: contador.tentativas, flag.aprovado, calculo.resultado

Benefícios dessa separação

A distinção entre campos mapeados e campos internos garante:

• Controle: Saber claramente quais dados são externos e quais são calculados
• Rastreabilidade: Facilita auditoria e debug de políticas
• Flexibilidade: Permite manipulação de dados sem afetar valores de origem
• Segurança: Protege dados originais de alterações acidentais

---

Listagem de Campos

Para acessar a listagem de campos:

1. Navegue até Campos no menu lateral (Sidebar)
2. Visualize todos os campos cadastrados no sistema

Nesta tela você pode:

• 🔍 Filtrar campos - Por nome, tipo de dado, categoria ou situação
• ➕ Adicionar novo campo - Criar um novo campo no sistema
• ✏️ Editar campo - Modificar configurações de campos existentes
• 📋 Duplicar campo - Criar cópia de um campo existente
• 👁️ Visualizar detalhes - Ver informações completas do campo

Filtros disponíveis

A listagem oferece os seguintes filtros para facilitar a localização de campos:

Filtro	Descrição	Exemplos
Nome do campo	Busca textual pelo nome	cpf, usuario.nome, api_response
Tipo de dado	Filtra por tipo específico	string, int, boolean, date
Categoria	Agrupa campos por categoria	Cliente, Produto, Transação
Situação	Status do campo	Ativo, Inativo

Dica de organização

Use categorias consistentes para facilitar a localização de campos relacionados. Por exemplo:

• Categoria “Cliente” para: cliente.nome, cliente.cpf, cliente.email
• Categoria “Endereço” para: endereco.rua, endereco.cep, endereco.cidade

---

Adicionar um novo campo

Campos marcados com * são obrigatórios.

ETAPA 1: Configuração Geral

Nome do campo*

Descrição: Nome único e identificador do campo no sistema.

Formato: Utilize nomenclatura clara e padronizada, preferencialmente com prefixo indicando a categoria.

Exemplos:

• cliente.nome_completo
• transacao.valor_total
• api.usuario.email
• calc.resultado_final

Boas práticas de nomenclatura

• Use snake_case ou camelCase de forma consistente
• Inclua prefixos que indiquem a categoria ou origem
• Evite abreviações obscuras
• Seja descritivo mas conciso
• Exemplos bons: cliente.cpf, produto.preco_unitario, boleto.data_vencimento
• Exemplos ruins: c1, val, d

Situação*

Descrição: Indica se o campo está ativo ou inativo para uso nas políticas.

Tipos:

• Ativo: O campo está disponível para uso em políticas e integrações (padrão)
• Inativo: O campo está desabilitado e não pode ser utilizado

Importante

Inativar um campo não remove suas referências em políticas existentes, mas impede que seja selecionado em novas configurações. Verifique dependências antes de inativar.

Categoria*

Descrição: Agrupamento lógico do campo para facilitar organização e localização.

Exemplos de categorias:

• Cliente
• Produto
• Transação
• Endereço
• Autenticação

Descrição

Descrição: Explicação detalhada sobre a finalidade e uso do campo.

Recomendações:

• Descreva claramente o propósito do campo
• Inclua informações sobre formato esperado (se aplicável)
• Mencione restrições ou validações importantes
• Documente casos de uso típicos

Exemplo:

Nome do campo: cliente.cpf
Descrição: CPF do cliente em formato numérico (apenas dígitos).
Utilizado para validação e consultas em bureaus de crédito.
Deve conter exatamente 11 dígitos.

Tipo de dado* ℹ️

Descrição: Define quais tipos de dados o campo pode armazenar. Este campo permite seleção múltipla através do dropdown.

Como selecionar múltiplos tipos

Para adicionar mais de um tipo de dado:

1. Clique no dropdown “Selecione”
2. Escolha um ou mais tipos desejados
3. Os tipos selecionados aparecerão como tags no campo
4. Para remover um tipo, clique no ”×” ao lado da tag

Tipos disponíveis:

Tipo	Descrição	Exemplos
string	Texto de qualquer tamanho	"João Silva", "Rua das Flores, 123"
int	Número inteiro	42, -10, 1000
float	Número decimal	3.14, 99.99, -0.5
boolean	Verdadeiro ou falso	true, false
date	Data	2024-01-15, 15/01/2024
datetime	Data e hora	2024-01-15T14:30:00
array	Lista de valores	[1, 2, 3], ["a", "b", "c"]
object	Estrutura complexa	{"nome": "João", "idade": 30}

Limitação dos tipos array e object

Campos do tipo array e object possuem uma restrição de uso no motor de políticas: eles só podem ser utilizados dentro do mapeamento de retorno de integrações (Nó de Requisição). Não é possível referenciá-los diretamente em nós de processamento como condições ou cálculos.

Múltiplos tipos:

Um campo pode aceitar múltiplos tipos de dados. Por exemplo:

• Um campo pode ser string ou int
• Durante a execução, apenas um tipo será usado por vez
• Útil para campos que recebem dados de múltiplas fontes

Restrição importante

Após salvar o campo, não é possível remover tipos de dado já cadastrados — apenas adicionar novos. Essa medida garante rastreabilidade e estabilidade na execução das políticas que utilizam esse campo.

Exemplo de uso múltiplo:

Campo: api.identificador
Tipos: string, int
Motivo: Algumas APIs retornam ID como número (123), outras como string ("ABC123")

Salvar

Após preencher todos os campos obrigatórios, clique em Salvar para criar o novo campo no sistema.

---

Editar Campo

Após criar campos, você pode precisar atualizar suas configurações. O processo de edição permite modificar a maioria das propriedades.

Para editar um campo, siga estes passos

1. Acesse a listagem de Campos no menu lateral
2. Localize o campo desejado na tabela
3. Clique no ícone de lápis (edição)
4. Altere os campos desejados
5. Clique em Salvar

Campos editáveis

Em caso de dúvida sobre o preenchimento: Consulte o tópico de Adicionar Integração nesta documentação. Os campos e suas regras de preenchimento são os mesmos quando adiciona uma nova integração.

Você pode alterar:

• ✅ Nome do campo
• ✅ Categoria
• ✅ Descrição
• ✅ Situação (Ativo/Inativo)
• ⚠️ Tipo de Dado (apenas adicionar novos tipos)

Restrições na edição

Tipos de dados existentes NÃO podem ser removidos

Ação	Permitido
Adicionar novo tipo de dado	✅ Sim
Remover tipo de dado existente	❌ Não
Editar nome do campo	✅ Sim
Editar categoria	✅ Sim
Editar descrição	✅ Sim
Alterar situação	✅ Sim

Por que não é possível remover tipos?

O sistema não permite a remoção de tipos de dado para garantir:

• Rastreabilidade: Histórico completo das capacidades do campo
• Estabilidade: Políticas existentes não quebram por mudanças retroativas
• Integridade: Mapeamentos em integrações permanecem válidos

Observações

Atenção ao Editar

• Alterações no nome do campo podem impactar políticas que já utilizam esse campo
• Verifique onde o campo está sendo usado antes de fazer alterações significativas
• Recomenda-se testar após alterações importantes
• Campos inativos não podem ser selecionados em novas políticas ou integrações

---

Duplicar Campos

Para agilizar a criação de campos com configurações semelhantes, a plataforma Wisedit oferece a funcionalidade de duplicar um campo já existente. Este recurso economiza tempo ao evitar que você precise preencher novamente todas as informações.

Como duplicar um campo

1. Acesse a listagem de Campos na barra lateral
2. Localize o campo desejado na tabela
3. Clique no ícone de duplicar (ao lado do ícone de edição)
4. Preencha ou edite os campos do formulário
5. Clique em Salvar

Campos na duplicação

Nome do campo*

Obrigatório fornecer um nome diferente do campo original.

O sistema não permite duplicar com o mesmo nome para evitar conflitos.

Outros campos

Todos os outros campos virão preenchidos com os valores do campo original:

• Categoria
• Descrição
• Situação
• Tipos de dado