Este artículo detalla 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 ) 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]
.
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.
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.
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.
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.
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.
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.