Übergeben von Dokumenten an den Forms-Service passing-documents-to-the-formsservice

Projektdateien einschließen

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

Erstellen eines Forms- und eines Document Management Client-API-Objekts

• Erstellen Sie ein ServiceClientFactory-Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften.)
• Erstellen Sie ein FormsServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
• Erstellen Sie ein DocumentManagementServiceClientImpl-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.

Abrufen des Formularentwurfs aus Content Services (nicht mehr unterstützt)

Rufen Sie die Methode retrieveContent des DocumentManagementServiceClientImpl-Objekts auf und übergeben Sie die folgenden Werte:

• Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist SpacesStore. Dieser Wert ist ein obligatorischer Parameter.
• Ein Zeichenfolgenwert, der den vollständig qualifizierten Pfad des abzurufenden Inhalts angibt (z. B. /Company Home/Form Designs/Loan.xdp). Dieser Wert ist ein obligatorischer Parameter.
• Ein Zeichenfolgenwert, der die Version angibt. Dieser Wert ist ein optionaler Parameter, und Sie können auch eine leere Zeichenfolge übergeben. In diesem Fall wird die neueste Version abgerufen.

Die Methode retrieveContent gibt ein CRCResult-Objekt zurück, das die XDP-Datei enthält. Sie können eine com.adobe.idp.Document-Instanz erhalten, indem Sie die Methode getDocument des CRCResult-Objekts aufrufen.

Wiedergeben eines interaktiven PDF-Formulars

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

• Ein com.adobe.idp.Document-Objekt, das den Formularentwurf enthält, der von Content Services (veraltet) abgerufen wurde.
• 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. Dieser Wert ist ein optionaler Parameter, für den Sie null angeben können, wenn Sie keine Laufzeitoptionen angeben möchten.
• Ein URLSpec-Objekt, das URI-Werte enthält. Dieser Wert ist ein optionaler Parameter, für den Sie auch null angeben können.
• Ein java.util.HashMap-Objekt, das Dateianlagen speichert. Dieser Wert ist ein optionaler Parameter, für den Sie null angeben können, wenn Sie keine Dateien an das Formular anhängen möchten.

Die Methode renderPDFForm gibt ein FormsResult-Objekt zurück, das einen Formulardaten-Stream enthält, der in den Client-Webbrowser geschrieben werden muss.

Ausführen einer Aktion mit dem Formulardaten-Stream

• Sie können ein com.adobe.idp.Document-Objekt erstellen, 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 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.
• Sie können ein java.io.InputStream-Objekt erstellen, indem Sie die Methode getInputStream des com.adobe.idp.Document-Objekts aufrufen.
• Sie können ein Byte-Array erstellen und es mit dem Formulardaten-Stream füllen, indem Sie die Methode read des InputStream-Objekts aufrufen. Übergeben Sie das Byte-Array als Argument.
• Rufen Sie die Methode write des javax.servlet.ServletOutputStream-Objekts auf, um den Formulardaten-Stream an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die Methode write.

Projektdateien einschließen

Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Da dieses Client-Programm zwei AEM Forms-Services aufruft, erstellen Sie zwei Service-Verweise. Verwenden Sie die folgende WSDL-Definition für den Service-Verweis, der mit dem Forms-Service verknüpft ist: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Verwenden Sie die folgende WSDL-Definition für den Service-Verweis, der mit dem Document Management-Service verknüpft ist: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Da der BLOB-Datentyp für beide Service-Referenzen verwendet wird, müssen Sie den BLOB-Datentyp vollständig qualifizieren, wenn Sie ihn verwenden. In der entsprechenden Kurzanleitung für den Webservice sind alle BLOB-Instanzen vollständig qualifiziert.

Erstellen eines Forms- und eines Document Management Client-API-Objekts

• Erstellen Sie ein FormsServiceClient-Objekt, indem Sie seinen Standardkonstruktor verwenden.

• Erstellen Sie mithilfe des System.ServiceModel.EndpointAddress-Konstruktors ein FormsServiceClient.Endpoint.Address-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B. http://localhost:8080/soap/services/FormsService?WSDL). Das Attribut lc_version muss nicht verwendet werden. Dieses Attribut wird verwendet, wenn Sie einen Service-Verweis erstellen.)

• Erstellen Sie ein System.ServiceModel.BasicHttpBinding-Objekt durch Abrufen des Werts des Felds FormsServiceClient.Endpoint.Binding. 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 FormsServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
  • Weisen Sie dem Feld FormsServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.

• Weisen Sie den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zum Feld BasicHttpBindingSecurity.Security.Mode zu.

Abrufen des Formularentwurfs aus Content Services (nicht mehr unterstützt)

Rufen Sie den Inhalt ab, indem Sie die retrieveContent-Methode des DocumentManagementServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

• Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist SpacesStore. Dieser Wert ist ein obligatorischer Parameter.
• Ein Zeichenfolgenwert, der den vollständig qualifizierten Pfad des abzurufenden Inhalts angibt (z. B. /Company Home/Form Designs/Loan.xdp). Dieser Wert ist ein obligatorischer Parameter.
• Ein Zeichenfolgenwert, der die Version angibt. Dieser Wert ist ein optionaler Parameter, und Sie können auch eine leere Zeichenfolge übergeben. In diesem Fall wird die neueste Version abgerufen.
• Der Ausgabeparameter einer Kennzeichenfolge, der den Wert des Browse-Links speichert.
• Ein BLOB-Ausgabeparameter, der den Inhalt speichert. Sie können diesen Ausgabeparameter verwenden, um den Inhalt abzurufen.
• Ein ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType-Ausgabeparameter, der Inhaltsattribute speichert.
• Ein CRCResult-Ausgabeparameter. Anstatt dieses Objekt zu verwenden, können Sie den BLOB-Ausgabeparameter zum Abrufen des Inhalts verwenden.

Wiedergeben eines interaktiven PDF-Formulars

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

• Ein BLOB-Objekt, das den Formularentwurf enthält, der von Content Services (veraltet) abgerufen wurde.
• Ein BLOB-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 BLOB-Objekt.
• Ein PDFFormRenderSpec-Objekt, das Laufzeitoptionen speichert. Dieser Wert ist ein optionaler Parameter, für den Sie null angeben können, wenn Sie keine Laufzeitoptionen angeben möchten.
• Ein URLSpec-Objekt, das URI-Werte enthält. Dieser Wert ist ein optionaler Parameter, für den Sie auch null angeben können.
• Ein Map-Objekt, das Dateianlagen speichert. Dieser Wert ist ein optionaler Parameter und Sie können null angeben, wenn Sie keine Dateien an das Formular anhängen möchten.
• Ein langer Ausgabeparameter, der zum Speichern der Seitenzahl verwendet wird.
• Ein Ausgabeparameter der Kennzeichenfolge, der zum Speichern des Gebietsschemawerts verwendet wird.
• Ein FormsResult-Ausgabeparameter, der zum Speichern des interaktiven PDF-Formulars verwendet wird .

Die renderPDFForm2-Methode gibt ein FormsResult-Objekt aus, das das interaktive PDF-Formular enthält.

Ausführen einer Aktion mit dem Formulardaten-Stream

• Erstellen Sie ein BLOB-Objekt, das Formulardaten enthält, indem Sie den Wert des outputContent-Feldes des FormsResult-Objekts abrufen.
• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie seinen Konstruktor verwenden. Übergeben Sie einen Kennzeichenfolgewert, der den Dateispeicherort des interaktiven PDF-Dokuments und den Modus angibt, in dem die Datei geöffnet werden soll.
• Erstellen Sie ein Byte-Array, das den Inhalt des BLOB-Objekts speichert, das aus dem FormsResult-Objekt abgerufen wurde. Füllen Sie das Byte-Array, indem Sie den Wert des Datenelements MTOM 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.