Uso de utilidades de XMP

Acerca del servicio de utilidades XMP

Los documentos PDF contienen metadatos, que son información sobre el documento distinguida del contenido del documento, como texto y gráficos. Adobe Extensible Metadata Platform (XMP) es un estándar para la gestión de metadatos de documentos.

El servicio XMP Utilidades puede recuperar y guardar XMP metadatos de documentos PDF e importar XMP metadatos en documentos PDF.

Puede realizar estas tareas mediante el servicio XMP Utilidades:

NOTA

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

Importación de metadatos en documentos PDF

Puede utilizar las API de servicios web y Java de utilidades de XMP para importar XMP metadatos mediante programación a un documento PDF. Los metadatos proporcionan información sobre un documento 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 del documento, como se muestra en la siguiente ilustración.

ww_ww_metadatadialog

Para importar metadatos mediante programación a un documento 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 la API de AEM Forms).

NOTA

En esta sección se explica cómo utilizar un documento XML para importar metadatos en un documento 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

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

Resumen de los pasos

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

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

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.

Creación de un cliente XMPUtilityService

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

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

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

Consulte también

Importación XMP metadatos mediante la API de Java

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

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Importación XMP metadatos mediante la API de Java

Importe XMP metadatos mediante la API de utilidades XMP (Java):

  1. Incluir archivos de proyecto

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

    NOTA

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

  2. Creación de un cliente XMPUtilityService

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

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

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

    Si utiliza el método importMetadata, pase los siguientes valores:

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

    Si utiliza el método importXMP, pase los siguientes valores:

    • Un objeto com.adobe.idp.Document que representa el archivo PDF.
    • Un objeto 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 objeto com.adobe.idp.Document que representa el archivo 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 PDF

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

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

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

  1. Incluir archivos de proyecto

  2. Creación de un cliente XMPUtilityService

    Cree un objeto XMPUtilityServiceService utilizando su constructor de clase proxy.

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

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

    Si utiliza el método importMetadata, pase los siguientes valores:

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

    Si utiliza el método importXMP, pase los siguientes valores:

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

    En cualquier caso, el valor devuelto es un objeto BLOB que representa el archivo 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 PDF

Invocación de AEM Forms mediante la codificación Base64

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

Exportación de metadatos de documentos PDF

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

NOTA

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

Resumen de los pasos

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

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

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.

Creación de un cliente XMPUtilityService

Para poder realizar mediante programación una operación XMP Utilidades, debe crear un cliente XMPUtilityService. Con la AP de Java, para conseguirlo, se crea un objeto XMPUtilityServiceClient. Con la API de servicio web, esto se logra mediante un objeto XMPUtilityServiceService.

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

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

Consulte también

Importación XMP metadatos mediante la API de Java

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

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Exportar metadatos de XMP usando la API de Java

Exporte XMP metadatos mediante la API de utilidades de XMP (Java):

  1. Incluir archivos de proyecto

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

    NOTA

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

  2. Creación de un cliente XMPUtilityService

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

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

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

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

Consulte también

Exportación de metadatos de documentos PDF

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Exportar metadatos de XMP mediante la API de servicio web

Exporte XMP metadatos mediante la API de utilidades XMP (servicio web):

  1. Incluir archivos de proyecto

    • Cree un ensamblado de cliente de Microsoft .NET que consuma el archivo WSDL del servicio de utilidades de XMP.
    • Haga referencia al ensamblado cliente de Microsoft .NET.
  2. Creación de un cliente XMPUtilityService

    Cree un objeto XMPUtilityServiceService utilizando su constructor de clase proxy.

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

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

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

Consulte también

Exportación de metadatos de documentos PDF

Invocación de AEM Forms mediante la codificación Base64

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

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now