Integrieren der Benutzeroberfläche „Korrespondenz erstellen“ in Ihr benutzerdefiniertes Portal integrating-create-correspondence-ui-with-your-custom-portal
Ü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 (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 alshttps://'[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.
Inline-datenbasierter 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-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
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
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
Wenn Sie ein HTTP- oder CQ-Protokoll für cmDataURL verwenden, muss die HTTP/CQ-URL anonym zugänglich sein.