Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.
Informazioni sul servizio Utilità XMP
I documenti PDF contengono metadati, ovvero informazioni relative al documento distinte dal contenuto del documento, ad esempio testo e grafica. Adobe Extensible Metadata Platform (XMP) è uno standard per la gestione dei metadati dei documenti.
Il servizio Utilità di XMP può recuperare e salvare i metadati XMP dai documenti di PDF e importare metadati XMP nei documenti di PDF.
Puoi eseguire queste attività utilizzando il servizio Utilità XMP:
Per ulteriori informazioni sul servizio Utilità XMP, consulta Riferimento servizi per AEM Forms.
È possibile utilizzare le API di XMP Utilities Java e di servizi Web per importare in modo programmatico i metadati XMP in un documento PDF. I metadati forniscono informazioni su un documento di PDF, ad esempio l’autore del documento e le parole chiave correlate al documento. I metadati possono essere posizionati nella finestra di dialogo Proprietà documento del documento, come illustrato nella figura seguente.
Per importare a livello di programmazione i metadati in un documento PDF, è possibile utilizzare un documento XML esistente che specifica i valori dei metadati oppure un oggetto di tipo XMPUtilityMetadata
. (Vedi Riferimento API di AEM Forms.)
Questa sezione illustra come utilizzare un documento XML per importare metadati in un documento PDF.
Il codice XML seguente contiene i valori di metadati corrispondenti all'illustrazione precedente. Ad esempio, notare 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>
Per ulteriori informazioni sul servizio Utilità XMP, consulta Riferimento servizi per AEM Forms.
Per importare XMP metadati in un documento PDF, eseguire le operazioni seguenti:
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, assicurati di includere i file proxy.
Creare un client XMPUtilityService
Prima di eseguire un'operazione Utilità di XMP a livello di programmazione, è necessario creare un client XMPUtilityService. Con l’API Java, si ottiene questo risultato creando un’ XMPUtilityServiceClient
oggetto. Con l’API del servizio Web, si ottiene questo risultato utilizzando un’ XMPUtilityServiceService
oggetto.
Richiamare l’operazione di importazione dei metadati XMP
Dopo aver creato il client di servizio, è possibile richiamare una delle operazioni di importazione dei metadati XMP per importare i metadati XMP nel documento di PDF specificato.
Consulta anche
Importare metadati XMP utilizzando l’API Java
Importazione di metadati XMP tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importa i metadati XMP utilizzando l'API XMP Utilities (Java):
Includi file di progetto
Includi file JAR client, come adobe-pdfutility-client.jar, nel percorso di classe del progetto Java.
Il file adobe-pdfutility-client.jar contiene classi che consentono di richiamare programmaticamente il servizio Utilità XMP.
Creare un client XMPUtilityService
Crea un XMPUtilityServiceClient
utilizzando il relativo costruttore e passando un ServiceClientFactory
oggetto contenente le proprietà di connessione.
Richiamare l’operazione di importazione dei metadati XMP
Per modificare i metadati del XMP, richiamare XMPUtilityServiceClient
dell’oggetto importMetadata
metodo o importXMP
metodo .
Se utilizzi importMetadata
passa i seguenti valori:
com.adobe.idp.Document
oggetto che rappresenta il file PDF.XMPUtilityMetadata
che contiene i metadati da importare.Se utilizzi importXMP
passa i seguenti valori:
com.adobe.idp.Document
oggetto che rappresenta il file PDF.com.adobe.idp.Document
oggetto che rappresenta un file XML contenente i metadati da importare.In entrambi i casi, il valore restituito è un com.adobe.idp.Document
oggetto che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto sul disco.
Consulta anche
Importazione di metadati in documenti PDF
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Per importare in modo programmatico i metadati XMP utilizzando l'API del servizio Web XMP Utilities, esegui le seguenti attività:
Includi file di progetto
Creare un client XMPUtilityService
Crea un XMPUtilityServiceService
utilizzando il costruttore della classe proxy.
Richiamare l’operazione di importazione dei metadati XMP
Per modificare i metadati del XMP, richiamare XMPUtilityServiceService
dell’oggetto importMetadata
metodo o importXMP
metodo .
Se utilizzi importMetadata
passa i seguenti valori:
BLOB
oggetto che rappresenta il file PDF.XMPUtilityMetadata
che contiene i metadati da importare.Se utilizzi importXMP
passa i seguenti valori:
BLOB
oggetto che rappresenta il file PDF.BLOB
oggetto che rappresenta un file XML contenente i metadati da importare.In entrambi i casi, il valore restituito è un BLOB
oggetto che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto sul disco.
Consulta anche
Importazione di metadati in documenti PDF
Richiamo di AEM Forms con codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64
È possibile utilizzare le API di XMP Utilities Java e di servizi Web per recuperare e salvare programmaticamente i metadati XMP da un documento PDF.
Per ulteriori informazioni sul servizio Utilità XMP, consulta Riferimento servizi per AEM Forms.
Per esportare i metadati XMP da un documento PDF, esegui le seguenti operazioni:
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, assicurati di includere i file proxy.
Creare un client XMPUtilityService
Prima di eseguire un'operazione Utilità di XMP a livello di programmazione, è necessario creare un client XMPUtilityService. Con Java AP, questo si ottiene creando un XMPUtilityServiceClient
oggetto. Con l’API del servizio Web, viene eseguito utilizzando un’ XMPUtilityServiceService
oggetto.
Richiamare l’operazione di esportazione dei metadati XMP
Dopo aver creato il client di servizio, è possibile richiamare una delle operazioni di esportazione dei metadati XMP, che può essere utilizzata per ispezionare i metadati XMP o salvarli sul disco.
Consulta anche
Importare metadati XMP utilizzando l’API Java
Importazione di metadati XMP tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Esporta metadati XMP utilizzando l'API XMP Utilities (Java):
Includi file di progetto
Includi file JAR client, come adobe-pdfutility-client.jar, nel percorso di classe del progetto Java.
Il file adobe-pdfutility-client.jar contiene classi che consentono di richiamare programmaticamente il servizio Utility XMP.
Creare un client XMPUtilityService
Crea un XMPUtilityServiceClient
utilizzando il relativo costruttore e passando un ServiceClientFactory
oggetto contenente le proprietà di connessione.
Richiamare l’operazione di importazione dei metadati XMP
Per esaminare i metadati XMP, richiama il XMPUtilityServiceClient
dell’oggetto exportMetadata
e trasmettere un com.adobe.idp.Document
oggetto che rappresenta il file PDF. Il metodo restituisce un XMPUtilityMetadata
oggetto contenente i metadati recuperati.
Per recuperare e salvare i metadati XMP, richiama il XMPUtilityServiceClient
dell’oggetto exportXMP
e trasmettere un com.adobe.idp.Document
oggetto che rappresenta il file PDF. Il metodo restituisce un com.adobe.idp.Document
oggetto contenente i metadati recuperati, che è possibile salvare successivamente su disco come file XML.
Consulta anche
Esportazione di metadati da documenti PDF
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Esporta metadati XMP utilizzando l'API XMP Utilities (servizio Web):
Includi file di progetto
Creare un client XMPUtilityService
Crea un XMPUtilityServiceService
utilizzando il costruttore della classe proxy.
Richiamare l’operazione di importazione dei metadati XMP
Per esaminare i metadati XMP, richiama il XMPUtilityServiceClient
dell’oggetto exportMetadata
e trasmettere un BLOB
oggetto che rappresenta il file PDF. Il metodo restituisce un XMPUtilityMetadata
oggetto contenente i metadati recuperati.
Per recuperare e salvare i metadati XMP, richiama il XMPUtilityServiceClient
dell’oggetto exportXMP
e trasmettere un BLOB
oggetto che rappresenta il file PDF. Il metodo restituisce un BLOB
oggetto contenente i metadati recuperati, che è possibile salvare successivamente su disco come file XML.
Consulta anche
Esportazione di metadati da documenti PDF
Richiamo di AEM Forms con codifica Base64
Creazione di un assembly client .NET che utilizza la codifica Base64