Rendern von Rights-aktiviertem Forms

Der Forms-Dienst kann Formulare wiedergeben, auf die Verwendungsrechte angewendet wurden. 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. Forms, auf die Verwendungsrechte angewendet wurden, werden als Formulare mit aktivierten Verwendungsrechten bezeichnet. Ein Benutzer, der ein Formular mit aktivierten Benutzerrechten in Adobe Reader öffnet, kann Vorgänge durchführen, die für dieses Formular aktiviert sind.

Um Verwendungsrechte auf ein Formular anzuwenden, muss der Acrobat Reader DC Extensions-Dienst Teil Ihrer AEM Forms-Installation sein. Außerdem müssen Sie über gültige Berechtigungen verfügen, mit denen Sie Verwendungsrechte auf PDF-Dokumente anwenden können. Das heißt, Sie müssen den Acrobat Reader DC Extensions-Dienst ordnungsgemäß konfigurieren, bevor Sie ein Formular mit aktivierten Rechten wiedergeben können. (Siehe Informationen zum Acrobat Reader DC Extensions-Dienst.

HINWEIS

Um ein Formular wiederzugeben, das Verwendungsrechte enthält, müssen Sie eine XDP-Datei als Eingabe und keine PDF-Datei verwenden. Wenn Sie eine PDF-Datei als Eingabe verwenden, wird das Formular weiterhin wiedergegeben. Es handelt sich jedoch nicht um ein Formular mit aktivierten Rechten.

HINWEIS

Sie können ein Formular nicht mit XML-Daten vorab ausfüllen, wenn Sie die folgenden Verwendungsrechte angeben: enableComments, enableCommentsOnline, enableEmbeddedFilesoder enableDigitalSignatures. (Siehe Vorausfüllen von Forms mit flexiblen Layouts.

HINWEIS

Weitere Informationen zum Forms-Dienst finden Sie unter Dienstreferenz für AEM Forms.

Zusammenfassung der Schritte

Um ein Formular mit aktivierten Rechten wiederzugeben, führen Sie die folgenden Aufgaben aus:

  1. Projektdateien einschließen.
  2. Erstellen Sie ein Forms Client-API-Objekt.
  3. Legen Sie Laufzeitoptionen für Nutzungsrechte fest.
  4. Wiedergabe eines Formulars mit aktivierten Verwendungsrechten.
  5. Schreiben Sie das Formular mit aktivierten Berechtigungen in den Client-Webbrowser.

Projektdateien einschließen

Fügen 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 Proxy-Dateien einschließen.

Erstellen eines Forms Client-API-Objekts

Bevor Sie einen Client-API-Vorgang für den Forms-Dienst programmgesteuert ausführen können, müssen Sie einen Forms-Dienstclient erstellen.

Laufzeitoptionen für Verwendungsrechte festlegen

Sie müssen Laufzeitoptionen für Nutzungsrechte festlegen, um ein Formular mit aktivierten Verwendungsrechten wiederzugeben. Sie müssen auch den Alias der Berechtigung angeben, die zum Anwenden von Verwendungsrechten auf ein Formular verwendet wird. Nachdem Sie den Alias-Wert angegeben haben, geben Sie jedes Nutzungsrecht an, das auf das Formular angewendet werden soll.

Wiedergabe eines Formulars mit aktivierten Verwendungsrechten

Um ein Formular mit aktivierten Benutzerrechten wiederzugeben, verwenden Sie dieselbe Anwendungslogik wie die Wiedergabe eines Formulars ohne Verwendungsrechte. Der einzige Unterschied besteht darin, dass Sie sicherstellen müssen, dass die Laufzeitoptionen für Nutzungsrechte in Ihrer Anwendungslogik enthalten sind.

HINWEIS

Bei der Wiedergabe eines Formulars mit aktivierten Rechten mithilfe der Forms-Webdienst-API können Sie keine Dateien an das Formular anhängen.

Schreiben Sie den Formulardaten-Stream in den Client-Webbrowser

Wenn der Forms-Dienst ein Formular mit aktivierten Benutzerrechten rendert, wird ein Formulardatenstream zurückgegeben, den Sie in den Client-Webbrowser schreiben müssen. Nach dem Schreiben in den Client-Webbrowser ist das Formular für den Benutzer sichtbar. Ein Benutzer, der das Formular mit aktivierten Rechten in Adobe Reader anzeigt, kann Vorgänge ausführen, die für dieses Formular aktiviert sind.

Siehe auch

Rendern von Formularen mit aktivierten Rechten mithilfe der Java-API

Rendern von Formularen mit aktivierten Verwendungsrechten mithilfe der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Schnellstarts zur Forms Service-API

Rendern interaktiver PDF forms

Erstellen von Webanwendungen, die Forms rendern

Rendern von Formularen mit aktivierten Rechten mithilfe der Java-API

Rendern Sie ein Formular mit aktivierten Rechten mithilfe der Forms API (Java):

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien wie adobe-forms-client.jar in den Klassenpfad Ihres Java-Projekts ein.

  2. Erstellen eines Forms Client-API-Objekts

    • Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
    • Erstellen Sie eine FormsServiceClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
  3. Laufzeitoptionen für Verwendungsrechte festlegen

    • Erstellen Sie ein Objekt ReaderExtensionSpec, indem Sie den Konstruktor verwenden.
    • Geben Sie den Alias der Berechtigung an, indem Sie die ReaderExtensionSpec -Objekt setReCredentialAlias -Methode und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.
    • Legen Sie die einzelnen Verwendungsrechte fest, indem Sie die entsprechende Methode aufrufen, die zum ReaderExtensionSpec -Objekt. Sie können jedoch nur dann ein Verwendungsrecht festlegen, wenn die von Ihnen referenzierte Berechtigung dies zulässt. Das heißt, Sie können keine Verwendungsrechte festlegen, wenn die Berechtigung es Ihnen nicht erlaubt, sie festzulegen. Beispiel. Um die Verwendungsrechte festzulegen, mit denen ein Benutzer Formularfelder ausfüllen und das Formular speichern kann, rufen Sie die ReaderExtensionSpec -Objekt setReFillIn -Methode und -übergabe true.
    HINWEIS

    Es ist nicht erforderlich, die ReaderExtensionSpec -Objekt setReCredentialPassword* Methode. Diese Methode wird vom Forms-Dienst nicht verwendet. *

  4. Wiedergabe eines Formulars mit aktivierten Verwendungsrechten

    Rufen Sie die FormsServiceClient -Objekt renderPDFFormWithUsageRights -Methode verwenden und die folgenden Werte übergeben:

    • Ein string -Wert, der den Namen des Formularentwurfs einschließlich der Dateinamenerweiterung angibt. Wenn Sie auf einen Formularentwurf verweisen, der Teil einer Forms-Anwendung ist, stellen Sie sicher, dass Sie den vollständigen Pfad angeben, z. B. Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
    • A com.adobe.idp.Document -Objekt, das Daten enthält, die mit dem Formular zusammengeführt werden sollen. Wenn Sie keine Daten zusammenführen möchten, übergeben Sie einen leeren com.adobe.idp.Document -Objekt.
    • A PDFFormRenderSpec -Objekt, das Laufzeitoptionen speichert.
    • A ReaderExtensionSpec -Objekt, das Laufzeitoptionen für Nutzungsrechte speichert.
    • A URLSpec -Objekt, das URI-Werte enthält, die für den Forms-Dienst erforderlich sind.

    Die renderPDFFormWithUsageRights -Methode gibt eine FormsResult -Objekt, das einen Formulardatenstrom enthält, der in den Client-Webbrowser geschrieben werden muss.

  5. Schreiben Sie den Formulardaten-Stream in den Client-Webbrowser

    • Erstellen Sie eine com.adobe.idp.Document -Objekt durch Aufrufen der FormsResult object ‘s getOutputContent -Methode.
    • Abrufen des Inhaltstyps der com.adobe.idp.Document -Objekt durch Aufrufen seiner getContentType -Methode.
    • Legen Sie die javax.servlet.http.HttpServletResponse Inhaltstyp des Objekts durch Aufrufen seiner setContentType -Methode und Übergabe des Inhaltstyps der com.adobe.idp.Document -Objekt.
    • Erstellen Sie eine javax.servlet.ServletOutputStream -Objekt, das zum Schreiben des Formulardaten-Streams in den Client-Webbrowser durch Aufrufen der javax.servlet.http.HttpServletResponse -Objekt getOutputStream -Methode.
    • Erstellen Sie eine java.io.InputStream -Objekt durch Aufrufen der com.adobe.idp.Document -Objekt getInputStream -Methode.
    • Erstellen Sie ein Byte-Array, das mit dem Formulardatenstream gefüllt wird, indem Sie die InputStream -Objekt read -Methode verwenden und das Byte-Array als Argument übergeben.
    • Rufen Sie die javax.servlet.ServletOutputStream -Objekt write -Methode zum Senden des Formulardaten-Streams an den Client-Webbrowser. Übergeben Sie das Byte-Array an die write -Methode.

Siehe auch

Schnellstart (SOAP-Modus): Rendern eines Formulars mit aktivierten Rechten mithilfe der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Rendern von Formularen mit aktivierten Verwendungsrechten mithilfe der Webdienst-API

Rendern Sie ein Formular mit aktivierten Rechten mithilfe der Forms-API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie Java-Proxyklassen, die die Forms-Dienst-WSDL verwenden.
    • Schließen Sie die Java-Proxy-Klassen in Ihren Klassenpfad ein.
  2. Erstellen eines Forms Client-API-Objekts

    Erstellen Sie eine FormsService Objekt und legen Sie Authentifizierungswerte fest.

  3. Laufzeitoptionen für Verwendungsrechte festlegen

    • Erstellen Sie ein Objekt ReaderExtensionSpec, indem Sie den Konstruktor verwenden.
    • Geben Sie den Alias der Berechtigung an, indem Sie die ReaderExtensionSpec -Objekt setReCredentialAlias -Methode und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.
    • Legen Sie die einzelnen Verwendungsrechte fest, indem Sie die entsprechende Methode aufrufen, die zum ReaderExtensionSpec -Objekt. Sie können jedoch nur dann ein Verwendungsrecht festlegen, wenn die von Ihnen referenzierte Berechtigung dies zulässt. Das heißt, Sie können keine Verwendungsrechte festlegen, wenn die Berechtigung es Ihnen nicht erlaubt, sie festzulegen. Um die Verwendungsrechte festzulegen, mit denen ein Benutzer Formularfelder ausfüllen und das Formular speichern kann, rufen Sie die ReaderExtensionSpec -Objekt setReFillIn -Methode und -übergabe true.
  4. Wiedergabe eines Formulars mit aktivierten Verwendungsrechten

    Rufen Sie die FormsService -Objekt renderPDFFormWithUsageRights -Methode verwenden und die folgenden Werte übergeben:

    • Ein string -Wert, der den Namen des Formularentwurfs einschließlich der Dateinamenerweiterung angibt. Wenn Sie auf einen Formularentwurf verweisen, der Teil einer Forms-Anwendung ist, stellen Sie sicher, dass Sie den vollständigen Pfad angeben, z. B. Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
    • A BLOB -Objekt, das Daten enthält, die mit dem Formular zusammengeführt werden sollen. Wenn Sie keine Daten mit dem Formular zusammenführen möchten, müssen Sie eine BLOB -Objekt, das auf einer leeren XML-Datenquelle basiert. Sie können keine BLOB Objekt, das null ist; Andernfalls wird eine Ausnahme ausgelöst.
    • A PDFFormRenderSpec -Objekt, das Laufzeitoptionen speichert.
    • A ReaderExtensionSpec -Objekt, das Laufzeitoptionen für Nutzungsrechte speichert.
    • A URLSpec -Objekt, das URI-Werte enthält, die für den Forms-Dienst erforderlich sind.

    Die renderPDFFormWithUsageRights -Methode gibt eine FormsResult -Objekt, das einen Formulardatenstrom enthält, der in den Client-Webbrowser geschrieben werden muss.

  5. Schreiben Sie den Formulardaten-Stream in den Client-Webbrowser

    • Erstellen Sie eine BLOB -Objekt, das Formulardaten enthält, durch Aufrufen der FormsResult -Objekt getOutputContent -Methode.
    • Abrufen des Inhaltstyps der BLOB -Objekt durch Aufrufen seiner getContentType -Methode.
    • Legen Sie die javax.servlet.http.HttpServletResponse Inhaltstyp des Objekts durch Aufrufen seiner setContentType -Methode und Übergabe des Inhaltstyps der BLOB -Objekt.
    • Erstellen Sie eine javax.servlet.ServletOutputStream -Objekt, das zum Schreiben des Formulardaten-Streams in den Client-Webbrowser durch Aufrufen der javax.servlet.http.HttpServletResponse -Objekt getOutputStream -Methode.
    • Erstellen Sie ein Byte-Array und füllen Sie es durch Aufrufen der BLOB -Objekt getBinaryData -Methode. Diese Aufgabe weist den Inhalt des FormsResult -Objekt zum Byte-Array hinzu.
    • Rufen Sie die javax.servlet.http.HttpServletResponse -Objekt write -Methode zum Senden des Formulardaten-Streams an den Client-Webbrowser. Übergeben Sie das Byte-Array an die write -Methode.

Siehe auch

Rendern von Rights-aktiviertem Forms

Aufrufen von AEM Forms mit Base64-Kodierung

Auf dieser Seite