Fluxo de trabalho centrado na Forms no OSGi - Referência em etapas

Etapas do Forms Workflow

As etapas do fluxo de trabalho do Forms executam operações específicas do AEM Forms em um fluxo de trabalho AEM. Essas etapas permitem que você crie rapidamente formulários adaptáveis com base no fluxo de trabalho centrado no Forms no OSGi. Esses fluxos de trabalho podem ser usados para desenvolver fluxos de trabalho básicos de revisão e aprovação, processos de negócios internos e entre firewall. Você também pode usar as etapas do Forms Workflow para iniciar serviços de documento, integrar com o fluxo de trabalho de assinatura do Adobe Sign e executar outras operações do AEM Forms. Você precisa do complemento AEM Forms para usar essas etapas em um fluxo de trabalho.

Atribuir etapa da tarefa

A etapa Atribuir tarefa cria uma tarefa e a atribui a um usuário ou grupo. Ao atribuir a 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 a entrada de usuários e um 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 o componente para controlar o comportamento da tarefa. Por exemplo, criar um documento automático de registro, atribuir a tarefa a um usuário ou grupo específico, especificar o caminho dos dados enviados, especificar o caminho dos dados a serem preenchidos previamente e especificar ações padrão. A etapa Atribuir tarefa tem as seguintes propriedades:

  • Título: Título da tarefa. O título é exibido AEM Caixa de entrada.

  • 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 de miniatura: caminho da miniatura da tarefa. Se nenhum caminho for especificado, para uma miniatura padrão de formulário adaptável será exibida e para 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 de 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 de AEM. As opções disponíveis são Alto, Médio e Baixo. O valor padrão é Médio.

  • Data de Vencimento: Especifique o número de dias ou horas após as quais a tarefa está marcada como vencida. Se você selecionar Off, a tarefa nunca será marcada como atrasada. 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 do qual a tarefa deve ser concluída. O número de dias é contado após a tarefa ser atribuída a um usuário. Se uma tarefa não estiver concluída e cruzar o número de dias especificado no campo Dias , então, se selecionado, um manipulador de tempo limite será acionado após a data de vencimento.

  • Horas: O número de horas antes do qual a tarefa deve ser concluída. O número de horas é contado após a tarefa ser atribuída a um usuário. Se uma tarefa não estiver concluída e cruzar o número de horas especificado no campo Horas , então, se selecionado, um manipulador de tempo limite será acionado após as horas de vencimento.

  • Tempo limite após a data de vencimento: selecione essa opção para ativar o campo de seleção Manipulador de tempo limite.

  • Manipulador de tempo limite: selecione o script a ser executado quando a etapa Atribuir tarefa atravessar 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 esta opção para exibir a última ação que foi tomada 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, interface do usuário do Agente de Comunicação Interativa ou Documento do Canal da Web de Comunicação Interativa.

  • Usar o 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 Adaptive form ou Read-only adaptive form na lista suspensa Type . É possível usar o formulário adaptável enviado para o 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.
    Você pode associar vários formulários 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.

  • Usar comunicação interativa: especifique o método para localizar a comunicação interativa de entrada. Você pode usar a comunicação interativa enviada para o workflow, 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. Essa opção estará disponível se você selecionar Interative Communication Agent UI ou Interative Communication Web Channel Document na lista suspensa Tipo.

OBSERVAÇÃO

Você deve ter usuários com agente-cm e atribuições de grupo de usuários de fluxo de trabalho para acessar a interface do Agente de Comunicações Interativas AEM caixa de entrada.

  • Formulário adaptável ou caminho de comunicação interativa: Especifique o caminho do formulário adaptável ou da Comunicação interativa. Você pode usar o formulário adaptável ou a comunicação interativa enviada ao workflow, 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 string.

  • Selecionar PDF de entrada usando: Especifique o caminho de um documento PDF não interativo. O campo fica 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, salvo em um caminho absoluto ou usando uma variável do tipo de dados Documento. Por exemplo, [Diretório_de_carga]/Workflow/PDF/credit-card.pdf. O caminho não existe no repositório crx. Um administrador cria o caminho antes de usá-lo. É necessário ativar uma opção Documento de registro ou formulários adaptáveis baseados em modelo de formulário 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, é possível renderizar o formulário adaptável como um formulário adaptável somente leitura ou um documento PDF. É necessário ativar uma opção Documento de registro ou formulários adaptáveis baseados em modelo de formulário para renderizar o formulário adaptável como Documento de registro.

  • Pré-preenchido: os seguintes campos listados abaixo atuam como entradas da 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). 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 Document, XML ou JSON. Por exemplo, o arquivo contém os dados enviados para o formulário por meio de um aplicativo AEM Caixa de entrada. Um caminho de exemplo é [Payload_Diretory]/workflow/data.

    • Selecionar anexos de entrada usando: Os anexos disponíveis no local são anexados ao formulário associado à tarefa. O caminho é sempre relativo à carga útil. Um caminho de exemplo é [Diretório_de_Carga]/anexos/

    • Escolha o JSON de entrada: selecione um arquivo JSON de entrada usando um caminho relativo à carga útil ou armazenado em uma variável do tipo de dados Documento, JSON ou Modelo de dados de formulário. Essa opção estará disponível se você selecionar Interative Communication Agent UI ou Interative Communication Web Channel Document na lista suspensa Tipo.

    • Escolha um serviço de preenchimento prévio personalizado: Selecione o serviço de preenchimento prévio para recuperar os dados e preencher previamente o documento do canal Web de Comunicação Interativa ou a interface do usuário do agente.

    • Use o serviço de preenchimento prévio da comunicação interativa selecionada acima: Use esta opção para usar o serviço de preenchimento prévio da Comunicação interativa definida na lista suspensa Usar comunicação interativa .

    • Mapeamento de atributo da solicitação: use a seção Mapeamento de atributo da solicitação para definir o nome e o valor do atributo da solicitação. Recupere os detalhes da fonte de dados com base no nome e no valor do atributo especificados 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.\

      As opções de mapeamento de atributo de solicitação e serviço de preenchimento prévio estarão disponíveis somente se você selecionar Interface do usuário do Agente de Comunicação Interativa ou Documento do Canal da Web de Comunicação Interativa na lista suspensa Tipo .

  • Informações enviadas: os seguintes campos listados abaixo servem como locais de saída para a tarefa:

    • Salve o arquivo de dados de saída usando: Salve o arquivo de dados (.json,. xml, .doc ou modelo de dados de formulário). 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 ou armazená-lo em uma variável do tipo de dados Document, XML ou JSON. Por exemplo, [Payload_Diretory]/Workflow/data, onde os dados são um arquivo.

    • Salvar anexos usando: Salve os anexos do formulário em uma tarefa. Você pode salvar os anexos usando um caminho relativo à carga útil ou armazená-lo em uma variável do tipo de dados Documento.

    • Salvar documento de registro usando: caminho para salvar um arquivo de documento de registro. Por exemplo, [Diretório_de_carga]/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 do Documento. Se você selecionar a opção Relative to Payload, o Documento de registro não será gerado se o campo de caminho ficar vazio. Essa opção só estará disponível se você selecionar Adaptive form na lista suspensa Type .

    • Salvar dados do Canal da Web usando: Salve o arquivo de dados do Canal da Web usando um caminho relativo à carga ou armazene-o em uma variável do tipo de dados Documento, JSON ou Modelo de dados de formulário. Essa opção só estará disponível se você selecionar Interface do usuário do Agente de Comunicação Interativa na lista suspensa Tipo .

    • Salvar documento PDF usando: Salve o documento PDF usando um caminho relativo à carga ou armazene-o em uma variável do tipo de dados Documento. Essa opção só estará disponível se você selecionar Interface do usuário do Agente de Comunicação Interativa na lista suspensa Tipo .

    • Salvar modelo de layout usando: Salve o modelo de layout usando um caminho relativo à carga ou armazene-o em uma variável do tipo de dados Documento. O modelo de layout se refere a um arquivo XDP criado usando o Forms Designer. Essa opção só estará disponível se você selecionar Interface do usuário do Agente de Comunicação Interativa na lista suspensa Tipo .

  • Destinatário > Atribuir opções: 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 do Seletor de Participante ou atribuir a tarefa a um usuário ou grupo de AEM específico.

  • Seletor de participante: a opção está disponível quando a opção ​Dinamicamente para um usuário ou grupo é selecionada no campo Atribuir opções . 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 do Adobe Experience Manager Dynamic Participant.

  • Participantes: o campo fica disponível quando a opção com.adobe.granite.workflow.core.process. RandomParticipantChooseroption é selecionada no campo Escolher participante . O campo permite selecionar usuários ou grupos para a opção RandomParticipantChooser.

  • Destinatário: O campo está disponível quando o com.adobe.fd.workspace.step.service. VariableParticipantChooseris é selecionado no campo Escolher Participante. O campo permite selecionar uma variável do tipo de dados String para definir o destinatário.

  • Argumentos: O campo fica disponível quando um script diferente do script RandomParticipantChoose é selecionado no campo Seletor de Participante. O campo permite fornecer uma lista de argumentos separados por vírgula para o script selecionado no campo Seletor de participante.

  • Usuário ou grupo: a tarefa é atribuída ao usuário ou grupo selecionado. A opção está disponível quando a opção To a specific user or group option é selecionada no campo Assign options. O campo lista todos os usuários e grupos do grupo de usuários do fluxo de trabalho.
    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 de se você tem permissões de acesso no nó users no repositório crx para esse usuário específico.

  • Enviar email de notificação: Selecione essa 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 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 na recuperação dinâmica e no uso de um endereço de email. A opção Use o 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 atribuído é usado.

  • Modelo de email 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 crx-repository.

  • Permitir delegação para: AEM Caixa de entrada fornece uma opção para o usuário conectado delegar o fluxo de trabalho atribuído a outro usuário. Você pode delegar no mesmo grupo ou no 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 aos membros do grupo do destinatário estiver selecionada, então não será possível delegar a tarefa a outro usuário ou grupo.

  • Configurações de compartilhamento: AEM Caixa de entrada fornece opções para compartilhar uma única ou todas as tarefas na caixa de entrada com outros usuários:

    • Quando a opção Permitir que o destinatário compartilhe explicitamente na caixa de entrada estiver selecionada, o usuário poderá clicar na tarefa e compartilhá-la com outro usuário AEM.
    • Quando a opção Permitir que o destinatário compartilhe via caixa de entrada compartilhando estiver selecionada e um usuário compartilhar 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 ativada serão compartilhadas com outros usuários.
  • Ações > Ações padrão: As ações prontas para uso, Enviar, Salvar e Redefinir estão disponíveis. Todas as ações padrão são habilitadas, por padrão.

  • Variável de rota: Nome da variável de rota. A variável de rota captura ações personalizadas que um usuário seleciona AEM Caixa de entrada.

  • Rotas: uma tarefa pode ramificar para rotas diferentes. Quando selecionada em AEM Caixa de entrada, a rota retorna um valor e o workflow ramifica com base na rota selecionada. Você pode armazenar rotas em uma variável de matriz do tipo de dados String ou selecionar Literal para adicionar rotas manualmente.

  • Título: Especifique o título da rota. Exibido em AEM Caixa de entrada.

  • Ícone Coral: Especifique o atributo HTML de um ícone de coral. Adobe A biblioteca CorelUI fornece um vasto conjunto de ícones de toque primeiro. Você pode escolher e usar um ícone para a rota. Ele é exibido junto com o título em AEM Caixa de entrada. Se você armazenar as rotas em uma variável, as rotas usarão um ícone de coral "Tags" padrão.

  • Permitir ao destinatário adicionar comentário: Selecione esta opção para habilitar comentários para a tarefa. Um destinatário pode adicionar os comentários de dentro AEM Caixa de entrada no momento do envio da tarefa.

  • Salve o comentário na variável: salve o comentário em uma variável do tipo de dados String. Essa opção é exibida somente se você marcar a caixa de seleção Permitir que o destinatário adicione comentário.

  • Permitir ao destinatário adicionar anexos à tarefa: Selecione esta opção para ativar anexos para a tarefa. Um destinatário pode adicionar os anexos de dentro AEM Caixa de entrada no momento do envio da tarefa.

  • Salve os anexos da tarefa de saída usando: Especifique a localização da pasta de anexos. Você pode salvar anexos de tarefa de saída usando um caminho relativo à carga ou em uma variável de matriz de tipo de dados do documento. Essa opção é exibida somente se você marcar a caixa de seleção Permitir que o destinatário adicione anexos à tarefa e selecionar Formulário adaptável, Formulário adaptável somente leitura ou Documento PDF não interativo na lista suspensa Tipo na guia Form/Document.

OBSERVAÇÃO

Use a guia Anexos na interface do agente durante o tempo de execução para associar os anexos a uma Comunicação interativa. Os anexos associados são exibidos como anexos de tarefa no sidekick depois de abrir o item de trabalho em um estado Concluído.

  • Usar metadados personalizados: selecione essa opção para ativar o campo de metadados personalizado. Os metadados personalizados são usados em modelos de email.
  • Metadados personalizados: selecione um metadados 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. Também é possível estender a interface WorkitemUserMetadataService para fornecer metadados personalizados.
  • Mostrar dados das etapas anteriores: Selecione esta opção para permitir que os destinatários visualizem os destinatários anteriores, a ação já executada na tarefa, os comentários adicionados à tarefa e o documento de registro da tarefa concluída, se disponível.
  • Mostrar dados de etapas subsequentes: selecione essa opção para permitir que o destinatário atual exiba a ação tomada e os comentários adicionados à tarefa pelos destinatários subsequentes. Também permite que o destinatário atual exiba um documento de registro da tarefa concluída, se disponível.
  • Visibilidade do tipo de dados: por padrão, um destinatário pode visualizar um Documento de registro, destinatários, ações tomadas e comentários que destinatários anteriores e subsequentes adicionaram. Use a opção visibility of data type para limitar o tipo de dados visível para os destinatários.

Etapa Enviar Email

Use a etapa de email para enviar um email, por exemplo, um email com um documento de registro, link de um formulário adaptável, link de uma comunicação interativa ou com um documento PDF anexado. A etapa Enviar email oferece suporte a email HTML. Os emails HTML são responsivos e adaptáveis 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. 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 processos 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 dentre as seguintes opções:

  • Literal - Especifique um assunto manualmente.
  • Recuperar dos metadados do fluxo de trabalho - recupere o assunto de uma propriedade de metadados.
  • Variável - recupere o assunto do valor armazenado em uma variável do tipo de dados da string.

Modelo de email HTML: Modelo HTML para o email. Você pode especificar variáveis em um modelo de email. A Etapa de email extrai e exibe todas as variáveis incluídas em um modelo para entradas.

Metadados de 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, na imagem ou em uma propriedade de metadados de workflow.

  • Literal: use a opção quando souber o valor exato a ser especificado. Por exemplo, example@example.com.

  • 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. Após 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.

  • URL do ativo: use a opção para incorporar um link da Web de uma comunicação interativa ao email. Após selecionar a opção , navegue e escolha a comunicação interativa a ser incorporada. O ativo pode residir no autor ou no servidor de publicação.

  • 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 tags de imagem (<img src="*"/>) disponíveis no modelo de email.

Endereço de email do remetente/destinatário: selecione a opção ​Literalpara especificar manualmente um endereço de email ou selecione a opção Recuperar dos 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 de metadados do fluxo de trabalho. Selecione a opção Variable para recuperar o endereço de email do valor armazenado em uma variável do tipo de dados da string.

Anexo de arquivo: o ativo disponível no local especificado é anexado ao email. O caminho do ativo pode ser relativo à carga ou ao caminho absoluto. Um caminho de exemplo é [Payload_Diretory]/attachments/.

Selecione a opção Variable para recuperar o anexo de arquivo armazenado em uma variável do tipo de dados Document, XML ou JSON.

Nome do arquivo: Nome do arquivo de anexo de email. A Etapa de 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 workflow ou de uma variável. Use a opção Literal quando souber o valor exato a ser especificado. Use a opção Variable para recuperar o nome do arquivo do valor armazenado em uma variável do tipo de dados da string. Use a opção Recuperar de um Metadado 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

Quando um formulário é preenchido ou enviado, é possível manter um registro do formulário, em formato impresso ou documento. Isso é chamado de Documento de Registro (DoR). Você pode usar a etapa Gerar documento de registro para criar uma versão PDF somente leitura ou interativa de um formulário adaptável. A versão em PDF contém informações preenchidas para o formulário junto com o layout do formulário adaptável.

A etapa Documento de registro tem as seguintes propriedades:

Usar o formulário adaptável: Especifique o método para localizar o formulário adaptável de entrada. É possível usar o formulário adaptável enviado para o 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 Select variable to resolve.
Você pode associar vários formulários 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 fica disponível quando você seleciona a opção Available at an absoluto path do campo Use Adaptive Form.

Selecione Input data using: Path of the input data for the adaptive form. 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 Document, JSON ou XML. Os dados de entrada são unidos ao formulário adaptável para criar um documento de registro.

Selecione Input attachment path usando: Caminho dos anexos. Esses anexos estã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 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 algum arquivo estiver disponível 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 Gerado de Registro usando as opções abaixo: Especifique o local para manter um documento de arquivo de registro. Você pode optar por substituir a pasta de carga útil, colocar o documento de registro em um local dentro do diretório de carga 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 de uma lista suspensa ou selecione Variável para recuperar a localidade do valor armazenado em uma variável do tipo de dados da string. Você deve definir o código local enquanto armazena o valor da localidade em uma variável. Por exemplo, especifique en_US para inglês e fr_FR para francês.

Invoque a etapa Serviço do Modelo de Dados de Formulário

Você pode usar AEM Forms Data Integration para configurar e se conectar a fontes de dados diferentes. Essas fontes de dados podem ser um banco de dados, serviço da Web, serviço REST, serviço OData e solução CRM. A Integração de dados do AEM Forms permite criar um modelo de dados de formulário que abrange vários serviços para executar operações de recuperação de dados, além de atualizar no banco de dados configurado. Você pode usar a Invoke Data Model Service step para selecionar um modelo de dados de formulário (FDM) e usar os serviços do FDM para recuperar, atualizar ou adicionar dados a fontes de dados diferentes.

Para explicar entradas para campos da etapa, a tabela de banco de dados a seguir e o arquivo JSON são usados como exemplo :

Tabela de detalhes do cliente de exemplo

Propriedade Valor
Nome
Sarah
Sobrenome Rosa
Customer ID 1
Endereço de email
srose@we.info

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 Invocar serviço de modelo de dados de formulário tem os campos listados abaixo para facilitar as operações do modelo de dados de formulário:

  • Título: Título da etapa. Ajuda a identificar a etapa no editor de fluxo de trabalho.

  • 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 presente no servidor.

  • Serviço: Lista dos serviços fornecidos pelo modelo de dados de formulário selecionado.

  • Entrada para serviços > Fornecer 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 de workflow, um objeto JSON, uma variável ou insira diretamente o valor na caixa de texto fornecida:

    • Literal: use a opção quando 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 do 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.

    • Em relação à Carga: Use a opção para recuperar o anexo de arquivo salvo em um caminho relativo à carga útil. Selecione a opção e especifique o nome da pasta que inclui o anexo do arquivo ou especifique o nome do anexo do arquivo na caixa de texto.

      Por exemplo, se a pasta Relative to Payload no repositório CRX incluir um anexo de arquivo no local attachment\attachment-folder, especifique attachment\attachment-folder na caixa de texto depois de selecionar a opção Relative to Payload.

    • Notação de ponto JSON: use a opção quando o valor a ser usado estiver em um arquivo JSON. Por exemplo, Insurance.customerDetails.emailAddress. A opção Notação de pontos JSON só estará disponível se a opção Mapear campos de entrada do 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.

  • Entrada de serviços > Fornecer dados de entrada usando uma 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 ao payload ou um caminho absoluto . Também é possível recuperar o documento JSON de entrada usando uma variável do tipo de dados JSON ou Form Data Model.

  • Notação de ponto JSON: 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 em variáveis ou metadados: Selecione a opção para salvar os valores de saída como propriedades do nó de metadados da instância de fluxo de trabalho no crx-repository. 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 Long data.Quando você seleciona uma propriedade para o atributo Service output a ser mapeado opção, somente as variáveis capazes de armazenar dados da propriedade selecionada são preenchidas para a opção Save the output to.

  • Saída de 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 .

  • Salve o 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 ou a um caminho absoluto. Também é possível salvar o arquivo JSON de saída usando uma variável do tipo de dados JSON ou Form Data Model.

Etapa Assinar documento

A etapa Assinar documento permite usar o Adobe Sign para assinar documentos. A etapa Assinar documento tem as seguintes propriedades:

  • Nome do Contrato: Especifique o título do contrato. O nome do contrato se torna parte do assunto e do texto do corpo 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.

  • Local: 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 local enquanto armazena o valor da localidade em uma variável. Por exemplo, especifique en_US para inglês e fr_FR para francês.

  • Configuração da Adobe Sign Cloud: Escolha uma Configuração da Adobe Sign Cloud. Se você não tiver configurado o Adobe Sign para AEM Forms, consulte Integrar Adobe Sign com AEM Forms.

  • Selecionar Documento a ser assinado usando: Você pode escolher um documento de um local relativo à carga, usar carga como 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 é marcado como vencido (prazo vencido) após não haver atividade na tarefa para o número de dias especificado no campo Dias até o Prazo. O número de dias é contado depois que o documento é atribuído a um usuário para assinatura.

  • Frequência de email do lembrete: você pode enviar um email de lembrete em um intervalo diário ou semanal. A semana é contada a partir do dia em que o documento foi atribuído 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 assinante recebe o documento por vez para assinatura. Depois que o primeiro assinante concluir a assinatura do documento, o documento será enviado para o segundo assinante e assim por diante. Em ordem paralela, vários signatários podem assinar um documento de cada vez.

  • URL de redirecionamento: especifique um 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 de AEM. É possível definir esses estágios nas propriedades do modelo (Sidekick > Página > Propriedades da página > Estágios).

  • Selecionar assinantes: Especifique o método para escolher os assinantes do documento. Você pode atribuir dinamicamente o fluxo de trabalho a um usuário ou grupo ou adicionar manualmente detalhes de um assinante.

  • Script ou serviço para selecionar signatários: A opção só estará disponível se a opção Dinamicamente estiver selecionada no campo Selecionar assinantes. Você pode especificar um ECMAScript ou um serviço para escolher assinantes e opções de verificação para um documento.

  • Detalhes do assinante: a opção só estará disponível se a opção Manualmente estiver selecionada no campo Selecionar assinantes . Especifique o 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 do 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 são exibidos somente se você selecionar Verificação de telefone na lista suspensa Verificação de duas etapas.

  • Variável de status: um documento habilitado para Adobe Sign armazena o status de assinatura do documento em uma variável do tipo de dados String. Especifique o nome da variável de status (adobeSignStatus). Uma variável de status de uma instância está disponível no CRXDE em /etc/workflow/instances/<server>/<date-time>/<instance of workflow model>/workItems/<node>/metaData contém o status de uma variável.

  • Salvar documento assinado usando as opções abaixo: Especifique o local onde manter documentos assinados. Você pode optar por substituir o arquivo de carga útil, colocar o documento assinado em um local dentro do diretório de carga ou armazenar o documento assinado em uma variável do tipo Documento.

Etapas dos Serviços de documento

AEM serviços de documento são um conjunto de serviços para criar, montar e proteger documentos PDF. O AEM Forms fornece uma etapa AEM Fluxo de trabalho separada para cada serviço de documento.

Semelhante a outras etapas do fluxo de trabalho do AEM Forms, como Atribuir tarefa, Enviar email e Assinar documento, você pode usar variáveis em todas as etapas AEM serviços de documento. Para obter mais informações sobre como criar e gerenciar variáveis, consulte Variáveis AEM workflows.

Aplicar etapa Carimbo de data/hora do documento

Adicionar carimbo de data/hora a um documento. Você fornece detalhes do documento, como caminho do documento de entrada, nome do documento de entrada, local para armazenar dados exportados. Você pode optar por substituir o arquivo de carga útil existente, escolher um nome de arquivo diferente para armazenar dados em um arquivo diferente na pasta de carga útil, fornecer um caminho absoluto para os dados ou armazenar dados em uma variável do tipo de dados Documento.

Converter em etapa da imagem

Converte um documento PDF em uma lista de imagens. Os formatos de imagem compatíveis são JPEG, JPEG2000, PNG e TIFF. As seguintes informações se aplicam a conversões para imagens TIFF:

  • Um arquivo TIFF de várias páginas é gerado.
  • Algumas anotações não são incluídas em imagens TIFF. As anotações que exigem que o Acrobat gere sua aparência não são incluídas.

Etapa Converter em PDF/A

Converte um documento PDF em formato PDF/A usando as opções fornecidas. A versão PDF/A do Portable Document Format (PDF) é especializada no arquivamento e na preservação de documentos a longo prazo.

Etapa Converter em PS

Converta documentos PDF em PostScript. Ao converter para PostScript, você pode usar a operação de conversão para especificar o documento de origem e se deve ser convertido para o nível 2 ou 3 do PostScript. O documento PDF que você converte em um arquivo PostScript deve ser não interativo.

Criar PDF a partir da etapa de tipo especificada

Gere um documento PDF a partir de um arquivo de entrada. O documento de entrada pode ser relativo à carga, ter um caminho absoluto, pode ser a própria carga ou armazenado em uma variável do tipo de dados Documento.

Criar PDF a partir da etapa URL/HTML/ZIP

Gera um documento PDF a partir de URL, HTML e arquivo ZIP fornecidos.

Etapa Exportar dados

Exporta dados de um arquivo PDF forms ou XDP. Ele requer que você insira o caminho de arquivo do Documento de entrada e o Formato de dados de exportação. As opções para Exportar formato de dados são Auto, XDP e XmlData.

Export PDF para a etapa de tipo especificada

Converte um documento PDF em um formato selecionado.

Etapa Gerar PDF não interativo

Gere um PDF não interativo. Ele fornece várias opções de personalização.

OBSERVAÇÃO

Você pode usar variáveis para especificar o arquivo de modelo para documentos de entrada. Armazene o caminho do arquivo de modelo em uma variável do tipo de dados String .

Etapa Importação de dados

Une dados de formulário em um formulário PDF. É possível importar dados de formulário para um formulário PDF.

Invocar etapa DDX

Executa o arquivo DDX no mapa especificado de documentos de entrada e retorna os documentos PDF manipulados.

OBSERVAÇÃO

Você pode usar variáveis para especificar o arquivo DDX para documentos de entrada. Armazene o arquivo DDX em uma variável do tipo de dados Document ou XML.

Optimize PDF step

Otimiza arquivos PDF, reduzindo seu tamanho. O resultado dessa conversão são arquivos PDF que podem ser menores do que suas versões originais. Essa operação também converte documentos PDF na versão PDF especificada nos parâmetros de otimização.

As configurações de otimização especificam como os arquivos são otimizados. Estas são as configurações de exemplo:

  • Versão do PDF de destino
  • Descartar objetos, como ações do JavaScript e miniaturas de página incorporadas
  • Descartar dados do usuário, como comentários e anexos de arquivo
  • Descartar configurações inválidas ou não usadas
  • Compactação de dados descompactados ou uso de algoritmos de compactação mais eficientes
  • Remoção de fontes incorporadas
  • Configuração de valores de transparência

Renderizar etapa do formulário PDF

Renderiza um formulário criado no Form Designer (XDP) em um formulário PDF.

OBSERVAÇÃO

Você pode usar variáveis para especificar o arquivo de modelo para documentos de entrada. Armazene o caminho do arquivo de modelo em uma variável do tipo de dados String .

Etapa do Documento Seguro

Criptografar, assinar e certificar um documento. O AEM Forms suporta criptografia baseada em senha e certificado. Você também pode escolher entre vários algoritmos para assinar documentos. Por exemplo, SHA-256 e SH-512. Você também pode usar a etapa do fluxo de trabalho para o leitor estender documentos PDF. A etapa do fluxo de trabalho fornece opções para habilitar a decodificação de códigos de barras, assinaturas digitais, importação e exportação de dados PDF e outras opções.

Enviar para etapa da impressora

Envie um documento diretamente para uma impressora. Ele suporta os seguintes mecanismos de acesso de impressão:

  • Impressora acessível diretamente: Uma impressora instalada no mesmo computador é chamada de impressora acessível diretamente e o computador é nomeado host da impressora. Esse tipo de impressora pode ser uma impressora local conectada diretamente ao computador.
  • Impressora direta acessível: A impressora instalada em um servidor de impressão é acessada de outros computadores. Tecnologias como o CUPS (Common UNIX® Printer System) e o protocolo LPD (Line Printer Daemon) estão disponíveis para se conectar a uma impressora de rede. Para acessar uma impressora indireta acessível, especifique o IP ou o nome do host do servidor de impressão. Usando esse mecanismo, você pode enviar um documento para um URI LPD quando a rede tiver um LPD em execução. O mecanismo permite rotear o documento para qualquer impressora conectada à rede com um LPD em execução.

Etapa Gerar Saída Impressa

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 é unido ao design de formulário e formatado para impressão. A saída gerada por esta etapa pode ser enviada diretamente para uma impressora ou salva como arquivo. É recomendável usar essa etapa quando quiser usar designs de formulário ou dados de um aplicativo. Se os designs de formulário ou designs de formulário estiverem localizados na rede, no sistema de arquivos local ou no local HTTP, use a operação generatePrintedOutput .

Por exemplo, seu aplicativo requer que você mescle 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 de formulário e seus dados de entrada estão localizados em um aplicativo. Use a operação generatePrintedOutput para unir cada registro a um design de formulário e enviar a saída para uma impressora que ofereça suporte a ZPL.

A etapa Gerar saída impressa tem as seguintes propriedades:

Propriedades de entrada

  • Selecione o 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, [Diretório_de_carga]/Workflow/data.xml. Se o caminho não existir no crx-repository, um administrador pode criar o caminho antes de usá-lo. Além disso, também é possível aceitar a carga como 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, [Diretório_de_carga]/Workflow/data.xml. Se o caminho não existir no crx-repository, um administrador pode 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 personalizado: Use a opção para especificar um arquivo XDC personalizado para PCL.
    • PostScript personalizado: Use a opção para especificar um arquivo XDC personalizado para PostScript.
    • ZPL personalizado: Use a opção para especificar um arquivo XDC personalizado para ZPL.
    • PCL de cor genérica (5c): Use uma cor genérica PCL (5c).
    • Nível 3 de PostScript Genérico: Use o PostScript Nível 3 genérico.
    • ZPL 300 DPI: Utilizar ZPL 300 DPI. O zpl300.xdc é usado.
    • ZPL 600 DPI: Utilizar ZPL 600 DPI. O arquivo zpl600.xdc é usado.
    • IPL personalizado: Use a opção para especificar um arquivo XDC personalizado para IPL.
    • IPL 300 DPI: Utilizar IPL 300 DPI. O ipl300.xdc é usado.
    • IPL 400 DPI: Utilizar IPL 400 DPI. O arquivo ipl400.xdc é usado.
    • TPCL personalizado: Use a opção para especificar um arquivo XDC personalizado para TPCL.
    • TPCL 305 DPI: Use TPCL 300 DPI. O arquivo tpcl305.xdc é usado.
    • PCL 600 DPI: Use TPCL 600 DPI. O arquivo tpcl600.xdc é usado.
    • DPL personalizado: Use a opção para especificar um arquivo XDC personalizado DPL.
    • DPL300DPI: Utilizar DPL 300 DPI. O arquivo dpl300.xdc é usado.
    • DPL406DPI: Utilizar DPL 400 DPI. O dpl406.xdc é usado.
    • DPL600DPI: Utilizar DPL 600 DPI. O dpl600.xdc é usado.

Propriedades de saída

  • Salve o 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, em uma variável ou especificar um local absoluto para salvar o arquivo de saída. Se o caminho não existir no crx-repository, um administrador pode criar o caminho antes de usá-lo.

Propriedades avançadas

  • Selecione o local raiz do conteúdo usando: A raiz de conteúdo é um valor de string que especifica o URI, a referência absoluta ou o local no repositório para recuperar os ativos relativos usados pelo design de formulário. Por exemplo, se o design de formulário fizer referência a uma imagem relativamente, como …/myImage.gif, myImage.gif deve estar localizado em repository://. O valor padrão é repository://, que aponta para o nível raiz do repositório.

    Quando você seleciona um ativo do seu aplicativo, o caminho do URI da raiz de conteúdo deve ter a estrutura correta. Por exemplo, se um formulário for extraído 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 como repository://administrator@password/Applications/SampleApp/1.0/forms/, ou o repositório:/Applications/SampleApp/1.0/forms/ (quando a autoridade for nula). Quando o URI raiz do conteúdo é especificado dessa forma, os caminhos de todos os ativos referenciados no formulário serão resolvidos em relação a esse URI.

  • Selecione o 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, em um caminho absoluto ou usando uma variável do tipo de dados Document .

  • Localidade: Especifica o idioma usado 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 Local definida no AEM Forms Server. A configuração Local é configurada usando o Console de administração. (Consulte Ajuda do Designer.)

    • Para usar um valor personalizado: Digite o Código de localidade na caixa literal ou selecione uma variável de string que contenha o código de localidade. Para obter uma lista completa dos códigos de localidade compatíveis, consulte http://java.sun.com/j2se/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 o uso da impressão nos dois lados ou nos dois lados. As impressoras compatíveis com PostScript e PCL usam esse valor. Se você fornecer um valor literal, selecione um destes valores:

    • Borda longa duplex: Use impressão nos dois lados e impressão usando paginação de borda longa.
    • Borda curta duplex: Use impressão nos dois lados e impressão usando paginação de borda curta.
    • Simplex: Use impressão em um único lado.

Nesta página