DocumentazioneAEM 6.5Guida utente

Utilizzo dei servizi dell’XMP working-with-xmp-utilities

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.

Informazioni sul servizio Utilità XMP

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:

NOTE
Per ulteriori informazioni sul servizio Utilità XMP, vedere Riferimento servizi per AEM Forms.

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.

ww_ww_metadata

Per importare i metadati in modo programmatico 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.)

NOTE
In questa sezione viene illustrato come utilizzare un documento XML per importare metadati in un documento PDF.

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>
NOTE
Per ulteriori informazioni sul servizio Utilità XMP, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi summary-of-steps

Per importare metadati XMP in un documento PDF, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client XMPUtilityService.
  3. 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 ottenuto creando un oggetto XMPUtilityServiceClient. Con l'API del servizio Web, questa operazione viene eseguita utilizzando un oggetto XMPUtilityServiceService.

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):

  1. 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.

  2. Creare un client XMPUtilityService

    Creare un oggetto XMPUtilityServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

  3. Richiama l’operazione di importazione dei metadati XMP

    Per modificare i metadati XMP, richiamare il metodo importMetadata dell'oggetto XMPUtilityServiceClient o il relativo metodo importXMP.

    Se si utilizza il metodo importMetadata, passare i seguenti valori:

    • Oggetto com.adobe.idp.Document che rappresenta il file PDF.
    • Oggetto XMPUtilityMetadata contenente i metadati da importare.

    Se si utilizza il metodo importXMP, passare i seguenti valori:

    • Oggetto com.adobe.idp.Document che rappresenta il file PDF.
    • Oggetto com.adobe.idp.Document che rappresenta un file XML contenente i metadati da importare.

    In entrambi i casi, il valore restituito è un oggetto com.adobe.idp.Document che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto su disco.

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à:

  1. Includi file di progetto

  2. Creare un client XMPUtilityService

    Creare un oggetto XMPUtilityServiceService utilizzando il costruttore di classe proxy.

  3. Richiama l’operazione di importazione dei metadati XMP

    Per modificare i metadati XMP, richiamare il metodo importMetadata dell'oggetto XMPUtilityServiceService o il relativo metodo importXMP.

    Se si utilizza il metodo importMetadata, passare i seguenti valori:

    • Oggetto BLOB che rappresenta il file PDF.
    • Oggetto XMPUtilityMetadata contenente i metadati da importare.

    Se si utilizza il metodo importXMP, passare i seguenti valori:

    • Oggetto BLOB che rappresenta il file PDF.
    • Oggetto BLOB che rappresenta un file XML contenente i metadati da importare.

    In entrambi i casi, il valore restituito è un oggetto BLOB che rappresenta il file PDF con i metadati appena importati. È quindi possibile salvare l'oggetto su disco.

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.

NOTE
Per ulteriori informazioni sul servizio Utilità XMP, vedere Riferimento servizi per AEM Forms.

Riepilogo dei passaggi summary_of_steps-1

Per esportare i metadati XMP da un documento PDF, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un client XMPUtilityService.
  3. 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 il punto di accesso Java, questo viene ottenuto creando un oggetto XMPUtilityServiceClient. Con l'API del servizio Web, questa operazione viene eseguita utilizzando un oggetto XMPUtilityServiceService.

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):

  1. 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.

  2. Creare un client XMPUtilityService

    Creare un oggetto XMPUtilityServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

  3. Richiama l’operazione di importazione dei metadati XMP

    Per verificare i metadati XMP, richiamare il metodo exportMetadata dell'oggetto XMPUtilityServiceClient e passare un oggetto com.adobe.idp.Document che rappresenta il file PDF. Il metodo restituisce un oggetto XMPUtilityMetadata contenente i metadati recuperati.

    Per recuperare e salvare i metadati XMP, richiamare il metodo exportXMP dell'oggetto XMPUtilityServiceClient e passare un oggetto com.adobe.idp.Document che rappresenta il file PDF. Il metodo restituisce un oggetto com.adobe.idp.Document contenente i metadati recuperati, che è possibile salvare successivamente 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):

  1. 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.

  2. Creare un client XMPUtilityService

    Creare un oggetto XMPUtilityServiceService utilizzando il costruttore di classe proxy.

  3. Richiama l’operazione di importazione dei metadati XMP

    Per verificare i metadati XMP, richiamare il metodo exportMetadata dell'oggetto XMPUtilityServiceClient e passare un oggetto BLOB che rappresenta il file PDF. Il metodo restituisce un oggetto XMPUtilityMetadata contenente i metadati recuperati.

    Per recuperare e salvare i metadati XMP, richiamare il metodo exportXMP dell'oggetto XMPUtilityServiceClient e passare un oggetto BLOB che rappresenta il file PDF. Il metodo restituisce un oggetto BLOB contenente i metadati recuperati, che è possibile salvare successivamente 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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2