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 dirección 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 (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.
Si el portal tiene el nombre de plantilla Carta a mano, la dirección URL podría ser
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL]
.
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.
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.
Otra forma (y más segura) de llamar a la aplicación Crear correspondencia podría ser simplemente visitar la dirección 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), lo que no era posible/ideal en el método anterior.
Nombre | Tipo | Descripción |
cmLetterInstanceId | Cadena | Identificador de la instancia de carta. |
cmLetterName | Cadena | Identificador de la plantilla de letras. Si existen varias letras CM con el mismo nombre en un servidor, el uso del parámetro cmLetterName en la URL genera un error "Existen varias letras con el nombre". En ese 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 letra.
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.
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.