Integrazione dell’interfaccia utente Crea corrispondenza con il portale personalizzato integrating-create-correspondence-ui-with-your-custom-portal

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Panoramica overview

Questo articolo descrive come integrare Crea soluzione di corrispondenza con il tuo ambiente.

Chiamata basata su URL url-based-invocation

Un modo per chiamare l’applicazione Crea corrispondenza da un portale personalizzato è quello di preparare l’URL con i seguenti parametri di richiesta:

  • l’identificatore del modello di lettera (utilizzando il parametro cmLetterId ) o il nome del modello di lettera (utilizzando il parametro cmLetterName )

  • 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 potrebbe essere il href da un collegamento sul portale.
Se il portale contiene il nome del modello Lettera , l’URL potrebbe essere
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL].

NOTE
Le chiamate in questo modo non sono sicure in quanto i parametri necessari vengono trasmessi come richiesta di GET, esponendo gli stessi (chiaramente visibili) nell'URL.
NOTE
Prima di chiamare l’applicazione Create Correspondence, salva e carica i dati per chiamare l’interfaccia utente Create Correspondence in corrispondenza del dataURL specificato. Questo può essere fatto dal portale personalizzato stesso o attraverso un altro processo back-end.

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

Un altro modo (e più sicuro) per chiamare l'applicazione Create Correspondence potrebbe essere quello di colpire semplicemente l'URL in https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html, durante l’invio dei parametri e dei dati per chiamare l’applicazione Create Correspondence come richiesta di POST (nasconderli 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.

Parametri per la specifica della lettera parameters-for-specifying-letter

Nome
Tipo
Descrizione
cmLetterInstanceId
Stringa
Identificatore per l'istanza della lettera.
cmLetterName
Stringa

Identificatore del modello di lettera.

Se su un server sono presenti più lettere CM con lo stesso nome, l'utilizzo del parametro cmLetterName nell'URL genera un errore "Esistono più lettere con lo stesso nome". In questo caso, utilizza il parametro cmLetterId nell’URL invece di cmLetterName.

cmLetterId
Stringa
Nome del modello Lettera.

L’ordine dei parametri nella tabella specifica la preferenza dei parametri utilizzati per caricare la lettera.

Parametri per la specifica dell'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 in Letter Instance.
cmUseTestData
Booleano
Per riutilizzare i dati di test allegati nel dizionario dati.

L’ordine dei parametri nella tabella specifica la preferenza dei parametri utilizzati per caricare i 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 in cache del browser.

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da