In questo articolo viene illustrato come integrare la soluzione Crea corrispondenza con il proprio ambiente.
Un modo per chiamare l’applicazione Crea corrispondenza da un portale personalizzato è preparare l’URL con i seguenti parametri di richiesta:
identificatore per il modello di lettera (utilizzando il parametro cmLetterId).
l'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 può essere il href di un collegamento nel portale.
La chiamata in questo modo non è sicura, in quanto i parametri necessari vengono passati come una richiesta di GET, esponendo lo stesso (chiaramente visibile) nell’URL.
Prima di chiamare l’applicazione Crea corrispondenza, salvate e caricate i dati per chiamare l’interfaccia utente Crea corrispondenza all’URL data specificato. Questo può essere fatto dal portale personalizzato stesso o attraverso un altro processo back-end.
Un altro metodo (e più sicuro) per chiamare l'applicazione Create Correspondence potrebbe essere quello di accedere semplicemente all'URL all'indirizzo https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html, inviando i parametri e i dati per chiamare l'applicazione Create Correspondence come richiesta di POST (nascondendoli dall'utente finale). Ciò significa anche che ora è possibile trasmettere i dati XML per l'applicazione Create Correspondence in linea (come parte della stessa richiesta, utilizzando il parametro cmData), che non era possibile/ideale nell'approccio precedente.
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 caricare la lettera.
Nome | Tipo | Descrizione |
cmDataUrl |
URL | Dati XML da un file di origine che utilizzano protocolli di base come cq, ftp, http o file. |
cmLetterInstanceId | Stringa | Utilizzo dei dati xml disponibili in Letter Instance (Istanza Lettera). |
cmUseTestData | Booleano | Per riutilizzare i dati di prova allegati nel dizionario dati. |
L'ordine dei parametri nella tabella specifica la preferenza dei parametri utilizzati per caricare i dati XML.
Nome | Tipo | Descrizione |
cmPreview |
Booleano | True per aprire la lettera in modalità di anteprima |
Casuale | Timestamp | Per risolvere i problemi di memorizzazione nella cache del browser. |
Se utilizzate il protocollo http o cq per cmDataURL, l'URL di http/cq dovrebbe essere accessibile in modo anonimo.