Integrar la interfaz de usuario de Crear correspondencia con su portal personalizado integrating-create-correspondence-ui-with-your-custom-portal

Información general overview

Este artículo explica cómo puede integrar la solución Crear correspondencia con su entorno.

Invocación basada en URL url-based-invocation

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.

NOTE
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.
NOTE
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.

Invocación basada en datos en línea inline-data-based-invocation

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.

Parámetros para especificar una carta parameters-for-specifying-letter

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.

Parámetros para especificar la fuente de datos XML parameters-for-specifying-the-xml-data-source

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.

Otros parámetros other-parameters

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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2