Utilizzo dei servizi dell’XMP working-with-xmp-utilities
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Informazioni sul servizio XMP Utilities
I documenti PDF contengono metadati, ovvero informazioni sul documento distinte dal contenuto del documento, ad esempio testo e grafica. Adobe La piattaforma XMP (Extensible Metadata Platform) è uno standard per la gestione dei metadati dei documenti.
Il servizio Utilità XMP può recuperare e salvare metadati XMP dai documenti PDF e importare metadati XMP nei documenti PDF.
Puoi eseguire queste attività utilizzando il servizio Utilità XMP:
- Importare metadati nei documenti PDF. (vedere Importazione di metadati nei documenti di PDF.)
- Esporta metadati da documenti PDF. (vedere Esportazione di metadati da documenti PDF.)
Importazione di metadati nei documenti di PDF importing-metadata-into-pdf-documents
Puoi utilizzare le API Java e dei servizi web di XMP Utilities per importare in modo programmatico i metadati XMP in un documento PDF. I metadati forniscono informazioni su un documento PDF, ad esempio l'autore del documento e le parole chiave correlate al documento. I metadati possono essere visualizzati nella finestra di dialogo Proprietà documento del documento, come illustrato nella figura seguente.
Per importare in modo programmatico i metadati in un documento PDF, è possibile utilizzare un documento XML esistente che specifichi i valori dei metadati oppure un oggetto di tipo XMPUtilityMetadata
. (vedere Riferimento API di AEM Forms.)
Il codice XML riportato di seguito contiene i valori dei metadati corrispondenti all'illustrazione precedente. Ad esempio, notate gli elementi in grassetto, che specificano le parole chiave.
<?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>
Riepilogo dei passaggi summary-of-steps
Per importare metadati XMP in un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client XMPUtilityService.
- Richiama l’operazione di importazione dei metadati XMP.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un client XMPUtilityService
Prima di poter eseguire un'operazione di utilità XMP a livello di programmazione, è necessario creare un client XMPUtilityService. Con l’API Java, questo viene eseguito creando un’ XMPUtilityServiceClient
oggetto. Con l’API del servizio web, questa operazione viene eseguita utilizzando un’ XMPUtilityServiceService
oggetto.
Richiama l’operazione di importazione dei metadati XMP
Dopo aver creato il client del servizio, è possibile richiamare una delle operazioni di importazione dei metadati XMP per importare i metadati XMP nel documento PDF specificato.
Consulta anche
Importare metadati XMP tramite API Java
Importazione dei metadati XMP tramite l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importare metadati XMP tramite API Java import-xmp-metadata-using-the-java-api
Importa i metadati dell’XMP utilizzando l’API Utility XMP (Java):
-
Includi file di progetto
Includi i file JAR client, come adobe-pdfutility-client.jar, nel percorso di classe del progetto Java.
note note NOTE Il file adobe-pdfutility-client.jar contiene classi che consentono di richiamare in modo programmatico il servizio Utilità XMP. -
Creare un client XMPUtilityService
Creare un
XMPUtilityServiceClient
oggetto utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto che contiene proprietà di connessione. -
Richiama l’operazione di importazione dei metadati XMP
Per modificare i metadati XMP, richiama
XMPUtilityServiceClient
dell'oggettoimportMetadata
metodo o i relativiimportXMP
metodo.Se si utilizza
importMetadata
metodo, passa i seguenti valori:- A
com.adobe.idp.Document
oggetto che rappresenta il file PDF. - Un
XMPUtilityMetadata
oggetto contenente i metadati da importare.
Se si utilizza
importXMP
metodo, passa i seguenti valori:- A
com.adobe.idp.Document
oggetto che rappresenta il file PDF. - A
com.adobe.idp.Document
oggetto che rappresenta un file XML contenente i metadati da importare.
In entrambi i casi, il valore restituito è
com.adobe.idp.Document
oggetto che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto su disco. - A
Consulta anche
Importazione di metadati nei documenti di PDF
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importazione dei metadati XMP tramite l’API del servizio web importing-xmp-metadata-using-the-web-service-api
Per importare in modo programmatico i metadati dell’XMP utilizzando l’API del servizio web Utility XMP, esegui le seguenti attività:
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizzi il file WSDL del servizio Utilità XMP. (vedere Richiamare AEM Forms utilizzando la codifica Base64.)
- Fare riferimento all'assembly client Microsoft .NET. (vedere Creazione di un assembly client .NET che utilizza la codifica Base64.)
-
Creare un client XMPUtilityService
Creare un
XMPUtilityServiceService
mediante il costruttore di classe proxy. -
Richiama l’operazione di importazione dei metadati XMP
Per modificare i metadati XMP, richiama
XMPUtilityServiceService
dell'oggettoimportMetadata
metodo o i relativiimportXMP
metodo.Se si utilizza
importMetadata
metodo, passa i seguenti valori:- A
BLOB
oggetto che rappresenta il file PDF. - Un
XMPUtilityMetadata
oggetto contenente i metadati da importare.
Se si utilizza
importXMP
metodo, passa i seguenti valori:- A
BLOB
oggetto che rappresenta il file PDF. - A
BLOB
oggetto che rappresenta un file XML contenente i metadati da importare.
In entrambi i casi, il valore restituito è
BLOB
oggetto che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto su disco. - A
Consulta anche
Importazione di metadati nei documenti di PDF
Richiamare AEM Forms utilizzando la codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64
Esportazione di metadati da documenti PDF exporting-metadata-from-pdf-documents
Puoi utilizzare le API Java e dei servizi web di XMP Utilities per recuperare e salvare in modo programmatico i metadati dell’XMP da un documento PDF.
Riepilogo dei passaggi summary_of_steps-1
Per esportare i metadati XMP da un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Creare un client XMPUtilityService.
- Richiama l’operazione di esportazione dei metadati XMP.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un client XMPUtilityService
Prima di poter eseguire un'operazione di utilità XMP a livello di programmazione, è necessario creare un client XMPUtilityService. Con l’API Java, questo viene eseguito creando un’ XMPUtilityServiceClient
oggetto. Con l’API del servizio web, questa operazione viene eseguita utilizzando un’ XMPUtilityServiceService
oggetto.
Richiama l’operazione di esportazione dei metadati XMP
Dopo aver creato il client del servizio, è possibile richiamare una delle operazioni di esportazione dei metadati XMP, che può essere utilizzata per esaminare i metadati XMP o salvarli su disco.
Consulta anche
Importare metadati XMP tramite API Java
Importazione dei metadati XMP tramite l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Esportare i metadati dell’XMP utilizzando l’API Java export-xmp-metadata-using-the-java-api
Esportare i metadati dell’XMP utilizzando l’API Utility XMP (Java):
-
Includi file di progetto
Includi i file JAR client, come adobe-pdfutility-client.jar, nel percorso di classe del progetto Java.
note note NOTE Il file adobe-pdfutility-client.jar contiene classi che consentono di richiamare a livello di programmazione il servizio Utilità XMP. -
Creare un client XMPUtilityService
Creare un
XMPUtilityServiceClient
oggetto utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto che contiene proprietà di connessione. -
Richiama l’operazione di importazione dei metadati XMP
Per verificare i metadati XMP, richiama
XMPUtilityServiceClient
dell'oggettoexportMetadata
metodo e passare in uncom.adobe.idp.Document
oggetto che rappresenta il file PDF. Il metodo restituisce unXMPUtilityMetadata
oggetto contenente i metadati recuperati.Per recuperare e salvare i metadati dell’XMP, richiama
XMPUtilityServiceClient
dell'oggettoexportXMP
metodo e passare in uncom.adobe.idp.Document
oggetto che rappresenta il file PDF. Il metodo restituisce uncom.adobe.idp.Document
oggetto contenente i metadati recuperati, che successivamente è possibile salvare su disco come file XML.
Consulta anche
Esportazione di metadati da documenti PDF
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Esportare i metadati dell’XMP utilizzando l’API del servizio web export-xmp-metadata-using-the-web-service-api
Esportare i metadati XMP utilizzando l’API Utility XMP (servizio web):
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizzi il file WSDL del servizio Utilità XMP.
- Fare riferimento all'assembly client Microsoft .NET.
-
Creare un client XMPUtilityService
Creare un
XMPUtilityServiceService
mediante il costruttore di classe proxy. -
Richiama l’operazione di importazione dei metadati XMP
Per verificare i metadati XMP, richiama
XMPUtilityServiceClient
dell'oggettoexportMetadata
metodo e passare in unBLOB
oggetto che rappresenta il file PDF. Il metodo restituisce unXMPUtilityMetadata
oggetto contenente i metadati recuperati.Per recuperare e salvare i metadati dell’XMP, richiama
XMPUtilityServiceClient
dell'oggettoexportXMP
metodo e passare in unBLOB
oggetto che rappresenta il file PDF. Il metodo restituisce unBLOB
oggetto contenente i metadati recuperati, che successivamente è possibile salvare su disco come file XML.
Consulta anche
Esportazione di metadati da documenti PDF
Richiamare AEM Forms utilizzando la codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64