Conversión entre formatos de archivo y PDF converting-between-file-formatsand-pdf

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.

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

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

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

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 documentos de Word en documentos de PDF converting-word-documents-to-pdf-documents

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.

Resumen de los pasos summary-of-steps

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

Incluir archivos de proyecto

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

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 convert-word-documents-to-pdf-documents-using-the-java-api

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

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 convert-word-documents-to-pdf-documents-using-the-web-service-api

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

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 converting-html-documents-to-pdf-documents

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.

Resumen de los pasos summary_of_steps-1

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

Incluir archivos de proyecto

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

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 convert-html-content-to-a-pdf-document-using-the-java-api

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

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 convert-html-content-to-a-pdf-document-using-the-web-service-api

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

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 converting-pdf-documents-to-non-image-formats

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.

Resumen de los pasos summary_of_steps-2

Para convertir un documento de PDF en cualquiera de los tipos compatibles, 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.

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 convert-a-pdf-document-to-a-rtf-file-using-the-java-api

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

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 convert-a-pdf-document-to-a-rtf-file-using-the-web-service-api

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

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 adding-support-for-additional-native-file-formats

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:

Interacciones de componentes component-interactions

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:

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.

Acerca de los archivos XML de script y diálogo about-the-script-and-dialog-xml-files

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 dialog-box-and-window-element-terminology

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 hierarchy

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.

Jerarquía de script y XML de diálogo

Archivos XML de script script-xml-files

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 dialog-xml-files

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:

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 adding-or-modifying-support-for-a-native-file-format

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 choosing-a-tool-for-identifying-window-elements

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:

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:

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 unpackaging-the-dialog-and-script-files

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:

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:

Para volver a implementar el componente GeneratePDF

Crear o modificar un archivo XML de secuencia de comandos para una aplicación nativa creating-or-modifying-a-script-xml-file-for-a-native-application

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 identifying-steps-the-script-must-execute

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:

Identificación de los cuadros de diálogo especificados en los atributos de rótulo identifying-the-dialogs-specified-in-caption-attributes

Utilice Microsoft Spy++ para obtener las identidades de las propiedades de los elementos de ventana en la aplicación nativa. Debe tener estas identidades para escribir scripts.

Uso de expresiones regulares en atributos de rótulo using-regular-expressions-in-caption-attributes

Puede utilizar expresiones regulares en las especificaciones de los subtítulos. El servicio Generate PDF utiliza la clase java.util.regex.Matcher para admitir expresiones regulares. Esa utilidad admite las expresiones regulares descritas en java.util.regex.Pattern.

Expresión regular que incluye el nombre de archivo antepuesto al Bloc de notas en el banner del Bloc de notas

 <!-- The regular expression ".*Notepad" means any number of non-terminating characters followed by Notepad. -->
 <step>
     <expectedWindow>
         <window caption=".*Notepad"/>
     </expectedWindow>
 </step>

Expresión regular que diferencia Print de Print Setup

 <!-- This regular expression differentiates the Print dialog box from the Print Setup dialog box. The "^" specifies the beginning of the line, and the "$" specifies the end of the line. -->
 <windowList>
     <window controlID="0x01" caption="^Print$" action="press"/>
 </windowList>

Ordenación de los elementos window y windowList ordering-the-window-and-windowlist-elements

Ordene los elementos window y windowList de la siguiente manera:

Ordenar elementos de ventana en un archivo de diálogo

 <!-- The caption attribute in the following window element is 40 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
 <window caption="Unexpected Failure in DebugActiveProcess">
     <…>
 </window>

 <!-- Caption length is 33 characters. -->
 <window caption="Adobe Acrobat - License Agreement">
     <…>
 </window>

 <!-- Caption length is 33 characters. -->
 <window caption="Microsoft Visual.*Runtime Library">
     <…>
 </window>

 <!-- The caption attribute in the following window element is 28 characters long. It is the shortest caption in this example, so its parent window element appears after the others. -->
 <window caption="Adobe Acrobat - Registration">
     <…>
 </window>

Ordenar elementos de ventana dentro de un elemento windowList

 <!-- The caption attribute in the following indexes element is 56 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
 <windowList>
     <window caption="Can&apos;t exit design mode because.* cannot be created"/>
     <window className="Button" caption="OK" action="press"/>
 </windowList>
 <windowList>
     <window caption="Do you want to continue loading the project?"/>
     <window className="Button" caption="No" action="press"/>
 </windowList>
 <windowList>
     <window caption="The macros in this project are disabled"/>
     <window className="Button" caption="OK" action="press"/>
 </windowList>

Crear o modificar un archivo XML de diálogo adicional para una aplicación nativa creating-or-modifying-an-additional-dialog-xml-file-for-a-native-application

Si crea una secuencia de comandos para una aplicación nativa que no era compatible anteriormente, también debe crear un archivo XML de diálogo adicional para esa aplicación. Cada aplicación nativa que utiliza AppMon debe tener solo un archivo XML de diálogo adicional. El archivo XML de diálogo adicional es necesario aunque no se esperen cuadros de diálogo no solicitados. El cuadro de diálogo adicional debe tener al menos un elemento window, incluso si ese elemento window es simplemente un marcador de posición.

También puede modificar el archivo XML de diálogo adicional para una aplicación nativa con estos fines:

El nombre de archivo que identifica un archivo dialogXML adicional es appmon.[appname].addition.[locale].xml. Un ejemplo es appmon.excel.add.en_US.xml.

El nombre del archivo XML de diálogo adicional debe usar el formato appmon.[applicationname].addition.[locale].xml, donde applicationName debe coincidir exactamente con el nombre de aplicación usado en el archivo de configuración XML y en el script.

Ordenar windowList elementos que aparecen como elementos secundarios en un elemento window. (Consulte Ordenar la ventana y los elementos windowList).

Modificación del archivo XML de diálogo general modifying-the-general-dialog-xml-file

Puede modificar el archivo XML de diálogo general para responder a cuadros de diálogo generados por el sistema o para responder a cuadros de diálogo comunes a varias aplicaciones.

Agregar una entrada de tipo de archivo en el archivo de configuración XML adding-a-filetype-entry-in-the-xml-configuration-file

En este procedimiento se explica cómo actualizar el archivo de configuración del servicio Generate PDF para asociar tipos de archivo con aplicaciones nativas. Para actualizar este archivo de configuración, debe utilizar la consola de administración para exportar los datos de configuración a un archivo. El nombre de archivo predeterminado para los datos de configuración es native2pdfconfig.xml.

Actualizar el archivo de configuración del servicio Generar PDF

En este ejemplo, los datos de configuración predeterminados suministrados con el servicio Generate PDF se modificaron para especificar que se debe utilizar Notepad (no Microsoft Word) para procesar archivos con la extensión de nombre de archivo .txt. Antes de esta modificación, se especificó Microsoft Word como la aplicación nativa que debe procesar dichos archivos.

Modificaciones para dirigir archivos de texto al Bloc de notas (native2pdfconfig.xml)

 <filetype-settings>

 <!-- Some native app file types were omitted for brevity. -->
 <!-- The following GenericApp element specifies Notepad as the native application that should be used to process files that have a txt file name extension. -->
             <GenericApp
                 extensions="txt"
                 name="Notepad" displayName=".*Notepad"/>
             <GenericApp
                 extensions="wpd"
                 name="WordPerfect" displayName="Corel WordPerfect"/>
             <GenericApp extensions="pmd,pm6,p65,pm"
                 name="PageMaker" displayName="Adobe PageMaker"/>
             <GenericApp extensions="fm"
                 name="FrameMaker" displayName="Adobe FrameMaker"/>
             <GenericApp extensions="psd"
                 name="Photoshop" displayName="Adobe Photoshop"/>
         </settings>
     </filetype-settings>

Creación de una variable de entorno para localizar la aplicación nativa creating-an-environment-variable-to-locate-the-native-application

Cree una variable de entorno que especifique la ubicación del ejecutable de la aplicación nativa. La variable debe usar el formato [applicationname]_PATH, donde nombreaplicación debe coincidir exactamente con el nombre de aplicación utilizado en el archivo de configuración XML y en el script, y donde la ruta de acceso contiene la ruta de acceso al ejecutable entre comillas dobles. Un ejemplo de esta variable de entorno es Photoshop_PATH.

Después de crear la nueva variable de entorno, debe reiniciar el servidor en el que se implementa el servicio Generate PDF.

Crear una variable de sistema en el entorno de Windows XP

Crear una variable de sistema desde la línea de comandos

Archivos XML xml-files

AEM Forms incluye archivos XML de ejemplo que hacen que el servicio Generate PDF utilice Notepad para procesar cualquier archivo con la extensión de nombre de archivo .txt. Este código se incluye en esta sección. Además, debe realizar las demás modificaciones que se describen en esta sección.

Archivo XML de diálogo adicional additional-dialog-xml-file

Este ejemplo contiene los cuadros de diálogo adicionales para la aplicación Bloc de notas. Estos cuadros de diálogo se pueden añadir a los especificados por el servicio Generate PDF.

Cuadros de diálogo del Bloc de notas(appmon.notepad.addie.en_US.xml)

 <dialogs app="Notepad" locale="en_US" version="7.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="dialogs.xsd">
     <window caption="Caption Title">
         <windowList>
             <window className="Button" caption="OK" action="press"/>
         </windowList>
     </window>
 </dialogs>

Archivo XML de script script-xml-file

En este ejemplo se especifica cómo debe interactuar el servicio Generate PDF con el Bloc de notas para imprimir archivos mediante la impresora Adobe PDF.

Archivo XML de script de Bloc de notas (appmon.notepad.script.en_US.xml)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--
*
* ADOBE CONFIDENTIAL
* ___________________
* Copyright 2004 - 2005 Adobe Systems Incorporated
* All Rights Reserved.
*
* NOTICE:  All information contained herein is, and remains
* the property of Adobe Systems Incorporated and its suppliers,
* if any.  The intellectual and technical concepts contained
* herein are proprietary to Adobe Systems Incorporated and its
* suppliers and may be covered by U.S. and Foreign Patents,
* patents in process, and are protected by trade secret or copyright law.
* Dissemination of this information or reproduction of this material
* is strictly forbidden unless prior written permission is obtained
* from Adobe Systems Incorporated.
*-->

<!-- This file automates printing of text files via notepad to Adobe PDF printer. To see the complete hierarchy Adobe recommends using the Microsoft Spy++ which details the properties of windows necessary to write scripts. In this sample there are total of eight steps-->

<application name="Notepad" version="9.0" locale="en_US" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="scripts.xsd">

    <!-- In this step we wait for the application window to appear -->
    <step>
        <expectedWindow>
            <window caption=".*Notepad"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the application window and send File->Open menu bar, menu item commands and the expectation is the windows Open dialog-->
    <step>
        <acquiredWindow>
            <window caption=".*Notepad">
                <virtualInput>
                    <menuBar>
                        <selection>
                            <name>File</name>
                        </selection>
                        <selection>
                            <name>Open...</name>
                        </selection>
                    </menuBar>
                </virtualInput>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Open"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the Open window and then select the 'Edit' widget and input the source path followed by clicking on the 'Open' button . The expectation of this 'action' is that the Open dialog will disappear -->
    <step>
        <acquiredWindow>
            <window caption="Open">
                <windowList>
                    <window className="ComboBoxEx32">
                        <windowList>
                            <window className="ComboBox">
                                <windowList>
                                <window className="Edit" action="inputSourcePath"/>
                                </windowList>
                            </window>
                        </windowList>
                    </window>
                </windowList>
                <windowList>
                    <window className="Button" caption="Open" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Open" action="disappear"/>
        </expectedWindow>
        <pause value="30"/>
    </step>

    <!-- In this step, we acquire the application window and send File->Print menu bar, menu item commands and the expectation is the windows Print dialog-->
    <step>
        <acquiredWindow>
            <window caption=".*Notepad">
                <virtualInput>
                    <menuBar>
                        <selection>
                            <name>File</name>
                        </selection>
                        <selection>
                            <name>Print...</name>
                        </selection>
                    </menuBar>
                </virtualInput>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Print">
        </window>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the Print dialog and click the 'Preferences' button and the expected window in this case is the dialog with the caption '"Printing Preferences' -->
    <step>
        <acquiredWindow>
            <window caption="Print">
                <windowList>
                    <window caption="General">
                        <windowList>
                            <window className="Button" caption="Preferences" action="press"/>
                        </windowList>
                    </window>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Printing Preferences"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the dialog "Printing Preferences' and select the combo box which is the 10th child of window with caption '"Adobe PDF Settings' and select the first index. (Note: All indeces start with 0.) Besides this we uncheck the box which has the caption '"View Adobe PDF results' and we click the button OK. The expectation is that 'Printing Preferences' dialog disappears. -->
    <step>
        <acquiredWindow>
            <window caption="Printing Preferences">
                <windowList>
                    <window caption="Adobe PDF Settings">
                        <windowList>
                            <window className="Button" caption="View Adobe PDF results" action="uncheck"/>
                        </windowList>
                        <windowList>
                            <window className="Button" caption="Ask to Replace existing PDF file" action="uncheck"/>
                        </windowList>
                    </window>
                </windowList>
                <windowList>
                    <window className="Button" caption="OK" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Printing Preferences" action="disappear"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the 'Print' dialog and click the Print button. The expectation is that the dialog with caption 'Print' disappears. In this case we use the regular expression '^Print$' for specifying the caption given there could be multiple dialogs with caption that includes the word Print. -->
    <step>
        <acquiredWindow>
            <window caption="Print">
                <windowList>
                    <window caption="General"/>
                    <window className="Button" caption="^Print$" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Print" action="disappear"/>
        </expectedWindow>
    </step>
    <step>
        <expectedWindow>
            <window caption="Save PDF File As"/>
        </expectedWindow>
    </step>
    <!-- Finally in this step, we acquire the dialog with caption "Save PDF File As" and in the Edit widget type the destination path for the output PDF file and click the Save button. The expectation is that the dialog disappears-->
    <step>
        <acquiredWindow>
            <window caption="Save PDF File As">
                <windowList>
                    <window className="Edit" action="inputDestinationPath"/>
                </windowList>
                <windowList>
                    <window className="Button" caption="Save" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Save PDF File As" action="disappear"/>
        </expectedWindow>
    </step>

    <!-- We can always set a retry count or a maximum time for a step. In case we surpass these limitations, PDF Generator generates this abort message and terminates processing. -->
    <abortMessage msg="15078"/>
</application>