Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
Acerca del servicio Output
El servicio Output permite generar documentos como PDF (incluidos documentos de PDF/A), PostScript, Printer Control Language (PCL) y los siguientes formatos de etiqueta:
Con el servicio Output, puede combinar los datos de formulario XML con un diseño de formulario y enviar el documento a una impresora o archivo de red.
Existen dos maneras de pasar un diseño de formulario (un archivo XDP) al servicio Output. Puede pasar una com.adobe.idp.Document
que contiene un diseño de formulario en el servicio Output. O puede pasar un valor URI que especifique la ubicación del diseño de formulario. Ambas formas se analizan en AEM Programar con formularios de.
El servicio Output no admite documentos del PDF de AcroForm que contengan scripts específicos de objetos de aplicación. Los documentos del PDF de AcroForm que contienen scripts específicos de objetos de aplicación no se representan.
Las secciones siguientes muestran cómo pasar un diseño de formulario al servicio Output mediante un valor URI:
Las secciones siguientes muestran cómo pasar un diseño de formulario dentro de un com.adobe.idp.Document
instancia:
Una consideración al decidir qué técnica utilizar es si obtiene el diseño de formulario de otro servicio de AEM Forms y, a continuación, pasarlo en un com.adobe.idp.Document
ejemplo. Tanto la Pasar documentos al servicio Output y Crear documentos de PDF mediante fragmentos Las secciones muestran cómo obtener un diseño de formulario de otro servicio de AEM Forms. La primera sección recupera el diseño de formulario de Content Services (obsoleto). La segunda sección recupera el diseño de formulario del servicio Assembler.
Si obtiene el diseño de formulario desde una ubicación fija, como el sistema de archivos, puede utilizar cualquiera de las técnicas. Es decir, se puede especificar el valor URI de un archivo XDP o utilizar un com.adobe.idp.Document
ejemplo.
Para pasar un valor URI que especifique la ubicación del diseño de formulario al crear un documento de PDF, utilice el generatePDFOutput
método. Del mismo modo, para pasar un com.adobe.idp.Document
al servicio Output al crear un documento de PDF, utilice el generatePDFOutput2
método.
Al enviar una secuencia de salida a una impresora de red, también puede utilizar cualquiera de estas técnicas. Para enviar una secuencia de salida a una impresora pasando un com.adobe.idp.Document
que contiene un diseño de formulario, utilice la variable sendToPrinter2
método. Para enviar una secuencia de salida a una impresora pasando un valor URI, utilice el sendToPrinter
método. El Envío de flujos de impresión a impresoras utiliza la sección sendToPrinter
método.
Puede realizar estas tareas mediante el servicio Output:
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Puede utilizar el servicio Output para crear un documento de PDF basado en un diseño de formulario y en los datos de formulario XML proporcionados. El documento de PDF creado por el servicio Output no es un documento interactivo de PDF; un usuario no puede introducir ni modificar datos de formulario.
Si desea crear un documento de PDF pensado para el almacenamiento a largo plazo, se recomienda crear un documento de PDF/A. (Consulte Creación de documentos de PDF/A.)
Para crear un formulario interactivo de PDF que permita al usuario introducir datos, utilice el servicio de Forms. (Consulte Procesamiento de PDF forms interactivos.)
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para crear un documento de PDF, realice los siguientes pasos:
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, 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 está implementado AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceService
objeto.
Hacer referencia a una fuente de datos XML
Para combinar datos con el diseño de formulario, debe hacer referencia a un origen de datos XML que contenga datos. Debe existir un elemento XML para cada campo de formulario que planee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. Si se especifican todos los elementos XML, no es necesario coincidir con el orden en que se muestran.
Consulte el siguiente ejemplo de formulario de solicitud de préstamo.
Para combinar datos en este diseño de formulario, debe crear una fuente de datos XML que corresponda al formulario. El siguiente XML representa una fuente de datos XML XDP que corresponde al formulario de aplicación hipotecaria de ejemplo.
<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Establecer las opciones de tiempo de ejecución del PDF
Establezca la opción URI de archivo al crear un documento de PDF. Esta opción especifica el nombre y la ubicación del archivo de PDF que genera el servicio Output.
En lugar de establecer la opción de tiempo de ejecución de URI de archivo, puede recuperar mediante programación el documento de PDF a partir del tipo de datos complejo que devuelve el servicio Output. Sin embargo, al establecer la opción de tiempo de ejecución de URI de archivo, no es necesario crear una lógica de aplicación que recupere mediante programación el documento de PDF.
Establecer opciones de tiempo de ejecución de procesamiento
Puede establecer las opciones de procesamiento en tiempo de ejecución al crear un documento de PDF. Aunque estas opciones no son necesarias (a diferencia de las opciones de tiempo de ejecución de PDF que son necesarias), puede realizar tareas como mejorar el rendimiento del servicio Output. Por ejemplo, puede almacenar en caché el diseño de formulario que utiliza el servicio Output para mejorar su rendimiento.
Si utiliza un formulario Acrobat etiquetado como entrada, no puede utilizar el Java del servicio de salida o la API del servicio web para desactivar la configuración etiquetada. Si intenta establecer esta opción en mediante programación false
, el documento del PDF de resultados seguirá etiquetado.
Si no especifica las opciones de procesamiento en tiempo de ejecución, se utilizarán los valores predeterminados. Para obtener información sobre cómo procesar opciones de tiempo de ejecución, vea la RenderOptionsSpec
referencia de clase. (Consulte Referencia de API de AEM Forms).
Generación de un documento de PDF
Después de hacer referencia a un origen de datos XML válido que contiene datos de formulario y establecer las opciones en tiempo de ejecución, puede invocar el servicio Output, que genera un documento de PDF.
Al generar un documento de PDF, se especifican los valores de URI que requiere el servicio Output para crear un documento de PDF. Un diseño de formulario se puede almacenar en ubicaciones como el sistema de archivos del servidor o como parte de una aplicación de AEM Forms. Se puede hacer referencia a un diseño de formulario (u otros recursos, como un archivo de imagen) que existe como parte de una aplicación de Forms, mediante el valor de URI de la raíz del contenido repository:///
. Por ejemplo, considere el siguiente diseño de formulario denominado Loan.xdp ubicado en una aplicación de Forms denominada Aplicaciones/FormsApplication:
Para acceder al archivo Loan.xdp mostrado en la ilustración anterior, especifique repository:///Applications/FormsApplication/1.0/FormsFolder/
como tercer parámetro pasado a la variable OutputClient
del objeto generatePDFOutput
método. Especifique el nombre del formulario (Loan.xdp) como segundo parámetro que se pasa al OutputClient
del objeto generatePDFOutput
método.
Si el archivo XDP contiene imágenes (u otros recursos como fragmentos), coloque los recursos en la misma carpeta de aplicación que el archivo XDP. AEM Forms utiliza el URI de raíz de contenido como ruta base para resolver referencias a imágenes. Por ejemplo, si el archivo Loan.xdp contiene una imagen, asegúrese de colocar la imagen en Applications/FormsApplication/1.0/FormsFolder/
.
Puede hacer referencia a un URI de aplicación de Forms al invocar el OutputClient
del objeto generatePDFOutput
o generatePrintedOutput
métodos.
Para ver un inicio rápido completo que cree un documento de PDF haciendo referencia a un XDP en una aplicación de Forms, consulte Inicio rápido (modo EJB): Creación de un documento de PDF basado en un archivo XDP de aplicación mediante la API de Java.
Recupere los resultados de la operación
Una vez que el servicio Output realiza una operación, devuelve varios elementos de datos, como datos XML de estado, que especifican si la operación se realizó correctamente.
Consulte también
Creación de un documento de PDF mediante la API de Java
Creación de un documento de PDF mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Cree un documento de PDF con la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Cliente de salida.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML.
java.io.FileInputStream
que representa el origen de datos XML utilizado para rellenar el documento de PDF utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
mediante su constructor. Pase el java.io.FileInputStream
objeto.Establecer las opciones de tiempo de ejecución del PDF.
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto setFileURI
método. Pase un valor de cadena que especifique la ubicación del archivo PDF que genera el servicio Output. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.Establecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.RenderOptionsSpec
del objeto setCacheEnabled
y pasando true
.No se puede establecer la versión del documento de PDF utilizando RenderOptionsSpec
del objeto setPdfVersion
si el documento de entrada es un formulario de Acrobat (un formulario creado en Acrobat) o un documento XFA firmado o certificado. El documento del PDF de salida conserva la versión original del PDF. Del mismo modo, no puede establecer la opción de Adobe PDF etiquetado invocando la variable RenderOptionsSpec
del objeto setTaggedPDF
si el documento de entrada es un formulario Acrobat o un documento XFA firmado o certificado.
No se puede establecer la opción de PDF linealizado mediante la variable RenderOptionsSpec
del objeto setLinearizedPDF
método si el documento del PDF de entrada está certificado o firmado digitalmente. (Consulte Firma digital de documentos de PDF .)
Genera un documento de PDF.
Cree un documento de PDF invocando el OutputClient
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.El generatePDFOutput
El método devuelve un OutputResult
que contiene los resultados de la operación.
Al generar un documento de PDF invocando el generatePDFOutput
no puede combinar datos con un formulario de PDF XFA firmado o certificado. (Consulte Firmar y certificar documentos digitalmente .)
El OutputResult
del objeto getRecordLevelMetaDataList
método devuelve null
.
También puede crear un documento de PDF invocando la variable OutputClient
del objeto generatePDFOutput2
método. (Consulte Pasar documentos en Content Services (obsoleto) al servicio Output .)
Recupere los resultados de la operación.
com.adobe.idp.Document
que representa el estado del objeto generatePDFOutput
operación invocando el OutputResult
del objeto getStatusDoc
método. Este método devuelve datos XML de estado que especifican si la operación se realizó correctamente.java.io.File
que contiene los resultados de la operación. Asegúrese de que la extensión del nombre de archivo sea .xml.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getStatusDoc
método).Aunque el servicio Output escribe el documento del PDF en la ubicación especificada por el argumento que se pasa al PDFOutputOptionsSpec
del objeto setFileURI
, puede recuperar mediante programación el documento PDF/A invocando el método OutputResult
del objeto getGeneratedDoc
método.
Consulte también
Inicio rápido (modo EJB): Creación de un documento de PDF con la API de Java
Inicio rápido (modo SOAP): Creación de un documento de PDF mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Cree un documento de PDF mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos XML que se combinarán con el documento de PDF.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo XML que contiene los datos del formulario.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución del PDF
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto fileURI
miembro de datos. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.Establecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.true
a la RenderOptionsSpec
del objeto cacheEnabled
miembro de datos.No se puede establecer la versión del documento de PDF utilizando RenderOptionsSpec
del objeto setPdfVersion
si el documento de entrada es un formulario de Acrobat (un formulario creado en Acrobat) o un documento XFA firmado o certificado. El documento del PDF de salida conserva la versión original del PDF. Del mismo modo, no puede establecer la opción de Adobe PDF etiquetado invocando la variable RenderOptionsSpec
del objeto setTaggedPDF
* si el documento de entrada es un formulario Acrobat o un documento XFA firmado o certificado.*
No se puede establecer la opción de PDF linealizado mediante la variable RenderOptionsSpec
del objeto linearizedPDF
miembro si el documento del PDF de entrada está certificado o firmado digitalmente. (Consulte Firma digital de documentos de PDF .)
Genera un documento de PDF.
Cree un documento de PDF invocando el OutputServiceService
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con datos de resultado. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).Al generar un documento de PDF invocando el generatePDFOutput
no puede combinar datos con un formulario de PDF XFA firmado o certificado. (Consulte Firmar y certificar documentos digitalmente .)
También puede crear un documento de PDF invocando la variable OutputClient
del objeto generatePDFOutput2
método. (Consulte Pasar documentos en Content Services (obsoleto) al servicio Output .)
Recupere los resultados de la operación.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa una ubicación de archivo XML que contiene datos de resultado. Asegúrese de que la extensión del nombre de archivo sea .xml.BLOB
objeto que se rellenó con datos de resultado por el OutputServiceService
del objeto generatePDFOutput
método (el octavo parámetro). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
field
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
El OutputServiceService
del objeto generateOutput
El método está obsoleto.
Puede utilizar el servicio Output para crear un documento de PDF/A. Como PDF/A es un formato de archivo para la preservación a largo plazo del contenido del documento, todas las fuentes están incrustadas y el archivo no está comprimido. Como resultado, un documento PDF/A suele ser más grande que un documento PDF estándar. Además, un documento de PDF/A no contiene contenido de audio y vídeo. Al igual que otras tareas del servicio Output, puede proporcionar un diseño de formulario y datos para combinarlos con uno para crear un documento de PDF/A.
La especificación PDF/A-1 consta de dos niveles de conformidad, a saber, a y b. La principal diferencia entre ambos está relacionada con la compatibilidad con la estructura lógica (accesibilidad), que no es necesaria para el nivel de conformidad b. Independientemente del nivel de conformidad, PDF/A-1 dicta que todas las fuentes están incrustadas en el documento PDF/A generado.
Aunque PDF/A es el estándar para archivar documentos de PDF, no es obligatorio que PDF/A se utilice para archivar si un documento de PDF estándar satisface las necesidades de su empresa. El propósito del estándar PDF/A es crear un archivo de PDF que se pueda almacenar durante un largo periodo de tiempo y que cumpla los requisitos de conservación de documentos. Por ejemplo, una dirección URL no se puede incrustar en un PDF/A porque, con el tiempo, la dirección URL puede no ser válida.
Su organización debe evaluar sus propias necesidades, el tiempo que desea conservar el documento, las consideraciones sobre el tamaño del archivo y determinar su propia estrategia de archivado. Puede determinar mediante programación si un documento de PDF es compatible con PDF/A mediante el servicio DocConverter. (Consulte Determinación programática de la conformidad de PDF/A.)
Un documento de PDF/A debe utilizar la fuente especificada en el diseño de formulario y las fuentes no se pueden sustituir. Como resultado, si una fuente ubicada en un documento de PDF no está disponible en el sistema operativo (SO) del host, se produce una excepción.
Cuando se abre un documento de PDF/A en Acrobat, aparece un mensaje que confirma que el documento es un documento de PDF/A, como se muestra en la siguiente ilustración.
El sitio web de AIIM tiene una sección de preguntas frecuentes para PDF/administradores a la que puede acceder en https://www.loc.gov/preservation/digital/formats/fdd/fdd000125.shtml.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para crear un documento de PDF/A, realice los siguientes pasos:
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación personalizada 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 está implementado AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceService
objeto.
Hacer referencia a una fuente de datos XML
Para combinar datos con el diseño de formulario, debe hacer referencia a un origen de datos XML que contenga datos. Debe existir un elemento XML para cada campo de formulario que desee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. Si se especifican todos los elementos XML, no es necesario coincidir con el orden en que se muestran.
Establecer las opciones de tiempo de ejecución de PDF/A
Puede establecer la opción URI de archivo al crear un documento de PDF/A. La URI es relativa al servidor de aplicaciones J2EE que aloja AEM Forms. Es decir, si establece C:\Adobe, el archivo se escribe en la carpeta del servidor, no en el equipo cliente. El URI especifica el nombre y la ubicación del archivo PDF/A que genera el servicio Output.
Establecer opciones de tiempo de ejecución de procesamiento
Puede establecer las opciones de procesamiento en tiempo de ejecución al crear documentos de PDF/A. Dos opciones relacionadas con el PDF/A que puede establecer son PDFAConformance
y PDFARevisionNumber
valores. El PDFAConformance
El valor se refiere a la forma en que un documento de PDF cumple los requisitos que especifican cómo se conservan los documentos electrónicos a largo plazo. Los valores válidos para esta opción son A
y B
. Para obtener información sobre la conformidad con los niveles A y B, consulte la especificación ISO PDF/A-1 titulada Gestión de documentos ISO 19005-1.
El PDFARevisionNumber
value hace referencia al número de revisión de un documento de PDF/A. Para obtener más información sobre el número de revisión de un documento de PDF/A, consulte la especificación de PDF/A-1 ISO titulada Gestión de documentos ISO 19005-1.
No puede establecer la opción de Adobe PDF etiquetado en false
al crear un documento PDF/A 1A. PDF/A 1A siempre será un documento de PDF etiquetado. Además, no puede establecer la opción de Adobe PDF etiquetado en true
al crear un documento PDF/A 1B. PDF/A 1B siempre será un documento de PDF sin etiquetar.
Generación de un documento de PDF/A
Después de hacer referencia a un origen de datos XML válido que contiene datos de formulario y establecer las opciones en tiempo de ejecución, puede invocar el servicio Output, lo que hace que genere un documento de PDF/A.
Recupere los resultados de la operación
Una vez que el servicio Output realiza una operación, devuelve varios elementos de datos, como datos XML, que especifican si la operación se realizó correctamente.
Consulte también
Creación de un documento de PDF/administrador mediante la API de Java
Creación de un documento de PDF/administrador mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Cree un documento de PDF/A mediante la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Cliente de salida.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML.
java.io.FileInputStream
que representa el origen de datos XML utilizado para rellenar el documento PDF/A utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Establecer las opciones de tiempo de ejecución de PDF/A.
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto setFileURI
método. Pase un valor de cadena que especifique la ubicación del archivo PDF que genera el servicio Output. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.Establecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.PDFAConformance
invocando el valor de RenderOptionsSpec
del objeto setPDFAConformance
método y pasar un PDFAConformance
valor de enumeración que especifica el nivel de conformidad. Por ejemplo, para especificar el nivel de conformidad A, apruebe PDFAConformance.A
.PDFARevisionNumber
invocando el valor de RenderOptionsSpec
del objeto setPDFARevisionNumber
método y paso PDFARevisionNumber.Revision_1
.La versión de PDF de un documento de PDF/A es 1.4 independientemente del valor especificado para RenderOptionsSpec
del objeto setPdfVersion
método.
Genera un documento de PDF/A.
Cree un documento de PDF/A invocando el OutputClient
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF/A, especifique TransformationFormat.PDFA
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contienen el origen de datos XML que contiene los datos que se van a combinar con el diseño de formulario.El generatePDFOutput
El método devuelve un OutputResult
que contiene los resultados de la operación.
El OutputResult
del objeto getRecordLevelMetaDataList
método devuelve null
.
También puede crear un documento PDF /A invocando el OutputClient
del objeto generatePDFOutput
2 método. (Consulte Pasar documentos en Content Services (obsoleto) al servicio Output.)
Recupere los resultados de la operación.
com.adobe.idp.Document
que representa el estado del objeto generatePDFOutput
invocando el método OutputResult
del objeto getStatusDoc
método.java.io.File
que contendrá los resultados de la operación. Asegúrese de que la extensión del nombre de archivo sea .xml.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getStatusDoc
método).Aunque el servicio Output escribe el documento PDF/A en la ubicación especificada por el argumento que se pasa al PDFOutputOptionsSpec
del objeto setFileURI
, puede recuperar mediante programación el documento PDF/A invocando el método OutputResult
del objeto getGeneratedDoc
método.
Consulte también
Inicio rápido (modo SOAP): Creación de un documento de PDF/A mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión.
Cree un documento de PDF/A mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos que se combinarán con el documento de PDF/A.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF que se va a cifrar y el modo en que se va a abrir el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución de PDF/A.
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto fileURI
miembro de datos. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo clienteEstablecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.PDFAConformance
asignando un valor de PDFAConformance
valor de enumeración para RenderOptionsSpec
del objeto PDFAConformance
miembro de datos. Por ejemplo, para especificar el nivel de conformidad A, asigne a PDFAConformance.A
a este miembro de datos.PDFARevisionNumber
asignando un valor de PDFARevisionNumber
valor de enumeración para RenderOptionsSpec
del objeto PDFARevisionNumber
miembro de datos. Asignar PDFARevisionNumber.Revision_1
a este miembro de datos.La versión de PDF de un documento de PDF/A es 1.4 independientemente del valor especificado.
Genera un documento de PDF/A.
Cree un documento de PDF invocando el OutputServiceService
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat.PDFA
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con datos de resultado. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).También puede crear un documento PDF /A invocando el OutputClient
del objeto generatePDFOutput
2 método. (Consulte Pasar documentos en Content Services (obsoleto) al servicio Output.)
Recupere los resultados de la operación.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa una ubicación de archivo XML que contiene datos de resultado. Asegúrese de que la extensión del nombre de archivo sea .xml.BLOB
objeto que se rellenó con datos de resultado por el OutputServiceService
del objeto generatePDFOutput
método (el octavo parámetro). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
field.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
El servicio Output procesa un formulario de PDF no interactivo basado en un diseño de formulario que normalmente se guarda como archivo XDP y se crea en Designer. Puede pasar un com.adobe.idp.Document
que contiene el diseño de formulario al servicio Output. A continuación, el servicio Output procesa el diseño de formulario en la com.adobe.idp.Document
objeto.
Una ventaja de pasar un com.adobe.idp.Document
al servicio Output es que otras operaciones del servicio AEM Forms devuelven un com.adobe.idp.Document
ejemplo. Es decir, puede obtener una com.adobe.idp.Document
instancia 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) y pasar el archivo XDP al servicio Output dentro de un com.adobe.idp.Document
objeto.
Para obtener más información sobre el servicio Forms, consulte Referencia de servicios para AEM Forms.
Para pasar un documento obtenido de Content Services (obsoleto) al servicio Output, realice las siguientes tareas:
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 una salida y un objeto de API de cliente de administración de documentos
Para poder realizar mediante programación una operación de la API del servicio Output, cree un objeto de la API del cliente Output. 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 Content Services (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 un com.adobe.idp.Document
instancia de (o un BLOB
si utiliza servicios web). A continuación, puede pasar el com.adobe.idp.Document
al Servicio de salida.
Procesar el formulario de PDF no interactivo
Para procesar un formulario no interactivo, pase el com.adobe.idp.Document
instancia devuelta por Content Services (obsoleta) al servicio Output.
Dos nuevos métodos llamados generatePDFOutput2
y g eneratePrintedOutput2
aceptar un com.adobe.idp.Document
que contiene un diseño de formulario. También puede pasar un com.adobe.idp.Document
que contiene el diseño de formulario al servicio Output al enviar un flujo de impresión a una impresora de red.
Realizar una acción con el flujo de datos del formulario
Puede guardar el formulario no interactivo como archivo de PDF. El formulario se puede ver en Adobe Reader o Acrobat.
Consulte también
Pasar documentos al servicio de salida mediante la API de Java
Pasar documentos al servicio Output mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Creación de documentos de PDF mediante fragmentos
Pase un documento recuperado de Content Services (obsoleto) mediante el servicio Output y la API de Content Services (obsoleto) (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar y adobe-contentservices-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Output y un objeto API de cliente de administración de documentos.
ServiceClientFactory
que contiene las propiedades de conexión. (Consulte Estableciendo propiedades de conexión.)OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.DocumentManagementServiceClientImpl
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Recupere el diseño de formulario de Content Services (obsoleto).
Invoque el DocumentManagementServiceClientImpl
del objeto retrieveContent
y pasar los siguientes valores:
SpacesStore
. Este valor es un parámetro obligatorio./Company Home/Form Designs/Loan.xdp
). Este valor es un parámetro obligatorio.El retrieveContent
El método devuelve un valor CRCResult
que contiene el archivo XDP. Recuperar un com.adobe.idp.Document
invocando el método CRCResult
del objeto getDocument
método.
Procese el formulario de PDF no interactivo.
Invoque el OutputClient
del objeto generatePDFOutput2
y pasar los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.com.adobe.idp.Document
que representa el diseño de formulario (utilice la instancia devuelta por el CRCResult
del objeto getDocument
método).PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.El generatePDFOutput2
El método devuelve un OutputResult
que contiene los resultados de la operación.
Realice una acción con el flujo de datos del formulario.
com.adobe.idp.Document
que representa el formulario no interactivo invocando el objeto OutputResult
del objeto getGeneratedDoc
método.java.io.File
que contiene los resultados de la operación. Asegúrese de que la extensión del nombre de archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getGeneratedDoc
método).Consulte también
Inicio rápido (modo EJB): Pasar documentos al servicio Output mediante la API de Java
Inicio rápido (modo SOAP): Pasar documentos al servicio Output mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Pase un documento recuperado de Content Services (obsoleto) mediante el servicio Output y la API de Content Services (obsoleto) (servicio web):
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 de WSDL para la referencia de servicio asociada al servicio Output: http://localhost:8080/soap/services/OutputService?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
.
Debido a que el BLOB
El tipo de datos es común a ambas referencias de servicio. Califique completamente el BLOB
tipo de datos al utilizarlo. En el inicio rápido del servicio web correspondiente, todas las etiquetas BLOB
Las instancias de están totalmente cualificadas.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Output y un objeto API de cliente de administración de documentos.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
). No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio).
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asignar el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Repita estos pasos para el DocumentManagementServiceClient
cliente de servicio.
Recupere el diseño de formulario de Content Services (obsoleto).
Recupere contenido invocando el DocumentManagementServiceClient
del objeto retrieveContent
y pasando los siguientes valores:
SpacesStore
. Este valor es un parámetro obligatorio./Company Home/Form Designs/Loan.xdp
). Este valor es un parámetro obligatorio.BLOB
parámetro de salida que almacena el contenido. Puede utilizar este parámetro de salida para recuperar el contenido.ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
parámetro de salida que almacena atributos de contenido.CRCResult
parámetro de salida. En lugar de utilizar este objeto, puede utilizar la variable BLOB
parámetro de salida para recuperar el contenido.Procese el formulario de PDF no interactivo.
Invoque el OutputServiceClient
del objeto generatePDFOutput2
y pasar los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.BLOB
que representa el diseño de formulario (utilice el BLOB
instancia devuelta por Content Services (obsoleto).PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objeto que se rellena con la variable generatePDFOutput2
método. El generatePDFOutput2
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).El generatePDFOutput2
El método devuelve un valor BLOB
que contiene el formulario de PDF no interactivo.
Realice una acción con el flujo de datos del formulario.
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento interactivo del PDF y el modo en que se abrirá el archivo.BLOB
objeto recuperado del generatePDFOutput2
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
El servicio Output procesa un formulario de PDF no interactivo basado en un diseño de formulario que normalmente se guarda como archivo XDP y se crea en Designer. Puede pasar un com.adobe.idp.Document
que contiene el diseño de formulario al servicio Output. A continuación, el servicio Output procesa el diseño de formulario en la com.adobe.idp.Document
objeto.
Una ventaja de pasar un com.adobe.idp.Document
al servicio Output es que otras operaciones del servicio AEM Forms devuelven un com.adobe.idp.Document
ejemplo. Es decir, puede obtener una com.adobe.idp.Document
instancia de otra operación de servicio y procesarla. Por ejemplo, supongamos que hay un archivo XDP almacenado en el repositorio de AEM Forms, como se muestra en la siguiente ilustración.
El FormsFolder La carpeta es una ubicación definida por el usuario en el repositorio de AEM Forms (esta ubicación es un ejemplo y no existe de forma predeterminada). En este ejemplo, hay un diseño de formulario denominado Loan.xdp en esta carpeta. Además del diseño de formulario, en esta ubicación se pueden almacenar otros materiales colaterales de formulario, como imágenes. La ruta a un recurso en el repositorio de AEM Forms es:
Applications/Application-name/Application-version/Folder.../Filename
Puede recuperar mediante programación Loan.xdp del repositorio de AEM Forms y pasarlo al servicio Output dentro de un com.adobe.idp.Document
objeto.
Puede crear un PDF basado en un archivo XDP en el repositorio de mediante uno de los dos métodos siguientes. Puede pasar la ubicación XDP por referencia o puede recuperar el XDP del repositorio mediante programación y pasarlo al servicio Output dentro de un archivo XDP.
Inicio rápido (modo EJB): Creación de un documento de PDF basado en un archivo XDP de aplicación mediante la API de Java (muestra cómo pasar la ubicación del archivo XDP por referencia).
Inicio rápido (modo EJB): Pasar un documento del repositorio de AEM Forms al servicio Output mediante la API de Java (muestra cómo recuperar mediante programación el archivo XDP del repositorio de AEM Forms y pasarlo al servicio Output dentro de un com.adobe.idp.Document
ejemplo). (Esta sección explica cómo realizar esta tarea)
Para obtener más información sobre el servicio Forms, consulte Referencia de servicios para AEM Forms.
Para pasar un documento obtenido del repositorio de AEM Forms al servicio Output, realice las siguientes tareas:
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 una salida y un objeto de API de cliente de administración de documentos
Para poder realizar mediante programación una operación de la API del servicio Output, cree un objeto de la API del cliente Output. 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 del repositorio de AEM Forms
Recupere el archivo XDP del repositorio de AEM Forms mediante la API del repositorio. (Consulte Leyendo recursos.)
El archivo XDP se devuelve en un com.adobe.idp.Document
instancia de (o un BLOB
si utiliza servicios web). A continuación, puede pasar el com.adobe.idp.Document
del servicio Output.
Procesar el formulario de PDF no interactivo
Para procesar un formulario no interactivo, pase el com.adobe.idp.Document
instancia devuelta mediante la API de repositorio de AEM Forms.
Dos nuevos métodos llamados generatePDFOutput2
y generatePrintedOutput2
aceptar un com.adobe.idp.Document
que contiene un diseño de formulario. También puede pasar un com.adobe.idp.Document
que contiene el diseño de formulario al servicio Output al enviar un flujo de impresión a una impresora de red.
Realizar una acción con el flujo de datos del formulario
Puede guardar el formulario no interactivo como archivo de PDF. El formulario se puede ver en Adobe Reader o Acrobat.
Consulte también
Pasar documentos del repositorio al servicio de salida mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
ResourceRepositoryClient
Pase un documento recuperado del repositorio mediante el servicio Output y la API del repositorio (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar y adobe-repository-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Output y un objeto API de cliente de administración de documentos.
ServiceClientFactory
que contiene las propiedades de conexión. (Consulte Estableciendo propiedades de conexión.)OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.DocumentManagementServiceClientImpl
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Recupere el diseño de formulario del repositorio de AEM Forms.
Invoque el ResourceRepositoryClient
del objeto readResourceContent
y pasar un valor de cadena que especifique la ubicación del URI al archivo XDP. Por ejemplo, /Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. Este valor es obligatorio. Este método devuelve un com.adobe.idp.Document
que representa el archivo XDP.
Procese el formulario de PDF no interactivo.
Invoque el OutputClient
del objeto generatePDFOutput2
y pasar los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.repository:///Applications/FormsApplication/1.0/FormsFolder/
.com.adobe.idp.Document
que representa el diseño de formulario (utilice la instancia devuelta por el ResourceRepositoryClient
del objeto readResourceContent
método).PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.El generatePDFOutput2
El método devuelve un OutputResult
que contiene los resultados de la operación.
Realice una acción con el flujo de datos del formulario.
com.adobe.idp.Document
que representa el formulario no interactivo invocando el objeto OutputResult
del objeto getGeneratedDoc
método.java.io.File
que contiene los resultados de la operación. Asegúrese de que la extensión del nombre de archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getGeneratedDoc
método).Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Puede utilizar los servicios Output y Assembler para crear una secuencia de salida, como un documento de PDF, basada en fragmentos. El servicio Assembler ensambla un documento XDP basado en fragmentos de varios archivos XDP. El documento XDP ensamblado se pasa al servicio Output, que crea un documento de PDF. Aunque este flujo de trabajo muestra un documento de PDF que se está generando, el servicio Output puede generar otros tipos de salida, como ZPL, para este flujo de trabajo. Un documento de PDF se utiliza únicamente con fines de discusión.
La siguiente ilustración muestra este flujo de trabajo.
Antes de leer Crear documentos de PDF mediante fragmentos Sin embargo, se recomienda familiarizarse con el uso del servicio Assembler para ensamblar varios documentos XDP. (Consulte Agrupar varios fragmentos XDP.)
También puede pasar un diseño de formulario ensamblado por el servicio Assembler al servicio Forms en lugar del servicio Output. La principal diferencia entre el servicio Output y el servicio Forms es que el servicio Forms genera documentos de PDF interactivos y el servicio Output produce documentos de PDF no interactivos. Además, el servicio Forms no puede generar flujos de salida basados en impresora como ZPL.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para crear un documento PDF basado en fragmentos, realice los siguientes pasos:
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, asegúrese de incluir los archivos proxy.
Crear un objeto de cliente Output y Assembler
Para poder realizar mediante programación una operación de la API del servicio Output, cree un objeto de la API del cliente Output. Además, dado que este flujo de trabajo invoca el servicio Assembler para crear el diseño de formulario, cree un objeto de API de cliente Assembler.
Utilizar el servicio Assembler para generar el diseño de formulario
Utilice el servicio Assembler para generar el diseño de formulario mediante fragmentos. El servicio Assembler devuelve un com.adobe.idp.Document
instancia que contiene el diseño de formulario.
Utilice el servicio Output para generar el documento de PDF
Puede utilizar el servicio Output para generar un documento de PDF mediante el diseño de formulario que ha creado el servicio Assembler. Pase el com.adobe.idp.Document
Instancia de que el servicio Assembler devolvió al servicio Output.
Guardar el documento de PDF como archivo de PDF
Una vez que el servicio Output haya generado un documento de PDF, puede guardarlo como un archivo de PDF.
Consulte también
Creación de un documento de PDF basado en fragmentos mediante la API de Java
Cree un documento de PDF basado en fragmentos mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Cree un documento de PDF basado en fragmentos mediante la API del servicio de salida y la API del servicio del ensamblador (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Output y Assembler Client.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.AssemblerServiceClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Utilice el servicio Assembler para generar el diseño de formulario.
Invoque el AssemblerServiceClient
del objeto invokeDDX
y pasar los siguientes valores obligatorios:
com.adobe.idp.Document
que representa el documento DDX que se va a utilizar.java.util.Map
que contiene los archivos XDP de entrada.com.adobe.livecycle.assembler.client.AssemblerOptionSpec
que especifica las opciones en tiempo de ejecución, incluida la fuente predeterminada y el nivel de registro de trabajo.El invokeDDX
El método devuelve un valor com.adobe.livecycle.assembler.client.AssemblerResult
que contiene el documento XDP ensamblado. Para recuperar el documento XDP ensamblado, realice las siguientes acciones:
AssemblerResult
del objeto getDocuments
método. Este método devuelve un java.util.Map
objeto.java.util.Map
hasta que encuentre el resultado com.adobe.idp.Document
objeto.com.adobe.idp.Document
del objeto copyToFile
para extraer el documento XDP ensamblado.Utilice el servicio Output para generar el documento de PDF.
Invoque el OutputClient
del objeto generatePDFOutput2
y pasar los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
com.adobe.idp.Document
que representa el diseño de formulario (utilice la instancia devuelta por el servicio Assembler)PDFOutputOptionsSpec
objeto que contiene opciones de tiempo de ejecución de PDFRenderOptionsSpec
objeto que contiene opciones de procesamiento en tiempo de ejecucióncom.adobe.idp.Document
que contiene el origen de datos XML que contiene los datos que se van a combinar con el diseño de formularioEl generatePDFOutput2
El método devuelve un OutputResult
que contiene los resultados de la operación
Guarde el documento de PDF como un archivo de PDF.
com.adobe.idp.Document
que representa el documento del PDF invocando el OutputResult
del objeto getGeneratedDoc
método.java.io.File
que contiene los resultados de la operación. Asegúrese de que la extensión del nombre del archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo. (Asegúrese de utilizar la variable com.adobe.idp.Document
objetar que la getGeneratedDoc
método devuelto).Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión.
Cree un documento de PDF basado en fragmentos mediante la API del servicio de salida y la API del servicio del ensamblador (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Utilice la siguiente definición de WSDL para la referencia de servicio asociada al servicio Output:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.
Utilice la siguiente definición de WSDL para la referencia de servicio asociada al servicio Assembler:
http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.
Debido a que el BLOB
El tipo de datos es común a ambas referencias de servicio. Califique completamente el BLOB
tipo de datos al utilizarlo. En el inicio rápido del servicio web correspondiente, todas las etiquetas BLOB
Las instancias de están totalmente cualificadas.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Output y Assembler Client.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
field.OutputServiceClient.ClientCredentials.UserName.Password
field.HttpClientCredentialType.Basic
a la BasicHttpBindingSecurity.Transport.ClientCredentialType
field.Asigne el BasicHttpSecurityMode.TransportCredentialOnly
valor constante para BasicHttpBindingSecurity.Security.Mode
field.
Repita estos pasos para el AssemblerServiceClient
objeto.
Utilice el servicio Assembler para generar el diseño de formulario.
Invoque el AssemblerServiceClient
del objeto invokeDDX
y pasar los siguientes valores:
BLOB
que representa el documento DDXMyMapOf_xsd_string_To_xsd_anyType
que contiene los archivos necesariosAssemblerOptionSpec
objeto que especifica opciones en tiempo de ejecuciónEl invokeDDX
El método devuelve un AssemblerResult
que contiene los resultados del trabajo y las excepciones que se han producido. Para obtener el documento XDP recién creado, realice las siguientes acciones:
AssemblerResult
del objeto documents
, que es un Map
que contiene los documentos de PDF resultantes.Map
para recuperar el diseño de formulario ensamblado. Convierta el de ese miembro de la matriz value
a un BLOB
. Pasar esto BLOB
al Servicio de salida.Utilice el servicio Output para generar el documento de PDF.
Invoque el OutputServiceClient
del objeto generatePDFOutput2
y pasar los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.BLOB
que representa el diseño de formulario (utilice el BLOB
instancia devuelta por el servicio Assembler).PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objetar que la generatePDFOutput2
rellena el método. El generatePDFOutput2
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).El generatePDFOutput2
El método devuelve un valor BLOB
que contiene el formulario de PDF no interactivo.
Guarde el documento de PDF como un archivo de PDF.
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento interactivo del PDF y el modo en que se abrirá el archivo.BLOB
objeto recuperado del generatePDFOutput2
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Puede utilizar el servicio Output para imprimir secuencias como PostScript, Printer Control Language (PCL) o los siguientes formatos de etiqueta en un archivo:
Con el servicio Output, puede combinar datos XML con un diseño de formulario e imprimir el formulario en un archivo. La siguiente ilustración muestra el servicio Output creando archivos láser y de etiqueta.
Para obtener información acerca de cómo enviar secuencias de impresión a impresoras, vea Envío de flujos de impresión a impresoras.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para imprimir en un archivo, realice los siguientes pasos:
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, 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 está implementado AEM Forms. (Consulte Incluir archivos de biblioteca Java de AEM Forms.)
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceService
objeto.
Hacer referencia a una fuente de datos XML
Para imprimir un documento que contenga datos, debe hacer referencia a un origen de datos XML que contenga elementos XML para cada campo de formulario que desee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. Si se especifican todos los elementos XML, no es necesario coincidir con el orden en que se muestran.
Establecer las opciones de tiempo de ejecución de impresión necesarias para imprimir en un archivo
Para imprimir en un archivo, debe establecer la opción de tiempo de ejecución URI de archivo especificando la ubicación y el nombre del archivo en el que se imprime el servicio Output. Por ejemplo, para indicar al servicio Output que imprima un archivo PostScript denominado MortgageForm.ps para C:\Adobe, especifique C:\Adobe\MortgageForm.ps.
Hay opciones opcionales en tiempo de ejecución que puede definir. Para obtener información sobre todas las opciones que puede establecer, consulte la PrintedOutputOptionsSpec
referencia de clase en Referencia de API de AEM Forms.
Imprimir el flujo de impresión en un archivo
Después de hacer referencia a un origen de datos XML válido que contiene datos de formulario y establecer las opciones de tiempo de ejecución de impresión, puede invocar el servicio Output, que hace que imprima un archivo.
Recupere los resultados de la operación
Una vez que el servicio Output realiza una operación, devuelve varios elementos de datos, como datos XML, que especifican si la operación se realizó correctamente.
Consulte también
Imprimir en archivos mediante la API de Java
Imprimir en archivos mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Imprimir en un archivo con la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Cliente de salida.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML.
java.io.FileInputStream
que representa el origen de datos XML utilizado para rellenar el documento utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Establecer las opciones de tiempo de ejecución de impresión necesarias para imprimir en un archivo.
PrintedOutputOptionsSpec
mediante su constructor.setFileURI
y pasando un valor de cadena que representa el nombre y la ubicación del archivo. Por ejemplo, si desea que el servicio Output imprima en un archivo PostScript denominado MortgageForm.ps en C:\Adobe, especifique C:\Adobe\MortgageForm.ps.PrintedOutputOptionsSpec
del objeto setCopies
y pasando un valor entero que representa el número de copias.Imprimir el flujo de impresión en un archivo.
Imprimir en un archivo invocando el OutputClient
del objeto generatePrintedOutput
y pasando los siguientes valores:
PrintFormat
valor de enumeración que especifica el formato de secuencia de impresión que se va a crear. Por ejemplo, para crear un flujo de impresión PostScript, pase PrintFormat.PostScript
.null
si ha especificado el archivo XDC que se va a utilizar utilizando la variable PrintedOutputOptionsSpec
objeto).PrintedOutputOptionsSpec
que contiene las opciones en tiempo de ejecución necesarias para imprimir en un archivo.com.adobe.idp.Document
que contienen el origen de datos XML que contiene los datos del formulario.El generatePrintedOutput
El método devuelve un OutputResult
que contiene los resultados de la operación.
El OutputResult
del objeto getRecordLevelMetaDataList
método devuelve null
.
Recupere los resultados de la operación.
com.adobe.idp.Document
que representa el estado del objeto generatePrintedOutput
invocando el método OutputResult
del objeto getStatusDoc
método (el OutputResult
ha devuelto el objeto el generatePrintedOutput
método).java.io.File
que contendrá los resultados de la operación. Asegúrese de que la extensión del archivo sea XML.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getStatusDoc
método).Consulte también
Inicio rápido (modo SOAP): Impresión en un archivo mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión.
Imprimir en un archivo mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos de formulario.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML que contiene los datos del formulario.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su binaryData
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución de impresión necesarias para imprimir en un archivo.
PrintedOutputOptionsSpec
mediante su constructor.PrintedOutputOptionsSpec
del objeto fileURI
miembro de datos. Por ejemplo, si desea que el servicio Output imprima en un archivo PostScript denominado MortgageForm.ps en C:\Adobe, especifique C:\Adobe\MortgageForm.ps.PrintedOutputOptionsSpec
del objeto copies
miembros de datos.Imprimir el flujo de impresión en un archivo.
Imprimir en un archivo invocando el OutputServiceService
del objeto generatePrintedOutput
y pasando los siguientes valores:
PrintFormat
valor de enumeración que especifica el formato de secuencia de impresión que se va a crear. Por ejemplo, para crear un flujo de impresión PostScript, pase PrintFormat.PostScript
.null
si ha especificado el archivo XDC que se va a utilizar utilizando la variable PrintedOutputOptionsSpec
objeto).PrintedOutputOptionsSpec
que contiene las opciones de tiempo de ejecución de impresión necesarias para imprimir en un archivo.BLOB
que contiene el origen de datos XML que contiene los datos del formulario.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con datos de resultado. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).Recupere los resultados de la operación.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa una ubicación de archivo XML que contiene datos de resultado. Asegúrese de que la extensión del archivo sea XML.BLOB
objeto que se rellenó con datos de resultado por el OutputServiceService
del objeto generatePDFOutput
método (el octavo parámetro). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Puede utilizar el servicio Output para enviar secuencias de impresión como PostScript, Printer Control Language (PCL) o los siguientes formatos de etiqueta a impresoras de red:
Con el servicio Output, puede combinar datos XML con un diseño de formulario y generar la salida del formulario como una secuencia de impresión. Por ejemplo, puede crear un flujo de impresión PostScript y enviarlo a una impresora de red. En la ilustración siguiente se muestra el Servicio de salida que envía secuencias de impresión a impresoras de red.
Para mostrar cómo enviar una secuencia de impresión a una impresora de red, esta sección envía una secuencia de impresión PostScript a una impresora de red mediante el protocolo de impresora SharedPrinter.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para enviar un flujo de impresión a una impresora de red, realice los siguientes pasos:
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, 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 está implementado AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, cree un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceClient
objeto.
Hacer referencia a una fuente de datos XML
Para imprimir un documento que contenga datos, debe hacer referencia a un origen de datos XML que contenga elementos XML para cada campo de formulario que desee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. Si se especifican todos los elementos XML, no es necesario coincidir con el orden en que se muestran.
Definir opciones de tiempo de ejecución de impresión
Puede establecer las opciones en tiempo de ejecución al enviar un flujo de impresión a una impresora, incluidas las siguientes opciones:
Para obtener información acerca de todas las opciones de tiempo de ejecución que puede establecer, vea la PrintedOutputOptionsSpec
referencia de clase.
Recuperar un documento para imprimir
Recupere un flujo de impresión para enviarlo a una impresora. Por ejemplo, puede recuperar un archivo PostScript y enviarlo a una impresora.
Puede elegir enviar un archivo de PDF si la impresora admite PDF. Sin embargo, un problema con el envío de un documento de PDF a una impresora es que cada fabricante de la impresora tiene una implementación diferente del intérprete de PDF. Es decir, algunos fabricantes de impresión utilizan la interpretación de Adobe PDF, pero depende de la impresora. Otras impresoras tienen su propio intérprete PDF. Como resultado, los resultados de impresión pueden variar.
Otra limitación del envío de un documento de PDF a una impresora es que sólo imprime; no puede tener acceso a doble cara, selección de bandeja de papel y grapado, excepto a través de la configuración de la impresora.
Para recuperar un documento que imprimir, utilice la variable generatePrintedOutput
método. En la tabla siguiente se especifican los tipos de contenido que se establecen para un flujo de impresión determinado al utilizar el generatePrintedOutput
método.
Formato de impresión |
Descripción |
---|---|
DPL |
Crea un dpl203.xdc de forma predeterminada o una secuencia de salida xdc personalizada. |
DPL 300 ppp |
Crea un flujo de salida DPL 300 DPI. |
DPL 406 ppp |
Crea un flujo de salida DPL 400 DPI. |
DPL 600 ppp |
Crea un flujo de salida DPL 600 DPI. |
GenericColorPCL |
Crea un flujo de salida PCL (5c) de color genérico. |
GenericPSLevel3 |
Crea un flujo de salida PostScript genérico de nivel 3. |
IPL |
Crea un flujo de salida IPL personalizado. |
IPL 300 ppp |
Crea un flujo de salida IPL de 300 ppp. |
IPL 400 ppp |
Crea un flujo de salida IPL de 400 ppp. |
PCL |
Crea un flujo de salida PCL (5e) monocromo genérico. |
PostScript |
Crea un flujo de salida PostScript genérico de nivel 2. |
TPCL |
Crea un flujo de salida TPCL personalizado. |
TPCL 305 ppp |
Crea un flujo de salida TPCL de 305 ppp. |
TPCL 600 ppp |
Crea un flujo de salida TPCL de 600 ppp. |
ZPL |
Crea un flujo de salida ZPL 203 DPI. |
ZPL 300 ppp |
Crea un flujo de salida ZPL 300 DPI. |
También puede enviar un flujo de impresión a una impresora mediante el generatePrintedOutput2
método. Sin embargo, los inicios rápidos asociados con la sección Envío de flujos de impresión a impresoras utilizan la variable generatePrintedOutput
método.
Enviar el flujo de impresión a una impresora de red
Después de recuperar un documento para imprimir, puede invocar el servicio Output, que hace que envíe un flujo de impresión a una impresora de red. Para que el servicio Output busque correctamente la impresora, debe especificar el servidor de impresión y el nombre de la impresora. Además, también debe especificar el protocolo de impresión.
Si PDFG está instalado en Forms Server y el servidor se ejecuta en Windows Server 2008, no se puede utilizar la propiedad SharedPrinter. En este caso, utilice un protocolo de impresora diferente.
Si utiliza una impresora de red y el mecanismo de acceso es SharedPrinter, debe especificar la ruta de red completa de la impresora.Envíe una secuencia de impresión a una impresora de red mediante la API de Java
Envíe un flujo de impresión a una impresora de red mediante la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Crear un objeto de cliente de salida
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML
java.io.FileInputStream
que representa el origen de datos XML utilizado para rellenar el documento utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Definir opciones de tiempo de ejecución de impresión
Crear un PrintedOutputOptionsSpec
que representa las opciones de tiempo de ejecución de impresión. Por ejemplo, puede especificar el número de copias que desea imprimir invocando la variable PrintedOutputOptionsSpec
del objeto setCopies
método.
No se puede establecer el valor de paginación utilizando PrintedOutputOptionsSpec
del objeto setPagination
método si genera un flujo de impresión ZPL. Del mismo modo, no puede establecer las siguientes opciones para un flujo de impresión ZPL: OutputJog, PageOffset y Staple. El setPagination
El método no es válido para la generación de PostScript. Solo es válido para la generación PCL.
Recuperar un documento para imprimir
Recupere un documento para imprimir invocando el OutputClient
del objeto generatePrintedOutput
y pasando los siguientes valores:
PrintFormat
valor de enumeración que especifica la secuencia de impresión. Por ejemplo, para crear un flujo de impresión PostScript, pase PrintFormat.PostScript
.PrintedOutputOptionsSpec
que contiene opciones en tiempo de ejecución necesarias para imprimir en un archivo.com.adobe.idp.Document
que representa el origen de datos XML que contiene los datos del formulario para combinarlos con el diseño de formulario.Este método devuelve un OutputResult
que contiene los resultados de la operación.
Crear un com.adobe.idp.Document
objeto para enviar a la impresora invocando el OutputResult
del objeto getGeneratedDoc
método. Este método devuelve un com.adobe.idp.Document
objeto.
Enviar el flujo de impresión a una impresora de red
Envíe el flujo de impresión a una impresora de red invocando el OutputClient
del objeto sendToPrinter
y pasando los siguientes valores:
com.adobe.idp.Document
que representa el flujo de impresión que se va a enviar a la impresora.PrinterProtocol
valor de enumeración que especifica el protocolo de impresora que se va a utilizar. Por ejemplo, para especificar el protocolo SharedPrinter, pase PrinterProtocol.SharedPrinter
.\\\PrintSever1
.\\\PrintSever1\Printer1
.El sendToPrinter
se ha añadido a la API de AEM Forms en la versión 8.2.1.
Enviar un flujo de impresión a una impresora de red mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos de formulario.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del archivo XML que contiene los datos del formulario.System.IO.FileStream
objeto. Determinar la longitud de la matriz de bytes obteniendo System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución de impresión.
Crear un PrintedOutputOptionsSpec
mediante su constructor. Por ejemplo, puede especificar el número de copias que desea imprimir asignando un valor entero que represente el número de copias al PrintedOutputOptionsSpec
del objeto copies
miembro de datos.
No se puede establecer el valor de paginación utilizando PrintedOutputOptionsSpec
del objeto pagination
miembro de datos si genera un flujo de impresión ZPL. Del mismo modo, no puede establecer las siguientes opciones para un flujo de impresión ZPL: OutputJog, PageOffset y Staple. El pagination
El miembro de datos no es válido para la generación PostScript. Solo es válido para la generación PCL.
Recupere un documento para imprimir.
Recupere un documento para imprimir invocando el OutputServiceService
del objeto generatePrintedOutput
y pasando los siguientes valores:
PrintFormat
valor de enumeración que especifica la secuencia de impresión. Por ejemplo, para crear un flujo de impresión PostScript, pase PrintFormat.PostScript
.PrintedOutputOptionsSpec
objeto que contiene opciones de tiempo de ejecución de impresión que se utilizan al enviar un flujo de impresión a una impresora de red.BLOB
que contiene el origen de datos XML que contiene los datos del formulario.BLOB
objeto que se rellena con la variable generatePrintedOutput
método. El generatePrintedOutput
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).BLOB
objeto que se rellena con la variable generatePrintedOutput
método. El generatePrintedOutput
Este método rellena este objeto con datos de resultado. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).Crear un BLOB
objeto que se va a enviar a la impresora obteniendo el valor del OutputResult
del objeto generatedDoc
método. Este método devuelve un BLOB
que contiene datos PostScript devueltos por el generatePrintedOutput
método.
Envíe el flujo de impresión a una impresora de red.
Envíe el flujo de impresión a una impresora de red invocando el OutputClient
del objeto sendToPrinter
y pasando los siguientes valores:
BLOB
que representa el flujo de impresión que se va a enviar a la impresora.PrinterProtocol
valor de enumeración que especifica el protocolo de impresora que se va a utilizar. Por ejemplo, para especificar el protocolo SharedPrinter, pase PrinterProtocol.SharedPrinter
.bool
valor que especifica si se va a utilizar el valor del parámetro anterior. Pasar el valor true
. (Este valor de parámetro solo es necesario para la invocación del servicio web).\\\PrintSever1
.\\\PrintSever1\Printer1
.El sendToPrinter
se ha añadido a la API de AEM Forms en la versión 8.2.1.
El servicio Output puede crear documentos independientes para cada registro de un origen de datos XML o un solo archivo que contenga todos los registros (esta funcionalidad es la predeterminada). Por ejemplo, supongamos que hay diez registros ubicados en un origen de datos XML y que indica al servicio Output que cree documentos de PDF independientes (u otros tipos de salida) para cada registro mediante la API del servicio Output. Como resultado, el servicio Output genera diez documentos de PDF. (En lugar de crear documentos, puede enviar varias secuencias de impresión a una impresora.)
La siguiente ilustración también muestra el Servicio de salida procesando un archivo de datos XML que contiene varios registros. Sin embargo, supongamos que ordena al servicio Output que cree un único documento de PDF que contenga todos los registros de datos. En este caso, el servicio Output genera un documento que contiene todos los registros.
La siguiente ilustración muestra el Servicio de salida procesando un archivo de datos XML que contiene varios registros. Supongamos que ordena al servicio Output que cree un documento de PDF independiente para cada registro de datos. En este caso, el servicio Output genera un documento de PDF independiente para cada registro de datos.
Los siguientes datos XML muestran un ejemplo de un archivo de datos que contiene tres registros de datos.
<?xml version="1.0" encoding="UTF-8"?>
<batch>
<LoanRecord>
<mortgageAmount>500000</mortgageAmount>
<lastName>Blue</lastName>
<firstName>Tony</firstName>
<SSN>555666777</SSN>
<PositionTitle>Product Manager</PositionTitle>
<Address>555 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>TBlue@NoMailServer.com</Email>
<PhoneNum>555-7418</PhoneNum>
<FaxNum>555-9981</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>300000</mortgageAmount>
<lastName>White</lastName>
<firstName>Sam</firstName>
<SSN>555666222</SSN>
<PositionTitle>Program Manager</PositionTitle>
<Address>557 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>SWhite@NoMailServer.com</Email>
<PhoneNum>555-7445</PhoneNum>
<FaxNum>555-9986</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>700000</mortgageAmount>
<lastName>Green</lastName>
<firstName>Steve</firstName>
<SSN>55566688</SSN>
<PositionTitle>Project Manager</PositionTitle>
<Address>445 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>SGreeb@NoMailServer.com</Email>
<PhoneNum>555-2211</PhoneNum>
<FaxNum>555-2221</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
</batch>
Observe que el elemento XML que inicia y finaliza cada registro de datos es LoanRecord
. La lógica de la aplicación que genera varios archivos hace referencia a este elemento XML.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para crear varios archivos de PDF basados en una fuente de datos XML, realice los siguientes pasos:
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 está implementado AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceService
objeto.
Hacer referencia a una fuente de datos XML
Hacer referencia a un origen de datos XML que contiene varios registros. Se debe utilizar un elemento XML para separar los registros de datos. Por ejemplo, en la fuente de datos XML de ejemplo que se muestra anteriormente en esta sección, el elemento XML que separa los registros de datos se denomina LoanRecord
.
Debe existir un elemento XML para cada campo de formulario que desee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. Si se especifican todos los elementos XML, no es necesario coincidir con el orden en que se muestran.
Establecer las opciones de tiempo de ejecución del PDF
Establezca las siguientes opciones en tiempo de ejecución para que el servicio Output cree correctamente varios archivos basados en un origen de datos XML:
LoanRecord
. (En lugar de establecer la opción de tiempo de ejecución Nombre del registro, puede establecer el nivel de registro asignándole un valor numérico que indique el nivel de elemento que contiene los registros de datos. Sin embargo, sólo puede establecer el Nombre del registro o el Nivel de registro. No puede establecer ambos valores).Establecer opciones de tiempo de ejecución de procesamiento
Puede establecer opciones de procesamiento en tiempo de ejecución al crear varios archivos. Aunque estas opciones no son necesarias (a diferencia de las opciones de tiempo de ejecución de salida, que son necesarias), puede realizar tareas como mejorar el rendimiento del servicio Output. Por ejemplo, puede almacenar en caché el diseño de formulario que utiliza el servicio Output para mejorar el rendimiento.
Cuando el Servicio de salida procesa los registros por lotes, lee de forma incremental los datos que contienen varios registros. Es decir, el servicio Output lee los datos en la memoria y los libera a medida que se procesa el lote de registros. El servicio Output carga los datos de forma incremental cuando se establece una de las dos opciones de tiempo de ejecución. Si establece la opción de tiempo de ejecución Nombre del registro, el servicio Output leerá los datos de forma incremental. Del mismo modo, si establece la opción de tiempo de ejecución Nivel de registro en 2 o superior, el servicio Output leerá los datos de forma incremental.
Puede controlar si el Servicio de salida realiza una carga incremental utilizando PDFOutputOptionsSpec
o el PrintedOutputOptionSpec
del objeto setLazyLoading
método. Puede pasar el valor false
a este método, que desactiva la carga incremental.
Generación de varios archivos de PDF
Después de hacer referencia a un origen de datos XML válido que contiene varios registros de datos y establecer opciones en tiempo de ejecución, puede invocar el servicio Output, que hace que genere varios archivos. Al generar varios registros, la variable OutputResult
del objeto getGeneratedDoc
método devuelve null
.
Recupere los resultados de la operación
Una vez que el servicio Output realiza una operación, devuelve datos XML que especifican si la operación se realizó correctamente. El servicio Output devuelve el siguiente XML. En esta situación, el servicio Output generó 42 documentos.
<?xml version="1.0" encoding="UTF-8"?>
<printResult>
<status>0</status>
<requestId>4ad85f9e2</requestId>
<context/>
<messages>
<message>Printed all 42 records successfully.</message>
</messages>
<printSpec>
<input>
<validated>true</validated>
<dataFile recordIdField="" recordLevel="0" recordName="LoanRecord"/>
<sniffRules lookAhead="300"/>
<formDesign>Loan.xdp</formDesign>
<contentRoot>C:\Adobe</contentRoot>
<metadata-spec record="false"/>
</input>
<output>
<format>PDF</format>
<fileURI>C:\Adobe\forms\Loan.pdf</fileURI>
<optionString>cacheenabled=true&padebug=false&linearpdf=false&pdfarevisionnumber=1&pdfaconformance=A&taggedpdf=false&TransactionTimeOut=180</optionString>
<waitForResponse>true</waitForResponse>
<outputStream>multiple</outputStream>
</output>
</printSpec>
</printResult>
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Cree varios archivos de PDF mediante la API de salida (Java):
"Incluir archivos de proyecto"
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Crear un objeto de cliente de salida
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML
java.io.FileInputStream
que representa el origen de datos XML que contiene varios registros utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Establecer las opciones de tiempo de ejecución del PDF
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto setGenerateManyFiles
método. Por ejemplo, pase el valor true
para indicar al servicio Output que cree un archivo de PDF independiente para cada registro del origen de datos XML. (Si pasa false
, el servicio Output genera un único documento de PDF que contiene todos los registros).PDFOutputOptionsSpec
del objeto setFileUri
y pasando un valor de cadena que especifica la ubicación de los archivos que genera el servicio Output. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.OutputOptionsSpec
del objeto setRecordName
y pasando un valor de cadena que especifica el nombre del elemento XML en el origen de datos que separa los registros de datos. (Por ejemplo, considere la fuente de datos XML que se muestra anteriormente en esta sección. El nombre del elemento XML que separa los registros de datos es LoanRecord).Establecer opciones de tiempo de ejecución de procesamiento
RenderOptionsSpec
mediante su constructor.RenderOptionsSpec
del objeto setCacheEnabled
y pasando un Boolean
valor de true
.Generación de varios archivos de PDF
Genere varios archivos de PDF invocando el OutputClient
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.El generatePDFOutput
El método devuelve un OutputResult
que contiene los resultados de la operación.
Recupere los resultados de la operación
java.io.File
que representa un archivo XML que contendrá los resultados del generatePDFOutput
método. Asegúrese de que la extensión del nombre de archivo sea .xml.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el applyUsageRights
método).Consulte también
Inicio rápido (modo EJB): Creación de varios archivos de PDF mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Cree varios archivos de PDF mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos de formulario que contienen varios registros.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo XML que contiene varios registros.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Establecer las opciones de tiempo de ejecución del PDF.
PDFOutputOptionsSpec
mediante su constructor.OutputOptionsSpec
del objeto generateManyFiles
miembro de datos. Por ejemplo, asigne el valor true
a este miembro de datos para indicar al servicio Output que cree un archivo de PDF independiente para cada registro en el origen de datos XML. (Si asigna false
a este miembro de datos, el servicio Output genera un solo PDF que contiene todos los registros).OutputOptionsSpec
del objeto fileURI
miembro de datos. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.OutputOptionsSpec
del objeto recordName
miembro de datos.OutputOptionsSpec
del objeto copies
miembro de datos.Establecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.true
a la RenderOptionsSpec
del objeto cacheEnabled
miembro de datos.Genere varios archivos de PDF.
Cree varios archivos de PDF invocando el OutputServiceService
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con metadatos generados que describen el documento.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con datos de resultado.OutputResult
que contiene los resultados de la operación.Recupere los resultados de la operación
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa una ubicación de archivo XML que contiene datos de resultado. Asegúrese de que la extensión del nombre de archivo sea .xml.BLOB
objeto que se rellenó con datos de resultado por el OutputServiceService
del objeto generatePDFOutput
método (el octavo parámetro). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto binaryData
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Puede crear reglas de búsqueda que hagan que el servicio Output examine los datos de entrada y utilice diferentes diseños de formulario basados en el contenido de los datos para generar resultados. Por ejemplo, si el texto hipoteca se encuentra dentro de los datos de entrada, el servicio Output puede utilizar un diseño de formulario denominado Hipoteca.xdp. Igualmente, si el texto automóvil está en los datos de entrada, el servicio Output puede utilizar un diseño de formulario guardado como AutomobileLoan.xdp. Aunque el servicio Output puede generar diferentes tipos de salida, esta sección supone que el servicio Output genera un archivo de PDF. En el diagrama siguiente se muestra el servicio Output que genera un archivo de PDF mediante el procesamiento de un archivo de datos XML y el uso de uno de los muchos diseños de formulario.
Además, el servicio Output puede generar paquetes de documentos, donde se proporcionan varios registros en el conjunto de datos y cada registro coincide con un diseño de formulario y se genera un solo documento compuesto por varios diseños de formulario.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para indicar al servicio Output que utilice reglas de búsqueda al generar un documento, realice los siguientes pasos:
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 adobe-utilities.jar y jbossall-client.jar por archivos JAR específicos del servidor de aplicaciones J2EE en el que está implementado AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output.
Hacer referencia a una fuente de datos XML
Debe existir un elemento XML para cada campo de formulario que desee rellenar con datos. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. No es necesario coincidir con el orden en que se muestran los elementos XML, siempre y cuando se especifiquen todos los elementos XML.
Definir reglas de búsqueda
Para definir reglas de búsqueda, defina uno o varios patrones de texto que el servicio Output busque en los datos de entrada. Para cada patrón de texto que defina, especifique un diseño de formulario correspondiente que se utilice si se encuentra el patrón de texto. Si se encuentra un patrón de texto, el servicio Output utiliza el diseño de formulario correspondiente para generar el resultado. Un ejemplo de patrón de texto es hipoteca.
Si no se encuentran patrones de texto, se utiliza el formulario predeterminado. Asegúrese de que todos los diseños de formulario que utiliza estén en la raíz de contenido.
Establecer las opciones de tiempo de ejecución del PDF
Establezca las siguientes opciones en tiempo de ejecución de PDF para que el servicio Output cree correctamente un documento de PDF basado en varios diseños de formulario:
Establecer opciones de tiempo de ejecución de procesamiento
Puede establecer opciones de procesamiento en tiempo de ejecución al crear archivos de PDF. Aunque estas opciones no son necesarias (a diferencia de las opciones de tiempo de ejecución de PDF), puede realizar tareas como mejorar el rendimiento del servicio Output. Por ejemplo, puede almacenar en caché el diseño de formulario que utiliza el servicio Output para mejorar el rendimiento.
Generación de un documento de PDF
Después de hacer referencia a un origen de datos XML válido y establecer las opciones en tiempo de ejecución, puede invocar el servicio Output que generará un documento de PDF. Si el servicio Output encuentra un patrón de texto especificado en los datos de entrada, utiliza el diseño de formulario correspondiente. Si no se utiliza un patrón de texto, el servicio Output utilizará el diseño de formulario predeterminado.
Recupere los resultados de la operación
Una vez que el servicio Output realiza una operación, devuelve datos XML que especifican si la operación se realizó correctamente.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Cree reglas de búsqueda mediante la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Cliente de salida.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a una fuente de datos XML.
java.io.FileInputStream
que representa el origen de datos XML utilizado para rellenar el documento de PDF utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo XML.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Defina las reglas de búsqueda.
Rule
mediante su constructor.Rule
del objeto setPattern
y pasando un valor de cadena que especifica un patrón de texto.Rule
del objeto setForm
método . Pase un valor de cadena que especifique el nombre del diseño de formulario.Para cada patrón de texto que desee definir, repita los tres subpasos anteriores.
java.util.List
mediante un objeto java.util.ArrayList
constructor.Rule
objeto que ha creado, invoque el java.util.List
del objeto add
y pase el Rule
objeto.Establecer las opciones de tiempo de ejecución del PDF.
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto setFileURI
método. Pase un valor de cadena que especifique la ubicación del archivo PDF. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.PDFOutputOptionsSpec
del objeto setRules
método. Pase el java.util.List
que contiene el objeto Rule
objetos.PDFOutputOptionsSpec
del objeto setLookAhead
método. Pase un valor entero que represente los números de bytes.Establecer las opciones de procesamiento en tiempo de ejecución.
RenderOptionsSpec
mediante su constructor.RenderOptionsSpec
del objeto setCacheEnabled
y pasando true
.Genera un documento de PDF.
Generar un documento de PDF basado en varios diseños de formulario invocando el método OutputClient
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.com.adobe.idp.Document
que contiene los datos del formulario que el servicio Output busca para los patrones de texto definidos.El generatePDFOutput
El método devuelve un OutputResult
que contiene los resultados de la operación.
Recupere los resultados de la operación.
com.adobe.idp.Document
que representa el estado del objeto generatePDFOutput
invocando el método OutputResult
del objeto getStatusDoc
método.java.io.File
que contendrá los resultados de la operación. Asegúrese de que la extensión del archivo sea .xml.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del com.adobe.idp.Document
al archivo (asegúrese de utilizar la variable com.adobe.idp.Document
objeto que ha devuelto el getStatusDoc
método).Consulte también
Inicio rápido (modo EJB): Creación de reglas de búsqueda mediante la API de Java
Inicio rápido (modo SOAP): Creación de reglas de búsqueda mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Cree reglas de búsqueda mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar datos que se combinarán con el documento de PDF.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF que se va a cifrar y el modo en que se va a abrir el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Defina las reglas de búsqueda.
Rule
mediante su constructor.Rule
del objeto pattern
miembro de datos.Rule
del objeto form
miembro de datos.Para cada patrón de texto que desee definir, repita los tres subpasos anteriores.
MyArrayOf_xsd_anyType
que almacena las reglas.Rule
objeto a un elemento del MyArrayOf_xsd_anyType
matriz. Invoque el MyArrayOf_xsd_anyType
del objeto Add
método para cada Rule
objeto.Establecer las opciones de tiempo de ejecución del PDF
PDFOutputOptionsSpec
mediante su constructor.PDFOutputOptionsSpec
del objeto fileURI
miembro de datos. La opción URI de archivo es relativa al servidor de aplicaciones J2EE que aloja AEM Forms, no al equipo cliente.PDFOutputOptionsSpec
del objeto copies
miembro de datos.MyArrayOf_xsd_anyType
que almacena las reglas en el PDFOutputOptionsSpec
del objeto rules
miembro de datos.PDFOutputOptionsSpec
del objeto lookAhead
método de datos.Establecer opciones de tiempo de ejecución de procesamiento
RenderOptionsSpec
mediante su constructor.true
a la RenderOptionsSpec
del objeto cacheEnabled
miembro de datos.No se puede establecer la versión del documento de PDF utilizando RenderOptionsSpec
del objeto pdfVersion
miembro si el documento de entrada es un formulario de Acrobat. El documento del PDF de salida conserva la versión del PDF del formulario de Acrobat. Del mismo modo, no se puede establecer la opción de PDF etiquetado mediante el RenderOptionsSpec
del objeto taggedPDF
si el documento de entrada es un formulario Acrobat.
No se puede establecer la opción de PDF linealizado mediante la variable RenderOptionsSpec
del objeto linearizedPDF
miembro si el documento del PDF de entrada está certificado o firmado digitalmente. Para obtener más información, consulte Firma digital de documentos de PDF.
Generación de un documento de PDF
Cree un documento de PDF invocando el OutputServiceService
del objeto generatePDFOutput
y pasando los siguientes valores:
TransformationFormat
valor de enumeración. Para generar un documento de PDF, especifique TransformationFormat.PDF
.PDFOutputOptionsSpec
que contiene opciones de tiempo de ejecución de PDF.RenderOptionsSpec
que contiene opciones de procesamiento en tiempo de ejecución.BLOB
que contiene el origen de datos XML que contiene los datos para combinarlos con el diseño de formulario.BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con metadatos generados que describen el documento. (Este valor de parámetro solo es necesario para la invocación del servicio web).BLOB
objeto que se rellena con la variable generatePDFOutput
método. El generatePDFOutput
Este método rellena este objeto con datos de resultado. (Este valor de parámetro solo es necesario para la invocación del servicio web).OutputResult
que contiene los resultados de la operación. (Este valor de parámetro solo es necesario para la invocación del servicio web).Al generar un documento de PDF invocando el generatePDFOutput
no puede combinar datos con un formulario de PDF XFA firmado, certificado o que contenga derechos de uso. Para obtener información sobre los derechos de uso, consulte Aplicar derechos de uso a documentos de PDF.
Recupere los resultados de la operación
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa una ubicación de archivo XML que contiene datos de resultado. Asegúrese de que la extensión del archivo sea XML.BLOB
objeto que se rellenó con datos de resultado por el OutputServiceService
del objeto generatePDFOutput
método (el octavo parámetro). Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Puede utilizar el servicio Output para transformar un documento de PDF interactivo en un PDF no interactivo. Un documento interactivo del PDF permite a los usuarios introducir o modificar datos que se encuentran en los campos del documento del PDF. Se llama al proceso de transformar un documento de PDF interactivo en un documento de PDF no interactivo aplanamiento. Cuando se aplana un documento de PDF, un usuario no puede modificar los datos de los campos del documento. Una razón para acoplar un documento PDF es garantizar que no se puedan modificar los datos.
Puede acoplar los siguientes tipos de documentos de PDF:
Si se intenta acoplar un PDF que no es un documento de PDF interactivo, se producirá una excepción.
Para obtener más información sobre el servicio Output, consulte Referencia de servicios para AEM Forms.
Para acoplar un documento de PDF interactivo a un documento de PDF no interactivo, realice los siguientes pasos:
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 está utilizando 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 está implementado AEM Forms. Para obtener información sobre la ubicación de todos los archivos JAR de AEM Forms, consulte Incluir archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de salida
Para poder realizar mediante programación una operación del servicio Output, debe crear un objeto de cliente del servicio Output. Si utiliza la API de Java, cree un OutputClient
objeto. Si utiliza la API del servicio web de salida, cree un OutputServiceService
objeto.
Recuperación de un documento interactivo del PDF
Recupere un documento de PDF interactivo que desee transformar en un documento de PDF no interactivo. Si se intenta transformar un documento PDF no interactivo, se producirá una excepción.
Transformación del documento del PDF
Después de recuperar un documento de PDF interactivo, puede transformarlo en un documento de PDF no interactivo. El servicio Output devuelve un documento de PDF no interactivo.
Guarde el documento no interactivo del PDF como archivo del PDF
Puede guardar el documento no interactivo del PDF como un archivo del PDF.
Consulte también
Acoplar un documento de PDF mediante la API de Java
Acoplar un documento de PDF mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de API del servicio de salida
Acople un documento interactivo del PDF a un documento no interactivo del PDF mediante la API de salida (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-output-client.jar, en la ruta de clase del proyecto Java.
Cree un objeto Cliente de salida.
ServiceClientFactory
que contiene las propiedades de conexión.OutputClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Recupere un documento interactivo del PDF.
java.io.FileInputStream
que representa el documento de PDF interactivo que se va a transformar utilizando su constructor y pasando un valor de cadena que especifica la ubicación del archivo de PDF interactivo.com.adobe.idp.Document
usando su constructor y pasando el objeto java.io.FileInputStream
objeto.Transforme el documento del PDF.
Transforme el documento interactivo del PDF en un documento no interactivo del PDF invocando el OutputServiceService
del objeto transformPDF
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento interactivo del PDF.TransformationFormat
valor de enumeración. Para generar un documento de PDF no interactivo, especifique TransformationFormat.PDF
.PDFARevisionNumber
valor de enumeración que especifica el número de revisión. Dado que este parámetro está diseñado para un documento de PDF/A, puede especificar null
.null
.PDFAConformance
valor de enumeración que representa el nivel de conformidad PDF/A. Dado que este parámetro está diseñado para un documento de PDF/A, puede especificar null
.El transformPDF
El método devuelve un valor com.adobe.idp.Document
que contiene un documento de PDF no interactivo.
Guarde el documento no interactivo del PDF como archivo del PDF.
java.io.File
y asegúrese de que la extensión del nombre de archivo es .pdf.Document
del objeto copyToFile
para copiar el contenido del Document
al archivo (asegúrese de utilizar la variable Document
objeto que ha devuelto el transformPDF
método).Consulte también
Inicio rápido (modo EJB): Transformación de un documento de PDF mediante la API de Java
Inicio rápido (modo SOAP): Transformación de un documento de PDF mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Acoplar un documento interactivo de PDF a un documento no interactivo de PDF mediante la API de salida (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un objeto Cliente de salida.
Crear un OutputServiceClient
mediante su constructor predeterminado.
Crear un OutputServiceClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/OutputService?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable OutputServiceClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
OutputServiceClient.ClientCredentials.UserName.UserName
.OutputServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Recupere un documento interactivo del PDF.
BLOB
mediante su constructor. El BLOB
se utiliza para almacenar el documento interactivo del PDF.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación de archivo del documento PDF interactivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Transforme el documento del PDF.
Transforme el documento interactivo del PDF en un documento no interactivo del PDF invocando el OutputClient
del objeto transformPDF
y pasando los siguientes valores:
BLOB
que contiene el documento interactivo del PDF.TransformationFormat
valor de enumeración. Para generar un documento de PDF no interactivo, especifique TransformationFormat.PDF
.PDFARevisionNumber
valor de enumeración que especifica el número de revisión.PDFARevisionNumber
se utiliza un valor de enumeración. Dado que este parámetro está diseñado para un documento de PDF/A, puede especificar false
.null
.PDFAConformance
valor de enumeración que representa el nivel de conformidad PDF/A.PDFAConformance
se utiliza un valor de enumeración. Dado que este parámetro está diseñado para un documento de PDF/A, puede especificar false
.El transformPDF
El método devuelve un valor BLOB
que contiene un documento de PDF no interactivo.
Guarde el documento no interactivo del PDF como archivo del PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación de archivo del documento de PDF no interactivo.BLOB
objeto que ha devuelto el transformPDF
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
miembro de datos.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también