Regra: enviar ação

Propriedades e opções de configuração para a regra Enviar ação, que salva e envia a entrada do usuário de um formulário para uma ação definida na Action Center.

Use a regra Enviar ação para salvar e enviar as alterações feitas por um usuário após o preenchimento de um formulário ou uma determinada interação da Interface Gráfica.

Importante:

Essa regra fica disponível para seleção apenas após você adicionar uma definição de ação ao seu aplicativo.

Esquema de ação

Esta seção exibe o nome da definição de ação usada em seu aplicativo.

Observação:

Como só é permitida uma definição de ação por aplicativo, esse campo é preenchido automaticamente.

Substituição de entrada

Nesta seção, você pode definir valores para os argumentos de entrada da ação.

Clicar no campo Substituição de entrada abre o painel Recursos , que exibe os parâmetros de entrada ou entrada/saída disponíveis da ação selecionada.

Selecione os parâmetros e defina-os para os valores dos controles de entrada do seu aplicativo.

As propriedades da ação, sejam elas de entrada ou de parâmetros de entrada/saída, podem ser acessadas usando a seguinte sintaxe:

ActionProperties.<action_property_name>

A expressão de valor de um controle de aplicativo tem a seguinte sintaxe:

<Apps_MainPage_name>.<input_control_name>.value

Por exemplo: você tem o parâmetro de entrada "name" em sua ação "Voting App". Você tem um controle de texto em seu aplicativo chamado "text1". Para associar o parâmetro de entrada ao valor de controle no Apps:

1. Selecione o parâmetro de entrada "name" no painel Recursos . Deve preencher o campo com a seguinte expressão:

   ActionProperties.Voting_app.name
   

2. No campo Inserir valor , defina o seguinte valor para o parâmetro "name":

   MainPage.text1.Value
   

Observação:

É possível adicionar muitas substituições de entrada conforme o número de parâmetros de entrada de sua ação.

Importante:

Aplique a substituição de entrada em todos os parâmetros de ação que quiser salvar temporariamente ou enviar ao enviar a ação.

Resultado de ação

Nesta seção, você pode configurar o resultado ao concluir a ação.

As opções de resultado são definidas no esquema de definição de sua ação.

Ao ocorrer erro

Nesta seção, você pode definir regras a serem executadas quando o envio da ação encontrar um erro.

Por exemplo: para detectar a falha, você pode adicionar uma regra Mostrar mensagem . Em seguida, você pode especificar o título, a mensagem e o tipo de erro.

Propriedades de saída da regra

• Erro — faz referência à mensagem de erro mostrada se o trabalho falhar.

Solução de problemas

Users can submit the form without filling in required fields

Marking a field as required does not block the Submit Action rule. This applies to the Required property of an input control and to required properties in the action definition. The button stays available until you configure its Disabled property.

The following example uses a form with Name and Comment textboxes on MainPage. The button that runs the Submit Action rule stays disabled until users fill in both textboxes.

1. Set the Required property of the Name and Comment textboxes to True.
2. Add both textboxes to a Container control, for example Container1.
3. Select the button that runs the Submit Action rule.
4. In the Disabled property, enter the following expression:

   Not MainPage.Container1.IsValid
   

The container is valid only when every control inside it is valid, so the button becomes available once users fill in both textboxes.

To check individual controls instead of a container, combine them with OrElse. OrElse stops at the first invalid control and skips the rest:

(Not MainPage.Name.IsValid) OrElse (Not MainPage.Comment.IsValid)

The submit button stays disabled after users fill in the form

The expression in the Disabled property of the button still evaluates to true. Check the following causes:

Causa	Resolution
The expression is missing Not. The button is disabled while Disabled is true, so MainPage.Container1.IsValid disables the button once the form becomes valid.	Add Not before the check, for example Not MainPage.Container1.IsValid.
The expression references the wrong container or control.	Check that each name in the expression matches the container or the controls users fill in.
A control inside the container, or a control in the expression, is still invalid. One invalid control keeps the expression true.	Check that every control has a value that passes its validation.