Ü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 retrieveContent-Methode 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

• Erstellen Sie ein com.adobe.idp.Document-Objekt, 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.
• Erstellen Sie ein java.io.InputStream-Objekt, indem Sie die getInputStream-Methode 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 die Service-Referenz, die mit dem Document Management-Service verknüpft ist: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Da der Datentyp BLOB für beide Service-Verweise verwendet wird, müssen Sie den Datentyp BLOB qualifizieren, wenn Sie ihn verwenden. Im entsprechenden Webservice-Schnellstart 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 mit der WSDL an den AEM Forms-Service (z. B. http://localhost:8080/soap/services/FormsService?WSDL). Sie müssen das lc_version-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie einen Service-Verweis erstellen.)

• Erstellen Sie ein System.ServiceModel.BasicHttpBinding-Objekt, indem Sie den Wert des FormsServiceClient.Endpoint.Binding-Felds abrufen. 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 konstanten Wert BasicHttpSecurityMode.TransportCredentialOnly dem 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, für den Sie null angeben können, 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 aufrufen. Ü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 BLOB-Datenelements des Objekts MTOM 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.