DocumentazioneAEM 6.5Guida utente

Integrazione di applicazioni di terze parti nell’area di lavoro di AEM Forms integrating-third-party-applications-in-aem-forms-workspace

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

AEM Forms Workspace supporta la gestione delle attività di assegnazione delle attività e completamento per moduli e documenti. Questi moduli e documenti possono essere XDP Forms, Flex® Form o Guide (obsoleti) di cui è stato eseguito il rendering in formati XDP, PDF, HTML o Flex.

Queste funzionalità vengono ulteriormente migliorate. AEM Forms ora supporta la collaborazione con applicazioni di terze parti che supportano funzionalità simili all’area di lavoro di AEM Forms. Una parte comune di questa funzionalità è il flusso di lavoro di un'assegnazione e la successiva approvazione di un'attività. AEM Forms offre un’unica esperienza unificata per gli utenti aziendali di AEM Forms, in modo che tutte le assegnazioni di attività o approvazioni per le applicazioni supportate possano essere gestite tramite l’area di lavoro di AEM Forms.

Ad esempio, consideriamo Gestione della corrispondenza come il candidato di esempio per l’integrazione con l’area di lavoro di AEM Forms. Gestione della corrispondenza ha il concetto di "Lettera", che può essere rappresentata e consente azioni.

Creare risorse di gestione della corrispondenza create-correspondence-management-assets

Per prima cosa, crea un modello di esempio per la gestione della corrispondenza di cui viene eseguito il rendering nell’area di lavoro di AEM Forms. Per ulteriori dettagli, consulta Creare un modello di lettera.

Accedi al modello Gestione corrispondenza con il relativo URL per verificare se è possibile eseguire correttamente il rendering del modello Gestione corrispondenza. L’URL ha un pattern simile a https://'[server]:[port]'/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;

Dove encodedLetterId è l’ID della lettera con codifica URL. Specifica lo stesso ID lettera quando definisci il processo di rendering per l’attività dell’area di lavoro in Workbench.

Creare un’attività per il rendering e l’invio di una lettera in AEM Workspace create-a-task-to-render-and-submit-a-letter-in-aem-workspace

Prima di eseguire questi passaggi, assicurati di essere membro dei seguenti gruppi:

  • cm-agent-users
  • Utenti di Workspace

Per ulteriori informazioni, consulta Aggiungere e configurare gli utenti.

Utilizza i seguenti passaggi per creare un’attività per riprodurre e inviare una lettera in AEM Workspace:

  1. Avvia Workbench. Accedere a localhost come amministratore.

  2. Selezionate File > Nuovo (New) > Applicazione (Application). Nel campo Nome applicazione, immettere CMDemoSample e quindi fare clic su Fine.

  3. Seleziona CMDemoSample/1.0 e fare clic con il pulsante destro del mouse NewProcess. Nel campo del nome, immetti CMRenderer e quindi fare clic su Fine.

  4. Trascina il selettore attività Punto iniziale e configuralo:

    1. In Dati presentazione, seleziona Usa risorsa CRX.

      useacrxasset

    2. Cercare una risorsa. Nella finestra di dialogo Seleziona risorsa modulo, la scheda Lettere elenca tutte le lettere presenti sul server.

      Scheda Lettera

    3. Seleziona la lettera appropriata e fai clic su OK.

  5. Fai clic su Gestisci profili azione. Viene visualizzata la finestra di dialogo Gestisci profilo azione. Verificare che il processo di rendering e il processo di invio siano selezionati in modo appropriato.

  6. Per aprire la lettera con un file XML dati, sfogliare e selezionare il file di dati appropriato nel processo di preparazione dei dati.

  7. Fare clic su OK.

  8. Definire le variabili per Output punto iniziale e Allegati attività. Le variabili definite contengono i dati Output punto iniziale e Allegati attività.

  9. (Facoltativo) Per aggiungere un altro utente al flusso di lavoro, trascina un selettore di attività, configuralo e assegnalo a un utente. Scrivere un wrapper personalizzato (esempio fornito di seguito) o scaricare e installare il DSC (fornito di seguito) per il modello di lettera esatta, l'output del punto iniziale e l'allegato dell'operazione.

    Di seguito è riportato un esempio di wrapper personalizzato:

    code language-javascript 
    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); }

}

    Ottieni file
    Scarica DSC: un esempio di DSC è disponibile nel file DSCSample.zip allegato in precedenza. Scarica e decomprimi il file DSCSample.zip. Prima di utilizzare il servizio DSC, è necessario configurarlo. Consulta Configurare il servizio DSC.

    Nella finestra di dialogo Definisci attività, seleziona l’attività appropriata, ad esempio getLetterInstanceInfo, e fai clic su OK.

  10. Distribuire l'applicazione. Se viene richiesto di effettuare il check-in e salvare le risorse.

  11. Accedi all’area di lavoro dei moduli AEM all’indirizzo https://'[server]:[porta]'/lc/content/ws.

  12. Apri l'attività aggiunta, CMRenderer. Viene visualizzata la lettera Gestione corrispondenza.

    cminworkspace

  13. Inserisci i dati richiesti e invia la lettera. La finestra si chiude. In questo processo, l’attività viene assegnata all’utente specificato nel flusso di lavoro al passaggio 9.

    note note
    NOTE
    Il pulsante Invia non viene attivato finché non vengono compilate tutte le variabili richieste nella lettera.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2