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

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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 Uso do 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.

NOTE
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 curta duração chamado MyApplication/EncryptDocument.

NOTE
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 este processo, crie um processo chamado MyApplication/EncryptDocument usando o Workbench. (Consulte Uso do 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 este processo é inDoc e o tipo de dados é documento.

  3. Salva o documento PDF criptografado por senha como um arquivo PDF para o 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 este processo é outDoc e o tipo de dados é documento.

    Esse processo é concluído de forma síncrona no mesmo thread de execução do qual foi chamado. O nome desse processo de curta duração é MyApplication/EncryptDocumente o seu funcionamento invoke.

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

    Programação com formulários AEM descreve as seguintes maneiras pelas 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 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 invocar programaticamente esse processo de longa duração, consulte Invocando processos de longa vida centrados em seres humanos.

NOTE
Esse processo pode ser criado seguindo o tutorial especificado em Criar seu primeiro aplicativo AEM Forms.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da