Show Menu
TEMAS×

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.
La llamada de este modo no es segura, ya que los parámetros necesarios se pasan como una solicitud 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.

Invocación basada en datos en línea

Otra forma (y más segura) de llamar a la aplicación Crear correspondencia podría ser simplemente visitar la URL en https://' # : # '/ # /aem/forms/createcorrespondence.html, mientras se envían los parámetros y datos para llamar a la aplicación Crear correspondencia como una solicitud 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 el 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.