Zuweisen von Verwendungsrechten

Projektdateien einschließen

Fügen Sie Client-JAR-Dateien wie „adobe-reader-extensions-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.

Erstellen Sie ein Client-Objekt für Acrobat Reader DC-Erweiterungen.

• Erstellen Sie ein ServiceClientFactory-Objekt, das Verbindungseigenschaften enthält.
• Erstellen Sie ein ReaderExtensionsServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.

Rufen Sie ein PDF-Dokument ab.

• Erstellen Sie ein java.io.FileInputStream-Objekt, das das PDF-Dokument repräsentiert, indem Sie seinen 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.

Geben Sie die anzuwendenden Verwendungsrechte an.

• Erstellen Sie ein UsageRights-Objekt, das die Verwendungsrechte darstellt, mithilfe seines Konstruktors.
• Rufen Sie für jedes anzuwendende Verwendungsrecht eine entsprechende Methode auf, die zum UsageRights-Objekt gehört. Um beispielsweise das Verwendungsrecht enableFormFillIn hinzuzufügen, rufen Sie die Methode enableFormFillIn des UsageRights-Objekts auf und übergeben 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 für den Service „Acrobat Reader DC-Erweiterungen“ erforderlich sind. Beim Aufrufen dieses Konstruktors müssen Sie die folgenden Werte angeben:

  • Das UsageRights-Objekt, das die Verwendungsrechte enthält, die auf das Dokument angewendet werden sollen.
  • Ein Zeichenfolgenwert, der eine Meldung angibt, die ein Benutzer zu sehen bekommt, wenn das berechtigungsaktivierte PDF-Dokument in Adobe Reader 7.x geöffnet wird. Diese Meldung wird in Adobe Reader 8.0 nicht angezeigt.

• Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die Methode applyUsageRights des ReaderExtensionsServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

  • Das com.adobe.idp.Document-Objekt, das das PDF-Dokument enthält, auf das die Verwendungsrechte angewendet werden.
  • Ein Zeichenfolgenwert, der den Alias der Berechtigung angibt, dank derer Sie Verwendungsrechte anwenden können.
  • Ein Zeichenfolgenwert, der den entsprechenden Kennwortwert angibt. (Derzeit wird dieser Parameter ignoriert. Sie können null übergeben.)

• Das ReaderExtensionsOptionSpec-Objekt, das Laufzeitoptionen enthält.

Die Methode applyUsageRights gibt ein com.adobe.idp.Document-Objekt zurück, das das berechtigungsaktivierte PDF-Dokument enthält.

Speichern Sie das berechtigungsaktivierte PDF-Dokument.

• Erstellen Sie ein java.io.File-Objekt und stellen Sie sicher, dass die Dateierweiterung .pdf ist.
• Rufen Sie die Methode copyToFile des com.adobe.idp.Document-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 Methode applyUsageRights zurückgegeben wurde).

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.

NOTE

Ersetzen Sie localhost mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird.

Erstellen Sie ein Client-Objekt für Acrobat Reader DC-Erweiterungen.

• Erstellen Sie ein ReaderExtensionsServiceClient-Objekt, indem Sie seinen standardmäßigen Konstruktor verwenden.

• Erstellen Sie ein ReaderExtensionsServiceClient.Endpoint.Address-Objekt, indem Sie den System.ServiceModel.EndpointAddress-Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der die WSDL zu dem AEM Forms-Service angibt (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 durch Abrufen des Werts im ReaderExtensionsServiceClient.Endpoint.Binding-Feld. Wandeln Sie den Rückgabewert in BasicHttpBinding um.

• Legen Sie das MessageEncoding-Feld des System.ServiceModel.BasicHttpBinding-Objekts auf WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.

• Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:

  • Weisen Sie dem Feld ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
  • Weisen Sie dem Feld ReaderExtensionsServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den konstanten Wert BasicHttpSecurityMode.TransportCredentialOnly zu.

Rufen Sie ein PDF-Dokument ab.

• Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern eines PDF-Dokuments verwendet, auf das Verwendungsrechte angewendet werden.
• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen 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 Byte-Array, das den Inhalt des System.IO.FileStream-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Eigenschaft Length des System.IO.FileStream-Objekts abrufen.
• Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Methode Read des System.IO.FileStream-Objekts aufrufen. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Datenstromlänge.
• Füllen Sie das BLOB-Objekt, indem Sie seiner MTOM-Eigenschaft den Inhalt des Byte-Arrays zuweisen.

Geben Sie die anzuwendenden Verwendungsrechte an.

• Erstellen Sie ein UsageRights-Objekt, das Verwendungsrechte darstellt, indem Sie seinen Konstruktor verwenden.
• Weisen Sie für jedes anzuwendende Verwendungsrecht den Wert true dem entsprechenden Datenelement zu, das zum UsageRights-Objekt gehört. Um beispielsweise das enableFormFillIn-Verwendungsrecht hinzuzufügen, weisen Sie dem Datenelement enableFormFillIn des UsageRights-Objekts true 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 für den Service „Acrobat Reader DC-Erweiterungen“ erforderlich sind.

• Weisen Sie das UsageRights-Objekt dem Datenelement usageRights des ReaderExtensionsOptionSpec-Objekts zu.

• Weisen Sie dem Datenelement message des ReaderExtensionsOptionSpec-Objekts einen Zeichenfolgenwert zu, der die Meldung angibt, die ein Benutzer zu sehen bekommt, wenn das berechtigungsaktivierte PDF-Dokument in Adobe Reader geöffnet wird.

• Wenden Sie Verwendungsrechte auf das PDF-Dokument an, indem Sie die Methode applyUsageRights des ReaderExtensionsServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

  • Das BLOB-Objekt, das das PDF-Dokument enthält, auf das die Verwendungsrechte angewendet werden.
  • Ein Zeichenfolgenwert, der den Alias der Berechtigung angibt, dank derer Sie Verwendungsrechte anwenden können.
  • Ein Zeichenfolgenwert, der den entsprechenden Kennwortwert angibt. (Derzeit wird dieser Parameter ignoriert. Sie können null übergeben.)

• Das ReaderExtensionsOptionSpec-Objekt, das Laufzeitoptionen enthält.

Die Methode applyUsageRights gibt ein BLOB-Objekt zurück, das das berechtigungsaktivierte PDF-Dokument enthält.

Speichern Sie das berechtigungsaktivierte PDF-Dokument.

• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort des berechtigungsaktivierten PDF-Dokuments darstellt.
• Erstellen Sie ein Byte-Array, das den Dateninhalt des BLOB-Objekts speichert, das von der Methode applyUsageRights zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des MTOM-Datenelements des BLOB-Objekts abrufen.
• Erstellen Sie ein System.IO.BinaryWriter-Objekt, indem Sie seinen Konstruktor aufrufen und das System.IO.FileStream-Objekt übergeben.
• Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Methode Write des System.IO.BinaryWriter-Objekts aufrufen und das Byte-Array übergeben.

Schließen Sie Projektdateien ein.

Fügen Sie Client-JAR-Dateien wie „adobe-reader-extensions-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.

Erstellen Sie ein Client-Objekt für Acrobat Reader DC-Erweiterungen.

Erstellen Sie ein ReaderExtensionsServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

Rufen Sie ein PDF-Dokument ab.

• Erstellen Sie ein java.io.FileInputStream-Objekt, das das PDF-Dokument mit aktivierten Rechten darstellt, indem Sie seinen 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.

Entfernen der Verwendungsrechte aus dem PDF-Dokument.

Entfernen Sie die Verwendungsrechte aus dem PDF-Dokument, indem Sie die removeUsageRights-Methode des ReaderExtensionsServiceClient-Objekts aufrufen und das com.adobe.idp.Document-Objekt übergeben, das das PDF-Dokument mit aktivierten Berechtigungen 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.

• Erstellen Sie ein java.io.File-Objekt und stellen Sie sicher, dass die Dateierweiterung .pdf ist.
• Rufen Sie die copyToFile-Methode des Document-Objekts auf, um die Inhalte des Document-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das von der removeUsageRights-Methode zurückgegebene Document-Objekt verwenden).

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.

NOTE

Ersetzen Sie localhost mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird.

Erstellen Sie ein Client-Objekt für Acrobat Reader DC-Erweiterungen.

• Erstellen Sie ein ReaderExtensionsServiceClient-Objekt, indem Sie seinen standardmäßigen Konstruktor verwenden.

• Erstellen Sie ein ReaderExtensionsServiceClient.Endpoint.Address-Objekt, indem Sie den System.ServiceModel.EndpointAddress-Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der die WSDL zu dem AEM Forms-Service angibt (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 durch Abrufen des Werts im ReaderExtensionsServiceClient.Endpoint.Binding-Feld. Wandeln Sie den Rückgabewert in BasicHttpBinding um.

• Legen Sie das MessageEncoding-Feld des System.ServiceModel.BasicHttpBinding-Objekts auf WSMessageEncoding.Mtom fest. Dieser Wert stellt sicher, dass MTOM verwendet wird.

• Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:

  • Weisen Sie dem Feld ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
  • Weisen Sie dem Feld ReaderExtensionsServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Security.Mode den konstanten Wert BasicHttpSecurityMode.TransportCredentialOnly zu.

Rufen Sie ein PDF-Dokument ab.

• Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern des PDF-Dokuments verwendet, aus dem die Verwendungsrechte entfernt werden sollen.
• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus enthält, in dem die Datei geöffnet werden soll.
• Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die Length-Eigenschaft des System.IO.FileStream-Objekts abrufen.
• Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Read-Methode des System.IO.FileStream-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben.
• Füllen Sie das BLOB-Objekt mit den Inhalten des Byte-Arrays, indem Sie diese der MTOM-Eigenschaft des Objekts zuweisen.

Entfernen der Verwendungsrechte aus dem PDF-Dokument.

Entfernen Sie die Verwendungsrechte aus dem PDF-Dokument, indem Sie die removeUsageRights-Methode des ReaderExtensionsServiceClient-Objekts aufrufen und das BLOB-Objekt übergeben, das das PDF-Dokument mit aktivierten Berechtigungen 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.

• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie dessen Konstruktor aufrufen und eine Zeichenfolge übergeben, die den Speicherort der PDF-Datei darstellt.
• Erstellen Sie ein Byte-Array, das den Dateninhalt des von der Methode removeUsageRights zurückgegebenen BLOB-Objekts enthält. Füllen Sie das Byte-Array, indem Sie den Wert des MTOM-Datenelements des BLOB-Objekts abrufen.
• Erstellen Sie ein System.IO.BinaryWriter-Objekt, indem Sie dessen Konstruktor verwenden und das System.IO.FileStream-Objekt übergeben.

Schließen Sie Projektdateien ein.

Fügen Sie Client-JAR-Dateien wie „adobe-reader-extensions-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.

Erstellen Sie ein Client-Objekt für Acrobat Reader DC-Erweiterungen.

Erstellen Sie ein ReaderExtensionsServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

Rufen Sie ein PDF-Dokument ab.

• Erstellen Sie ein java.io.FileInputStream-Objekt, das das PDF-Dokument mit aktivierten Verwendungsrechten darstellt, indem Sie den Konstruktor des Objekts verwenden und eine Zeichenfolge übergeben, die 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.

Entfernen der Verwendungsrechte aus dem PDF-Dokument.

• Rufen Sie Informationen zu der Berechtigung ab, die zum Anwenden von Verwendungsrechten auf das PDF-Dokument verwendet wird, indem Sie die Methode getDocumentUsageRights des ReaderExtensionsServiceClient-Objekts aufrufen und das com.adobe.idp.Document-Objekt übergeben, das das PDF-Dokument enthält. Diese Methode gibt ein GetUsageRightsResult-Objekt mit Informationen zur Berechtigung zurück.
• Rufen Sie das Datum ab, nach dem die Berechtigung nicht mehr gültig ist, indem Sie die Methode getNotAfter des GetUsageRightsResult-Objekts aufrufen. Diese Methode gibt ein java.util.Date-Objekt zurück, das das Ablaufdatum der Berechtigung darstellt.
• Rufen Sie die Nachricht ab, die in Adobe Reader beim Öffnen des PDF-Dokuments mit aktivierten Verwendungsberechtigungen angezeigt wird, indem Sie die Methode getMessage des GetUsageRightsResult-Objekts aufrufen. Diese Methode gibt eine Zeichenfolge zurück, die die Nachricht darstellt.