Integrazione dell’interfaccia utente per la creazione di corrispondenza con il portale personalizzato integrating-create-correspondence-ui-with-your-custom-portal

Panoramica overview

Questo articolo illustra come integrare la soluzione Create Correspondence con il tuo ambiente.

Chiamata basata su URL url-based-invocation

Un modo per chiamare l’applicazione Create Correspondence da un portale personalizzato consiste nel preparare l’URL con i seguenti parametri di richiesta:

  • l’identificatore per il modello di lettera (utilizzando il parametro cmLetterId).

  • URL dei dati XML recuperati dall'origine dati desiderata (utilizzando il parametro cmDataUrl).

Ad esempio, il portale personalizzato prepara l’URL come
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL], che potrebbe essere l’href di un collegamento sul portale.

NOTE
Una chiamata di questo tipo non è sicura in quanto i parametri necessari vengono trasmessi come richiesta di GET esponendo lo stesso (chiaramente visibile) nell’URL.
NOTE
Prima di richiamare l’applicazione Create Correspondence, salva e carica i dati per richiamare l’interfaccia utente Create Correspondence in corrispondenza dell’URL dati specificato. Questa operazione può essere eseguita dal portale personalizzato stesso o attraverso un altro processo back-end.

Chiamata basata su dati in linea inline-data-based-invocation

Un altro modo (e più sicuro) per chiamare l’applicazione Create Correspondence potrebbe essere semplicemente di premere l’URL su https://'[server]:[porta]'/[contextPath]/aem/forms/createcorrespondence.html, durante l’invio di parametri e dati per richiamare l’applicazione Create Correspondence come richiesta POST (nascondendoli all’utente finale). Ciò significa anche che ora puoi trasmettere in linea i dati XML per l’applicazione Create Correspondence (come parte della stessa richiesta, utilizzando il parametro cmData), che non era possibile/ideale nell’approccio precedente.

Parametri per specificare la lettera parameters-for-specifying-letter

Nome
Tipo
Descrizione
cmLetterInstanceId
Stringa
Identificatore per l’istanza della lettera.
cmLetterId
Stringa
Nome del modello Lettera.

L'ordine dei parametri nella tabella specifica la preferenza dei parametri utilizzati per il caricamento della lettera.

Parametri per specificare l'origine dati XML parameters-for-specifying-the-xml-data-source

Nome
Tipo
Descrizione
cmDataUrl
URL
Dati XML da un file di origine utilizzando protocolli di base come cq, ftp, http o file.
cmLetterInstanceId
Stringa
Utilizzo dei dati xml disponibili nell’istanza della lettera.
cmUseTestData
Booleano
Per riutilizzare i dati di test allegati al dizionario dati.

L'ordine dei parametri nella tabella specifica la preferenza dei parametri utilizzati per il caricamento dei dati XML.

Altri parametri other-parameters

Nome
Tipo
Descrizione
cmPreview
Booleano
True per aprire la lettera in modalità anteprima
Casuale
Timestamp
Per risolvere i problemi di memorizzazione nella cache del browser.

Se utilizzi il protocollo http o cq per cmDataURL, l’URL di http/cq deve essere accessibile in modo anonimo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2