Gebruiksrechten toewijzen assigning-usage-rights
de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.
Over de Acrobat Reader DC-extensieservice about-the-acrobat-reader-dc-extensions-service
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. Voor informatie, zie Toepassend de Rechten van het Gebruik op de Documenten van de PDF.
- Gebruiksrechten verwijderen uit PDF-documenten. Voor informatie, zie Verwijderend de Rechten van het Gebruik van de Documenten van de PDF.
- Retrieve crediteurdetails. Voor informatie, zie het Terugwinnen van ReferentieInformatie.
Gebruiksrechten toepassen op PDF-documenten applying-usage-rights-to-pdf-documents
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
, die deel uitmaakt van de Java API, kunt u de parameter isModeFinal
van het object ReaderExtensionsOptionSpec
instellen op false
. Hierdoor worden de verwerkte formulieren niet bijgewerkt en verbeteren de prestaties. Als u niet bezorgd bent over het bijwerken van de verwerkte teller van de formulieren, wordt geadviseerd dat u de parameter isModeFinal
aan false
plaatst.Overzicht van de stappen summary-of-steps
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.
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt van de uitbreidingen van Acrobat Reader DC
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 API voor webservices voor Acrobat Reader DC-extensies gebruikt, maakt u een ReaderExtensionsServiceService
-object.
wint een document van PDF terug
Haal een PDF-document op 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.
specificeer gebruiksrechten 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.
pas gebruiksrechten op het document van de PDF toe
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.
sparen het recht-toegelaten document van PDF
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
Gebruiksrechten toepassen met de Java API apply-usage-rights-using-the-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.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
ReaderExtensionsServiceClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Een PDF-document ophalen.
- Maak 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. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Geef de gebruiksrechten op die u wilt toepassen.
- Maak een
UsageRights
-object dat gebruiksrechten vertegenwoordigt met behulp van de constructor ervan. - Roep voor elk gebruiksrecht een overeenkomende methode aan die tot het
UsageRights
-object behoort. Als u bijvoorbeeld het gebruiksrechtenableFormFillIn
wilt toevoegen, roept u de methodeUsageRights
objectenableFormFillIn
aan en geeft utrue
door. (Herhaal deze stap voor elk gebruiksrecht dat u wilt toepassen.)
- Maak een
-
Gebruiksrechten toepassen op het PDF-document.
-
Maak 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:- Het
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.
- Het
-
Pas gebruiksrechten toe op het PDF-document door de methode
applyUsageRights
van hetReaderExtensionsServiceClient
-object aan te roepen en de volgende waarden door te geven:- Het
com.adobe.idp.Document
-object dat het PDF-document bevat waarop gebruiksrechten worden 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
doorgeven.)
- Het
-
Het
ReaderExtensionsOptionSpec
-object dat uitvoeringsopties bevat.
De methode
applyUsageRights
retourneert eencom.adobe.idp.Document
-object dat het PDF-document met ingeschakelde rechten bevat. -
-
Sla het PDF-document waarvoor rechten zijn ingeschakeld op.
- Maak een
java.io.File
-object en controleer of de bestandsextensie .pdf is. - Roep de methode
copyToFile
van het objectcom.adobe.idp.Document
aan om de inhoud van het objectcom.adobe.idp.Document
naar het bestand te kopiëren (gebruik het objectcom.adobe.idp.Document
dat door de methodeapplyUsageRights
is geretourneerd).
- Maak een
zie ook
Gebruiksrechten toepassen op PDF-documenten
Snel starten (SOAP modus):gebruiksrechten toepassen met de Java API
Gebruiksrechten toepassen met de webservice-API apply-usage-rights-using-the-web-service-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. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Maak een
ReaderExtensionsServiceClient
-object met de standaardconstructor. -
Maak een
ReaderExtensionsServiceClient.Endpoint.Address
-object met deSystem.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
opgeeft.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetReaderExtensionsServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.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
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
-
Een PDF-document ophalen.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een PDF-document op te slaan waarop gebruiksrechten worden toegepast. - Maak een
System.IO.FileStream
-object door de constructor ervan 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 het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het object
BLOB
door de eigenschapMTOM
ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Geef de gebruiksrechten op die u wilt toepassen.
- Maak een
UsageRights
-object dat gebruiksrechten vertegenwoordigt met behulp van de constructor ervan. - Wijs voor elk gebruiksrecht de waarde
true
toe aan het overeenkomstige gegevenslid dat tot hetUsageRights
-object behoort. Als u bijvoorbeeld het gebruiksrechtenableFormFillIn
wilt toevoegen, wijst utrue
toe aan het gegevenslid van hetUsageRights
-objectenableFormFillIn
. (Herhaal deze stap voor elk gebruiksrecht dat u wilt toepassen.)
- Maak een
-
Gebruiksrechten toepassen op het PDF-document.
-
Maak 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
-object toe aan het gegevenslid van hetReaderExtensionsOptionSpec
objectusageRights
. -
Wijs een tekenreekswaarde toe die het bericht aangeeft dat een gebruiker ziet wanneer het PDF-document waarvoor rechten zijn ingeschakeld in Adobe Reader wordt geopend in het gegevenslid
message
van hetReaderExtensionsOptionSpec
-object. -
Pas gebruiksrechten toe op het PDF-document door de methode
applyUsageRights
van hetReaderExtensionsServiceClient
-object aan te roepen en de volgende waarden door te geven:- Het
BLOB
-object dat het PDF-document bevat waarop gebruiksrechten worden 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
doorgeven.)
- Het
-
Het
ReaderExtensionsOptionSpec
-object dat uitvoeringsopties bevat.
De methode
applyUsageRights
retourneert eenBLOB
-object dat het PDF-document met ingeschakelde rechten bevat. -
-
Sla het PDF-document waarvoor rechten zijn ingeschakeld op.
- Maak 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 wordt opgeslagen van het object
BLOB
dat door de methodeapplyUsageRights
is geretourneerd. Vul de bytearray met de waarde van het gegevenslidMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven. - Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode
Write
van het objectSystem.IO.BinaryWriter
aan te roepen en de bytearray door te geven.
- Maak een
zie ook
Gebruiksrechten verwijderen uit PDF-documenten removing-usage-rights-from-pdf-documents
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 summary_of_steps-1
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.
- Een PDF-document met ingeschakelde rechten ophalen.
- Gebruiksrechten verwijderen uit het PDF-document.
- Sla het PDF-document op.
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt van de uitbreidingen van Acrobat Reader DC
Voordat u een Acrobat Reader DC-extensieservicebewerking programmatisch kunt uitvoeren, moet u een client-object voor de Acrobat Reader DC-extensieservice maken. Maak een ReaderExtensionsServiceClient
-object als u de Java API gebruikt. Als u de API voor webservices voor Acrobat Reader DC-extensies gebruikt, maakt u een ReaderExtensionsServiceService
-object.
wint een recht-Toegelaten document van PDF terug
Haal een PDF-document met ingeschakelde rechten op om gebruiksrechten te verwijderen.
verwijdert gebruiksrechten uit het document van PDF
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.
sparen het document van de PDF
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
Gebruiksrechten verwijderen met de Java API remove-usage-rights-using-the-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.
Maak een
ReaderExtensionsServiceClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
Een PDF-document ophalen.
- Maak een
java.io.FileInputStream
-object dat het PDF-document waarvoor rechten zijn ingeschakeld, vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
Gebruiksrechten verwijderen uit het PDF-document.
Verwijder gebruiksrechten uit het PDF-document door de methode
removeUsageRights
van hetReaderExtensionsServiceClient
-object aan te roepen en hetcom.adobe.idp.Document
-object dat het voor rechten ingeschakelde PDF-document bevat, door te geven. Deze methode retourneert eencom.adobe.idp.Document
-object dat een PDF-document bevat dat geen gebruiksrechten heeft. -
Gebruiksrechten toepassen op het PDF-document.
- Maak een
java.io.File
-object en controleer of de bestandsextensie .PDF is. - Roep de methode
copyToFile
van het objectDocument
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methoderemoveUsageRights
is geretourneerd).
- Maak een
zie ook
Gebruiksrechten verwijderen uit PDF-documenten
Snel starten (SOAP modus): gebruiksrechten verwijderen uit een PDF-document met de Java API
Gebruiksrechten verwijderen met de webservice-API remove-usage-rights-using-the-web-service-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. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Maak een
ReaderExtensionsServiceClient
-object met de standaardconstructor. -
Maak een
ReaderExtensionsServiceClient.Endpoint.Address
-object met deSystem.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
opgeeft.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetReaderExtensionsServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.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
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
-
Een PDF-document ophalen.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om het voor rechten ingeschakelde PDF-document op te slaan waaruit gebruiksrechten worden verwijderd. - Maak een
System.IO.FileStream
-object door de constructor ervan 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 het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het object
BLOB
door de eigenschapMTOM
ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Gebruiksrechten verwijderen uit het PDF-document.
Verwijder gebruiksrechten uit het PDF-document door de methode
removeUsageRights
van hetReaderExtensionsServiceClient
-object aan te roepen en hetBLOB
-object dat het voor rechten ingeschakelde PDF-document bevat, door te geven. Deze methode retourneert eenBLOB
-object dat een PDF-document bevat dat geen gebruiksrechten heeft. -
Gebruiksrechten toepassen op het PDF-document.
- Maak een
System.IO.FileStream
-object 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 wordt opgeslagen van het object
BLOB
dat door de methoderemoveUsageRights
is geretourneerd. Vul de bytearray met de waarde van het gegevenslidMTOM
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven.
- Maak een
zie ook
Referentiegegevens ophalen retrieving-credential-information
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 summary_of_steps-2
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.
- Een PDF-document met ingeschakelde rechten ophalen.
- Haal informatie op over de referentie.
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, moet u ervoor zorgen dat u de proxybestanden opneemt.
creeer een voorwerp van de Cliënt van de uitbreidingen van Acrobat Reader DC
Voordat u een Acrobat Reader DC-extensieservicebewerking programmatisch kunt uitvoeren, moet u een client-object voor de Acrobat Reader DC-extensieservice maken. Maak een ReaderExtensionsServiceClient
-object als u de Java API gebruikt. Als u de API voor webservices voor Acrobat Reader DC-extensies gebruikt, maakt u een ReaderExtensionsServiceService
-object.
wint een recht-Toegelaten document van PDF terug
Haal een PDF-document met ingeschakelde rechten op 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.
wint informatie over de referentie terug
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
Crediteringsgegevens ophalen met de Java API retrieve-credential-information-using-the-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.
Maak een
ReaderExtensionsServiceClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
Een PDF-document ophalen.
- Maak een
java.io.FileInputStream
-object dat het PDF-document waarvoor rechten zijn ingeschakeld, vertegenwoordigt door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het voor rechten ingeschakelde PDF-document aangeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak 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 de methode
getDocumentUsageRights
van het objectReaderExtensionsServiceClient
aan te roepen en hetcom.adobe.idp.Document
-object door te geven dat het voor rechten ingeschakelde PDF-document bevat. Deze methode retourneert eenGetUsageRightsResult
-object dat referentie-informatie bevat. - Haal de datum op waarna de referentie niet meer geldig is door de methode
getNotAfter
van het objectGetUsageRightsResult
aan te roepen. Deze methode retourneert eenjava.util.Date
-object dat de datum vertegenwoordigt waarna de referentie niet meer geldig is. - Haal het bericht op dat in Adobe Reader wordt weergegeven wanneer het voor rechten ingeschakelde PDF-document wordt geopend door de methode
getMessage
van het objectGetUsageRightsResult
aan te roepen. 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 de methode
zie ook
Snel starten (SOAP modus): referentie-informatie ophalen met de Java API
Crediteringsgegevens ophalen met de webservice-API retrieve-credential-information-using-the-web-service-api
Retrificatiegegevens ophalen met de Acrobat Reader DC Extension API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Acrobat Reader DC Extension Client-object.
-
Maak een
ReaderExtensionsServiceClient
-object met de standaardconstructor. -
Maak een
ReaderExtensionsServiceClient.Endpoint.Address
-object met deSystem.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
opgeeft.) -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetReaderExtensionsServiceClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.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
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
-
Een PDF-document ophalen.
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een PDF-document op te slaan waarvoor rechten zijn ingeschakeld. - Maak 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 het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het object
BLOB
door de eigenschapMTOM
ervan toe te wijzen met de inhoud van de bytearray.
- Maak 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 de methode
getDocumentUsageRights
van het objectReaderExtensionsServiceClient
aan te roepen en hetcom.adobe.idp.Document
-object door te geven dat het voor rechten ingeschakelde PDF-document bevat. Deze methode retourneert eenGetUsageRightsResult
-object dat referentie-informatie bevat. - Haal de datum op waarna de referentie niet meer geldig is door de waarde van het
notAfter
-gegevenslid van hetGetUsageRightsResult
-object op te halen. Het gegevenstype van dit gegevenslid isSystem.DateTime
. - Haal het bericht op dat wordt weergegeven wanneer het PDF-document waarvoor rechten zijn ingeschakeld in Adobe Reader wordt geopend door de waarde van het
message
-gegevenslid van hetGetUsageRightsResult
-object op te halen. Het gegevenstype van dit gegevenslid is een tekenreeks. - Haal het aantal keren op dat de referentie wordt gebruikt door de waarde van het
useCount
-gegevenslid van hetGetUsageRightsResult
-object op te halen. 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 de methode
zie ook
AEM Forms aanroepen met SwaRef