Configurar elementos descritivos para telas de formulário de entrada

  • Versão de lançamento: Yokohama
  • Atualizado 5 de mar. de 2025
  • 5 min. de leitura
  • Adicione elementos descritivos, como texto simples, rich text ou uma imagem, 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

    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 até mesmo seções de formulário de entrada sem entradas. Os elementos descritivos podem ser uma seleção de texto simples, rich text ou uma imagem que precede uma entrada.

    Você deve ter os seguintes elementos configurados para configurar elementos descritivos:
    • 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 com a tela do formulário de entrada. As entradas podem estar localizadas dentro de uma seção ou independentemente de uma seção.
    Nota:
    Pode haver vários elementos descritivos para cada entrada ou para cada seção de 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 ao 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 de tela de 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 simples em uma tela de formulário de entrada.

    Procedimento

    1. Navegar até Tudo > Sistema Móvel > Construtor de apps para celular.
      O Construtor de apps para celular abre em uma nova guia do navegador e exibe a tela de seleção do 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.
      A tela inicial de Construtor de apps para celular categorias é exibida.
    3. Selecione Todos os registros móveis no menu.
    4. No campo Tipo de registro, selecione Elemento descritivo [sys_sg_descriptive_element] e, em seguida, 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 que é exibido acima do elemento descritivo.
      Configurações
      Tipos de elemento descritivo Três elementos descritivos estão disponíveis:
      • Rich text: oferece suporte a 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:
      Os atributos disponíveis com o campo Atributos de elementos descritivos diferem de acordo com o elemento descritivo selecionado.
      Ordem A ordem em que este elemento descritivo é exibido 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 nenhuma entrada.
      Para executar esta exibição:
      1. Abra a IU baseada na web.
      2. Navegar até Tudo > sys_sg_section_attribute.
      3. Selecione Novo.
      4. No campo Nome, adicione o nome do atributo "HideIfDescriptiveOnly" com um valor falso. Esta configuração indica que os elementos descritivos são exibidos mesmo se não houver entradas nessa seção.
      Registro principal A entrada ou a seção do formulário de 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, Text e Image):
      • DataSourceId: o identificador exclusivo da fonte de dados com a qual você está trabalhando
      • ElementIdentifier: o identificador exclusivo de cada elemento de IU.
        Nota:
        Este identificador está listado como valuesMapper.addRecordMapping no script da fonte de dados
      • MergeWithNextUIElement: é assim que o elemento descritivo aparece na tela do formulário de entrada. Marque como verdadeiro para criar uma lacuna entre entradas ou seções de entrada.
        Os seguintes valores padrão existem:
        • A tabela primária do tipo Entrada tem um valor falso.
        • A tabela primária da seção de formulário do tipo Entrada tem um valor verdadeiro.
      Nota:
      Os elementos descritivos devem conter valores para os atributos DataSourceId e ElementIdentifier.
      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.
      • Escala: selecione Ajustar para garantir que o quadro se ajuste à imagem, mantendo sua proporção. Selecione Preencher para que a imagem seja recortada para preencher o quadro. Este é o valor padrão.
    6. No campo Atributos de elementos descritivos, selecione Novo e faça o seguinte:
      1. Selecione DataSouceId no campo Nome.
      2. No campo Valor, selecione um valor conforme listado no script da fonte de dados.
      3. Selecione Save (Salvar).
      4. Selecione ElementIdentifier no campo Nome.
      5. Insira o identificador de 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 deseja usar para este elemento descritivo.
    7. Opcional: Selecione outros atributos de elementos descritivos que sejam relevantes para o elemento descritivo em que você está trabalhando.
    8. Selecione Save (Salvar).