Trabajar con utilidades XMP working-with-xmp-utilities
Acerca del servicio de utilidades XMP
Los documentos del 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 de PDF e importar XMP metadatos en documentos de PDF.
Puede realizar estas tareas mediante el servicio XMP Utilidades:
- Importe metadatos en documentos de PDF. (Consulte Importación de metadatos en documentos de PDF.)
- Exportar metadatos de documentos de PDF. (Consulte Exportación de metadatos desde documentos de PDF.)
Importación de metadatos en documentos de PDF importing-metadata-into-pdf-documents
Puede utilizar las API de servicios web y Java de utilidades de XMP para importar XMP metadatos mediante programación a 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 del documento, como se muestra en la siguiente ilustración.
Para importar metadatos mediante programación a 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 la API de AEM Forms.)
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>
Resumen de los pasos summary-of-steps
Para importar XMP metadatos en un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un cliente XMPUtilityService.
- 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 logra creando un XMPUtilityServiceClient
objeto. Con la API del servicio web, esto se logra mediante el uso de un XMPUtilityServiceService
objeto.
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 de 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 import-xmp-metadata-using-the-java-api
Importe XMP metadatos mediante la API de utilidades XMP (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR del cliente, como adobe-pdfutility-client.jar, en la ruta de clase del proyecto Java.
note note NOTE El archivo adobe-pdfutility-client.jar contiene clases que le permiten invocar mediante programación el servicio XMP Utilidades. -
Creación de un cliente XMPUtilityService
Cree un
XMPUtilityServiceClient
usando su constructor y pasando unServiceClientFactory
objeto que contiene propiedades de conexión. -
Invocar la operación de importación de metadatos de XMP
Para modificar los metadatos de XMP, invoque la variable
XMPUtilityServiceClient
del objetoimportMetadata
método oimportXMP
método.Si usa la variable
importMetadata
pasa los siguientes valores:- A
com.adobe.idp.Document
que representa el archivo PDF. - Un
XMPUtilityMetadata
objeto que contiene los metadatos que se van a importar.
Si usa la variable
importXMP
pasa los siguientes valores:- A
com.adobe.idp.Document
que representa el archivo 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 PDF con los metadatos recién importados. A continuación, puede guardar este objeto en el disco. - A
Consulte también
Importación de metadatos en documentos de 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 importing-xmp-metadata-using-the-web-service-api
Para importar mediante programación metadatos de XMP mediante la API de servicio web de utilidades de XMP, realice las siguientes tareas:
-
Incluir archivos de proyecto
- Cree un ensamblado de cliente de Microsoft .NET que consuma el archivo WSDL del servicio de utilidades de XMP. (Consulte Invocación de AEM Forms mediante la codificación Base64.)
- Haga referencia al ensamblado del cliente Microsoft .NET. (Consulte Creación de un ensamblado de cliente .NET que utilice la codificación Base64.)
-
Creación de un cliente XMPUtilityService
Cree un
XMPUtilityServiceService
usando el constructor de clase proxy. -
Invocar la operación de importación de metadatos de XMP
Para modificar los metadatos de XMP, invoque la variable
XMPUtilityServiceService
del objetoimportMetadata
método oimportXMP
método.Si usa la variable
importMetadata
pasa los siguientes valores:- A
BLOB
que representa el archivo PDF. - Un
XMPUtilityMetadata
objeto que contiene los metadatos que se van a importar.
Si usa la variable
importXMP
pasa los siguientes valores:- A
BLOB
que representa el archivo 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 PDF con los metadatos recién importados. A continuación, puede guardar este objeto en el disco. - A
Consulte también
Importación de metadatos en documentos de 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 desde documentos de PDF exporting-metadata-from-pdf-documents
Puede utilizar las API de servicios web y Java de utilidades de XMP para recuperar y guardar XMP metadatos mediante programación desde un documento de PDF.
Resumen de los pasos summary_of_steps-1
Para exportar XMP metadatos de un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un cliente XMPUtilityService.
- 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 API de Java, esto se logra creando una XMPUtilityServiceClient
objeto. Con la API del servicio web, esto se lleva a cabo mediante un XMPUtilityServiceService
objeto.
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 mediante la API de Java export-xmp-metadata-using-the-java-api
Exporte XMP metadatos mediante la API de utilidades de XMP (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR del cliente, como adobe-pdfutility-client.jar, en la ruta de clase del proyecto Java.
note note NOTE El archivo adobe-pdfutility-client.jar contiene clases que le permiten invocar mediante programación el servicio XMP Utility. -
Creación de un cliente XMPUtilityService
Cree un
XMPUtilityServiceClient
usando su constructor y pasando unServiceClientFactory
objeto que contiene propiedades de conexión. -
Invocar la operación de importación de metadatos de XMP
Para inspeccionar los metadatos de XMP, invoque la variable
XMPUtilityServiceClient
del objetoexportMetadata
método y pasar uncom.adobe.idp.Document
que representa el archivo PDF. El método devuelve un valorXMPUtilityMetadata
que contiene los metadatos recuperados.Para recuperar y guardar los metadatos de XMP, invoque la variable
XMPUtilityServiceClient
del objetoexportXMP
método y pasar uncom.adobe.idp.Document
que representa el archivo PDF. El método devuelve un valorcom.adobe.idp.Document
que contiene los metadatos recuperados, que posteriormente se pueden guardar en disco como un archivo XML.
Consulte también
Exportación de metadatos desde documentos de 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 export-xmp-metadata-using-the-web-service-api
Exporte XMP metadatos mediante la API de utilidades XMP (servicio web):
-
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 del cliente Microsoft .NET.
-
Creación de un cliente XMPUtilityService
Cree un
XMPUtilityServiceService
usando el constructor de clase proxy. -
Invocar la operación de importación de metadatos de XMP
Para inspeccionar los metadatos de XMP, invoque la variable
XMPUtilityServiceClient
del objetoexportMetadata
método y pasar unBLOB
que representa el archivo PDF. El método devuelve un valorXMPUtilityMetadata
que contiene los metadatos recuperados.Para recuperar y guardar los metadatos de XMP, invoque la variable
XMPUtilityServiceClient
del objetoexportXMP
método y pasar unBLOB
que representa el archivo PDF. El método devuelve un valorBLOB
que contiene los metadatos recuperados, que posteriormente se pueden guardar en disco como un archivo XML.
Consulte también
Exportación de metadatos desde documentos de 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