Formulário de entrada do dicionário

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 14 min. de leitura
  • O formulário Entrada do dicionário foi reprojetado para fornecer uma exibição Avançada e campos adicionais. Pode ser necessário configurar o formulário para ver todos os campos.

    Tabela 1. Formulário de entrada do dicionário
    Campo Descrição
    Tabela Define a tabela na qual o elemento é criado.
    Nota:
    Esta lista mostra somente as tabelas que atendem às proteções de escopo para adicionar campos.
    Tipo Define o tipo de campo da coluna ou, se o Tipo . Coleção , indica que a entrada do dicionário representa a tabela. Para obter mais informações, consulte Administração de campo .

    Você pode mudar o tipo de um campo. Para preservar os dados existentes, mude somente entre os tipos lógicos que são mapeados para o mesmo tipo físico no banco de dados. Por exemplo, Opção e Cadeia de caracteres.

    Ativo Habilita ou desabilita o campo. Quando esta caixa de seleção é desmarcada, o campo fica oculto em listas e formulários no Ambiente clássico. No entanto, os campos inativos ainda estão disponíveis para consultas. Além disso, desabilitar um campo desmarcando esta opção não o remove de uma lista configurada. Os campos inativos são exibidos nas listas configuradas pelo administrador até que um administrador atualize o layout da lista para removê-los.
    Consulte abaixo anotações de comportamento adicionais.
    • Campos desativados são removidos dos formulários.
    • Listas: Os campos inativos continuam a ser exibidos nas listas configuradas pelo administrador até que um administrador atualize o layout da lista para removê-los. Se um campo inativo for removido de uma exibição padrão configurada pelo administrador, todas as listas pessoais serão redefinidas para seguir a exibição padrão, removendo assim o campo inativo da lista pessoal.
    • Relatórios: Os relatórios existentes que incluem campos inativos continuarão funcionando, porque os dados ainda existem nos registros. No entanto, os campos desativados não estarão disponíveis ao criar novos relatórios ou layouts de lista se não estiverem presentes nas listas configuradas pelo administrador.
    • Construtor de condições: Os campos desativados não estão disponíveis no Construtor de condições, a menos que você esteja usando uma URL existente com filtros que contenham o campo inativo. Mostrar correspondência , Descartar . Agrupar por também pode ser usado em um campo inativo se a coluna estiver presente na exibição de lista.
    • ServiceNow API: A API ServiceNow não verifica se uma coluna está ativa ou inativa. Os valores antigos do campo permanecem nos registros e não podem ser desfeitos.
    • Campos inativos ainda podem ser referenciados em scripts. (Scripts do lado do servidor que usam GlideRecord podem ler e gravar em campos inativos).
    Campo da função Se selecionado, cria um campo que exibe os resultados de uma função de banco de dados, como uma operação matemática, cálculo do comprimento do campo ou cálculo do dia da semana.

    Depois que o novo registro de função for salvo, você não poderá desmarcar a caixa de seleção para tornar o campo um campo regular.

    Somente leitura

    Determina se os usuários podem mudar o valor do campo na interface do usuário. Quando esta caixa de seleção é marcada, ela fica esmaecida. O sistema calcula e exibe os dados do campo.

    Nota:
    Você pode substitua esta opção para tabelas estendidas.
    Auditoria Habilita ou desabilita a auditoria de uma tabela. Ativando a Auditoria (Histórico) para uma Tabela.
    Nota:
    Esta opção se aplica somente a tabelas.
    Índice de texto Determina se as pesquisas indexam o texto em uma tabela.
    Nota:
    Esta opção se aplica somente a tabelas. Para excluir campos da indexação, consulte Remova um índice de um campo específico .
    Rótulo da coluna Define um rótulo exclusivo para a coluna. O rótulo aparece nos cabeçalhos da lista e nos campos de formulário da coluna.
    • Atualizando o. Rótulo da coluna o campo também atualiza o rótulo no arquivo de idioma (para o idioma atual).
    • Quando você cria uma nova coluna, o nome da coluna é preenchido automaticamente com base no rótulo, que é prefixado com u_ para indicar que é personalizado. Por exemplo, se você inserir Descrição da atividade como rótulo da coluna, o nome da coluna é padronizado como u_activity_description .
    Nome da coluna Define o nome do campo da coluna. Quando você cria um novo campo, esse nome é preenchido automaticamente com base no rótulo e em um prefixo da seguinte forma:
    • Para um campo em uma tabela em um escopo diferente, o nome é prefixado com o escopo para indicar que ele é personalizado e não faz parte dessa aplicação.
    • Para um campo em uma tabela na mesma aplicação com escopo, o nome não tem um prefixo, o que indica que ele faz parte da aplicação.
    • Para um campo em uma aplicação global, o nome é prefixado com u_ para indicar que é personalizado.
    Você não pode modificar o prefixo; no entanto, você pode modificar o restante do nome. O nome pode conter apenas caracteres ASCII alfanuméricos minúsculos e sublinhados (_). Você não pode mudar o nome de um registro de dicionário existente.
    Nota:
    Você não pode inserir sublinhados consecutivos (duplos) em um nome de coluna. Por exemplo, se você inserir meu__sample_name como o nome da coluna, ele é alterado automaticamente para my_sample_name quando você salva a entrada do dicionário.
    ]
    Comprimento máximo Fornece um limite lógico para o tamanho dos campos de cadeia de caracteres para determinar como o sistema os exibe na interface do usuário e como mapeá-los para tipos de dados de banco de dados físico.

    Campos de cadeia de caracteres com comprimento inferior a 255 caracteres aparecem como campos de texto de linha única. Campos de cadeia de caracteres com comprimento superior a 254 caracteres aparecem como uma caixa de texto com várias linhas.

    O sistema mapeia o tamanho do campo para o tipo de dados físicos mais próximo disponível no banco de dados. Às vezes, isso resulta em mais comprimento disponível do que o especificado originalmente. Por exemplo, inserir um tamanho de 50 mapeia o tipo de dados físicos mais próximo de VARCHAR(100), que fornece um limite de até 100 caracteres ou o dobro do tamanho do campo solicitado. Da mesma forma, inserir um comprimento de 1000 mapeia o tipo de dados físicos mais próximo de MEDIUMTEXT, o que fornece um limite de até 4000 caracteres ou quatro vezes o tamanho do campo solicitado.

    Nota:
    • Você só pode mudar este valor para um Cadeia de caracteres campo. As mudanças para qualquer outro tipo de campo são ignoradas.
    • Os usuários em uma instância Oracle não podem aumentar o tamanho máximo de um campo de cadeia de caracteres para nada maior que 4000 por meio da IU da aplicação, pois isso requer o tipo de dados CLOB no Oracle. Para aumentar além desse tamanho, registre um incidente com o suporte técnico para solicitar a mudança.
    • Para evitar a perda de dados, diminua o tamanho de um campo de cadeia de caracteres somente quando você estiver desenvolvendo uma nova aplicação e não quando um campo contiver dados. Um aviso será exibido se uma mudança em um campo personalizado resultar em perda de dados. Para um campo do sistema de base, você não pode fazer uma mudança que resulte em perda de dados.
    Obrigatório(a) Determina se este campo deve conter um valor para salvar um registro. Para obter mais informações, consulte Tornar um campo obrigatório .
    Nota:
    Você pode substituir esta opção para tabelas estendidas.
    Exibição Indica que este campo é Valores de exibição para campos de referência. Defina como verdadeiro para o campo cujo valor você deseja usar como o texto exibido em Links para esta tabela em listas e formulários. Por padrão, o Número o campo é o valor de exibição de todas as tabelas de tarefas.
    Nota:
    • Esta opção não controla se uma lista ou formulário exibe este campo como parte do layout. Em vez disso, consulte Configuração da lista E personalizando formulários.
    • O valor de exibição se torna parte do título do formulário ao exibir um registro individual de uma tabela.
    • Você pode definir um valor de exibição diferente em uma tabela estendida do que o valor de exibição em uma tabela primária usando um substituição de dicionário .
    Definição de função Define a função que o campo executa.

    Começa com glidefunction: , seguido pela operação a ser realizada (por exemplo, concat ), seguido pelos parâmetros de função. As constantes devem estar entre aspas simples.

    Por exemplo, a definição de função a seguir cria um campo que mostra a descrição resumida, seguida por um espaço, seguido pelo nome do chamador:

    glidefunction:concat(short_description, ' ' ', caller_id.name)

    Nota:
    Os parâmetros de função são compatíveis com o ponto-walking. Consulte Dot-walking to data in related tables.
    Atributos [Exibição avançada] Altera o comportamento de um campo ou funcionalidade que depende do campo. Para obter mais informações, consulte Atributos do dicionário . Os atributos podem ser substituídos para tabelas estendidas com substituições de dicionário . Você também pode configurar atributos para esta entrada de dicionário por meio de Atributos lista relacionada.
    Valor padrão
    Usar padrão dinâmico [Exibição avançada] Permite especificar um valor padrão gerado dinamicamente com base em um filtro dinâmico.
    Valor do filtro dinâmico [Exibição avançada] Especifica o. Crie uma opção de filtro dinâmico que determina o valor padrão se Usar padrão dinâmico a opção está selecionada.
    Valor padrão Especifica o valor padrão do campo para qualquer novo registro. Certifique-se de que este valor use o tipo de campo correto. Por exemplo, um campo inteiro usa um valor padrão de 2, mas não pode usar um valor padrão de dois. Esses valores podem ser substituídos por substituições de dicionário .
    Especificação de referência
    Referência Torna o campo em um Tipo de campo de referência .

    Se você inserir um nome que não corresponda a uma tabela existente, uma nova tabela será criada quando você salvar suas mudanças no registro de dicionário. Se a tabela atual tiver um módulo no navegador de aplicações, um módulo para a nova tabela será criado automaticamente no mesmo menu de aplicações.

    Usar qualificador de referência [Exibição avançada] Especifica o tipo de qualificador a ser usado:
    • Simples: Um conjunto de listas de seleção em que você pode especificar uma condição de qualificador de referência.
    • Dinâmico: A. Crie uma opção de filtro dinâmico que você pode usar para criar o qualificador.
    • Avançado: Uma cadeia de caracteres de consulta codificada estática ou código JavaScript que você pode usar para criar o qualificador.
    Condição de qualificador de referência Especifica uma condição quando o qualificador de referência é executado se Simples o tipo de qualificador está selecionado.
    Qual de referência dinâmica [Exibição avançada] Especifica o. Crie uma opção de filtro dinâmico que determina o qualificador de referência quando Dinâmico o tipo de qualificador está selecionado.
    Qual de referência [Exibição avançada] Filtra os registros disponíveis para um campo de referência se Avançado o tipo de qualificador está selecionado. Os qualificadores de referência podem ser substituídos por substituições de dicionário .
    Chave de referência [Exibição avançada] Identifica um campo diferente de sys_id a ser usado como identificador exclusivo para campos de referência.
    Regra em cascata de referência [Exibição avançada] Define o que acontece com um registro se o registro referenciado for excluído. Selecione uma das seguintes opções.
    • Limpar: Limpa as referências (padrão).
    • Excluir: Exclui todos os registros de referência.
    • Restringir: Impede a exclusão de registro se houver um registro de referência.
    • Nenhum: Não muda os registros de referência.
    Referência flutuante [Exibição avançada] Habilita Editar botão nas listas relacionadas para relacionamentos um para muitos.
    Criação dinâmica [Exibição avançada] Para campos de referência, determina se a inserção de um valor que não corresponde a um registro existente cria um registro na tabela referenciada. Se selecionado, use Script de criação dinâmica campo para definir como criar o registro.
    Script de criação dinâmica [Exibição avançada] . Campo de criação dinâmica está selecionado, permite que você insira um script para criar um registro na tabela referenciada.
    Campo Dependente
    Dependente do campo [Exibição avançada] Especifica um campo do qual o campo atual depende. Para obter mais informações, consulte Tornar um campo dependente
    Nota:
    Você pode substituir este valor para tabelas estendidas.
    .
    Especificação da lista de opção
    Escolha Permite que os usuários vejam uma lista de valores sugeridos de uma das seguintes maneiras:

    Se uma opção for usada, defina um Tipo de campo da lista de seleção ou use os campos Opção tabela e. Opção campo para copiar opções de outro campo em outro lugar do dicionário.

    Tabela de seleção [Exibição avançada] Preenche as opções de campo com os mesmos valores de outro campo de opção. . Opção o campo está definido como qualquer coisa além de Nenhum , selecione uma tabela da qual extrair valores de seleção. O campo Campo de seleção também deve ser preenchido.

    Por exemplo, se Tabela de seleção Está definido como a tabela Incidente [incidente], este campo tem a mesma lista de seleção de um dos campos de opção em Incidente. Campo de seleção (veja abaixo) determina qual campo.

    Campo de seleção [Exibição avançada] Preenche as opções de campo com os mesmos valores de outro campo de opção. . Opção o campo está definido como qualquer coisa além de Nenhum , selecione um campo na tabela selecionada para Tabela de seleção . Por exemplo, se Tabela de seleção O campo está definido como a tabela Incidente [incidente], e. Campo de seleção está definido como Prioridade , este campo tem as mesmas opções que Prioridade Incidente, mesmo que essas opções mudem.
    Nota:
    Este campo deve ser um campo de seleção.
    Valor calculado
    [Exibição avançada] Determina se o valor do campo é calculado a partir de outros valores. Se selecionado, use Cálculo campo para definir como o cálculo é realizado. . Tipo de cálculo o campo permite selecionar cálculo baseado em script ou fórmula para o valor da coluna. Ao filtrar, classificar ou agrupar por um campo calculado, a ordem de classificação é baseada no valor do campo armazenado da última vez em que o campo foi atualizado, não na última vez em que o campo foi exibido.
    Nota:
    Em relação às regras de negócio, os campos calculados são preenchidos primeiro antes que qualquer regra de negócio, mesmo uma regra de negócio anterior, seja executada. Os campos calculados são preenchidos novamente, se necessário, após qualquer antes da execução das regras de negócio.
    Tipo de cálculo [Exibição avançada] Permite selecionar cálculo baseado em script ou cálculo baseado em fórmula para uma coluna. Para obter mais informações sobre funções predefinidas e fórmulas de exemplo, consulte Fórmulas para valores de coluna em Construtor de tabelas.
    Cálculo [Exibição avançada] Permite inserir um script ou fórmula com base no Tipo de cálculo selecionado.

    . Tipo de cálculo . Fórmula , você pode inserir uma função ou fórmula predefinida para calcular o valor do campo. Você pode usar uma fórmula predefinida ou combinar outras fórmulas para criar uma fórmula de acordo com seus requisitos.

    . Tipo de cálculo . Script , você pode inserir um script para calcular o valor do campo. Eles podem ser substituídos para tabelas estendidas com substituições de dicionário . Você pode usar o objeto atual neste script. Assim como acontece com as regras de controle de acesso, o script pode:
    • Avalie como verdadeiro ou falso.
    • Retorne uma variável de resposta definida como verdadeira ou falsa.
    • Defina um valor de campo diretamente, como: "display_name" .
    Nota:
    Os campos são exibidos como somente leitura quando scripts calculados são aplicados. Por exemplo, ao adicionar um script ao campo calculado em um registro de dicionário definido como Ativo, o campo Ativo se torna somente leitura no formulário. A edição em linha do campo Ativo na exibição de lista também está desabilitada.
    Campos adicionais
    Classe Identifica a tabela que a tabela atual estende. As tabelas que não estendem outras tabelas especificam seu próprio nome neste campo. Para obter mais informações, consulte .
    Defaultsort Obsoleto.
    Classe de tamanho Determina se a plataforma lida com essa tabela como uma tabela grande, reduzindo a quantidade de memória armazenada para cada linha durante as consultas. Há um trabalho agendado que é executado e define o valor deste campo.
    Verificação ortográfica Habilita ou desabilita a verificação ortográfica no campo.
    Exclusivo Requer que o valor do campo seja exclusivo.
    Aviso:
    Tornar um campo exclusivo quando a tabela correspondente já tiver valores diferentes para esse campo causa perda de dados. Antes de impor exclusividade em um campo, verifique se nenhum registro na tabela do campo tem valores ou se todos têm o mesmo valor.
    Ação de IU
    Exibição padrão ou Exibição avançada Muda a exibição do formulário para a exibição padrão ou avançada. Os campos mudam com base na exibição. Se você estiver usando a exibição padrão, deverá escrever um script para realizar as mesmas tarefas fornecidas pelos campos de exibição avançada.
    Listas relacionadas
    Controles de acesso Fornece acesso aos controles de acesso que permitem ou limitam o acesso aos dados na tabela.
    Escolhas Fornece acesso às opções no campo da lista de seleção que você está editando.
    Substituições de dicionário Fornece acesso às substituições de dicionário para este campo.
    Atributos Fornece acesso aos atributos de dicionário para esta entrada.
    Rótulos Fornece acesso aos rótulos usados para a tabela ou campo que você está editando.