Noções básicas sobre os processos do AEM Forms

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

Quando um processo é ativado, ele se torna 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 originado 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 duração curta é uma operação executada de forma síncrona e no mesmo thread de execução a partir da qual foi invocada. 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 abranger uma quantidade significativa de tempo.

  • Um processo pode estender-se por limites organizacionais.

  • Um processo precisa de entrada externa para ser concluído. Por exemplo, considere uma situação em que um formulário é enviado para 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 como 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 não forem mais necessários.

OBSERVAÇÃO

O AEM Forms não cria um registro quando um processo de duração curta é 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 de processo para executar operações do Process Manager, como encerrar uma instância de processo em execução.

Exemplo de processo de duração curta

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

OBSERVAÇÃO

Esse processo não se baseia em um processo AEM Forms existente. Para seguir junto com os exemplos de código que discutem como invocar esse processo, crie um processo chamado MyApplication/EncryptDocument usando o Workbench. (Consulte Usando Workbench.)

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

  1. Obtém o documento 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 esse 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 para esse 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 desse processo de duração curta é MyApplication/EncryptDocumente sua operação é invoke.

    OBSERVAÇÃO

    Normalmente, um processo de duração curta consiste em mais de três ações. Você cria um processo usando o Workbench. (Consulte Usando Workbench.)

    A programação com formulários AEM descreve as seguintes maneiras nas quais você pode invocar programaticamente esse processo de curta duração:

Exemplo de processo de duração longa

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

Este processo é invocado quando um candidato submete um formulário de empréstimo. O processo não está completo até que um agente de empréstimo aprove ou rejeite o pedido de empréstimo. O nome desse 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 invocar programaticamente esse processo de longa duração, consulte Invocando processos de longa vida centrados em humanos.

OBSERVAÇÃO

Esse processo pode ser criado seguindo o tutorial especificado em Criar seu primeiro aplicativo AEM Forms.

Nesta página