Especifique um valor de campo padrão

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Um valor padrão preenche um valor em um campo quando um novo registro é criado.

    Antes de Iniciar

    Função necessária: personalize_dictionary

    Por Que e Quando Desempenhar Esta Tarefa

    O valor padrão preenche o campo no formulário em branco para um novo registro e também posteriormente quando o novo registro é enviado se o campo estiver vazio. Os valores padrão podem ser especificados como uma constante ou gerados por meio de script.

    Procedimento

    1. Clique com o botão direito do mouse no rótulo do campo no formulário e selecione Configurar dicionário.
    2. Insira o valor padrão no campo Valor padrão.
      Para definir um valor constante, digite-o no campo da caixa de texto Valor padrão. Para atribuir um valor padrão usando uma fórmula mais complexa, use JavaScript para gerar um valor padrão.
      Nota:
      O valor padrão deve ser o valor subjacente que estaria presente no campo, não o rótulo. Por exemplo, em um campo de lista de seleção, use o valor da opção como o valor padrão, não o nome da opção.

    Exemplos de valor de campo padrão

    Revise os exemplos a seguir sobre como especificar valores de campo padrão.

    Valores padrão de constante

    Aqui está um exemplo que define um valor padrão para o campo Prioridade.
    Figura 1. Constante de valor padrão

    Valores padrão de Javascript

    Para exibir exemplos prontos para uso de valores padrão do JavaScript, navegue até Definição do Sistema > Dicionário e insira este filtro: [Default value] [starts with] [javascript]. Abra alguns dos registros e exiba as entradas de javascript do valor padrão.

    Definir um valor padrão para assign_group

    O exemplo a seguir define um valor padrão em um campo de referência [sys_user_group], obtendo o ID do nome de um grupo.
    javascript:GetIDValue('sys_user_group', 'Development');

    Defina um valor padrão para assigned_to se o usuário tiver a função itil

    Este exemplo da tabela Tarefa [task] descreve como configurar o valor padrão para o usuário [assigned_to] igual ao ID do usuário atual se o usuário tiver uma função itil.
    • Rótulo da coluna: Atribuído a
    • Nome da coluna: [assigned_to]
    • Seção de especificação de referência
      • Referência: usuário [sys_user]
      • Condição qual de referência: [Roles] [is] [itil]
    • Script de valor padrão:
      javascript:if (gs.hasRole("itil"))current.assigned_to = gs.getUserID();

    Definir um valor padrão para um campo de duração

    Para definir um valor padrão para um campo de duração, use o seguinte no campo Valor padrão da entrada do dicionário do campo de duração:
    javascript:current.duration_field.setDisplayValue('3 04:30:14');

    Evite codificar uma data/hora específica. Se o formato de data e hora do sistema mudar, o valor se tornará inválido. Em vez disso, marque a caixa de seleção Usar padrão dinâmico e atribua uma opção de filtro dinâmico. Para obter mais informações sobre filtros dinâmicos, consulte Criar uma opção de filtro dinâmico.