Pasar documentos al servicio de Forms

Última actualización: 15 de julio de 2024
  • Se aplica a:
  • Experience Manager 6.5
  • Temas:

Creado para:

  • Desarrollador

Las muestras y los ejemplos de este documento solo son para AEM Forms en un entorno JEE.

El servicio AEM Forms procesa PDF forms interactivos en dispositivos cliente, normalmente exploradores web, para recopilar información de los usuarios. Un formulario PDF interactivo se basa en un diseño de formulario que normalmente se guarda como archivo XDP y se crea en Designer. A partir de AEM Forms, puede pasar un objeto com.adobe.idp.Document que contenga el diseño de formulario al servicio Forms. A continuación, el servicio Forms procesa el diseño de formulario en el objeto com.adobe.idp.Document.

Una ventaja de pasar un objeto com.adobe.idp.Document al servicio Forms es que otras operaciones del servicio devuelven una instancia com.adobe.idp.Document. Es decir, puede obtener una instancia de com.adobe.idp.Document de otra operación de servicio y procesarla. Por ejemplo, supongamos que un archivo XDP se almacena en un nodo de Content Services (obsoleto) denominado /Company Home/Form Designs, como se muestra en la siguiente ilustración.

Puede recuperar mediante programación Loan.xdp de Content Services (obsoleto) (obsoleto) y pasar el archivo XDP al servicio de Forms dentro de un objeto com.adobe.idp.Document.

NOTA
Para obtener más información acerca del servicio Forms, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

Para pasar un documento obtenido de Content Services (obsoleto) (obsoleto) al servicio Forms, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Cree un objeto de API de cliente de Forms y de Administración de documentos.
  3. Recupere el diseño de formulario de Content Services (obsoleto).
  4. Procese el formulario interactivo del PDF.
  5. Realice una acción con el flujo de datos del formulario.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente con Java, incluya los archivos JAR necesarios. Si utiliza servicios web, incluya los archivos proxy.

Crear un Forms y un objeto de API de cliente de administración de documentos

Para poder realizar mediante programación una operación de API de servicio de Forms, cree un objeto de API de cliente de Forms. Además, como este flujo de trabajo recupera un archivo XDP de los servicios de contenido (obsoleto), cree un objeto de API de administración de documentos.

Recuperar el diseño de formulario de los servicios de contenido (obsoleto)

Recupere el archivo XDP de los servicios de contenido (obsoleto) mediante Java o la API de servicio web. El archivo XDP se devuelve en una instancia com.adobe.idp.Document (o en una instancia BLOB si utiliza servicios web). A continuación, puede pasar la instancia com.adobe.idp.Document al servicio Forms.

Procesar un formulario de PDF interactivo

Para procesar un formulario interactivo, pase la instancia com.adobe.idp.Document devuelta por Content Services (obsoleta) al servicio Forms.

NOTA
Puede pasar un(a) com.adobe.idp.Document que contenga el diseño de formulario al servicio Forms. Dos nuevos métodos denominados renderPDFForm2 y renderHTMLForm2 aceptan un objeto com.adobe.idp.Document que contiene un diseño de formulario.

Realizar una acción con el flujo de datos del formulario

Según el tipo de aplicación cliente, puede escribir el formulario en un explorador web de cliente o guardarlo como archivo de PDF. Una aplicación basada en web suele escribir el formulario en el explorador web. Sin embargo, una aplicación de escritorio suele guardar el formulario como un archivo de PDF.

Consulte también

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Inicio rápido de la API del servicio de Forms

Pasar documentos al servicio de Forms mediante la API de Java

Pase un documento obtenido de Content Services (obsoleto) mediante el servicio Forms y la API de Content Services (obsoleto) (Java):

  1. Incluir archivos de proyecto

    Incluya archivos JAR de cliente, como adobe-forms-client.jar y adobe-contentservices-client.jar, en la ruta de clase del proyecto Java.

  2. Crear un objeto de API de cliente de Forms y Administración de documentos

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión. (Consulte Establecimiento de propiedades de conexión.)
    • Cree un objeto FormsServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.
    • Cree un objeto DocumentManagementServiceClientImpl utilizando su constructor y pasando el objeto ServiceClientFactory.

  3. Recuperar el diseño de formulario de Content Services (obsoleto)

    Invoque el método retrieveContent del objeto DocumentManagementServiceClientImpl y pase los siguientes valores:

    • Un valor de cadena que especifica el almacén donde se agrega el contenido. El almacén predeterminado es SpacesStore. Este valor es un parámetro obligatorio.
    • Valor de cadena que especifica la ruta de acceso completa del contenido que se va a recuperar (por ejemplo, /Company Home/Form Designs/Loan.xdp). Este valor es un parámetro obligatorio.
    • Un valor de cadena que especifica la versión. Este valor es un parámetro opcional y puede pasar una cadena vacía. En este caso, se recupera la versión más reciente.

    El método retrieveContent devuelve un objeto CRCResult que contiene el archivo XDP. Obtenga una instancia com.adobe.idp.Document invocando el método getDocument del objeto CRCResult.

  4. Procesar un formulario interactivo de PDF

    Invoque el método renderPDFForm2 del objeto FormsServiceClient y pase los siguientes valores:

    • Un objeto com.adobe.idp.Document que contiene el diseño de formulario recuperado de Content Services (obsoleto).
    • Objeto com.adobe.idp.Document que contiene datos para combinar con el formulario. Si no desea combinar datos, pase un objeto com.adobe.idp.Document vacío.
    • Objeto PDFFormRenderSpec que almacena opciones en tiempo de ejecución. Este valor es un parámetro opcional y puede especificar null si no desea especificar opciones en tiempo de ejecución.
    • Objeto URLSpec que contiene valores de URI. Este valor es un parámetro opcional y puede especificar null.
    • Objeto java.util.HashMap que almacena datos adjuntos de archivos. Este valor es un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.

    El método renderPDFForm devuelve un objeto FormsResult que contiene una secuencia de datos de formulario que debe escribirse en el explorador web del cliente.

  5. Realizar una acción con el flujo de datos del formulario

    • Cree un objeto com.adobe.idp.Document invocando el método getOutputContent del objeto FormsResult.
    • Obtenga el tipo de contenido del objeto com.adobe.idp.Document invocando su método getContentType.
    • Establezca el tipo de contenido del objeto javax.servlet.http.HttpServletResponse invocando su método setContentType y pasando el tipo de contenido del objeto com.adobe.idp.Document.
    • Cree un objeto javax.servlet.ServletOutputStream utilizado para escribir el flujo de datos de formulario en el explorador web del cliente invocando el método getOutputStream del objeto javax.servlet.http.HttpServletResponse.
    • Cree un objeto java.io.InputStream invocando el método getInputStream del objeto com.adobe.idp.Document.
    • Cree una matriz de bytes y rellénela con la secuencia de datos de formulario invocando el método read del objeto InputStream. Pase la matriz de bytes como argumento.
    • Invoque el método write del objeto javax.servlet.ServletOutputStream para enviar el flujo de datos de formulario al explorador web del cliente. Pase la matriz de bytes al método write.

Consulte también

SOAP Inicio rápido (modo de): Pasar documentos al servicio de Forms mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión