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 (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 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.
Wenn das Portal den Namen der Briefvorlage enthält, kann die URLhttps://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL]
.
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
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.