Campos Personalizados

Visão Geral

Os campos personalizados permitem que os administradores do tenant definam campos personalizados adicionais além das propriedades de ativos já existentes na plataforma. Assim que um campo personalizado é criado e vinculado a um ou mais tipos de ativo, ele aparece sempre que esses ativos são criados, editados e visualizados.

O objetivo é permitir que as organizações registrem as informações extras que são relevantes para elas (por exemplo, uma etiqueta interna de ativo, uma data de expiração de garantia, um centro de custo) sem a necessidade de alterações na plataforma.

Onde encontrar

Console → Configurações Gerais → Campos Personalizados

Tipos de Campo Suportados

Abaixo está a lista dos tipos de campo suportados e suas opções de configuração:

Tipo	Descrição	Configuração adicional
Texto	Texto livre de uma linha	Placeholder, texto de ajuda, comprimento mín./máx.
Texto Longo	Texto livre de várias linhas	Placeholder, texto de ajuda, comprimento mín./máx.
Número	Valor numérico	Placeholder, texto de ajuda, valor mín./máx.
Data	Data de calendário (sem componente de hora)	Permitir data passada / permitir data futura
Booleano	Alternância (sim/não)	—
URL	Texto validado como URL	Placeholder, texto de ajuda
Seleção Única	Uma escolha a partir de uma lista predefinida de opções	Lista de opções
Seleção Múltipla	Uma ou mais escolhas a partir de uma lista predefinida de opções	Lista de opções

Importante: É possível definir valores padrão para todos os tipos de campo. Para campos de seleção, o valor padrão deve ser uma das opções da lista.

Tipos de Ativo Suportados

Abaixo está a lista dos tipos de ativo suportados aos quais os campos personalizados podem ser vinculados

• Dispositivos
• Gateways
• Projetos
• Documentos
• Licenças
• Estações de trabalho
• Cofres
• Segredos
• Tags

Criando um Campo Personalizado

1. Navegue até Console → Configurações Gerais → Campos Personalizados.
2. Clique em Create Field.
3. Informações Básicas:
   • Insira um Label para o campo. Este é o nome que será exibido aos usuários.
   • A Key é gerada automaticamente com base no label e não pode ser editada.
   • Insira uma Description (opcional). É uma breve explicação da finalidade do campo.
4. Tipo de Campo:
   • Selecione o tipo de campo que deseja criar a partir da lista de tipos de campo suportados.
5. Texto do Campo:
   • Configure as definições do campo com base no tipo selecionado. Isso pode incluir texto de placeholder, texto de ajuda e valor padrão.
6. Opções (somente para campos de seleção):
   • Adicione as opções entre as quais os usuários poderão escolher. Você pode adicionar múltiplas opções e definir uma opção padrão, se necessário.
7. Validação:
   • Defina quaisquer regras de validação para o campo, como comprimento mínimo/máximo para text fields, ou valor mínimo/máximo para number fields.
   • Para date fields, você pode especificar se datas passadas ou futuras são permitidas.
8. Comportamento:
   • Escolha se o campo é Required ou Optional.
   • Uma vez definida, esta opção não pode ser alterada posteriormente.
9. Vinculado A:
   • Selecione os tipos de ativo aos quais este campo deve ser vinculado. O campo aparecerá nos formulários e nas páginas de detalhes desses tipos de ativo.
10. Clique em Create para criar o campo personalizado.

Renderizamos a pré-visualização do campo em tempo real conforme você o configura, para que você veja exatamente como ele aparecerá aos usuários.

Importante: Uma vez criado, o campo fica por padrão Active e será visível aos usuários nos tipos de ativo vinculados. Você pode alterar o status para Inactive posteriormente, se necessário, usando as opções de edição do campo.

Atualizando um Campo Personalizado

1. Navegue até Console → Configurações Gerais → Campos Personalizados.
2. Clique no nome do campo que deseja atualizar.
3. Atualize as configurações do campo conforme necessário. Você pode alterar:
   • Label
   • Descrição
   • Texto de placeholder
   • Texto de ajuda
   • Valor padrão
   • Tipos de ativo vinculados
   • Status (Ativo / Inativo)
4. Clique em Save Changes para aplicar as alterações.

Ativando / Desativando

Você pode alterar o status de um campo personalizado para Active ou Inactive. Desativar um campo o oculta dos formulários e das páginas de detalhes e também remove suas associações com os tipos de ativo vinculados, mas não exclui o campo nem os dados armazenados. Você pode reativar o campo e vinculá-lo novamente a tipos de ativo a qualquer momento.

Além do formulário de edição, você também pode alterar o status de um campo a partir da visualização em lista usando as caixas de seleção das linhas e as ações em massa Activate / Deactivate.

1. Navegue até Console → Configurações Gerais → Campos Personalizados.
2. Selecione um ou mais campos usando as caixas de seleção das linhas.
3. Clique em Activate ou Deactivate para alterar o status dos campos selecionados.

Vinculando / Desvinculando Campo Personalizado

Você pode vincular ou desvincular um campo personalizado a um ou mais tipos de ativo. Isso pode ser feito a partir do formulário de edição do campo ou em massa a partir da visualização em lista.

1. Navegue até Console → Configurações Gerais → Campos Personalizados.
2. Selecione um ou mais campos usando as caixas de seleção das linhas.
3. Clique em Link with ou Unlink from para anexar ou desanexar os campos selecionados de um tipo de ativo escolhido.

Importante: Você não pode vincular um campo a um tipo de ativo se ele não estiver ativo. É necessário ativar o campo antes de vinculá-lo a um tipo de ativo.

Como os Campos Personalizados Aparecem nos Ativos

Uma vez vinculado, um campo personalizado aparece em dois lugares para o seu tipo de ativo:

1. Formulários de criação / edição — uma seção Custom Fields é adicionada ao formulário, onde os usuários preenchem um valor para cada campo ativo e vinculado. Os campos obrigatórios devem ser preenchidos para permitir o envio.

2. Página de detalhes do ativo — uma seção Custom Fields exibe os valores salvos, junto com os demais detalhes do ativo. Esta seção aparece apenas nas visualizações de detalhes completas, não na versão compacta.