Este artículo explica cómo puede integrar la solución Crear correspondencia con su entorno.
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.
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.
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.
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.
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.
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.
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.