Integración de la IU Crear correspondencia con su portal personalizado

Información general

Este artículo detalla cómo puede integrar la solución Crear correspondencia con su entorno.

Invocación basada en URL

Una forma de llamar a la aplicación Crear correspondencia desde un portal personalizado es preparar la URL con los siguientes parámetros de solicitud:

  • el identificador de la plantilla de carta (con el parámetro cmLetterId ) o el nombre de la plantilla Letter (con el parámetro cmLetterName )

  • la dirección URL de los datos XML recuperados del origen de datos deseado (con el parámetro cmDataUrl ).

Por ejemplo, el portal personalizado prepararía la dirección URL como
https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL], que podría ser el href de un vínculo en el portal.
Si el portal tiene el nombre de la plantilla Carta a mano, la URL podría ser
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL].

NOTA

Llamar a de este modo no es seguro, ya que los parámetros necesarios se pasan como una solicitud de GET, al exponer lo mismo (claramente visible) en la dirección URL.

NOTA

Antes de llamar a la aplicación Crear correspondencia, guarde y cargue los datos para llamar a la IU Crear correspondencia en la URL de datos determinada. Esto se puede hacer desde el propio portal personalizado o a través de otro proceso de back-end.

Invocación basada en datos en línea

Otra forma (y más segura) de llamar a la aplicación Crear correspondencia podría ser simplemente visitar la URL en https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html, mientras se envían los parámetros y datos para llamar a la aplicación Crear correspondencia como una solicitud de POST (ocultándolos al usuario final). Esto también significa que ahora puede pasar los datos XML para la aplicación Crear correspondencia en línea (como parte de la misma solicitud, utilizando el parámetro cmData), que no era posible/ideal en el método anterior.

Parámetros para especificar una carta

Nombre Tipo Descripción
cmLetterInstanceId Cadena Identificador de la instancia de letra.
cmLetterName Cadena

Identificador de la plantilla de carta.

Si existen varias letras CM con el mismo nombre en un servidor, el uso del parámetro cmLetterName en la URL genera el error "Hay varias letras con el nombre". En tal caso, utilice el parámetro cmLetterId en la dirección URL en lugar de cmLetterName.

cmLetterId Cadena El nombre de la plantilla Carta.

El orden de los parámetros de la tabla especifica la preferencia de los parámetros utilizados para cargar la carta.

Parámetros para especificar el origen de datos XML

Nombre Tipo Descripción
cmDataUrl
URL Datos XML de un archivo de origen utilizando protocolos básicos como cq, ftp, http o file.
cmLetterInstanceId Cadena Uso de datos xml disponibles en la instancia de carta.
cmUseTestData Booleano Para reutilizar los datos de prueba adjuntos en un diccionario de datos.

El orden de los parámetros de la tabla especifica la preferencia de los parámetros utilizados para cargar los datos XML.

Otros parámetros

Nombre Tipo Descripción
cmPreview
Booleano True para abrir la carta en el modo de vista previa
Aleatorio Marca de tiempo Para resolver los problemas de almacenamiento en caché del explorador.

Si utiliza el protocolo http o cq para cmDataURL, la dirección URL de http/cq debe ser accesible de forma anónima.

En esta página