DocumentaçãoAEM 6.5Guia do usuário

Noções básicas sobre processos do AEM Forms understanding-aem-forms-processes

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.

Um caso de uso comum é um conjunto de serviços da AEM Forms que operam em um único documento. Você pode enviar uma solicitação para o contêiner de serviço criando um processo usando a Bancada. Um processo representa um processo de negócios que você está automatizando. Para obter informações sobre como criar processos, consulte Usando o Workbench.

Uma vez ativado, o processo torna-se um serviço e pode ser chamado como outros serviços. Uma diferença entre um serviço padrão, como o Serviço de criptografia, e um serviço que se originou de um processo é que o último tem uma operação que executa muitas ações. Por outro lado, um serviço padrão tem muitas operações. Cada operação normalmente executa uma ação, como aplicar uma política a um documento ou criptografar um documento.

Os processos podem ter vida curta ou longa. Um processo de curta duração é uma operação executada de forma síncrona e no mesmo thread de execução do qual foi chamado. As operações de curta duração são comparáveis ao comportamento padrão encontrado na maioria das linguagens de programação, onde um aplicativo cliente chama um método e aguarda um valor de retorno.

No entanto, há situações em que um processo não pode ser concluído de forma síncrona devido a fatores como estes:

  • Um processo pode se estender por um período significativo.

  • Um processo pode ultrapassar os limites organizacionais.

  • Um processo precisa de entrada externa para ser concluído. Por exemplo, considere uma situação em que um formulário é enviado a um gerente que está fora do escritório. Nessa situação, o processo não é concluído até que o gerente retorne e preencha o formulário.

    Esses tipos de processos são conhecidos como processos de longa duração. Um processo de longa duração é executado de forma assíncrona, permitindo que os sistemas interajam conforme os recursos permitem e permitindo o rastreamento e o monitoramento da operação. Quando um processo de longa duração é chamado, o AEM Forms cria um valor de identificador de invocação como parte de um registro que rastreia o status do processo de longa duração. O registro é armazenado no banco de dados do AEM Forms. Você pode limpar registros de processos de longa duração quando eles não são mais necessários.

NOTE
O AEM Forms não cria um registro quando um processo de curta duração é chamado.

Usando o valor do identificador de invocação, você pode rastrear o status do processo de longa duração. Por exemplo, você pode usar o valor do identificador de invocação do processo para executar operações do Process Manager, como encerrar uma instância de processo em execução.

Exemplo de processo de vida curta

A ilustração a seguir é um exemplo de um processo de vida curta chamado MyApplication/EncryptDocument.

NOTE
Este processo não se baseia em um processo AEM Forms existente. Para acompanhar os exemplos de código que discutem como invocar este processo, crie um processo chamado MyApplication/EncryptDocument usando o Workbench. (Consulte Uso do Workbench.)

Quando esse processo de vida curta é chamado, ele executa as seguintes ações:

  1. Obtém o documento de PDF não seguro passado para o processo como um valor de entrada.

  2. Criptografa o documento PDF com uma senha. O nome do parâmetro de entrada para este processo é inDoc e o tipo de dados é document.

  3. Salva o documento PDF criptografado por senha como um arquivo PDF no sistema de arquivos local. Esse processo retorna o documento PDF criptografado como um valor de saída. O nome do parâmetro de saída deste processo é outDoc e o tipo de dados é document.

    Esse processo é concluído de forma síncrona no mesmo thread de execução do qual foi chamado. O nome deste processo de curta duração é MyApplication/EncryptDocument e sua operação é invoke.

    note note
    NOTE
    Normalmente, um processo de curta duração consiste em mais de três ações. Crie um processo usando a Bancada. (Consulte Uso do Workbench.)

    A programação com formulários AEM descreve as seguintes maneiras de invocar este processo de curta duração de forma programática:

Exemplo de processo de vida longa

A ilustração a seguir é um exemplo de um processo de longa vida.

Esse processo é chamado quando um candidato envia um formulário de empréstimo. O processo não é concluído até que um gestor de empréstimos aprove ou rejeite a solicitação de empréstimo. O nome deste processo de longa duração é FirstAppSolution/PreLoanProcess e sua operação é invoke_Async. Esse processo deve ser chamado de forma assíncrona. Para obter informações sobre como invocar programaticamente esse processo de longa duração, consulte Invocando Processos de Longa Vida Centrados em Humanos.

NOTE
Este processo pode ser criado seguindo o tutorial especificado em Criando seu Primeiro Aplicativo AEM Forms.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2