Usar workflows AEM centrados na Forms - referência de etapa para automatizar processos de negócios forms-centric-workflow-on-osgi-step-reference
Você usa modelos de fluxo de trabalho. Um modelo ajuda a definir e executar uma série de etapas. Você também pode definir propriedades do modelo, como se o fluxo de trabalho é transitório ou usa vários recursos. Você pode incluir várias etapas do fluxo de trabalho do AEM em um modelo para atingir a lógica de negócios.
Etapas centradas no Forms forms-workflow-steps
As etapas de fluxo de trabalho centradas no Forms executam operações específicas do AEM Forms em um fluxo de trabalho do AEM. Forms Essas etapas permitem criar rapidamente um fluxo de trabalho adaptável baseado em Forms no OSGi. Esses workflows podem ser usados para desenvolver workflows básicos de revisão e aprovação, processos comerciais internos e entre firewalls. Também é possível usar as etapas Forms Workflow para:
-
Crie processos de negócios, fluxos de trabalho pós-envio e fluxos de trabalho de back-end para gerenciar processos de inscrição.
-
Criar e atribuir tarefas a um usuário ou grupo.
-
Use Adobe Sign em um fluxo de trabalho do AEM para enviar um documento para assinatura.
-
Gerar um documento de registro sob demanda ou no envio de um formulário.
-
Conecte um modelo de fluxo de trabalho com várias fontes de dados para salvar e recuperar dados facilmente.
-
Use a etapa de e-mail para enviar e-mails de notificação e outros anexos ao concluir uma ação e no início ou conclusão de um workflow.
Atribuir etapa de tarefa assign-task-step
A etapa de atribuição de tarefa cria um item de trabalho e o atribui a um usuário ou grupo. Junto com a atribuição da tarefa, o componente também especifica o Formulário adaptável ou PDF não interativo para a tarefa. O Formulário adaptável é necessário para aceitar entradas de usuários e PDF não interativo, ou um Formulário adaptável somente leitura é usado para workflows somente para revisão.
Você também pode usar o componente 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, especificar o caminho dos dados enviados, especificar o caminho dos dados a serem pré-preenchidos e especificar ações padrão. A etapa Atribuir tarefa tem as seguintes propriedades:
-
Título: título da tarefa. O título é exibido na Caixa de entrada do AEM.
-
Descrição: Explicação das operações que estão sendo executadas na tarefa. Essas informações são úteis para outros desenvolvedores de processos quando você está trabalhando em um ambiente de desenvolvimento compartilhado.
-
Caminho da miniatura: caminho da miniatura da tarefa. Se nenhum caminho for especificado, para um Formulário adaptável, uma miniatura padrão será exibida, e para o Documento de registro, um ícone padrão será exibido.
-
Estágio do fluxo de trabalho: um fluxo de trabalho pode ter vários estágios. Esses estágios são exibidos na Caixa de entrada do AEM. É possível definir esses estágios nas propriedades do modelo (Sidekick > Página > Propriedades da página > Estágios).
-
Prioridade: a prioridade selecionada é exibida na Caixa de Entrada do AEM. As opções disponíveis são Alta, Medium e Baixa. O valor padrão é Medium.
-
Data de vencimento: especifique o número de dias ou horas após o qual a tarefa será marcada como vencida. Se você selecionar Desativado, a tarefa nunca será marcada como vencida. Você também pode especificar um manipulador de tempo limite para executar tarefas específicas depois que a tarefa estiver vencida.
-
Dias: o número de dias antes dos quais a tarefa deve ser concluída. O número de dias é contado depois que a tarefa é atribuída a um usuário. Se uma tarefa não estiver concluída e ultrapassar o número de dias especificado no campo Dias, em seguida, se for selecionada, um manipulador de tempo limite será acionado após a data de vencimento.
-
Horas: o número de horas antes das quais a tarefa deve ser concluída. O número de horas é contado depois que a tarefa é atribuída a um usuário. Se uma tarefa não estiver concluída e ultrapassar o número de horas especificado no campo Horas, e se for selecionada, um manipulador de tempo limite será acionado após as horas de vencimento.
-
Tempo limite após a Data de Conclusão: selecione essa opção para habilitar o campo de seleção Manipulador de Tempo Limite.
-
Manipulador de tempo limite: selecione o script a ser executado quando a etapa de atribuição de tarefa ultrapassar a data de vencimento. Os scripts colocados no repositório CRX em [apps]/fd/dashboard/scripts/timeoutHandler estão disponíveis para seleção. O caminho especificado não existe no repositório crx. Um administrador cria o caminho antes de usá-lo.
-
Realçar a ação e o comentário da última tarefa em Detalhes da Tarefa: selecione essa opção para exibir a última ação realizada e o comentário recebido na seção de detalhes da tarefa de uma tarefa.
-
Tipo: escolha o tipo de documento a ser preenchido quando o fluxo de trabalho for iniciado. Você pode escolher um Formulário adaptável, Formulário adaptável somente leitura, um documento PDF não interativo.
-
Usar formulário adaptável: especifique o método para localizar o formulário adaptável de entrada. Essa opção estará disponível se você selecionar Formulário adaptável ou Formulário adaptável somente leitura na lista suspensa Tipo. Você pode usar o Formulário adaptável enviado ao fluxo de trabalho, disponível em um caminho absoluto ou disponível em um caminho em uma variável. Você pode usar uma variável do tipo String para especificar o caminho.
É possível associar várias Forms adaptáveis a um fluxo de trabalho. Como resultado, você pode especificar um Formulário adaptável no tempo de execução usando os métodos de entrada disponíveis. -
Caminho do formulário adaptável: especifique o caminho do formulário adaptável. Você pode usar o formulário adaptável enviado ao fluxo de trabalho, disponível em um caminho absoluto ou recuperar o formulário adaptável de um caminho armazenado em uma variável do tipo de dados da cadeia de caracteres.
-
Selecione o PDF de entrada usando: especifique o caminho de um documento PDF não interativo. O campo está disponível ao escolher um documento PDF não interativo no campo Tipo. Você pode selecionar o PDF de entrada usando o caminho relativo à carga útil, salvo em um caminho absoluto ou usando uma variável do tipo de dados Documento. Por exemplo, [Payload_Diretory]/Workflow/PDF/credit-card.pdf. O caminho não existe no repositório crx. Um administrador cria o caminho antes de usá-lo. Você precisa de uma opção Documento de registro ativada ou de um modelo de formulário do Adaptive Forms para usar a opção Caminho do PDF.
-
Para tarefas concluídas, renderize o Formulário Adaptável como: quando uma tarefa é marcada como concluída, você pode renderizar o Formulário Adaptável como um Formulário Adaptável somente leitura ou um documento PDF. Você precisa de uma opção Documento de registro ativada ou modelo de formulário baseado no Forms adaptável para renderizar o Formulário adaptável como Documento de registro.
-
Pré-preenchido: os seguintes campos listados abaixo servem como entradas para a tarefa:
-
Selecione o arquivo de dados de entrada usando: Caminho do arquivo de dados de entrada (.json, .xml, .doc ou modelo de dados de formulário (FDM)). Você pode recuperar o arquivo de dados de entrada usando um caminho relativo à carga útil ou recuperar o arquivo armazenado em uma variável do tipo de dados Documento, XML ou JSON. Por exemplo, o arquivo contém os dados enviados para o formulário por meio de um aplicativo Caixa de entrada AEM. Um exemplo de caminho é [Payload_Diretory]/workflow/data.
-
Selecione os anexos de entrada usando: os anexos disponíveis no local são anexados ao formulário associado à tarefa. O caminho pode ser relativo à carga ou recuperar o anexo armazenado em uma variável de um documento. Um exemplo de caminho é [Payload_Diretory]/attachments/. Você pode especificar anexos colocados em relação à carga ou usar uma variável do tipo de documento (Lista de matriz > Documento) para especificar um anexo de entrada para o Formulário adaptável.
-
Mapeamento do Atributo de Solicitação: Use a seção Mapeamento do Atributo de Solicitação para definir o nome e o valor do atributo de solicitação. Recupere os detalhes da fonte de dados com base no nome e valor do atributo especificado na solicitação. Você pode definir um valor de atributo de solicitação usando um valor literal ou uma variável do tipo de dados String.
-
-
Informações enviadas: os seguintes campos listados abaixo servem como locais de saída para a tarefa:
- Salvar arquivo de dados de saída usando: salve o arquivo de dados (.json, .xml, .doc ou modelo de dados de formulário (FDM)). O arquivo de dados contém informações enviadas por meio do formulário associado. Você pode salvar o arquivo de dados de saída usando um caminho relativo à carga útil ou armazená-lo em uma variável do tipo de dados Documento, XML ou JSON. Por exemplo, [Payload_Diretory]/Workflow/data, onde os dados são um arquivo.
- Salvar anexos usando: salve os anexos de formulário fornecidos em uma tarefa. Você pode salvar os anexos usando um caminho relativo à carga ou armazená-lo em uma variável da lista de matriz do tipo de dados Documento.
- Salvar documento de registro usando: caminho para salvar um arquivo de documento de registro. Por exemplo, [Payload_Diretory]/DocumentofRecord/credit-card.pdf. Você pode salvar o documento de registro usando um caminho relativo à carga útil ou armazená-lo em uma variável do tipo de dados Documento. Se você selecionar a opção Relativo à carga, o documento de registro não será gerado se o campo de caminho estiver vazio. Essa opção estará disponível somente se você selecionar Formulário adaptável na lista suspensa Tipo.
-
Atribuído > Opções de atribuição: especifique o método para atribuir a tarefa a um usuário. Você pode atribuir dinamicamente a tarefa a um usuário ou grupo usando o script Seletor de participante ou atribuir a tarefa a um usuário ou grupo AEM específico.
-
Seletor de participantes: a opção estará disponível quando a opção Dinamicamente para um usuário ou grupo estiver selecionada no campo Opções de atribuição. Você pode usar um ECMAScript ou um serviço para selecionar dinamicamente um usuário ou grupo. Para obter mais informações, consulte Atribuir dinamicamente um fluxo de trabalho aos usuários e Criar uma etapa personalizada de Participante Dinâmico do Adobe Experience Manager.
-
Participantes: o campo está disponível quando a opção com.adobe.granite.workflow.core.process.RandomParticipantChooser é selecionada no campo Seletor de Participantes. O campo permite selecionar usuários ou grupos para a opção RandomParticipantChooser.
-
Atribuído: o campo está disponível quando o com.adobe.fd.workspace.step.service.VariableParticipantChooser está selecionado no campo Seletor de Participante. O campo permite selecionar uma variável de tipo de dados String para definir o destinatário.
-
Argumentos: o campo está disponível quando um script diferente do script RandomParticipantChoose é selecionado no campo Seletor de Participantes. O campo permite fornecer uma lista de um argumento separado por vírgulas para o script selecionado no campo Seletor de participantes.
-
Usuário ou Grupo: a tarefa foi atribuída a um usuário ou grupo selecionado. A opção está disponível quando a opção Para um usuário ou grupo específico é selecionada no campo Opções de atribuição. O campo lista todos os usuários e grupos do grupo workflow-users.
O menu suspenso Usuário ou Grupo lista os usuários e grupos aos quais o usuário conectado tem acesso. A exibição do nome de usuário depende se você tem permissões de acesso no nó usuários no repositório crx para esse usuário específico. -
Enviar Email de Notificação: selecione esta opção para enviar notificações por email ao destinatário. Essas notificações são enviadas quando uma tarefa é atribuída a um usuário ou grupo. Você pode usar a opção Endereço de email do destinatário para especificar o mecanismo para recuperar o endereço de email.
-
Endereço de email do destinatário: você pode armazenar um endereço de email em uma variável, usar um literal para especificar um endereço de email permanente ou usar o endereço de email padrão do destinatário especificado no perfil do destinatário. Você pode usar o literal ou uma variável para especificar o endereço de email de um grupo. A opção de variável é útil para recuperar e usar dinamicamente um endereço de email. A opção Usar endereço de email padrão do destinatário é somente para um único destinatário. Nesse caso, o endereço de email armazenado no perfil de usuário designado é usado.
-
Modelo de email do HTML: selecione o modelo de email para o email de notificação. Para editar um modelo, modifique o arquivo localizado em /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt no repositório crx.
-
Permitir delegação para: a Caixa de Entrada AEM fornece uma opção ao usuário conectado para delegar o fluxo de trabalho atribuído a outro usuário. Você tem permissão para delegar no mesmo grupo ou para o usuário de workflow de outro grupo. Se a tarefa for atribuída a um único usuário e a opção permitir delegação a membros do grupo do destinatário for selecionada, não será possível delegar a tarefa a outro usuário ou grupo.
-
Configurações de Compartilhamento: a Caixa de Entrada AEM fornece opções para compartilhar uma única tarefa ou todas as tarefas da caixa de entrada com outro usuário:
- Quando a opção Permitir que o destinatário compartilhe explicitamente na caixa de entrada é selecionada, o usuário pode selecionar a tarefa na Caixa de Entrada AEM e compartilhá-la com outro usuário AEM.
- Quando a opção Permitir que o destinatário compartilhe através do compartilhamento da caixa de entrada estiver selecionada e os usuários compartilharem seus itens da Caixa de Entrada ou permitir que outros usuários acessem seus itens da Caixa de Entrada, somente as tarefas com a opção mencionada anteriormente habilitada serão compartilhadas com outros usuários.
- Quando a opção Permitir que o destinatário autorize usando as configurações 'Ausente' está selecionada. O responsável pode habilitar a opção para delegar a tarefa a outros usuários junto com outras opções de Ausência Temporária. Quaisquer novas tarefas atribuídas ao usuário ausente do escritório são automaticamente delegadas (atribuídas) aos usuários mencionados nas configurações ausentes do escritório.
Ele permite que outros usuários escolham as tarefas atribuídas enquanto estiver fora do escritório e não puder trabalhar nas tarefas atribuídas.
-
Ações > Ações padrão: as ações Enviar, Salvar e Redefinir prontas para uso estão disponíveis. Todas as ações padrão são ativadas, por padrão.
-
Variável de rota: nome da variável de rota. A variável de rota captura as ações personalizadas que um usuário seleciona na Caixa de entrada do AEM.
-
Rotas: uma tarefa pode ramificar para rotas diferentes. Quando selecionado na Caixa de entrada do AEM, o roteiro retorna um valor e o workflow ramifica com base no roteiro selecionado. Você pode armazenar rotas em uma variável de matriz de tipos de dados String ou selecionar Literal para adicionar rotas manualmente.
-
Título da Rota: especifique o título da rota. Ele é exibido na Caixa de entrada do AEM.
-
Ícone Coral: especifique um atributo HTML de um ícone coral. A biblioteca CorelUI do Adobe fornece um vasto conjunto de ícones de primeiro toque. Você pode escolher e usar um ícone para a rota. Ele é exibido junto com o título na Caixa de entrada do AEM. Se você armazenar as rotas em uma variável, elas usarão um ícone de coral "Tags" padrão.
-
Permitir que o destinatário adicione o comentário: selecione esta opção para habilitar comentários para a tarefa. Um signatário pode adicionar os comentários de dentro da Caixa de entrada AEM no momento do envio da tarefa.
-
Salvar comentário na variável: salve o comentário em uma variável do tipo de dados String. Esta opção é exibida somente se você marcar a caixa de seleção Permitir ao signatário adicionar comentário.
-
Permitir que o destinatário adicione anexos à tarefa: selecione esta opção para habilitar anexos para a tarefa. Um destinatário pode adicionar os anexos da Caixa de entrada AEM no momento do envio da tarefa. Você também pode limitar o tamanho máximo (Tamanho Máximo do Arquivo) de um anexo. O tamanho padrão é 2 MB.
-
Salvar anexos de saída da tarefa usando: especifique o local da pasta de anexos. Você pode salvar anexos de saída da tarefa usando um caminho relativo à carga útil ou em uma variável de uma matriz de tipos de dados de documento. Esta opção é exibida somente se você marcar a caixa de seleção Permitir ao signatário adicionar anexos à tarefa e selecionar Formulário adaptável, Formulário adaptável somente leitura ou Documento de PDF não interativo na lista suspensa Tipo, na guia Formulário/Documento.
-
Usar metadados personalizados: selecione esta opção para habilitar o campo de metadados personalizado. Os metadados personalizados são usados em modelos de email.
-
Metadados personalizados: selecione um metadado personalizado para os modelos de email. Os metadados personalizados estão disponíveis no repositório crx em apps/fd/dashboard/scripts/metadataScripts. O caminho especificado não existe no repositório crx. Um administrador cria o caminho antes de usá-lo. Você também pode usar um serviço para os metadados personalizados. Você também pode estender a interface
WorkitemUserMetadataService
para fornecer metadados personalizados. -
Mostrar Dados das Etapas Anteriores: selecione essa opção para permitir que os atribuídos exibam os atribuídos anteriores, as ações já executadas na tarefa, os comentários adicionados à tarefa e o Documento de Registro da tarefa concluída, se disponível.
-
Mostrar dados das etapas subsequentes: selecione essa opção para permitir que o destinatário atual visualize a ação executada e os comentários adicionados à tarefa pelos atribuídos subsequentes. Ela também permite que o destinatário atual visualize um documento de registro da tarefa concluída, se disponível.
-
Visibilidade do tipo de dados: por padrão, um destinatário pode exibir um Documento de Registro, destinatários, ações realizadas e comentários adicionados por destinatários anteriores e subsequentes. Use a opção de visibilidade do tipo de dados para limitar o tipo de dados visível para os atribuídos.
Converter em etapa PDF/A convert-pdfa
PDF/A é um formato de arquivo que permite preservar o conteúdo do documento a longo prazo, incorporando as fontes e descompactando o arquivo. Como resultado, um documento PDF/A geralmente é maior do que um documento PDF padrão. Você pode usar a etapa Converter em PDF/A em um fluxo de trabalho AEM para converter seus documentos PDF para o formato PDF/A.
A etapa converter em PDF/A tem as seguintes propriedades:
Documento de Entrada: o documento de entrada pode ser relativo à carga útil, ter um caminho absoluto, pode ser fornecido como uma carga útil ou armazenado em uma variável do tipo de dados Documento.
Opções de Conversão: Usando esta propriedade, as configurações para converter documentos PDF em documentos PDF/A são especificadas. Várias opções disponíveis nessa guia são:
- Conformidade: especifica o padrão com o qual o PDF/documento de saída deve estar em conformidade. Ele suporta diferentes padrões de PDF, como PDF/A-1b, PDF/A-2b ou PDF/A-3b.
- Nível de Resultado: especifica o nível de resultado como PassFail, Summary ou Detailed para a saída de conversão.
- Espaço de cor: especifica o espaço de cor predefinido como S_RGB, COATED_FOGRA27, JAPAN_COLOR_COATED ou SWOP, que pode ser usado para arquivos PDF/A de saída.
- Conteúdo Opcional: permitir que objetos gráficos e/ou anotações específicos sejam visíveis no PDF de saída/documento A, somente quando um conjunto especificado de critérios for atendido.
Documentos de saída: especifica o local para salvar o arquivo de saída. O arquivo de saída pode ser salvo em um local relativo à carga útil, substitui a carga útil, se a carga útil for um arquivo ou em uma variável do tipo de dados Documento.
Etapa Enviar email send-email-step
Use a etapa do email para enviar um email, por exemplo, um email com um Documento de Registro, um link de um Formulário Adaptável ou um documento PDF anexado. A etapa Enviar email oferece suporte a HTML email. Os emails de HTML são responsivos e se adaptam ao cliente de email dos recipients e ao tamanho da tela. Você pode usar um template de email HTML para definir a aparência, o esquema de cores e o comportamento do email.
A etapa de email usa o Day CQ Mail Service para enviar emails. Antes de usar a etapa de email, verifique se o serviço de email está configurado. Por padrão, o email suporta somente os protocolos HTTP e HTTPs. Contate a equipe de suporte para habilitar as portas para enviar emails e habilitar o protocolo SMTP para o seu ambiente. A restrição ajuda a melhorar a segurança da plataforma.
A etapa de email tem as seguintes propriedades:
Título: o título da etapa ajuda a identificar a etapa no editor de fluxo de trabalho.
Descrição: a explicação é útil para outros desenvolvedores de processo quando você está trabalhando em um ambiente de desenvolvimento compartilhado.
Assunto do Email: o assunto pode ser recuperado de metadados de fluxo de trabalho, especificados manualmente ou recuperados do valor armazenado em uma variável. Selecione entre as seguintes opções:
- Literal especifica manualmente um assunto.
- Recuperar metadados de Fluxo de Trabalho - Recupere o assunto de uma propriedade de metadados.
- Variável - Recupera o assunto do valor armazenado em uma variável do tipo de dados string.
Modelo de email do HTML: modelo de HTML para o email. Você pode especificar variáveis em um template de email. A etapa Email extrai e exibe todas as variáveis incluídas em um modelo para entradas.
Metadados do modelo de email: o valor das variáveis do modelo de email pode ser um valor especificado pelo usuário, o caminho de um ativo no autor ou no servidor de publicação, imagem ou uma propriedade de metadados de fluxo de trabalho.
-
Literal: use a opção quando você souber o valor exato a ser especificado. Por exemplo, example@example.com.
-
Metadados do fluxo de trabalho: use a opção quando o valor a ser usado for salvo em uma propriedade de metadados do fluxo de trabalho. Depois de selecionar a opção, insira o nome da propriedade de metadados na caixa de texto vazia abaixo da opção Metadados do fluxo de trabalho. Por exemplo, emailAddress.
-
Imagem: use a opção para incorporar uma imagem ao email. Depois de selecionar a opção, navegue e escolha a imagem. A opção de imagem está disponível somente para as marcas de imagem (<img src="*"/>) disponíveis no modelo de email.
Endereço de email do remetente/destinatário: selecione a opção Literal para especificar manualmente um endereço de email ou selecione a opção Recuperar metadados do fluxo de trabalho para recuperar o endereço de email de uma propriedade de metadados. Você também pode especificar uma lista de matrizes de propriedades de metadados para a opção Recuperar dos metadados do fluxo de trabalho. Selecione a opção Variável para recuperar o endereço de email do valor armazenado em uma variável do tipo de dados string.
- Anexo de Arquivo: o ativo disponível no local especificado está anexado ao email. O caminho do ativo pode ser relativo à carga ou ao caminho absoluto. Um exemplo de caminho é [Payload_Diretory]/attachments/.
Selecione a opção Variável para recuperar o anexo de arquivo armazenado em uma variável do tipo de dados Documento, XML ou JSON.
Nome do arquivo: nome do arquivo de anexo de email. A Etapa Email altera o nome de arquivo original do anexo para o nome de arquivo especificado. O nome pode ser especificado manualmente ou recuperado de uma propriedade de metadados de fluxo de trabalho ou de uma variável. Use a opção Literal quando você souber o valor exato a ser especificado. Use a opção Variável para recuperar o nome do arquivo do valor armazenado em uma variável do tipo de dados string. Use a opção Recuperar de Metadados de Fluxo de Trabalho quando o valor a ser usado for salvo em uma propriedade de metadados de fluxo de trabalho.
Etapa Gerar documento de registro generate-document-of-record-step
Quando um formulário é preenchido ou enviado, você pode manter um registro do formulário, impresso ou no formato do documento. Esse registro é chamado de Documento de registro (DoR). Você pode usar a etapa Gerar documento de registro para criar uma versão de PDF somente leitura ou interativa de um formulário adaptável. A versão do PDF contém informações preenchidas no formulário junto com o layout do Formulário adaptável.
A etapa Documento de registro tem as seguintes propriedades:
Usar formulário adaptável: especifique o método para localizar o formulário adaptável de entrada. Você pode usar o Formulário adaptável enviado ao fluxo de trabalho, disponível em um caminho absoluto ou disponível em um caminho em uma variável. Você pode usar uma variável do tipo de dados String para especificar o caminho no campo Selecionar variável para resolver.
É possível associar várias Forms adaptáveis a um fluxo de trabalho. Como resultado, você pode especificar um Formulário adaptável no tempo de execução usando os métodos de entrada disponíveis.
Caminho do formulário adaptável: especifique o caminho do formulário adaptável. O campo está disponível ao selecionar a opção Disponível em um caminho absoluto do campo Usar Formulário Adaptável.
Selecione os dados de entrada usando: Caminho dos dados de entrada para o Formulário adaptável. Você pode manter os dados em um local relativo à carga, especificar um caminho absoluto dos dados ou recuperar dados armazenados em uma variável do tipo de dados Documento, JSON ou XML. Os dados de entrada são mesclados com o Formulário adaptável para criar um Documento de registro.
Selecione o caminho do anexo de entrada usando: Caminho dos anexos. Esses anexos são incluídos no documento de registro. Você pode manter os anexos em um local relativo à carga, especificar um caminho absoluto dos anexos ou recuperar anexos armazenados em uma variável de matriz do tipo de dados Documento.
Se você especificar o caminho de uma pasta, por exemplo, anexos, todos os arquivos diretamente disponíveis na pasta serão anexados ao documento de registro. Se houver arquivos disponíveis nas pastas diretamente disponíveis no caminho de anexo especificado, os arquivos serão incluídos no Documento de registro como anexos. Se houver pastas em pastas diretamente disponíveis, elas serão ignoradas.
Salvar documento de registro gerado usando as opções abaixo: especifique o local para manter um documento de registro. Você pode optar por substituir a pasta de carga útil, colocar o Documento de registro em um local no diretório da carga útil ou armazenar o Documento de registro em uma variável do tipo de dados Documento.
Localidade: especifique o idioma do documento de registro. Selecione Literal para selecionar a localidade em uma lista suspensa ou selecione Variável para recuperar a localidade do valor armazenado em uma variável do tipo de dados string. Defina o código do local ao armazenar o valor do local em uma variável. Por exemplo, especifique en_US para inglês e fr_FR para francês.
Chamar etapa DDX invokeddx
O Document Description XML (DDX) é uma linguagem de marcação declarativa cujos elementos representam os blocos fundamentais de documentos. Esses blocos fundamentais incluem documentos PDF e XDP, além de outros elementos, como comentários, marcadores e texto estilizado. O DDX define um conjunto de operações, que podem ser aplicadas em um ou mais documentos de entrada para gerar um ou mais documentos de saída. Um único DDX pode ser usado com uma variedade de documentos de origem. Você pode usar a etapa Invocar DDX em um fluxo de trabalho do AEM para executar várias operações, como Montar, Desmontar documentos, Criar e modificar o Acrobat e o XFA Forms, entre outras, descritas na documentação de Referência do DDX.
A etapa Chamar DDX tem as seguintes propriedades:
Documentos de Entrada: usados para definir propriedades de um documento de entrada. Várias opções disponíveis nessa guia são:
- Especificar DDX Usando: especifica o documento de entrada relativo à carga útil, tem um caminho absoluto, pode ser fornecido como carga útil ou armazenado em uma variável do tipo de dados Documento.
- Criar Mapa a partir da Carga: adicione todos os documentos na pasta da carga ao Mapa do Documento de Entrada para a API de invocação no Assembler. O nome do nó de cada documento é usado como uma chave no mapa.
- Mapa do Documento de Entrada: A opção é usada para adicionar várias entradas usando o botão ADICIONAR. Cada entrada representa a chave do documento no mapa e a origem do documento.
Opções de Ambiente: esta opção é usada para definir as configurações de processamento para invocar API. Várias opções disponíveis nessa guia são:
- Validar Somente: verifica a validade do documento DDX de entrada.
- Falha ao errar: valor booleano para indicar se o serviço de API de invocação falha, se houver ou não um erro. Por padrão, seu valor é definido como Falso.
- Primeiro número de Bates: especifica o número, que é de autoincrementação. Esse número de autoincrementação é exibido em cada página consecutiva automaticamente.
- Estilo padrão: define o estilo padrão para o arquivo de saída.
Documentos de saída: especifica o local para salvar o arquivo de saída. Várias opções disponíveis nessa guia são:
- Salvar Saída na Carga: salva os documentos de saída na pasta da carga útil ou substitui a carga útil; caso a carga seja um arquivo.
- Mapa do Documento de Saída: especifica o local para salvar explicitamente cada arquivo de documento, adicionando uma entrada por documento. Cada entrada representa o documento e o local onde ele deve ser salvo. Se houver vários documentos de saída, essa opção será usada.
Chamar a etapa de serviço do Modelo de dados de formulário (FDM) invoke-form-data-model-service-step
Você pode usar a AEM Forms Integração de Dados para configurar e conectar-se a fontes de dados diferentes. Essas fontes de dados podem ser um serviço Web, um serviço REST, um serviço OData e uma solução de CRM. A Integração de Dados do AEM Forms permite criar um Modelo de Dados de Formulário (FDM) que abrange vários serviços para executar operações de recuperação, adição e atualização de dados no banco de dados configurado. Você pode usar a etapa Invocar Serviço de Modelo de Dados para selecionar um Modelo de Dados de Formulário (FDM) e usar os serviços do FDM para recuperar, atualizar ou adicionar dados a diferentes fontes de dados.
Para explicar entradas para campos da etapa, a seguinte tabela de banco de dados e arquivo JSON são usados como exemplo:
Tabela CustomerDetails de exemplo
Arquivo JSON de exemplo
{
customer: {
firstName: "Sarah",
lastName:"Rose",
customerId: "1",
emailAddress:"srose@we.info"
},
insurance: {
customerId: "1",
policyType: "Premium,
policyNumber: "Premium-521499",
customerDetails: {
firstName: "Sarah",
lastName: "Rose",
customerId: "1",
emailAddress: "srose@we.info"
}
}
}
A etapa Serviço Chamar modelo de dados de formulário (FDM) tem os campos listados abaixo para facilitar as operações do Modelo de dados de formulário (FDM):
-
Título: título da etapa. Ajuda a identificar as etapas no editor de workflow.
-
Descrição: explicação útil para outros desenvolvedores de processo quando você está trabalhando em um ambiente de desenvolvimento compartilhado.
-
Caminho do modelo de dados de formulário: procure e selecione um modelo de dados de formulário (FDM) presente no servidor.
-
Erros e Validações: a opção permite capturar mensagens de erro e especificar opções de validação para dados recuperados e enviados para fontes de dados. Com essas alterações, você pode garantir que os dados transmitidos para a etapa de serviço Chamar modelo de dados de formulário (FDM) sigam as restrições de dados definidas pela fonte de dados. Para obter mais detalhes, consulte Validação automatizada dos dados de entrada
-
Nível de validação: há três categorias de validações: Básica, Completa e DESATIVADA:
- Total: todas as restrições são validadas.
- Básico: somente restrições obrigatórias e anuláveis
- DESATIVADO: Não ocorre validação.
-
Encerrar Fluxo de Trabalho na Falha: quando uma restrição não é validada, o fluxo de trabalho é interrompido.
-
Armazenar código de erro na variável: você pode armazenar um código de erro em uma variável de tipo String.
-
Armazenar Mensagem de Erro na Variável: Você pode armazenar uma mensagem de erro em uma variável de tipo de cadeia de caracteres.
-
Armazenar detalhes do erro na Variável: você pode armazenar detalhes do erro em uma variável de tipo JSON.
-
Serviço: lista dos serviços que o Modelo de Dados de Formulário (FDM) selecionado fornece.
-
Entrada para serviços > Forneça dados de entrada usando metadados literais, variáveis ou de fluxo de trabalho e um arquivo JSON: um serviço pode ter vários argumentos. Selecione a opção para obter o valor dos argumentos de serviço de uma propriedade de metadados do fluxo de trabalho, um objeto JSON, uma variável ou insira o valor diretamente na caixa de texto fornecida:
-
Literal: use a opção quando você souber o valor exato a ser especificado. Por exemplo, srose@we.info.
-
Variável: use a opção para recuperar o valor armazenado em uma variável.
-
Recuperar dos Metadados de Fluxo de Trabalho: use a opção quando o valor a ser usado for salvo em uma propriedade de metadados de fluxo de trabalho. Por exemplo, emailAddress.
-
Relativo à carga: use a opção para recuperar o anexo de arquivo salvo em um caminho relativo à carga. Selecione a opção e especifique o nome da pasta que inclui o anexo de arquivo ou especifique o nome do anexo de arquivo na caixa de texto.
Por exemplo, se a pasta Relativo a Carga no repositório do CRX incluir um anexo de arquivo no local
attachment\attachment-folder
, especifiqueattachment\attachment-folder
na caixa de texto depois de selecionar a opção Relativo a Carga. -
Anotação JSON Dot: use a opção quando o valor a ser usado estiver em um arquivo JSON. Por exemplo, insurance.customerDetails.emailAddress. A opção Anotação JSON Dot estará disponível somente se Mapear campos de entrada da opção JSON de entrada estiver selecionada.
-
Mapear campos de entrada do JSON de entrada: especifique o caminho de um arquivo JSON para obter o valor de entrada de alguns argumentos de serviço do arquivo JSON. O caminho do arquivo JSON pode ser relativo à carga, um caminho absoluto ou você pode selecionar um documento JSON de entrada usando uma variável do tipo JSON ou Form Data Model (FDM).
-
-
Entrada para serviços > Forneça dados de entrada usando variável ou um arquivo JSON: selecione a opção para obter valores para todos os argumentos de um arquivo JSON salvo em um caminho absoluto, em um caminho relativo à carga ou em uma variável.
-
Selecione o documento JSON de entrada usando: o arquivo JSON que contém valores para todos os argumentos de serviço. O caminho do arquivo JSON pode ser relativo à carga ou um caminho absoluto. Você também pode recuperar o documento JSON de entrada usando uma variável do tipo de dados JSON ou Form Data Model (FDM).
-
Anotação JSON Dot: Deixe o campo em branco para usar todos os objetos do arquivo JSON especificado como entrada para argumentos de serviço. Para ler um objeto JSON específico do arquivo JSON especificado como entrada para argumentos de serviço, especifique a notação de pontos para o objeto JSON. Por exemplo, se você tiver um JSON semelhante ao listado no início da seção, especifique insurance.customerDetails para fornecer todos os detalhes de um cliente como entrada para o serviço.
-
Saída do serviço > Mapear e gravar valores de saída na variável ou nos metadados: selecione a opção para salvar os valores de saída como propriedades do nó de metadados da instância do fluxo de trabalho no repositório crx. Especifique o nome da propriedade de metadados e selecione o atributo de saída de serviço correspondente a ser mapeado com a propriedade de metadados, por exemplo, mapeie o phone_number retornado pelo serviço de saída com a propriedade phone_number dos metadados do fluxo de trabalho. Da mesma forma, você pode armazenar a saída em uma variável do tipo de dados Long. Ao selecionar uma propriedade para a opção Atributo de saída de serviço a ser mapeado, somente as variáveis capazes de armazenar dados da propriedade selecionada serão preenchidas para a opção Salvar a saída em.
-
Saída do serviço > Salvar saída na variável ou em um arquivo JSON: selecione a opção para salvar os valores de saída em um arquivo JSON em um caminho absoluto, em um caminho relativo à carga ou em uma variável.
-
Salvar documento JSON de saída usando as opções abaixo: Salve o arquivo JSON de saída. O caminho do arquivo JSON de saída pode ser relativo à carga útil ou a um caminho absoluto. Você também pode salvar o arquivo JSON de saída usando uma variável do tipo de dados JSON ou Form Data Model (FDM).
Etapa Assinar documento sign-document-step
A etapa Assinar Documento permite que você use o Adobe Sign para assinar documentos. Quando você usa a etapa do fluxo de trabalho Adobe Sign para assinar um formulário adaptável, o formulário pode ser passado entre os destinatários um após o outro ou pode ser enviado para todos os destinatários simultaneamente, dependendo da configuração da etapa do fluxo de trabalho. O Adaptive Forms habilitado para Adobe Sign é enviado ao Experience Manager Forms Server somente depois que todos os destinatários concluírem o processo de assinatura.
Por padrão, o serviço Agendador do Adobe Sign verifica (pesquisa) a resposta do recipient a cada 24 horas. Você pode alterar o intervalo padrão do seu ambiente.
A etapa Assinar documento tem as seguintes propriedades:
-
Nome do Contrato: especifique o título do contrato. O nome do contrato torna-se parte do assunto e do corpo do texto do email enviado aos signatários. Você pode armazenar o nome em uma variável do tipo de dados String ou selecionar Literal para adicionar o nome manualmente.
-
Localidade: especifique o idioma para as opções de email e verificação. Você pode armazenar a localidade em uma variável do tipo de dados String ou selecionar Literal para escolher a localidade na lista de opções disponíveis. Você deve definir o código do local ao armazenar o valor do local em uma variável. Por exemplo, especifique en_US para inglês e fr_FR para francês.
-
Configuração da nuvem do Adobe Sign: escolha uma configuração da nuvem Adobe Sign. Se você não tiver configurado o Adobe Sign para AEM Forms, consulte Integrar o Adobe Sign com o AEM Forms.
-
Selecione o Documento a ser assinado usando: você pode escolher um documento de um local relativo à carga útil, usar a carga útil como o documento, especificar um caminho absoluto do documento ou recuperar o documento armazenado em uma variável do tipo de dados Documento.
-
Dias até o prazo: um documento está marcado como vencido (ultrapassou o prazo) depois que não há nenhuma atividade na tarefa para o número de dias especificado no campo Dias até o prazo. O número de dias é contado depois que a documentação é atribuída a um usuário para assinatura.
-
Frequência de Email de Lembrete: você pode enviar um email de lembrete em um intervalo diário ou semanal. A semana é contada a partir do dia em que a documentação é atribuída a um usuário para assinatura.
-
Processo de assinatura: você pode optar por assinar um documento em ordem sequencial ou paralela. Em ordem sequencial, um signatário recebe o documento de cada vez para assinar. Depois que o primeiro signatário terminar de assinar o documento, ele será enviado ao segundo signatário e assim por diante. Em ordem paralela, vários signatários podem assinar um documento de cada vez.
-
URL de redirecionamento: especifique uma URL de redirecionamento. Depois que o documento for assinado, você poderá redirecionar o destinatário para um URL. Normalmente, este URL contém uma mensagem de agradecimento ou mais instruções.
-
Estágio do fluxo de trabalho: um fluxo de trabalho pode ter vários estágios. Esses estágios são exibidos na Caixa de entrada do AEM. Você pode definir esses estágios nas propriedades do modelo ( Sidekick > Página > Propriedades da Página > Estágios).
-
Selecionar Destinatários: especifique o método para escolher os destinatários do documento. Você pode atribuir o fluxo de trabalho de maneira dinâmica a um usuário ou grupo ou adicionar manualmente os detalhes de um recipient. Ao selecionar Manually na lista suspensa, você adiciona detalhes do recipient, como email, função e método de autenticação.
note note NOTE - Na seção Função, você pode especificar a função do destinatário como Signatário, Aprovador, Aceitador, Destinatário certificado, Preenchedor de formulário e Delegador.
- Se você selecionar Delegator na opção Role, o Delegator poderá atribuir a tarefa de assinatura a outro recipient.
- Se você tiver configurado um método de autenticação para Adobe Sign, com base na sua configuração, selecione um método de autenticação, como autenticação com base no Telefone, autenticação com base na Identidade Social, autenticação com base no Conhecimento, autenticação com base na Identidade do Governo.
-
Script ou serviço para selecionar destinatários: a opção estará disponível somente se você selecionar a opção Dinamicamente no campo Selecionar destinatários. Você pode especificar um ECMAScript ou um serviço para escolher assinantes e opções de verificação para um documento.
-
Detalhes do destinatário: a opção só estará disponível se a opção Manually estiver selecionada no campo Select Recipients. Especifique um endereço de email e escolha um mecanismo de verificação opcional. Antes de selecionar um mecanismo de verificação de duas etapas, verifique se a opção de verificação correspondente está habilitada para a conta Adobe Sign configurada. Você pode usar uma variável do tipo de dados String para definir valores para os campos Email, Código do país e Número de telefone. Os campos Código do país e Número de telefone serão exibidos somente se você selecionar Verificação de telefone na lista suspensa de verificação de duas etapas.
-
Documento assinado: você pode salvar o status do documento assinado na variável. Para adicionar uma trilha de auditoria de assinatura eletrônica para maior segurança e legalidade ao Documento assinado, você pode Incluir o Relatório de auditoria. Você pode salvar o Documento assinado usando a pasta Variável ou Carga.
note note NOTE O relatório de auditoria é anexado à última página do documento assinado.
Etapa Gerar Saída Impressa generatePrintedOutput
A etapa gera uma saída PCL, PostScript, ZPL, IPL, TPCL ou DPL, considerando um design de formulário e um arquivo de dados. O arquivo de dados é mesclado com o design do formulário e formatado para impressão. A saída gerada por essa etapa pode ser enviada diretamente para uma impressora ou salva como um arquivo. É recomendável usar essa etapa quando quiser usar designs de formulário ou dados de um aplicativo. Se os designs de formulário estiverem na rede, no sistema de arquivos local ou no local HTTP, use a operação generatePrintedOutput.
Por exemplo, seu aplicativo exige a mesclagem de um design de formulário com um arquivo de dados. Os dados contêm centenas de registros. Além disso, requer que a saída seja enviada para uma impressora que suporte ZPL. O design do formulário e os dados de entrada estão em um aplicativo. Use a operação generatePrintedOutput para mesclar cada registro com um design de formulário e enviar a saída para uma impressora compatível com ZPL.
A etapa Gerar Saída Impressa tem as seguintes propriedades:
Propriedades de entrada
-
Selecionar arquivo de modelo usando: especifique o caminho do arquivo de modelo. Você pode selecionar o arquivo de modelo usando o caminho relativo à carga útil, salvo em um caminho absoluto ou usando uma variável do tipo de dados Documento. Por exemplo, [Payload_Diretory]/Workflow/data.xml. Se o caminho não existir no repositório crx, um administrador poderá criar o caminho antes de usá-lo. Além disso, você também pode aceitar a carga como o arquivo de dados de entrada.
-
Selecionar documento de dados usando: especifique o caminho de um arquivo de dados de entrada. Você pode selecionar o arquivo de dados de entrada usando o caminho relativo à carga útil, salvo em um caminho absoluto ou usando uma variável do tipo de dados Documento. Por exemplo, [Payload_Diretory]/Workflow/data.xml. Se o caminho não existir no repositório crx, um administrador poderá criar o caminho antes de usá-lo.
-
Formato da Impressora: um valor de Formato de Impressão que especifica a linguagem de descrição da página a ser usada, quando um arquivo XDC não for fornecido, para gerar o fluxo de saída. Se você fornecer um valor literal, selecione um destes valores:
- PCL de cor: use a opção para especificar um arquivo XDC para PCL.
- PostScript genérico: use a opção para especificar um arquivo XDC genérico para o PostScript.
- ZPL 300 DPI: use ZPL 300 DPI. O zpl300.xdc é usado.
- ZPL 600 DPI: usar ZPL 600 DPI. O arquivo zpl600.xdc é usado.
- IPL 300 DPI: usar IPL 300 DPI. O ipl300.xdc é usado.
- IPL 400 DPI: usar IPL 400 DPI. O arquivo ipl400.xdc é usado.
- TPCL 600 DPI: Use TPCL 600 DPI. O arquivo tpcl600.xdc é usado.
- PostScript Plain: use a opção para especificar um arquivo XDC de texto simples para o PostScript.
- DPL300DPI: use DPL 300 DPI. A dpl300.xdc é usada.
- DPL400DPI: usar DPL 400 DPI. A dpl400.xdc é usada.
- DPL600DPI: usar DPL 600 DPI. A dpl600.xdc é usada.
- HP_PCL_5e: use a opção para suportar vários dispositivos Canon.
Propriedades de Saída
- Salvar documento de saída usando: especifique o local para salvar o arquivo de saída. Você pode salvar o arquivo de saída em um local relativo à carga útil, em uma variável ou especificar um local absoluto para salvar o arquivo de saída. Se o caminho não existir no repositório crx, um administrador poderá criar o caminho antes de usá-lo.
Propriedades Avançadas
-
Selecione o local da Raiz de Conteúdo usando: a raiz de conteúdo é um valor de cadeia de caracteres que especifica o URI, a referência absoluta ou o local no repositório para recuperar ativos relativos usados pelo design do formulário. Por exemplo, se o design do formulário referenciar uma imagem relativamente, como
../myImage.gif
,myImage.gif
deve estar emrepository://
. O valor padrão érepository://
, que aponta para o nível raiz do repositório.Quando você seleciona um ativo do aplicativo, o caminho do URI da raiz do conteúdo deve ter a estrutura correta. Por exemplo, se um formulário for retirado de um aplicativo chamado SampleApp e for colocado em
SampleApp/1.0/forms/Test.xdp
, o URI da Raiz de Conteúdo deverá ser especificado comorepository://administrator@password/Applications/SampleApp/1.0/forms/
ourepository:/Applications/SampleApp/1.0/forms/
(quando a autoridade for nula). Quando o URI da raiz do conteúdo é especificado dessa maneira, os caminhos de todos os ativos referenciados no formulário são resolvidos em relação a esse URI. -
Selecionar arquivo XCI usando: os arquivos XCI são usados para descrever fontes e outras propriedades usadas para elementos de design de formulário. Você pode manter um arquivo XCI relativo à carga útil, em um caminho absoluto ou usando uma variável do tipo de dados Documento.
-
Localidade: especifica a linguagem usada para gerar o documento PDF. Se você fornecer um valor literal, selecione um idioma na lista ou selecione um destes valores:
-
Para usar o padrão do servidor:
(Padrão) Use a configuração de Local definida no Servidor AEM Forms. A configuração Local é definida usando o Console de administração. (Consulte a Ajuda do Designer.) -
Para usar o valor personalizado:
Digite o código de localidade na caixa literal ou selecione uma variável de cadeia de caracteres que contenha o código de localidade. Para obter uma lista completa de códigos de localidade compatíveis, consulte https://docs.oracle.com/javase/1.5.0/docs/guide/intl/locale.doc.html.
-
-
Cópias: um valor inteiro que especifica o número de cópias a serem geradas para a saída. O valor padrão é 1.
-
Impressão frente e verso: um valor de Paginação que especifica se deve ser usada impressão frente e verso ou frente e verso. As impressoras que suportam PostScript e PCL usam este valor. Se você fornecer um valor literal, selecione um destes valores:
- Edge Longo Duplex: usar impressão frente e verso e impressão com paginação de borda longa.
- Edge curto duplex: use impressão frente e verso e impressão usando paginação de borda curta.
- Simplex: usar impressão em frente e verso.
Etapa Gerar saída de PDF não interativa generatePDFdocuments
- Arraste o workflow Gerar saída de PDF não interativa para a guia Forms Workflow no Sidekick.
- Clique duas vezes na etapa de fluxo de trabalho adicionada para editar o componente.
- Na caixa de diálogo Editar componente, configure documentos de entrada, documentos de saída e parâmetros adicionais e clique em OK.
Documentos de entrada input-documents-3
-
Arquivo de modelo: especifica o local do modelo XDP. É um campo obrigatório.
-
Documento de Dados: especifica o local do xml de dados que deve ser mesclado com o modelo.
Documento de saída output-document
Documento de saída: especifica o nome do formulário de PDF gerado.
Parâmetros adicionais additional-parameters-1
- Raiz de Conteúdo: especifica o caminho para a pasta no repositório onde os fragmentos ou imagens usados no modelo XDP de entrada são armazenados.
- Localidade: especifica a localidade padrão para o formulário de PDF gerado.
- Versão do Acrobat: especifica a versão do Acrobat de destino para o formulário de PDF gerado.
- PDF linearizado: especifica se o PDF gerado deve ser otimizado para exibição na Web.
- PDF marcado: especifica se o PDF gerado deve ficar acessível.
- Documento XCI: especifica o caminho para o arquivo XCI.