Der Acrobat Reader DC Extensions-Dienst ermöglicht Ihrem Unternehmen die einfache Freigabe interaktiver PDF-Dokumente durch Erweiterung der Funktionalität von Adobe Reader. Der Acrobat Reader DC Extensions-Dienst unterstützt alle PDF-Dokumente bis einschließlich PDF 1.7 vollständig. Es funktioniert mit Adobe Reader 7.0 und höher. Der Dienst fügt einem PDF-Dokument Verwendungsrechte hinzu und aktiviert Funktionen, die normalerweise nicht verfügbar sind, wenn ein PDF-Dokument mit Adobe Reader geöffnet wird. Drittanbieterbenutzer benötigen keine zusätzliche Software oder Plug-Ins, um mit den Dokumenten mit aktivierten Benutzerrechten arbeiten zu können.
Sie können diese Aufgaben mit dem Acrobat Reader DC Extensions-Dienst ausführen:
Weitere Informationen zum Acrobat Reader DC Extensions-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Sie können Verwendungsrechte auf PDF-Dokumente mit der Acrobat Reader DC Extensions Java Client-API und dem Webdienst anwenden. Verwendungsrechte gelten für Funktionen, die standardmäßig in Acrobat, nicht jedoch in Adobe Reader zur Verfügung stehen, wie etwa die Möglichkeit, Kommentare zu einem Formular hinzuzufügen oder Formularfelder auszufüllen und das Formular zu speichern. PDF-Dokumente, auf die Verwendungsrechte angewandt wurden, werden als Dokumente mit aktivierten Verwendungsrechten bezeichnet. Benutzer, die ein Dokument mit aktivierten Verwendungsrechten in Adobe Reader öffnen, können Vorgänge durchführen, die für dieses spezifische Dokument aktiviert sind.
Beim Anwenden von Verwendungsrechten auf PDF-Dokumente mit der Methode applyUsageRights
, die Teil der Java-API ist, können Sie den Parameter isModeFinal
des Objekts ReaderExtensionsOptionSpec
auf false
setzen. Dadurch wird der Zähler für verarbeitete Formulare nicht aktualisiert und die Leistung verbessert. Wenn Sie den Zähler für verarbeitete Formulare nicht aktualisieren möchten, sollten Sie den Parameter isModeFinal
auf false
setzen.
Weitere Informationen zum Acrobat Reader DC Extensions-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
So wenden Sie Verwendungsrechte auf ein PDF-Dokument an:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Acrobat Reader DC Extensions-Client-Objekt erstellen
Um einen Acrobat Reader DC Extensions-Dienstvorgang programmgesteuert durchzuführen, müssen Sie ein Client-Objekt des Acrobat Reader DC Extensions-Dienstes erstellen. Wenn Sie die Acrobat Reader DC Extensions Java API verwenden, erstellen Sie ein ReaderExtensionsServiceClient
-Objekt. Wenn Sie die Acrobat Reader DC Extensions-Webdienst-API verwenden, erstellen Sie ein ReaderExtensionsServiceService
-Objekt.
PDF-Dokument abrufen
Sie müssen ein PDF-Dokument abrufen, um Verwendungsrechte anzuwenden. Für Rechte aktivierte PDF-Dokumente enthalten ein Wörterbuch mit Verwendungsrechten. Wenn Adobe Reader ein Dokument öffnet, das ein solches Wörterbuch enthält, aktiviert es nur die im Wörterbuch angegebenen Verwendungsrechte für dieses Dokument. Wenn das Dokument kein Wörterbuch mit Verwendungsrechten enthält, erstellt der Acrobat Reader DC Extensions-Dienst eines. Wenn der Acrobat Reader DC Extensions-Dienst bereits ein Wörterbuch enthält, überschreibt er vorhandene Verwendungsrechte mit den von Ihnen angegebenen. Das Wörterbuch gibt an, welche Verwendungsrechte aktiviert sind. Wenn ein Benutzer das Dokument in Adobe Reader öffnet, sind nur die im Wörterbuch angegebenen Verwendungsrechte zulässig.
Verwendungsrechte festlegen
Die Verwendungsrechte, die Sie festlegen können, werden durch eine Berechtigung festgelegt, die Sie bei Adobe Systems Incorporated erwerben. Berechtigungen bieten in der Regel die Berechtigung zum Festlegen einer Gruppe verwandter Verwendungsrechte, z. B. für interaktive Formulare. Jede Berechtigung bietet das Recht, eine bestimmte Anzahl von PDF-Dokumenten mit aktivierten Benutzerrechten zu erstellen. Eine Testberechtigung berechtigt zur Erstellung einer unbegrenzten Anzahl von Dokumenten.
Wenn Sie versuchen, ein Verwendungsrecht zuzuweisen, das in Ihrer Berechtigung nicht zulässig ist, verursachen Sie eine Ausnahme.
Verwendungsrechte auf das PDF-Dokument anwenden
Um Verwendungsrechte auf ein PDF-Dokument anzuwenden, verweisen Sie auf den Alias der Berechtigung, mit der Sie Verwendungsrechte anwenden (eine Berechtigung wird normalerweise während der Installation von AEM Forms installiert). Außerdem müssen Sie das PDF-Dokument angeben, auf das Verwendungsrechte angewendet werden. Weitere Informationen zum Konfigurieren einer Berechtigung finden Sie im Handbuch zum Installieren und Bereitstellen für Ihren Anwendungsserver.
Speichern des PDF-Dokuments mit aktivierten Verwendungsrechten
Nachdem der Acrobat Reader DC Extensions-Dienst Verwendungsrechte auf ein PDF-Dokument angewendet hat, können Sie das PDF-Dokument mit aktivierten Verwendungsrechten als PDF-Datei speichern.
Siehe auch
Verwendungsrechte mithilfe der Java-API anwenden
Verwendungsrechte mithilfe der Webdienst-API anwenden
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Acrobat Reader DC Extensions-Dienst-API
Anwenden von Verwendungsrechten auf ein PDF-Dokument mithilfe der Acrobat Reader DC Extensions API (Java):
Projektdateien einschließen
Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.ReaderExtensionsServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.PDF-Dokument abrufen
java.io.FileInputStream
-Objekt, das das PDF-Dokument darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Geben Sie die anzuwendenden Verwendungsrechte an.
UsageRights
-Objekt, das mithilfe des Konstruktors Verwendungsrechte darstellt.UsageRights
-Objekt gehört. Um beispielsweise das Verwendungsrecht enableFormFillIn
hinzuzufügen, rufen Sie die UsageRights
-Methode des Objekts enableFormFillIn
auf und übergeben Sie true
. (Wiederholen Sie diesen Schritt für jedes Verwendungsrecht, das angewendet werden soll.)Wenden Sie Verwendungsrechte auf das PDF-Dokument an.
Erstellen Sie ein Objekt ReaderExtensionsOptionSpec
, indem Sie den Konstruktor verwenden. Dieses Objekt enthält Laufzeitoptionen, die vom Acrobat Reader DC Extensions-Dienst benötigt werden. Beim Aufrufen dieses Konstruktors müssen Sie die folgenden Werte angeben:
UsageRights
-Objekt mit den auf das Dokument anzuwendenden Verwendungsrechten.Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die ReaderExtensionsServiceClient
-Objektmethode applyUsageRights
aufrufen und die folgenden Werte übergeben:
com.adobe.idp.Document
-Objekt, das das PDF-Dokument enthält, auf das Verwendungsrechte angewendet werden.null
übergeben.)Das ReaderExtensionsOptionSpec
-Objekt, das Laufzeitoptionen enthält.
Die applyUsageRights
-Methode gibt ein com.adobe.idp.Document
-Objekt zurück, das das PDF-Dokument mit aktivierten Rechten enthält.
Speichern Sie das PDF-Dokument mit aktivierten Verwendungsrechten.
java.io.File
-Objekt und stellen Sie sicher, dass die Dateierweiterung .pdf ist.copyToFile
-Methode des Objekts auf, um den Inhalt des com.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das com.adobe.idp.Document
-Objekt verwenden, das von der applyUsageRights
-Methode zurückgegeben wurde).com.adobe.idp.Document
Siehe auch
Verwendungsrechte auf PDF-Dokumente anwenden
Quick Beginn (SOAP-Modus):Verwendungsrechte mithilfe der Java-API anwenden
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Anwenden von Verwendungsrechten auf ein PDF-Dokument mithilfe der Acrobat Reader DC Extensions API (Webdienst):
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.
Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
Erstellen Sie ein ReaderExtensionsServiceClient
-Objekt mit dem Standardkonstruktor.
Erstellen Sie ein ReaderExtensionsServiceClient.Endpoint.Address
-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress
. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Stellen Sie sicher, dass Sie ?blob=mtom
angeben.)
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert des Felds ReaderExtensionsServiceClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Setzen Sie das Feld System.ServiceModel.BasicHttpBinding
des Objekts auf MessageEncoding
. WSMessageEncoding.Mtom
Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
den entsprechenden Kennwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den Konstantenwert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.PDF-Dokument abrufen
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern eines PDF-Dokuments verwendet, auf das Verwendungsrechte angewendet werden.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.System.IO.FileStream
-Methode des Objekts Read
aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.BLOB
-Objekt, indem Sie seine MTOM
-Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.Geben Sie die anzuwendenden Verwendungsrechte an.
UsageRights
-Objekt, das mithilfe des Konstruktors Verwendungsrechte darstellt.true
dem entsprechenden Datenmember zu, der zum UsageRights
-Objekt gehört. Um beispielsweise das Verwendungsrecht enableFormFillIn
hinzuzufügen, weisen Sie true
dem UsageRights
-Datenmember des Objekts enableFormFillIn
zu. (Wiederholen Sie diesen Schritt für jedes Verwendungsrecht, das angewendet werden soll.)Wenden Sie Verwendungsrechte auf das PDF-Dokument an.
Erstellen Sie ein Objekt ReaderExtensionsOptionSpec
, indem Sie den Konstruktor verwenden. Dieses Objekt enthält Laufzeitoptionen, die vom Acrobat Reader DC Extensions-Dienst benötigt werden.
Weisen Sie das UsageRights
-Objekt dem ReaderExtensionsOptionSpec
-Datenelement des Objekts usageRights
zu.
Weisen Sie dem Datenmember des Objekts message
einen Zeichenfolgenwert zu, der die Meldung angibt, die ein Benutzer beim Öffnen des PDF-Dokuments mit aktivierten Benutzerrechten in Adobe Reader sieht.ReaderExtensionsOptionSpec
Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die ReaderExtensionsServiceClient
-Objektmethode applyUsageRights
aufrufen und die folgenden Werte übergeben:
BLOB
-Objekt, das das PDF-Dokument enthält, auf das Verwendungsrechte angewendet werden.null
übergeben.)Das ReaderExtensionsOptionSpec
-Objekt, das Laufzeitoptionen enthält.
Die applyUsageRights
-Methode gibt ein BLOB
-Objekt zurück, das das PDF-Dokument mit aktivierten Rechten enthält.
Speichern Sie das PDF-Dokument mit aktivierten Verwendungsrechten.
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort des PDF-Dokuments mit aktivierten Benutzerrechten darstellt.BLOB
-Objekts speichert, das von der applyUsageRights
-Methode zurückgegeben wurde. Füllen Sie das Bytearray, indem Sie den Wert des BLOB
-Datenelements des Objekts MTOM
abrufen.System.IO.BinaryWriter
-Objekt, indem Sie den Konstruktor aufrufen und das System.IO.FileStream
-Objekt übergeben.Write
-Methode des Objekts aufrufen und das Bytearray übergeben.System.IO.BinaryWriter
Siehe auch
Verwendungsrechte auf PDF-Dokumente anwenden
Aufrufen von AEM Forms mit MTOM
Aufrufen von AEM Forms mit SwaRef
Sie können Verwendungsrechte aus einem Dokument mit aktivierten Benutzerrechten entfernen. Das Entfernen von Verwendungsrechten aus einem PDF-Dokument mit aktivierten Verwendungsrechten ist auch erforderlich, um andere AEM Forms-Vorgänge darauf auszuführen. Sie müssen beispielsweise ein PDF-Dokument digital signieren (bzw. zertifizieren), bevor Sie Verwendungsrechte festlegen. Wenn Sie daher Vorgänge für ein Dokument mit aktivierten Benutzerrechten ausführen möchten, müssen Sie Verwendungsrechte aus dem PDF-Dokument entfernen, andere Vorgänge wie das digitale Signieren des Dokuments ausführen und anschließend erneut Verwendungsrechte auf das Dokument anwenden.
Weitere Informationen zum Acrobat Reader DC Extensions-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
So entfernen Sie Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Acrobat Reader DC Extensions-Client-Objekt erstellen
Bevor Sie einen Acrobat Reader DC Extensions-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Acrobat Reader DC Extensions-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein ReaderExtensionsServiceClient
-Objekt. Wenn Sie die Acrobat Reader DC Extensions-Webdienst-API verwenden, erstellen Sie ein ReaderExtensionsServiceService
-Objekt.
Abrufen eines PDF-Dokuments mit aktivierten Verwendungsrechten
Rufen Sie ein PDF-Dokument mit aktivierten Benutzerrechten ab, um Verwendungsrechte zu entfernen.
Verwendungsrechte aus dem PDF-Dokument entfernen
Nachdem Sie ein PDF-Dokument mit aktivierten Verwendungsrechten abgerufen haben, können Sie Verwendungsrechte entfernen. Nachdem Sie Verwendungsrechte entfernt haben, verfügt das PDF-Dokument bei der Anzeige in Adobe Reader über keine zusätzlichen Funktionen.
PDF-Dokument speichern
Sie können das PDF-Dokument, das keine Verwendungsrechte mehr enthält, als PDF-Datei speichern. Nach dem Speichern als PDF-Datei kann das PDF-Dokument in Adobe Reader oder Acrobat angezeigt werden.
Siehe auch
Entfernen von Verwendungsrechten mit der Java-API
Entfernen von Verwendungsrechten mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Acrobat Reader DC Extensions-Dienst-API
Verwendungsrechte auf PDF-Dokumente anwenden
Entfernen Sie mithilfe der Acrobat Reader DC Extensions-API (Java) Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
Erstellen Sie ein ReaderExtensionsServiceClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
PDF-Dokument abrufen
java.io.FileInputStream
-Objekt, das das PDF-Dokument mit aktivierten Verwendungsrechten darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
Entfernen Sie Verwendungsrechte aus dem PDF-Dokument, indem Sie die ReaderExtensionsServiceClient
-Objektmethode removeUsageRights
aufrufen und das com.adobe.idp.Document
-Objekt übergeben, das das PDF-Dokument mit aktivierten Benutzerrechten enthält. Diese Methode gibt ein com.adobe.idp.Document
-Objekt zurück, das ein PDF-Dokument ohne Verwendungsrechte enthält.
Wenden Sie Verwendungsrechte auf das PDF-Dokument an.
java.io.File
-Objekt und stellen Sie sicher, dass die Dateierweiterung .PDF ist.copyToFile
-Methode des Objekts auf, um den Inhalt des Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document
-Objekt verwenden, das von der removeUsageRights
-Methode zurückgegeben wurde).Document
Siehe auch
Entfernen von Verwendungsrechten aus PDF-Dokumenten
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Entfernen Sie Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten mithilfe der Acrobat Reader DC Extensions API (Webdienst):
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.
Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
Erstellen Sie ein ReaderExtensionsServiceClient
-Objekt mit dem Standardkonstruktor.
Erstellen Sie ein ReaderExtensionsServiceClient.Endpoint.Address
-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress
. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Stellen Sie sicher, dass Sie ?blob=mtom
angeben.)
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert des Felds ReaderExtensionsServiceClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Setzen Sie das Feld System.ServiceModel.BasicHttpBinding
des Objekts auf MessageEncoding
. WSMessageEncoding.Mtom
Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
den entsprechenden Kennwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den Konstantenwert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.PDF-Dokument abrufen
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern des PDF-Dokuments verwendet, für das Verwendungsrechte entfernt wurden.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.Read
-Methode des Objekts aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben.System.IO.FileStream
BLOB
-Objekt, indem Sie seine MTOM
-Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
Entfernen Sie Verwendungsrechte aus dem PDF-Dokument, indem Sie die ReaderExtensionsServiceClient
-Objektmethode removeUsageRights
aufrufen und das BLOB
-Objekt übergeben, das das PDF-Dokument mit aktivierten Benutzerrechten enthält. Diese Methode gibt ein BLOB
-Objekt zurück, das ein PDF-Dokument ohne Verwendungsrechte enthält.
Wenden Sie Verwendungsrechte auf das PDF-Dokument an.
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Speicherort der PDF-Datei darstellt.BLOB
-Objekts speichert, das von der removeUsageRights
-Methode zurückgegeben wurde. Füllen Sie das Bytearray, indem Sie den Wert des BLOB
-Datenelements des Objekts MTOM
abrufen.System.IO.BinaryWriter
-Objekt, indem Sie den Konstruktor aufrufen und das System.IO.FileStream
-Objekt übergeben.Siehe auch
Entfernen von Verwendungsrechten aus PDF-Dokumenten
Aufrufen von AEM Forms mit MTOM
Aufrufen von AEM Forms mit SwaRef
Sie können Informationen über die Berechtigung abrufen, mit der Verwendungsrechte auf ein PDF-Dokument mit aktivierten Verwendungsrechten angewendet wurden. Durch Abrufen von Informationen zu einer Berechtigung können Sie Informationen abrufen, z. B. das Datum, nach dem das Zertifikat nicht mehr gültig ist.
Weitere Informationen zum Acrobat Reader DC Extensions-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
So rufen Sie Informationen über die Berechtigung ab, mit der Verwendungsrechte auf ein PDF-Dokument angewendet wurden:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Acrobat Reader DC Extensions-Client-Objekt erstellen
Bevor Sie einen Acrobat Reader DC Extensions-Dienstvorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt des Acrobat Reader DC Extensions-Dienstes erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein ReaderExtensionsServiceClient
-Objekt. Wenn Sie die Acrobat Reader DC Extensions-Webdienst-API verwenden, erstellen Sie ein ReaderExtensionsServiceService
-Objekt.
Abrufen eines PDF-Dokuments mit aktivierten Verwendungsrechten
Sie müssen ein PDF-Dokument mit aktivierten Benutzerrechten abrufen, um Informationen zur Berechtigung abrufen zu können. Sie können auch Informationen zu einer Berechtigung abrufen, indem Sie deren Alias angeben. Wenn Sie jedoch Informationen zu einer Berechtigung abrufen möchten, die zum Anwenden von Verwendungsrechten auf ein bestimmtes PDF-Dokument mit aktivierten Benutzerrechten verwendet wurde, müssen Sie das Dokument abrufen.
Informationen zur Berechtigung abrufen
Nachdem Sie ein PDF-Dokument mit aktivierten Verwendungsrechten abgerufen haben, können Sie Informationen zu den Berechtigungen abrufen, mit denen Verwendungsrechte darauf angewendet wurden. Sie können die folgenden Informationen zur Berechtigung abrufen:
Siehe auch
Entfernen von Verwendungsrechten mit der Java-API
Entfernen von Verwendungsrechten mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Acrobat Reader DC Extensions-Dienst-API
Abrufen von Anmeldeinformationen mithilfe der Acrobat Reader DC Extensions-API (Java):
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
Erstellen Sie ein ReaderExtensionsServiceClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
PDF-Dokument abrufen
java.io.FileInputStream
-Objekt, das das PDF-Dokument mit aktivierten Verwendungsrechten darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt, für das Rechte aktiviert sind.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
getDocumentUsageRights
-Methode des Objekts aufrufen und das com.adobe.idp.Document
-Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. ReaderExtensionsServiceClient
Diese Methode gibt ein GetUsageRightsResult
-Objekt zurück, das Anmeldeinformationen enthält.getNotAfter
-Methode des Objekts aufrufen. GetUsageRightsResult
Diese Methode gibt ein java.util.Date
-Objekt zurück, das das Datum darstellt, nach dem die Berechtigung nicht mehr gültig ist.GetUsageRightsResult
-Objektmethode getMessage
aufrufen. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Meldung darstellt.Siehe auch
Abrufen von Berechtigungsinformationen
Quick Beginn (SOAP-Modus): Abrufen von Anmeldeinformationen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Abrufen von Anmeldeinformationen mit der Acrobat Reader DC Extensions-API (Webdienst):
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.
Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
Erstellen Sie ein ReaderExtensionsServiceClient
-Objekt mit dem Standardkonstruktor.
Erstellen Sie ein ReaderExtensionsServiceClient.Endpoint.Address
-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress
. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
). Stellen Sie sicher, dass Sie ?blob=mtom
angeben.)
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert des Felds ReaderExtensionsServiceClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Setzen Sie das Feld System.ServiceModel.BasicHttpBinding
des Objekts auf MessageEncoding
. WSMessageEncoding.Mtom
Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
den entsprechenden Kennwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den Konstantenwert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.PDF-Dokument abrufen
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern eines PDF-Dokuments mit aktivierten Benutzerrechten verwendet.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments mit aktivierten Rechten und den Dateimodus darstellt, in dem die Datei geöffnet werden soll.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.Read
-Methode des Objekts aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben.System.IO.FileStream
BLOB
-Objekt, indem Sie seine MTOM
-Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
getDocumentUsageRights
-Methode des Objekts aufrufen und das com.adobe.idp.Document
-Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. ReaderExtensionsServiceClient
Diese Methode gibt ein GetUsageRightsResult
-Objekt zurück, das Anmeldeinformationen enthält.GetUsageRightsResult
-Datenelements des Objekts notAfter
abrufen. Der Datentyp dieses Datenelements ist System.DateTime
.GetUsageRightsResult
-Datenelements des Objekts message
abrufen. Der Datentyp dieses Datenelements ist eine Zeichenfolge.GetUsageRightsResult
-Datenelements des Objekts useCount
abrufen. Der Datentyp dieses Datenelements ist eine Ganzzahl.Siehe auch
Abrufen von Berechtigungsinformationen
Aufrufen von AEM Forms mit MTOM
Aufrufen von AEM Forms mit SwaRef