Conversión entre formatos de archivo y PDF

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

Creado para:

  • Desarrollador

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

Acerca del servicio Generar PDF

El servicio Generate PDF convierte los formatos de archivo nativos en PDF. También convierte PDF a otros formatos de archivo y optimiza el tamaño de los documentos PDF.

El servicio Generate PDF utiliza aplicaciones nativas para convertir los siguientes formatos de archivo a PDF. A menos que se indique lo contrario, solo son compatibles las versiones alemana, francesa, inglesa y japonesa de estas aplicaciones. Solo Windows indica compatibilidad únicamente con Windows Server® 2003 y Windows Server 2008.

  • Microsoft Office 2003 y 2007 para convertir DOC, DOCX, RTF, TXT, XLS, XLSX, PPT, PPTX, VSD, MPP, MPPX, XPS y PUB (sólo Windows)
NOTA
Se requiere Acrobat® 9.2 o posterior para convertir el formato XPS de Microsoft a PDF.
  • Autodesk AutoCAD 2005, 2006, 2007, 2008 y 2009 para convertir DWF, DWG y DXW (sólo en inglés)
  • Corel WordPerfect 12 y X4 para convertir WPD, QPW, SHW (solo en inglés)
  • OpenOffice 2.0, 2.4, 3.0.1 y 3.1 para convertir ODT, ODS, ODP, ODG, ODF, SXW, SXI, SXC, SXD, DOC, DOCX, RTF, TXT, XLS, XLSX, PPT, PPTX, VSD, MPP, MPPX y PUB
NOTA
El servicio Generar PDF no es compatible con las versiones de 64 bits de OpenOffice.
  • Adobe Photoshop® CS2 para convertir el PSD (sólo Windows)
NOTA
Photoshop CS3 y CS4 no son compatibles porque no son compatibles con Windows Server 2003 o Windows Server 2008.
  • Adobe FrameMaker® 7.2 y 8 para convertir FM (sólo Windows)
  • PageMaker de Adobe ® 7.0 para convertir PMD, PM6, P65 y PM (sólo Windows)
  • Formatos nativos admitidos por aplicaciones de terceros (requiere el desarrollo de archivos de instalación específicos para la aplicación) (solo Windows)

El servicio Generate PDF convierte los siguientes formatos de archivo basados en estándares en PDF.

  • Formatos de vídeo: SWF, FLV (sólo Windows)
  • Formatos de imagen: JPEG, JPG, JP2, J2Kí, JPC, J2C, GIF, BMP, TIFF, TIF, PNG, JPF
  • HTML (Windows, Sun™ Solaris™ y Linux®)

El servicio Generate PDF convierte PDF a los siguientes formatos de archivo (solo Windows):

  • PostScript encapsulado (EPS)
  • HTML 3.2
  • HTML 4.01 con CSS 1.0
  • DOC (formato Microsoft Word)
  • RTF
  • Texto (accesible y sin formato)
  • XML
  • PDF/A-1a que sólo utiliza el espacio de color DeviceRGB
  • PDF/A-1b que utiliza sólo el espacio de color DeviceRGB

El servicio Generate PDF requiere que realice las siguientes tareas administrativas:

  • Instalar las aplicaciones nativas necesarias en el equipo que aloja AEM Forms
  • Instale Adobe Acrobat Professional o Acrobat Pro Extended 9.2 en el equipo que aloja AEM Forms
  • Realizar tareas de instalación posteriores a la instalación

AEM Estas tareas se describen en Instalación e implementación de formularios en forma de mediante JBoss Turnkey.

Puede realizar estas tareas mediante el servicio Generate PDF:

  • Convertir de formatos de archivo nativos a PDF.
  • Convertir documentos de HTML en documentos de PDF.
  • Convierta documentos de PDF en formatos de archivo.
NOTA
Para obtener más información acerca del servicio Generate PDF, consulte Referencia de servicios para AEM Forms.

Convertir documentos de Word en documentos de PDF

En esta sección se describe cómo puede utilizar la API Generate PDF para convertir mediante programación un documento de Microsoft Word en un documento de PDF.

NOTA
Para obtener más información sobre formatos de archivo adicionales, consulte Agregar compatibilidad con formatos de archivo nativos adicionales.
NOTA
Para obtener más información acerca del servicio Generate PDF, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

Para convertir un documento de Microsoft Word en un documento de PDF, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Cree un cliente Generate PDF.
  3. Recupere el archivo para convertirlo en un documento de PDF.
  4. Convierta el archivo en un documento de PDF.
  5. Recupere los resultados.

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.

Crear un cliente Generar PDF

Para poder realizar mediante programación una operación Generate PDF, cree un cliente de servicio Generate PDF. Si está usando la API de Java, cree un objeto GeneratePdfServiceClient. Si está usando la API del servicio web, cree un objeto GeneratePDFServiceService.

Recupere el archivo para convertirlo en un documento de PDF

Recupere el documento de Microsoft Word para convertirlo en un documento de PDF.

Convertir el archivo en un documento de PDF

Después de crear el cliente del servicio Generate PDF, puede invocar el método createPDF2. Este método necesita información sobre el documento que se va a convertir, incluida la extensión de archivo.

Recuperar los resultados

Una vez convertido el archivo en un documento de PDF, puede recuperar los resultados. Por ejemplo, después de convertir un archivo de Word en un documento de PDF, puede recuperar y guardar el documento de PDF.

Consulte también

Conversión de documentos de Word en documentos de PDF mediante la API de Java

Conversión de documentos de Word en documentos 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 la API de generación de servicio de PDF

Conversión de documentos de Word en documentos de PDF mediante la API de Java

Convierta un documento de Microsoft Word en un documento de PDF mediante la API Generate PDF (Java):

  1. Incluir archivos de proyecto.

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

  2. Cree un cliente Generate PDF.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto GeneratePdfServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.

  3. Recupere el archivo para convertirlo en un documento de PDF.

    • Cree un objeto java.io.FileInputStream que represente el archivo de Word que se va a convertir mediante su constructor. Pase un valor de cadena que especifique la ubicación del archivo.
    • Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando el objeto java.io.FileInputStream.

  4. Convierta el archivo en un documento de PDF.

    Convierta el archivo en un documento de PDF invocando el método createPDF2 del objeto GeneratePdfServiceClient y pasando los siguientes valores:

    • Objeto com.adobe.idp.Document que representa el archivo que se va a convertir.
    • Objeto java.lang.String que contiene la extensión de archivo.
    • Objeto java.lang.String que contiene la configuración de tipo de archivo que se utilizará en la conversión. La configuración de tipo de archivo proporciona opciones de conversión para diferentes tipos de archivo, como .doc o .xls.
    • Objeto java.lang.String que contiene el nombre de la configuración de PDF que se va a utilizar. Por ejemplo, puede especificar Standard.
    • Objeto java.lang.String que contiene el nombre de la configuración de seguridad que se va a utilizar.
    • Un objeto com.adobe.idp.Document opcional que contiene la configuración que se aplicará durante la generación del documento de PDF.
    • Un objeto com.adobe.idp.Document opcional que contiene información de metadatos que se aplicará al documento del PDF.

    El método createPDF2 devuelve un objeto CreatePDFResult que contiene el nuevo documento de PDF y la información de registro. El archivo de registro suele contener mensajes de error o advertencia generados por la solicitud de conversión.

  5. Recupere los resultados.

    Para obtener el documento de PDF, realice las siguientes acciones:

    • Invoque el método getCreatedDocument del objeto CreatePDFResult, que devuelve un objeto com.adobe.idp.Document.
    • Invoque el método copyToFile del objeto com.adobe.idp.Document para extraer el documento de PDF del objeto creado en el paso anterior.

    Si utilizó el método createPDF2 para obtener el documento de registro (no aplicable a las conversiones de HTML), realice las siguientes acciones:

    • Invoque el método getLogDocument del objeto CreatePDFResult. Devuelve un objeto com.adobe.idp.Document.
    • Invoque el método copyToFile del objeto com.adobe.idp.Document para extraer el documento de registro.

Consulte también

Resumen de los pasos

SOAP Inicio rápido (modo de): Conversión de un documento de Microsoft Word en un documento de PDF mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Conversión de documentos de Word en documentos de PDF mediante la API de servicio web

Conversión de un documento de Microsoft Word en un documento de PDF mediante la API Generate PDF (servicio web):

  1. 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/GeneratePDFService?WSDL&lc_version=9.0.1.

    NOTA
    Reemplace localhost por la dirección IP del servidor que hospeda AEM Forms.

  2. Cree un cliente Generate PDF.

    • Cree un objeto GeneratePDFServiceClient utilizando su constructor predeterminado.

    • Cree un objeto GeneratePDFServiceClient.Endpoint.Address mediante el constructor System.ServiceModel.EndpointAddress. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/GeneratePDFService?blob=mtom). No necesita usar el atributo lc_version. Sin embargo, especifique ?blob=mtom.

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

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

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

      • AEM Asigne el nombre de usuario de los formularios de la al campo GeneratePDFServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo GeneratePDFServiceClient.ClientCredentials.UserName.Password.
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere el archivo para convertirlo en un documento de PDF.

    • Crear un objeto BLOB mediante su constructor. El objeto BLOB se usa para almacenar el archivo que desea convertir en un documento de PDF.
    • Cree un objeto System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo que se va a convertir y el modo en que se va a abrir el archivo.
    • Cree una matriz de bytes que almacene el contenido del objeto System.IO.FileStream. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad Length del objeto System.IO.FileStream.
    • Rellene la matriz de bytes con datos de secuencia invocando el método Read del objeto System.IO.FileStream y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea.
    • Rellene el objeto BLOB asignando a su propiedad MTOM el contenido de la matriz de bytes.

  4. Convierta el archivo en un documento de PDF.

    Convierta el archivo en un documento de PDF invocando el método CreatePDF2 del objeto GeneratePDFServiceService y pasando los siguientes valores:

    • Objeto BLOB que representa el archivo que se va a convertir.
    • Cadena que contiene la extensión del archivo.
    • Objeto java.lang.String que contiene la configuración de tipo de archivo que se utilizará en la conversión. La configuración de tipo de archivo proporciona opciones de conversión para diferentes tipos de archivo, como .doc o .xls.
    • Objeto de cadena que contiene la configuración del PDF que se va a utilizar. Puede especificar Standard.
    • Objeto de cadena que contiene la configuración de seguridad que se va a utilizar. Puede especificar No Security.
    • Un objeto BLOB opcional que contiene la configuración que se aplicará durante la generación del documento de PDF.
    • Un objeto BLOB opcional que contiene información de metadatos que se aplicará al documento del PDF.
    • Un parámetro de salida de tipo BLOB que se rellena con el método CreatePDF2. El método CreatePDF2 rellena este objeto con el documento convertido. (Este valor de parámetro solo es necesario para la invocación del servicio web).
    • Un parámetro de salida de tipo BLOB que se rellena con el método CreatePDF2. El método CreatePDF2 rellena este objeto con el documento de registro. (Este valor de parámetro solo es necesario para la invocación del servicio web).

  5. Recupere los resultados.

    • Recupere el documento de PDF convertido asignando el campo MTOM del objeto BLOB a una matriz de bytes. La matriz de bytes representa el documento de PDF convertido. Asegúrese de utilizar el objeto BLOB que se usa como parámetro de salida para el método createPDF2.
    • Cree un objeto System.IO.FileStream invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF convertido.
    • Cree un objeto System.IO.BinaryWriter invocando su constructor y pasando el objeto System.IO.FileStream.
    • Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método Write del objeto System.IO.BinaryWriter y pasando la matriz de bytes.

Consulte también

Resumen de los pasos

Invocar AEM Forms mediante MTOM

Invocar AEM Forms mediante SwaRef

Conversión de Documentos de HTML en Documentos de PDF

En esta sección se describe cómo puede utilizar la API Generate PDF para convertir mediante programación documentos de HTML en documentos de PDF.

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

Resumen de los pasos

Para convertir un documento de HTML en un documento de PDF, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Cree un cliente Generate PDF.
  3. Recupere el contenido del HTML para convertirlo en un documento del PDF.
  4. Convierta el contenido del HTML en un documento del PDF.
  5. Recupere los resultados.

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.

Crear un cliente Generar PDF

Para poder realizar mediante programación una operación Generate PDF, debe crear un cliente de servicio Generate PDF. Si está usando la API de Java, cree un objeto GeneratePdfServiceClient. Si está usando la API del servicio web, cree un GeneratePDFServiceService.

Recuperar el contenido del HTML para convertirlo en un documento del PDF

Haga referencia al contenido del HTML que desee convertir en un documento del PDF. Puede hacer referencia a contenido de HTML, como un archivo de HTML o a contenido de HTML al que se puede acceder mediante una dirección URL.

Convertir el contenido del HTML en un documento del PDF

Después de crear el cliente de servicios, puede invocar la operación de creación de PDF adecuada. Esta operación necesita información sobre el documento que se va a convertir, incluida la ruta al documento de destino.

Recuperar los resultados

Una vez convertido el contenido del HTML en un documento del PDF, puede recuperar los resultados y guardar el documento del PDF.

Consulte también

Conversión del contenido del HTML en un documento del PDF mediante la API de Java

Conversión del contenido de un HTML en un documento de un PDF mediante la API de servicio web

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Inicios rápidos de la API de generación de servicio de PDF

Conversión del contenido del HTML en un documento del PDF mediante la API de Java

Conversión de un documento de HTML en un documento de PDF mediante la API de generación de PDF (Java):

  1. Incluir archivos de proyecto.

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

  2. Cree un cliente Generate PDF.

    Cree un objeto GeneratePdfServiceClient utilizando su constructor y pasando un objeto ServiceClientFactory que contenga propiedades de conexión.

  3. Recupere el contenido del HTML para convertirlo en un documento del PDF.

    Recupere contenido de HTML creando una variable de cadena y asignando una dirección URL que apunte al contenido de HTML.

  4. Convierta el contenido del HTML en un documento del PDF.

    Invoque el método htmlToPDF2 del objeto GeneratePdfServiceClient y pase los siguientes valores:

    • Objeto java.lang.String que contiene la dirección URL del archivo de HTML que se va a convertir.
    • Objeto java.lang.String que contiene la configuración de tipo de archivo que se utilizará en la conversión. La configuración de tipo de archivo puede incluir niveles de araña.
    • Objeto java.lang.String que contiene el nombre de la configuración de seguridad que se va a utilizar.
    • Un objeto com.adobe.idp.Document opcional que contiene la configuración que se aplicará durante la generación del documento de PDF. Si no se proporciona esta información, la configuración se elige automáticamente en función de los tres parámetros anteriores.
    • Un objeto com.adobe.idp.Document opcional que contiene información de metadatos que se aplicará al documento del PDF.

  5. Recupere los resultados.

    El método htmlToPDF2 devuelve un objeto HtmlToPdfResult que contiene el nuevo documento de PDF generado. Para obtener el documento de PDF recién creado, realice las siguientes acciones:

    • Invoque el método getCreatedDocument del objeto HtmlToPdfResult. Devuelve un objeto com.adobe.idp.Document.
    • Invoque el método copyToFile del objeto com.adobe.idp.Document para extraer el documento de PDF del objeto creado en el paso anterior.

Consulte también

Conversión de Documentos de HTML en Documentos de PDF

SOAP Inicio rápido (modo de): Conversión del contenido del HTML a un documento del PDF mediante la API de Java

SOAP Inicio rápido (modo de): Conversión del contenido del HTML a un documento del PDF mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Conversión del contenido de un HTML en un documento de un PDF mediante la API de servicio web

Conversión del contenido de un HTML en un documento de un PDF mediante la API de generación de PDF (servicio web):

  1. 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/GeneratePDFService?WSDL&lc_version=9.0.1.

    NOTA
    Reemplace localhost por la dirección IP del servidor que hospeda AEM Forms.

  2. Cree un cliente Generate PDF.

    • Cree un objeto GeneratePDFServiceClient utilizando su constructor predeterminado.

    • Cree un objeto GeneratePDFServiceClient.Endpoint.Address mediante el constructor System.ServiceModel.EndpointAddress. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/GeneratePDFService?blob=mtom). No necesita usar el atributo lc_version. Sin embargo, especifique ?blob=mtom.

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

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

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

      • AEM Asigne el nombre de usuario de los formularios de la al campo GeneratePDFServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo GeneratePDFServiceClient.ClientCredentials.UserName.Password.
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere el contenido del HTML para convertirlo en un documento del PDF.

    Recupere contenido de HTML creando una variable de cadena y asignando una dirección URL que apunte al contenido de HTML.

  4. Convierta el contenido del HTML en un documento del PDF.

    Convierta el contenido del HTML en un documento de PDF invocando el método HtmlToPDF2 del objeto GeneratePDFServiceService y pase los siguientes valores:

    • Cadena que contiene el contenido del HTML que se va a convertir.
    • Objeto java.lang.String que contiene la configuración de tipo de archivo que se utilizará en la conversión.
    • Objeto de cadena que contiene la configuración de seguridad que se va a utilizar.
    • Un objeto BLOB opcional que contiene la configuración que se aplicará durante la generación del documento de PDF.
    • Un objeto BLOB opcional que contiene información de metadatos que se aplicará al documento del PDF.
    • Un parámetro de salida de tipo BLOB que se rellena con el método CreatePDF2. El método CreatePDF2 rellena este objeto con el documento convertido. (Este valor de parámetro solo es necesario para la invocación del servicio web).

  5. Recupere los resultados.

    • Recupere el documento de PDF convertido asignando el campo MTOM del objeto BLOB a una matriz de bytes. La matriz de bytes representa el documento de PDF convertido. Asegúrese de utilizar el objeto BLOB que se usa como parámetro de salida para el método HtmlToPDF2.
    • Cree un objeto System.IO.FileStream invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF convertido.
    • Cree un objeto System.IO.BinaryWriter invocando su constructor y pasando el objeto System.IO.FileStream.
    • Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método Write del objeto System.IO.BinaryWriter y pasando la matriz de bytes.

Consulte también

Conversión de Documentos de HTML en Documentos de PDF

Invocar AEM Forms mediante MTOM

Invocar AEM Forms mediante SwaRef

Conversión de documentos de PDF a formatos que no sean imágenes

En esta sección se describe cómo puede utilizar la API Generate PDF Java y la API de servicio web para convertir mediante programación un documento de PDF en un archivo RTF, que es un ejemplo de formato que no es de imagen. Otros formatos que no son de imagen son HTML, texto, DOC y EPS. Al convertir un documento de PDF a RTF, asegúrese de que el documento de PDF no contenga elementos de formulario, como un botón de envío. Los elementos de formulario no se convierten.

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

Resumen de los pasos

Para convertir un documento de PDF en cualquiera de los tipos compatibles, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente Generate PDF.
  3. Recupere el documento del PDF que desea convertir.
  4. Convierta el documento del PDF.
  5. Guarde el archivo convertido.

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.

Crear un cliente Generar PDF

Para poder realizar mediante programación una operación Generate PDF, debe crear un cliente de servicio Generate PDF. Si está usando la API de Java, cree un objeto GeneratePdfServiceClient. Si está usando la API del servicio web, cree un objeto GeneratePDFServiceService.

Recuperar el documento de PDF para convertir

Recupere el documento del PDF para convertirlo a un formato que no sea de imagen.

Convertir el documento del PDF

Después de crear el cliente de servicios, puede invocar la operación de exportación del PDF. Esta operación necesita información sobre el documento que se va a convertir, incluida la ruta al documento de destino.

Guardar el archivo convertido

Guarde el archivo convertido. Por ejemplo, si convierte un documento de PDF en un archivo RTF, guarde el documento convertido en un archivo RTF.

Consulte también

Conversión de un documento de PDF en un archivo RTF mediante la API de Java

Conversión de un documento de PDF en un archivo RTF mediante la API de servicio web

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Inicios rápidos de la API de generación de servicio de PDF

Conversión de un documento de PDF en un archivo RTF mediante la API de Java

Conversión de un documento de PDF en un archivo RTF mediante la API Generate PDF (Java):

  1. Incluir archivos de proyecto.

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

  2. Cree un cliente Generate PDF.

    Cree un objeto GeneratePdfServiceClient utilizando su constructor y pasando un objeto ServiceClientFactory que contenga propiedades de conexión.

  3. Recupere el documento del PDF que desea convertir.

    • Cree un objeto java.io.FileInputStream que represente el documento de PDF que se va a convertir mediante su constructor. Pase un valor de cadena que especifique la ubicación del documento del PDF.
    • Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando el objeto java.io.FileInputStream.

  4. Convierta el documento del PDF.

    Invoque el método exportPDF2 del objeto GeneratePdfServiceClient y pase los siguientes valores:

    • Objeto com.adobe.idp.Document que representa el archivo PDF que se va a convertir.
    • Objeto java.lang.String que contiene el nombre del archivo que se va a convertir.
    • Objeto java.lang.String que contiene el nombre de la configuración de Adobe PDF.
    • Un objeto ConvertPDFFormatType que especifica el tipo de archivo de destino para la conversión.
    • Un objeto com.adobe.idp.Document opcional que contiene la configuración que se aplicará durante la generación del documento de PDF.

    El método exportPDF2 devuelve un objeto ExportPDFResult que contiene el archivo convertido.

  5. Convierta el documento del PDF.

    Para obtener el archivo recién creado, realice las siguientes acciones:

    • Invoque el método getConvertedDocument del objeto ExportPDFResult. Devuelve un objeto com.adobe.idp.Document.
    • Invoque el método copyToFile del objeto com.adobe.idp.Document para extraer el nuevo documento.

Consulte también

Resumen de los pasos

SOAP Inicio rápido (modo de): Conversión del contenido del HTML a un documento del PDF mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Conversión de un documento de PDF en un archivo RTF mediante la API de servicio web

Conversión de un documento de PDF en un archivo RTF mediante la API Generate PDF (servicio web):

  1. 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/GeneratePDFService?WSDL&lc_version=9.0.1.

    NOTA
    Reemplace localhost por la dirección IP del servidor que hospeda AEM Forms.

  2. Cree un cliente Generar PDF.

    • Cree un objeto GeneratePDFServiceClient utilizando su constructor predeterminado.

    • Cree un objeto GeneratePDFServiceClient.Endpoint.Address mediante el constructor System.ServiceModel.EndpointAddress. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/GeneratePDFService?blob=mtom). No necesita usar el atributo lc_version. Sin embargo, especifique ?blob=mtom.

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

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

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

      • AEM Asigne el nombre de usuario de los formularios de la al campo GeneratePDFServiceClient.ClientCredentials.UserName.UserName.
      • Asigne el valor de contraseña correspondiente al campo GeneratePDFServiceClient.ClientCredentials.UserName.Password.
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recupere el documento del PDF que desea convertir.

    • Crear un objeto BLOB mediante su constructor. El objeto BLOB se usa para almacenar un documento de PDF convertido.
    • Cree un objeto System.IO.FileStream invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF y el modo en que se abrirá el archivo.
    • Cree una matriz de bytes que almacene el contenido del objeto System.IO.FileStream. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad Length del objeto System.IO.FileStream.
    • Rellene la matriz de bytes con datos de secuencia invocando el método Read del objeto System.IO.FileStream y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea.
    • Rellene el objeto BLOB asignando a su propiedad MTOM el contenido de la matriz de bytes.

  4. Convierta el documento del PDF.

    Invoque el método ExportPDF2 del objeto GeneratePDFServiceServiceWse y pase los siguientes valores:

    • Objeto BLOB que representa el archivo PDF que se va a convertir.
    • Cadena que contiene el nombre de ruta del archivo que se va a convertir.
    • Un objeto java.lang.String que especifica la ubicación del archivo.
    • Un objeto de cadena que especifica el tipo de archivo de destino para la conversión. Especifique RTF.
    • Un objeto BLOB opcional que contiene la configuración que se aplicará durante la generación del documento de PDF.
    • Un parámetro de salida de tipo BLOB que se rellena con el método ExportPDF2. El método ExportPDF2 rellena este objeto con el documento convertido. (Este valor de parámetro solo es necesario para la invocación del servicio web).

  5. Guarde el archivo convertido.

    • Recupere el documento RTF convertido asignando el campo MTOM del objeto BLOB a una matriz de bytes. La matriz de bytes representa el documento RTF convertido. Asegúrese de utilizar el objeto BLOB que se usa como parámetro de salida para el método ExportPDF2.
    • Cree un objeto System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo RTF.
    • Cree un objeto System.IO.BinaryWriter invocando su constructor y pasando el objeto System.IO.FileStream.
    • Escriba el contenido de la matriz de bytes en un archivo RTF invocando el método Write del objeto System.IO.BinaryWriter y pasando la matriz de bytes.

Consulte también

Resumen de los pasos

Invocar AEM Forms mediante MTOM

Invocar AEM Forms mediante SwaRef

Añadir compatibilidad con formatos de archivo nativos adicionales

Esta sección explica cómo agregar compatibilidad con formatos de archivo nativos adicionales. Proporciona una descripción general de las interacciones entre el servicio Generate PDF y las aplicaciones nativas que este servicio utiliza para convertir formatos de archivo nativos en PDF.

Esta sección también explica lo siguiente:

  • Cómo modificar la respuesta que el servicio Generate PDF proporciona a las aplicaciones nativas que este producto ya utiliza para convertir formatos de archivo nativos en PDF
  • Las interacciones entre el servicio Generate PDF, el componente Application Monitor (AppMon) del servicio Generate PDF y las aplicaciones nativas, como Microsoft Word
  • Las funciones que desempeñan las gramáticas XML en esas interacciones

Interacciones de componentes

El servicio Generate PDF convierte los formatos de archivo nativos invocando la aplicación asociada al formato de archivo e interactuando con la aplicación para imprimir el documento mediante la impresora predeterminada. La impresora predeterminada debe estar configurada como impresora de Adobe PDF.

Esta ilustración muestra los componentes y controladores implicados en la compatibilidad con aplicaciones nativas. También menciona las gramáticas XML que influyen en las interacciones.

Interacciones de componentes para la conversión de archivos nativos

Este documento usa el término aplicación nativa para indicar la aplicación utilizada para producir un formato de archivo nativo, como Microsoft Word.

AppMon es un componente de empresa que interactúa con una aplicación nativa de la misma manera que un usuario navegaría por los cuadros de diálogo presentados por esa aplicación. Las gramáticas XML utilizadas por AppMon para indicar a una aplicación, como Microsoft Word, que abra e imprima un archivo implican estas tareas secuenciales:

  1. Abra el archivo seleccionando Archivo > Abrir
  2. Comprobar que aparece el cuadro de diálogo Abrir; si no es así, controlar el error
  3. Proporcione el nombre del archivo en el campo Nombre de archivo y haga clic en el botón Abrir
  4. Comprobar que el archivo se abre realmente
  5. Abrir el cuadro de diálogo Imprimir seleccionando Archivo > Imprimir
  6. Comprobación de que aparece el cuadro de diálogo Imprimir

AppMon utiliza API estándar de Win32 para interactuar con aplicaciones de terceros y transferir eventos de interfaz de usuario, como pulsaciones de teclas y clics de mouse (ratón), lo que resulta útil para controlar estas aplicaciones y producir archivos PDF a partir de ellas.

Debido a una limitación con estas API de Win32, AppMon no puede distribuir estos eventos de interfaz de usuario a algunos tipos específicos de ventanas, como barras de menú flotantes (que se encuentran en algunas aplicaciones como TextPad) y cierto tipo de cuadros de diálogo cuyo contenido no se puede recuperar mediante las API de Win32.

Es fácil identificar visualmente una barra de menús flotante; sin embargo, es posible que no sea posible identificar los tipos especiales de diálogos solo mediante la inspección visual. Necesitaría una aplicación de terceros como Microsoft Spy++ (parte del entorno de desarrollo de Microsoft Visual C++) o su WinID equivalente (que se puede descargar gratuitamente desde https://www.dennisbabkin.com/php/download.php?what=WinID) para examinar un cuadro de diálogo y determinar si AppMon podría interactuar con él mediante las API estándar de Win32.

Si WinID puede extraer el contenido del cuadro de diálogo, como el texto, las ventanas secundarias, el ID de clase de ventana, etc., AppMon también podrá hacer lo mismo.

En esta tabla se muestra el tipo de información utilizada para imprimir formatos de archivo nativos.

Tipo de información
Descripción
Modificar/crear entradas relacionadas con archivos nativos
Configuración administrativa

Incluye la configuración del PDF, la configuración de seguridad y la configuración del tipo de archivo.

La configuración de tipo de archivo asocia las extensiones de nombre de archivo con las aplicaciones nativas correspondientes. La configuración de tipo de archivo también especifica la configuración de la aplicación nativa utilizada para imprimir archivos nativos.

Para cambiar la configuración de una aplicación nativa ya admitida, el administrador del sistema establece la Configuración de tipo de archivo en la consola de administración.

Para añadir compatibilidad con un nuevo formato de archivo nativo, debe editar manualmente el archivo. (Consulte Agregar o modificar la compatibilidad con un formato de archivo nativo.)

Script

Especifica las interacciones entre el servicio Generate PDF y una aplicación nativa. Estas interacciones normalmente dirigen la aplicación para imprimir un archivo al controlador de Adobe PDF.

La secuencia de comandos contiene instrucciones que dirigen la aplicación nativa para abrir cuadros de diálogo específicos y que proporcionan respuestas específicas a los campos y botones de esos cuadros de diálogo.

El servicio Generate PDF incluye archivos de script para todas las aplicaciones nativas admitidas. Puede modificar estos archivos mediante una aplicación de edición XML.

Para agregar compatibilidad con una nueva aplicación nativa, debe crear un archivo de script. (Consulte Creación o modificación de un archivo XML de diálogo adicional para una aplicación nativa.)

Instrucciones genéricas del cuadro de diálogo

Especifica cómo responder a los cuadros de diálogo comunes a varias aplicaciones. Estos cuadros de diálogo los generan los sistemas operativos, las aplicaciones de ayuda (como PDFMaker) y los controladores.

El archivo que contiene esta información es appmon.global.en_US.xml.

No modifique este archivo.
Instrucciones del cuadro de diálogo específico de la aplicación

Especifica cómo responder a los cuadros de diálogo específicos de la aplicación.

El archivo que contiene esta información es appmon.`[nombre de aplicación]`.dialog.`[locale]`.xml (por ejemplo, appmon.word.en_US.xml).

No modifique este archivo.

Para agregar instrucciones de cuadro de diálogo para una nueva aplicación nativa, vea Crear o modificar un archivo XML de cuadro de diálogo adicional para una aplicación nativa.

Instrucciones adicionales del cuadro de diálogo específico de la aplicación

Especifica las invalidaciones y adiciones a las instrucciones del cuadro de diálogo específico de la aplicación. La sección presenta un ejemplo de dicha información.

El archivo que contiene esta información es appmon.`[nombre de aplicación]`.add.`[locale]`.xml. Un ejemplo es appmon.add.en_US.xml.

Los archivos de este tipo se pueden crear y modificar mediante una aplicación de edición XML. (Consulte Creación o modificación de un archivo XML de diálogo adicional para una aplicación nativa.)

Importante: cree instrucciones adicionales de cuadro de diálogo específicas de la aplicación para cada aplicación nativa que admitirá el servidor.

Acerca de los archivos XML de script y diálogo

Los archivos XML de secuencia de comandos dirigen el servicio Generate PDF para que navegue por los cuadros de diálogo de la aplicación del mismo modo que lo haría un usuario por los cuadros de diálogo de la aplicación. Los archivos XML de secuencia de comandos también dirigen el servicio Generate PDF para que responda a los cuadros de diálogo mediante acciones como presionar botones, seleccionar o anular la selección de casillas de verificación o seleccionar elementos de menú.

Por el contrario, los archivos XML de diálogo sólo responden a cuadros de diálogo con los mismos tipos de acciones utilizadas en los archivos XML de secuencias de comandos.

Terminología del cuadro de diálogo y del elemento de ventana

En esta sección y en la siguiente se utiliza una terminología diferente para los cuadros de diálogo y los componentes que contienen, según la perspectiva que se describa. Los componentes de cuadro de diálogo son elementos como botones, campos y cuadros combinados.

Cuando esta sección y la siguiente describen los cuadros de diálogo y sus componentes desde la perspectiva de un usuario, se utilizan términos como cuadro de diálogo, botón, campo y cuadro combinado.

Cuando esta sección y la siguiente describen los cuadros de diálogo y sus componentes desde la perspectiva de su representación interna, se utiliza el término elemento window. La representación interna de los elementos de ventana es una jerarquía, donde cada instancia del elemento de ventana se identifica con etiquetas. La instancia del elemento window también describe sus características físicas y su comportamiento.

Desde la perspectiva de un usuario, los cuadros de diálogo y sus componentes muestran comportamientos diferentes, donde algunos elementos del cuadro de diálogo se ocultan hasta que se activan. Desde la perspectiva de la representación interna, no existe tal cuestión de comportamiento. Por ejemplo, la representación interna de un cuadro de diálogo tiene un aspecto similar al de los componentes que contiene, con la excepción de que los componentes están anidados en el cuadro de diálogo.

En esta sección se describen los elementos XML que proporcionan instrucciones a AppMon. Estos elementos tienen nombres como dialog y window. Este documento utiliza una fuente monoespaciada para distinguir los elementos XML. El elemento dialog identifica un cuadro de diálogo que un archivo de script XML puede hacer que se muestre, ya sea intencionada o involuntariamente. El elemento window identifica un elemento de ventana (cuadro de diálogo o los componentes de un cuadro de diálogo).

Jerarquía

Este diagrama muestra la jerarquía del script y el XML de diálogo. Un archivo XML de secuencia de comandos se ajusta al esquema script.xsd, que incluye (en el sentido XML) el esquema window.xsd. Del mismo modo, un archivo XML de diálogo se ajusta al esquema dialog.xsd, que también incluye el esquema window.xsd.

as_as_xml_hierarchy

Jerarquía de script y XML de diálogo

Archivos XML de script

Un archivo XML de script especifica una serie de pasos que indican a la aplicación nativa que se desplace hasta determinados elementos de la ventana y que, a continuación, proporcione respuestas a dichos elementos. La mayoría de las respuestas son texto o pulsaciones de teclas que corresponden a la entrada que un usuario proporcionaría a un campo, cuadro combinado o botón del cuadro de diálogo correspondiente.

La intención de la compatibilidad del servicio Generate PDF con los archivos XML de script es dirigir una aplicación nativa para imprimir un archivo nativo. Sin embargo, los archivos XML de secuencias de comandos se pueden utilizar para realizar cualquier tarea que pueda realizar un usuario al interactuar con los cuadros de diálogo de la aplicación nativa.

Los pasos de un archivo XML de script se ejecutan en orden, sin ninguna oportunidad de bifurcación. La única prueba condicional admitida es el tiempo de espera/reintento, que hace que una secuencia de comandos se termine si un paso no se completa correctamente en un período de tiempo específico y después de un número específico de reintentos.

Además de los pasos que son secuenciales, las instrucciones dentro de un paso también se ejecutan en orden. Asegúrese de que los pasos e instrucciones reflejen el orden en que un usuario realizaría esos mismos pasos.

Cada paso de un archivo XML de secuencia de comandos identifica el elemento window que se espera que aparezca si las instrucciones del paso se realizan correctamente. Si aparece un cuadro de diálogo inesperado al ejecutar un paso de script, el servicio Generate PDF busca los archivos XML de diálogo como se describe en la siguiente sección.

Archivos XML de diálogo

La ejecución de aplicaciones nativas muestra diferentes cuadros de diálogo, que aparecen independientemente de si las aplicaciones nativas están en modo visible o invisible. Los cuadros de diálogo pueden ser generados por el sistema operativo o por la propia aplicación. Cuando las aplicaciones nativas se ejecutan bajo el control del servicio Generate PDF, los cuadros de diálogo system y native application se muestran en una ventana invisible.

Un archivo XML de diálogo especifica cómo responde el servicio Generate PDF a los cuadros de diálogo del sistema o de la aplicación nativa. Los archivos XML de diálogo permiten que el servicio Generate PDF responda a los cuadros de diálogo no solicitados de forma que facilite el proceso de .

Cuando el sistema o la aplicación nativa muestra un cuadro de diálogo que no está controlado por el archivo XML de secuencia de comandos que se está ejecutando, el servicio Generate PDF busca los archivos XML de diálogo en este orden y se detiene cuando encuentra una coincidencia:

  • ¡Applón![appname].adicional.[locale].xml
  • ¡Applón![appname].[locale].xml (no modifique este archivo).
  • appmon.global.[locale].xml (no modifique este archivo).

Si el servicio Generar PDF encuentra una coincidencia para el cuadro de diálogo, lo descarta enviándole la pulsación de tecla u otra acción especificada para el cuadro de diálogo. Si las instrucciones del cuadro de diálogo especifican un mensaje de anulación, el servicio Generate PDF finaliza el trabajo que se está ejecutando y genera un mensaje de error. Este mensaje de anulación se especificaría en el elemento abortMessage de la gramática XML del script.

Si el servicio Generar PDF encuentra un cuadro de diálogo que no se describe en ninguno de los archivos enumerados anteriormente, el servicio Generar PDF incorpora el título del cuadro de diálogo en la entrada del archivo de registro. El trabajo que se está ejecutando finaliza el tiempo de espera. A continuación, puede utilizar la información del archivo de registro para crear nuevas instrucciones en el archivo XML de diálogo adicional para la aplicación nativa.

Agregar o modificar la compatibilidad con un formato de archivo nativo

En esta sección se describen las tareas que debe realizar para admitir otros formatos de archivo nativos o para modificar la compatibilidad con un formato de archivo nativo ya admitido.

Antes de agregar o modificar la compatibilidad, debe completar las tareas siguientes.

Selección de una herramienta para identificar los elementos de la ventana

Los archivos XML de diálogo y script requieren que identifique el elemento window (cuadro de diálogo, campo u otro componente de diálogo) al que responde el elemento dialog o script. Por ejemplo, después de que un script invoque un menú para una aplicación nativa, el script debe identificar el elemento window de ese menú al que se deben aplicar las pulsaciones de teclas o una acción.

Puede identificar fácilmente un cuadro de diálogo por el título que muestra en su barra de título. Sin embargo, debe utilizar una herramienta como Microsoft Spy++ para identificar los elementos de ventana de nivel inferior. Los elementos de ventana de nivel inferior se pueden identificar mediante una variedad de atributos, que no son obvios. Además, cada aplicación nativa puede identificar su elemento de ventana de forma diferente. Como resultado, hay varias formas de identificar un elemento window. Este es el orden sugerido para considerar la identificación de elementos de ventana:

  1. Pie de ilustración si es único
  2. ID de control, que puede ser único o no para un cuadro de diálogo determinado
  3. Nombre de clase, que puede ser único o no

Cualquiera de estos tres atributos, o una combinación de ellos, puede utilizarse para identificar una ventana.

Si los atributos no identifican un pie de ilustración, puede identificar un elemento de ventana mediante su índice con respecto a su elemento principal. Un índice especifica la posición del elemento window en relación con los elementos window del mismo nivel. Con frecuencia, los índices son la única manera de identificar los cuadros combinados.

Tenga en cuenta los siguientes problemas:

  • Microsoft Spy++ muestra los subtítulos utilizando un signo & para identificar la tecla de acceso directo del subtítulo. Por ejemplo, Spy++ muestra el título de un cuadro de diálogo Imprimir como Pri&nt, lo que indica que la tecla de acceso directo es n. Los títulos de los títulos de los archivos XML de script y diálogo deben omitir el símbolo et.
  • Algunos subtítulos incluyen saltos de línea. el servicio Generar PDF no puede identificar saltos de línea. Si un pie de ilustración incluye un salto de línea, incluya suficiente para diferenciarlo de los demás elementos de menú y, a continuación, utilice expresiones regulares para el fragmento omitido. Un ejemplo es ( ^Long caption title$). (Consulte Uso de expresiones regulares en los atributos de subtítulos.)
  • Utilice entidades de caracteres (también denominadas secuencias de escape) para caracteres XML reservados. Por ejemplo, use & para el símbolo &, < y > para los símbolos menor y mayor que, &apos; para los apóstrofos y &quot; para las comillas.

Si planea trabajar en archivos XML de cuadros de diálogo o secuencias de comandos, debe instalar la aplicación Microsoft Spy++.

Desempaquetado de los archivos de diálogo y script

Los archivos de cuadro de diálogo y de script residen en el archivo appmondata.jar. Antes de poder modificar cualquiera de estos archivos o agregar nuevos archivos de script o de diálogo, debe desempaquetar este archivo JAR. Por ejemplo, supongamos que desea añadir compatibilidad con la aplicación EditPlus. Puede crear dos archivos XML, llamados appmon.editplus.script.en_US.xml y appmon.editplus.script.additplus.en_US.xml. Estos scripts XML deben agregarse al archivo adobe-appmondata.jar en dos ubicaciones, como se especifica a continuación:

  • adobe-livecycle-native-jboss-x86_win32.ear > adobe-Native2PDFSvc.war\WEB-INF\lib > adobe-native.jar > Native2PDFSvc-native.jar\bin > adobe-appmondata.jar\com\adobe\appmon. El archivo adobe-livecycle-native-jboss-x86_win32.ear se encuentra en la carpeta de exportación en [AEM forms install directory]\configurationManager. (si AEM Forms está implementado en otro servidor de aplicaciones J2EE, sustituya el archivo adobe-livecycle-native-jboss-x86_win32.ear por el archivo EAR que corresponda a su servidor de aplicaciones J2EE).
  • adobe-generatepdf-dsc.jar > adobe-appmondata.jar\com\adobe\appmon (el archivo adobe-appmondata.jar se encuentra dentro del archivo adobe-generatepdf-dsc.jar). El archivo adobe-generatepdf-dsc.jar se encuentra en la carpeta [AEM forms install directory]\deploy.

Después de agregar estos archivos XML al archivo adobe-appmondata.jar, debe volver a implementar el componente GeneratePDF. Para agregar archivos XML de cuadros de diálogo y secuencias de comandos al archivo adobe-appmondata.jar, realice estas tareas:

  1. Con una herramienta como WinZip o WinRAR, abra el archivo adobe-livecycle-native-jboss-x86_win32.earfile > adobe-Native2PDFSvc.war\WEB-INF\lib > adobe-native.jar > Native2PDFSvc-native.jar > adobe-appmondata.jar.
  2. Agregue los archivos XML de cuadro de diálogo y secuencia de comandos al archivo appmondata.jar o modifique los archivos XML existentes en este archivo. (Vea Crear o modificar un archivo XML de script para una aplicación nativay Crear o modificar un archivo XML de cuadro de diálogo adicional para una aplicación nativa.)
  3. Con una herramienta como WinZip o WinRAR, abra adobe-generatepdf-dsc.jar > adobe-appmondata.jar.
  4. Agregue los archivos XML de cuadro de diálogo y secuencia de comandos al archivo appmondata.jar o modifique los archivos XML existentes en este archivo. (Vea Crear o modificar un archivo XML de script para una aplicación nativay Crear o modificar un archivo XML de cuadro de diálogo adicional para una aplicación nativa.) Después de agregar los archivos XML al archivo adobe-appmondata.jar, coloque el nuevo archivo adobe-appmondata.jar en el archivo adobe-generatepdf-dsc.jar.
  5. Si agregó compatibilidad con un formato de archivo nativo adicional, cree una variable de entorno del sistema que proporcione la ruta de acceso de la aplicación (vea Creación de una variable de entorno para localizar la aplicación nativa.)

Para volver a implementar el componente GeneratePDF

  1. Inicie sesión en Workbench.
  2. Seleccione Ventana > Mostrar vistas > Componentes. Esta acción añade la vista Componentes a Workbench.
  3. Haga clic con el botón secundario en el componente GeneratePDF y, a continuación, seleccione Detener componente.
  4. Cuando el componente se haya detenido, haga clic con el botón derecho y seleccione Desinstalar componente para eliminarlo.
  5. Haga clic con el botón derecho en el icono Componentes y seleccione Instalar componente.
  6. Busque y seleccione el archivo adobe-generatepdf-dsc.jar modificado y, a continuación, haga clic en Abrir. Observe que aparece un cuadrado rojo junto al componente GeneratePDF.
  7. Expanda el componente GeneratePDF, seleccione Descriptores de servicio, haga clic con el botón derecho en GeneratePDFService y seleccione Activar servicio.
  8. En el cuadro de diálogo de configuración que aparece, introduzca los valores de configuración aplicables. Si deja estos valores en blanco, se utilizan los valores de configuración predeterminados.
  9. Haga clic con el botón derecho en GeneratePDF y seleccione Start Component.
  10. Expanda Servicios activos. Si se está ejecutando, aparecerá una flecha verde junto al nombre del servicio. De lo contrario, el servicio está en estado detenido.
  11. Si el servicio está en estado detenido, haga clic con el botón derecho en el nombre del servicio y seleccione Iniciar servicio.

Crear o modificar un archivo XML de secuencia de comandos para una aplicación nativa

Si desea dirigir los archivos a una nueva aplicación nativa, debe crear un archivo XML de secuencia de comandos para esa aplicación. Si desea modificar la forma en que el servicio Generate PDF interactúa con una aplicación nativa ya admitida, deberá modificar el script de dicha aplicación.

La secuencia de comandos contiene instrucciones que permiten navegar por los elementos window de la aplicación nativa y proporcionar respuestas específicas a dichos elementos. El archivo que contiene esta información es appmon.[appname]".script.[locale].xml. Un ejemplo es appmon.notepad.script.en_US.xml.

Identificación de los pasos que debe ejecutar el script

Con la aplicación nativa, determine los elementos de ventana que debe desplazarse y cada respuesta que debe realizar para imprimir el documento. Fíjese en los cuadros de diálogo que resultan de cualquier respuesta. Los pasos son similares a estos pasos:

  1. Seleccione Archivo > Abrir.
  2. Especifique la ruta y haga clic en Abrir.
  3. Seleccione Archivo > Imprimir en la barra de menús.
  4. Especifique las propiedades necesarias para la impresora.
  5. Seleccione Imprimir y espere a que aparezca el cuadro de diálogo Guardar como. El cuadro de diálogo Guardar como es necesario para que el servicio Generate PDF especifique el destino del archivo de PDF.