Show Menu
TEMAS×

Uso de utilidades XMP

Acerca del servicio de utilidades XMP
Los documentos PDF contienen metadatos, que es información sobre el documento, tal como se distingue del contenido del documento, como texto y gráficos. Adobe Extensible Metadata Platform (XMP) es un estándar para gestionar metadatos de documento.
El servicio Utilidades XMP puede recuperar y guardar metadatos XMP de documentos PDF e importar metadatos XMP a documentos PDF.
Puede realizar estas tareas mediante el servicio Utilidades XMP:
Para obtener más información sobre el servicio Utilidades XMP, consulte Referencia de servicios para AEM Forms .

Importación de metadatos en Documentos PDF

Puede utilizar las API de Java y de servicio Web de XMP Utilities para importar metadatos XMP en un documento PDF mediante programación. Los metadatos proporcionan información sobre un documento PDF, como el autor del documento y las palabras clave relacionadas con el documento. Los metadatos se pueden encontrar en el cuadro de diálogo Propiedades del Documento del documento, como se muestra en la siguiente ilustración.
Para importar metadatos mediante programación a un documento PDF, puede utilizar un documento XML existente que especifique los valores de metadatos o un objeto de tipo XMPUtilityMetadata . (Consulte Referencia de la API de AEM Forms).
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>

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

Resumen de los pasos

Para importar metadatos XMP a un documento PDF, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente XMPUtilityService.
  3. Invocar la operación de importación de metadatos XMP.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear 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 de Utilidades XMP, debe crear un cliente XMPUtilityService. Con la API de Java, esto se logra creando un XMPUtilityServiceClient objeto. Con la API de servicio Web, esto se logra mediante el uso de un XMPUtilityServiceService objeto.
Invocar la operación de importación de metadatos XMP
Después de crear el cliente de servicio, puede invocar una de las operaciones de importación de metadatos XMP para importar los metadatos XMP en el documento PDF especificado.
Consulte también

Importación de metadatos XMP mediante la API de Java

Importe metadatos XMP mediante la API de utilidades XMP (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-pdfutility-client.jar, en la ruta de clases del proyecto Java.
    El archivo adobe-pdfutility-client.jar contiene clases que le permiten invocar mediante programación el servicio Utilidades XMP.
  2. Creación de un cliente XMPUtilityService
    Cree un XMPUtilityServiceClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Invocar la operación de importación de metadatos XMP
    Para modificar los metadatos XMP, invoque el XMPUtilityServiceClient método importMetadata del objeto o su importXMP método.
    Si utiliza el importMetadata método, pase los siguientes valores:
    • Un com.adobe.idp.Document objeto que representa el archivo PDF.
    • Un XMPUtilityMetadata objeto que contiene los metadatos que se van a importar.
    Si utiliza el importXMP método, pase los siguientes valores:
    • Un com.adobe.idp.Document objeto que representa el archivo PDF.
    • Un com.adobe.idp.Document objeto 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 objeto 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 XMP mediante la API de servicio web

Para importar metadatos XMP mediante programación mediante la API de servicio Web de Utilidades XMP, realice las siguientes tareas:
  1. Incluir archivos de proyecto
  2. Creación de un cliente XMPUtilityService
    Cree un XMPUtilityServiceService objeto mediante el constructor de la clase proxy.
  3. Invocar la operación de importación de metadatos XMP
    Para modificar los metadatos XMP, invoque el XMPUtilityServiceService método importMetadata del objeto o su importXMP método.
    Si utiliza el importMetadata método, pase los siguientes valores:
    • Un BLOB objeto que representa el archivo PDF.
    • Un XMPUtilityMetadata objeto que contiene los metadatos que se van a importar.
    Si utiliza el importXMP método, pase los siguientes valores:
    • Un BLOB objeto que representa el archivo PDF.
    • Un BLOB objeto que representa un archivo XML que contiene los metadatos que se van a importar.
    En cualquier caso, el valor devuelto es un BLOB objeto que representa el archivo PDF con los metadatos recién importados. A continuación, puede guardar este objeto en el disco.
Consulte también

Exportación de metadatos desde Documentos PDF

Puede utilizar las API de Java y de servicio Web de Utilidades XMP para recuperar y guardar metadatos XMP mediante programación desde un documento PDF.
Para obtener más información sobre el servicio Utilidades XMP, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para exportar metadatos XMP desde un documento PDF, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente XMPUtilityService.
  3. Invocar la operación de exportación de metadatos XMP.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear 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 de Utilidades XMP, debe crear un cliente XMPUtilityService. Con la AP de Java, esto se logra creando un XMPUtilityServiceClient objeto. Con la API de servicio Web, esto se logra utilizando un XMPUtilityServiceService objeto.
Invocar la operación de exportación de metadatos XMP
Después de crear el cliente de servicio, puede invocar una de las operaciones de exportación de metadatos XMP, que se puede utilizar para inspeccionar los metadatos XMP o guardarlos en el disco.
Consulte también

Exportación de metadatos XMP mediante la API de Java

Exporte metadatos XMP mediante la API de utilidades XMP (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-pdfutility-client.jar, en la ruta de clases del proyecto Java.
    El archivo adobe-pdfutility-client.jar contiene clases que le permiten invocar mediante programación el servicio de utilidad XMP.
  2. Creación de un cliente XMPUtilityService
    Cree un XMPUtilityServiceClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Invocar la operación de importación de metadatos XMP
    Para inspeccionar los metadatos XMP, invoque el XMPUtilityServiceClient método exportMetadata del objeto y pase un com.adobe.idp.Document objeto que represente el archivo PDF. El método devuelve un XMPUtilityMetadata objeto que contiene los metadatos recuperados.
    Para recuperar y guardar los metadatos XMP, invoque el XMPUtilityServiceClient método exportXMP del objeto y pase un com.adobe.idp.Document objeto que represente el archivo PDF. El método devuelve un com.adobe.idp.Document objeto que contiene los metadatos recuperados, que se pueden guardar posteriormente en el disco como archivo XML.
Consulte también

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

Exporte metadatos XMP mediante la API de utilidades XMP (servicio web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el archivo WSDL del servicio de utilidades XMP.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Creación de un cliente XMPUtilityService
    Cree un XMPUtilityServiceService objeto mediante el constructor de la clase proxy.
  3. Invocar la operación de importación de metadatos XMP
    Para inspeccionar los metadatos XMP, invoque el XMPUtilityServiceClient método exportMetadata del objeto y pase un BLOB objeto que represente el archivo PDF. El método devuelve un XMPUtilityMetadata objeto que contiene los metadatos recuperados.
    Para recuperar y guardar los metadatos XMP, invoque el XMPUtilityServiceClient método exportXMP del objeto y pase un BLOB objeto que represente el archivo PDF. El método devuelve un BLOB objeto que contiene los metadatos recuperados, que se pueden guardar posteriormente en el disco como archivo XML.
Consulte también