Noções básicas sobre os processos do AEM Forms understanding-aem-forms-processes
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.
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.
MyApplication/EncryptDocument
usando o Workbench. (Consulte Uso do Workbench.)Quando esse processo de duração curta é chamado, ele executa as seguintes ações:
-
Obtém o documento PDF não seguro passado para o processo como um valor de entrada.
-
Criptografa o documento PDF com uma senha. O nome do parâmetro de entrada para este processo é
inDoc
e o tipo de dados é documento. -
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/EncryptDocument
e o seu funcionamentoinvoke
.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:
- Chamar um processo de duração curta transmitindo um documento inseguro usando o AEM Forms Remoting (Usando um aplicativo Flex)
- Chamada de um processo de duração curta usando a API de chamada (API Java Invocation)
- Chamada de AEM Forms usando codificação Base64 (exemplo de serviço da Web)
- Chamar o AEM Forms usando MTOM (exemplo de serviço da Web)
- Chamar o AEM Forms usando SwaRef (exemplo de serviço da Web)
- Chamada de AEM Forms usando dados BLOB sobre HTTP (exemplo de serviço da Web)
- Chamar o AEM Forms usando DIME (exemplo de serviço da Web)
- Chamar o processo MyApplication/EncryptDocument usando REST
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.