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

Übersicht overview

In diesem Artikel wird erläutert, 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“ von einem Cluster-Portal aufzurufen, besteht darin, die URL mit folgenden Anfrageparametern vorzubereiten:

  • die Kennung für die Briefvorlage (mithilfe des cmLetterId-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.

NOTE
Den Aufruf auf diese Weise durchzuführen, ist nicht sicher, da die erforderlichen Parameter als GET-Anfrage übergeben werden, indem dieselben (eindeutig sichtbaren) Parameter in der URL offengelegt werden.
NOTE
Bevor Sie die Anwendung „Korrespondenz erstellen“ aufrufen, speichern und laden Sie die Daten, um die Benutzeroberfläche „Korrespondenz erstellen“ unter der angegebenen Daten-URL aufzurufen. Dies kann entweder vom benutzerdefinierten Portal aus oder über einen anderen Backend-Vorgang ausgeführt werden.

Auf Daten basierter Inline-Aufruf inline-data-based-invocation

Eine weitere (und sicherere) Möglichkeit, die Anwendung „Korrespondenz erstellen“ aufzurufen, besteht darin, die URL https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html aufzurufen, während die Parameter und Daten zum Aufrufen der Anwendung „Korrespondenz erstellen“ als POST-Anforderung gesendet werden (wodurch sie vor dem Endbenutzer versteckt werden). Dies bedeutet auch, dass Sie jetzt die XML-Datei für die Anwendung „Korrespondenz erstellen“ inline (als Teil der gleichen Anfrage unter Verwendung des Parameters cmData) übergeben können, was bei der vorigen Herangehensweise nicht möglich/ideal war.

Parameter für das Festlegen des Briefs parameters-for-specifying-letter

Name
Typ
Beschreibung
cmLetterInstanceId
Zeichenfolge
Der Bezeichner für die Briefinstanz.
cmLetterId
Zeichenfolge
Der Name der Briefvorlage.

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

Parameter für die Angabe der XML-Datenquelle parameters-for-specifying-the-xml-data-source

Name
Typ
Beschreibung
cmDataUrl
URL
XML-Daten aus einer Quelldatei, die Standardprotokolle wie CQ, FTP, HTTP oder FILE verwenden.
cmLetterInstanceId
Zeichenfolge
Verwenden von XML-Daten, die in der Briefinstanz verfügbar sind.
cmUseTestData
Boolesch
Um die Testdaten wiederzuverwenden, die im Datenwörterbuch angehängt sind.

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

Andere Parameter other-parameters

Name
Typ
Beschreibung
cmPreview
Boolesch
„True“, um den Brief im Vorschaumodus zu öffnen.
Willkürlich
Zeitstempel
Um die Probleme mit dem Browser-Caching zu lösen.

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

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