Configurar variáveis e atributos da tela do formulário de entrada

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 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: admin

Procedimento

1. Navegar até Todos > Sistema Móvel > Construtor de apps para celular.
   O Construtor de apps para celular é aberto 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 no qual 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 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 o atributo FieldName. Depois de configurar a seção Posicionamento da variável, consulte a Etapa 6 para configurar o atributo.
   Data	Data atual. Esta variável não recebe um atributo. Depois de configurar a seção Posicionamento da variável, consulte a Etapa 8 para concluir a configuração da variável.
   Constante	Um valor estático definido pelo administrador usando o atributo ConstantValue. Depois de configurar a seção Posicionamento da variável, consulte a Etapa 6 para configurar o atributo.
   Coordenadas do GPS	Longitude e latitude do usuário. Esta variável não recebe um atributo. Depois de configurar a seção Posicionamento da 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 recebe um atributo. Depois de configurar a seção Posicionamento da 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 recebe um atributo. Depois de configurar a seção Posicionamento da variável, consulte a Etapa 8 para concluir a configuração da variável.
   ParentContext	Informações de contexto que são transportadas de um registro primário para uma ação. Usa o atributo ContextField. Depois de configurar o posicionamento da variável, consulte a etapa 7 para configurar a variável e o atributo.
   Com script	Script que preenche automaticamente as entradas. Usa o atributo Script. Depois de configurar a seção Posicionamento da 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 de formulário de entrada	Selecione a seção de 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 será exibida.
   Na seção Atributos de variável, 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. Use este atributo se você selecionou o tipo de variável de campo Banco de dados. Consulte a Etapa 8 para concluir a configuração da variável.
   ConstantValue	Insira os dados estáticos definidos pelo administrador. Use este atributo se você selecionou o tipo de variável Constante. 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 Scripted, 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. Na tela do formulário de entrada, selecione o ícone de menu de opções ícone de no canto superior direito do formulário no Construtor de apps para celular, e selecione Abrir na plataforma.
   4. Selecione a guia Variáveis.
   5. Em Nome, selecione o nome que você inseriu 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 transportadas de um registro primário para uma ação. Este tipo usa o atributo ContextField. Por exemplo, use esta variável quando um funcionário sair em uma chamada de serviço e precisar registrar despesas associadas, como milhagem.
      Com script	Script que preenche automaticamente as entradas. Este tipo usa o atributo Script. 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 em 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 de ParentContext. Nota: Insira o nome do atributo exatamente. Faz distinção entre maiúsculas e minúsculas.
      Script	Insira este nome de atributo para Variáveis com script. Nota: Insira o nome do atributo exatamente. Faz distinção entre maiúsculas e minúsculas.

   8. Depois de inserir o nome do atributo, marque a verificação ( de verificação) 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 da 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 de ) para salvar o atributo.
   11. Selecione Atualizar.
   12. Navegue de volta para o Construtor de apps para celular selecionando essa guia do navegador.
8. No Construtor de apps para celular, selecione Salvar.
   Importante:

   Se você executou a Etapa 7 opcional, já salvou o registro no Construtor de apps para celular, portanto, não precisa salvá-lo novamente.

O que Fazer Depois

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