Configurar entradas de preenchimento automático nas telas do formulário de entrada

Simplifique o preenchimento de formulários nas telas do formulário de entrada configurando entradas preenchidas automaticamente com base em uma ou muitas entradas do usuário.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

As entradas de preenchimento automático são configuradas usando client scripts móveis que são executados como uma ação de regra de IU na regra de IU de uma tela de formulário de entrada. Esses scripts são executados em regras de IU com um tipo de gatilho OnChange. Para obter mais informações sobre regras de IU e ações de regra de IU, consulte Regras da IU para celular.

Nota:

• Somente uma ação de regra de IU Run client script pode ser configurada para cada regra de IU para celular.
• As telas do formulário de entrada eram chamadas de telas de parâmetro. No entanto, o nome Tela de parâmetros ainda é usado no formulário Regra da IU para celular.

Procedimento

1. Navegar até Tudo > Sistema Móvel > IU para celular > Regras da IU para celular.
2. Na lista Regras da IU para celular, selecione Novo para criar uma nova regra de IU para celular ou selecione uma regra de IU para celular existente para configurá-la para entradas de preenchimento automático.
   Importante:

   Se você selecionar uma regra de IU para celular existente, verifique se ela tem as seguintes características:

   • A tabela primária está definida como Tela de parâmetros.
   • Pelo menos um dos gatilhos é OnChange.
3. Configure uma regra de IU para celular para entradas de preenchimento automático em telas de formulário de entrada preenchendo uma das seguintes opções.

   Se você selecionou Novo na Etapa 2:

   1. No formulário Regra da IU para celular, preencha os campos da seguinte forma:

      Campo	Valor
      Nome	Nome da regra da IU para celular.
      Ativo	Se a regra da IU para celular está ativa.
      Condição	Condição sob a qual a regra da IU para celular é usada. Se o campo Condição for deixado em branco, esta regra de IU será executada sempre que qualquer entrada for alterada. Por exemplo, para acionar esta regra de IU quando uma entrada específica muda, use o operador VALCHANGES. Inserir urgenteVALCHANGES no campo Condição faz com que a regra de IU seja acionada somente quando o valor de uma entrada chamada urgency muda. Para obter detalhes sobre os operadores disponíveis para sua condição, consulte Operators available for filters and queries.
      Tabela primária	A tabela primária à qual a regra da IU para celular se aplica. Selecionar tela de parâmetro.
      Primário(a)	A tela do formulário de entrada à qual a regra da IU para celular é aplicada.
      Gatilhos	Selecione onChange.
      ID da ação do usuário	Um valor exclusivo que identifica este registro de ação. É necessário associar a ação a uma regra de IU. Importante: Esta opção não se aplica à configuração de entradas de preenchimento automático em telas de formulário de entrada. Não defina um valor para este campo.
      Ordem	Ordem na qual a regra da IU para celular é executada. Importante: Esta opção não se aplica à configuração de entradas de preenchimento automático em telas de formulário de entrada. Não defina um valor para este campo.
      Reverter se falso	Quando este campo é selecionado, as ações de regra da IU para celular são revertidas se a condição for avaliada como falsa. Importante: As ações de regra de IU que usam a operação Executar client script não poderão ser executadas se a condição for avaliada como false. Não marque esta caixa de seleção.

   2. Selecione Enviar.

   Se você selecionou uma regra de IU para celular existente para configurá-la para entradas de preenchimento automático na Etapa 2:

   1. No formulário Regra da IU para celular, preencha os campos da seguinte forma:

      Campo	Valor
      Condição	Condição sob a qual a regra da IU para celular é usada. Se o campo Condição for deixado em branco, esta regra de IU será executada sempre que qualquer entrada for alterada. Por exemplo, para acionar esta regra de IU quando uma entrada específica muda, use o operador VALCHANGES. Inserir urgenteVALCHANGES no campo Condição faz com que a regra de IU seja acionada somente quando o valor de uma entrada chamada urgency muda. Para obter detalhes sobre os operadores disponíveis para sua condição, consulte Operators available for filters and queries.
      Tabela primária	Certifique-se de que este campo esteja definido como Tela de parâmetros.
      Gatilhos	Certifique-se de que pelo menos um dos gatilhos esteja definido como onChange.

   2. Mantenha pressionada (ou clique com o botão direito do mouse) a faixa e selecione Salvar.

4. Navegue até a regra da IU para celular que você configurou na Etapa 3 para configurar a ação da regra da IU para celular para entradas de preenchimento automático na tela do formulário de entrada.
5. Na seção Ações de regra da IU para celular do formulário de regra da IU para celular, selecione Novo.

   

   O formulário Ação de regra da IU para celular é exibido.
6. No campo Operação do formulário Ação de regra da IU para celular, pesquise e selecione Executar client script.

   

7. Grave o script do cliente no campo Script do cliente.

   Os client scripts usam o objeto m_form e a classe MobileScriptIncludeCaller. Para obter detalhes sobre essas APIs JavaScript, consulte MobileScriptIncludeCaller - Client e m_form - Client na documentação de referência da API.

   Ao escrever o client script, esteja ciente dos seguintes pontos:

   • Não mude a assinatura da função onChange.
   • O argumento inputName é uma cadeia de caracteres que é o nome da entrada cujo valor foi alterado.
   • O argumento newValue contém o novo valor dessa entrada após a mudança.
8. Selecione Enviar.