Show Menu
TÓPICOS×

Integração de aplicativos de terceiros na área de trabalho do AEM Forms

A área de trabalho do AEM Forms suporta o gerenciamento de atividades de conclusão e atribuição de tarefas para formulários e documentos. Esses formulários e documentos podem ser formulários XDP, formulários Flex® ou Guias (obsoletos) que foram renderizados nos formatos XDP, PDF, HTML ou Flex.
Esses recursos são aprimorados ainda mais. Agora, o AEM Forms oferece suporte à colaboração com aplicativos de terceiros que oferecem suporte a funcionalidades semelhantes à área de trabalho dos AEM Forms. Uma parte comum dessa funcionalidade é o fluxo de trabalho da atribuição e aprovação subsequente de uma tarefa. O AEM Forms fornece uma única experiência unificada para usuários corporativos do AEM Forms, para que todas as atribuições ou aprovações de tarefa para os aplicativos suportados possam ser tratadas por meio da área de trabalho do AEM Forms.
Como exemplo, consideremos o Gerenciamento de correspondência como o candidato de amostra para integração com o espaço de trabalho do AEM Forms. O Gerenciamento de correspondência tem o conceito de "Carta", que pode ser renderizada e permite ações.

Criar ativos do Gerenciamento de correspondência

Start criando um modelo de gerenciamento de correspondência de amostra que é renderizado na área de trabalho do AEM Forms. Para obter mais detalhes, consulte Criar um modelo de carta.
Acesse o modelo de Gerenciamento de Correspondência em seu URL para verificar se o modelo de Gerenciamento de Correspondência pode ser renderizado com êxito. O URL tem um padrão semelhante ao https://'[server]:[port]'/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;
onde encodedLetterId é a ID da carta codificada por URL. Especifique a mesma ID de letra ao definir o processo de renderização para a tarefa de espaço de trabalho no Workbench.

Criar uma tarefa para renderizar e enviar uma carta no AEM Workspace

Antes de executar essas etapas, verifique se você é membro dos seguintes grupos:
  • cm-agent-users
  • Usuários da Workspace
Para obter mais informações, consulte Adicionar e configurar usuários .
Use as seguintes etapas para criar uma tarefa para renderizar e enviar uma carta no AEM Workspace:
  1. Inicie o Workbench. Faça logon no localhost como administrador.
  2. Clique em Arquivo > Novo > Aplicativo. No campo Nome do aplicativo, digite CMDemoSample e clique em Concluir.
  3. Selecione CMDemoSample/1.0 e clique com o botão direito do mouse NewProcess . No campo de nome, digite CMRenderer e clique em Concluir.
  4. Arraste o seletor de atividade do Ponto de Start e configure-o:
    1. Em Dados de apresentação, selecione Usar um ativo CRX.
    2. Procurar um ativo. Na caixa de diálogo Selecionar ativo de formulário, a guia Letras lista todas as letras do servidor.
    3. Selecione a carta apropriada e clique em OK .
  5. Clique em Gerenciar Perfis de ação. A caixa de diálogo Gerenciar Perfil de ação é exibida. Certifique-se de que o Processo de renderização e o Processo de envio estejam selecionados adequadamente.
  6. Para abrir a carta com um arquivo XML de dados, procure e selecione o arquivo de dados apropriado no Processo de preparação de dados.
  7. Clique em OK.
  8. Defina as variáveis para Saída do ponto de Start e Anexos de Tarefa. As variáveis definidas conterão dados de Saída de ponto de Start e Anexos de Tarefa.
  9. (Opcional) Para adicionar outro usuário no fluxo de trabalho, arraste um seletor de atividade, configure-o e atribua-o a um usuário. Escreva um invólucro personalizado (exemplo fornecido abaixo) ou baixe e instale o DSC (fornecido abaixo) para o modelo Carta extinto, Saída de Ponto de Start e Anexo de tarefa.
    Uma amostra de invólucro personalizado está conforme listado abaixo:
    public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception {
    try {
    if(dataXML == null)
    throw new Exception("dataXML is missing");
    
    CoreService coreService = getRemoteCoreService();
    if (coreService == null)
    throw new Exception("Unable to retrive service. Please verify connection details.");
    Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8"));
    LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo();
    
    List<Document> attachmentDocs = new ArrayList<Document>();
    List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY);
    if (attachments != null){
    for (byte[] attachment : attachments)
    { attachmentDocs.add(new Document(attachment)); }
    
    }
    letterInstanceInfo.setLetterAttachments(attachmentDocs);
    
    byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY);
    if (updateLayout != null)
    { letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); }
    
    else
    { throw new Exception("template bytes missing while getting Letter instance Info."); }
    
    return letterInstanceInfo;
    } catch (Exception e)
    { throw new Exception(e); }
    
    }
    
    
    Obter DSC de Download de Arquivo: Uma amostra de DSC está disponível no arquivo DSCSamplie.zip anexado acima. Baixe e descompacte o arquivo DSCSamplie.zip. Antes de usar o serviço DSC, é necessário configurá-lo. Para obter informações, consulte Configurar o serviço DSC.
    Na caixa de diálogo Definir Atividade, selecione a atividade apropriada, como getLetterInstanceInfo, e clique em OK .
  10. Implante o aplicativo. Se solicitado, faça check-in e salve os ativos.
  11. Faça logon na área de trabalho de formulários do AEM em https://' # : # '/lc/content/ws.
  12. Abra a tarefa que você adicionou, CMRenderer. A carta de Gerenciamento de correspondência é exibida.
  13. Preencha os dados necessários e envie a carta. A janela fecha. Nesse processo, a tarefa é atribuída ao usuário especificado no fluxo de trabalho na etapa 9.
    O botão Enviar não é ativado até que todas as variáveis necessárias na letra sejam preenchidas.