Intégration de l’interface utilisateur de création de correspondance dans votre portail personnalisé integrating-create-correspondence-ui-with-your-custom-portal
Présentation overview
Cet article décrit comment intégrer la solution de création de correspondance à votre environnement.
Appel basé sur une URL url-based-invocation
Pour appeler l’application de création de correspondance à partir d’un portail personnalisé, préparez l’URL avec les paramètres de requête suivants :
-
l’identifiant du modèle de lettre (à l’aide du paramètre cmLetterId) ou le nom du modèle de lettre (à l’aide du paramètre cmLetterName) ;
-
l’URL des données XML extraites à partir de la source de données sélectionnée (à l’aide du paramètre cmDataUrl).
Par exemple, le portail personnalisé prépare l’URL sous la formehttps://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]
, qui pourrait être le href dʼun lien sur le portail.
Si le nom du modèle de lettre est à portée de main sur le portail, l’URL peut êtrehttps://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL]
.
Appel intégré basé sur les données inline-data-based-invocation
Un autre moyen (plus sécurisé) d’appeler l’application de création de correspondance consiste à simplement accéder à l’URL à l’adresse https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html
, lors de l’envoi des paramètres et des données pour appeler l’application de création de correspondance en tant que demande de POST (en les masquant à l’utilisateur final). Cela signifie également que vous pouvez désormais transmettre les données XML pour l’application de création de correspondance en ligne (dans le cadre de la même requête, à l’aide du paramètre cmData), ce qui n’était pas possible/idéal dans l’approche précédente.
Paramètres de spécification de lettre parameters-for-specifying-letter
L’ordre des paramètres dans le tableau indique la préférence des paramètres utilisés pour le chargement de la lettre.
Paramètres de spécification de la source de données XML parameters-for-specifying-the-xml-data-source
L’ordre des paramètres dans le tableau indique la préférence des paramètres utilisés pour le chargement des données XML.
Autres paramètres other-parameters
Si vous utilisez le protocole http ou cq pour le paramètre cmDataURL, l’URL correspondante doit pouvoir être accessible de manière anonyme.