Rendern von Formularen mit aktivierten Verwendungsrechten rendering-rights-enabled-forms

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

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

Optionen für Nutzungsrechte zur Laufzeit festlegen

• Erstellen Sie ein Objekt ReaderExtensionSpec, indem Sie den Konstruktor verwenden.
• Geben Sie den Alias der Anmeldeinformationen an, indem Sie die Methode setReCredentialAlias des ReaderExtensionSpec-Objekts aufrufen, und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.
• Legen Sie die einzelnen Nutzungsrechte fest, indem Sie die entsprechende Methode aufrufen, die zum ReaderExtensionSpec-Objekt gehört. Sie können jedoch nur dann ein Nutzungsrecht festlegen, wenn die von Ihnen referenzierte Berechtigung dies zulässt. Das heißt, Sie können keine Nutzungsrechte festlegen, wenn die Berechtigung Ihnen dies nicht erlaubt. Beispiel. Um das Nutzungsrecht festzulegen, mit dem Sie Formularfelder ausfüllen und das Formular speichern können, rufen Sie die Methode setReFillIn des ReaderExtensionSpec-Objekts auf und übergeben Sie true.

Rendern eines Formulars mit aktivierten Nutzungsrechten

Rufen Sie die Methode renderPDFFormWithUsageRights des FormsServiceClient-Objekts auf und übergeben Sie die folgenden Werte:

• Ein Zeichenfolgenwert, der den Namen des Formularentwurfs einschließlich der Dateinamenerweiterung angibt. Wenn Sie auf einen Formularentwurf verweisen, der Teil eines Forms-Programms ist, stellen Sie sicher, dass Sie den vollständigen Pfad angeben, z. B. Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
• Ein 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.
• Ein PDFFormRenderSpec-Objekt, das Laufzeitoptionen speichert.
• Ein 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 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

• Erstellen Sie ein Objekt vom Typ com.adobe.idp.Document, indem Sie die Methode getOutputContent des FormsResult-Objekts aufrufen.
• Ermitteln Sie den Content-Typ des com.adobe.idp.Document-Objekts, indem Sie seine Methode getContentType aufrufen.
• Legen Sie den Content-Typ des javax.servlet.http.HttpServletResponse-Objekts fest, indem Sie seine Methode setContentType aufrufen und den Content-Typ des com.adobe.idp.Document-Objekts übergeben.
• Erstellen Sie ein Objekt vom Typ javax.servlet.ServletOutputStream, das zum Schreiben des Formulardatenstroms in den Client-Webbrowser verwendet wird, indem Sie die Methode getOutputStream des javax.servlet.http.HttpServletResponse-Objekts aufrufen.
• Erstellen Sie ein Objekt vom Typ java.io.InputStream, indem Sie die Methode getInputStream des com.adobe.idp.Document-Objekts aufrufen.
• Erstellen Sie ein Byte-Array und füllen Sie es mit dem Formulardatenstrom, indem Sie die Methode read des InputStream-Objekts aufrufen und das Byte-Array als Argument übergeben.
• Rufen Sie die Methode write des javax.servlet.ServletOutputStream-Objekts auf, um den Formulardatenstrom an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die Methode write.

Projektdateien einschließen

• Erstellen Sie Java-Proxy-Klassen, welche die Forms-Dienst-WSDL verwenden.
• Schließen Sie die Java-Proxy-Klassen in Ihren Klassenpfad ein.

Erstellen eines Forms Client-API-Objekts

Erstellen Sie ein FormsService-Objekt und legen Sie Authentifizierungswerte fest.

Optionen für Nutzungsrechte zur Laufzeit festlegen

• Erstellen Sie ein Objekt ReaderExtensionSpec, indem Sie den Konstruktor verwenden.
• Geben Sie den Alias der Anmeldeinformationen an, indem Sie die Methode setReCredentialAlias des ReaderExtensionSpec-Objekts aufrufen, und geben Sie einen Zeichenfolgenwert an, der den Alias-Wert darstellt.
• Legen Sie die einzelnen Nutzungsrechte fest, indem Sie die entsprechende Methode aufrufen, die zum ReaderExtensionSpec-Objekt gehört. Sie können jedoch nur dann ein Nutzungsrecht festlegen, wenn die von Ihnen referenzierte Berechtigung dies zulässt. Das heißt, Sie können keine Nutzungsrechte festlegen, wenn die Berechtigung Ihnen dies nicht erlaubt. Um das Nutzungsrecht festzulegen, mit dem Sie Formularfelder ausfüllen und das Formular speichern können, rufen Sie die Methode setReFillIn des ReaderExtensionSpec-Objekts auf und übergeben Sie true.

Rendern eines Formulars mit aktivierten Nutzungsrechten

Rufen Sie die Methode renderPDFFormWithUsageRights des FormsService-Objekts auf und übergeben Sie die folgenden Werte:

• Ein Zeichenfolgenwert, der den Namen des Formularentwurfs einschließlich der Dateinamenerweiterung angibt. Wenn Sie auf einen Formularentwurf verweisen, der Teil eines Forms-Programms ist, stellen Sie sicher, dass Sie den vollständigen Pfad angeben, z. B. Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
• Ein 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.
• Ein PDFFormRenderSpec-Objekt, das Laufzeitoptionen speichert.
• Ein 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 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

• Erstellen Sie ein Objekt vom Typ BLOB, das Formulardaten enthält, indem Sie die Methode getOutputContent des FormsResult-Objekts aufrufen.
• Ermitteln Sie den Content-Typ des BLOB-Objekts, indem Sie seine Methode getContentType aufrufen.
• Legen Sie den Content-Typ des javax.servlet.http.HttpServletResponse-Objekts fest, indem Sie seine Methode setContentType aufrufen und den Content-Typ des BLOB-Objekts übergeben.
• Erstellen Sie ein Objekt vom Typ javax.servlet.ServletOutputStream, das zum Schreiben des Formulardatenstroms in den Client-Webbrowser verwendet wird, indem Sie die Methode getOutputStream des javax.servlet.http.HttpServletResponse-Objekts aufrufen.
• Erstellen Sie ein Byte-Array und füllen Sie es auf, indem Sie die Methode getBinaryData des BLOB-Objekts aufrufen. Mit dieser Aufgabe wird dem Byte-Array der Inhalt des FormsResult-Objekts zugewiesen.
• Rufen Sie die Methode write des javax.servlet.http.HttpServletResponse-Objekts auf, um den Formulardatenstrom an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die Methode write.