Integrieren der Benutzeroberfläche „Korrespondenz erstellen“ in Ihr benutzerdefiniertes Portal integrating-create-correspondence-ui-with-your-custom-portal

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Übersicht overview

In diesem Artikel wird beschrieben, wie Sie die Lösung "Korrespondenz erstellen"in Ihre Umgebung integrieren können.

URL-basierter Aufruf url-based-invocation

Eine Möglichkeit, die Anwendung "Korrespondenz erstellen"über ein benutzerdefiniertes Portal aufzurufen, besteht darin, die URL mit den folgenden Anforderungsparametern vorzubereiten:

  • die Kennung für die Briefvorlage (unter Verwendung des cmLetterId-Parameters) oder den Namen der Briefvorlage (unter Verwendung des cmLetterName-Parameters)

  • die URL für die XML-Datei, die aus der gewünschten Datenquelle (unter Verwendung des cmDataUrl-Parameters) erfasst wurde

Beispielsweise würde das benutzerdefinierte Portal die URL als
https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL] vorbereiten, wobei es sich um die href eines Links auf dem Portal handeln könnte.
Wenn das Portal den Namen der Briefvorlage enthält, kann die URL
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL].

NOTE
Ein solcher Aufruf ist nicht sicher, da die erforderlichen Parameter als GET-Anfrage übergeben werden, indem der gleiche (deutlich sichtbare) Parameter in der URL offen gelegt wird.
NOTE
Bevor Sie die Anwendung "Korrespondenz erstellen"aufrufen, speichern und laden Sie die Daten hoch, um die Benutzeroberfläche "Korrespondenz erstellen"unter der angegebenen dataURL aufzurufen. Dies kann entweder vom benutzerdefinierten Portal selbst oder über einen anderen Back-End-Prozess erfolgen.

Inline-datenbasierter Aufruf inline-data-based-invocation

Eine weitere (und sicherere) Möglichkeit, die Anwendung "Korrespondenz erstellen"aufzurufen, besteht darin, einfach die URL unter https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html, während die Parameter und Daten gesendet werden, um die Anwendung "Korrespondenz erstellen"als POST-Anfrage aufzurufen (diese für den Endbenutzer auszublenden). Dies bedeutet auch, dass Sie jetzt die XML-Daten für die Anwendung "Korrespondenz erstellen"inline übergeben können (als Teil derselben Anforderung, unter Verwendung des cmData-Parameters), was im vorherigen Ansatz nicht möglich/ideal war.

Parameter für die Angabe von Briefen parameters-for-specifying-letter

Name
Typ
Beschreibung
cmLetterInstanceId
Zeichenfolge
Der Bezeichner für die Briefinstanz.
cmLetterName
Zeichenfolge

Die Kennung für die Briefvorlage.

Wenn auf einem Server mehrere CM-Buchstaben mit demselben Namen vorhanden sind, löst die Verwendung des cmLetterName-Parameters in der URL den Fehler "Mehrere Buchstaben mit dem Namen vorhanden"aus. Verwenden Sie in diesem Fall den Parameter cmLetterId in der URL anstelle von cmLetterName.

cmLetterId
Zeichenfolge
Der Name der Briefvorlage.

Die Reihenfolge der Parameter in der Tabelle gibt die Voreinstellungen der Parameter an, die zum Laden des Briefs verwendet werden.

Parameter zum Angeben der XML-Datenquelle parameters-for-specifying-the-xml-data-source

Name
Typ
Beschreibung
cmDataUrl
URL
XML-Daten aus einer Quelldatei mit Grundprotokollen wie cq, ftp, http oder file.
cmLetterInstanceId
Zeichenfolge
Verwenden von XML-Daten, die in der Briefinstanz verfügbar sind.
cmUseTestData
Boolesch
Um die im Datenwörterbuch angehängten Testdaten wiederzuverwenden.

Die Reihenfolge der Parameter in der Tabelle gibt die Voreinstellungen der Parameter an, die zum Laden der XML-Daten verwendet werden.

Andere Parameter other-parameters

Name
Typ
Beschreibung
cmPreview
Boolesch
True zum Öffnen des Briefs im Vorschaumodus
Willkürlich
Zeitstempel
Beheben von Problemen beim Zwischenspeichern im Browser.

Wenn Sie ein HTTP- oder CQ-Protokoll für cmDataURL verwenden, muss die HTTP/CQ-URL anonym zugänglich sein.

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