Integración de la interfaz de usuario 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 dirección URL con los siguientes parámetros de solicitud:

  • identificador de la plantilla de letras (con el parámetro cmLetterId).

  • la dirección URL de los datos XML recuperados del origen de datos deseado (mediante 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 puede ser el href de un vínculo en el portal.

NOTA

La llamada de este modo no es segura, ya que los parámetros necesarios se pasan como una solicitud de GET, al exponer los mismos (claramente visibles) en la dirección URL.

NOTA

Antes de llamar a la aplicación Crear correspondencia, guarde y cargue los datos para llamar a la interfaz de usuario Crear correspondencia en la dirección URL de datos determinada. Esto puede realizarse 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 sería simplemente visitar la dirección URL en https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html, mientras se enviaban 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), lo que no era posible/ideal en el método anterior.

Parámetros para especificar la letra

Nombre Tipo Descripción
cmLetterInstanceId Cadena Identificador de la instancia de carta.
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 letra.

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 el 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 letra en modo de previsualización
Aleatorio Marca de hora 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