Werken met XMP hulpprogramma's working-with-xmp-utilities
de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.
Ongeveer de Dienst van Hulpprogramma's XMP
PDF-documenten bevatten metagegevens. Dit zijn gegevens over het document die worden onderscheiden van de inhoud van het document, zoals tekst en afbeeldingen. Adobe Extensible Metadata Platform (XMP) is een standaard voor de verwerking van metagegevens van documenten.
Met de XMP Utilities kunt u XMP metagegevens uit PDF-documenten ophalen en opslaan, en XMP metagegevens importeren in PDF-documenten.
U kunt deze taken uitvoeren met behulp van de service XMP Hulpprogramma's:
- Metagegevens importeren in PDF-documenten. (Zie het Invoeren Meta-gegevens in de Documenten van PDF.)
- Metagegevens exporteren uit PDF-documenten. (Zie het Uitvoeren Meta-gegevens van de Documenten van PDF.)
Metagegevens importeren in PDF-documenten importing-metadata-into-pdf-documents
Met de XMP Utilities Java en de webservice-API's kunt u XMP metagegevens programmatisch importeren in een PDF-document. Metagegevens bevatten informatie over een PDF-document, zoals de auteur van het document en trefwoorden die betrekking hebben op het document. Metagegevens kunnen worden weergegeven in het dialoogvenster Documenteigenschappen van het document, zoals in de volgende afbeelding wordt getoond.
Als u metagegevens programmatisch wilt importeren in een PDF-document, kunt u een bestaand XML-document gebruiken dat de metagegevenswaarden opgeeft of een object van het type XMPUtilityMetadata
gebruiken. (Zie AEM Forms API Verwijzing.)
De volgende XML-code bevat metagegevenswaarden die overeenkomen met de vorige illustratie. Let bijvoorbeeld op de vette items die trefwoorden opgeven.
<?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>
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om XMP metagegevens te importeren in een PDF-document:
- Inclusief projectbestanden.
- Maak een XMPUtilityService-client.
- Roep de importbewerking voor XMP metagegevens aan.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, dient u de proxybestanden op te nemen.
creeer een cliënt XMPUtilityService
Voordat u een XMP Utilities-bewerking programmatisch kunt uitvoeren, moet u een XMPUtilityService-client maken. Met de Java API wordt dit gedaan door een XMPUtilityServiceClient
-object te maken. Met de webservice-API gebeurt dit met behulp van een XMPUtilityServiceService
-object.
Roep de XMP verrichting van de meta-gegevensinvoer aan
Nadat u de de dienstcliënt creeert, kunt u één van de XMP meta-gegevens aanhalen invoerverrichtingen om de XMP meta-gegevens in het gespecificeerde document van PDF in te voeren.
zie ook
Metagegevens XMP importeren met de Java API
XMP metagegevens importeren met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Metagegevens XMP importeren met de Java API import-xmp-metadata-using-the-java-api
Importeer XMP metagegevens met de XMP Utilities-API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-pdfutility-client.jar, op in het klassenpad van uw Java-project.
note note NOTE Het bestand adobe-pdfutility-client.jar bevat klassen waarmee u de service Hulpprogramma's voor XMP programmatisch kunt aanroepen. -
Een XMPUtilityService-client maken
Maak een
XMPUtilityServiceClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
De importbewerking voor XMP metagegevens aanroepen
Als u de XMP metagegevens wilt wijzigen, roept u de methode
importMetadata
of de methodeimportXMP
van het objectXMPUtilityServiceClient
aan.Wanneer u de methode
importMetadata
gebruikt, geeft u de volgende waarden door:- Een
com.adobe.idp.Document
-object dat het PDF-bestand vertegenwoordigt. - Een
XMPUtilityMetadata
-object dat de te importeren metagegevens bevat.
Wanneer u de methode
importXMP
gebruikt, geeft u de volgende waarden door:- Een
com.adobe.idp.Document
-object dat het PDF-bestand vertegenwoordigt. - Een
com.adobe.idp.Document
-object dat een XML-bestand vertegenwoordigt dat de te importeren metagegevens bevat.
In beide gevallen is de geretourneerde waarde een
com.adobe.idp.Document
-object dat het PDF-bestand met de nieuw geïmporteerde metagegevens vertegenwoordigt. U kunt dit object vervolgens op schijf opslaan. - Een
zie ook
Metagegevens importeren in PDF-documenten
XMP metagegevens importeren met de webservice-API importing-xmp-metadata-using-the-web-service-api
Voer de volgende taken uit om XMP metagegevens via de API voor XMP hulpprogramma's programmatisch te importeren:
-
Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die het dossier van WSDL van de dienst van het XMP gebruikt. (Zie het Aanhalen van AEM Forms gebruikend Base64 het coderen.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie Creërend een .NET cliëntassemblage die het coderen Base64gebruikt.)
-
Een XMPUtilityService-client maken
Maak een
XMPUtilityServiceService
-object met de constructor van de proxyklasse. -
De importbewerking voor XMP metagegevens aanroepen
Als u de XMP metagegevens wilt wijzigen, roept u de methode
importMetadata
of de methodeimportXMP
van het objectXMPUtilityServiceService
aan.Wanneer u de methode
importMetadata
gebruikt, geeft u de volgende waarden door:- Een
BLOB
-object dat het PDF-bestand vertegenwoordigt. - Een
XMPUtilityMetadata
-object dat de te importeren metagegevens bevat.
Wanneer u de methode
importXMP
gebruikt, geeft u de volgende waarden door:- Een
BLOB
-object dat het PDF-bestand vertegenwoordigt. - Een
BLOB
-object dat een XML-bestand vertegenwoordigt dat de te importeren metagegevens bevat.
In beide gevallen is de geretourneerde waarde een
BLOB
-object dat het PDF-bestand met de nieuw geïmporteerde metagegevens vertegenwoordigt. U kunt dit object vervolgens op schijf opslaan. - Een
zie ook
Metagegevens importeren in PDF-documenten
AEM Forms aanroepen met Base64-codering
Creërend een .NET cliëntassemblage die het coderen Base64 gebruikt
Metagegevens exporteren uit PDF-documenten exporting-metadata-from-pdf-documents
Met de XMP Utilities Java en de webservice-API's kunt u XMP metagegevens uit een PDF-document programmatisch ophalen en opslaan.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om XMP metagegevens uit een PDF-document te exporteren:
- Inclusief projectbestanden.
- Maak een XMPUtilityService-client.
- Roep de exportbewerking XMP metagegevens aan.
omvat projectdossiers
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, dient u de proxybestanden op te nemen.
creeer een cliënt XMPUtilityService
Voordat u een XMP Utilities-bewerking programmatisch kunt uitvoeren, moet u een XMPUtilityService-client maken. Met het Java-toegangspunt gebeurt dit door een XMPUtilityServiceClient
-object te maken. Met de webservice-API wordt dit gedaan met behulp van een XMPUtilityServiceService
-object.
Roep de XMP verrichting van de meta-gegevensuitvoer aan
Nadat u de de dienstcliënt creeert, kunt u één van de XMP meta-gegevens uitvoerverrichtingen aanhalen, die kunnen worden gebruikt om de XMP meta-gegevens te inspecteren of het op schijf te bewaren.
zie ook
Metagegevens XMP importeren met de Java API
XMP metagegevens importeren met de webservice-API
Metagegevens XMP exporteren met de Java API export-xmp-metadata-using-the-java-api
Exporteer XMP metagegevens met behulp van de XMP Utilities-API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-pdfutility-client.jar, op in het klassenpad van uw Java-project.
note note NOTE Het bestand adobe-pdfutility-client.jar bevat klassen waarmee u de service XMP Utility programmatisch kunt aanroepen. -
Een XMPUtilityService-client maken
Maak een
XMPUtilityServiceClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
De importbewerking voor XMP metagegevens aanroepen
Als u de XMP metagegevens wilt inspecteren, roept u de methode
exportMetadata
van het objectXMPUtilityServiceClient
aan en geeft u eencom.adobe.idp.Document
-object door dat het PDF-bestand vertegenwoordigt. De methode retourneert eenXMPUtilityMetadata
-object dat de opgehaalde metagegevens bevat.Als u de XMP metagegevens wilt ophalen en opslaan, roept u de methode
exportXMP
van het objectXMPUtilityServiceClient
aan en geeft u eencom.adobe.idp.Document
-object door dat het PDF-bestand vertegenwoordigt. De methode retourneert eencom.adobe.idp.Document
-object dat de opgehaalde metagegevens bevat. U kunt deze vervolgens als XML-bestand op schijf opslaan.
zie ook
Metagegevens exporteren uit PDF-documenten
Metagegevens XMP exporteren met de webservice-API export-xmp-metadata-using-the-web-service-api
Exporteer XMP metagegevens met behulp van de XMP Utilities API (webservice):
-
Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die het dossier van WSDL van de dienst van het XMP gebruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
Een XMPUtilityService-client maken
Maak een
XMPUtilityServiceService
-object met de constructor van de proxyklasse. -
De importbewerking voor XMP metagegevens aanroepen
Als u de XMP metagegevens wilt inspecteren, roept u de methode
exportMetadata
van het objectXMPUtilityServiceClient
aan en geeft u eenBLOB
-object door dat het PDF-bestand vertegenwoordigt. De methode retourneert eenXMPUtilityMetadata
-object dat de opgehaalde metagegevens bevat.Als u de XMP metagegevens wilt ophalen en opslaan, roept u de methode
exportXMP
van het objectXMPUtilityServiceClient
aan en geeft u eenBLOB
-object door dat het PDF-bestand vertegenwoordigt. De methode retourneert eenBLOB
-object dat de opgehaalde metagegevens bevat. U kunt deze vervolgens als XML-bestand op schijf opslaan.
zie ook
Metagegevens exporteren uit PDF-documenten
AEM Forms aanroepen met Base64-codering
Creërend een .NET cliëntassemblage die het coderen Base64 gebruikt