Show Menu
THEMEN×

Verwendungsrechte zuweisen

Info zum Acrobat Reader DC Extensions-Dienst

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:
For more information about the Acrobat Reader DC extensions service, see Services Reference for AEM Forms .

Applying Usage Rights to PDF Documents

Mit der Java Client-API und dem Webdienst von Acrobat Reader DC Extensions können Sie Verwendungsrechte auf PDF-Dokumente 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 applyUsageRights Methode, die Teil der Java-API ist, können Sie den isModeFinal Parameter des ReaderExtensionsOptionSpec Objekts auf false festlegen. 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 isModeFinal Parameter auf false .
For more information about the Acrobat Reader DC extensions service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So wenden Sie Verwendungsrechte auf ein PDF-Dokument an:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
  3. PDF-Dokument abrufen.
  4. Geben Sie die anzuwendenden Verwendungsrechte an.
  5. Verwendungsrechte auf das PDF-Dokument anwenden
  6. Speichern Sie das PDF-Dokument mit aktivierten Berechtigungen.
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
Zum programmatischen Ausführen eines Vorgangs des Acrobat Reader DC Extensions-Dienstes müssen Sie ein Client-Objekt des Acrobat Reader DC Extensions-Dienstes erstellen. Wenn Sie die Java-API von Acrobat Reader DC Extensions 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, werden nur die im Wörterbuch angegebenen Verwendungsrechte für dieses Dokument aktiviert. 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 bestimmt, 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 Berechtigung für die Auswertung berechtigt zur Erstellung einer unbegrenzten Anzahl von Entwürfen 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 Berechtigungen als PDF-Datei speichern.
Siehe auch

Verwendungsrechte mithilfe der Java-API anwenden

Anwenden von Verwendungsrechten auf ein PDF-Dokument mithilfe der Acrobat Reader DC Extensions API (Java):
  1. Projektdateien einschließen
    Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    • Erstellen Sie ein ServiceClientFactory -" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie ein ReaderExtensionsServiceClient -Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory -Objekt übergeben.
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein 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.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Geben Sie die anzuwendenden Verwendungsrechte an.
    • Erstellen Sie ein UsageRights Objekt, das mithilfe des Konstruktors Verwendungsrechte darstellt.
    • Rufen Sie für jedes Verwendungsrecht eine entsprechende Methode auf, die zum UsageRights Objekt gehört. Um beispielsweise das enableFormFillIn Verwendungsrecht hinzuzufügen, rufen Sie die UsageRights Methode des enableFormFillIn Objekts auf und übergeben Sie es true . (Wiederholen Sie diesen Schritt für jedes anzuwendende Verwendungsrecht.)
  5. Verwendungsrechte auf das PDF-Dokument anwenden
    • 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:
      • Das UsageRights Objekt mit den auf das Dokument anzuwendenden Verwendungsrechten.
      • Ein Zeichenfolgenwert, der eine Meldung angibt, die ein Benutzer beim Öffnen des PDF-Dokuments mit aktivierten Benutzerrechten in Adobe Reader 7.x sieht. Diese Meldung wird in Adobe Reader 8.0 nicht angezeigt.
    • Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die ReaderExtensionsServiceClient applyUsageRights Objektmethode aufrufen und die folgenden Werte übergeben:
      • Das com.adobe.idp.Document Objekt, das das PDF-Dokument enthält, auf das Verwendungsrechte angewendet werden.
      • Ein Zeichenfolgenwert, der den Alias der Berechtigung angibt, mit dem Sie Verwendungsrechte anwenden können.
      • Ein Zeichenfolgenwert, der den entsprechenden Kennwortwert angibt. (Derzeit wird dieser Parameter ignoriert. Sie können bestehen null .)
    • 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 Berechtigungen enthält.
  6. Speichern Sie das PDF-Dokument mit aktivierten Berechtigungen.
    • Erstellen Sie ein java.io.File -Objekt und stellen Sie sicher, dass die Dateierweiterung .pdf ist.
    • Rufen Sie die com.adobe.idp.Document Methode des copyToFile 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).
Siehe auch

Verwendungsrechte mithilfe der Webdienst-API anwenden

Anwenden von Verwendungsrechten auf ein PDF-Dokument mithilfe der Acrobat Reader DC Extensions API (Webdienst):
  1. 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 dies localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    • Create a ReaderExtensionsServiceClient object by using its default constructor.
    • Create a ReaderExtensionsServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom ). Geben Sie ?blob=mtom an.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des ReaderExtensionsServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu ReaderExtensionsServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
      • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines PDF-Dokuments, auf das Verwendungsrechte angewendet werden.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode Read aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.
    • Füllen Sie das BLOB Objekt, indem Sie seine MTOM Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.
  4. Geben Sie die anzuwendenden Verwendungsrechte an.
    • Erstellen Sie ein UsageRights Objekt, das mithilfe des Konstruktors Verwendungsrechte darstellt.
    • Weisen Sie für jedes Verwendungsrecht den Wert true dem entsprechenden Datenmember zu, der zum UsageRights Objekt gehört. Um beispielsweise das enableFormFillIn Verwendungsrecht hinzuzufügen, weisen Sie es true dem UsageRights Datenmember des enableFormFillIn Objekts zu. (Wiederholen Sie diesen Schritt für jedes anzuwendende Verwendungsrecht.)
  5. Verwendungsrechte auf das PDF-Dokument anwenden
    • 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 Datenmember des Objekts zu usageRights .
    • Weisen Sie dem Datenmember des ReaderExtensionsOptionSpec Objekts einen Zeichenfolgenwert zu, der die Meldung angibt, die ein Benutzer beim Öffnen des PDF-Dokuments mit aktivierten Verwendungsrechten in Adobe Reader sieht message .
    • Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die ReaderExtensionsServiceClient applyUsageRights Objektmethode aufrufen und die folgenden Werte übergeben:
      • Das BLOB Objekt, das das PDF-Dokument enthält, auf das Verwendungsrechte angewendet werden.
      • Ein Zeichenfolgenwert, der den Alias der Berechtigung angibt, mit dem Sie Verwendungsrechte anwenden können.
      • Ein Zeichenfolgenwert, der den entsprechenden Kennwortwert angibt. (Derzeit wird dieser Parameter ignoriert. Sie können bestehen null .)
    • Das ReaderExtensionsOptionSpec Objekt, das Laufzeitoptionen enthält.
    Die applyUsageRights Methode gibt ein BLOB Objekt zurück, das das PDF-Dokument mit aktivierten Berechtigungen enthält.
  6. Speichern Sie das PDF-Dokument mit aktivierten Berechtigungen.
    • Create a System.IO.FileStream object by invoking its constructor. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort des PDF-Dokuments mit aktivierten Benutzerrechten darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der applyUsageRights Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Datenelements des MTOM Objekts abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die System.IO.BinaryWriter Objektmethode aufrufen und das Bytearray Write übergeben.
Siehe auch

Entfernen von Verwendungsrechten aus PDF-Dokumenten

Sie können Verwendungsrechte aus einem Dokument mit aktivierten Benutzerrechten entfernen. Das Entfernen von Verwendungsrechten aus einem PDF-Dokument mit aktivierten Verwendungsrechten ist ebenfalls 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.
For more information about the Acrobat Reader DC extensions service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So entfernen Sie Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
  3. Rufen Sie ein PDF-Dokument mit aktivierten Berechtigungen ab.
  4. Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
  5. Speichern Sie das PDF-Dokument.
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 Verwendungsrechten 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

Verwendungsrechte mit der Java-API entfernen

Entfernen Sie mithilfe der Acrobat Reader DC Extensions API (Java) Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    Erstellen Sie ein ReaderExtensionsServiceClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein 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.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
    Entfernen Sie Verwendungsrechte aus dem PDF-Dokument, indem Sie die ReaderExtensionsServiceClient Methode des removeUsageRights Objekts aufrufen und das com.adobe.idp.Document Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. Diese Methode gibt ein com.adobe.idp.Document Objekt zurück, das ein PDF-Dokument ohne Verwendungsrechte enthält.
  5. Verwendungsrechte auf das PDF-Dokument anwenden
    • Create a java.io.File object and ensure that the file extension is .PDF.
    • Rufen Sie die Document Methode des copyToFile 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).
Siehe auch

Entfernen von Verwendungsrechten mit der Webdienst-API

Entfernen Sie Verwendungsrechte aus einem PDF-Dokument mit aktivierten Verwendungsrechten mithilfe der Acrobat Reader DC Extensions-API (Webdienst):
  1. 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 dies localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    • Create a ReaderExtensionsServiceClient object by using its default constructor.
    • Create a ReaderExtensionsServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom ). Geben Sie ?blob=mtom an.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des ReaderExtensionsServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu ReaderExtensionsServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
      • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt wird zum Speichern des PDF-Dokuments mit aktivierten Verwendungsrechten verwendet, aus dem die Verwendungsrechte entfernt werden.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seine MTOM Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.
  4. Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
    Entfernen Sie Verwendungsrechte aus dem PDF-Dokument, indem Sie die ReaderExtensionsServiceClient Methode des removeUsageRights Objekts aufrufen und das BLOB Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. Diese Methode gibt ein BLOB Objekt zurück, das ein PDF-Dokument ohne Verwendungsrechte enthält.
  5. Verwendungsrechte auf das PDF-Dokument anwenden
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Speicherort der PDF-Datei darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der removeUsageRights Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Datenelements des MTOM Objekts abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
Siehe auch

Abrufen von Berechtigungsinformationen

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.
For more information about the Acrobat Reader DC extensions service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So rufen Sie Informationen über die Berechtigung ab, mit der Verwendungsrechte auf ein PDF-Dokument angewendet wurden:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
  3. Rufen Sie ein PDF-Dokument mit aktivierten Berechtigungen ab.
  4. Rufen Sie Informationen zur Berechtigung ab.
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 Berechtigungen abrufen, um Informationen zur Berechtigung abzurufen. 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 Verwendungsrechten 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 über die Berechtigung abrufen, mit der Verwendungsrechte darauf angewendet wurden. Sie können die folgenden Informationen zur Berechtigung abrufen:
  • Die Meldung, die in Adobe Reader angezeigt wird, wenn das PDF-Dokument mit aktivierten Berechtigungen geöffnet wird.
  • Das Datum, nach dem die Berechtigung nicht mehr gültig ist.
  • Das Datum, vor dem die Berechtigung nicht gültig ist.
  • Die Verwendungsrechte, die für dieses PDF-Dokument mit aktivierten Verwendungsrechten festgelegt wurden.
  • Die Häufigkeit, mit der die Berechtigung verwendet wurde.
Siehe auch

Berechtigungsinformationen mit der Java-API abrufen

Rufen Sie Anmeldeinformationen mit der Acrobat Reader DC Extensions-API (Java) ab:
  1. Schließen Sie Projektdateien ein.
    Schließen Sie Client-JAR-Dateien wie "adobe-reader-extensions-client.jar"im Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    Erstellen Sie ein ReaderExtensionsServiceClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das PDF-Dokument mit aktivierten Berechtigungen darstellt, indem Sie den Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments mit aktivierten Berechtigungen angibt.
    • Erstellen Sie ein com.adobe.idp.Document -Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream -Objekt übergeben.
  4. Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
    • Rufen Sie Informationen zu den Berechtigungen ab, die zum Anwenden von Verwendungsrechten auf das PDF-Dokument verwendet werden, indem Sie die ReaderExtensionsServiceClient Objektmethode aufrufen und das getDocumentUsageRights com.adobe.idp.Document Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. Diese Methode gibt ein GetUsageRightsResult Objekt zurück, das Anmeldeinformationen enthält.
    • Rufen Sie das Datum ab, nach dem die Berechtigung nicht mehr gültig ist, indem Sie die GetUsageRightsResult Objektmethode getNotAfter aufrufen. Diese Methode gibt ein java.util.Date Objekt zurück, das das Datum darstellt, nach dem die Berechtigung nicht mehr gültig ist.
    • Rufen Sie die Meldung ab, die in Adobe Reader angezeigt wird, wenn das PDF-Dokument mit aktivierten Berechtigungen geöffnet wird, indem Sie die GetUsageRightsResult Objektmethode getMessage aufrufen. Diese Methode gibt einen Zeichenfolgenwert zurück, der die Meldung darstellt.
Siehe auch

Abrufen von Anmeldeinformationen mithilfe der Webdienst-API

Abrufen von Anmeldeinformationen mit der Acrobat Reader DC Extensions-API (Webdienst):
  1. 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 dies localhost durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
  2. Erstellen Sie ein Acrobat Reader DC Extensions-Client-Objekt.
    • Erstellen Sie ein ReaderExtensionsServiceClient Objekt mit dem Standardkonstruktor.
    • Create a ReaderExtensionsServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Übergeben Sie einen Zeichenfolgenwert, der die WSDL angibt, an den AEM Forms-Dienst (z. B. http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom ). Geben Sie ?blob=mtom an.)
    • Erstellen Sie ein System.ServiceModel.BasicHttpBinding Objekt, indem Sie den Wert des ReaderExtensionsServiceClient.Endpoint.Binding Felds abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.
    • Legen Sie für das System.ServiceModel.BasicHttpBinding Objektfeld MessageEncoding den Wert WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.
    • Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
      • Weisen Sie dem Feld den AEM Forms-Benutzernamen zu ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName .
      • Weisen Sie dem Feld den entsprechenden Kennwortwert zu ReaderExtensionsServiceClient.ClientCredentials.UserName.Password .
      • Weisen Sie dem Feld den Konstantenwert HttpClientCredentialType.Basic zu BasicHttpBindingSecurity.Transport.ClientCredentialType .
      • Weisen Sie dem Feld den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zu BasicHttpBindingSecurity.Security.Mode .
  3. PDF-Dokument abrufen.
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt wird zum Speichern eines PDF-Dokuments mit aktivierten Benutzerrechten verwendet.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments mit aktivierten Berechtigungen und den Modus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seine MTOM Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.
  4. Entfernen Sie Verwendungsrechte aus dem PDF-Dokument.
    • Rufen Sie Informationen zu den Berechtigungen ab, die zum Anwenden von Verwendungsrechten auf das PDF-Dokument verwendet werden, indem Sie die ReaderExtensionsServiceClient Objektmethode aufrufen und das getDocumentUsageRights com.adobe.idp.Document Objekt übergeben, das das PDF-Dokument mit aktivierten Verwendungsrechten enthält. Diese Methode gibt ein GetUsageRightsResult Objekt zurück, das Anmeldeinformationen enthält.
    • Rufen Sie das Datum ab, nach dem die Berechtigung nicht mehr gültig ist, indem Sie den Wert des GetUsageRightsResult Datenelements des notAfter Objekts abrufen. Der Datentyp dieses Datenelements ist System.DateTime .
    • Rufen Sie die Meldung ab, die angezeigt wird, wenn das PDF-Dokument mit aktivierten Berechtigungen in Adobe Reader geöffnet wird, indem Sie den Wert des GetUsageRightsResult Datenelements des message Objekts abrufen. Der Datentyp dieses Datenelements ist eine Zeichenfolge.
    • Rufen Sie die Häufigkeit der Verwendung der Berechtigung ab, indem Sie den Wert des GetUsageRightsResult Datenelements des useCount Objekts abrufen. Der Datentyp dieses Datenelements ist eine Ganzzahl.
Siehe auch