Integrar la interfaz de usuario de Crear correspondencia con su portal personalizado

Información general

Este artículo explica 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)

  • la dirección URL de los datos XML recuperados de la fuente de datos deseada (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], la cual podría ser el href de un vínculo del portal.

NOTA

Realizar la llamada de esta forma no es seguro, ya que los parámetros necesarios se pasan como una petición GET, exponiendo lo mismo (claramente visible) en la URL.

NOTA

Antes de llamar a la aplicación Crear correspondencia, guarde y cargue los datos para llamar a la interfaz de usuario de Crear correspondencia en la URL de datos determinada. Puede hacerlo 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 es simplemente visitar la URL en https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html mientras se envían los parámetros y los datos para llamar a la aplicación Crear correspondencia como una petición POST (ocultándolos al usuario final). Eso significa también 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), lo que no era posible ni lo ideal en el caso del método anterior.

Parámetros para especificar una carta

Nombre Tipo Descripción
cmLetterInstanceId Cadena El identificador de la instancia de carta.
cmLetterId Cadena El nombre de la plantilla de 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 la fuente de datos XML

Nombre Tipo Descripción
cmDataUrl
URL Los datos XML de un archivo de fuente utilizando protocolos básicos como cq, ftp, http o file.
cmLetterInstanceId Cadena El uso de los datos XML disponibles en la instancia de carta.
cmUseTestData Booleano Permite 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 URL de http/cq debe ser accesible de forma anónima.

En esta página