Skip to main content

Processamento de eventos com conjunto de ações

Uma interface de usuário (IU) pode incluir controles que permitem aos usuários executar certas ações antes de enviar um formulário, como forma de oferecer uma experiência mais interativa.

O modelo de evento-ação

Controles acionáveis são baseados em um modelo evento-ação (event-action model), que estabelece uma relação de causa e efeito para um controle, tal como uma caixa de seleção ou um botão. O evento  (event) é um gatilho causado pela atividade do usuário, tal como um clique em um botão ou uma entrada em um campo. A ação (action) é uma resposta do aplicativo, tal como a criação de um caso ou exibição de informações sobre um campo para orientar a entrada do usuário.

Por exemplo, um distribuidor online deseja permitir que os clientes usem um endereço de entrega para um pedido como sendo o endereço de faturamento para pagamento. O formulário para entrada do endereço de faturamento oferece aos usuários uma caixa de seleção. Quando o usuário seleciona a caixa de seleção, o aplicativo copia a informação do endereço de entrega para os campos do endereço de faturamento e desativa qualquer edição dos campos do endereço de faturamento. Quando o usuário limpa a caixa de seleção, o aplicativo remove quaisquer entradas nos campos do endereço de faturamento e permite ao usuário inserir um endereço.

No centro da imagem a seguir, deslize a linha vertical para visualizar como a tela do formulário de endereço muda quando o usuário clica e limpa a caixa de seleção.

A tabela a seguir lista exemplos dos pares de evento-ação.

Evento Ação (Action)
Clica em um controle, tal como botão, link ou ícone. Abre uma nova janela
Clica duas vezes em uma linha na grade Permite a edição do conteúdo da linha.
Pressiona a tecla Enter no teclado. Exibe um menu
Seleciona um valor de uma lista de Estados/Províncias Atualiza a lista dos locais dos escritórios
Insere um valor no campo Quantidade (Quantity) Verifica se o inventário é suficiente para executar o pedido

Conjuntos de ações

Em um aplicativo Pega Platform™, um conjunto de ações (action set) é usado para configurar um controle executável. Um conjunto de ações consiste em um ou mais eventos e uma ou mais ações. Como opção, é possível adicionar condições a cada ação de forma que a ação ocorra somente quando as condições forem atendidas.

Cuidado: Eventos e ações podem ser compartilhados entre conjuntos de ações. Como resultado, um ou mais eventos podem acionar uma ação, e um evento e pode acionar mais de um conjunto de ações. Ao configurar mais de um conjunto de ações, evite configurar comportamentos conflitantes para um evento.

Na imagem a seguir, clique nos ícones + para explorar como um conjunto de ações pode preencher os campos do endereço de faturamento em um formulário ao enviar um pedido para um distribuidor online.

Verifique o seu conhecimento com a seguinte interação:

Otimização do conjunto de ações

Ao configurar um conjunto de ações, considere como é afetada a experiência do usuário e os dados por ações de atualização e chamadas ao servidor. Por exemplo, o fluxo do usuário é interrompido quando o usuário tem que esperar pela atualização de uma tela ou retornar manualmente para uma tela anterior.

Atualize uma seção quando:

  • Os valores de propriedade são atualizados no servidor e a IU precisa refletir os novos valores.
  • Uma ação que provoca uma mudança em mais de uma propriedade que ocorre somente no cliente, tal como apagar uma coluna, deve ser enviada.
  • Partes da IU exigem a remoção do Modelo de Objeto de Documento (Document Object Model - DOM) em razão de outra entrada.

Não atualize uma seção quando:

  • É preciso enviar a entrada do usuário. Ao invés disso, utilize uma ação de publicação do valor.
  • É preciso chamar uma transformação de dados (data transform) ou uma atividade após uma ação do usuário.
  • É preciso recalcular a visibilidade, estado ativado/desativado ou somente leitura. Selecione a caixa de seleção Evaluate on client próxima do campo de expressão.

Utilize uma ação Refresh When sempre que possível para declarar dependências. Para manter os dados precisos, utilize uma ação Atualizar quando (Refresh When) para as referências de somente leitura que precisarem permanecer sincronizadas com os dados no servidor. Por exemplo, atualize a seção de detalhes de um hotel que precisa ser atualizada somente quando houver mudança na localização do hotel.

Quando a ação “Atualizar quando” não é possível, utilize uma ação Refresh Other Section (Atualizar outra seção), que é uma atualização de destino. Por exemplo, se você tiver referências editáveis que são atualizadas com base em outras entradas ou entradas não rastreáveis, como cliques em botões, utilize a ação Atualizar outra seção (Refresh Other Section).

    Ações de consolidação no conjunto de ações

    Cada ação no conjunto de ações gera pelo menos uma solicitação de HTTP para o servidor e é executada na ordem sequencial da configuração. Para otimizar as ações e reduzir o número de solicitações de HTTP ao servidor, utilize as melhores práticas a seguir:

    • Se a pré-atividade ou a pré-transformação de dados for executada no mesmo contexto à medida que a seção é atualizada, configure-as na mesma ação de atualizar seção.
    • Modifique o conteúdo da pré-atividade se necessário, ao executá-la no contexto da ação de atualizar seção.
    • Utilize a atividade de invólucro ou a transformação de dados de invólucro para consolidar todas as ações.

    No centro da imagem a seguir, deslize a linha vertical para visualizar como as ações em um conjunto de ações podem ser consolidadas em uma atividade de invólucro.

    Diferenciação entre as ações da seção de publicar e atualizar

    Por padrão, uma ação Atualizar seção (Refresh section) envia todas as alterações pendentes aplicadas a um formulário de volta ao servidor. Não há necessidade de usar uma ação Publicar valor (Post value) antes de uma ação de atualizar seção, como uma ação Atualizar esta seção (Refresh This Section).

    Uma ação Publicar valor atualiza o servidor e obriga todas as condições “Atualizar quando” a serem reavaliadas. Uma ação Publicar valor pode afetar diversas ações que utilizam as condições Quando. Utilize a ação Publicar valor ao invés de utilizar uma seção Atualizar para cada uma destas condições. O uso da ação Publicar valor para atualizar todas as seções também evita a codificação do nome da seção no conjunto de ações ao utilizar uma ação Atualizar outra seção.

    Por exemplo, em um aplicativo de compra de um veículo, o usuário insere seu ID do cliente (Customer ID) para visualizar os acessórios adicionais. Quando o valor do ID do cliente muda, as condições em duas seções são avaliadas em relação aos dados armazenados do cliente, tais como status de associação Elite (Elite membership status), tempo de associação ativa (Active membership lenght) e total de veículos comprados (total vehicle purchases). A seção “Acessórios exclusivos de estilo de vida” (Exclusive lifestyle accessories) é atualizada somente quando um ID de cliente válido é associado a um usuário que tenha comprado três ou mais veículos. A seção “Acessórios de veículos de elite” (Elite car accessories) é atualizada somente quando um ID de cliente válido pertence a um usuário que é membro Elite ativo há mais de 10 anos. 

    No centro da imagem a seguir, deslize a linha vertical para comparar a visualização exibida a um usuário inválido com e a um membro Elite:

    Nota: As ações Executar atividade (Run activity), Executar transformação de dados (Run data transform) e Definir valor (Set value) não enviam as mudanças feitas em um formulário de volta ao servidor. Se você quiser passar algumas mudanças que são feitas em um formulário para uma atividade ou transformação de dados, é preciso passá-las como parâmetros.

    This Topic is available in the following Module:

    If you are having problems with your training, please review the Pega Academy Support FAQs.

    Este conteúdo foi útil?

    50% acharam esse conteúdo útil

    Quer nos ajudar a melhorar esse conteúdo?

    We'd prefer it if you saw us at our best.

    Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

    Close Deprecation Notice