Gebruiksrechten toewijzen
Gemaakt voor:
- Developer
Over de Acrobat Reader DC-extensieservice
Met de Acrobat Reader DC Extension Service kan uw organisatie eenvoudig interactieve PDF-documenten delen door de functionaliteit van Adobe Reader uit te breiden. De Acrobat Reader DC-extensieservice biedt volledige ondersteuning voor alle PDF-documenten, tot en met PDF 1.7. Het werkt met Adobe Reader 7.0 en hoger. De service voegt gebruiksrechten toe aan een PDF-document, waarbij functies worden geactiveerd die gewoonlijk niet beschikbaar zijn wanneer een PDF-document wordt geopend met Adobe Reader. Gebruikers van derden hebben geen extra software of plug-ins nodig om met documenten waarvoor rechten zijn ingeschakeld te kunnen werken.
U kunt deze taken uitvoeren met de Acrobat Reader DC-extensieservice:
- Gebruiksrechten toepassen op PDF-documenten. Zie voor meer informatie Gebruiksrechten toepassen op PDF-documenten.
- Gebruiksrechten verwijderen uit PDF-documenten. Zie voor meer informatie Gebruiksrechten verwijderen uit PDF-documenten.
- Crediteringsgegevens ophalen. Zie voor meer informatie Referentiegegevens ophalen.
Gebruiksrechten toepassen op PDF-documenten
U kunt gebruiksrechten toepassen op PDF-documenten met de Acrobat Reader DC Extension Java Client API en webservice. Gebruiksrechten hebben betrekking op functionaliteit die standaard beschikbaar is in Acrobat, maar niet in Adobe Reader, zoals de mogelijkheid om opmerkingen toe te voegen aan een formulier of formuliervelden in te vullen en het formulier op te slaan. PDF-documenten waarop gebruiksrechten zijn toegepast, worden documenten met ingeschakelde rechten genoemd. Een gebruiker die een document met ingeschakelde rechten opent in Adobe Reader, kan bewerkingen uitvoeren die zijn ingeschakeld voor dat specifieke document.
applyUsageRights
-methode, die onderdeel is van de Java API, kunt u de isModeFinal
parameter van de ReaderExtensionsOptionSpec
object naar false
. Hierdoor worden de verwerkte formulieren niet bijgewerkt en verbeteren de prestaties. Als u de verwerkte teller van de formulieren niet wilt bijwerken, kunt u het beste de instelling isModeFinal
parameter to false
.Overzicht van de stappen
Voer de volgende stappen uit om gebruiksrechten toe te passen op een PDF-document:
- Inclusief projectbestanden.
- Maak een Acrobat Reader DC Extension Client-object.
- Een PDF-document ophalen.
- Geef de gebruiksrechten op die u wilt toepassen.
- Gebruiksrechten toepassen op het PDF-document.
- Sla het PDF-document waarvoor rechten zijn ingeschakeld op.
Projectbestanden opnemen
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
Acrobat Reader DC-extensies maken voor clientobjecten
Als u programmatisch een Acrobat Reader DC Extension Service-bewerking wilt uitvoeren, moet u een Acrobat Reader DC Extension Service Client-object maken. Als u de Java API voor Acrobat Reader DC-extensies gebruikt, maakt u een ReaderExtensionsServiceClient
object. Als u de Acrobat Reader DC-API voor extensies gebruikt, maakt u een ReaderExtensionsServiceService
object.
Een PDF-document ophalen
U moet een PDF-document ophalen om gebruiksrechten toe te passen. PDF-documenten met ingeschakelde rechten bevatten een gebruiksrechtenwoordenboek. Wanneer Adobe Reader een document met een dergelijk woordenboek opent, worden alleen de gebruiksrechten ingeschakeld die in het woordenboek voor dat document zijn opgegeven. Als het document geen gebruiksrechtenwoordenboek bevat, wordt dit gemaakt door de Acrobat Reader DC Extension Service. Als het al een woordenboek bevat, overschrijft de Acrobat Reader DC-extensieservice bestaande gebruiksrechten met de gebruiksrechten die u opgeeft. In het woordenboek wordt opgegeven welke gebruiksrechten zijn ingeschakeld. Wanneer een gebruiker het document in Adobe Reader opent, zijn alleen de gebruiksrechten toegestaan die in het woordenboek zijn opgegeven.
Gebruiksrechten opgeven om toe te passen
De gebruiksrechten die u kunt instellen, worden bepaald door een referentie die u van Adobe Systems Incorporated koopt. Referenties geven doorgaans toestemming om een groep gerelateerde gebruiksrechten in te stellen, zoals rechten die betrekking hebben op interactieve formulieren. Elke referentie biedt het recht om een bepaald aantal PDF-documenten te maken waarvoor rechten zijn ingeschakeld. Een evaluatiereferentie geeft het recht om een onbeperkt aantal ontwerpdocumenten tot stand te brengen.
Gebruiksrechten toepassen op het PDF-document
Als u gebruiksrechten wilt toepassen op een PDF-document, verwijst u naar de alias van de referentie die u gebruikt om gebruiksrechten toe te passen (een referentie wordt meestal geïnstalleerd tijdens de installatie van AEM Forms). U moet ook het PDF-document opgeven waarop gebruiksrechten worden toegepast. Voor informatie over het vormen van een referentie, zie de het installeren en opstellen gids voor uw toepassingsserver.
PDF-document met ingeschakelde rechten opslaan
Nadat de service Acrobat Reader DC-extensies gebruiksrechten heeft toegepast op een PDF-document, kunt u het PDF-document waarvoor rechten zijn ingeschakeld opslaan als een PDF-bestand.
Zie ook
Gebruiksrechten toepassen met de Java API
Gebruiksrechten toepassen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Acrobat Reader DC Extensions Service API - Snel starten
Gebruiksrechten toepassen met de Java API
Gebruiksrechten toepassen op een PDF-document met de Acrobat Reader DC Extensions-API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-reader-extensions-client.jar, op in het klassenpad van uw Java-project.
-
Maak een Acrobat Reader DC Extension Client-object.
- Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
ReaderExtensionsServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
Een PDF-document ophalen.
- Een
java.io.FileInputStream
-object dat het PDF-document vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Een
com.adobe.idp.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
Geef de gebruiksrechten op die u wilt toepassen.
- Een
UsageRights
object dat gebruiksrechten vertegenwoordigt door de constructor ervan te gebruiken. - Voor elk gebruiksrecht om toe te passen, haalt een overeenkomstige methode aan die tot
UsageRights
object. Als u bijvoorbeeld de opdrachtenableFormFillIn
gebruiksrecht, deUsageRights
objectenableFormFillIn
methode en doorgeventrue
. (Herhaal deze stap voor elk gebruiksrecht dat u wilt toepassen.)
- Een
-
Gebruiksrechten toepassen op het PDF-document.
-
Een
ReaderExtensionsOptionSpec
object met behulp van de constructor. Dit object bevat runtime-opties die vereist zijn voor de Acrobat Reader DC-extensieservice. Wanneer u deze constructor oproept, moet u de volgende waarden opgeven:- De
UsageRights
-object dat de gebruiksrechten bevat die op het document moeten worden toegepast. - Een tekenreekswaarde die een bericht opgeeft dat wordt weergegeven wanneer het PDF-document waarvoor rechten zijn ingeschakeld, wordt geopend in Adobe Reader 7.x. Dit bericht wordt niet weergegeven in Adobe Reader 8.0.
- De
-
Gebruiksrechten toepassen op het PDF-document door het
ReaderExtensionsServiceClient
objectapplyUsageRights
en geeft de volgende waarden door:- De
com.adobe.idp.Document
object dat het PDF-document bevat waarop gebruiksrechten zijn toegepast. - Een tekenreekswaarde die de alias van de referentie opgeeft waarmee u gebruiksrechten kunt toepassen.
- Een tekenreekswaarde die de bijbehorende wachtwoordwaarde opgeeft. (Deze parameter wordt momenteel genegeerd. U kunt
null
.)
- De
-
De
ReaderExtensionsOptionSpec
object dat uitvoeringsopties bevat.
De
applyUsageRights
methode retourneert eencom.adobe.idp.Document
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. -
-
Sla het PDF-document waarvoor rechten zijn ingeschakeld op.
- Een
java.io.File
en zorg dat de bestandsextensie .pdf is. - De
com.adobe.idp.Document
objectcopyToFile
methode om de inhoud van decom.adobe.idp.Document
object naar het bestand (gebruik decom.adobe.idp.Document
object dat is geretourneerd door deapplyUsageRights
methode).
- Een
Zie ook
Gebruiksrechten toepassen op PDF-documenten
Snel starten (SOAP-modus):gebruiksrechten toepassen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Gebruiksrechten toepassen met de webservice-API
Gebruiksrechten toepassen op een PDF-document met de Acrobat Reader DC Extensions-API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.NOTE
Vervangenlocalhost
met het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Een
ReaderExtensionsServiceClient
object met de standaardconstructor. -
Een
ReaderExtensionsServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Zorg ervoor dat u?blob=mtom
.) -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenReaderExtensionsServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld naarWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld toe
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Een PDF-document ophalen.
- Een
BLOB
object met behulp van de constructor. DeBLOB
-object wordt gebruikt om een PDF-document op te slaan waarop gebruiksrechten worden toegepast. - Een
System.IO.FileStream
door de constructor aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
methode. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
eigenschap met de inhoud van de bytearray.
- Een
-
Geef de gebruiksrechten op die u wilt toepassen.
- Een
UsageRights
object dat gebruiksrechten vertegenwoordigt door de constructor ervan te gebruiken. - Wijs voor elk gebruiksrecht de waarde toe
true
aan het overeenkomstige gegevenslid dat totUsageRights
object. Als u bijvoorbeeld de opdrachtenableFormFillIn
gebruiksrecht toewijzentrue
aan deUsageRights
objectenableFormFillIn
lid. (Herhaal deze stap voor elk gebruiksrecht dat u wilt toepassen.)
- Een
-
Gebruiksrechten toepassen op het PDF-document.
-
Een
ReaderExtensionsOptionSpec
object met behulp van de constructor. Dit object bevat runtime-opties die vereist zijn voor de Acrobat Reader DC-extensieservice. -
Wijs het
UsageRights
aanReaderExtensionsOptionSpec
objectusageRights
lid. -
Wijs een koordwaarde toe die het bericht specificeert dat een gebruiker ziet wanneer het recht-toegelaten PDF document in Adobe Reader aan het
ReaderExtensionsOptionSpec
objectmessage
lid. -
Gebruiksrechten toepassen op het PDF-document door het
ReaderExtensionsServiceClient
objectapplyUsageRights
en geeft de volgende waarden door:- De
BLOB
object dat het PDF-document bevat waarop gebruiksrechten zijn toegepast. - Een tekenreekswaarde die de alias van de referentie opgeeft waarmee u gebruiksrechten kunt toepassen.
- Een tekenreekswaarde die de bijbehorende wachtwoordwaarde opgeeft. (Deze parameter wordt momenteel genegeerd. U kunt
null
.)
- De
-
De
ReaderExtensionsOptionSpec
object dat uitvoeringsopties bevat.
De
applyUsageRights
methode retourneert eenBLOB
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. -
-
Sla het PDF-document waarvoor rechten zijn ingeschakeld op.
- Een
System.IO.FileStream
object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het PDF-document waarvoor rechten zijn ingeschakeld. - Maak een bytearray waarin de gegevensinhoud van de
BLOB
object dat is geretourneerd door deapplyUsageRights
methode. Vul de bytearray met de waarde van deBLOB
objectMTOM
lid. - Een
System.IO.BinaryWriter
object door de constructor aan te roepen en deSystem.IO.FileStream
object. - Schrijf de inhoud van de bytearray naar een PDF-bestand door het
System.IO.BinaryWriter
objectWrite
en geeft u de bytearray door.
- Een
Zie ook
Gebruiksrechten toepassen op PDF-documenten
AEM Forms aanroepen met SwaRef
Gebruiksrechten verwijderen uit PDF-documenten
U kunt gebruiksrechten verwijderen uit een document waarvoor rechten zijn ingeschakeld. U moet ook gebruiksrechten verwijderen uit een PDF-document waarvoor rechten zijn ingeschakeld om andere AEM Forms-bewerkingen op het document uit te voeren. U moet bijvoorbeeld een PDF-document digitaal ondertekenen (of certificeren) voordat u gebruiksrechten instelt. Daarom als u verrichtingen op een recht-toegelaten document wilt uitvoeren, moet u gebruiksrechten uit het document van de PDF verwijderen, de andere verrichtingen uitvoeren, zoals digitaal het ondertekenen van het document, en dan gebruiksrechten op het document opnieuw toepassen.
Overzicht van de stappen
Voer de volgende stappen uit om gebruiksrechten te verwijderen uit een PDF-document waarvoor rechten zijn ingeschakeld:
- Inclusief projectbestanden.
- Maak een Acrobat Reader DC Extension Client-object.
- Hiermee wordt een PDF-document met ingeschakelde rechten opgehaald.
- Gebruiksrechten verwijderen uit het PDF-document.
- Sla het PDF-document op.
Projectbestanden opnemen
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
Acrobat Reader DC-extensies maken voor clientobjecten
Voordat u een Acrobat Reader DC-extensieservicebewerking programmatisch kunt uitvoeren, moet u een client-object voor de Acrobat Reader DC-extensieservice maken. Als u de Java API gebruikt, maakt u een ReaderExtensionsServiceClient
object. Als u de Acrobat Reader DC-API voor extensies gebruikt, maakt u een ReaderExtensionsServiceService
object.
Een PDF-document met ingeschakelde rechten ophalen
Haal een PDF-document met ingeschakelde rechten op om gebruiksrechten te verwijderen.
Gebruiksrechten verwijderen uit het PDF-document
Nadat u een voor rechten geschikt PDF-document hebt opgehaald, kunt u gebruiksrechten verwijderen. Nadat u gebruiksrechten hebt verwijderd, beschikt het PDF-document niet meer over extra functionaliteit wanneer het wordt weergegeven in Adobe Reader.
Het PDF-document opslaan
U kunt het PDF-document dat geen gebruiksrechten meer bevat, opslaan als een PDF-bestand. Als het document is opgeslagen als een PDF-bestand, kan het PDF-document worden weergegeven in Adobe Reader of Acrobat.
Zie ook
Gebruiksrechten verwijderen met de Java API
Gebruiksrechten verwijderen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Acrobat Reader DC Extensions Service API - Snel starten
Gebruiksrechten toepassen op PDF-documenten
Gebruiksrechten verwijderen met de Java API
Verwijder gebruiksrechten uit een PDF-document waarvoor rechten zijn ingeschakeld met de Acrobat Reader DC Extension API (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-reader-extensions-client.jar, op in het klassenpad van uw Java-project.
-
Maak een Acrobat Reader DC Extension Client-object.
Een
ReaderExtensionsServiceClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
Een PDF-document ophalen.
- Een
java.io.FileInputStream
-object dat staat voor het PDF-document waarvoor rechten zijn ingeschakeld, met behulp van de constructor en door middel van een tekenreekswaarde die de locatie van het PDF-document aangeeft. - Een
com.adobe.idp.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
Gebruiksrechten verwijderen uit het PDF-document.
Gebruiksrechten uit het PDF-document verwijderen door het
ReaderExtensionsServiceClient
objectremoveUsageRights
en het doorgeven van decom.adobe.idp.Document
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. Deze methode retourneert eencom.adobe.idp.Document
object dat een PDF-document bevat dat geen gebruiksrechten heeft. -
Gebruiksrechten toepassen op het PDF-document.
- Een
java.io.File
-object en controleer of de bestandsextensie .PDF is. - De
Document
objectcopyToFile
methode om de inhoud van deDocument
object naar het bestand (gebruik deDocument
object dat is geretourneerd door deremoveUsageRights
methode).
- Een
Zie ook
Gebruiksrechten verwijderen uit PDF-documenten
Snel starten (SOAP-modus): Gebruiksrechten verwijderen uit een PDF-document met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Gebruiksrechten verwijderen met de webservice-API
Verwijder gebruiksrechten uit een PDF-document waarvoor rechten zijn ingeschakeld met de Acrobat Reader DC Extension API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.NOTE
Vervangenlocalhost
met het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Een
ReaderExtensionsServiceClient
object met de standaardconstructor. -
Een
ReaderExtensionsServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Zorg ervoor dat u?blob=mtom
.) -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenReaderExtensionsServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld naarWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld toe
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Een PDF-document ophalen.
- Een
BLOB
object met behulp van de constructor. DeBLOB
-object wordt gebruikt om het PDF-document met ingeschakelde rechten op te slaan waaruit gebruiksrechten worden verwijderd. - Een
System.IO.FileStream
door de constructor aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
en geeft u de bytearray, de startpositie en de streamlengte door die u wilt lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
eigenschap met de inhoud van de bytearray.
- Een
-
Gebruiksrechten verwijderen uit het PDF-document.
Gebruiksrechten uit het PDF-document verwijderen door het
ReaderExtensionsServiceClient
objectremoveUsageRights
en het doorgeven van deBLOB
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. Deze methode retourneert eenBLOB
object dat een PDF-document bevat dat geen gebruiksrechten heeft. -
Gebruiksrechten toepassen op het PDF-document.
- Een
System.IO.FileStream
door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de locatie van het PDF-bestand vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud van de
BLOB
object dat is geretourneerd door deremoveUsageRights
methode. Vul de bytearray met de waarde van deBLOB
objectMTOM
lid. - Een
System.IO.BinaryWriter
object door de constructor aan te roepen en deSystem.IO.FileStream
object.
- Een
Zie ook
Gebruiksrechten verwijderen uit PDF-documenten
AEM Forms aanroepen met SwaRef
Referentiegegevens ophalen
U kunt informatie ophalen over de referentie die is gebruikt om gebruiksrechten toe te passen op een PDF-document waarvoor gebruiksrechten zijn ingeschakeld. Door informatie over een referentie op te halen, kunt u informatie zoals de datum opvragen waarna het certificaat niet meer geldig is.
Overzicht van de stappen
Voer de volgende stappen uit om informatie op te halen over de referentie die is gebruikt om gebruiksrechten toe te passen op een PDF-document:
- Inclusief projectbestanden.
- Maak een Acrobat Reader DC Extension Client-object.
- Hiermee wordt een PDF-document met ingeschakelde rechten opgehaald.
- Haal informatie op over de referentie.
Projectbestanden opnemen
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
Acrobat Reader DC-extensies maken voor clientobjecten
Voordat u een Acrobat Reader DC-extensieservicebewerking programmatisch kunt uitvoeren, moet u een client-object voor de Acrobat Reader DC-extensieservice maken. Als u de Java API gebruikt, maakt u een ReaderExtensionsServiceClient
object. Als u de Acrobat Reader DC-API voor extensies gebruikt, maakt u een ReaderExtensionsServiceService
object.
Een PDF-document met ingeschakelde rechten ophalen
U moet een voor rechten geschikt PDF-document ophalen om informatie over de referentie op te halen. U kunt informatie over een referentie ook terugwinnen door zijn alias te specificeren; nochtans, als u informatie over een referentie wilt terugwinnen die werd gebruikt om gebruiksrechten op een specifiek recht-toegelaten document van de PDF toe te passen, dan moet u het document terugwinnen.
Informatie over de referentie ophalen
Nadat u een voor rechten geschikt document van de PDF terugwint, kunt u informatie over de referentie verkrijgen die werd gebruikt om gebruiksrechten op het toe te passen. U kunt de volgende informatie over de referentie verkrijgen:
- Het bericht dat in Adobe Reader wordt weergegeven wanneer het voor rechten ingeschakelde PDF-document wordt geopend.
- De datum waarna de referentie niet langer geldig is.
- De datum vóór welke de referentie niet geldig is.
- De gebruiksrechten die zijn ingesteld voor dit PDF-document waarvoor rechten zijn ingeschakeld.
- Het aantal keren dat de referentie is gebruikt.
Zie ook
Gebruiksrechten verwijderen met de Java API
Gebruiksrechten verwijderen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Acrobat Reader DC Extensions Service API - Snel starten
Crediteringsgegevens ophalen met de Java API
Retrireer referentie-informatie met de Acrobat Reader DC Extension API (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-reader-extensions-client.jar, op in het klassenpad van uw Java-project.
-
Maak een Acrobat Reader DC Extension Client-object.
Een
ReaderExtensionsServiceClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
Een PDF-document ophalen.
- Een
java.io.FileInputStream
-object dat het PDF-document waarvoor rechten zijn ingeschakeld vertegenwoordigt met behulp van de constructor en door een tekenreekswaarde door te geven die de locatie van het voor rechten ingeschakelde PDF-document aangeeft. - Een
com.adobe.idp.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
Gebruiksrechten verwijderen uit het PDF-document.
- Haal informatie op over de referentie die wordt gebruikt om gebruiksrechten toe te passen op het PDF-document door het
ReaderExtensionsServiceClient
objectgetDocumentUsageRights
en het doorgeven van decom.adobe.idp.Document
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. Deze methode retourneert eenGetUsageRightsResult
object dat referentie-informatie bevat. - Haal de datum terug waarna de referentie niet meer geldig is door de
GetUsageRightsResult
objectgetNotAfter
methode. Deze methode retourneert eenjava.util.Date
object dat staat voor de datum waarna de referentie niet meer geldig is. - Hiermee wordt het bericht opgehaald dat in Adobe Reader wordt weergegeven wanneer het voor rechten ingeschakelde PDF-document wordt geopend door het
GetUsageRightsResult
objectgetMessage
methode. Deze methode retourneert een tekenreekswaarde die het bericht vertegenwoordigt.
- Haal informatie op over de referentie die wordt gebruikt om gebruiksrechten toe te passen op het PDF-document door het
Zie ook
Snel starten (SOAP-modus): Crediteringsgegevens ophalen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Crediteringsgegevens ophalen met de webservice-API
Retrificatiegegevens ophalen met de Acrobat Reader DC Extension API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.NOTE
Vervangenlocalhost
met het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Een
ReaderExtensionsServiceClient
object met de standaardconstructor. -
Een
ReaderExtensionsServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Zorg ervoor dat u?blob=mtom
.) -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenReaderExtensionsServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld naarWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld toe
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Een PDF-document ophalen.
- Een
BLOB
object met behulp van de constructor. DeBLOB
-object wordt gebruikt om een PDF-document met ingeschakelde rechten op te slaan. - Een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het PDF-document waarvoor rechten zijn ingeschakeld en de modus waarin het bestand moet worden geopend. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
en geeft u de bytearray, de startpositie en de streamlengte door die u wilt lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
eigenschap met de inhoud van de bytearray.
- Een
-
Gebruiksrechten verwijderen uit het PDF-document.
- Haal informatie op over de referentie die wordt gebruikt om gebruiksrechten toe te passen op het PDF-document door het
ReaderExtensionsServiceClient
objectgetDocumentUsageRights
en het doorgeven van decom.adobe.idp.Document
-object dat het PDF-document bevat waarvoor rechten zijn ingeschakeld. Deze methode retourneert eenGetUsageRightsResult
object dat referentie-informatie bevat. - Haal de datum op waarna de referentie niet meer geldig is door de waarde van de
GetUsageRightsResult
objectnotAfter
lid. Het gegevenstype van dit gegevenslid isSystem.DateTime
. - Hiermee wordt het bericht opgehaald dat wordt weergegeven wanneer het PDF-document waarvoor rechten zijn ingeschakeld in Adobe Reader wordt geopend door de waarde van het dialoogvenster
GetUsageRightsResult
objectmessage
lid. Het gegevenstype van dit gegevenslid is een tekenreeks. - Hiermee wordt het aantal keren opgehaald dat de referentie wordt gebruikt door de waarde van de
GetUsageRightsResult
objectuseCount
lid. Het gegevenstype van dit gegevenslid is een geheel getal.
- Haal informatie op over de referentie die wordt gebruikt om gebruiksrechten toe te passen op het PDF-document door het