Puede ensamblar un documento PDF no interactivo cuando utilice un formulario PDF interactivo como entrada. Es decir, supongamos que tiene un formulario que los usuarios pueden utilizar para introducir datos en sus campos. Puede pasar ese formulario al servicio Assembler, lo que hace que el servicio Assembler devuelva un documento PDF que impide que los usuarios introduzcan datos en sus campos. Este documento es un formulario PDF no interactivo. Por ejemplo, la siguiente ilustración muestra una aplicación hipotecaria que representa un formulario interactivo.
A los efectos de esta discusión, supongamos que se utiliza el siguiente documento DDX.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="out.pdf">
<PDF source="inDoc"/>
<NoXFA/>
</PDF>
</DDX>
Dentro de este documento DDX, observe que al atributo de origen se le asigna el valor inDoc
. En situaciones en las que solo se pasa un documento PDF de entrada al servicio Assembler y se devuelve un documento PDF y se invoca la operación invokeOneDocument
, asigne el valor inDoc
al atributo de origen PDF. Al invocar la operación invokeOneDocument
, el valor inDoc
es una clave predefinida que debe especificarse en el documento DDX.
Por el contrario, al pasar dos o más documentos PDF de entrada al servicio Assembler, puede invocar la operación invokeDDX
. En este caso, asigne el nombre de archivo del documento PDF de entrada al atributo source
.
Este documento DDX contiene el elemento NoXFA
, que ordena al servicio Assembler que devuelva un documento PDF no interactivo.
El servicio Assembler puede ensamblar documentos PDF no interactivos sin que el servicio Output forme parte de la instalación de los formularios AEM si el documento PDF de entrada se basa en un formulario Acrobat o un formulario XFA estático. Sin embargo, si el documento PDF de entrada es un formulario XFA dinámico, el servicio Output debe formar parte de la instalación de formularios AEM. Si el servicio Output no forma parte de la instalación de formularios AEM cuando se monta un formulario XFA dinámico, se genera una excepción. Consulte Creación de flujos de salida de documento.
Antes de leer esta sección, se recomienda que esté familiarizado con el ensamblaje de documentos PDF mediante el servicio Assembler. En esta sección no se tratan conceptos como la creación de un objeto de colección que contenga documentos de entrada o el aprendizaje de cómo extraer los resultados del objeto de colección devuelto. (Consulte Agrupación programática de documentos PDF).
Para obtener más información sobre el servicio Assembler, consulte Referencia de servicios para AEM Forms.
Para obtener más información sobre un documento DDX, consulte Servicio de ensamblador y referencia DDX.
Para ensamblar un documento PDF no interactivo, realice las siguientes tareas:
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
si AEM Forms se implementa en un servidor de aplicaciones J2EE compatible que no sea JBoss, debe reemplazar los archivos adobe-Utilities.jar y jbossall-client.jar con archivos JAR específicos del servidor de aplicaciones J2EE en el que AEM Forms está implementado.
Crear un cliente de ensamblador
Para poder realizar una operación Assembler mediante programación, debe crear un cliente de servicio Assembler.
Referencia a un documento DDX existente
Se debe hacer referencia a un documento DDX para ensamblar un documento PDF. Este documento DDX debe contener el elemento NoXFA
, que indica al servicio Assembler que devuelva un documento PDF no interactivo.
Hacer referencia a un documento PDF interactivo
Se debe hacer referencia a un documento PDF interactivo y pasarlo al servicio Assembler para obtener un documento PDF no interactivo.
Establecer opciones de tiempo de ejecución
Puede establecer opciones en tiempo de ejecución que controlan el comportamiento del servicio Assembler mientras realiza un trabajo. Por ejemplo, puede definir una opción que indique al servicio Assembler que continúe procesando un trabajo si se encuentra un error.
Montaje del documento PDF
Después de crear el cliente de servicio Assembler, hacer referencia al documento DDX, hacer referencia a un documento PDF interactivo y establecer las opciones de tiempo de ejecución, puede invocar la operación invokeOneDocument
. Dado que solo se pasa un documento PDF de entrada al servicio Assembler y se devuelve un solo documento, puede utilizar la operación invokeOneDocument
en lugar de la operación invokeDDX
.
Guardar el documento PDF no interactivo
Si solo se pasa un documento PDF al servicio Assembler, el servicio Assembler devuelve un documento único en lugar de un objeto de colección. Es decir, al invocar la operación invokeOneDocument
, se devuelve un solo documento. Dado que el documento DDX al que se hace referencia en esta sección contiene instrucciones para crear un documento PDF no interactivo, el servicio Assembler devuelve un documento PDF no interactivo que puede guardarse como archivo PDF.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Montaje programático de documentos PDF
Ensamble un documento PDF no interactivo mediante la API del servicio Assembler (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-assembler-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente Assembler.
ServiceClientFactory
que contenga propiedades de conexión.AssemblerServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Haga referencia a un documento DDX existente.
java.io.FileInputStream
que represente el documento DDX utilizando su constructor y pasando un valor de cadena que especifique la ubicación del archivo DDX.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Haga referencia a un documento PDF interactivo.
java.io.FileInputStream
utilizando su constructor y pasando la ubicación de un documento PDF interactivo.com.adobe.idp.Document
y pase el objeto java.io.FileInputStream
que contiene el documento PDF. Este objeto com.adobe.idp.Document
se pasa al método invokeOneDocument
.Establezca las opciones de tiempo de ejecución.
AssemblerOptionSpec
que almacene opciones en tiempo de ejecución empleando su constructor.AssemblerOptionSpec
. Por ejemplo, para solicitar al servicio Assembler que continúe procesando un trabajo cuando se produce un error, invoque el método AssemblerOptionSpec
del objeto setFailOnError
y pase false
.Ensamble el documento PDF.
Invoque el método AssemblerServiceClient
del objeto invokeOneDocument
y pase los siguientes valores:
com.adobe.idp.Document
que representa el documento DDX. Asegúrese de que este documento DDX contiene el valor inDoc
para el elemento de origen PDF.com.adobe.idp.Document
que contiene el documento PDF interactivo.com.adobe.livecycle.assembler.client.AssemblerOptionSpec
que especifica las opciones en tiempo de ejecución, incluyendo la fuente predeterminada y el nivel de registro de trabajo.El método invokeOneDocument
devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF no interactivo.
Guarde el documento PDF no interactivo.
java.io.File
y asegúrese de que la extensión del nombre del archivo sea .pdf.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo. Asegúrese de utilizar el objeto Document
que el método invokeOneDocument
devolvió.Ensamble un documento PDF no interactivo mediante la API del servicio Assembler (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un cliente Assembler.
Cree un objeto AssemblerServiceClient
utilizando su constructor predeterminado.
Cree un objeto AssemblerServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/AssemblerService?blob=mtom
). No es necesario utilizar 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 AssemblerServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
AssemblerServiceClient.ClientCredentials.UserName.UserName
.AssemblerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Haga referencia a un documento DDX existente.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar el documento DDX.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento DDX y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición de inicio y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Haga referencia a un documento PDF interactivo.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar el documento PDF de entrada. Este objeto BLOB
se pasa a invokeOneDocument
como argumento.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF de entrada y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición de inicio y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Establezca las opciones de tiempo de ejecución.
AssemblerOptionSpec
que almacene opciones en tiempo de ejecución empleando su constructor.AssemblerOptionSpec
. Por ejemplo, para solicitar al servicio Assembler que continúe procesando un trabajo cuando se produzca un error, asigne false
al miembro de datos AssemblerOptionSpec
del objeto failOnError
.Ensamble el documento PDF.
Invoque el método AssemblerServiceClient
del objeto invokeOneDocument
y pase los siguientes valores:
BLOB
que representa el documento DDXBLOB
que representa el documento PDF interactivoAssemblerOptionSpec
que especifica opciones en tiempo de ejecuciónEl método invokeOneDocument
devuelve un objeto BLOB
que contiene un documento PDF no interactivo.
Guarde el documento PDF no interactivo.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF no interactivo y el modo en el que se abre el archivo.BLOB
que el método invokeOneDocument
devolvió. Rellene la matriz de bytes obteniendo el valor del campo BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM