Exibir definições da lista de seleção

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura
  • A tabela Conjunto de seleção [sys_choice_set] contém um registro para cada campo que usa uma lista de seleção.

    Antes de Iniciar

    Função necessária: personalize_choices
    Nota:
    A função personalize_choices deve ser concedida explicitamente ao usuário; não pode ser uma ACL.

    Por Que e Quando Desempenhar Esta Tarefa

    O registro do conjunto de opções está associado a um arquivo de aplicações, o que permite que os conjuntos de atualizações e o desenvolvimento da equipe rastreiem e transfiram todas as opções de um campo em um único registro de atualização.

    Os valores da lista de seleção permitem um tamanho máximo de 40 caracteres. O intervalo de valores numéricos permitidos é [-999, 999].

    Procedimento

    1. Clique com o botão direito do mouse no rótulo do campo da lista de seleção e selecione Mostrar listade seleção .
      Para exibir outros valores da lista de seleção, modifique o filtro na parte superior da lista.
      Nota:
      Quando você usa uma ACL para conceder personalize_choices em um campo específico, Mostrar lista de seleção não está disponível. Ela só estará disponível se você conceder explicitamente a função ao usuário. Configurar escolhas continua a aparecer, independentemente de ser uma ACL ou uma função de usuário concedida explicitamente.
    2. Revise os itens na lista.
      Aviso:
      Não adicione novas opções à lista. Para adicionar novas opções a um campo de lista de seleção, use a opção Configurar escolhas.

    Definir uma opção para uma lista de seleção

    Você pode personalizar as opções que estão disponíveis em uma lista de seleção.

    Antes de Iniciar

    Função necessária: personalize_choices

    Procedimento

    1. Navegue até um formulário em que o campo aparece.
    2. Se a lista de seleção depender de outro campo, insira o valor de seleção do qual as opções dependem.

      Por exemplo, na tabela de incidentes, a Subcategoria depende da Categoria. Para personalizar quais opções de subcategoria estão disponíveis para a categoria de hardware, selecione Hardware no campo Categoria.

    3. Clique com o botão direito do mouse no rótulo do campo e selecione Configurar escolhas.
    4. Use o slushbucket para reorganizar a ordem, adicionar ou remover itens ou para criar novos itens.
    5. Clique em Salvar.

      Para adicionar itens dinamicamente a uma lista de seleção, use o método addOption GlideForm.

      Nota:
      Algumas regras de negócio podem ser afetadas por mudanças nas opções da lista de seleção (por exemplo, estados de incidentes padrão).

    Reutilizar uma lista de seleção

    Depois de definir um conjunto de valores de lista de seleção, você pode reutilizar os valores para outro campo em uma tabela diferente.

    Antes de Iniciar

    Função necessária: personalize_choices

    Procedimento

    1. Clique com o botão direito do mouse em um campo de opção existente (Campo A) e selecione Configurar escolhas.
    2. Adicione os valores de lista de seleção desejados na lista relacionada Escolhas.
    3. Para reutilizar os valores da lista de seleção para outro campo (Campo B) em uma tabela diferente, clique com o botão direito do mouse no rótulo do Campo B e selecione Configurar dicionário.
    4. No campo Tabela de seleção, selecione a tabela em que o Campo A reside.
    5. No campo Opção, selecione Campo A.
      Compartilhamento da lista de seleção
    6. Clique em Atualizar.

      Os valores da lista de seleção definidos no Campo A são exibidos no Campo B. Quando você adiciona ou remove valores da lista de seleção no Campo A, essas mudanças também são refletidas no Campo B. Depois de especificar uma tabela de seleção e um campo de seleção, o campo não é mais usa a lista de seleção definida.

    Remover a opção Nenhum de uma lista de seleção

    Você pode remover a opção Nenhum de uma lista de seleção se ela não for necessária.

    Antes de Iniciar

    Função necessária: personalize_dictionary

    Procedimento

    1. Navegue até um formulário em que o campo aparece.
    2. Clique com o botão direito do mouse no rótulo do campo e selecione Configurar dicionário.
    3. Altere o valor do campo Opção para Menu suspenso sem -- Nenhum -- (um valor padrão deve ser especificado).
      Opção sem nenhum
    4. Certifique-se de que o campo Padrão esteja preenchido para determinar qual opção é exibida por padrão.
      Nota:
      Se o campo depender de outro campo, a opção -- Nenhum -- permanecerá disponível.

    Como alterar o valor de exibição Nenhum de uma lista de seleção

    Você pode mudar o rótulo de exibição padrão da opção Nenhum para um campo de seleção.

    Antes de Iniciar

    Função necessária: personalize_choices
    Nota:
    A função personalize_choices deve ser concedida explicitamente ao usuário; não pode ser uma ACL.

    Procedimento

    1. Navegue até um formulário no qual o campo aparece.
    2. Clique com o botão direito do mouse no rótulo do campo e selecione Mostrar listade seleção .
    3. Clique em Nova.
    4. Preencha o formulário.
      Tabela 1. Campos de formulário de opção
      Campo Valor
      Tabela Selecione a tabela.
      Elemento Deixe o nome do campo que é preenchido automaticamente.
      Idioma Insira o código de idioma ISO para o rótulo.
      Sequência Deixe em branco. Este campo determina a ordem.
      Inativo Deixe em branco.
      Rótulo

      Insira o rótulo a ser exibido na lista de seleção.

      Você pode usar JavaScript, incluindo chamadas para inclusões de script, para definir o rótulo. Por exemplo, o rótulo JavaScript no exemplo a seguir muda o valor -- None -- da lista de seleção de Fuso horário em um registro de usuário para usar o valor de fuso horário da instância.

      Criação de novo registro
      Valor Insira NULL_OVERRIDE.
      Nota:
      Você deve inserir NULL_OVERRIDE como o valor ou o novo rótulo aparecerá além da opção -- None --.
      Valor dependente Deixe em branco.
      Dica Deixe em branco.
      Nota:
      Quando o tipo de campo estiver definido como Lista (Lista do Glide), a dica não será exibida.
    5. Clique em Enviar.

    Excluir todas as opções da lista de seleção

    Você pode excluir todas as opções de um campo de opção do registro do Conjunto de opções.

    Antes de Iniciar

    Função necessária: personalizar

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode usar este método quando estiver desenvolvendo uma nova aplicação e os requisitos de negócios mudarem. Se você estiver atualizando uma lista de seleção que já está em uso, considere desativar as opções que não usa mais para evitar conflitos com dados ou scripts existentes que podem depender das opções anteriores.

    Procedimento

    1. No filtro de navegação, insira sys_choice_set.list e pressione Enter.
    2. Abra o registro do conjunto de seleção para o campo.

      Por exemplo, para localizar o conjunto de seleção para a subcategoria de incidente, filtre por [Table] [is] [incident] E [Element] [is] [subcategory].

    3. Marque a caixa ao lado do registro do conjunto de seleção para excluir e selecione Excluir na lista de seleção Ações abaixo da lista.
    4. Clique em Excluir na janela de confirmação.
      Todas as opções do campo foram excluídas.

    Criar uma lista de seleção para outro tipo de campo

    Você pode criar uma lista de seleção para um campo com outro tipo, como um número inteiro, cadeia de caracteres ou campo de referência.

    Antes de Iniciar

    Função necessária: personalize_dictionary

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode usar esta configuração para padronizar a entrada de dados e limitar as opções disponíveis para um campo enquanto mantém o tipo de campo original.

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Dicionário.
    2. Abra a entrada do dicionário para o campo.
      Nota:
      Campos de referência com um grande número de registros na tabela de referência não podem ser convertidos para se parecerem com campos de opção. Um campo de referência com muitos registros é revertido para se parecer com um campo de referência.
    3. Altere o valor de Opção para Menu suspenso com --- Nenhum --- ou Menu suspenso sem --- Nenhum --- (um valor padrão deve ser especificado).
    4. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
    5. Clique em Criar listade seleção .
      • A lista relacionada Escolhas aparece no formulário de entrada do dicionário.
      • Se os registros na tabela contiverem dados para o campo, será criado um valor de lista de seleção para cada valor de campo exclusivo. Por exemplo, se houver três registros na tabela e cada registro tiver um valor exclusivo no campo, três opções serão criadas.
      • Se não houver dados no campo, será criado um valor de lista de seleção de -- Nova opção --.

    Exibir valores inválidos da lista de seleção

    Por padrão, os valores da lista de seleção inativa ou inválida aparecem em texto azul em vez de preto. Você pode desabilitar o indicador de cores para escolhas inválidas.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    No exemplo a seguir, a categoria Rede foi desativada, portanto, aparece em azul para registros que ainda contêm o valor inativo.
    Lista de seleção inválida

    Procedimento

    1. Navegar até Todos > Propriedades do sistema > Propriedades da IU.
    2. Desmarque a caixa de seleção da propriedade Exibir entradas da lista de seleção ausente.

    Adicionar opção de pesquisa a um campo de seleção

    Adicione um campo de pesquisa aos campos de opção que têm uma longa lista de opções.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegue até um formulário que contém campos de opção.
      Por exemplo, incidente.
    2. Em um campo de opção no formulário, por exemplo, Estado, clique com o botão direito do mouse no campo e selecione Configurar dicionário.
    3. Alterne para a exibição avançada do formulário de entrada do dicionário usando o menu de contexto navegando até Exibição > Avançado.
    4. No campo Atributos, digite is_searchable_choice=true.
      Se houver outras entradas no campo de atributos, use uma vírgula para separar as entradas.
    5. Atualize o formulário Entrada de Dicionário e recarregue a página que contém a lista de seleção.

    Resultado

    A lista de seleção contém um campo de pesquisa que os usuários podem usar para filtrar a lista de opções.
    Figura 1. Pesquisa do campo de opção
    Campo de estado com a lista aberta e um campo de pesquisa na parte superior da lista