Configurar ações de entrada

  • Versão de lançamento: Yokohama
  • Atualizado 6 de mar. de 2025
  • 6 min. de leitura
  • Adicione um botão ao lado dos campos de formulário de entrada para permitir que os usuários executem várias ações de entrada. Essas ações incluem adicionar um comentário, adicionar um ou mais anexos e navegar para outras telas.

    Antes de Iniciar

    Função necessária: administrador

    Este tópico descreve como configurar ações de entrada para seus vários campos de entrada. Essas configurações devem ser realizadas com a configuração geral das telas do formulário de entrada. As configurações de ações de entrada adicionais só estão disponíveis quando Tela é selecionado no campo Estilo de apresentação da tela do formulário de entrada. Para obter mais informações, consulte Configurar uma tela de formulário de entrada.

    Por Que e Quando Desempenhar Esta Tarefa

    Adicionar um botão de menu Mais ícone de menu Mais. por campos de valor de entrada especificados.
    Nota:
    A aparência do botão pode variar entre os sistemas operacionais iOS e Android. O botão é indicado por três pontos na horizontal ou na vertical.
    Este botão pode incluir qualquer variedade de itens de ação: botões de comentário, anexo e navegação:
    • Comentários: onde os usuários podem adicionar, editar ou excluir um comentário. Os usuários podem adicionar apenas um comentário para cada campo de valor de entrada.
    • Anexos: os usuários podem selecionar imagens da galeria ou adicionar uma nova imagem à galeria. Como alternativa, eles podem adicionar uma imagem diretamente usando a câmera. Os usuários podem adicionar vários anexos a cada campo de valor de entrada.
      Nota:

      Para ações de entrada de anexo, ao mapear anexos como parte de uma fonte de dados, o nome do campo deve ser declarado como um sys_id para que seja adicionado automaticamente à tabela Anexo [sys_sg_attachment]. Em seguida, você deve definir a qual identificador de elemento o elemento pertence, usando o atributo values.Mapper.

    • Botão de navegação: os usuários tocam nesta opção para abrir uma tela alternativa ou a tela do inicializador. Por exemplo, navegue até uma tela de lista para criar uma tarefa de acompanhamento ou para exibir um artigo da base de conhecimento no contexto de uma entrada. Qualquer número de botões de navegação pode ser adicionado ao botão de menu mais.
      Nota:
      Para funções de navegação rotuladas com um contexto de registro, o mecanismo de fonte de dados é necessário. Para funções de navegação rotuladas com um contexto Global, o mecanismo de fonte de dados não é necessário.
    Para obter exemplos de script de ações de entrada, consulte Código de script para armazenar anexos selecionados pelo usuário no banco de dados e Código de script para tipo de comentário e atualizações para ações de entrada.

    Imagem que mostra um pop-up exibido depois que um usuário toca no botão de menu "Mais".

    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 a categoria Telas e selecione uma tela de formulário de entrada existente ou uma nova.
      Se você selecionar Novo, selecione a opção Formulário de entrada na página Criar uma tela e selecione Continuar.
    4. Na página Tela do formulário de entrada, selecione Tela no campo Estilo de apresentação.
    5. Selecione Novo na área Ações para abrir a página Ação do formulário de entrada.
    6. Preencha os seguintes campos conforme necessário.
      Tabela 1. Campos de ação
      Campo Valor
      Propriedades
      Nome Nome da ação.
      Rótulo Rótulo exibido para a ação.
      Ativo Se a ação está ativa. As ações inativas não aparecem na tela do formulário de entrada.
      Disponível off-line Determine se esta ação está disponível off-line.
      Tipo de entrada Opção para escolher se sua entrada é preenchida de outra origem ou modificada por uma ação.
      Nota:
      Para esta configuração, selecione Ação de entrada.
      Aplique ações de entrada a um campo de entrada, como comentários, anexos ou funções de navegação.
      Ícone Ícone usado para representar sua ação na tela do dispositivo móvel do usuário.
      Posicionamento da ação
      Tela do formulário de entrada Selecione a tela do formulário de entrada em que a ação aparece.
      Seção do formulário de entrada Selecione a seção de formulário de entrada em que a ação aparece. Se a tela do formulário de entrada selecionada não contiver seções, este campo não estará disponível.
      Tabela primária A tabela primária à qual a ação se aplica. Este campo é preenchido automaticamente.
      Entrada primária Selecione em qual entrada a ação será aplicada.
      Atributos da ação Determine onde ou como a ação lida com os dados gerados.
      Nota:
      A menos que seja declarado de outra forma, todos os atributos listados estão disponíveis quando você seleciona Ações de entrada no campo Tipo de entrada.

      InputActionType: ações de entrada são ações que podem ser acionadas no ícone de menu mais ícone de menu mais. exibido ao lado de um campo de valor de entrada. As ações são: anexos, comentárioou botão (função de navegação).

      BotãoId: a função de navegação associada à ação de entrada. Esta ação de entrada de navegação pode ser um contexto global ou de registro. O BotãoId é o sys_id de um registro da tabela Botão [sys_sg_button].

      HiddenAttachmentSources: capacidade de impedir o carregamento de origens de anexo específicas do usuário. O usuário pode carregar somente imagens da câmera do telefone ou da galeria.

      DataSourceID: a fonte de dados usada para carregar dados do banco de dados. Usado para ação de entrada de comentário e anexo.
      Nota:
      Um atributo ElementIdentifier também é necessário. Para obter mais informações, consulte Fontes de dados.
      ElementIdentifier: o ID exclusivo contido em uma fonte de dados, usado para carregar dados do banco de dados. Usado para ação de entrada de comentário e anexo.
      Nota:
      Um atributo DataSourceID também é necessário. Para obter mais informações, consulte Fontes de dados.
      UserActionID: um valor exclusivo que identifica este registro de ação. É necessário associar a ação a uma regra de IU.
      Nota:
      Este campo está disponível quando o campo Tipo de entrada é Origem da entrada.
    7. Insira um nome para sua ação de entrada no campo Nome.
    8. Insira um rótulo para a ação de entrada que esteja visível para os usuários no campo Rótulo.
    9. Selecione Ação de entrada no campo Tipo de entrada.
    10. Selecione onde você deseja que a ação seja mostrada preenchendo os seguintes campos na área Posicionamento da ação: Tela do formulário de entrada, Tabela primáriae Entrada primária.
    11. Selecione Novo na área Atributos da ação.
      Os atributos de ação do formulário de entrada são abertos.
    12. Faça o seguinte para as ações de entrada que você deseja incluir na área do campo de entrada.
      Tipo de ação de entradaProcedimento
      Anexo
      1. Selecione InputActionType no campo Nome.
      2. Insira os anexos de texto no campo Valor.
      3. Selecione Save (Salvar).
      Comentário
      1. Selecione InputActionType no campo Nome.
      2. Insira o comentário de texto no campo Valor.
      3. Selecione Save (Salvar).
      Botão de navegação
      1. Selecione InputActionType no campo Nome.
      2. Insira o botão de texto no campo Valor.
      3. Selecione Save (Salvar).

        Você retorna à tabela de atributos de ação do formulário de entrada.

      4. Selecione Novo na área Atributos da ação.
      5. Selecione BotãoId no campo Nome.
      6. Selecione um tipo de navegação pré-configurado no campo Valor. Para obter mais informações sobre como criar botões de navegação, consulte Funções de navegação.
        Nota:
        Se a função de navegação selecionada tiver um contexto de registro (em vez de um contexto global), você deverá mapeá-la para o registro específico usando fontes de dados.

        Se o BotãoId se referir a um botão com um contexto de registro, o padrão será o contexto do formulário de entrada. No entanto, você pode substituir este contexto padrão usando a fonte de dados para vincular a um contexto de registro diferente.

      7. Selecione Save (Salvar).
    13. Selecione Save (Salvar).

    O que Fazer Depois

    Para abrir a tela do formulário de entrada com anexos e comentários já carregados da tabela de instância [instance], você deve configurar os atributos DataSourceId e ElementIdentifier. Por exemplo, em um cenário em que vários usuários trabalham no mesmo formulário, o mecanismo de carregamento da fonte de dados valida que os dados mais recentes são exibidos para o próximo usuário na tela do formulário de entrada. Para uma função de navegação com um contexto de registro, o contexto de registro é definido no script da fonte de dados. O script é mapeado para o sys_id do registro que contém um contexto para a navegação. Para obter mais informações, consulte Configurar fontes de dados.