Pasar documentos al servicio de Forms passing-documents-to-the-formsservice

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.

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.

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.

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.

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.

Incluir archivos de proyecto

Cree un proyecto de Microsoft .NET que utilice MTOM. Dado que esta aplicación cliente invoca dos servicios de AEM Forms, cree dos referencias de servicio. Utilice la siguiente definición WSDL para la referencia de servicio asociada al servicio Forms: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Utilice la siguiente definición de WSDL para la referencia de servicio asociada al servicio de administración de documentos: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Dado que el tipo de datos BLOB es común a ambas referencias de servicio, califique completamente el tipo de datos BLOB al utilizarlo. En el inicio rápido del servicio web correspondiente, todas las instancias de BLOB están completamente calificadas.

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

• Cree un objeto FormsServiceClient utilizando su constructor predeterminado.

• Cree un objeto FormsServiceClient.Endpoint.Address mediante el constructor System.ServiceModel.EndpointAddress. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/FormsService?WSDL). No necesita usar el atributo lc_version. Este atributo se utiliza al crear una referencia de servicio).

• Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo FormsServiceClient.Endpoint.Binding. Convertir el valor devuelto en BasicHttpBinding.

• Establezca el campo MessageEncoding del objeto System.ServiceModel.BasicHttpBinding en WSMessageEncoding.Mtom. Este valor garantiza que se utiliza MTOM.

• Habilite la autenticación HTTP básica realizando las siguientes tareas:

  • Asigne el nombre de usuario de los formularios AEM Forms al campo FormsServiceClient.ClientCredentials.UserName.UserName.
  • Asigne el valor de contraseña correspondiente al campo FormsServiceClient.ClientCredentials.UserName.Password.
  • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

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

Recupere contenido invocando el método retrieveContent del objeto DocumentManagementServiceClient y pasando 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.
• Un parámetro de salida de cadena que almacena el valor del vínculo de exploración.
• Parámetro de salida BLOB que almacena el contenido. Puede utilizar este parámetro de salida para recuperar el contenido.
• Parámetro de salida ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType que almacena atributos de contenido.
• Un parámetro de salida CRCResult. En lugar de usar este objeto, puede usar el parámetro de salida BLOB para obtener el contenido.

Procesar un formulario interactivo de PDF

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

• Un objeto BLOB que contiene el diseño de formulario recuperado de Content Services (obsoleto).
• Objeto BLOB que contiene datos para combinar con el formulario. Si no desea combinar datos, pase un objeto BLOB 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 Map que almacena datos adjuntos de archivos. Este valor es un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.
• Un parámetro de salida largo que se utiliza para almacenar el recuento de páginas.
• Un parámetro de salida de cadena que se utiliza para almacenar el valor de configuración regional.
• Un parámetro de salida FormsResult que se usa para almacenar el formulario PDF interactivo .

El método renderPDFForm2 devuelve un objeto FormsResult que contiene el formulario PDF interactivo.

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

• Cree un objeto BLOB que contenga datos de formulario obteniendo el valor del campo outputContent del objeto FormsResult.
• Cree un objeto System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento interactivo de PDF y el modo en que se abrirá el archivo.
• Cree una matriz de bytes que almacene el contenido del objeto BLOB recuperado del objeto FormsResult. Rellene la matriz de bytes obteniendo el valor del miembro de datos MTOM del objeto BLOB.
• Cree un objeto System.IO.BinaryWriter invocando su constructor y pasando el objeto System.IO.FileStream.
• Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método Write del objeto System.IO.BinaryWriter y pasando la matriz de bytes.