Configure elementos descritivos para telas de formulário de entrada

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Adicione elementos descritivos, como uma imagem, texto simples, rich text ou um cartão para celular, antes de um campo de entrada em uma tela de formulário de entrada. Essas informações adicionais na tela fornecem um contexto para os usuários, permitindo que eles entendam melhor o que é necessário ao inserir dados em um formulário de entrada.

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Elementos descritivos de imagem, texto e rich text são configurados no Construtor de apps para celular, enquanto os elementos descritivos do cartão são configurados no ServiceNow AI Platform. Para obter a configuração de elementos descritivos do cartão, consulte, Configure um elemento descritivo de cartão para telas de formulário de entrada.

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode adicionar elementos descritivos a campos de entrada, seções que contêm campos de entrada ou seções de formulário de entrada sem entradas. Elementos descritivos podem ser uma seleção de texto simples, rich text ou uma imagem que antecede uma entrada.

    Você deve ter os seguintes elementos configurados antes de criar elementos descritivos:
    • Uma fonte de dados que contém pelo menos um identificador de elemento. As fontes de dados facilitam o mapeamento do elemento descritivo para a tela do formulário de entrada. Para obter mais informações, consulte Fontes de dados.
    • Uma seção de registro que pode ser uma entrada ou uma seção de formulário de entrada:
      • Uma seção de formulário de entrada é um grupo de entradas em uma área definida da tela do formulário de entrada, geralmente com um cabeçalho definido.
      • Entradas são campos individuais para os usuários preencherem na tela do formulário de entrada. As entradas podem estar localizadas em uma seção ou independentes de uma seção.
    Nota:
    Pode haver vários elementos descritivos para cada entrada ou para cada seção do formulário de entrada. No entanto, você deve criar um registro separado para cada elemento descritivo de cada entrada.
    As seguintes fases são necessárias ao criar um elemento descritivo: Primeiro, declare o que é o elemento descritivo e o que ele está relacionado. Em seguida, determine se o elemento descritivo está associado a uma entrada ou a uma seção de formulário de entrada. Em seguida, crie atributos para cada tipo de elemento descritivo selecionado. Por fim, mapeie o elemento descritivo em um elemento de IU da tela do formulário de entrada.
    Elementos descritivos de imagem e rich text em uma tela de formulário de entrada Elementos descritivos de imagem e texto simples em uma tela de formulário de entrada
    Elementos descritivos de uma imagem e rich text em uma tela de formulário de entrada. Elementos descritivos de uma imagem e texto sem formatação em uma tela de formulário de entrada.

    Procedimento

    1. Navegar até Tudo > Sistema Móvel > Construtor de apps para celular.
      . Construtor de apps para celular abre em uma nova guia do navegador e exibe a tela de seleção de escopo da aplicação.
    2. PESQUISE o escopo da aplicação em que você está trabalhando e selecione o nome do escopo da aplicação.
      . Construtor de apps para celular a tela inicial de categorias é exibida.
    3. Selecione Todos os registros móveis no menu.
    4. Em Tipo de registro campo, selecione Elemento descritivo [sys_sg_descritive_element] e selecione Novo .
    5. Preencha os seguintes campos conforme necessário.
      Campo Valor
      Propriedades
      Nome Um nome exclusivo para o elemento descritivo.
      Rótulo Um rótulo exibido acima do elemento descritivo.
      Configurações
      Tipos de elemento descritivo Três elementos descritivos estão disponíveis com isso Construtor de apps para celular configuração:
      Nota:
      Os elementos descritivos do cartão são configurados no ServiceNow AI Platform. Para obter a configuração de elementos descritivos do cartão, consulte, Configure um elemento descritivo de cartão para telas de formulário de entrada.
      • Rich text Compatível com marcadores HTML, como negrito, sublinhado, itálico, marcadores, listas numeradas e cor da fonte.
      • Texto Texto simples sem elementos de rich text.
      • Imagem Uma única imagem para acompanhar o elemento descritivo.
      Nota:
      Atributos disponíveis com Atributos de elementos descritivos o campo difere de acordo com o elemento descritivo selecionado.
      Ordem A ordem que este elemento descritivo exibe antes da entrada.
      Posicionamento do elemento descritivo
      Tabela primária Opção para colocar o elemento descritivo em uma área especificada. As seguintes opções estão disponíveis:
      • Entrada : O elemento descritivo precede a entrada.
      • Seção de formulário de entrada : O elemento descritivo existe na seção específica.
      Nota:
      Normalmente, um elemento descritivo é colocado na parte superior de uma seção. No entanto, também há uma opção para incluir um elemento descritivo em uma seção sem exibir entradas. Para obter instruções de configuração, consulte a Etapa 8.
      Registro principal A seção do formulário de entrada ou entrada à qual a tabela primária está relacionada.
      Atributos do elemento descritivo Use atributos para determinar como os elementos descritivos são mostrados no dispositivo móvel. Selecione Novo para adicionar atributos. Os seguintes atributos estão disponíveis para todos os tipos de elemento descritivo (Rich text, texto e imagem):
      DataSourceId
      O identificador exclusivo da fonte de dados com a qual você está trabalhando. Este atributo deve ser usado para elementos descritivos.
      ElementIdentifier
      O identificador exclusivo de cada elemento de IU. Este atributo deve ser usado para elementos descritivos.
      Nota:
      Este identificador está listado como ValoresMapper.addRecordMapping no script da fonte de dados
      MergeWithNextUIElement
      É assim que o elemento descritivo aparece na tela do formulário de entrada. Marcar como verdadeiro para criar um espaço entre entradas ou seções de entrada.
      Nota:
      Existem os seguintes valores padrão:
      • . Tabela primária do tipo Entrada tem um valor de falso .
      • . Tabela primária do tipo Seção de formulário de entrada tem um valor de verdadeiro .

      Os seguintes atributos também estão disponíveis para o tipo de elemento descritivo, Imagem:

      Texto alternativo
      Capacidade de inserir um texto alternativo a ser lido para os usuários.
      MediaHeight
      A altura da imagem. O valor padrão é 210 pixels.
      Escalonamento
      Selecione Ajuste para garantir que o quadro se ajuste à imagem, mantendo sua proporção. Selecione Preencher para que a imagem seja cortada para preencher o quadro. Este é o valor padrão.
    6. Insira um Nome para o seu elemento descritivo.
    7. Selecione Tipo de elemento descritivo (Rich text, Texto ou Imagem) a serem exibidos antes do valor de entrada.
    8. Em Campo da tabela primária selecione se o elemento descritivo é exibido antes de uma entrada ou na parte superior de uma seção.
      Nota:
      Normalmente, um elemento descritivo é colocado na parte superior de uma seção. No entanto, também há uma opção para incluir um elemento descritivo em uma seção sem exibir entradas. Para aplicar este layout, você precisa aplicar a configuração a seguir.
      1. Abra a IU baseada na Web.
      2. Navegar até Tudo > sys_sg_section_attribute.list.
      3. Selecione Novo.
      4. Em Nome o campo adiciona o nome do atributo OculteIfDescriptiveOnly com um valor de falso . Esta configuração afirma que elementos descritivos são exibidos mesmo se não houver entradas nessa seção.
      5. Em Seleção , selecione a seção do formulário de entrada em que este atributo se aplica.
      6. Selecione Enviar.
    9. Em Registro primário selecione a seção de formulário de entrada ou entrada à qual a tabela primária está relacionada.
    10. Em Atributos de elementos descritivos campo, selecione Novo e faça o seguinte:
      1. Selecione DataSourceID em Nome campo.
      2. Em Valor , selecione um valor conforme listado no script da fonte de dados.
      3. Selecione Save (Salvar).
      4. Selecione ElementIdentifier em Nome campo.
      5. Insira o identificador do elemento como está gravado no script da fonte de dados.
      6. Selecione Save (Salvar).
      Nota:
      O valor disponível para fontes de dados e o identificador de elemento são detalhados no script da fonte de dados. Você seleciona qual fonte de dados contém o mapeamento para o identificador de elemento que você deseja usar para este elemento descritivo.
    11. Opcional: Selecione quaisquer outros atributos de elementos descritivos relevantes para o elemento descritivo em que você está trabalhando.
    12. Selecione Save (Salvar).