Tilldela användningsrättigheter assigning-usage-rights
Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.
Om Acrobat Reader DC-tilläggstjänsten about-the-acrobat-reader-dc-extensions-service
Med Acrobat Reader DC Extensions kan man enkelt utbyta interaktiva PDF-dokument genom att utöka funktionaliteten i Adobe Reader. Acrobat Reader DC-tilläggstjänsten stöder alla PDF-dokument, till och med PDF 1.7. Det fungerar med Adobe Reader 7.0 och senare. Tjänsten lägger till användarrättigheter i ett PDF-dokument och aktiverar funktioner som vanligtvis inte är tillgängliga när ett PDF-dokument öppnas med Adobe Reader. Tredjepartsanvändare behöver inte några extra program eller plugin-program för att kunna arbeta med upphovsrättsaktiverade dokument.
Du kan utföra följande uppgifter med hjälp av Acrobat Reader DC-tilläggstjänsten:
- Använd användarrättigheter för PDF-dokument. Mer information finns i Använda användningsrättigheter i PDF-dokument.
- Ta bort användningsrättigheter från PDF-dokument. Mer information finns i Ta bort användningsrättigheter från PDF-dokument.
- Hämta information om autentiseringsuppgifter. Mer information finns i Hämtar information om autentiseringsuppgifter.
Använda användningsbehörighet för PDF-dokument applying-usage-rights-to-pdf-documents
Du kan lägga till användarrättigheter i PDF-dokument med Acrobat Reader DC-tilläggens Java Client API och webbtjänst. Användningsrättigheterna gäller funktioner som är tillgängliga som standard i Acrobat men inte i Adobe Reader, t.ex. möjligheten att lägga till kommentarer i ett formulär eller att fylla i formulärfält och spara formuläret. PDF-dokument som har användarrättigheter är aktiverade. En användare som öppnar ett rättighetsaktiverat dokument i Adobe Reader kan utföra åtgärder som är aktiverade för det specifika dokumentet.
applyUsageRights
, som är en del av Java API:t, kan du ange parametern isModeFinal
för objektet ReaderExtensionsOptionSpec
till false
. Detta resulterar i att de bearbetade formulärräknarna inte uppdateras och att prestandan förbättras. Om du inte är orolig för att uppdatera räknaren för bearbetade formulär rekommenderar vi att du ställer in parametern isModeFinal
på false
.Sammanfattning av steg summary-of-steps
Gör så här om du vill lägga till användarrättigheter i ett PDF-dokument:
- Inkludera projektfiler.
- Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
- Hämta ett PDF-dokument.
- Ange användningsrättigheter att använda.
- Använd användningsbehörighet för PDF-dokumentet.
- Spara det rättighetsaktiverade PDF-dokumentet.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.
Skapa ett klientobjekt för Acrobat Reader DC-tillägg
Om du vill utföra en programstyrd Acrobat Reader DC extensions service-åtgärd måste du skapa ett klientobjekt för Acrobat Reader DC extensions-tjänsten. Om du använder Java API:t för Acrobat Reader DC-tillägg skapar du ett ReaderExtensionsServiceClient
-objekt. Om du använder webbtjänstens API för Acrobat Reader DC-tillägg skapar du ett ReaderExtensionsServiceService
-objekt.
Hämta ett PDF-dokument
Hämta ett PDF-dokument om du vill använda användningsrättigheter. PDF-dokument med aktiverade rättigheter innehåller en ordlista med användningsrättigheter. När Adobe Reader öppnar ett dokument som innehåller en sådan ordlista aktiveras de användningsrättigheter som anges i ordlistan endast för det dokumentet. Om dokumentet inte innehåller någon användarrättighetsordlista skapar Acrobat Reader DC-tjänsten en sådan. Om den redan innehåller en ordlista skriver Acrobat Reader DC-tilläggstjänsten över befintliga användningsrättigheter med de som du anger. Ordlistan anger vilka användarrättigheter som är aktiverade. När en användare öppnar dokumentet i Adobe Reader tillåts bara de användningsrättigheter som anges i ordlistan.
Ange användningsbehörighet att använda
Vilka användarrättigheter du kan ange avgörs av en inloggningsinformation som du köper från Adobe Systems Incorporated. Autentiseringsuppgifterna ger vanligtvis behörighet att ange en grupp användarrättigheter, t.ex. de som gäller interaktiva formulär. Varje inloggningsinformation ger rätt att skapa ett visst antal rättighetsaktiverade PDF-dokument. Med en utvärderingsautentisering får man rätt att skapa ett obegränsat antal utkast till dokument.
Använd användningsbehörighet för PDF-dokumentet
Om du vill tillämpa användarrättigheter på ett PDF-dokument refererar du till aliaset för de autentiseringsuppgifter som du använder för att tillämpa användarrättigheter (en autentiseringsuppgift installeras vanligtvis under installationen av AEM Forms). Du måste också ange det PDF-dokument som användarrättigheterna gäller för. Mer information om hur du konfigurerar en autentiseringsuppgift finns i installations- och distributionsguiden för programservern.
Spara dokumentet för PDF som aktiverats för rättigheter
När Acrobat Reader DC Extensions-tjänsten har tillämpat användarrättigheter på ett PDF-dokument kan du spara det rättighetsaktiverade PDF-dokumentet som en PDF-fil.
Se även
Använd användningsrättigheter med Java API
Använd användningsrättigheter med webbtjänstens API
Använd användningsrättigheter med Java API apply-usage-rights-using-the-java-api
Använd användarrättigheter för ett PDF-dokument med hjälp av Acrobat Reader DC Extensions API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler, som adobe-reader-extensions-client.jar, i Java-projektets klassökväg.
-
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
- Skapa ett
ServiceClientFactory
-objekt som innehåller anslutningsegenskaper. - Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess konstruktor och skickaServiceClientFactory
-objektet.
- Skapa ett
-
Hämta ett PDF-dokument.
- Skapa ett
java.io.FileInputStream
-objekt som representerar PDF-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet. - Skapa ett
com.adobe.idp.Document
-objekt med hjälp av dess konstruktor och skickajava.io.FileInputStream
-objektet.
- Skapa ett
-
Ange användningsrättigheter att använda.
- Skapa ett
UsageRights
-objekt som representerar användningsrättigheter med hjälp av konstruktorn. - Anropa en motsvarande metod som tillhör objektet
UsageRights
för varje användningsbehörighet som ska användas. Om du till exempel vill lägga till användningsrättighetenenableFormFillIn
anropar duUsageRights
-objektetsenableFormFillIn
-metod och skickartrue
. (Upprepa det här steget för varje användningsbehörighet).
- Skapa ett
-
Använd användningsbehörighet för PDF-dokumentet.
-
Skapa ett
ReaderExtensionsOptionSpec
-objekt med hjälp av dess konstruktor. Det här objektet innehåller körningsalternativ som krävs av Acrobat Reader DC-tilläggstjänsten. När du anropar den här konstruktorn måste du ange följande värden:- Objektet
UsageRights
som innehåller användningsrättigheterna som ska tillämpas på dokumentet. - Ett strängvärde som anger ett meddelande som en användare ser när det rättighetsaktiverade PDF-dokumentet öppnas i Adobe Reader 7.x. Meddelandet visas inte i Adobe Reader 8.0.
- Objektet
-
Använd användningsbehörighet för PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsapplyUsageRights
-metod och skicka följande värden:- Det
com.adobe.idp.Document
-objekt som innehåller det PDF-dokument som användningsrättigheterna tillämpas på. - Ett strängvärde som anger det alias för autentiseringsuppgiften som gör att du kan tillämpa användningsbehörighet.
- Ett strängvärde som anger motsvarande lösenordsvärde. (Den här parametern ignoreras för närvarande. Du kan skicka
null
.)
- Det
-
Objektet
ReaderExtensionsOptionSpec
som innehåller körningsalternativ.
Metoden
applyUsageRights
returnerar ettcom.adobe.idp.Document
-objekt som innehåller det rättighetsaktiverade PDF-dokumentet. -
-
Spara det rättighetsaktiverade PDF-dokumentet.
- Skapa ett
java.io.File
-objekt och kontrollera att filtillägget är .pdf. - Anropa
com.adobe.idp.Document
-objektetscopyToFile
-metod för att kopiera innehållet icom.adobe.idp.Document
-objektet till filen (se till att du använder detcom.adobe.idp.Document
-objekt som returnerades av metodenapplyUsageRights
).
- Skapa ett
Se även
Använda användningsbehörighet för PDF-dokument
Snabbstart (SOAP):Tillämpa användningsrättigheter med Java API
Använd användningsrättigheter med webbtjänstens API apply-usage-rights-using-the-web-service-api
Använd användarrättigheter för ett PDF-dokument med hjälp av Acrobat Reader DC Extensions API (webbtjänst):
-
Inkludera projektfiler.
Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Ersätt localhost
med IP-adressen för servern som är värd för AEM Forms. -
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
-
Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess standardkonstruktor. -
Skapa ett
ReaderExtensionsServiceClient.Endpoint.Address
-objekt med konstruktornSystem.ServiceModel.EndpointAddress
. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempelhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Se till att du anger?blob=mtom
.) -
Skapa ett
System.ServiceModel.BasicHttpBinding
-objekt genom att hämta värdet för fältetReaderExtensionsServiceClient.Endpoint.Binding
. Skicka returvärdet tillBasicHttpBinding
. -
Ställ in
System.ServiceModel.BasicHttpBinding
-objektetsMessageEncoding
-fält tillWSMessageEncoding.Mtom
. Detta värde garanterar att MTOM används. -
Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
- Tilldela användarnamnet för AEM formulär till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Tilldela motsvarande lösenordsvärde till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Tilldela konstantvärdet
HttpClientCredentialType.Basic
till fältetBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Tilldela konstantvärdet
BasicHttpSecurityMode.TransportCredentialOnly
till fältetBasicHttpBindingSecurity.Security.Mode
.
- Tilldela användarnamnet för AEM formulär till fältet
-
-
Hämta ett PDF-dokument.
- Skapa ett
BLOB
-objekt med hjälp av dess konstruktor. ObjektetBLOB
används för att lagra ett PDF-dokument som en användningsbehörighet används för. - Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i. - Skapa en bytearray som lagrar innehållet i objektet
System.IO.FileStream
. Du kan bestämma storleken på bytearrayen genom att hämtaSystem.IO.FileStream
-objektetsLength
-egenskap. - Fyll i bytearrayen med strömdata genom att anropa
System.IO.FileStream
-objektetsRead
-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas. - Fyll objektet
BLOB
genom att tilldela dessMTOM
-egenskap med innehållet i bytearrayen.
- Skapa ett
-
Ange användningsrättigheter att använda.
- Skapa ett
UsageRights
-objekt som representerar användningsrättigheter med hjälp av konstruktorn. - För varje användningsbehörighet som ska användas tilldelar du värdet
true
till motsvarande datamedlem som tillhör objektetUsageRights
. Om du till exempel vill lägga till användningsrättighetenenableFormFillIn
tilldelar dutrue
tillUsageRights
-objektetsenableFormFillIn
-datamedlem. (Upprepa det här steget för varje användningsbehörighet).
- Skapa ett
-
Använd användningsbehörighet för PDF-dokumentet.
-
Skapa ett
ReaderExtensionsOptionSpec
-objekt med hjälp av dess konstruktor. Det här objektet innehåller körningsalternativ som krävs av Acrobat Reader DC-tilläggstjänsten. -
Tilldela objektet
UsageRights
tillReaderExtensionsOptionSpec
-objektetsusageRights
-datamedlem. -
Tilldela ett strängvärde som anger meddelandet som en användare ser när det rättighetsaktiverade PDF-dokumentet öppnas i Adobe Reader till
message
-objektetsReaderExtensionsOptionSpec
-datamedlem. -
Använd användningsbehörighet för PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsapplyUsageRights
-metod och skicka följande värden:- Det
BLOB
-objekt som innehåller det PDF-dokument som användningsrättigheterna tillämpas på. - Ett strängvärde som anger det alias för autentiseringsuppgiften som gör att du kan tillämpa användningsbehörighet.
- Ett strängvärde som anger motsvarande lösenordsvärde. (Den här parametern ignoreras för närvarande. Du kan skicka
null
.)
- Det
-
Objektet
ReaderExtensionsOptionSpec
som innehåller körningsalternativ.
Metoden
applyUsageRights
returnerar ettBLOB
-objekt som innehåller det rättighetsaktiverade PDF-dokumentet. -
-
Spara det rättighetsaktiverade PDF-dokumentet.
- Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för det rättighetsaktiverade PDF-dokumentet. - Skapa en bytearray som lagrar datainnehållet för objektet
BLOB
som returnerades av metodenapplyUsageRights
. Fyll i bytearrayen genom att hämta värdet förBLOB
-objektetsMTOM
-datamedlem. - Skapa ett
System.IO.BinaryWriter
-objekt genom att anropa dess konstruktor och skickaSystem.IO.FileStream
-objektet. - Skriv bytearrayens innehåll till en PDF-fil genom att anropa
System.IO.BinaryWriter
-objektetsWrite
-metod och skicka bytearrayen.
- Skapa ett
Se även
Ta bort användningsrättigheter från PDF-dokument removing-usage-rights-from-pdf-documents
Du kan ta bort användarrättigheter från ett rättighetsaktiverat dokument. Det är också nödvändigt att ta bort användarrättigheter från ett PDF-dokument med aktiverade rättigheter för att kunna utföra andra AEM Forms-åtgärder på det. Du måste till exempel signera (eller certifiera) ett PDF-dokument digitalt innan du anger användningsbehörighet. Om du vill utföra åtgärder på ett rättighetsaktiverat dokument måste du därför ta bort användningsbehörighet från dokumentet i PDF, utföra andra åtgärder, t.ex. signera dokumentet digitalt och sedan återanvända användningsbehörighet för dokumentet.
Sammanfattning av steg summary_of_steps-1
Så här tar du bort användarrättigheter från ett PDF-dokument som har aktiverats för rättigheter:
- Inkludera projektfiler.
- Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
- Hämta ett rättighetsaktiverat PDF-dokument.
- Ta bort användningsrättigheter från PDF-dokumentet.
- Spara dokumentet PDF.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.
Skapa ett klientobjekt för Acrobat Reader DC-tillägg
Innan du programmässigt kan utföra en Acrobat Reader DC-tilläggstjänståtgärd måste du skapa ett klientobjekt för Acrobat Reader DC-tilläggstjänsten. Om du använder Java API skapar du ett ReaderExtensionsServiceClient
-objekt. Om du använder webbtjänstens API för Acrobat Reader DC-tillägg skapar du ett ReaderExtensionsServiceService
-objekt.
Hämta ett rättighetsaktiverat PDF-dokument
Hämta ett rättighetsaktiverat PDF-dokument för att ta bort användningsrättigheter.
Ta bort användningsrättigheter från PDF-dokumentet
När du har hämtat ett rättighetsaktiverat PDF-dokument kan du ta bort användningsrättigheterna. När du har tagit bort användningsrättigheterna har PDF-dokumentet inga ytterligare funktioner när det visas i Adobe Reader.
Spara PDF-dokumentet
Du kan spara det PDF-dokument som inte längre innehåller användningsrättigheter som en PDF-fil. När dokumentet har sparats som en PDF-fil kan det visas i Adobe Reader eller Acrobat.
Se även
Ta bort användningsrättigheter med Java API
Ta bort användningsrättigheter med webbtjänstens API
Inkludera AEM Forms Java-biblioteksfiler
Ta bort användningsrättigheter med Java API remove-usage-rights-using-the-java-api
Ta bort användarrättigheter från ett rättighetsaktiverat PDF-dokument med hjälp av Acrobat Reader DC Extensions API (Java):
-
Inkludera projektfiler.
Inkludera JAR-klientfiler, som adobe-reader-extensions-client.jar, i Java-projektets klassökväg.
-
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Hämta ett PDF-dokument.
- Skapa ett
java.io.FileInputStream
-objekt som representerar det rättighetsaktiverade PDF-dokumentet genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet. - Skapa ett
com.adobe.idp.Document
-objekt med hjälp av dess konstruktor och skickajava.io.FileInputStream
-objektet.
- Skapa ett
-
Ta bort användningsrättigheter från PDF-dokumentet.
Ta bort användningsrättigheter från PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsremoveUsageRights
-metod och skickacom.adobe.idp.Document
-objektet som innehåller det rättighetsaktiverade PDF-dokumentet. Den här metoden returnerar ettcom.adobe.idp.Document
-objekt som innehåller ett PDF-dokument som inte har användningsbehörighet. -
Använd användningsbehörighet för PDF-dokumentet.
- Skapa ett
java.io.File
-objekt och kontrollera att filtillägget är .PDF. - Anropa
Document
-objektetscopyToFile
-metod för att kopiera innehållet iDocument
-objektet till filen (se till att du använder detDocument
-objekt som returnerades av metodenremoveUsageRights
).
- Skapa ett
Se även
Ta bort användningsrättigheter från PDF-dokument
Snabbstart (SOAP läge): Ta bort användningsrättigheter från ett PDF-dokument med Java API
Ta bort användningsrättigheter med webbtjänstens API remove-usage-rights-using-the-web-service-api
Ta bort användningsrättigheter från ett rättighetsaktiverat PDF-dokument med Acrobat Reader DC Extensions API (webbtjänst):
-
Inkludera projektfiler.
Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Ersätt localhost
med IP-adressen för servern som är värd för AEM Forms. -
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
-
Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess standardkonstruktor. -
Skapa ett
ReaderExtensionsServiceClient.Endpoint.Address
-objekt med konstruktornSystem.ServiceModel.EndpointAddress
. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempelhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Se till att du anger?blob=mtom
.) -
Skapa ett
System.ServiceModel.BasicHttpBinding
-objekt genom att hämta värdet för fältetReaderExtensionsServiceClient.Endpoint.Binding
. Skicka returvärdet tillBasicHttpBinding
. -
Ställ in
System.ServiceModel.BasicHttpBinding
-objektetsMessageEncoding
-fält tillWSMessageEncoding.Mtom
. Detta värde garanterar att MTOM används. -
Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
- Tilldela användarnamnet för AEM formulär till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Tilldela motsvarande lösenordsvärde till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Tilldela konstantvärdet
HttpClientCredentialType.Basic
till fältetBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Tilldela konstantvärdet
BasicHttpSecurityMode.TransportCredentialOnly
till fältetBasicHttpBindingSecurity.Security.Mode
.
- Tilldela användarnamnet för AEM formulär till fältet
-
-
Hämta ett PDF-dokument.
- Skapa ett
BLOB
-objekt med hjälp av dess konstruktor. ObjektetBLOB
används för att lagra det rättighetsaktiverade PDF-dokumentet från vilket användningsrättigheterna tas bort. - Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i. - Skapa en bytearray som lagrar innehållet i objektet
System.IO.FileStream
. Du kan bestämma storleken på bytearrayen genom att hämtaSystem.IO.FileStream
-objektetsLength
-egenskap. - Fyll i bytearrayen med strömdata genom att anropa
System.IO.FileStream
-objektetsRead
-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas. - Fyll objektet
BLOB
genom att tilldela dessMTOM
-egenskap med innehållet i bytearrayen.
- Skapa ett
-
Ta bort användningsrättigheter från PDF-dokumentet.
Ta bort användningsrättigheter från PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsremoveUsageRights
-metod och skickaBLOB
-objektet som innehåller det rättighetsaktiverade PDF-dokumentet. Den här metoden returnerar ettBLOB
-objekt som innehåller ett PDF-dokument som inte har användningsbehörighet. -
Använd användningsbehörighet för PDF-dokumentet.
- Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen PDF. - Skapa en bytearray som lagrar datainnehållet för objektet
BLOB
som returnerades av metodenremoveUsageRights
. Fyll i bytearrayen genom att hämta värdet förBLOB
-objektetsMTOM
-datamedlem. - Skapa ett
System.IO.BinaryWriter
-objekt genom att anropa dess konstruktor och skickaSystem.IO.FileStream
-objektet.
- Skapa ett
Se även
Hämtar information om autentiseringsuppgifter retrieving-credential-information
Du kan hämta information om de autentiseringsuppgifter som användes för att tillämpa användarrättigheter på ett PDF-dokument med aktiverade rättigheter. Genom att hämta information om en autentiseringsuppgift, kan du få information som det datum efter vilket certifikatet inte längre är giltigt.
Sammanfattning av steg summary_of_steps-2
Så här hämtar du information om de autentiseringsuppgifter som användes för att tillämpa användarrättigheter på ett PDF-dokument:
- Inkludera projektfiler.
- Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
- Hämta ett rättighetsaktiverat PDF-dokument.
- Hämta information om autentiseringsuppgifterna.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.
Skapa ett klientobjekt för Acrobat Reader DC-tillägg
Innan du programmässigt kan utföra en Acrobat Reader DC-tilläggstjänståtgärd måste du skapa ett klientobjekt för Acrobat Reader DC-tilläggstjänsten. Om du använder Java API skapar du ett ReaderExtensionsServiceClient
-objekt. Om du använder webbtjänstens API för Acrobat Reader DC-tillägg skapar du ett ReaderExtensionsServiceService
-objekt.
Hämta ett rättighetsaktiverat PDF-dokument
Hämta ett rättighetsaktiverat PDF-dokument om du vill hämta information om autentiseringsuppgifterna. Du kan även hämta information om en autentiseringsuppgift genom att ange dess alias. Om du vill hämta information om en autentiseringsuppgift som användes för att tillämpa användarrättigheter på ett visst rättighetsaktiverat PDF-dokument måste du dock hämta dokumentet.
Hämta information om autentiseringsuppgifterna
När du har hämtat ett rättighetsaktiverat PDF-dokument kan du få information om de autentiseringsuppgifter som användes för att tillämpa användarrättigheter på det. Du kan få följande information om autentiseringsuppgifterna:
- Det meddelande som visas i Adobe Reader när dokumentet för aktiverade rättigheter öppnas i PDF.
- Det datum efter vilket autentiseringsuppgifterna inte längre är giltiga.
- Det datum före vilket autentiseringsuppgifterna inte är giltiga.
- De användningsrättigheter som har angetts för det här rättighetsaktiverade PDF-dokumentet.
- Antalet gånger som autentiseringsuppgifterna har använts.
Se även
Ta bort användningsrättigheter med Java API
Ta bort användningsrättigheter med webbtjänstens API
Hämta inloggningsinformation med Java API retrieve-credential-information-using-the-java-api
Hämta autentiseringsuppgifter med Acrobat Reader DC Extensions API (Java):
-
Inkludera projektfiler.
Inkludera JAR-klientfiler, som adobe-reader-extensions-client.jar, i Java-projektets klassökväg.
-
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Hämta ett PDF-dokument.
- Skapa ett
java.io.FileInputStream
-objekt som representerar det rättighetsaktiverade PDF-dokumentet genom att använda konstruktorn och skicka ett strängvärde som anger platsen för det rättighetsaktiverade PDF-dokumentet. - Skapa ett
com.adobe.idp.Document
-objekt med hjälp av dess konstruktor och skickajava.io.FileInputStream
-objektet.
- Skapa ett
-
Ta bort användningsrättigheter från PDF-dokumentet.
- Hämta information om de autentiseringsuppgifter som används för att tillämpa användningsrättigheter på PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsgetDocumentUsageRights
-metod och skickacom.adobe.idp.Document
-objektet som innehåller det rättighetsaktiverade PDF-dokumentet. Den här metoden returnerar ettGetUsageRightsResult
-objekt som innehåller autentiseringsuppgifter. - Hämta det datum efter vilket autentiseringsuppgifterna inte längre är giltiga genom att anropa
GetUsageRightsResult
-objektetsgetNotAfter
-metod. Den här metoden returnerar ettjava.util.Date
-objekt som representerar det datum efter vilket autentiseringsuppgifterna inte längre är giltiga. - Hämta det meddelande som visas i Adobe Reader när dokumentet med aktiverade rättigheter öppnas i PDF genom att anropa
GetUsageRightsResult
-objektetsgetMessage
-metod. Den här metoden returnerar ett strängvärde som representerar meddelandet.
- Hämta information om de autentiseringsuppgifter som används för att tillämpa användningsrättigheter på PDF-dokumentet genom att anropa
Se även
Hämtar information om autentiseringsuppgifter
Snabbstart (SOAP läge): Hämtar autentiseringsinformation med Java API
Hämta autentiseringsuppgifter med webbtjänstens API retrieve-credential-information-using-the-web-service-api
Hämta autentiseringsinformation med Acrobat Reader DC Extensions API (webbtjänst):
-
Inkludera projektfiler.
Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Ersätt localhost
med IP-adressen för servern som är värd för AEM Forms. -
Skapa ett klientobjekt för Acrobat Reader DC-tillägg.
-
Skapa ett
ReaderExtensionsServiceClient
-objekt med hjälp av dess standardkonstruktor. -
Skapa ett
ReaderExtensionsServiceClient.Endpoint.Address
-objekt med konstruktornSystem.ServiceModel.EndpointAddress
. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempelhttp://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Se till att du anger?blob=mtom
.) -
Skapa ett
System.ServiceModel.BasicHttpBinding
-objekt genom att hämta värdet för fältetReaderExtensionsServiceClient.Endpoint.Binding
. Skicka returvärdet tillBasicHttpBinding
. -
Ställ in
System.ServiceModel.BasicHttpBinding
-objektetsMessageEncoding
-fält tillWSMessageEncoding.Mtom
. Detta värde garanterar att MTOM används. -
Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
- Tilldela användarnamnet för AEM formulär till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Tilldela motsvarande lösenordsvärde till fältet
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Tilldela konstantvärdet
HttpClientCredentialType.Basic
till fältetBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Tilldela konstantvärdet
BasicHttpSecurityMode.TransportCredentialOnly
till fältetBasicHttpBindingSecurity.Security.Mode
.
- Tilldela användarnamnet för AEM formulär till fältet
-
-
Hämta ett PDF-dokument.
- Skapa ett
BLOB
-objekt med hjälp av dess konstruktor. ObjektetBLOB
används för att lagra ett rättighetsaktiverat PDF-dokument. - Skapa ett
System.IO.FileStream
-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det rättighetsaktiverade PDF-dokumentet och läget som filen ska öppnas i. - Skapa en bytearray som lagrar innehållet i objektet
System.IO.FileStream
. Du kan bestämma storleken på bytearrayen genom att hämtaSystem.IO.FileStream
-objektetsLength
-egenskap. - Fyll i bytearrayen med strömdata genom att anropa
System.IO.FileStream
-objektetsRead
-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas. - Fyll objektet
BLOB
genom att tilldela dessMTOM
-egenskap med innehållet i bytearrayen.
- Skapa ett
-
Ta bort användningsrättigheter från PDF-dokumentet.
- Hämta information om de autentiseringsuppgifter som används för att tillämpa användningsrättigheter på PDF-dokumentet genom att anropa
ReaderExtensionsServiceClient
-objektetsgetDocumentUsageRights
-metod och skickacom.adobe.idp.Document
-objektet som innehåller det rättighetsaktiverade PDF-dokumentet. Den här metoden returnerar ettGetUsageRightsResult
-objekt som innehåller autentiseringsuppgifter. - Hämta datumet efter vilket autentiseringsuppgifterna inte längre är giltiga genom att hämta värdet för
GetUsageRightsResult
-objektetsnotAfter
-datamedlem. Datatypen för denna datamedlem ärSystem.DateTime
. - Hämta meddelandet som visas när dokumentet för PDF som aktiverats för rättigheter öppnas i Adobe Reader genom att hämta värdet för
GetUsageRightsResult
-objektetsmessage
-datamedlem. Datatypen för den här datamedlemmen är en sträng. - Hämta antalet gånger som autentiseringsuppgiften används genom att hämta värdet för
GetUsageRightsResult
-objektetsuseCount
-datamedlem. Datatypen för den här datamedlemmen är ett heltal.
- Hämta information om de autentiseringsuppgifter som används för att tillämpa användningsrättigheter på PDF-dokumentet genom att anropa
Se även
Hämtar information om autentiseringsuppgifter