AEM Forms mit Web Services aufrufen

Die meisten AEM Forms-Dienste im Dienstcontainer sind so konfiguriert, dass sie einen Webdienst bereitstellen, wobei die WSDL-Generierung (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-Dienstes verwenden. Daher können AEM Forms-Dienste die folgenden SOAP-Nachrichten austauschen und verarbeiten:

• SOAP-Anfrage: Wird von einer Client-Anwendung, die eine Aktion anfordert, an einen Forms-Dienst gesendet.
• SOAP-Antwort: Wird von einem Forms-Dienst an eine Clientanwendung gesendet, nachdem eine SOAP-Anforderung verarbeitet wurde.

Mithilfe von Webdiensten können Sie dieselben AEM Forms-Dienstvorgänge ausführen, die Sie auch über die Java-API ausführen können. Der Vorteil der Verwendung von Webdiensten zum Aufrufen von AEM Forms-Diensten besteht darin, dass Sie eine Clientanwendung in einer Entwicklungsumgebung erstellen können, die SOAP unterstützt. Eine Clientanwendung ist nicht an eine bestimmte Entwicklungsumgebung oder Programmiersprache gebunden. Sie können beispielsweise eine Clientanwendung mit Microsoft Visual Studio .NET und C# als Programmiersprache erstellen.

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

AEM Forms unterstützt die folgenden Webdienststandards:

• Kodierung: Unterstützt nur Dokumenten- und Literalkodierung (die gemäß WSI Basic Profile die bevorzugte Kodierung ist). (Siehe Aufrufen von AEM Forms mit Base64-Kodierung.
• MTOM: Stellt eine Möglichkeit dar, Anlagen mit SOAP-Anforderungen zu kodieren. (Siehe AEM Forms mithilfe von MTOM aufrufen.
• SwaRef: Stellt eine andere Möglichkeit dar, Anlagen mit SOAP-Anforderungen zu kodieren. (Siehe Aufrufen von AEM Forms mithilfe von SwaRef.
• SOAP mit Anlagen: Unterstützt sowohl MIME als auch DIME (Direct Internet Message Encapulation). Diese Protokolle sind Standardmethoden zum Senden von Anhängen über SOAP. Microsoft Visual Studio .NET-Anwendungen verwenden DIME. (Siehe Aufrufen von AEM Forms mit Base64-Kodierung.
• WS-Sicherheit: Unterstützt ein Benutzernamenkennwort-Token-Profil, das eine Standardmethode zum Senden von Benutzernamen und Passwörtern als Teil der SOAP-Kopfzeile von WS-Sicherheit darstellt. AEM Forms unterstützt auch die einfache HTTP-Authentifizierung.

Um AEM Forms-Dienste mit einem Webdienst aufzurufen, erstellen Sie normalerweise eine Proxy-Bibliothek, die die Dienst-WSDL verwendet. Die Aufrufen von AEM Forms mithilfe von Webdiensten -Abschnitt verwendet JAX-WS zum Erstellen von Java-Proxy-Klassen zum Aufrufen von Diensten. (Siehe Erstellen von Java-Proxyklassen mithilfe von JAX-WS.

Sie können einen Dienst-WDSL 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:

• your_serverhost stellt die IP-Adresse des J2EE-Anwendungsservers dar, auf dem AEM Forms gehostet wird.
• your_port stellt den HTTP-Anschluss dar, den der J2EE-Anwendungsserver verwendet.
• service_name stellt den Dienstnamen dar.
• version stellt die Zielversion eines Dienstes dar (standardmäßig wird die neueste Dienstversion verwendet).
• async gibt den Wert an true , um zusätzliche Vorgänge für den asynchronen Aufruf zu aktivieren ( false Standard).
• lc_version stellt die Version von AEM Forms dar, die Sie aufrufen möchten.

In der folgenden Tabelle sind die WSDL-Definitionen des Dienstes aufgeführt (vorausgesetzt, AEM Forms wird auf dem lokalen Host bereitgestellt und der Beitrag ist 8080).

Service	WSDL-Definition
Assembler	http://localhost:8080/soap/services/ AssemblerService?wsdl
Zurück und Wiederherstellen	http://localhost:8080/soap/services/BackupService?wsdl
Barcoded Forms	http://localhost:8080/soap/services/ BarcodedFormsService?wsdl
Convert PDF	http://localhost:8080/soap/services/ ConvertPDFService?wsdl
Distiller	http://localhost:8080/soap/services/ DistillerService?wsdl
DocConverter	http://localhost:8080/soap/services/DocConverterService?WSDL
DocumentManagement	http://localhost:8080/soap/services/DocumentManagementService?WSDL
Encryption-Dienst	http://localhost:8080/soap/services/EncryptionService?wsdl
Formulare	http://localhost:8080/soap/services/FormsService?wsdl
Form Data Integration	http://localhost:8080/soap/services/FormDataIntegration?wsdl
Generate PDF	http://localhost:8080/soap/services/ GeneratePDFService?wsdl
3D-PDF generieren	http://localhost:8080/soap/services/Generate3dPDFService?WSDL
Ausgabe	http://localhost:8080/soap/services/ OutputService?wsdl
PDF Utilities	http://localhost:8080/soap/services/ PDFUtilityService?wsdl
Acrobat Reader DC Extensions	http://localhost:8080/soap/services/ ReaderExtensionsService?wsdl
Repository	http://localhost:8080/soap/services/ RepositoryService?wsdl
Rights Management	http://localhost:8080/soap/services/ RightsManagementService?wsdl
Signatur	http://localhost:8080/soap/services/ SignatureService?wsdl
XMP Utilities	http://localhost:8080/soap/services/ XMPUtilityService?wsdl

WSDL-Definitionen für AEM Forms-Prozesse

Sie müssen den Anwendungsnamen und den Prozessnamen in der WSDL-Definition angeben, um auf eine WSDL zuzugreifen, die zu einem in Workbench erstellten Prozess gehört. Angenommen, der Name der Anwendung 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 Webdiensten

Auf neue AEM Forms-Dienstfunktionen kann über Webdienste zugegriffen werden. In AEM Forms wird beispielsweise die Möglichkeit eingeführt, Anhänge mit MTOM zu kodieren. (Siehe AEM Forms mithilfe von MTOM aufrufen.

Um auf die in AEM Forms eingeführten neuen Funktionen zuzugreifen, geben Sie die lc_version -Attribut in der WSDL-Definition. Um beispielsweise auf neue Dienstfunktionen (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

Webdienst-BLOB-Datentyp

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

A BLOB -Objekt sendet und ruft Binärdaten (z. B. PDF-Dateien, XML-Daten usw.) an und von AEM Forms-Diensten ab. Die BLOB Typ wird in einer Dienst-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 MTOM und swaRef -Felder werden nur in AEM Forms unterstützt. Diese neuen Felder können nur verwendet werden, wenn Sie eine URL angeben, die die Variable lc_version -Eigenschaft.

Bereitstellen von BLOB-Objekten in Dienstanforderungen

Wenn ein AEM Forms-Dienstvorgang BLOB als Eingabewert eingeben, eine Instanz der BLOB Geben Sie in Ihre Anwendungslogik ein. (Viele Schnellstarts des Webdienstes befinden sich unter Programmieren mit AEM Formularen zeigen, wie Sie mit einem BLOB-Datentyp arbeiten.)

Weisen Sie den Feldern, die zum BLOB Instanz wie folgt:

• Base64: Um Daten als Text zu übergeben, der in einem Base64-Format kodiert wurde, legen Sie die Daten im BLOB.binaryData und legen Sie den Datentyp im MIME-Format fest (z. B. application/pdf) im BLOB.contentType -Feld. (Siehe Aufrufen von AEM Forms mit Base64-Kodierung.
• MTOM: Um Binärdaten in einer MTOM-Anlage zu übergeben, legen Sie die Daten in der BLOB.MTOM -Feld. Diese Einstellung hängt die Daten mithilfe des Java JAX-WS-Frameworks oder der nativen API des SOAP-Frameworks an die SOAP-Anfrage an. (Siehe AEM Forms mithilfe von MTOM aufrufen.
• SwaRef: Um Binärdaten in einem WS-I SwaRef-Anhang zu übergeben, legen Sie die Daten im BLOB.swaRef -Feld. Diese Einstellung hängt die Daten mithilfe des Java JAX-WS-Frameworks an die SOAP-Anforderung an. (Siehe Aufrufen von AEM Forms mithilfe von SwaRef.
• MIME- oder DIME-Anlage: Um Daten in einer MIME- oder DIME-Anlage zu übergeben, hängen Sie die Daten mithilfe der nativen API des SOAP-Frameworks an die SOAP-Anfrage an. Legen Sie die Anlagenkennung in der BLOB.attachmentID -Feld. (Siehe Aufrufen von AEM Forms mit Base64-Kodierung.
• Remote URL: Wenn Daten auf einem Webserver gehostet werden und über eine HTTP-URL aufgerufen werden können, legen Sie die HTTP-URL in der BLOB.remoteURL -Feld. (Siehe Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP.

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

Das Übertragungsprotokoll für die Rückgabe BLOB -Objekte hängen von mehreren Faktoren ab, die in der folgenden Reihenfolge berücksichtigt werden und bei Erfüllung der Hauptbedingung angehalten werden:

1. Ziel-URL gibt Übertragungsprotokoll an. Wenn die beim SOAP-Aufruf angegebene Ziel-URL den Parameter enthält blob="BLOB_TYPE", dann BLOB_TYPE bestimmt das Übertragungsprotokoll. BLOB_TYPE ist ein Platzhalter für base64, dime, mime, http, mtom oder slagerf.

2. SOAP-Endpunkt des Dienstes ist intelligent. Wenn die folgenden Bedingungen erfüllt sind, werden die Ausgabedokumente unter Verwendung des gleichen Übertragungsprotokolls wie die Eingabedokumente zurückgegeben:

   • Der SOAP-Endpunktparameter des Diensts Standardprotokoll für Output Blob-Objekte ist auf Smart gesetzt.

     Für jeden Dienst mit einem SOAP-Endpunkt können Sie in der Administration Console das Übertragungsprotokoll für alle zurückgegebenen Blobs angeben. (Siehe Administration-Hilfe.

   • Der AEM Forms-Dienst akzeptiert ein oder mehrere Dokumente als Eingabe.

3. Service SOAP-Endpunkt ist nicht intelligent. Das konfigurierte Protokoll bestimmt das Dokumentübertragungsprotokoll und die Daten werden im entsprechenden BLOB -Feld. Wenn der SOAP-Endpunkt beispielsweise auf DIME gesetzt ist, befindet sich der zurückgegebene Blob im blob.attachmentID -Feld unabhängig vom Übertragungsprotokoll eines Eingabedokuments.

4. Sonst. Wenn ein Dienst den Dokumenttyp nicht als Eingabe verwendet, werden die Ausgabedokumente im BLOB.remoteURL -Feld über das HTTP-Protokoll.

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 mit einem Suffix erweitern:

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

Im Folgenden finden Sie die Korrelation zwischen den Übertragungstypen und dem Feld, aus dem Sie die Daten abrufen:

• Base64-Format: Legen Sie die blob Suffix zu base64 , um die Daten im BLOB.binaryData -Feld.
• MIME- oder DIME-Anlage: Legen Sie die blob Suffix zu DIME oder MIME , um die Daten als entsprechenden Anlagentyp mit der Anlagenkennung zurückzugeben, die im BLOB.attachmentID -Feld. Verwenden Sie die proprietäre API des SOAP-Frameworks, um die Daten aus dem Anhang zu lesen.
• Remote URL: Legen Sie die blob Suffix zu http , um die Daten auf dem Anwendungsserver zu speichern und die URL zurückzugeben, die auf die Daten im BLOB.remoteURL -Feld.
• MTOM oder SwaRef: Legen Sie die blob Suffix zu mtom oder swaref , um die Daten als entsprechenden Anlagentyp mit der Anlagenkennung zurückzugeben, die im BLOB.MTOM oder BLOB.swaRef -Felder. Verwenden Sie die native API des SOAP-Frameworks, um die Daten aus dem Anhang zu lesen.

MTOM-Übertragung von base64-kodierten Byte-Arrays

Zusätzlich zu den BLOB -Objekt, unterstützt das MTOM-Protokoll alle Byte-Array-Parameter oder Byte-Array-Felder eines komplexen Typs. Dies bedeutet, dass Client-SOAP-Frameworks, die MTOM unterstützen, jede xsd:base64Binary -Element als MTOM-Anhang (anstelle eines base64-kodierten Texts). 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 Ausgabe-Byte-Array-Parameter unterstützen MTOM nicht.

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

Webdienst-Datentypen

In der folgenden Tabelle sind die Java-Datentypen und der entsprechende Webdienst-Datentyp aufgeführt.

Java-Datentyp	Webdienst-Datentyp
java.lang.byte[]	xsd:base64Binary
java.lang.Boolean	xsd:boolean
java.util.Date	Die DATE Typ, der in einer Dienst-WSDL wie folgt definiert ist: <complexType name="DATE"> <sequence> <element maxOccurs="1" minOccurs="0" name="date" type="xsd:dateTime" /> <element maxOccurs="1" minOccurs="0" name="calendar" type="xsd:dateTime" /> </sequence> </complexType> Wenn ein AEM Forms-Dienstvorgang java.util.Date als Eingabe verwendet wird, muss die SOAP-Client-Anwendung das Datum in der Variablen DATE.date -Feld. Festlegen der DATE.calendar -Feld in diesem Fall eine Laufzeitausnahme verursacht. Wenn der Dienst eine java.util.Date, wird das Datum im DATE.date -Feld.
java.util.Calendar	Die DATE Typ, der in einer Dienst-WSDL wie folgt definiert ist: <complexType name="DATE"> <sequence> <element maxOccurs="1" minOccurs="0" name="date" type="xsd:dateTime" /> <element maxOccurs="1" minOccurs="0" name="calendar" type="xsd:dateTime" /> </sequence> </complexType> Wenn ein AEM Forms-Dienstvorgang java.util.Calendar als Eingabe verwendet wird, muss die SOAP-Client-Anwendung das Datum in der Variablen DATE.caledendar -Feld. Festlegen der DATE.date -Feld führt in diesem Fall zu einer Laufzeitausnahme. Wenn der Dienst eine java.util.Calendar, wird das Datum im DATE.calendar -Feld.
java.math.BigDecimal	xsd:decimal
com.adobe.idp.Document	BLOB
java.lang.Double	xsd:double
java.lang.Float	xsd:float
java.lang.Integer	xsd:int
java.util.List	MyArrayOf_xsd_anyType
java.lang.Long	xsd:long
java.util.Map	Die apachesoap:Map, der in einer Dienst-WSDL wie folgt definiert ist: <schema elementFormDefault="qualified" targetNamespace="https://xml.apache.org/xml-soap" xmlns="https://www.w3.org/2001/XMLSchema"> <complexType name="mapItem"> <sequence> <element name="key" nillable="true" type="xsd:anyType"/> <element name="value" nillable="true" type="xsd:anyType"/> </sequence> </complexType> <complexType name="Map"> <sequence> <element maxOccurs="unbounded" minOccurs="0" name="item" type="apachesoap:mapItem"/> </sequence> </complexType> </schema> Die Zuordnung wird als Sequenz von Schlüssel/Wert-Paaren dargestellt.
java.lang.Object	$1
java.lang.Short	xsd:short
java.lang.String	xsd:string
org.w3c.dom.Document	Der XML-Typ, der in einer Dienst-WSDL wie folgt definiert ist: <complexType name="XML"> <sequence> <element maxOccurs="1" minOccurs="0" name="document" type="xsd:string" /> <element maxOccurs="1" minOccurs="0" name="element" type="xsd:string" /> </sequence> </complexType> Wenn ein AEM Forms-Dienstvorgang eine org.w3c.dom.Document -Wert, übergeben Sie die XML-Daten im XML.document -Feld. Festlegen der XML.element -Feld verursacht eine Laufzeitausnahme. Wenn der Dienst eine org.w3c.dom.Document, dann werden die XML-Daten im XML.document -Feld.
org.w3c.dom.Element	Der XML-Typ, der in einer Dienst-WSDL wie folgt definiert ist: <complexType name="XML"> <sequence> <element maxOccurs="1" minOccurs="0" name="document" type="xsd:string" /> <element maxOccurs="1" minOccurs="0" name="element" type="xsd:string" /> </sequence> </complexType> Wenn ein AEM Forms-Dienstvorgang org.w3c.dom.Element als Eingabe übergeben Sie die XML-Daten in die XML.element -Feld. Festlegen der XML.document -Feld verursacht eine Laufzeitausnahme. Wenn der Dienst eine org.w3c.dom.Element, werden die XML-Daten im XML.element -Feld.

Erstellen von Java-Proxyklassen mithilfe von JAX-WS

Sie können JAX-WS verwenden, um eine Forms-Dienst-WSDL in Java-Proxyklassen 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 generiert, indem Sie auf eine AEM Forms-Dienst-WSDL verweisen. Sie können JAX-WS-Proxy-Dateien generieren, indem Sie die folgenden Schritte ausführen:

1. Installieren Sie Apache Ant auf dem Clientcomputer. (Siehe https://ant.apache.org/bindownload.cgi.

   • Fügen Sie den Ordner bin zu Ihrem Klassenpfad hinzu.
   • Legen Sie die ANT_HOME -Umgebungsvariable in den Ordner, in dem Sie Ant installiert haben.

2. Installieren Sie JDK 1.6 oder höher.

   • Fügen Sie den Ordner "JDK bin"zum Klassenpfad hinzu.
   • Fügen Sie den Ordner "JRE bin"zum Klassenpfad hinzu. Diese Klasse befindet sich im [JDK_INSTALL_LOCATION] Verzeichnis "/jre".
   • Legen Sie die JAVA_HOME Umgebungsvariable in den Ordner, in dem Sie das JDK installiert haben.

   JDK 1.6 enthält das in der Datei "build.xml"verwendete Programm "wsimport". JDK 1.5 enthält dieses Programm nicht.

3. Installieren Sie JAX-WS auf dem Clientcomputer. (Siehe Java-API für XML-Webdienste.

4. Verwenden Sie JAX-WS und Apache Ant, um Java-Proxyklassen zu generieren. Erstellen Sie ein Ant-Build-Skript, um diese Aufgabe durchzuführen. Das folgende Skript ist ein Beispiel für ein Ant-Build-Skript namens "build.xml":

    <?xml version="1.0" encoding="UTF-8"?>
   
    <project basedir="." default="compile">
   
    <property name="port" value="8080" />
    <property name="host" value="localhost" />
    <property name="username" value="administrator" />
    <property name="password" value="password" />
    <property name="tests" value="all" />
   
    <target name="clean" >
           <delete dir="classes" />
    </target>
   
    <target name="wsdl" depends="clean">
           <mkdir dir="classes"/>
           <exec executable="wsimport" failifexecutionfails="false" failonerror="true" resultproperty="foundWSIMPORT">
               <arg line="-keep -d classes https://${host}:${port}/soap/services/EncryptionService?wsdl&lc_version=9.0.1"/>
           </exec>
           <fail unless="foundWSIMPORT">
              !!! Failed to execute JDK's wsimport tool. Make sure that JDK 1.6 (or later) is on your PATH !!!
           </fail>
    </target>
   
    <target name="compile" depends="clean, wsdl" >
         <javac destdir="./classes" fork="true" debug="true">
            <src path="./src"/>
         </javac>
    </target>
   
    <target name="run">
         <java classname="Client" fork="yes" failonerror="true" maxmemory="200M">
            <classpath>
              <pathelement location="./classes"/>
            </classpath>
            <arg value="${port}"/>
            <arg value="${host}"/>
            <arg value="${username}"/>
            <arg value="${password}"/>
            <arg value="${tests}"/>
         </java>
    </target>
    </project>
   

   Beachten Sie in diesem Ant-Build-Skript, dass die Variable url -Eigenschaft festgelegt ist, um auf die WSDL-Datei für den Verschlüsselungsdienst zu verweisen, die auf localhost ausgeführt wird. Die username und password -Eigenschaften müssen auf einen gültigen AEM für Benutzernamen und Kennwort festgelegt sein. Beachten Sie, dass die URL die lc_version -Attribut. Ohne Angabe von lc_version -Option können Sie keine neuen AEM Forms-Dienstvorgänge aufrufen.

   HINWEIS

   Ersetzen EncryptionService* mit dem AEM Forms-Dienstnamen, den Sie mithilfe von Java-Proxyklassen aufrufen möchten. Um beispielsweise Java-Proxy-Klassen für den Rights Management-Dienst zu erstellen, geben Sie Folgendes an:*

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

5. Erstellen Sie eine BAT-Datei, um das Ant-Build-Skript auszuführen. Der folgende Befehl befindet sich in einer BAT-Datei, die für die Ausführung des Ant-Build-Skripts zuständig ist:

    ant -buildfile "build.xml" wsdl
   

   Positionieren Sie das ANT-Build-Skript im Ordner C:\Program Files\Java\jaxws-ri\bin directory. Das Skript schreibt die JAVA-Dateien in .Ordner /classes . Das Skript generiert JAVA-Dateien, die den Dienst aufrufen können.

6. Verpacken Sie die JAVA-Dateien in einer JAR-Datei. Wenn Sie an Eclipse arbeiten, führen Sie die folgenden Schritte aus:

   • Erstellen Sie ein neues Java-Projekt, das zum Verpacken der JAVA-Proxy-Dateien in eine JAR-Datei verwendet wird.
   • Erstellen Sie einen Quellordner im Projekt.
   • Erstellen Sie eine com.adobe.idp.services -Paket im Ordner Quelle .
   • Wählen Sie die com.adobe.idp.services und importieren Sie dann die JAVA-Dateien aus dem Ordner adobe/idp/services in das Paket.
   • Erstellen Sie bei Bedarf eine org/apache/xml/xmlsoap -Paket im Ordner Quelle .
   • Wählen Sie den Quellordner aus und importieren Sie dann die JAVA-Dateien aus dem Ordner org/apache/xml/xmlsoap .
   • Setzen Sie die Konformitätsstufe des Java-Compilers auf 5.0 oder höher.
   • Erstellen Sie das Projekt.
   • Exportieren Sie das Projekt als JAR-Datei.
   • Importieren Sie diese JAR-Datei in den Klassenpfad eines Client-Projekts. Importieren Sie außerdem alle JAR-Dateien, die sich in <install directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty
   HINWEIS

   Alle Schnellstarts des Java-Webdienstes (mit Ausnahme des Forms-Dienstes) unter Programmieren mit AEM Formularen erstellen Java-Proxy-Dateien mit JAX-WS. Darüber hinaus verwenden Sie SwaRef für alle Schnellstarts des Java-Webdienstes. (Siehe Aufrufen von AEM Forms mithilfe von SwaRef.

Siehe auch

Erstellen von Java-Proxy-Klassen mit 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 mit Apache Axis

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

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

1. Installieren Sie Apache Ant auf dem Clientcomputer. Sie ist abrufbar unter https://ant.apache.org/bindownload.cgi.

   • Fügen Sie den Ordner bin zu Ihrem Klassenpfad hinzu.
   • Legen Sie die ANT_HOME -Umgebungsvariable in den Ordner, in dem Sie Ant installiert haben.

2. Installieren Sie Apache Axis 1.4 auf dem Clientcomputer. Sie ist abrufbar unter https://ws.apache.org/axis/.

3. Richten Sie den Klassenpfad ein, um die Axis JAR-Dateien in Ihrem Webdienst-Client zu verwenden, wie in den Anweisungen zur Axis-Installation unter https://ws.apache.org/axis/java/install.html.

4. Verwenden Sie das Apache WSDL2Java-Tool in Axis, um Java-Proxy-Klassen zu generieren. Erstellen Sie ein Ant-Build-Skript, um diese Aufgabe durchzuführen. Das folgende Skript ist ein Beispiel für ein Ant-Build-Skript namens "build.xml":

    <?xml version="1.0"?>
    <project name="axis-wsdl2java">
   
    <path id="axis.classpath">
    <fileset dir="C:\axis-1_4\lib" >
        <include name="**/*.jar" />
    </fileset>
    </path>
   
    <taskdef resource="axis-tasks.properties" classpathref="axis.classpath" />
   
    <target name="encryption-wsdl2java-client" description="task">
    <axis-wsdl2java
        output="C:\JavaFiles"
        testcase="false"
        serverside="false"
        verbose="true"
        username="administrator"
        password="password"
        url="http://localhost:8080/soap/services/EncryptionService?wsdl&lc_version=9.0.1" >
    </axis-wsdl2java>
    </target>
   
    </project>
   

   Beachten Sie in diesem Ant-Build-Skript, dass die Variable url -Eigenschaft festgelegt ist, um auf die WSDL-Datei für den Verschlüsselungsdienst zu verweisen, die auf localhost ausgeführt wird. Die username und password -Eigenschaften müssen auf einen gültigen AEM für Benutzernamen und Kennwort festgelegt sein.

5. Erstellen Sie eine BAT-Datei, um das Ant-Build-Skript auszuführen. Der folgende Befehl befindet sich in einer BAT-Datei, die für die Ausführung des Ant-Build-Skripts zuständig ist:

    ant -buildfile "build.xml" encryption-wsdl2java-client
   

   Die JAVA-Dateien werden in die Datei C:\JavaFiles folder as specified by the geschrieben. output -Eigenschaft. Um den Forms-Dienst erfolgreich aufzurufen, importieren Sie diese JAVA-Dateien in Ihren Klassenpfad.

   Standardmäßig gehören diese Dateien zu einem Java-Paket mit dem Namen com.adobe.idp.services. Es wird empfohlen, diese JAVA-Dateien in einer JAR-Datei zu platzieren. Importieren Sie dann die JAR-Datei in den Klassenpfad Ihrer Client-Anwendung.

   HINWEIS

   Es gibt verschiedene Möglichkeiten, .JAVA-Dateien in eine JAR zu übertragen. Eine Möglichkeit ist die Verwendung einer Java IDE wie Eclipse. Erstellen Sie ein Java-Projekt und erstellen Sie ein com.adobe.idp.services* Paket (alle .JAVA-Dateien gehören zu diesem Paket). Importieren Sie anschließend alle JAVA-Dateien in das Paket. Exportieren Sie das Projekt schließlich als JAR-Datei.*

6. Ändern Sie die URL im EncryptionServiceLocator -Klasse, um den Kodierungstyp anzugeben. Um beispielsweise base64 zu verwenden, geben Sie ?blob=base64 sicherstellen, dass BLOB -Objekt gibt Binärdaten zurück. Das heißt in der EncryptionServiceLocator -Klasse, suchen Sie die folgende Codezeile:

    http://localhost:8080/soap/services/EncryptionService;
   

   und ändern Sie sie in:

    http://localhost:8080/soap/services/EncryptionService?blob=base64;
   

7. Fügen Sie die folgenden Axis JAR-Dateien zum Klassenpfad Ihres Java-Projekts hinzu:

   • activation.jar
   • achse.jar
   • commons-codec-1.3.jar
   • commons-collections-3.1.jar
   • commons-discovery.jar
   • commons-logging.jar
   • dom3-xml-apis-2.5.0.jar
   • jai_imageio.jar
   • jaxen-1.1-beta-9.jar
   • jaxrpc.jar
   • log4j.jar
   • mail.jar
   • saaj.jar
   • wsdl4j.jar
   • xalan.jar
   • xbean.jar
   • xercesImpl.jar

   Diese JAR-Dateien befinden sich im [Installationsordner]/Adobe/Adobe Experience Manager Forms/sdk/lib/thirdparty directory.

Siehe auch

Erstellen von Java-Proxyklassen mithilfe von 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

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

"AEM Forms mit Base64-Kodierung aufrufen"beschreibt den Aufruf des folgenden kurzlebigen AEM Forms-Prozesses namens MyApplication/EncryptDocument durch Verwendung der Base64-Kodierung.

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

1. Ruft das ungesicherte PDF-Dokument ab, das an den Prozess übergeben wird. Diese Aktion basiert auf dem Vorgang SetValue. Der Eingangsparameter für diesen Prozess ist eine document-Prozessvariable mit dem Namen inDoc.
2. Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Diese Aktion basiert auf dem Vorgang PasswordEncryptPDF. Das kennwortverschlüsselte PDF-Dokument wird in einer Prozessvariablen namens outDoc zurückgegeben.

Erstellen einer .NET-Client-Assembly, die die Base64-Kodierung verwendet

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

1. Erstellen Sie eine Proxy-Klasse basierend auf einer AEM Forms-Aufruf-URL.
2. Erstellen Sie ein Microsoft Visual Studio .NET-Projekt, das die .NET-Client-Assembly erzeugt.

Proxy-Klasse erstellen

Sie können mithilfe eines Tools, das Microsoft Visual Studio begleitet, eine Proxyklasse erstellen, die zum Erstellen der .NET-Clientassembly verwendet wird. Der Name des Tools ist 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. Mit dieser CSS-Datei erstellen Sie ein Proxy-Objekt, mit dem Sie den Dienst aufrufen können, der in der Aufruf-URL angegeben wurde.

Ändern Sie die URL in der Proxy-Klasse, um ?blob=base64 sicherstellen, dass BLOB -Objekt gibt Binärdaten zurück. Suchen Sie in der Proxy-Klasse die folgende Codezeile:

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

und ändern Sie sie in:

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

Die Aufrufen von AEM Forms mit Base64-Kodierung Abschnitt-Verwendung MyApplication/EncryptDocument als Beispiel. Wenn Sie eine .NET-Clientassembly für einen anderen Forms-Dienst erstellen, stellen Sie sicher, dass Sie MyApplication/EncryptDocument mit dem Namen des Dienstes.

Entwickeln der .NET-Clientassembly

Erstellen Sie ein Visual Studio-Klassenbibliotheksprojekt, das eine .NET-Client-Assembly erzeugt. Die CS-Datei, die Sie mit 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 Dienstes verwenden können.

1. Starten Sie Microsoft Visual Studio .NET.
2. Erstellen Sie ein Klassenbibliotheksprojekt und nennen Sie es DocumentService.
3. Importieren Sie die CS-Datei, die Sie mit wsdl.exe erstellt haben.
4. Im Projekt Menü auswählen Referenz hinzufügen.
5. Wählen Sie im Dialogfeld Verweis hinzufügen die Option System.Web.Services.dll.
6. Klicken Auswählen und klicken Sie anschließend auf OK.
7. Kompilieren und erstellen Sie das Projekt.

Referenzieren der .NET-Clientassembly

Platzieren Sie die neu erstellte .NET-Clientassembly auf dem Computer, auf dem Sie Ihre Clientanwendung entwickeln. Nachdem Sie die .NET-Client-Assembly in einem Verzeichnis platziert haben, können Sie sie aus einem Projekt 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.

1. Im Projekt Menü auswählen Referenz hinzufügen.
2. Klicken Sie auf .NET Registerkarte.
3. Klicken Durchsuchen und suchen Sie die Datei "DocumentService.dll".
4. Klicken Auswählen und klicken Sie anschließend auf OK.

Aufrufen eines Dienstes mit einer .NET-Client-Assembly, die die Base64-Kodierung verwendet

Sie können die MyApplication/EncryptDocument -Dienst (der in Workbench erstellt wurde) mit einer .NET-Client-Assembly, die die Base64-Kodierung verwendet. Aufrufen der MyApplication/EncryptDocument -Dienst ausführen, führen Sie die folgenden Schritte aus:

1. Erstellen Sie eine Microsoft .NET-Client-Assembly, die die MyApplication/EncryptDocument Service-WSDL.
2. Erstellen Sie ein Microsoft .NET-Clientprojekt. Verweisen Sie im Clientprojekt auf die Microsoft .NET-Clientassembly. Referenz System.Web.Services.
3. Erstellen Sie mithilfe der Microsoft .NET-Client-Assembly eine MyApplication_EncryptDocumentService -Objekt durch Aufrufen des Standardkonstruktors.
4. Legen Sie die MyApplication_EncryptDocumentService -Objekt Credentials -Eigenschaft mit System.Net.NetworkCredential -Objekt. Innerhalb der System.Net.NetworkCredential -Konstruktor einen AEM Formular-Benutzernamen und das entsprechende Kennwort angeben. Legen Sie Authentifizierungswerte fest, damit Ihre .NET-Clientanwendung SOAP-Nachrichten erfolgreich mit AEM Forms austauschen kann.
5. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Die BLOB -Objekt wird zum Speichern eines PDF-Dokuments verwendet, das an die MyApplication/EncryptDocument Prozess.
6. Erstellen Sie eine System.IO.FileStream -Objekt durch Aufrufen seines Konstruktors. Übergeben Sie einen string -Wert, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
7. Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream -Objekt. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream -Objekt Length -Eigenschaft.
8. Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die System.IO.FileStream -Objekt Read -Methode. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Stream-Länge.
9. Füllen Sie die BLOB Objekt durch Zuweisen seiner binaryData -Eigenschaft mit dem Inhalt des Byte-Arrays.
10. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplication_EncryptDocumentService -Objekt invoke -Methode und Übergabe der BLOB -Objekt, das das PDF-Dokument enthält. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.
11. Erstellen Sie eine System.IO.FileStream -Objekt, indem Sie seinen Konstruktor aufrufen und einen string -Wert übergeben, der den Dateispeicherort des kennwortverschlüsselten Dokuments darstellt.
12. Erstellen Sie ein Byte-Array, das den Dateninhalt der BLOB Objekt, das von der MyApplicationEncryptDocumentService -Objekt invoke -Methode. Füllen Sie das Byte-Array, indem Sie den Wert der BLOB -Objekt binaryData Datenelement.
13. Erstellen Sie eine System.IO.BinaryWriter -Objekt durch Aufrufen des Konstruktors und Übergeben des System.IO.FileStream -Objekt.
14. Schreiben Sie die Byte-Array-Inhalte in eine PDF-Datei, indem Sie die System.IO.BinaryWriter -Objekt Write -Methode verwenden und das Byte-Array übergeben.

Aufrufen eines Dienstes mit Java-Proxy-Klassen und Base64-Kodierung

Sie können einen AEM Forms-Dienst mithilfe von Java-Proxyklassen und Base64 aufrufen. Aufrufen der MyApplication/EncryptDocument -Dienst mit Java-Proxy-Klassen ausführen, führen Sie die folgenden Schritte aus:

1. Erstellen Sie Java-Proxyklassen mit JAX-WS, die die MyApplication/EncryptDocument Service-WSDL. Verwenden Sie den folgenden WSDL-Endpunkt:

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

   HINWEIS

   Ersetzen hiro-xp* mit der IP-Adresse des J2EE-Anwendungsservers, der als Host für AEM Forms dient. *

2. Verpacken Sie die mit JAX-WS erstellten Java-Proxyklassen in eine JAR-Datei.

3. Schließen Sie die Java-Proxy-JAR-Datei und die JAR-Dateien im folgenden Pfad ein:

   <install directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

   in den Klassenpfad Ihres Java-Client-Projekts.

4. Erstellen Sie ein Objekt MyApplicationEncryptDocumentService, indem Sie den Konstruktor verwenden.

5. Erstellen Sie eine MyApplicationEncryptDocument -Objekt durch Aufrufen der MyApplicationEncryptDocumentService -Objekt getEncryptDocument -Methode.

6. Legen Sie die zum Aufrufen von AEM Forms erforderlichen Verbindungswerte fest, indem Sie den folgenden Datenmitgliedern Werte zuweisen:

   • Weisen Sie den WSDL-Endpunkt und den Kodierungstyp dem javax.xml.ws.BindingProvider -Objekt ENDPOINT_ADDRESS_PROPERTY -Feld. Aufrufen der MyApplication/EncryptDocument -Dienst mit Base64-Kodierung verwenden, geben Sie den folgenden URL-Wert an:

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

   • Weisen Sie den AEM forms-Benutzer dem javax.xml.ws.BindingProvider -Objekt USERNAME_PROPERTY -Feld.

   • Weisen Sie den entsprechenden Kennwortwert dem javax.xml.ws.BindingProvider -Objekt PASSWORD_PROPERTY -Feld.

   Das folgende Codebeispiel zeigt diese Anwendungslogik:

    //Set connection values required to invoke AEM Forms
    String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64";
    String username = "administrator";
    String password = "password";
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
   

7. Rufen Sie das PDF-Dokument ab, das an die MyApplication/EncryptDocument Prozess durch Erstellen einer java.io.FileInputStream -Objekt durch Verwendung seines -Konstruktors. Übergeben Sie einen string -Wert, der den Speicherort des PDF-Dokuments angibt.

8. Erstellen Sie ein Byte-Array und füllen Sie es mit dem Inhalt der java.io.FileInputStream -Objekt.

9. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden.

10. Füllen Sie die BLOB -Objekt durch Aufrufen seiner setBinaryData -Methode verwenden und das Byte-Array übergeben. Die BLOB -Objekt setBinaryData ist die Methode, die bei Verwendung der Base64-Kodierung aufgerufen wird. Siehe Bereitstellen von BLOB-Objekten in Dienstanforderungen.

11. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplicationEncryptDocument -Objekt invoke -Methode. Übergeben Sie die BLOB -Objekt, das das PDF-Dokument enthält. Die invoke -Methode gibt eine BLOB -Objekt, das das verschlüsselte PDF-Dokument enthält.

12. Erstellen Sie ein Byte-Array, das das verschlüsselte PDF-Dokument enthält, indem Sie die BLOB -Objekt getBinaryData -Methode.

13. Speichern Sie das verschlüsselte PDF-Dokument als PDF-Datei. Schreiben Sie das Byte-Array in eine Datei.

Siehe auch

Schnellstart: Aufrufen eines Dienstes mit Java-Proxy-Dateien und Base64-Kodierung

Erstellen einer .NET-Client-Assembly, die die Base64-Kodierung verwendet

AEM Forms mithilfe von MTOM aufrufen

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

Die Diskussion hier dreht sich um die Verwendung von MTOM zum Aufrufen des folgenden kurzlebigen AEM Forms-Prozesses namens MyApplication/EncryptDocument.

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

1. Ruft das ungesicherte PDF-Dokument ab, das an den Prozess übergeben wird. Diese Aktion basiert auf dem Vorgang SetValue. Der Eingangsparameter für diesen Prozess ist eine document-Prozessvariable mit dem Namen inDoc.
2. Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Diese Aktion basiert auf dem Vorgang PasswordEncryptPDF. Das kennwortverschlüsselte PDF-Dokument wird in einer Prozessvariablen namens outDoc zurückgegeben.

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 es. Das .NET 3.5-Framework unterstützt ein SOAP-Framework namens Windows Communication Foundation (WCF). Beim Aufrufen von AEM Forms mithilfe von MTOM wird nur WCF (nicht WSE) unterstützt.

Erstellen eines .NET-Projekts, das einen Dienst mit MTOM aufruft

Sie können ein Microsoft .NET-Projekt erstellen, das einen AEM Forms-Dienst mithilfe von Webdiensten aufrufen kann. Erstellen Sie zunächst ein Microsoft .NET-Projekt mit Visual Studio 2008. Um einen AEM Forms-Dienst aufzurufen, erstellen Sie eine Dienstreferenz zum AEM Forms-Dienst, den Sie in Ihrem Projekt aufrufen möchten. Wenn Sie eine Dienstreferenz 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 localhost mit der IP-Adresse des J2EE-Anwendungsservers, der als Host für AEM Forms dient. Ersetzen 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 lc_version -Option stellt sicher, dass AEM Forms-Funktionen wie MTOM verfügbar sind. Ohne Angabe von lc_version -Option können Sie AEM Forms nicht mit MTOM aufrufen.

Nachdem Sie eine Dienstreferenz erstellt haben, sind mit dem AEM Forms-Dienst verknüpfte Datentypen für die Verwendung in Ihrem .NET-Projekt verfügbar. Gehen Sie wie folgt vor, um ein .NET-Projekt zu erstellen, das einen AEM Forms-Dienst aufruft:

1. Erstellen Sie ein .NET-Projekt mit Microsoft Visual Studio 2008.

2. Im Projekt Menü auswählen Dienstreferenz hinzufügen.

3. Im Adresse Geben Sie die WSDL für den AEM Forms-Dienst an. Beispiel:

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

4. Klicken Los und klicken Sie anschließend auf OK.

Aufrufen eines Dienstes mit MTOM in einem .NET-Projekt

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

1. Erstellen Sie ein Microsoft .NET-Projekt.

2. Erstellen Sie eine MyApplication_EncryptDocumentClient -Objekt mithilfe des Standardkonstruktors.

3. Erstellen Sie eine MyApplication_EncryptDocumentClient.Endpoint.Address -Objekt mithilfe der System.ServiceModel.EndpointAddress -Konstruktor. Übergeben Sie einen string -Wert, der die WSDL an den AEM Forms-Dienst und den Kodierungstyp angibt:

    https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=mtom
   

   Sie müssen die lc_version -Attribut. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen. Stellen Sie jedoch sicher, dass Sie ?blob=mtom.

   HINWEIS

   Ersetzen hiro-xp* mit der IP-Adresse des J2EE-Anwendungsservers, der als Host für AEM Forms dient. *

4. Erstellen Sie eine System.ServiceModel.BasicHttpBinding -Objekt durch Abrufen des Werts der EncryptDocumentClient.Endpoint.Binding Datenelement. Wandeln Sie den Rückgabewert in BasicHttpBinding um.

5. Legen Sie die System.ServiceModel.BasicHttpBinding -Objekt MessageEncoding Datenelement in WSMessageEncoding.Mtom. Dieser Wert stellt sicher, dass MTOM verwendet wird.

6. Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:

   • Weisen Sie dem Datenmember den Benutzernamen AEM Formulare zu. MyApplication_EncryptDocumentClient.ClientCredentials.UserName.UserName.
   • Weisen Sie dem Datenmember den entsprechenden Kennwortwert zu MyApplication_EncryptDocumentClient.ClientCredentials.UserName.Password.
   • Konstantenwert zuweisen HttpClientCredentialType.Basic an das Datenelement BasicHttpBindingSecurity.Transport.ClientCredentialType.
   • Konstantenwert zuweisen BasicHttpSecurityMode.TransportCredentialOnly an das Datenelement BasicHttpBindingSecurity.Security.Mode.

   Das folgende Codebeispiel zeigt diese Aufgaben.

    //Enable BASIC HTTP authentication
    encryptProcess.ClientCredentials.UserName.UserName = "administrator";
    encryptProcess.ClientCredentials.UserName.Password = "password";
    b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
    b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
    b.MaxReceivedMessageSize = 4000000;
    b.MaxBufferSize = 4000000;
    b.ReaderQuotas.MaxArrayLength = 4000000;
   

7. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Die BLOB -Objekt wird verwendet, um ein PDF-Dokument zu speichern, das an die MyApplication/EncryptDocument Prozess.

8. Erstellen Sie eine System.IO.FileStream -Objekt durch Aufrufen seines Konstruktors. Übergeben Sie einen string -Wert, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.

9. Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream -Objekt. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream -Objekt Length -Eigenschaft.

10. Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die System.IO.FileStream -Objekt Read -Methode. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Stream-Länge.

11. Füllen Sie die BLOB Objekt durch Zuweisen seiner MTOM -Datenelement mit dem Inhalt des Byte-Arrays.

12. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplication_EncryptDocumentClient -Objekt invoke -Methode. Übergeben Sie die BLOB -Objekt, das das PDF-Dokument enthält. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.

13. Erstellen Sie eine System.IO.FileStream -Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des gesicherten PDF-Dokuments darstellt.

14. Erstellen Sie ein Byte-Array, das den Dateninhalt der BLOB -Objekt, das von der invoke -Methode. Füllen Sie das Byte-Array, indem Sie den Wert der BLOB -Objekt MTOM Datenelement.

15. Erstellen Sie eine System.IO.BinaryWriter -Objekt durch Aufrufen des Konstruktors und Übergeben des System.IO.FileStream -Objekt.

16. Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die System.IO.BinaryWriter -Objekt Write -Methode verwenden und das Byte-Array übergeben.

Siehe auch

Schnellstart: Aufrufen eines Dienstes mit MTOM in einem .NET-Projekt

Zugreifen auf mehrere Dienste mithilfe von Webdiensten

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

Aufrufen von AEM Forms mithilfe von SwaRef

Sie können AEM Forms-Dienste mit SwaRef aufrufen. Der Inhalt der wsi:swaRef XML-Element wird als Anhang innerhalb eines SOAP-Hauptteils gesendet, der die Referenz zum Anhang speichert. Wenn Sie einen Forms-Dienst mithilfe von SwaRef aufrufen, erstellen Sie Java-Proxyklassen mithilfe der Java-API für XML Web Services (JAX-WS). (Siehe Java-API für XML-Webdienste.

In der Diskussion geht es darum, den folgenden kurzlebigen Forms-Prozess mit dem Namen MyApplication/EncryptDocument durch Verwendung von SwaRef.

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

1. Ruft das ungesicherte PDF-Dokument ab, das an den Prozess übergeben wird. Diese Aktion basiert auf dem Vorgang SetValue. Der Eingangsparameter für diesen Prozess ist eine document-Prozessvariable mit dem Namen inDoc.
2. Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Diese Aktion basiert auf dem Vorgang PasswordEncryptPDF. Das kennwortverschlüsselte PDF-Dokument wird in einer Prozessvariablen namens outDoc zurückgegeben.

In der folgenden Diskussion wird beschrieben, wie Sie Forms-Dienste aufrufen, indem Sie SwaRef in einer Java-Clientanwendung verwenden. Die Java-Anwendung verwendet Proxy-Klassen, die mithilfe von JAX-WS erstellt wurden.

Aufrufen eines Dienstes mit JAX-WS-Bibliotheksdateien, die SwaRef verwenden

Aufrufen der MyApplication/EncryptDocument Verarbeiten Sie die Verarbeitung mithilfe von Java-Proxy-Dateien, die mit JAX-WS und SwaRef erstellt wurden, und führen Sie die folgenden Schritte aus:

1. Erstellen Sie Java-Proxyklassen mit JAX-WS, die die MyApplication/EncryptDocument Service-WSDL. Verwenden Sie den folgenden WSDL-Endpunkt:

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

   Weitere Informationen finden Sie unter Erstellen von Java-Proxyklassen mithilfe von JAX-WS.

   HINWEIS

   Ersetzen hiro-xp* mit der IP-Adresse des J2EE-Anwendungsservers, der als Host für AEM Forms dient. *

2. Verpacken Sie die mit JAX-WS erstellten Java-Proxyklassen in eine JAR-Datei.

3. Schließen Sie die Java-Proxy-JAR-Datei und die JAR-Dateien im folgenden Pfad ein:

   <install directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

   in den Klassenpfad Ihres Java-Client-Projekts.

4. Erstellen Sie ein Objekt MyApplicationEncryptDocumentService, indem Sie den Konstruktor verwenden.

5. Erstellen Sie eine MyApplicationEncryptDocument -Objekt durch Aufrufen der MyApplicationEncryptDocumentService -Objekt getEncryptDocument -Methode.

6. Legen Sie die zum Aufrufen von AEM Forms erforderlichen Verbindungswerte fest, indem Sie den folgenden Datenmitgliedern Werte zuweisen:

   • Weisen Sie den WSDL-Endpunkt und den Kodierungstyp dem javax.xml.ws.BindingProvider -Objekt ENDPOINT_ADDRESS_PROPERTY -Feld. Aufrufen der MyApplication/EncryptDocument Dienst mit SwaRef-Kodierung, geben Sie den folgenden URL-Wert an:

      https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=swaref

   • Weisen Sie den AEM forms-Benutzer dem javax.xml.ws.BindingProvider -Objekt USERNAME_PROPERTY -Feld.

   • Weisen Sie den entsprechenden Kennwortwert dem javax.xml.ws.BindingProvider -Objekt PASSWORD_PROPERTY -Feld.

   Das folgende Codebeispiel zeigt diese Anwendungslogik:

    //Set connection values required to invoke AEM Forms
    String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=swaref";
    String username = "administrator";
    String password = "password";
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
   

7. Rufen Sie das PDF-Dokument ab, das an die MyApplication/EncryptDocument Prozess durch Erstellen einer java.io.File -Objekt durch Verwendung seines -Konstruktors. Übergeben Sie einen string -Wert, der den Speicherort des PDF-Dokuments angibt.

8. Erstellen Sie eine javax.activation.DataSource -Objekt mithilfe der FileDataSource -Konstruktor. Übergeben Sie die java.io.File -Objekt.

9. Erstellen Sie ein javax.activation.DataHandler-Objekt, indem Sie seinen Konstruktor verwenden und das javax.activation.DataSource-Objekt übergeben.

10. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden.

11. Füllen Sie die BLOB -Objekt durch Aufrufen seiner setSwaRef -Methode und Übergabe der javax.activation.DataHandler -Objekt.

12. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplicationEncryptDocument -Objekt invoke -Methode und Übergabe der BLOB -Objekt, das das PDF-Dokument enthält. Die invoke -Methode gibt eine BLOB -Objekt, das ein verschlüsseltes PDF-Dokument enthält.

13. Füllen einer javax.activation.DataHandler -Objekt durch Aufrufen der BLOB -Objekt getSwaRef -Methode.

14. Konvertieren Sie die javax.activation.DataHandler -Objekt java.io.InputSteam -Instanz durch Aufrufen der javax.activation.DataHandler -Objekt getInputStream -Methode.

15. Schreiben Sie die java.io.InputSteam -Instanz in eine PDF-Datei, die das verschlüsselte PDF-Dokument darstellt.

Siehe auch

Schnellstart: Aufrufen eines Dienstes mit SwaRef in einem Java-Projekt

Aufrufen von AEM Forms mithilfe von BLOB-Daten über 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 Methode, anstatt die Base64-Kodierung, DIME oder MIME zu verwenden. 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 Verwendung von BLOB-Daten über HTTP werden Eingabedaten hochgeladen, bevor der AEM Forms-Dienst aufgerufen wird.

"Aufrufen von AEM Forms mithilfe von BLOB-Daten über HTTP"beschreibt den Aufruf des folgenden kurzlebigen AEM Forms-Prozesses namens MyApplication/EncryptDocument durch Übergabe von BLOB-Daten über HTTP.

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

1. Ruft das ungesicherte PDF-Dokument ab, das an den Prozess übergeben wird. Diese Aktion basiert auf dem Vorgang SetValue. Der Eingangsparameter für diesen Prozess ist eine document-Prozessvariable mit dem Namen inDoc.
2. Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Diese Aktion basiert auf dem Vorgang PasswordEncryptPDF. Das kennwortverschlüsselte PDF-Dokument wird in einer Prozessvariablen namens outDoc zurückgegeben.

Erstellen einer .NET-Client-Assembly, die Daten über HTTP verwendet

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

 "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-Clientassembly auf dem Computer, auf dem Sie Ihre Clientanwendung entwickeln. Nachdem Sie die .NET-Client-Assembly in einem Verzeichnis platziert haben, können Sie sie aus einem Projekt referenzieren. Verweisen Sie auf 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.

1. Im Projekt Menü auswählen Referenz hinzufügen.
2. Klicken Sie auf .NET Registerkarte.
3. Klicken Durchsuchen und suchen Sie die Datei "DocumentService.dll".
4. Klicken Auswählen und klicken Sie anschließend auf OK.

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

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

1. Erstellen Sie die .NET-Client-Assembly.
2. Verweisen Sie auf die Microsoft .NET-Clientassembly. Erstellen Sie ein Microsoft .NET-Clientprojekt. Verweisen Sie im Clientprojekt auf die Microsoft .NET-Clientassembly. Referenz System.Web.Services.
3. Erstellen Sie mithilfe der Microsoft .NET-Client-Assembly eine MyApplication_EncryptDocumentService -Objekt durch Aufrufen des Standardkonstruktors.
4. Legen Sie die MyApplication_EncryptDocumentService -Objekt Credentials -Eigenschaft mit System.Net.NetworkCredential -Objekt. Innerhalb der System.Net.NetworkCredential -Konstruktor einen AEM Formular-Benutzernamen und das entsprechende Kennwort angeben. Legen Sie Authentifizierungswerte fest, damit Ihre .NET-Clientanwendung SOAP-Nachrichten erfolgreich mit AEM Forms austauschen kann.
5. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Die BLOB -Objekt wird verwendet, um Daten an die MyApplication/EncryptDocument Prozess.
6. Weisen Sie dem BLOB -Objekt remoteURL Datenelement, das den URI-Speicherort eines PDF-Dokuments angibt, das an die MyApplication/EncryptDocumentDienst.
7. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplication_EncryptDocumentService -Objekt invoke -Methode und Übergabe der BLOB -Objekt. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.
8. Erstellen Sie eine System.UriBuilder -Objekt mithilfe des Konstruktors und Übergabe des Werts des zurückgegebenen BLOB -Objekt remoteURL Datenelement.
9. Konvertieren Sie die System.UriBuilder -Objekt System.IO.Stream -Objekt. (Der auf diese Liste folgende C#-Schnellstart zeigt, wie diese Aufgabe ausgeführt wird.)
10. Erstellen Sie ein Byte-Array und fügen Sie es mit den Daten im System.IO.Stream -Objekt.
11. Erstellen Sie eine System.IO.BinaryWriter -Objekt durch Aufrufen des Konstruktors und Übergeben des System.IO.FileStream -Objekt.
12. Schreiben Sie die Byte-Array-Inhalte in eine PDF-Datei, indem Sie die System.IO.BinaryWriter -Objekt Write -Methode verwenden und das Byte-Array übergeben.

Aufrufen eines Dienstes mithilfe von Java-Proxy-Klassen und BLOB-Daten über HTTP

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

1. Erstellen Sie Java-Proxyklassen mit JAX-WS, die die MyApplication/EncryptDocument Service-WSDL. Verwenden Sie den folgenden WSDL-Endpunkt:

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

   Weitere Informationen finden Sie unter Erstellen von Java-Proxyklassen mithilfe von JAX-WS.

   HINWEIS

   Ersetzen hiro-xp* mit der IP-Adresse des J2EE-Anwendungsservers, der als Host für AEM Forms dient. *

2. Verpacken Sie die mit JAX-WS erstellten Java-Proxyklassen in eine JAR-Datei.

3. Schließen Sie die Java-Proxy-JAR-Datei und die JAR-Dateien im folgenden Pfad ein:

   <install directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

   in den Klassenpfad Ihres Java-Client-Projekts.

4. Erstellen Sie ein Objekt MyApplicationEncryptDocumentService, indem Sie den Konstruktor verwenden.

5. Erstellen Sie eine MyApplicationEncryptDocument -Objekt durch Aufrufen der MyApplicationEncryptDocumentService -Objekt getEncryptDocument -Methode.

6. Legen Sie die zum Aufrufen von AEM Forms erforderlichen Verbindungswerte fest, indem Sie den folgenden Datenmitgliedern Werte zuweisen:

   • Weisen Sie den WSDL-Endpunkt und den Kodierungstyp dem javax.xml.ws.BindingProvider -Objekt ENDPOINT_ADDRESS_PROPERTY -Feld. Aufrufen der MyApplication/EncryptDocument -Dienst, der BLOB über HTTP-Kodierung verwendet, geben Sie den folgenden URL-Wert an:

     https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=http

   • Weisen Sie den AEM forms-Benutzer dem javax.xml.ws.BindingProvider -Objekt USERNAME_PROPERTY -Feld.

   • Weisen Sie den entsprechenden Kennwortwert dem javax.xml.ws.BindingProvider -Objekt PASSWORD_PROPERTY -Feld.

   Das folgende Codebeispiel zeigt diese Anwendungslogik:

    //Set connection values required to invoke AEM Forms
    String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=http";
    String username = "administrator";
    String password = "password";
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
    ((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
   

7. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden.

8. Füllen Sie die BLOB -Objekt durch Aufrufen seiner setRemoteURL -Methode. Übergeben Sie einen string -Wert, der den URI-Speicherort eines PDF-Dokuments angibt, das an die MyApplication/EncryptDocument Dienst.

9. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der MyApplicationEncryptDocument -Objekt invoke -Methode und Übergabe der BLOB -Objekt, das das PDF-Dokument enthält. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.

10. Erstellen Sie ein Byte-Array, um den Datenstrom zu speichern, der das verschlüsselte PDF-Dokument darstellt. Rufen Sie die BLOB -Objekt getRemoteURL -Methode (verwenden Sie die BLOB Objekt, das von der invoke -Methode).

11. Erstellen Sie ein Objekt java.io.File, indem Sie den Konstruktor verwenden. Dieses Objekt stellt das verschlüsselte PDF-Dokument dar.

12. Erstellen Sie ein java.io.FileOutputStream-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.File-Objekt übergeben.

13. Rufen Sie die java.io.FileOutputStream -Objekt write -Methode. Übergeben Sie das Byte-Array, das den Datenstrom enthält, der das verschlüsselte PDF-Dokument darstellt.

AEM Forms mithilfe von DIME aufrufen

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

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

1. Ruft das ungesicherte PDF-Dokument ab, das an den Prozess übergeben wird. Diese Aktion basiert auf dem Vorgang SetValue. Der Eingangsparameter für diesen Prozess ist eine document-Prozessvariable mit dem Namen inDoc.
2. Sie verschlüsselt das PDF-Dokument mit einem Kennwort. Diese Aktion basiert auf dem Vorgang PasswordEncryptPDF. Das kennwortverschlüsselte PDF-Dokument wird in einer Prozessvariablen namens outDoc zurückgegeben.

Dieser Prozess basiert nicht auf einem vorhandenen AEM Forms-Prozess. Um den Codebeispielen zu folgen, erstellen Sie einen Prozess mit dem Namen MyApplication/EncryptDocument**Verwendung von Workbench. (Siehe Verwenden von Workbench.)

Erstellen eines .NET-Projekts, das DIME verwendet

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

• Installieren Sie Web Services Enhancements 2.0 auf Ihrem Entwicklungscomputer.
• Erstellen Sie in Ihrem .NET-Projekt eine Webreferenz zum FormsAEM Forms-Dienst.

Web-Services-Verbesserungen 2.0 installieren

Installieren Sie Web Services Enhancements 2.0 auf Ihrem Entwicklungscomputer und integrieren Sie es in Microsoft Visual Studio .NET. Sie können die Web-Services-Verbesserungen 2.0 von der Microsoft-Download-Center.

Suchen Sie auf dieser Webseite nach Web Services Enhancements 2.0 und laden Sie es auf Ihren Entwicklungscomputer 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.

Webverweis auf einen AEM Forms-Dienst erstellen

Nachdem Sie Web Services Enhancements 2.0 auf Ihrem Entwicklungscomputer installiert und ein Microsoft .NET-Projekt erstellt haben, erstellen Sie eine Webreferenz zum Forms-Dienst. So erstellen Sie beispielsweise eine Webreferenz zum MyApplication/EncryptDocument verarbeiten und vorausgesetzt, dass Forms auf dem lokalen Computer installiert ist, geben Sie die folgende URL an:

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

Nachdem Sie eine Webreferenz erstellt haben, stehen Ihnen die beiden folgenden Proxy-Datentypen zur Verfügung, die Sie in Ihrem .NET-Projekt verwenden können: EncryptDocumentService und EncryptDocumentServiceWse. Aufrufen der MyApplication/EncryptDocument Prozess mit DIME, verwenden Sie die EncryptDocumentServiceWse Typ.

Referenzieren der WSE-Bibliothek

1. Wählen Sie im Menü Projekt die Option Verweis hinzufügen aus.
2. Wählen Sie im Dialogfeld Verweis hinzufügen die Option Microsoft.Web.Services2.dll aus.
3. Wählen Sie System.Web.Services.dll aus.
4. Klicken Sie auf Auswählen und dann auf OK.

Webverweis auf einen Forms-Dienst erstellen

1. Wählen Sie im Menü Projekt die Option Webverweis hinzufügen aus.
2. Geben Sie im Dialogfeld "URL"die URL zum Forms-Dienst an.
3. Klicken Sie auf Los und dann auf Verweis hinzufügen .

Aufrufen eines Dienstes mit DIME in einem .NET-Projekt

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

1. Erstellen Sie ein Microsoft .NET-Projekt, mit dem Sie einen Forms-Dienst mit DIME aufrufen können. Stellen Sie sicher, dass Sie die Web-Services-Verbesserungen 2.0 einbeziehen und eine Webreferenz zum AEM Forms-Dienst erstellen.

2. Nachdem Sie einen Webverweis auf die MyApplication/EncryptDocument Prozess erstellen, EncryptDocumentServiceWse -Objekt mithilfe des Standardkonstruktors.

3. Legen Sie die EncryptDocumentServiceWse -Objekt Credentials Datenelement mit System.Net.NetworkCredential -Wert, der den Benutzernamen und den Wert für AEM Formulare angibt.

4. Erstellen Sie eine Microsoft.Web.Services2.Dime.DimeAttachment -Objekt mithilfe des -Konstruktors und Übergabe der folgenden Werte:

   • Ein string -Wert, der einen GUID-Wert angibt. Sie können einen GUID-Wert abrufen, indem Sie die System.Guid.NewGuid.ToString -Methode.
   • Ein string -Wert, der den Inhaltstyp angibt. Da für diesen Vorgang ein PDF-Dokument erforderlich ist, geben Sie application/pdf.
   • A TypeFormat Auflistungswert. Geben Sie TypeFormat.MediaType.
   • Ein string -Wert, der den Speicherort des PDF-Dokuments angibt, das an den AEM Forms-Prozess übergeben werden soll.

5. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden.

6. Fügen Sie die DIME-Anlage zum BLOB -Objekt durch Zuweisen der Microsoft.Web.Services2.Dime.DimeAttachment -Objekt Id Datenmember-Wert zu BLOB -Objekt attachmentID Datenelement.

7. Rufen Sie die EncryptDocumentServiceWse.RequestSoapContext.Attachments.Add -Methode und übergeben Sie die Microsoft.Web.Services2.Dime.DimeAttachment -Objekt.

8. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der EncryptDocumentServiceWse -Objekt invoke -Methode und Übergabe der BLOB -Objekt, das die DIME-Anlage enthält. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.

9. Rufen Sie den Anlagenkennungswert ab, indem Sie den Wert der zurückgegebenen BLOB -Objekt attachmentID Datenelement.

10. Iterieren Sie durch die Anlagen unter EncryptDocumentServiceWse.ResponseSoapContext.Attachments und verwenden Sie den Anlagenkennungswert, um das verschlüsselte PDF-Dokument abzurufen.

11. Abrufen einer System.IO.Stream -Objekt durch Abrufen des Werts der Attachment -Objekt Stream Datenelement.

12. Erstellen Sie ein Byte-Array und übergeben Sie dieses Byte-Array an die System.IO.Stream -Objekt Read -Methode. Diese Methode füllt das Byte-Array mit einem Datenstrom, der das verschlüsselte PDF-Dokument darstellt.

13. Erstellen Sie eine System.IO.FileStream -Objekt durch Aufrufen des Konstruktors und Übergeben eines Zeichenfolgenwerts, der einen Speicherort der PDF-Datei darstellt. Dieses Objekt stellt das verschlüsselte PDF-Dokument dar.

14. Erstellen Sie eine System.IO.BinaryWriter -Objekt durch Aufrufen des Konstruktors und Übergeben des System.IO.FileStream -Objekt.

15. Schreiben Sie den Inhalt des Byte-Arrays in die PDF-Datei, indem Sie die System.IO.BinaryWriter -Objekt Write -Methode verwenden und das Byte-Array übergeben.

Erstellen von Apache Axis Java-Proxy-Klassen, die DIME verwenden

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 der Achse generierten Bibliotheken dekodiert und in die Methoden und Argumente zurückumgewandelt.

Aufrufen der MyApplication/EncryptDocument -Dienst (der in Workbench erstellt wurde) mit Axis-generierten Bibliotheksdateien und DIME ausführen:

1. Erstellen Sie Java-Proxy-Klassen, die die MyApplication/EncryptDocument Dienst-WSDL mit Apache Axis. (Siehe Erstellen von Java-Proxy-Klassen mit Apache Axis.

2. Schließen Sie die Java-Proxy-Klassen in Ihren Klassenpfad ein.

3. Erstellen Sie ein Objekt MyApplicationEncryptDocumentServiceLocator, indem Sie den Konstruktor verwenden.

4. Erstellen Sie eine URL -Objekt, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der die WSDL-Definition des AEM Forms-Dienstes angibt. Stellen Sie sicher, dass Sie ?blob=dime am Ende der SOAP-Endpunkt-URL. Beispiele

    https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=dime.
   

5. Erstellen Sie eine EncryptDocumentSoapBindingStub -Objekt durch Aufrufen des Konstruktors und Übergeben des MyApplicationEncryptDocumentServiceLocator-Objekt und URL -Objekt.

6. Legen Sie den AEM für Benutzernamen und Kennwort fest, indem Sie die EncryptDocumentSoapBindingStub -Objekt setUsername und setPassword -Methoden.

    encryptionClientStub.setUsername("administrator");
    encryptionClientStub.setPassword("password");
   

7. Rufen Sie das PDF-Dokument ab, das an die MyApplication/EncryptDocument Dienst durch Erstellen eines java.io.File -Objekt. Übergeben Sie einen string -Wert, der den Speicherort des PDF-Dokuments angibt.

8. Erstellen Sie eine javax.activation.DataHandler -Objekt mithilfe des -Konstruktors und Übergeben eines javax.activation.FileDataSource -Objekt. Die javax.activation.FileDataSource -Objekt kann mit seinem Konstruktor erstellt und die java.io.File -Objekt, das das PDF-Dokument darstellt.

9. Erstellen Sie eine org.apache.axis.attachments.AttachmentPart -Objekt durch Verwendung seines Konstruktors und Übergabe des javax.activation.DataHandler -Objekt.

10. Anhängen der Anlage durch Aufrufen der EncryptDocumentSoapBindingStub -Objekt addAttachment -Methode und Übergabe der org.apache.axis.attachments.AttachmentPart -Objekt.

11. Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Füllen Sie die BLOB -Objekt mit dem Anlagenkennungswert durch Aufrufen der BLOB -Objekt setAttachmentID -Methode und Übergabe des Anlagenkennungswerts. Dieser Wert kann durch Aufrufen der org.apache.axis.attachments.AttachmentPart -Objekt getContentId -Methode.

12. Rufen Sie die MyApplication/EncryptDocument -Prozess durch Aufrufen der EncryptDocumentSoapBindingStub -Objekt invoke -Methode. Übergeben Sie die BLOB -Objekt, das die DIME-Anlage enthält. Dieser Prozess gibt ein verschlüsseltes PDF-Dokument innerhalb eines BLOB -Objekt.

13. Rufen Sie den Anlagenkennungswert ab, indem Sie die zurückgegebene BLOB -Objekt getAttachmentID -Methode. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Kennungswert des zurückgegebenen Anhangs darstellt.

14. Rufen Sie die Anlagen ab, indem Sie die EncryptDocumentSoapBindingStub -Objekt getAttachments -Methode. Diese Methode gibt ein Array von Objects , die die Anlagen darstellen.

15. Iterieren Sie durch die Anlagen (die Object -Array) und verwenden Sie den Anlagenkennungswert, um das verschlüsselte PDF-Dokument abzurufen. Jedes Element ist eine org.apache.axis.attachments.AttachmentPart -Objekt.

16. Erhalten Sie die javax.activation.DataHandler -Objekt, das mit der Anlage verknüpft ist, durch Aufrufen der org.apache.axis.attachments.AttachmentPart -Objekt getDataHandler -Methode.

17. Abrufen einer java.io.FileStream -Objekt durch Aufrufen der javax.activation.DataHandler -Objekt getInputStream -Methode.

18. Erstellen Sie ein Byte-Array und übergeben Sie dieses Byte-Array an die java.io.FileStream -Objekt read -Methode. Diese Methode füllt das Byte-Array mit einem Datenstrom, der das verschlüsselte PDF-Dokument darstellt.

19. Erstellen Sie ein Objekt java.io.File, indem Sie den Konstruktor verwenden. Dieses Objekt stellt das verschlüsselte PDF-Dokument dar.

20. Erstellen Sie ein java.io.FileOutputStream-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.File-Objekt übergeben.

21. Rufen Sie die java.io.FileOutputStream -Objekt write -Methode verwenden und das Byte-Array übergeben, das den Datenstrom enthält, der das verschlüsselte PDF-Dokument darstellt.

Siehe auch

Schnellstart: Aufrufen eines Dienstes mit DIME in einem Java-Projekt

Verwenden der SAML-basierten Authentifizierung

AEM Forms unterstützt beim Aufrufen von Diensten verschiedene Webdienst-Authentifizierungsmodi. Ein Authentifizierungsmodus gibt sowohl einen Benutzernamen als auch einen Kennwortwert mithilfe eines einfachen Autorisierungsheaders im Webdienstaufruf an. AEM Forms unterstützt auch die SAML-Assertionsbasierte Authentifizierung. Wenn eine Clientanwendung einen AEM Forms-Dienst mithilfe eines Webdiensts aufruft, kann die Clientanwendung Authentifizierungsinformationen auf eine der folgenden Arten bereitstellen:

• Übergeben von Anmeldeinformationen als Teil der grundlegenden Autorisierung
• Übergeben des Benutzername-Tokens als Teil der WS-Security-Kopfzeile
• Übergeben einer SAML-Assertion als Teil der WS-Security-Kopfzeile
• Weitergeben des Kerberos-Tokens als Teil der WS-Security-Kopfzeile

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

Die Identität AEM Formularbenutzer kann durch eine SAML-Zusicherung dargestellt werden, die mithilfe eines geheimen Schlüssels signiert wurde. Der folgende XML-Code zeigt ein Beispiel für eine SAML-Assertion.

 <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 Beispielassertion wird für einen Administrator ausgestellt. Diese Zusicherung enthält die folgenden merklichen Elemente:

• Sie gilt für eine bestimmte Dauer.
• Sie wird für einen bestimmten Benutzer ausgestellt.
• Es ist digital signiert. Jede daran vorgenommene Änderung würde also die Signatur beschädigen.
• Sie kann AEM Forms als Token der Benutzeridentität ähnlich dem Benutzernamen und Kennwort angezeigt werden.

Eine Clientanwendung kann die Zusicherung von jeder AEM Forms AuthenticationManager-API abrufen, die eine AuthResult -Objekt. Sie können eine AuthResult -Instanz eine der folgenden beiden Methoden ausführen:

• Authentifizieren des Benutzers mit einer der Authentifizierungsmethoden, die von der AuthenticationManager-API verfügbar gemacht werden. Normalerweise würden der Benutzername und das Kennwort verwendet. Sie können jedoch auch die Zertifikatauthentifizierung verwenden.
• Verwenden der AuthenticationManager.getAuthResultOnBehalfOfUser -Methode. Mit dieser Methode kann eine Client-Anwendung eine AuthResult -Objekt für AEM Formularbenutzer.

Ein AEM Formularbenutzer kann mithilfe eines SAML-Tokens authentifiziert werden, das abgerufen wird. Diese SAML-Assertion (XML-Fragment) kann als Teil der WS-Security-Kopfzeile mit dem Webdienst-Aufruf zur Benutzerauthentifizierung gesendet werden. In der Regel hat eine Clientanwendung einen Benutzer authentifiziert, die Benutzeranmeldeinformationen jedoch nicht gespeichert. (Oder der Benutzer hat sich über einen anderen Mechanismus als die Verwendung eines Benutzernamens und Kennworts bei diesem Client angemeldet.) In diesem Fall muss die Client-Anwendung AEM Forms aufrufen und die Identität eines bestimmten Benutzers annehmen, der AEM Forms aufrufen darf.

Rufen Sie die AuthenticationManager.getAuthResultOnBehalfOfUser -Methode mithilfe eines Webdiensts. Diese Methode gibt eine AuthResult -Instanz, die die SAML-Assertion für diesen Benutzer enthält.

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

Verwenden von Apache Axis-Klassen und SAML-basierter Authentifizierung

Sie können einen AEM Forms-Dienst über Java-Proxyklassen aufrufen, die mit der Axis-Bibliothek erstellt wurden. (Siehe Erstellen von Java-Proxy-Klassen mit 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.

Erstellen eines AssertionHandlers mit Achse

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

 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);
            }
        }
 }

Handler registrieren

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 Achsen .

 <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-Dienstes

Im folgenden Codebeispiel wird ein AEM Forms-Dienst 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 SAML-basierten Authentifizierung

Sie können einen Forms-Dienst mithilfe einer .NET-Client-Assembly und einer SAML-basierten Authentifizierung aufrufen. Dazu müssen Sie die Webdienstverbesserungen 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, Zuordnungen und SecurityToken . Geben Sie kurz für einen Webdienstaufruf eine Richtlinie an. Eine Richtlinie kann über mehrere Assertionen verfügen. Jede Assertion kann Filter enthalten. Ein Filter wird in bestimmten Phasen eines Webdienstaufrufs aufgerufen und kann zu diesem Zeitpunkt die SOAP-Anforderung ändern. Ausführliche Informationen finden Sie in der Dokumentation zu Web Service-Verbesserungen 3.0 .

Erstellen der Zusicherung und des Filters

Im folgenden C#-Codebeispiel werden Filter- und Assertionsklassen erstellt. In diesem Codebeispiel 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-Dienstes

Im folgenden C#-Codebeispiel wird ein Forms-Dienst 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 Webdiensten

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

Asynchrones Aufrufen von Dienstvorgängen

Wenn Sie versuchen, einen AEM Forms-Dienstvorgang asynchron aufzurufen, z. B. die PDF "Generate" htmlToPDF Vorgang, SoapFaultException auftritt. Um dieses Problem zu beheben, erstellen Sie eine XML-Datei mit benutzerdefinierter Bindung, die die ExportPDF_Result Elemente und andere Elemente in verschiedene Klassen. 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-Proxyklassen mithilfe von JAX-WS.

Referenzieren Sie diese XML-Datei beim Ausführen des JAX-WS-Tools (wsimport.exe) mithilfe des - b Befehlszeilenoption. Aktualisieren Sie die 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. Geben Sie beispielsweise für Java-Proxy-Dateien, die mit JAX-WS erstellt werden, Folgendes für die BindingProvider.ENDPOINT_ADDRESS_PROPERTY.

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

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

• PDFG 3D
• Task Manager
• Anwendungs-Manager
• Directory Manager
• Distiller
• Rights Management
• Document Management

Unterschiede bei J2EE-Anwendungsservern

Manchmal ruft eine Proxy-Bibliothek, die mit einem bestimmten J2EE-Anwendungsserver erstellt wurde, nicht erfolgreich AEM Forms auf, das auf einem anderen J2EE-Anwendungsserver 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-Dienste, die auf dem JBoss Application 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 zu JBoss Application Server anders definiert. Unterschiede in den JDKs, die von den verschiedenen J2EE-Anwendungsdiensten verwendet werden, sind der Grund, warum es Unterschiede in WSDL-Definitionen gibt. Verwenden Sie daher Proxy-Bibliotheken, die vom selben J2EE-Anwendungsserver generiert werden.

Zugreifen auf mehrere Dienste mithilfe von Webdiensten

Aufgrund von Namespace-Konflikten können Datenobjekte nicht für mehrere Service-WSDLs freigegeben werden. Verschiedene Dienste können Datentypen gemeinsam nutzen. Daher teilen sich die Dienste die Definition dieser Typen in den WSDLs. Sie können beispielsweise nicht zwei .NET-Clientassemblys hinzufügen, die eine BLOB Datentyp auf dasselbe .NET-Client-Projekt verweist. 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:

• User
• Principals
• PrincipalReference
• Groups
• Roles
• BLOB

Um dieses Problem zu vermeiden, wird empfohlen, die Datentypen vollständig zu qualifizieren. Angenommen, eine .NET-Anwendung, die sowohl auf den Forms-Dienst als auch auf den Signature-Dienst verweist, verwendet eine Dienstreferenz. Beide Dienstverweise enthalten eine BLOB -Klasse. So verwenden Sie eine BLOB -Instanz die BLOB -Objekt, wenn Sie es deklarieren. Dieser Ansatz wird im folgenden Codebeispiel veranschaulicht. Weitere Informationen zu diesem Codebeispiel finden Sie unter Digital Signing Interactive Forms.

Das folgende C#-Codebeispiel signiert ein interaktives Formular, das vom Forms-Dienst wiedergegeben wird. Die Clientanwendung verfügt über zwei Dienstreferenzen. Die BLOB -Instanz, die mit dem Forms-Dienst verknüpft ist, gehört zum SignInteractiveForm.ServiceReference2 Namespace. Ebenso wird die BLOB -Instanz, die mit dem Signature-Dienst verknüpft ist, gehört zum SignInteractiveForm.ServiceReference1 Namespace. Das signierte interaktive Formular wird als PDF-Datei mit dem Namen LoanXFASigned.pdf.

 ???/**
     * 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 a 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 a 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);
                }
            }
        }
 }

Dienste, die mit dem Brief beginnen Ich produziere ungültige Proxy-Dateien

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