Trabajar con utilidades XMP

Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.

XMP Acerca del servicio de utilidades de

Los documentos de PDF contienen metadatos, que son información sobre el documento tal como se distingue del contenido del documento, como texto y gráficos. La plataforma de metadatos extensible de Adobe XMP () es un estándar para administrar metadatos de documentos.

XMP XMP El servicio Utilidades de la puede recuperar y guardar metadatos de la de documentos de PDF XMP, así como importarlos en documentos de PDF.

XMP Puede llevar a cabo estas tareas mediante el servicio Utilidades de la:

NOTA

XMP Para obtener más información sobre el servicio Utilidades de la, consulte Referencia de servicios para AEM Forms.

Importación de metadatos en documentos de PDF

XMP XMP Puede utilizar las API de Java y servicios web de Utilidades de la para importar mediante programación metadatos de la aplicación en un documento de PDF. Los metadatos proporcionan información sobre un documento de PDF, como el autor del documento y las palabras clave relacionadas con él. Los metadatos se pueden encontrar en el cuadro de diálogo Propiedades del documento, como se muestra en la siguiente ilustración.

ww_ww_metadatadialog

Para importar metadatos mediante programación en un documento de PDF, puede utilizar un documento XML existente que especifique los valores de los metadatos o puede utilizar un objeto de tipo XMPUtilityMetadata. (Consulte Referencia de API de AEM Forms.)

NOTA

En esta sección se explica cómo utilizar un documento XML para importar metadatos en un documento de PDF.

El siguiente código XML contiene valores de metadatos que corresponden a la ilustración anterior. Por ejemplo, observe los elementos en negrita, que especifican palabras clave.

 <?xpacket begin="?" id="W5M0MpCehiHzreSzNTczkc9d"?>
 <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 4.2-jc015 52.349034, 2008 Jun 20 00:30:39-PDT (debug)">
       <rdf:RDF xmlns:rdf="https://www.w3.org/1999/02/22-rdf-syntax-ns#">
          <rdf:Description rdf:about=""
                xmlns:xmp="https://ns.adobe.com/xap/1.0/">
             <xmp:MetadataDate>2008-10-22T10:52:21-04:00</xmp:MetadataDate>
             <xmp:CreatorTool>AEM Forms</xmp:CreatorTool>
             <xmp:ModifyDate>2008-10-22T10:52:21-04:00</xmp:ModifyDate>
             <xmp:CreateDate>2008-02-13T11:00:18-05:00</xmp:CreateDate>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:pdf="https://ns.adobe.com/pdf/1.3/">
             <pdf:Producer>AEM Forms</pdf:Producer>
             <pdf:Keywords>keyword1, keyword2, keyword3,keyword4</pdf:Keywords>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:xmpMM="https://ns.adobe.com/xap/1.0/mm/">
             <xmpMM:DocumentID>uuid:1cce1f84-331e-4d8d-8538-15441c271dd7</xmpMM:DocumentID>
             <xmpMM:InstanceID>uuid:cdda0ca6-7c91-4771-9dc9-796c8fe59350</xmpMM:InstanceID>
          </rdf:Description>
          <rdf:Description rdf:about=""
                >
             <dc:format>application/pdf</dc:format>
             <dc:description>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Adobe Designer Sample</rdf:li>
                </rdf:Alt>
             </dc:description>
             <dc:title>
                <rdf:Alt>
                   <rdf:li xml:lang="x-default">Grant Application</rdf:li>
                </rdf:Alt>
             </dc:title>
             <dc:creator>
                <rdf:Seq>
                   <rdf:li>Tony Blue</rdf:li>
                </rdf:Seq>
             </dc:creator>
             <dc:subject>
                <rdf:Bag>
                   <rdf:li>keyword1</rdf:li>
                   <rdf:li>keyword2</rdf:li>
                   <rdf:li>keyword3</rdf:li>
                   <rdf:li>keyword4</rdf:li>
                </rdf:Bag>
             </dc:subject>
          </rdf:Description>
          <rdf:Description rdf:about=""
                xmlns:desc="https://ns.adobe.com/xfa/promoted-desc/">
             <desc:version rdf:parseType="Resource">
                <rdf:value>1.0</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:version>
             <desc:contact rdf:parseType="Resource">
                <rdf:value>Adobe Systems Incorporated</rdf:value>
                <desc:ref>/template/subform[1]</desc:ref>
             </desc:contact>
          </rdf:Description>
       </rdf:RDF>
 </x:xmpmeta>
NOTA

XMP Para obtener más información sobre el servicio Utilidades de la, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

XMP Para importar metadatos de la en un documento de PDF, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de XMPUtilityService.
  3. XMP Invoque la operación de importación de metadatos de la.

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 de XMPUtilityService

XMP Antes de poder realizar mediante programación una operación de Utilidades de, debe crear un cliente de XMPUtilityService. Con la API de Java, esto se logra creando un XMPUtilityServiceClient objeto. Con la API del servicio web, esto se logra mediante una XMPUtilityServiceService objeto.

XMP Invocar la operación de importación de metadatos de la

XMP XMP Después de crear el cliente de servicios, puede invocar una de las operaciones de importación de metadatos de la para importar los metadatos de la en el documento de PDF especificado.

Consulte también

XMP Importación de metadatos de la mediante la API de Java

XMP Importación de metadatos de la mediante la API de servicio web

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

XMP Importación de metadatos de la mediante la API de Java

XMP XMP Importación de metadatos de la mediante la API de utilidades (Java):

  1. Incluir archivos de proyecto

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

    NOTA

    XMP El archivo adobe-pdfutility-client.jar contiene clases que permiten invocar mediante programación el servicio Utilidades de la.

  2. Crear un cliente de XMPUtilityService

    Crear un XMPUtilityServiceClient mediante su constructor y pasando un objeto ServiceClientFactory que contiene las propiedades de conexión.

  3. XMP Invocar la operación de importación de metadatos de la

    XMP Para modificar los metadatos de la, invoque el método XMPUtilityServiceClient del objeto importMetadata o su importXMP método.

    Si usa el importMetadata , pase los siguientes valores:

    • A com.adobe.idp.Document que representa el archivo del PDF.
    • Un XMPUtilityMetadata que contiene los metadatos que se van a importar.

    Si usa el importXMP , pase los siguientes valores:

    • A com.adobe.idp.Document que representa el archivo del PDF.
    • A com.adobe.idp.Document que representa un archivo XML que contiene los metadatos que se van a importar.

    En cualquier caso, el valor devuelto es un com.adobe.idp.Document que representa el archivo del PDF con los metadatos recién importados. A continuación, puede guardar este objeto en el disco.

Consulte también

Importación de metadatos en documentos de PDF

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

XMP Importación de metadatos de la mediante la API de servicio web

XMP XMP Para importar mediante programación metadatos de la mediante la API del servicio web de Utilidades de la aplicación, realice las siguientes tareas:

  1. Incluir archivos de proyecto

  2. Crear un cliente de XMPUtilityService

    Crear un XMPUtilityServiceService mediante el constructor de la clase de proxy.

  3. XMP Invocar la operación de importación de metadatos de la

    XMP Para modificar los metadatos de la, invoque el método XMPUtilityServiceService del objeto importMetadata o su importXMP método.

    Si usa el importMetadata , pase los siguientes valores:

    • A BLOB que representa el archivo del PDF.
    • Un XMPUtilityMetadata que contiene los metadatos que se van a importar.

    Si usa el importXMP , pase los siguientes valores:

    • A BLOB que representa el archivo del PDF.
    • A BLOB que representa un archivo XML que contiene los metadatos que se van a importar.

    En cualquier caso, el valor devuelto es un BLOB que representa el archivo del PDF con los metadatos recién importados. A continuación, puede guardar este objeto en el disco.

Consulte también

Importación de metadatos en documentos de PDF

Invocar AEM Forms con codificación Base64

Crear un ensamblado de cliente .NET que utilice codificación Base64

Exportación de metadatos desde documentos del PDF

XMP XMP Puede utilizar las API de Java y del servicio web de Utilidades de para recuperar y guardar metadatos de un documento de PDF mediante programación.

NOTA

XMP Para obtener más información sobre el servicio Utilidades de la, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos

XMP Para exportar metadatos de la desde un documento de PDF, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de XMPUtilityService.
  3. XMP Invoque la operación de exportación de metadatos de la.

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 de XMPUtilityService

XMP Antes de poder realizar mediante programación una operación de Utilidades de, debe crear un cliente de XMPUtilityService. Con la API de Java, esto se consigue creando una XMPUtilityServiceClient objeto. Con la API del servicio web, esto se logra mediante una XMPUtilityServiceService objeto.

XMP Invocar la operación de exportación de metadatos de la

XMP XMP Después de crear el cliente de servicio, puede invocar una de las operaciones de exportación de metadatos de la, que se puede utilizar para inspeccionar los metadatos de la o guardarlos en el disco.

Consulte también

XMP Importación de metadatos de la mediante la API de Java

XMP Importación de metadatos de la mediante la API de servicio web

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

XMP Exportación de metadatos de la mediante la API de Java

XMP XMP Exportación de metadatos de la mediante la API de utilidades (Java):

  1. Incluir archivos de proyecto

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

    NOTA

    XMP El archivo adobe-pdfutility-client.jar contiene clases que permiten invocar mediante programación el servicio de utilidad de.

  2. Crear un cliente de XMPUtilityService

    Crear un XMPUtilityServiceClient mediante su constructor y pasando un objeto ServiceClientFactory que contiene las propiedades de conexión.

  3. XMP Invocar la operación de importación de metadatos de la

    XMP Para inspeccionar los metadatos de la, invoque el XMPUtilityServiceClient del objeto exportMetadata método y pasar un com.adobe.idp.Document que representa el archivo del PDF. El método devuelve un valor XMPUtilityMetadata que contiene los metadatos recuperados.

    XMP Para recuperar y guardar los metadatos de la, invoque el XMPUtilityServiceClient del objeto exportXMP método y pasar un com.adobe.idp.Document que representa el archivo del PDF. El método devuelve un valor com.adobe.idp.Document que contiene los metadatos recuperados, que posteriormente puede guardar en disco como archivo XML.

Consulte también

Exportación de metadatos desde documentos del PDF

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

XMP Exportación de metadatos de la mediante la API de servicio web

XMP XMP Exportación de metadatos de la mediante la API de utilidades (servicio web):

  1. Incluir archivos de proyecto

    • Cree un ensamblado de cliente de Microsoft XMP .NET que consuma el archivo WSDL del servicio Utilidades de la.
    • Hacer referencia al ensamblado de cliente de Microsoft .NET.

  2. Crear un cliente de XMPUtilityService

    Crear un XMPUtilityServiceService mediante el constructor de la clase de proxy.

  3. XMP Invocar la operación de importación de metadatos de la

    XMP Para inspeccionar los metadatos de la, invoque el XMPUtilityServiceClient del objeto exportMetadata método y pasar un BLOB que representa el archivo del PDF. El método devuelve un valor XMPUtilityMetadata que contiene los metadatos recuperados.

    XMP Para recuperar y guardar los metadatos de la, invoque el XMPUtilityServiceClient del objeto exportXMP método y pasar un BLOB que representa el archivo del PDF. El método devuelve un valor BLOB que contiene los metadatos recuperados, que posteriormente puede guardar en disco como archivo XML.

Consulte también

Exportación de metadatos desde documentos del PDF

Invocar AEM Forms con codificación Base64

Crear un ensamblado de cliente .NET que utilice codificación Base64

En esta página