AEM Forms mit Web Services aufrufen invoking-aem-forms-using-web-services

Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.

Die meisten AEM Forms-Services im Service-Container sind so konfiguriert, dass sie einen Webservice bereitstellen, wobei die Generierung von WSDL (Web Service Definition Language) vollständig unterstützt wird. Das heißt, Sie können Proxy-Objekte erstellen, die den nativen SOAP-Stapel eines AEM Forms-Services verwenden. Daher können AEM Forms-Services die folgenden SOAP-Nachrichten austauschen und verarbeiten:

Mithilfe von Web-Services können Sie dieselben AEM Forms-Service-Vorgänge ausführen, die Sie auch mithilfe der Java-API ausführen können. Ein Vorteil der Verwendung von Web-Services zum Aufrufen von AEM Forms-Services ist, dass Sie ein Client-Programm in einer Entwicklungsumgebung erstellen können, die SOAP unterstützt. Ein Client-Programm ist nicht an eine bestimmte Entwicklungsumgebung oder Programmiersprache gebunden. Sie können beispielsweise ein Client-Programm mit Microsoft Visual Studio .NET und C# als Programmiersprache erstellen.

AEM Forms-Services werden über das SOAP-Protokoll bereitgestellt und sind mit WSI Basic Profile 1.1 kompatibel. Web Services Interoperability (WSI) ist eine Organisation mit offenen Standards, die die Interoperabilität von Web-Services plattformübergreifend fördert. Weitere Informationen finden Sie unter https://www.ws-i.org/.

AEM Forms unterstützt die folgenden Webservice-Standards:

Um AEM Forms-Services über einen Webservice aufzurufen, erstellen Sie in der Regel eine Proxy-Bibliothek, die die WSDL des Services verwendet. Der Abschnitt Aufrufen von AEM Forms mithilfe von Web Services verwendet JAX-WS, um Java-Proxy-Klassen zum Aufrufen von Services zu erstellen. (Siehe Erstellen von Java-Proxy-Klassen mithilfe von JAX-WS.)

Sie können eine Service-WSDL abrufen, indem Sie die folgende URL-Definition angeben (Elemente in Klammern sind optional):

 https://<your_serverhost>:<your_port>/soap/services/<service_name>?wsdl[&version=<version>][&async=true|false][lc_version=<lc_version>]

Hierbei gilt:

In der folgenden Tabelle sind die WSDL-Definitionen des Services aufgeführt (unter der Annahme, dass AEM Forms auf dem lokalen Host bereitgestellt wird und der Port 8080 ist).

WSDL-Definitionen für AEM Forms-Prozesse

Geben Sie den Anwendungsnamen und den Prozessnamen in der WSDL-Definition an, um auf eine WSDL zugreifen zu können, die zu einem in Workbench erstellten Prozess gehört. Angenommen, der Name des Programms lautet MyApplication und der Name des Prozesses lautet EncryptDocument. Geben Sie in diesem Fall die folgende WSDL-Definition an:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl

 http://localhost:8080/soap/services/MyApplication/[<folderA>/.../<folderZ>/]EncryptDocument?wsdl

Zugriff auf neue Funktionen mithilfe von Web-Services

Auf neue Service-Funktionen in AEM Forms kann mithilfe von Web-Services zugegriffen werden. In AEM Forms wird beispielsweise die Möglichkeit eingeführt, Anhänge mithilfe von MTOM zu codieren. (Siehe Aufrufen von AEM Forms mithilfe von MTOM.)

Um auf die in AEM Forms eingeführten neuen Funktionen zuzugreifen, geben Sie in der WSDL-Definition das Attribut lc_version an. Um beispielsweise auf neue Service-Funktionen (einschließlich MTOM-Unterstützung) zuzugreifen, geben Sie die folgende WSDL-Definition an:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl&lc_version=9.0.1

Webservice-BLOB-Datentyp

Die WSDLs der AEM Forms-Services definieren viele Datentypen. Einer der wichtigsten Datentypen, die in einem Webservice verfügbar gemacht werden, ist ein BLOB-Typ. Dieser Datentyp wird beim Arbeiten mit AEM Forms-Java-APIs der Klasse com.adobe.idp.Document zugeordnet. (Siehe Übergeben von Daten an AEM Forms-Services mithilfe der Java-API).

Ein BLOB-Objekt sendet Binärdaten (z. B. PDF-Dateien, XML-Daten usw.) an AEM Forms-Services und ruft sie von ihnen ab. Der BLOB-Typ wird in einer Service-WSDL wie folgt definiert:

 <complexType name="BLOB">
     <sequence>
         <element maxOccurs="1" minOccurs="0" name="contentType"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="binaryData"
             type="xsd:base64Binary"/>
         <element maxOccurs="1" minOccurs="0" name="attachmentID"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="remoteURL"
             type="xsd:string"/>
         <element maxOccurs="1" minOccurs="0" name="MTOM"
             type="xsd:base64Binary"
             xmime:expectedContentTypes="*/*"
             xmlns:xmime="https://www.w3.org/2005/05/xmlmime"/>
         <element maxOccurs="1" minOccurs="0" name="swaRef"
             type="tns1:swaRef"/>
         <element maxOccurs="1" minOccurs="0" name="attributes"
             type="impl:MyMapOf_xsd_string_To_xsd_anyType"/>
     </sequence>
 </complexType>

Die Felder MTOM und swaRef werden nur in AEM Forms unterstützt. Sie können diese neuen Felder nur verwenden, wenn Sie eine URL angeben, die die Eigenschaft lc_version enthält.

Bereitstellen von BLOB-Objekten in Service-Anforderungen

Wenn ein Service-Vorgang von AEM Forms einen BLOB-Typ als Eingabewert erfordert, erstellen Sie in Ihrer Anwendungslogik eine Instanz des BLOB-Typs. (Viele der Webservice-Schnellstartanleitungen unter Programmieren mit AEM Forms zeigen, wie Sie mit einem BLOB-Datentyp arbeiten).

Weisen Sie den Feldern, die zur BLOB-Instanz gehören, wie folgt Werte zu:

Zugriff auf Daten in BLOB-Objekten, die von Diensten zurückgegeben werden

Das Übermittlungsprotokoll für zurückgesendete BLOB-Objekte hängt von mehreren Faktoren ab, die in der folgenden Reihenfolge berücksichtigt werden und das bei Erfüllung der Hauptbedingung beendet wird:

Wie in der ersten Bedingung beschrieben, können Sie den Übertragungstyp für alle zurückgegebenen Dokumente sicherstellen, indem Sie die SOAP-Endpunkt-URL wie folgt um ein Suffix erweitern:

     https://<your_serverhost>:<your_port>/soap/services/<service
     name>?blob=base64|dime|mime|http|mtom|swaref

Im Folgenden wird der Zusammenhang zwischen den Übertragungsarten und dem Feld, aus dem Sie die Daten beziehen, erläutert:

MTOM-Übertragung von base64-kodierten Byte-Arrays

Zusätzlich zum BLOB-Objekt unterstützt das MTOM-Protokoll sämtliche Byte-Array-Parameter oder Byte-Array-Felder eines komplexen Typs. Dies bedeutet, dass Client-SOAP-Frameworks, die MTOM unterstützen, jedes xsd:base64Binary-Element als MTOM-Anlage senden können (anstelle eines base64-kodierten Textes). AEM Forms SOAP-Endpunkte können diesen Typ der Byte-Array-Kodierung lesen. Der AEM Forms-Dienst gibt jedoch immer einen Byte-Array-Typ als base64-kodierten Text zurück. Die Parameter für die Ausgabe von Byte-Arrays unterstützen kein MTOM.

AEM Forms-Dienste, die eine große Menge an Binärdaten zurückgeben, verwenden den Typ Dokument/BLOB anstelle des Typs Byte-Array. Der Dokumententyp ist wesentlich effizienter für die Übertragung großer Datenmengen.

Webdienst-Datentypen web-service-data-types

In der folgenden Tabelle sind die Java-Datentypen mit dem entsprechenden Webdienst-Datentyp aufgeführt.

Erstellen von Java-Proxy-Klassen mit JAX-WS creating-java-proxy-classes-using-jax-ws

Sie können JAX-WS verwenden, um eine Forms-Dienst-WSDL in Java-Proxy-Klassen zu konvertieren. Diese Klassen ermöglichen es Ihnen, AEM Forms-Dienstvorgänge aufzurufen. Mit Apache Ant können Sie ein Build-Skript erstellen, das Java-Proxy-Klassen durch Verweisen auf eine AEM Forms-Dienst-WSDL, generiert. Sie können JAX-WS-Proxy-Dateien generieren, indem Sie die folgenden Schritte ausführen:

Siehe auch

Erstellen von Java-Proxy-Klassen mithilfe von Apache Axis

Aufrufen von AEM Forms mit Base64-Kodierung

Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP

Aufrufen von AEM Forms mithilfe von SwaRef

Erstellen von Java-Proxy-Klassen mithilfe von Apache Axis creating-java-proxy-classes-using-apache-axis

Sie können das Apache Axis WSDL2Java-Tool verwenden, um einen Forms-Service in Java-Proxy-Klassen zu konvertieren. Diese Klassen ermöglichen es Ihnen, Vorgänge von Forms-Services aufzurufen. Mit Apache Ant können Sie Bibliotheksdateien für Axis aus einer Service-WSDL generieren. Sie können Apache Axis unter der URL https://ws.apache.org/axis/ herunterladen.

Sie können Java-Bibliotheksdateien für Axis generieren, indem Sie die folgenden Schritte ausführen:

Siehe auch

Erstellen von Java-Proxy-Klassen mit JAX-WS

Aufrufen von AEM Forms mit Base64-Kodierung

Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP

Aufrufen von AEM Forms mit Base64-Kodierung invoking-aem-forms-using-base64-encoding

Sie können einen AEM Forms-Dienst mit Base64-Kodierung aufrufen. Die Base64-Kodierung kodiert Anlagen, die mit einer Webdienst-Aufrufanforderung gesendet werden. Das heißt, BLOB-Daten sind Base64-kodiert, nicht die gesamte SOAP-Nachricht.

In „Aufrufen von AEM Forms mit Base64-Kodierung“ wird das Aufrufen des folgenden kurzlebigen AEM Forms-Prozesses namens MyApplication/EncryptDocument mit Base64-Kodierung beschrieben.

Wenn dieser Prozess aufgerufen wird, führt er die folgenden Aktionen aus:

Erstellen einer .NET-Client-Zusammenführung, die Base64-Kodierung verwendet creating-a-net-client-assembly-that-uses-base64-encoding

Sie können eine .NET-Client-Assembly erstellen, um einen Forms-Dienst aus einem Microsoft Visual Studio .NET-Projekt heraus aufzurufen. Um eine .NET-Client-Assembly zu erstellen, die base64-Kodierung verwendet, führen Sie die folgenden Schritte aus:

Proxy-Klasse erstellen

Sie können mithilfe eines Werkzeuges, das zu Microsoft Visual Studio gehört, eine Proxyklasse zur Erstellung der .NET-Client-Assembly erstellen. Dieses Tool trägt den Namen „wsdl.exe“ und befindet sich im Installationsordner von Microsoft Visual Studio. Um eine Proxy-Klasse zu erstellen, öffnen Sie die Eingabeaufforderung und navigieren Sie zu dem Ordner, der die Datei „wsdl.exe“ enthält. Weitere Informationen zum Tool „wsdl.exe“ finden Sie in der MSDN-Hilfe.

Geben Sie an der Eingabeaufforderung den folgenden Befehl ein:

 wsdl https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1

Standardmäßig erstellt dieses Tool eine CS-Datei im selben Ordner, der auf dem Namen der WSDL basiert. In diesem Fall wird eine CS-Datei mit dem Namen EncryptDocumentService.cs erstellt. Mit dieser CS-Datei erstellen Sie ein Proxy-Objekt, mit dem Sie den Service aufrufen können, der in der Aufruf-URL angegeben wurde.

Ändern Sie die URL in der Proxy-Klasse so, dass sie ?blob=base64 enthält, um sicherzustellen, dass das BLOB-Objekt binäre Daten zurückgibt. Suchen Sie in der Proxy-Klasse die folgende Code-Zeile:

 "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument";

und ändern Sie sie in:

 "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64";

Der Abschnitt Aufrufen von AEM Forms mit Base64-Codierung verwendet MyApplication/EncryptDocument als Beispiel. Wenn Sie eine .NET-Client-Assembly für einen anderen Forms-Service erstellen, stellen Sie sicher, dass Sie MyApplication/EncryptDocument durch den Namen des Services ersetzen.

Entwickeln der .NET-Client-Assembly

Erstellen Sie ein Visual Studio-Klassenbibliotheksprojekt, das eine .NET-Client-Assembly erzeugt. Die CS-Datei, die Sie mithilfe von „wsdl.exe“ erstellt haben, kann in dieses Projekt importiert werden. Dieses Projekt erzeugt eine DLL-Datei (die .NET-Client-Assembly), die Sie in anderen Visual Studio .NET-Projekten zum Aufrufen eines Services verwenden können.

Referenzieren der .NET-Client-Assembly

Platzieren Sie die neu erstellte .NET-Client-Assembly auf dem Computer, auf dem Sie Ihr Client-Programm entwickeln. Nachdem Sie die .NET-Client-Assembly in einem Verzeichnis platziert haben, können Sie sie von einem Projekt aus referenzieren. Verweisen Sie auch auf die System.Web.Services-Bibliothek aus Ihrem Projekt. Wenn Sie diese Bibliothek nicht referenzieren, können Sie die .NET-Client-Assembly nicht zum Aufrufen eines Dienstes verwenden.

Aufrufen eines Services mithilfe einer .NET-Client-Assembly, die die Base64-Codierung verwendet

Sie können den Service MyApplication/EncryptDocument (der in Workbench erstellt wurde) mithilfe einer .NET-Client-Assembly aufrufen, die die Base64-Codierung verwendet. Um den Service MyApplication/EncryptDocument aufzurufen, führen Sie die folgenden Schritte aus:

Aufrufen eines Service mit Java-Proxy-Klassen und Base64-Codierung invoking-a-service-using-java-proxy-classes-and-base64-encoding

Sie können einen AEM Forms-Service mithilfe von Java-Proxy-Klassen und Base64 aufrufen. Um den MyApplication/EncryptDocument-Service mit Java-Proxy-Klassen aufzurufen, führen Sie die folgenden Schritte aus:

Siehe auch

Schnellstart: Aufrufen eines Services mithilfe von Java-Proxy-Dateien und Base64-Codierung

Erstellen einer .NET-Client-Zusammenführung, die Base64-Kodierung verwendet

AEM Forms mithilfe von MTOM aufrufen invoking-aem-forms-using-mtom

Sie können AEM Forms-Services mithilfe des Webservice-Standards MTOM aufrufen. Dieser Standard definiert, wie binäre Daten, z. B. ein PDF-Dokument, über das Internet oder Intranet übertragen werden. Eine Funktion von MTOM ist die Verwendung des XOP:Include-Elements. Dieses Element ist in der XOP-Spezifikation (XML-binary Optimized Packaging) definiert, um auf die binären Anhänge einer SOAP-Nachricht zu verweisen.

In dieser Diskussion geht es um die Verwendung von MTOM, um den folgenden kurzlebigen AEM Forms-Prozess namens MyApplication/EncryptDocument aufzurufen.

Wenn dieser Prozess aufgerufen wird, führt er die folgenden Aktionen aus:

Hier geht es um die Verwendung von MTOM innerhalb eines Microsoft .NET-Projekts zum Aufrufen von AEM Forms-Diensten. Das verwendete .NET-Framework ist 3.5 und die Entwicklungsumgebung ist Visual Studio 2008. Wenn Sie auf Ihrem Entwicklungscomputer Web Service Enhancements (WSE) installiert haben, entfernen sie. Das .NET 3.5-Framework unterstützt ein SOAP-Framework namens Windows Communication Foundation (WCF). Wenn Sie AEM Forms mithilfe von MTOM aufrufen, wird nur WCF (nicht WSE) unterstützt.

Erstellen eines .NET-Projekts, das einen Dienst mit MTOM aufruft creating-a-net-project-that-invokes-a-service-using-mtom

Sie können ein Microsoft .NET-Projekt erstellen, das einen AEM Forms-Dienst mittels Webdienste aufrufen kann. Erstellen Sie zunächst ein Microsoft .NET-Projekt mit Visual Studio 2008. Um einen AEM Forms-Dienst aufzurufen, erstellen Sie einen Dienstverweis zum AEM Forms-Dienst, den Sie in Ihrem Projekt aufrufen möchten. Wenn Sie einen Dienstverweis erstellen, geben Sie eine URL für den AEM Forms-Dienst an:

 http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1

Ersetzen Sie localhost mit der IP-Adresse des J2EE-Anwendungsservers, auf dem AEM Forms gehostet wird. Ersetzen Sie MyApplication/EncryptDocument mit dem Namen des aufzurufenden AEM Forms-Dienstes. Um beispielsweise einen Rights Management-Vorgang aufzurufen, geben Sie Folgendes an:

http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1

Die Option lc_version stellt sicher, dass AEM Forms-Funktionen, wie beispielsweise MTOM, verfügbar sind. Ohne Angabe der lc_version-Option können Sie AEM Forms nicht über MTOM aufrufen.

Nachdem Sie einen Dienstverweis erstellt haben, sind mit dem AEM Forms-Dienst verknüpfte Datentypen für die Verwendung in Ihrem .NET-Projekt verfügbar. Um ein .NET-Projekt zu erstellen, das einen AEM Forms-Dienst aufruft, führen Sie die folgenden Schritte aus:

Aufrufen eines Dienstes mit MTOM in einem .NET-Projekt invoking-a-service-using-mtom-in-a-net-project

Beachten Sie den MyApplication/EncryptDocument-Prozess, der ein ungesichertes PDF-Dokument akzeptiert und ein kennwortverschlüsseltes PDF-Dokument zurückgibt. Um den MyApplication/EncryptDocumentProzess (der in Workbench erstellt wurde) mithilfe von MTOM aufzurufen, führen Sie die folgenden Schritte aus:

Siehe auch

Kurzanleitung: Aufrufen eines Services mithilfe von MTOM in einem .NET-Projekt

Zugreifen auf mehrere Dienste mithilfe von Webdiensten

Erstellen einer ASP.NET-Webanwendung, die einen langlebigen, am Menschen orientierten Prozess aufruft

Aufrufen von AEM Forms mithilfe von SwaRef invoking-aem-forms-using-swaref

Sie können AEM Forms-Dienste mit SwaRef aufrufen. Der Inhalt des wsi:swaRef-XML-Elements wird als Anlage innerhalb eines SOAP-Bodys gesendet, der den Verweis auf die Anlage speichert. Wenn Sie einen Forms-Dienst mit SwaRef aufrufen, erstellen Sie Java-Proxy-Klassen unter Verwendung der Java-API für XML-Webdienste (JAX-WS). (Siehe Java-API für XML-Webdienste.)

Hier geht es um den Aufruf des folgenden kurzlebigen Forms-Prozesses namens MyApplication/EncryptDocument unter Verwendung von SwaRef.

Wenn dieser Prozess aufgerufen wird, führt er die folgenden Aktionen aus:

Im Folgenden wird erörtert, wie Forms-Dienste mithilfe von SwaRef innerhalb einer Java-Client-Anwendung aufgerufen werden können. Die Java-Anwendung verwendet Proxy-Klassen, die mithilfe von JAX-WS erstellt wurden.

Aufrufen eines Dienstes mit JAX-WS-Bibliotheksdateien, die SwaRef verwenden invoke-a-service-using-jax-ws-library-files-that-use-swaref

Um den MyApplication/EncryptDocument-Prozess mithilfe von Java-Proxy-Dateien aufzurufen, die mit JAX-WS und SwaRef erstellt wurden, führen Sie die folgenden Schritte aus:

Siehe auch

Kurzanleitung: Aufrufen eines Services mit SwaRef in einem Java-Projekt

Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP invoking-aem-forms-using-blob-data-over-http

Sie können AEM Forms-Dienste über Webdienste aufrufen und BLOB-Daten über HTTP übergeben. Die Übergabe von BLOB-Daten über HTTP ist eine alternative Technik, statt der Verwendung von base64-Kodierung, DIME oder MIME. Beispielsweise können Sie Daten über HTTP in einem Microsoft .NET-Projekt übergeben, das Web Service Enhancement 3.0 verwendet, das DIME oder MIME nicht unterstützt. Bei der Verwendung von BLOB-Daten über HTTP werden die Eingabedaten hochgeladen, bevor der AEM Forms-Dienst aufgerufen wird.

„Aufrufen von AEM Forms mit BLOB-Daten über HTTP“ beschreibt das Aufrufen des folgenden kurzlebigen AEM Forms-Prozesses mit dem Namen MyApplication/EncryptDocument durch Übergabe von BLOB-Daten über HTTP.

Wenn dieser Prozess aufgerufen wird, führt er die folgenden Aktionen aus:

Erstellen einer .NET-Client-Assembly, die Daten über HTTP verwendet creating-a-net-client-assembly-that-uses-data-over-http

Um eine Client-Assembly zu erstellen, die Daten über HTTP verwendet, folgen Sie dem unter Aufrufen von AEM Forms mit Base64-Kodierung beschriebenen Prozess. Ändern Sie jedoch die URL in der Proxy-Klasse so, dass sie ?blob=http anstelle von ?blob=base64 enthält. Diese Aktion stellt sicher, dass Daten über HTTP übergeben werden. Suchen Sie in der Proxy-Klasse die folgende Code-Zeile:

 "http://localhost:8080/soap/services/MyApplication/EncryptDocument";

und ändern Sie sie in:

 "http://localhost:8080/soap/services/MyApplication/EncryptDocument?blob=http";

Referenzieren der .NET clienMyApplication/EncryptDocument-Assembly

Platzieren Sie die neue .NET-Client-Assembly auf dem Computer, auf dem Sie Ihre Client-Anwendung entwickeln. Nachdem Sie die .NET-Client-Assembly in einem Verzeichnis platziert haben, können Sie sie von einem Projekt aus referenzieren. Verweisen Sie auf die System.Web.Services-Bibliothek aus Ihrem Projekt. Wenn Sie diese Bibliothek nicht referenzieren, können Sie die .NET-Client-Assembly nicht zum Aufrufen eines Dienstes verwenden.

Aufrufen eines Dienstes mit einer .NET-Client-Assembly, die BLOB-Daten über HTTP verwendet

Sie können den MyApplication/EncryptDocument-Dienst (der in Workbench erstellt wurde) mit einer .NET-Client-Assembly, die Daten über HTTP verwendet, aufrufen. Um den MyApplication/EncryptDocument-Dienst aufzurufen, führen Sie die folgenden Schritte aus:

Aufrufen eines Dienstes mit Java-Proxy-Klassen und BLOB-Daten über HTTP invoking-a-service-using-java-proxy-classes-and-blob-data-over-http

Sie können einen AEM Forms-Dienst mit Java-Proxy-Klassen und BLOB-Daten über HTTP aufrufen. Um den MyApplication/EncryptDocument-Dienst mit Java-Proxy-Klassen aufzurufen, führen Sie die folgenden Schritte aus:

Aufrufen von AEM Forms mithilfe von DIME invoking-aem-forms-using-dime

Sie können AEM Forms-Services mithilfe von SOAP mit Anhängen aufrufen. AEM Forms unterstützt sowohl MIME- als auch DIME-Webservice-Standards. Mit DIME können Sie binäre Anhänge, wie z. B. PDF-Dokumente, zusammen mit Aufrufanforderungen senden, anstatt den Anhang zu codieren. Der Abschnitt Aufrufen von AEM Forms mithilfe von DIME erläutert das Aufrufen des folgenden kurzlebigen AEM Forms-Prozesses namens MyApplication/EncryptDocument mithilfe von DIME.

Wenn dieser Prozess aufgerufen wird, führt er die folgenden Aktionen aus:

Dieser Prozess basiert nicht auf einem vorhandenen AEM Forms-Prozess. Um den Code-Beispielen folgen zu können, erstellen Sie mithilfe von Workbench einen Prozess mit dem Namen MyApplication/EncryptDocument. (Siehe Verwenden von Workbench.)

Erstellen eines .NET-Projekts, das DIME verwendet creating-a-net-project-that-uses-dime

Führen Sie die folgenden Aufgaben aus, um ein .NET-Projekt zu erstellen, das einen Forms-Service mithilfe von DIME aufrufen kann:

Installation von Web Services Enhancements 2.0

Installieren Sie Web Services Enhancements 2.0 auf Ihrem Entwicklungs-Computer und integrieren Sie es in Microsoft Visual Studio .NET. Sie können Web Services Enhancements 2.0 aus dem Microsoft-Download-Center herunterladen.

Suchen Sie auf dieser Web-Seite nach Web Services Enhancements 2.0 und laden Sie es auf Ihren Entwicklungs-Computer herunter. Durch diesen Download wird eine Datei mit dem Namen „Microsoft WSE 2.0 SPI.msi“ auf Ihrem Computer platziert. Führen Sie das Installationsprogramm aus und folgen Sie den Online-Anweisungen.

Erstellen eines Web-Verweises auf einen AEM Forms-Service

Nachdem Sie Web Services Enhancements 2.0 auf Ihrem Entwicklungs-Computer installiert und ein Microsoft .NET-Projekt erstellt haben, erstellen Sie einen Web-Verweis auf den Forms-Service. Um beispielsweise einen Web-Verweis auf den Prozess MyApplication/EncryptDocument zu erstellen, und unter der Annahme, dass Forms auf dem lokalen Computer installiert ist, geben Sie die folgende URL an:

     http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL

Nachdem Sie einen Web-Verweis erstellt haben, stehen Ihnen die beiden folgenden Proxy-Datentypen zur Verfügung, die Sie in Ihrem .NET-Projekt verwenden können: EncryptDocumentService und EncryptDocumentServiceWse. Um den Prozess MyApplication/EncryptDocument mithilfe von DIME aufzurufen, verwenden Sie den Typ EncryptDocumentServiceWse.

Referenzieren der WSE-Bibliothek

Erstellen eines Web-Verweises auf einen Forms-Service

Aufrufen eines Dienstes mit DIME in einem .NET-Projekt

Sie können einen Forms-Dienst mit DIME aufrufen. Beachten Sie den MyApplication/EncryptDocument-Prozess, der ein ungesichertes PDF-Dokument akzeptiert und ein kennwortverschlüsseltes PDF-Dokument zurückgibt. Um den MyApplication/EncryptDocument-Prozess mit DIME aufzurufen, führen Sie die folgenden Schritte aus:

Erstellen von Apache Axis Java-Proxy-Klassen, die DIME verwenden creating-apache-axis-java-proxy-classes-that-use-dime

Sie können das Apache Axis WSDL2Java-Tool verwenden, um eine Dienst-WSDL in Java-Proxyklassen zu konvertieren, damit Sie Dienstvorgänge aufrufen können. Mithilfe von Apache Ant können Sie Bibliotheksdateien für Axis aus einer AEM Forms-Dienst-WSDL generieren, mit der Sie den Dienst aufrufen können. (Siehe Erstellen von Java-Proxy-Klassen mit Apache Axis.)

Das Apache Axis WSDL2Java-Tool generiert JAVA-Dateien, die Methoden enthalten, die zum Senden von SOAP-Anforderungen an einen Dienst verwendet werden. SOAP-Anforderungen, die von einem Dienst empfangen werden, werden von den von Axis generierten Bibliotheken dekodiert und in die Methoden und Argumente zurückumgewandelt.

Zum Aufrufen des MyApplication/EncryptDocument-Dienstes (der in Workbench erstellt wurde) mit Axis-generierten Bibliotheksdateien und DIME, führen Sie die folgenden Schritte durch:

Siehe auch

Kurzanleitung: Aufrufen eines Services mithilfe von DIME in einem Java-Projekt

Verwenden der SAML-basierten Authentifizierung using-saml-based-authentication

AEM Forms unterstützt beim Aufrufen von Services verschiedene Authentifizierungsmodi für Web-Services. Ein Authentifizierungsmodus ist die Angabe eines Benutzernamens und eines Kennworts mit Hilfe einer einfachen Autorisierungskopfzeile im Aufruf des Web-Services. AEM Forms unterstützt auch die Authentifizierung, die auf einer SAML-Bestätigung basiert. Wenn ein Client-Programm einen AEM Forms-Service mithilfe eines Web-Services aufruft, kann das Client-Programm Authentifizierungsinformationen auf eine der folgenden Arten bereitstellen:

AEM Forms unterstützt keine standardmäßige zertifikatbasierte Authentifizierung, unterstützt jedoch die zertifikatbasierte Authentifizierung in einer anderen Form.

Die Identität von AEM Forms-Benutzern kann durch eine SAML-Bestätigung dargestellt werden, die mithilfe eines geheimen Schlüssels signiert wird. Der folgende XML-Code zeigt ein Beispiel für eine SAML-Bestätigung.

 <Assertion xmlns="urn:oasis:names:tc:SAML:1.0:assertion"
     xmlns:saml="urn:oasis:names:tc:SAML:1.0:assertion"
     xmlns:samlp="urn:oasis:names:tc:SAML:1.0:protocol"
     AssertionID="fd4bd0c87302780e0d9bbfa8726d5bc0" IssueInstant="2008-04-17T13:47:00.720Z" Issuer="LiveCycle"
     MajorVersion="1" MinorVersion="1">
     <Conditions NotBefore="2008-04-17T13:47:00.720Z" NotOnOrAfter="2008-04-17T15:47:00.720Z">
     </Conditions>
     <AuthenticationStatement
         AuthenticationInstant="2008-04-17T13:47:00.720Z"
         AuthenticationMethod="urn:oasis:names:tc:SAML:1.0:am:unspecified">
         <Subject>
             <NameIdentifier NameQualifier="DefaultDom">administrator</NameIdentifier>
             <SubjectConfirmation>
                 <ConfirmationMethod>urn:oasis:names:tc:SAML:1.0:cm:sender-vouches</ConfirmationMethod>
             </SubjectConfirmation>
         </Subject>
     </AuthenticationStatement>
     <ds:Signature >
         <ds:SignedInfo>
             <ds:CanonicalizationMethod Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#"></ds:CanonicalizationMethod>
             <ds:SignatureMethod    Algorithm="https://www.w3.org/2000/09/xmldsig#hmac-sha1"></ds:SignatureMethod>
             <ds:Reference URI="#fd4bd0c87302780e0d9bbfa8726d5bc0">
                 <ds:Transforms>
                     <ds:Transform Algorithm="https://www.w3.org/2000/09/xmldsig#enveloped-signature"></ds:Transform>
                     <ds:Transform Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#">
                         <ec:InclusiveNamespaces
                             PrefixList="code ds kind rw saml samlp typens #default">
                         </ec:InclusiveNamespaces>
                     </ds:Transform>
                 </ds:Transforms>
                 <ds:DigestMethod Algorithm="https://www.w3.org/2000/09/xmldsig#sha1"></ds:DigestMethod>
                 <ds:DigestValue>hVrtqjWr+VzaVUIpQx0YI9lIjaY=</ds:DigestValue>
             </ds:Reference>
         </ds:SignedInfo>
         <ds:SignatureValue>UMbBb+cUcPtcWDCIhXes4n4FxfU=</ds:SignatureValue>
     </ds:Signature>
 </Assertion>

Diese Beispiel-Bestätigung wird für einen Administrator-Benutzer ausgestellt. Diese Bestätigung enthält die folgenden bemerkenswerten Elemente:

Ein Client-Programm kann die Bestätigung von jeder AuthenticationManager-API in AEM Forms abrufen, die ein AuthResult-Objekt zurückgibt. Sie können eine AuthResult-Instanz erhalten, indem Sie eine der beiden folgenden Methoden durchführen:

AEM Forms-Benutzende können mithilfe eines SAML-Tokens authentifiziert werden, das abgerufen wird. Diese SAML-Bestätigung (XML-Fragment) kann als Teil der WS-Security-Kopfzeile mit dem Aufruf des Web-Services zur Benutzerauthentifizierung gesendet werden. In der Regel hat ein Client-Programm einen Benutzer authentifiziert, aber die Anmeldeinformationen des Benutzers nicht gespeichert. (Oder der Benutzer hat sich bei diesem Client über einen anderen Mechanismus als die Verwendung eines Benutzernamens und Kennworts angemeldet.) In dieser Situation muss das Client-Programm AEM Forms aufrufen und einen bestimmten Benutzer verkörpern, der berechtigt ist, AEM Forms aufzurufen.

Um einen bestimmten Benutzer zu verkörpern, rufen Sie die Methode AuthenticationManager.getAuthResultOnBehalfOfUser mithilfe eines Web-Services auf. Diese Methode gibt eine AuthResult-Instanz zurück, die die SAML-Bestätigung für diesen Benutzer enthält.

Verwenden Sie anschließend diese SAML-Bestätigung, um alle Services aufzurufen, für die eine Authentifizierung erforderlich ist. Diese Aktion umfasst das Senden der Bestätigung als Teil der SOAP-Kopfzeile. Wenn mit dieser Bestätigung ein Aufruf eines Web-Services erfolgt, identifiziert AEM Forms den Benutzer als den Benutzer, der durch diese Bestätigung dargestellt wird. Das heißt, der in der Bestätigung angegebene Benutzer ist der Benutzer, der den Service aufruft.

Verwenden von Apache Axis-Klassen und SAML-basierter Authentifizierung using-apache-axis-classes-and-saml-based-authentication

Sie können einen AEM Forms-Service über Java-Proxy-Klassen aufrufen, die mithilfe der Axis-Bibliothek erstellt wurden. (Siehe Erstellen von Java-Proxy-Klassen mithilfe von Apache Axis.)

Wenn Sie AXIS verwenden, das SAML-basierte Authentifizierung verwendet, registrieren Sie den Anfrage- und Antwort-Handler bei Axis. Apache Axis ruft den Handler auf, bevor eine Aufrufanforderung an AEM Forms gesendet wird. Um einen Handler zu registrieren, erstellen Sie eine Java-Klasse, die org.apache.axis.handlers.BasicHandler erweitert.

Erstellen eines AssertionHandlers mit Axis

Die folgende Java-Klasse mit dem Namen AssertionHandler.java zeigt ein Beispiel einer Java-Klasse, die org.apache.axis.handlers.BasicHandler erweitert.

 public class AssertionHandler extends BasicHandler {
        public void invoke(MessageContext ctx) throws AxisFault {
            String assertion = (String) ctx.getProperty(LC_ASSERTION);

            //no assertion hence nothing to insert
            if(assertion == null) return;

            try {
                MessageElement samlElement = new MessageElement(convertToXML(assertion));
                SOAPHeader header = (SOAPHeader) ctx.getRequestMessage().getSOAPHeader();
                //Create the wsse:Security element which would contain the SAML element
                SOAPElement wsseHeader = header.addChildElement("Security", "wsse", WSSE_NS);
                wsseHeader.appendChild(samlElement);
                //remove the actor attribute as in LC we do not specify any actor. This would not remove the actor attribute though
                //it would only remove it from the soapenv namespace
                wsseHeader.getAttributes().removeNamedItem("actor");
            } catch (SOAPException e) {
                throw new AxisFault("Error occured while adding the assertion to the SOAP Header",e);
            }
        }
 }

Registrieren des Handlers

Um einen Handler bei Axis zu registrieren, erstellen Sie eine Datei „client-config.wsdd“. Standardmäßig sucht Axis nach einer Datei mit diesem Namen. Der folgende XML-Code ist ein Beispiel für eine Datei „client-config.wsdd“. Weitere Informationen finden Sie in der Dokumentation zu Axis.

 <deployment xmlns="https://xml.apache.org/axis/wsdd/" xmlns:java="https://xml.apache.org/axis/wsdd/providers/java">
     <transport name="http" pivot="java:org.apache.axis.transport.http.HTTPSender"/>
      <globalConfiguration >
       <requestFlow >
        <handler type="java:com.adobe.idp.um.example.AssertionHandler" />
       </requestFlow >
      </globalConfiguration >
 </deployment>

Aufrufen eines AEM Forms-Service

Im folgenden Code-Beispiel wird ein AEM Forms-Service mit SAML-basierter Authentifizierung aufgerufen.

 public class ImpersonationExample {
        . . .
        public void  authenticateOnBehalf(String superUsername,String password,
                String canonicalName,String domainName) throws UMException, RemoteException{
            ((org.apache.axis.client.Stub) authenticationManager).setUsername(superUsername);
            ((org.apache.axis.client.Stub) authenticationManager).setPassword(password);

            //Step 1 - Invoke the Auth manager api to get an assertion for the user to be impersonated
            AuthResult ar = authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
            String assertion = ar.getAssertion();
            //Step 2 - Setting the assertion here to be picked later by the AssertionHandler. Note that stubs are not threadSafe
            //hence should not be reused. For this simple example we have made them instance variable but care should be taken
            //regarding the thread safety
            ((javax.xml.rpc.Stub) authorizationManager)._setProperty(AssertionHandler.LC_ASSERTION, assertion);
        }

        public Role findRole(String roleId) throws UMException, RemoteException{
            //This api would be invoked under bob's user rights
            return authorizationManager.findRole(roleId);
        }

        public static void main(String[] args) throws Exception {
            ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
            //Get the SAML assertion for the user to impersonate and store it in stub
            ie.authenticateOnBehalf(
                    "administrator", //The Super user which has the required impersonation permission
                    "password", // Password of the super user as referred above
                    "bob", //Cannonical name of the user to impersonate
                    "testdomain" //Domain of the user to impersonate
                    );

            Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
            System.out.println("Role "+r.getName());
        }
 }

Verwenden einer .NET-Client-Assembly und einer SAML-basierten Authentifizierung using-a-net-client-assembly-and-saml-based-authentication

Sie können einen Forms-Service mithilfe einer .NET-Client-Assembly und einer SAML-basierten Authentifizierung aufrufen. Dazu müssen Sie Web Service Enhancements 3.0 (WSE) verwenden. Informationen zum Erstellen einer .NET-Client-Assembly, die WSE verwendet, finden Sie unter Erstellen eines .NET-Projekts, das DIME verwendet.

Die WSE-Architektur verwendet die Datentypen Richtlinien, Assertionen und SecurityToken. Für einen Webservice-Aufruf geben Sie eine Richtlinie an. Eine Richtlinie kann über mehrere Assertionen verfügen. Jede Assertion kann Filter enthalten. Ein Filter wird in bestimmten Phasen eines Webservice-Aufrufs aufgerufen und kann zu diesem Zeitpunkt die SOAP-Anforderung ändern. Ausführliche Informationen finden Sie in der Dokumentation zu Web Service Enhancements 3.0.

Erstellen von Assertion und Filter

Im folgenden C#-Code-Beispiel werden Filter- und Assertionsklassen erstellt. In diesem Code-Beispiel wird ein SamlAssertionOutputFilter erstellt. Dieser Filter wird vom WSE-Framework aufgerufen, bevor die SOAP-Anforderung an AEM Forms gesendet wird.

 class LCSamlPolicyAssertion : Microsoft.Web.ServicES4.Design.PolicyAssertion
 {
        public override Microsoft.Web.ServicES4.SoapFilter CreateClientOutputFilter(FilterCreationContext context)
        {
           return new SamlAssertionOutputFilter();
        }
        . . .
 }


 class SamlAssertionOutputFilter : SendSecurityFilter
 {
        public override void SecureMessage(SoapEnvelope envelope, Security security)
        {
           // Get the SamlToken from the SessionState
           SamlToken samlToken = envelope.Context.Credentials.UltimateReceiver.GetClientToken<SamlToken>();
           security.Tokens.Add(samlToken);
        }
 }

Erstellen des SAML-Tokens

Erstellen Sie eine Klasse, die die SAML-Assertion darstellt. Die Hauptaufgabe dieser Klasse besteht darin, Datenwerte aus der Zeichenfolge in XML zu konvertieren und Leerzeichen beizubehalten. Diese Assertions-XML wird später in die SOAP-Anforderung importiert.

 class SamlToken : SecurityToken
 {
        public const string SAMLAssertion = "https://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1";
        private XmlElement _assertionElement;

        public SamlToken(string assertion)
             : base(SAMLAssertion)
        {
           XmlDocument xmlDoc = new XmlDocument();
           //The white space has to be preserved else the digital signature would get broken
           xmlDoc.PreserveWhitespace = true;
           xmlDoc.LoadXml(assertion);
           _assertionElement = xmlDoc.DocumentElement;
         }

         public override XmlElement GetXml(XmlDocument document)
         {
            return (XmlElement)document.ImportNode(_assertionElement, true);
         }
        . . .
 }

Aufrufen eines AEM Forms-Service

Im folgenden C#-Code-Beispiel wird ein Forms-Service mithilfe der SAML-basierten Authentifizierung aufgerufen.

 public class ImpersonationExample
 {
        . . .
        public void AuthenticateOnBehalf(string superUsername, string password, string canonicalName, string domainName)
        {
            //Create a policy for UsernamePassword Token
            Policy usernamePasswordPolicy = new Policy();
            usernamePasswordPolicy.Assertions.Add(new UsernameOverTransportAssertion());

            UsernameToken token = new UsernameToken(superUsername, password, PasswordOption.SendPlainText);
            authenticationManager.SetClientCredential(token);
            authenticationManager.SetPolicy(usernamePasswordPolicy);

            //Get the SAML assertion for impersonated user
            AuthClient.AuthenticationManagerService.AuthResult ar
                = authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
            System.Console.WriteLine("Received assertion " + ar.assertion);

            //Create a policy for inserting SAML assertion
            Policy samlPolicy = new Policy();
            samlPolicy.Assertions.Add(new LCSamlPolicyAssertion());
            authorizationManager.SetPolicy(samlPolicy);
            //Set the SAML assertion obtained previously as the token
            authorizationManager.SetClientCredential(new SamlToken(ar.assertion));
        }

        public Role findRole(string roleId)
        {
            return authorizationManager.findRole(roleId);
        }

        static void Main(string[] args)
        {
            ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
            ie.AuthenticateOnBehalf(
                 "administrator", //The Super user which has the required impersonation permission
                 "password", // Password of the super user as referred above
                 "bob", //Cannonical name of the user to impersonate
                 "testdomain" //Domain of the user to impersonate
                 );

         Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
            System.Console.WriteLine("Role "+r.name);
     }
 }

Überlegungen zur Verwendung von Webservices related-considerations-when-using-web-services

Manchmal treten Probleme beim Aufrufen bestimmter AEM Forms-Service-Vorgänge über Webservices auf. Ziel dieser Diskussion ist es, diese Probleme zu ermitteln und eine Lösung anzubieten, sofern eine Lösung verfügbar ist.

Asynchrones Aufrufen von Service-Vorgängen invoking-service-operations-asynchronously

Wenn Sie versuchen, einen AEM Forms-Dienstvorgang asynchron aufzurufen, z. B. den htmlToPDF-Vorgang von Generate PDF, tritt eine SoapFaultException auf. Um dieses Problem zu beheben, erstellen Sie eine XML-Datei mit benutzerdefinierter Bindung, die das ExportPDF_Result-Element und andere Elemente in verschiedenen Klassen zuordnet. Die folgende XML-Datei stellt eine benutzerdefinierte Bindungsdatei dar.

 <bindings
        xmlns:xsd="https://www.w3.org/2001/XMLSchema"
        xmlns:jxb="https://java.sun.com/xml/ns/jaxb" jxb:version="1.0"
        xmlns:wsdl="https://schemas.xmlsoap.org/wsdl/"
      wsdlLocation="http://localhost:8080/soap/services/GeneratePDFService?wsdl&async=true&lc_version=9.0.0"
        xmlns="https://java.sun.com/xml/ns/jaxws">
        <enableAsyncMapping>false</enableAsyncMapping>
        <package name="external_customize.client"/>
        <enableWrapperStyle>true</enableWrapperStyle>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='ExportPDF_Result']">
            <jxb:class name="ExportPDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='CreatePDF_Result']">
            <jxb:class name="CreatePDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='HtmlToPDF_Result']">
            <jxb:class name="HtmlToPDFAsyncResult">
            </jxb:class>
        </bindings>
        <bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='OptimizePDF_Result']">
            <jxb:class name="OptimizePDFAsyncResult">
            </jxb:class>
        </bindings>
        <!--bindings node="//wsdl:portType[@name='GeneratePDFService']/wsdl:operation[@name='HtmlToPDF_Result']">
            <jxb:class name="HtmlToPDFAsyncResult"/>
        </bindings-->
 </bindings>

Verwenden Sie diese XML-Datei beim Erstellen von Java-Proxy-Dateien mithilfe von JAX-WS. (Siehe Erstellen von Java-Proxy-Klassen mithilfe von JAX-WS.)

Referenzieren Sie diese XML-Datei beim Ausführen des JAX-WS-Tools („wsimport.exe“) mithilfe der Befehlszeilenoption „- b“. Aktualisieren Sie das wsdlLocation-Element in der Bindungs-XML-Datei, um die URL von AEM Forms anzugeben.

Um sicherzustellen, dass der asynchrone Aufruf funktioniert, ändern Sie den Endpunkt-URL-Wert und geben Sie async=true an. Geben Sie beispielsweise für Java-Proxy-Dateien, die mit JAX-WS erstellt werden, Folgendes für BindingProvider.ENDPOINT_ADDRESS_PROPERTY an.

https://server:port/soap/services/ServiceName?wsdl&async=true&lc_version=9.0.0

Die folgende Liste gibt andere Services an, die eine benutzerdefinierte Bindungsdatei benötigen, wenn sie asynchron aufgerufen werden:

Unterschiede bei J2EE-Anwendungsservern differences-in-j2ee-application-servers

Manchmal ruft eine Proxy-Bibliothek, die mit einem bestimmten J2EE-Programm-Server erstellt wurde, nicht erfolgreich AEM Forms auf, das auf einem anderen J2EE-Programm-Server gehostet wird. Stellen Sie sich eine Proxy-Bibliothek vor, die mit AEM Forms generiert wird, das auf WebSphere bereitgestellt wird. Diese Proxy-Bibliothek kann AEM Forms-Services, die auf dem JBoss-Programm-Server bereitgestellt werden, nicht erfolgreich aufrufen.

Einige komplexe AEM Forms-Datentypen, z. B. PrincipalReference, werden bei der Bereitstellung von AEM Forms auf WebSphere im Vergleich zum JBoss-Programm-Server anders definiert. Der Grund für die Unterschiede in den WSDL-Definitionen liegt in den unterschiedlichen JDKs, die von den verschiedenen J2EE-Programm-Services verwendet werden. Verwenden Sie daher Proxy-Bibliotheken, die vom selben J2EE-Programm-Server generiert werden.

Zugreifen auf mehrere Dienste mithilfe von Webdiensten accessing-multiple-services-using-web-services

Aufgrund von Namespace-Konflikten können Datenobjekte nicht für mehrere Service-WSDLs freigegeben werden. Verschiedene Services können Datentypen gemeinsam nutzen. Daher nutzen die Services die Definition dieser Typen in den WSDLs gemeinsam. Sie können beispielsweise nicht zwei .NET-Client-Assemblys, die einen BLOB-Datentyp enthalten, zum selben .NET-Client-Projekt hinzufügen. Wenn Sie dies versuchen, tritt ein Kompilierungsfehler auf.

In der folgenden Liste sind Datentypen aufgeführt, die nicht von mehreren Service-WSDLs gemeinsam genutzt werden können:

Um dieses Problem zu vermeiden, wird empfohlen, die Datentypen vollständig zu qualifizieren. Betrachten Sie zum Beispiel ein .NET-Programm, das sowohl auf den Forms-Service als auch auf den Signature-Service mit einem Service-Verweis verweist. Beide Service-Verweise enthalten eine BLOB-Klasse. Um eine BLOB-Instanz verwenden zu können, müssen Sie das BLOB-Objekt bei der Deklaration vollständig qualifizieren. Dieser Ansatz wird im folgenden Code-Beispiel veranschaulicht. Informationen zu diesem Code-Beispiel finden Sie unter Digitales Signieren von interaktiven Formularen.

Im folgenden C#-Code-Beispiel wird ein interaktives Formular signiert, das vom Forms-Service gerendert wird. Das Client-Programm hat zwei Service-Verweise. Die BLOB-Instanz, die mit dem Forms-Service verbunden ist, gehört zum Namespace SignInteractiveForm.ServiceReference2. Analog dazu gehört die BLOB-Instanz, die mit dem Signature-Service verbunden ist, zum Namespace SignInteractiveForm.ServiceReference1. Das signierte interaktive Formular wird als PDF-Datei mit dem Namen LoanXFASigned.pdf gespeichert.

 ???/**
     * Ensure that you create a .NET project that uses
     * MS Visual Studio 2008 and version 3.5 of the .NET
     * framework. This is required to invoke a
     * AEM Forms service using MTOM.
     *
     * For information, see "Invoking AEM Forms using MTOM" in Programming with AEM forms
     */
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.ServiceModel;
 using System.IO;

 //A reference to the Signature service
 using SignInteractiveForm.ServiceReference1;

 //A reference to the Forms service
 using SignInteractiveForm.ServiceReference2;

 namespace SignInteractiveForm
 {
        class Program
        {
            static void Main(string[] args)
            {
                try
                {
                    //Because BLOB objects are used in both service references
                    //it is necessary to fully qualify the BLOB objects

                    //Retrieve the form -- invoke the Forms service
                    SignInteractiveForm.ServiceReference2.BLOB formData = GetForm();

                    //Create a BLOB object associated with the Signature service
                    SignInteractiveForm.ServiceReference1.BLOB sigData = new SignInteractiveForm.ServiceReference1.BLOB();

                    //Transfer the byte stream from one Forms BLOB object to the
                    //Signature BLOB object
                    sigData.MTOM = formData.MTOM;

                    //Sign the Form -- invoke the Signature service
                    SignForm(sigData);
                }
                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
            }

            //Creates an interactive PDF form based on a XFA form - invoke the Forms service
            private static SignInteractiveForm.ServiceReference2.BLOB GetForm()
            {

                try
                {
                    //Create a FormsServiceClient object
                    FormsServiceClient formsClient = new FormsServiceClient();
                    formsClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/FormsService?blob=mtom");

                    //Enable BASIC HTTP authentication
                    BasicHttpBinding b = (BasicHttpBinding)formsClient.Endpoint.Binding;
                    b.MessageEncoding = WSMessageEncoding.Mtom;
                    formsClient.ClientCredentials.UserName.UserName = "administrator";
                    formsClient.ClientCredentials.UserName.Password = "password";
                    b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                    b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                    b.MaxReceivedMessageSize = 2000000;
                    b.MaxBufferSize = 2000000;
                    b.ReaderQuotas.MaxArrayLength = 2000000;

                    //Create a BLOB to store form data
                    SignInteractiveForm.ServiceReference2.BLOB formData = new SignInteractiveForm.ServiceReference2.BLOB();
                    SignInteractiveForm.ServiceReference2.BLOB pdfForm = new SignInteractiveForm.ServiceReference2.BLOB();

                    //Specify an XML form data
                    string path = "C:\\Adobe\Loan.xml";
                    FileStream fs = new FileStream(path, FileMode.Open);

                    //Get the length of the file stream
                    int len = (int)fs.Length;
                    byte[] ByteArray = new byte[len];

                    fs.Read(ByteArray, 0, len);
                    formData.MTOM = ByteArray;

                    //Specify an XML form data
                    string path2 = "C:\\Adobe\LoanSigXFA.pdf";
                    FileStream fs2 = new FileStream(path2, FileMode.Open);

                    //Get the length of the file stream
                    int len2 = (int)fs2.Length;
                    byte[] ByteArray2 = new byte[len2];

                    fs2.Read(ByteArray2, 0, len2);
                    pdfForm.MTOM = ByteArray2;

                    PDFFormRenderSpec renderSpec = new PDFFormRenderSpec();
                    renderSpec.generateServerAppearance = true;

                    //Set out parameter values
                    long pageCount = 1;
                    String localValue = "en_US";
                    FormsResult result = new FormsResult();

                    //Render an interactive PDF form
                    formsClient.renderPDFForm2(
                        pdfForm,
                        formData,
                        renderSpec,
                        null,
                        null,
                        out pageCount,
                        out localValue,
                        out result);

                    //Write the data stream to the BLOB object
                    SignInteractiveForm.ServiceReference2.BLOB outForm = result.outputContent;
                    return outForm;
                }
                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
                return null;
            }

            //Sign the form -- invoke the Signature service
            private static void SignForm(SignInteractiveForm.ServiceReference1.BLOB inDoc)
            {

                try
                {
                    //Create a SignatureServiceClient object
                    SignatureServiceClient signatureClient = new SignatureServiceClient();
                    signatureClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/SignatureService?blob=mtom");

                    //Enable BASIC HTTP authentication
                    BasicHttpBinding b = (BasicHttpBinding)signatureClient.Endpoint.Binding;
                    b.MessageEncoding = WSMessageEncoding.Mtom;
                    signatureClient.ClientCredentials.UserName.UserName = "administrator";
                    signatureClient.ClientCredentials.UserName.Password = "password";
                    b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
                    b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
                    b.MaxReceivedMessageSize = 2000000;
                    b.MaxBufferSize = 2000000;
                    b.ReaderQuotas.MaxArrayLength = 2000000;

                    //Specify the name of the signature field
                    string fieldName = "form1[0].grantApplication[0].page1[0].SignatureField1[0]";

                    //Create a Credential object
                    Credential myCred = new Credential();
                    myCred.alias = "secure";

                    //Specify the reason to sign the document
                    string reason = "The document was reviewed";

                    //Specify the location of the signer
                    string location = "New York HQ";

                    //Specify contact information
                    string contactInfo = "Tony Blue";

                    //Create a PDFSignatureAppearanceOptions object
                    //and show date information
                    PDFSignatureAppearanceOptionSpec appear = new PDFSignatureAppearanceOptionSpec();
                    appear.showDate = true;

                    //Sign the PDF document
                    SignInteractiveForm.ServiceReference1.BLOB signedDoc = signatureClient.sign(
                        inDoc,
                        fieldName,
                        myCred,
                        HashAlgorithm.SHA1,
                        reason,
                        location,
                        contactInfo,
                        appear,
                        true,
                        null,
                        null,
                        null);

                    //Populate a byte array with BLOB data that represents the signed form
                    byte[] outByteArray = signedDoc.MTOM;

                    //Save the signed PDF document
                    string fileName = "C:\\Adobe\LoanXFASigned.pdf";
                    FileStream fs2 = new FileStream(fileName, FileMode.OpenOrCreate);

                    //Create a BinaryWriter object
                    BinaryWriter w = new BinaryWriter(fs2);
                    w.Write(outByteArray);
                    w.Close();
                    fs2.Close();
                }

                catch (Exception ee)
                {
                    Console.WriteLine(ee.Message);
                }
            }
        }
 }

Services, die mit dem Buchstaben I beginnen, erzeugen ungültige Proxy-Dateien services-starting-with-the-letter-i-produce-invalid-proxy-files

Die Namen einiger von AEM Forms generierter Proxyklassen sind bei Verwendung von Microsoft .Net 3.5 und WCF falsch. Dieses Problem tritt auf, wenn für den IBMFilenetContentRepositoryConnector, IDPSchedulerService oder einen anderen Dienst, dessen Name mit dem Buchstaben I beginnt, Proxy-Klassen erstellt werden. Beispielsweise lautet der Name des generierten Clients im Fall von IBMFileNetContentRepositoryConnector BMFileNetContentRepositoryConnectorClient. Der Buchstabe I fehlt in der generierten Proxy-Klasse.