DocumentaçãoAEM 6.4Guia do Forms

Fluxo de trabalho centrado no Forms no OSGi forms-centric-workflow-on-osgi

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
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.

As empresas coletam dados de centenas e milhares de formulários, vários sistemas back-end e fontes de dados online ou offline. Eles também têm um conjunto dinâmico de usuários para tomar decisões sobre os dados, o que envolve processos iterativos de revisão e aprovação.

Juntamente com fluxos de trabalho de revisão e aprovação para públicos internos e externos, grandes organizações e empresas têm tarefas repetitivas. Por exemplo, converter um documento PDF para outro formato. Quando realizadas manualmente, essas tarefas demoram muito tempo e recursos. As empresas também têm requisitos legais para assinar digitalmente um documento e arquivar dados de formulário para uso posterior em formatos predefinidos.

Introdução ao fluxo de trabalho centrado no Forms no OSGi introduction-to-forms-centric-workflow-on-osgi

Você pode usar fluxos de trabalho AEM para criar rapidamente fluxos de trabalho baseados em formulários adaptáveis. Esses fluxos de trabalho podem ser usados para revisão e aprovações, fluxos de processos comerciais, para iniciar serviços de documento, integrar com o fluxo de trabalho de assinatura do Acrobat Sign e operações semelhantes. Por exemplo, processamento de aplicativos de cartão de crédito, fluxo de trabalho de aprovação de licença de funcionário, salvando um formulário como um documento PDF. Além disso, esses fluxos de trabalho podem ser usados em uma organização ou por meio de um firewall de rede.

Com o fluxo de trabalho centrado na Forms no OSGi, você pode criar e implantar rapidamente fluxos de trabalho para várias tarefas na pilha OSGi, sem precisar instalar o recurso completo de Gerenciamento de processos na pilha JEE. O desenvolvimento e o gerenciamento de workflows usam os recursos conhecidos AEM Fluxo de trabalho e AEM Caixa de entrada. Os fluxos de trabalho são a base para automatizar processos de negócios reais que abrangem vários sistemas de software, redes, departamentos e até mesmo organizações.

Após a configuração, esses workflows podem ser acionados manualmente para concluir um processo definido ou ser executados de forma programática quando os usuários enviam um formulário ou gerenciamento de correspondência carta. Com esses recursos aprimorados de Fluxo de trabalho AEM, a AEM Forms oferece dois recursos distintos, mas semelhantes. Como parte de sua estratégia de implantação, você precisa decidir qual delas funciona para você. Consulte um comparação dos AEM Workflows centrados na Forms no OSGi e no Process Management no JEE. Além disso, para obter a topologia de implantação, consulte Topologias de arquitetura e implantação do AEM Forms.

O fluxo de trabalho centrado no Forms no OSGi estende Caixa de entrada AEM e fornece componentes extras (etapas) para AEM editor de fluxo de trabalho para adicionar suporte a fluxos de trabalho centrados no AEM Forms. A Caixa de entrada de AEM estendida tem funcionalidades semelhantes a AEM Forms Workspace. Juntamente com o gerenciamento de fluxos de trabalho centrados no ser humano (Aprovação, Revisão e assim por diante), você pode usar fluxos de trabalho AEM para automatizar serviços de documentoOperações relacionadas a (por exemplo, Gerar PDF) e documentos de assinatura eletrônica (Acrobat Sign).

O diagrama a seguir descreve o procedimento completo para criar, executar e monitorar um fluxo de trabalho centrado na Forms no OSGi.

fluxo de trabalho de introdução ao aem-forms

Antes de você iniciar before-you-start

  • Um fluxo de trabalho é uma representação de um processo de negócios do mundo real. Mantenha seu processo de negócios real e a lista dos participantes do processo de negócios prontos. Além disso, mantenha o material adicional (formulários adaptáveis, Documentos do PDF e muito mais) pronto antes de começar a criar um fluxo de trabalho.
  • Um fluxo de trabalho pode ter vários estágios. Esses estágios são exibidos na Caixa de entrada de AEM e no relatório de ajuda sobre o progresso do fluxo de trabalho. Divida seu processo de negócios em estágios lógicos.
  • Você pode configurar a etapa de atribuição de fluxos de trabalho AEM para enviar notificações por email aos usuários ou destinatários. Então, ativar notificações por email.
  • Um workflow também pode usar o Acrobat Sign para assinaturas digitais. Se você planeja usar o Acrobat Sign em um workflow, a variável configurar o Acrobat Sign para AEM Forms antes de usá-lo em um workflow.

Criar um modelo de fluxo de trabalho create-a-workflow-model

Um modelo de fluxo de trabalho consiste em lógica e fluxo de um processo de negócios. Ele é composto por uma série de etapas. Essas etapas são componentes AEM. É possível estender as etapas do fluxo de trabalho com parâmetros e scripts para fornecer mais funcionalidade e controle, conforme necessário. O AEM Forms fornece algumas etapas além AEM etapas disponíveis para uso imediato. Para obter uma lista detalhada das etapas do AEM e do AEM Forms, consulte Referência em etapas do fluxo de trabalho AEM e Fluxo de trabalho centrado na Forms no OSGi - Referência em etapas.

O AEM oferece uma interface de usuário intuitiva para criar um modelo de fluxo de trabalho usando as etapas de fluxo de trabalho fornecidas. Para obter instruções passo a passo para criar um modelo de fluxo de trabalho, consulte Criação de modelos de fluxo de trabalho. O exemplo a seguir fornece instruções passo a passo para criar um modelo de fluxo de trabalho para um fluxo de trabalho de aprovação e revisão:

NOTE
Você deve ser um membro do grupo editor de fluxo de trabalho para criar ou editar um modelo de fluxo de trabalho.

Criar um modelo para um fluxo de trabalho de aprovação e revisão create-a-model-for-an-approval-and-review-workflow

O fluxo de trabalho de aprovação e revisão é para as tarefas que exigem intervenção humana para tomar decisões. O exemplo a seguir cria um modelo de fluxo de trabalho para um pedido de empréstimo hipotecário ser preenchido por um agente bancário de front office. Depois que o aplicativo é preenchido, ele é enviado para aprovação. Posteriormente, o pedido aprovado é enviado ao requerente para assinatura eletrônica através da Acrobat Sign.

O exemplo está disponível como um pacote anexado abaixo. Importe e instale o exemplo usando o gerenciador de pacotes. Você também pode executar as seguintes etapas para criar manualmente o modelo de fluxo de trabalho para o aplicativo:

O exemplo cria um modelo de fluxo de trabalho para um aplicativo de hipoteca ser preenchido por um agente bancário de front-office. Uma vez preenchido, o aplicativo é enviado para aprovação. Posteriormente, o aplicativo aprovado será enviado ao cliente para assinatura eletrônica usando o Acrobat Sign. Você pode importar e instalar o exemplo usando o gerenciador de pacotes.

Obter arquivo

  1. Abra o console Modelos de fluxo de trabalho . O URL padrão é https://[Server]:[port]/libs/cq/workflow/admin/console/content/models.html/etc/workflow/models

  2. Selecionar Criar, em seguida Criar modelo. A caixa de diálogo Adicionar modelo de fluxo de trabalho é exibida.

  3. Insira o Título e Nome (opcional). Por exemplo, um aplicativo de hipoteca. Toque Concluído.

  4. Selecione o modelo de fluxo de trabalho recém-criado e toque em Editar. Agora, você pode adicionar etapas de fluxo de trabalho para criar lógica de negócios. Ao criar um modelo de fluxo de trabalho pela primeira vez, ele contém:

    • As etapas: Início e Fim do Fluxo. Essas etapas representam o início e o fim do workflow. Essas etapas são obrigatórias e não podem ser editadas ou removidas.
    • Um exemplo de Etapa do participante chamada Etapa 1. Essa etapa é configurada para atribuir um item de trabalho ao usuário administrador. Remova esta etapa.

  5. Habilite notificações por email. Você pode configurar o fluxo de trabalho centrado no Forms no OSGi para enviar notificações por email aos usuários ou destinatários. Execute as seguintes configurações para ativar notificações por email:

    1. Vá para AEM gerenciador de configuração em https://[server]:[port]/system/console/configMgr.
    2. Abra o Day CQ Mail Service configuração. Especifique um valor para a variável Nome do host do servidor SMTP, porta do servidor SMTP, e Endereço "De" campos. Clique em Salvar.
    3. Abra o Externalizador de links CQ do dia configuração. No Domínios , especifique o nome do host/endereço IP real e o número da porta para instâncias locais, de autor e de publicação. Clique em Salvar.

  6. Crie estágios do fluxo de trabalho. Um fluxo de trabalho pode ter vários estágios. Esses estágios são exibidos na Caixa de entrada de AEM e no progresso do relatório do fluxo de trabalho.

    Para definir um estágio, toque no info-círculo ícone para abrir as propriedades do modelo de fluxo de trabalho, abra o Estágios , adicione estágios para o modelo de fluxo de trabalho e toque em Salvar e fechar. Para o exemplo de aplicativo de hipoteca, crie estágios: solicitação de empréstimo, status de solicitação de empréstimo, para ser assinado e documento de empréstimo assinado.

  7. Arraste e solte a Atribuir tarefa etapas do navegador para o modelo de fluxo de trabalho. Faça dele o primeiro passo do modelo.

    O componente Atribuir tarefa atribui a tarefa, criada por workflow, a um usuário ou grupo. Ao atribuir a tarefa, você pode usar o componente para especificar um formulário adaptável ou um PDF não interativo para a tarefa. O formulário adaptável é necessário para aceitar a entrada de usuários e o PDF não interativo ou um formulário adaptável somente leitura é usado para fluxos de trabalho de revisão somente.

    Você também pode usar a etapa para controlar o comportamento da tarefa. Por exemplo, criar um documento de registro automático, atribuir a tarefa a um usuário ou grupo específico, o caminho dos dados enviados, o caminho dos dados a serem preenchidos previamente e as ações padrão. Para obter informações detalhadas sobre as opções da etapa de atribuição de tarefa, consulte Fluxo de trabalho centrado na Forms no OSGi - Referência em etapas documento.

    editor de fluxo de trabalho

    Para o exemplo do aplicativo de hipoteca, configure a etapa de atribuição de tarefa para usar um formulário adaptável somente leitura e exibir o Documento PDF após a conclusão da tarefa. Além disso, selecione para o grupo de usuários com permissão para aprovar a solicitação de empréstimo. No Ações , desative o Enviar opção. Especifique um Variável de rota. Por exemplo, actionTaken. Além disso, adicione as rotas Approve e Reject . As rotas são exibidas como ações separadas (botões) AEM Caixa de entrada. O workflow seleciona uma ramificação com base na ação (botão) que um usuário toca.

    É possível importar o pacote de exemplo, disponível para download no início da seção, para o conjunto completo de valores de todos os campos da etapa de tarefa de atribuição configurada, por exemplo, aplicativo de hipoteca.

  8. Arraste e solte o componente OU Dividir do navegador da etapa para o modelo de fluxo de trabalho. A divisão OR cria uma divisão no fluxo de trabalho, após a qual apenas uma ramificação está ativa. Essa etapa permite introduzir caminhos de processamento condicional no fluxo de trabalho. Adicione etapas de fluxo de trabalho a cada ramificação, conforme necessário.

    Abra as propriedades da divisão OR e adicione os seguintes trechos de código à Ramificação1 e Ramificação2. Esses trechos de código ajudam a escolher uma ramificação com base na ação do usuário AEM Caixa de entrada.

    Snippet de código para Ramificação 1

    Quando um usuário toca Aprovar AEM Caixa de entrada, a Ramificação 1 é ativada.

    code language-none 
    function check(){
   var action = workflowData.getMetaDataMap().get("actionTaken","");
log.info("action " + action);
   return action=="Approve";
}

    Snippet de código para Ramificação 2

    Quando um usuário toca Rejeitar AEM Caixa de entrada, a Ramificação 2 é ativada.

    code language-none 
    function check(){
   var action = workflowData.getMetaDataMap().get("actionTaken","");
log.info("action " + action);
   return action=="Reject";
}

  9. Adicione outras etapas do fluxo de trabalho para criar a lógica de negócios.

    Para o exemplo de hipoteca, adicione um documento de geração de registro, duas etapas de tarefa e uma etapa de assinatura de documento à Ramificação 1 do modelo, conforme exibido na imagem abaixo. Uma etapa de tarefa Atribuir é exibir e enviar ser assinados documentos de empréstimo ao candidato e outro componente de atribuição de tarefa é para exibir documentos assinados. Além disso, adicione um componente de tarefa à ramificação 2. Ela é ativada, quando um usuário toca em Rejeitar AEM Caixa de entrada.

    Para o conjunto completo de valores de todos os campos de etapas da tarefa de atribuição, etapa do documento de registro e etapa de assinatura de documento configuradas por exemplo aplicativo de hipoteca, importe o pacote de exemplo, disponível para download no início desta seção.

    O modelo de fluxo de trabalho está pronto. Você pode iniciar o workflow por meio de vários métodos. Para obter detalhes, consulte Iniciar um fluxo de trabalho centrado na Forms no OSGi.

    workflow-editor-hipoteca

Criar um aplicativo de fluxo de trabalho centrado no Forms create-a-forms-centric-workflow-application

O aplicativo é o formulário adaptável associado ao fluxo de trabalho. Quando um aplicativo é enviado por meio da Caixa de entrada, ele inicia o fluxo de trabalho associado. Para disponibilizar um fluxo de trabalho do Forms como um aplicativo AEM Caixa de entrada e aplicativo do AEM Forms, faça o seguinte para criar um aplicativo de fluxo de trabalho:

NOTE
Você deve ser um membro do grupo fd-administrators para poder criar e gerenciar aplicativos de fluxo de trabalho.
  1. Na instância do autor do AEM, acesse ferramentas > Forms > Gerenciar aplicativo de fluxo de trabalho e torneiras Criar.
  2. Na janela Criar aplicativo de fluxo de trabalho , forneça entradas para os seguintes campos e toque em Criar. Um novo aplicativo é criado e é listado na tela Aplicativos de fluxo de trabalho .
Texto
Descrição
Título
O título é visível AEM Caixa de entrada e ajuda os usuários a escolher um aplicativo. Mantenha-o descritivo. Por exemplo, Salvar Conta Abrindo Aplicativo.
Nome
Especifique o nome do aplicativo. Todos os caracteres, exceto alfabetos, números, hifens e sublinhados, são substituídos por hifens.
Descrição
A descrição é visível AEM Caixa de entrada. Forneça informações detalhadas sobre o aplicativo nos campos de descrição. Por exemplo, Finalidade do aplicativo.
Formulário adaptável

Especifique o caminho de um formulário adaptável. Quando um usuário inicia um aplicativo, o formulário adaptável especificado é exibido.

Observação: Os aplicativos de fluxo de trabalho não suportam formulários e documentos PDF que sejam maiores que uma página ou que exijam rolagem no Apple iPad. Quando um aplicativo é aberto no Apple iPad e o formulário adaptável ou o documento PDF é maior que uma página, os campos do formulário e o conteúdo da segunda página são perdidos.

Grupo de acesso
Selecione um grupo. O aplicativo é visível AEM Caixa de entrada somente para os membros do grupo selecionado. A opção access group disponibiliza todos os grupos do grupo workflow-users para seleção.
Preencher Serviço
Selecione um serviço de preenchimento prévio para o formulário adaptável.
Modelo de fluxo de trabalho
Selecione um modelo de fluxo de trabalho para o aplicativo. Um modelo de fluxo de trabalho consiste em lógica e fluxo do processo de negócios.
Caminho do arquivo de dados
Especifique o caminho do arquivo de dados no repositório crx. O caminho é relativo à carga adaptável do formulário e contém o nome do arquivo de dados. Sempre inclua o nome completo do arquivo, incluindo a extensão, se aplicável. Por exemplo, [payload]/data.xml.
Caminho do anexo
Especifique o caminho da pasta de anexos no repositório crx. O caminho do anexo é relativo ao local da carga útil. Por exemplo, [payload]/data.xml.
Caminho do documento de registro
Especifique o caminho do arquivo Documento de registro no repositório crx. O caminho é relativo ao local de carga do formulário adaptável. Sempre inclua o nome completo do arquivo, incluindo a extensão, se aplicável. Por exemplo, [payload]/DOR/creditcard.pdf.

Iniciar um fluxo de trabalho centrado na Forms no OSGi launch

Você pode iniciar ou acionar um fluxo de trabalho centrado no Forms ao:

Envio de um aplicativo AEM Caixa de entrada inbox

O aplicativo de fluxo de trabalho criado está disponível como um aplicativo na Caixa de entrada. Os usuários que são membros do grupo de usuários do fluxo de trabalho podem preencher e enviar o aplicativo que aciona o fluxo de trabalho associado. Para obter informações sobre como usar AEM Caixa de entrada para enviar aplicativos e gerenciar tarefas, consulte Gerenciar aplicativos e tarefas do Forms na Caixa de entrada AEM.

Envio de um aplicativo do aplicativo AEM Forms afa

O aplicativo AEM Forms é sincronizado com um servidor AEM Forms e permite fazer alterações nos dados do formulário, tarefas, aplicativos de fluxo de trabalho e nas informações salvas (rascunhos/modelos) em sua conta. Para obter mais informações, consulte Aplicativo AEM Forms e artigos relacionados.

Envio de um formulário adaptável af

É possível configurar as ações de envio de um formulário adaptável para iniciar um fluxo de trabalho no envio do formulário adaptável. Os formulários adaptáveis fornecem o Chamar um fluxo de trabalho AEM enviar ação para iniciar um fluxo de trabalho ao enviar um formulário adaptável. Para obter informações detalhadas sobre a ação de envio, consulte Configuração da ação Enviar. Para enviar um formulário adaptável por meio do aplicativo AEM Forms, ative Sincronizar com o aplicativo AEM Forms nas propriedades do formulário adaptável.

Você pode configurar um formulário adaptável para sincronizar, enviar e acionar um fluxo de trabalho do aplicativo AEM Forms. Para obter detalhes, consulte como trabalhar com um formulário.

Uso de uma pasta assistida watched

Um administrador (um membro do grupo fd-administrators ) pode configurar uma pasta de rede para executar um fluxo de trabalho pré-configurado quando um usuário coloca um arquivo (como um arquivo PDF) na pasta. Depois que o workflow for concluído, ele poderá salvar o arquivo de resultado em uma pasta de saída especificada. Essa pasta é conhecida como Pasta assistida. Execute o seguinte procedimento para configurar uma pasta assistida para iniciar um workflow:

  1. Na instância do autor do AEM, acesse ferramentas Forms > Configurar pasta assistida. Uma lista de pastas de controle já configuradas é exibida.
  2. Toque Novo. Uma lista de campos é exibida. Especifique um valor para os seguintes campos para configurar uma Pasta assistida para um fluxo de trabalho:
Texto
Descrição
Nome
Especifique o nome da Pasta assistida. Este campo suporta apenas alfanumérico.
Caminho
Especifique a localização física da Pasta assistida. Em um ambiente em cluster, use uma pasta de rede compartilhada que possa ser acessada AEM nó do cluster.
Processar arquivos usando
Selecione o Fluxo de trabalho opção.
Modelo de fluxo de trabalho
Selecione um modelo de fluxo de trabalho.
Padrão do arquivo de saída
Especifique a estrutura de diretório para arquivos de saída e diretórios. Também é possível especificar uma padrão para arquivos de saída e diretórios.

  1. Toque Avançado. Especifique um valor para o campo a seguir e toque em Criar. A Pasta assistida é configurada para iniciar um fluxo de trabalho. Agora, sempre que um arquivo é colocado no diretório de entrada da Pasta assistida, o fluxo de trabalho especificado é acionado.

    table 0-row-2 1-row-2
    Texto Descrição
    Filtro do mapeador de carga útil Ao criar uma pasta assistida, ela cria uma estrutura de pastas no repositório crx. A estrutura de pastas pode servir como uma carga para o fluxo de trabalho. Você pode gravar um script para mapear um Fluxo de trabalho de AEM para aceitar entradas da estrutura de pastas assistida. Uma implementação pronta para uso está disponível e listada no Filtro do Mapeador de Carga. Se não tiver uma implementação personalizada, selecione a implementação padrão.

    A guia Advanced contém mais campos. A maioria desses campos contém um valor padrão. Para saber mais sobre todos os campos, consulte a Criar ou configurar uma pasta monitorada artigo 10. o

Envio de uma comunicação interativa ou uma carta letter

Você pode associar e executar um fluxo de trabalho centrado na Forms no OSGi ao enviar uma comunicação interativa ou uma carta. Os workflows de gerenciamento de correspondência são usados para comunicações e cartas interativas de pós-processamento. Por exemplo, envio de emails, impressão, envio de fax ou arquivamento de cartas finais. Para obter etapas detalhadas, consulte Pós-processamento de comunicações e cartas interativas.

Configurações adicionais additional-configurations

Configurar o serviço de email configure-email-service

Você pode usar as etapas Atribuir tarefa e Enviar email dos fluxos de trabalho AEM para enviar um email. Execute as etapas a seguir para especificar servidores de email e outras configurações necessárias para enviar emails:

  1. Vá para AEM gerenciador de configuração em https://[server]:[port]/system/console/configMgr.
  2. Abra o Day CQ Mail Service configuração. Especifique um valor para a variável Nome do host do servidor SMTP, porta do servidor SMTP, e Endereço "De" campos. Clique em Salvar.
  3. Abra o Externalizador de links CQ do dia configuração. No Domínios , especifique o nome do host/endereço IP real e o número da porta para instâncias locais, de autor e de publicação. Clique em Salvar.

Limpar instâncias do fluxo de trabalho purge-workflow-instances

Minimizar o número de instâncias de fluxo de trabalho aumenta o desempenho do motor de workflow. Portanto, você pode remover regularmente do repositório as instâncias de fluxo de trabalho concluídas ou em execução. Para obter informações detalhadas, consulte Limpeza regular de instâncias de fluxo de trabalho.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da