Der Forms-Service kann Formulare rendern, auf die Nutzungsrechte 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. Formulare, auf die Nutzungsrechte angewandt wurden, werden als Formulare mit aktivierten Nutzungsrechten bezeichnet. Benutzer, die ein Formular mit aktivierten Nutzungsrechten in Adobe Reader öffnen, können Vorgänge durchführen, die für dieses spezifische Formular aktiviert sind.
Um Nutzungsrechte auf ein Formular anzuwenden, muss der Acrobat Reader DC-Erweiterungs-Service Teil der AEM Forms-Installation sein. Außerdem müssen Sie über gültige Anmeldeinformationen verfügen, mit denen Sie Nutzungsrechte auf PDF-Dokumente anwenden können. Das heißt, Sie müssen den Acrobat Reader DC-Erweiterungs-Service ordnungsgemäß konfigurieren, bevor Sie ein Formular mit aktivierten Nutzungsrechten rendern können. (Siehe Informationen zum Acrobat Reader DC-Erweiterungs-Service.)
Um ein Formular zu rendern, das Nutzungsrechte enthält, müssen Sie eine XDP-Datei und keine PDF-Datei als Eingabe verwenden. Wenn Sie eine PDF-Datei als Eingabe verwenden, wird das Formular weiterhin gerendert. Es handelt sich dann jedoch nicht um ein Formular mit aktivierten Nutzungsrechten.
Sie können ein Formular nicht mit XML-Daten vorab ausfüllen, wenn Sie die folgenden Nutzungsrechte angeben: enableComments
, enableCommentsOnline
, enableEmbeddedFiles
oder enableDigitalSignatures
. (Siehe Vorausfüllen von Formularen mit flexiblen Layouts.)
Weitere Informationen zum Forms-Service finden Sie in der Service-Referenz für AEM Forms.
Um ein Formular mit aktivierten Nutzungsrechten zu rendern, führen Sie die folgenden Aufgaben aus:
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm 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-Service programmgesteuert durchführen können, müssen Sie einen Client für den Forms-Service erstellen.
Festlegen von Laufzeitoptionen für Nutzungsrechte
Sie müssen Laufzeitoptionen für Nutzungsrechte festlegen, um ein Formular mit aktivierten Nutzungsrechten zu rendern. Sie müssen auch den Alias der Anmeldeinformationen angeben, die zum Anwenden von Nutzungsrechten auf ein Formular verwendet werden. Nachdem Sie den Alias-Wert angegeben haben, geben Sie jedes Nutzungsrecht an, das auf das Formular angewendet werden soll.
Rendern eines Formulars mit aktivierten Nutzungsrechten
Um ein Formular mit aktivierten Nutzungsrechten zu rendern, verwenden Sie dieselbe Anwendungslogik wie beim Rendern eines Formulars ohne Nutzungsrechte. Der einzige Unterschied besteht darin, dass Sie sicherstellen müssen, dass die Laufzeitoptionen für Nutzungsrechte in Ihrer Anwendungslogik enthalten sind.
Beim Rendern eines Formulars mit aktivierten Nutzungsrechten mithilfe der Forms-Web-Service-API können Sie keine Dateien an das Formular anhängen.
Schreiben des Formulardaten-Streams in den Client-Webbrowser
Wenn der Forms-Service ein Formular mit aktivierten Nutzungsrechten rendert, wird ein Formulardaten-Stream 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 Benutzerrechten in Adobe Reader anzeigt, kann Vorgänge ausführen, die für dieses Formular aktiviert sind.
Siehe auch
Rendern von Formularen mit aktivierten Nutzungsrechten mithilfe der Java-API
Rendering von rechteaktivierten Formularen über die Webservice-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstart mit der Forms Service-API
Rendern interaktiver PDF-Formulare
Erstellen von Web-Programmen, die Formulare wiedergeben
So rendern Sie ein Formular mit aktivierten Nutzungsrechten mithilfe der Forms-API (Java):
Projektdateien einschließen
Fügen Sie Client-JAR-Dateien wie „adobe-forms-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
Erstellen eines Forms Client-API-Objekts
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.FormsServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Optionen für Nutzungsrechte zur Laufzeit festlegen
ReaderExtensionSpec
, indem Sie den Konstruktor verwenden.setReCredentialAlias
-Methode des ReaderExtensionSpec
-Objekts aufrufen und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.ReaderExtensionSpec
-Objekt gehört. Sie können jedoch nur dann ein Nutzungsrecht festlegen, wenn die von Ihnen referenzierten Anmeldeinformationen dies zulassen. Das heißt, Sie können keine Nutzungsrechte festlegen, wenn die Anmeldeinformationen es Ihnen nicht erlauben, sie festzulegen. Beispiel. Um die Nutzungsrechte festzulegen, mit denen ein Benutzer Formularfelder ausfüllen und das Formular speichern kann, rufen Sie die setReFillIn
-Methode des ReaderExtensionSpec
-Objekt auf und übergeben true
.Es ist nicht erforderlich, die ReaderExtensionSpec
-Objekt setReCredentialPassword
* Methode. Diese Methode wird vom Forms-Service nicht verwendet. *
Rendern eines Formulars mit aktivierten Nutzungsrechten
Rufen Sie die renderPDFFormWithUsageRights
-Methode des FormsServiceClient
-Objekts auf und übergeben Sie die folgenden Werte:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.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 ein leeres com.adobe.idp.Document
-Objekt.PDFFormRenderSpec
-Objekt, das Laufzeitoptionen speichert.ReaderExtensionSpec
-Objekt, das Laufzeitoptionen für Nutzungsrechte speichert.URLSpec
-Objekt, das URI-Werte enthält, die für den Forms-Dienst erforderlich sind.Die renderPDFFormWithUsageRights
-Methode gibt ein FormsResult
-Objekt zurück, das einen Formulardatenstrom enthält, der in den Client-Webbrowser geschrieben werden muss.
Schreiben des Formulardaten-Streams in den Client-Webbrowser
com.adobe.idp.Document
-Objekt, indem Sie die Methode getOutputContent
des FormsResult
-Objekts aufrufen.com.adobe.idp.Document
-Objekts, indem Sie seine Methode getContentType
aufrufen.javax.servlet.http.HttpServletResponse
-Objekts fest, indem Sie seine Methode setContentType
aufrufen und den Content-Typ des com.adobe.idp.Document
-Objekts übergeben.javax.servlet.ServletOutputStream
-Objekt, das zum Schreiben des Formulardaten-Streams in den Client-Webbrowser verwendet wird, indem Sie die Methode getOutputStream
des javax.servlet.http.HttpServletResponse
-Objekts aufrufen.java.io.InputStream
-Objekt durch Aufrufen der getInputStream
-Methode des com.adobe.idp.Document
-Objekts.read
des InputStream
-Objekts verwenden und das Byte-Array als Argument übergeben.write
des javax.servlet.ServletOutputStream
-Objekts zum Senden des Formulardaten-Streams an den Client-Webbrowser auf. Übergeben Sie das Byte-Array an die Methode write
.Siehe auch
Kurzanleitung (SOAP-Modus): Rendern eines berechtigungsaktivierten Formulars mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Rendering eines Formulars mit aktivierten Rechten mithilfe der Forms API (Webservice):
Projektdateien einschließen
Erstellen eines Forms Client-API-Objekts
Erstellen Sie ein FormsService
-Objekt und legen Sie Authentifizierungswerte fest.
Optionen für Nutzungsrechte zur Laufzeit festlegen
ReaderExtensionSpec
, indem Sie den Konstruktor verwenden.setReCredentialAlias
-Methode des ReaderExtensionSpec
-Objekts aufrufen und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.ReaderExtensionSpec
-Objekt gehört. Sie können jedoch nur dann ein Nutzungsrecht festlegen, wenn die von Ihnen referenzierten Anmeldeinformationen dies zulassen. Das heißt, Sie können keine Nutzungsrechte festlegen, wenn die Berechtigung Ihnen nicht erlaubt, diese festzulegen. Um die Nutzungsrechte festzulegen, die es einem Benutzer erlauben Formularfelder auszufüllen und das Formular zu speichern, rufen Sie die setReFillIn
-Methode des ReaderExtensionSpec
-Objekts auf und übergeben Sie true
.Rendern eines Formulars mit aktivierten Rechten
Rufen Sie die renderPDFFormWithUsageRights
-Methode des FormsService
-Objekts auf und übergeben Sie die folgenden Werte:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.BLOB
-Objekt, das Daten enthält, die mit dem Formular zusammengeführt werden sollen. Wenn Sie keine Daten mit dem Formular zusammenführen wollen, müssen Sie ein BLOB
-Objekt übergeben, das auf einer leeren XML-Datenquelle basiert. Sie können kein BLOB
-Objekt übergeben, das Null ist; andernfalls wird eine Ausnahme ausgelöst.PDFFormRenderSpec
-Objekt, das Laufzeitoptionen speichert.ReaderExtensionSpec
-Objekt, das Laufzeitoptionen für Nutzungsrechte speichert.URLSpec
-Objekt, das URI-Werte enthält, die für den Forms-Dienst erforderlich sind.Die renderPDFFormWithUsageRights
-Methode gibt ein FormsResult
-Objekt zurück, das einen Formulardatenstrom enthält, der in den Client-Webbrowser geschrieben werden muss.
Schreiben des Formulardaten-Streams in den Client-Webbrowser
BLOB
-Objekt, das Formulardaten enthält, indem Sie die getOutputContent
-Methode des FormsResult
-Objekts aufrufen.BLOB
-Objekts, indem Sie seine Methode getContentType
aufrufen.javax.servlet.http.HttpServletResponse
-Objekts fest, indem Sie seine Methode setContentType
aufrufen und den Content-Typ des BLOB
-Objekts übergeben.javax.servlet.ServletOutputStream
-Objekt, das zum Schreiben des Formulardaten-Stream in den Client-Webbrowser verwendet wird, indem Sie die Methode getOutputStream
des javax.servlet.http.HttpServletResponse
-Objekts aufrufen.getBinaryData
des BLOB
-Objekts aufrufen. Mit dieser Aufgabe wird dem Byte-Array der Inhalt des FormsResult
-Objekts zugewiesen.write
des javax.servlet.http.HttpServletResponse
-Objekts auf, um den Formulardaten-Stream an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die Methode write
.Siehe auch
Rendern von Formularen mit aktivierten Verwendungsrechten
Aufrufen von AEM Forms mit Base64-Kodierung