Configure atributos para variáveis da tela do formulário de entrada

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Use variáveis de tela para coletar informações do usuário automaticamente ou definir informações padrão. As variáveis podem incluir informações como IDs de usuário e coordenadas de GPS.

    Antes de Iniciar

    Você deve criar uma tela de formulário de entrada antes de criar variáveis e atributos. Para obter informações sobre como criar uma tela de formulário de entrada, consulte Configurar uma tela de formulário de entrada.

    Função necessária: administrador

    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 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.
      . Construtor de apps para celular a tela inicial de categorias é exibida.
    3. Selecione Telas e selecione a tela do formulário de entrada para a qual você deseja configurar variáveis.
    4. Role para baixo até a seção Variáveis do formulário e selecione Novo para criar uma variável.
      O formulário Variável é exibido.
    5. Preencha os seguintes campos conforme necessário.
      Tabela 1. Campos de variáveis
      Campo Descrição
      Nome O nome da sua variável
      Tipo de variável
      Campo de banco de dados Dados de um campo. Este campo usa Fieldname atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 6 para configurar o atributo.
      Data Data atual. Esta variável não usa um atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 8 para concluir a configuração da variável.
      Constante Um valor estático definido pelo administrador usando ConstantValue atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 6 para configurar o atributo.
      Coordenadas do GPS Longitude e latitude do usuário. Esta variável não usa um atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 8 para concluir a configuração da variável.
      Modo Off-line A entrada está disponível quando o aplicativo para celular está off-line. Esta variável não usa um atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 8 para concluir a configuração da variável.
      Usuário Sys_id do usuário. Esta variável não usa um atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 8 para concluir a configuração da variável.
      ParentContext Informações de contexto que são transferidas de um registro primário para uma ação. Usa o. ContextField atributo. Depois de configurar Posicionamento de variável , Consulte a Etapa 7 para configurar a variável e o atributo.
      Com script Script que preenche entradas automaticamente. Usa o. Script atributo. Depois de configurar o. Posicionamento de variável Consulte a Etapa 7 para configurar a variável e o atributo.
      Posicionamento de variável
      Tela do formulário de entrada Selecione a tela do formulário de entrada em que a variável aparece.
      Seção do formulário de entrada Selecione a seção do formulário de entrada em que a variável aparece. Se a tela do formulário de entrada não contiver seções, este campo não estará disponível.
    6. Opcional: Se você selecionou Campo de banco de dados ou Constante Como seu tipo de variável, a seção Atributos de variável é exibida.
      Na seção Atributos de variáveis, selecione Novo para configurar o atributo de variável. Dependendo do tipo de variável definido na Etapa 5, selecione as propriedades do atributo.
      Tabela 2. Propriedades do atributo
      Nome de atributo Propriedades
      FieldName Defina as seguintes informações:
      • Tabela : A tabela que você deseja usar.
      • Valor : O nome do campo nessa tabela.

      Se você selecionou este atributo Campo de banco de dados tipo de variável.

      Consulte a Etapa 8 para concluir a configuração da variável.

      ConstantValue

      Insira os dados estáticos definidos pelo administrador. Se você selecionou este atributo Constante tipo de variável.

      Consulte a Etapa 8 para concluir a configuração da variável.

    7. Opcional: Se você quiser configurar os tipos de variáveis ParentContext ou com script, faça o seguinte:
      1. Salve a tela do formulário de entrada selecionando Salvar .
      2. Navegue de volta para o nó da tela do formulário de entrada no menu de navegação esquerdo.
      3. No formulário da tela do formulário de entrada, selecione o ícone do menu de opções Ícone do menu de opções.No canto superior direito do formulário no Construtor de aplicações para celular , e selecione Aberto na plataforma .
      4. Selecione Variáveis guia.
      5. Em Nome , Selecione o nome inserido para a variável na Etapa 5.
      6. Selecione um dos seguintes tipos de variáveis.
        Tipo de Variável Descrição
        ParentContext Informações de contexto que são transferidas de um registro primário para uma ação. Este tipo usa ContextField atributo. Por exemplo, use esta variável quando um funcionário sair em uma chamada de serviço e precisar registrar despesas associadas, como quilometragem.
        Com script Script que preenche entradas automaticamente. Este tipo usa Script atributo. Por exemplo, você pode preencher previamente um número de edifício com base no perfil de um usuário final ao fazer uma reserva.
      7. Na seção Atributos, em Nome, clique duas vezes Inserir uma nova linha... e insira o nome do atributo de variável conforme listado na tabela a seguir.
        Importante:
        Insira o Nome do atributo exatamente como está listado na tabela. O nome faz distinção entre maiúsculas e minúsculas.
        Nome de Atributo Descrição
        ContextField Insira este nome de atributo para variáveis ParentContext.
        Nota:
        Insira o nome do atributo exatamente. Diferencia maiúsculas de minúsculas.
        Script Insira este nome de atributo para variáveis com script.
        Nota:
        Insira o nome do atributo exatamente. Diferencia maiúsculas de minúsculas.
      8. Depois de inserir o nome do atributo, selecione a verificação ( Ícone Verificar.) para salvar o atributo.
      9. Clique duas vezes no campo em Valor e adicione o valor apropriado para o atributo que você está configurando conforme descrito na tabela a seguir.
        Nome de Atributo Descrição
        ContextField Insira o nome do campo na tela primária cujo conteúdo você deseja preencher o campo da tela do formulário de entrada.
        Script Cole o código JavaScript que preenche automaticamente o campo da tela do formulário de entrada. Por exemplo, você pode preencher previamente um número de edifício com base no perfil de um usuário final ao fazer uma reserva.
      10. Selecione o ícone de verificação ( Ícone Verificar.) para salvar o atributo.
      11. Selecione Atualizar.
      12. Navegue de volta para o Construtor de aplicações para celular selecionando essa guia do navegador.
    8. No Construtor de aplicações para celular, selecione Salvar .
      Importante:
      Se você executou a Etapa 7 opcional, você já salvou o registro no Construtor de aplicativos para celular para não precisar salvá-lo novamente.

    O que Fazer Depois

    Depois de criar as variáveis da tela do formulário de entrada, você pode mapear essas variáveis para entradas da tela do formulário de entrada ou itens de ação. Para obter detalhes sobre este processo, consulte Configure um item de ação.