Web サービスを使用した AEM Forms の呼び出し invoking-aem-forms-using-web-services

ターゲット URL は送信プロトコルを指定します。SOAP 呼び出しで指定されたターゲット URL に blob="BLOB_TYPE というパラメーターでが含まれる場合、BLOB_TYPE は送信プロトコルを決定します。BLOB_TYPE は、base64、dime、mime、http、mtom や swaref のプレースホルダーです。

サービス SOAP エンドポイントがスマートです。次の条件が true の場合、出力ドキュメントは入力ドキュメントと同じ送信プロトコルを使用して返されます。

• サービスの SOAP エンドポイントパラメーターの出力 BLOB オブジェクトのデフォルトプロトコルは、スマートに設定されています。

  SOAP エンドポイントを持つ各サービスについて、管理コンソールを使用すると、返された Blob の送信プロトコルを指定できます。（管理ヘルプを参照してください）。

• AEM Forms サービスは、1 つ以上のドキュメントを入力として取得します。

サービス SOAP エンドポイントがスマートではありません。設定されたプロトコルがドキュメント送信プロトコルを決定し、データは対応する BLOB フィールドに返されます。例えば、SOAP エンドポイントが DIME に設定されている場合、返される BLOB は入力ドキュメントの送信プロトコルに関係なく、blob.attachmentID フィールドにあります。

それ以外の場合。サービスがドキュメントタイプを入力として取得しない場合、出力ドキュメントは HTTP プロトコル経由で BLOB.remoteURL のフィールドに返されます。

クライアントコンピューターに Apache Ant をインストールします。（https://ant.apache.org/bindownload.cgi を参照。）

• bin ディレクトリをクラスパスに追加します。
• ANT_HOME 環境変数を、Ant をインストールしたディレクトリに設定します。

JDK 1.6 以降をインストールします。

• JDK bin ディレクトリをクラスパスに追加します。
• JRE bin ディレクトリをクラスパスに追加します。この bin は、[JDK_INSTALL_LOCATION]/jre ディレクトリに配置されています。
• JAVA_HOME 環境変数を、JDK をインストールしたディレクトリに設定します。

JDK 1.6 には、build.xml ファイルで使用される wsimport プログラムが含まれています。JDK 1.5 には、このプログラムは含まれていません。

JAX-WS をクライアントコンピューターにインストールします。（XML web サービス用 Java API を参照。）

JAX-WS と Apache Ant を使用して、Java プロキシクラスを生成します。このタスクを実行する Ant ビルドスクリプトを作成します。次のスクリプトは、build.xml という名前の Ant ビルドスクリプトのサンプルです。

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

この Ant ビルドスクリプト内では、 url プロパティは、localhost で実行されている 暗号化サービス WSDL を参照するように設定されていることにご注意ください。この username および password プロパティは、有効な AEM forms のユーザー名とパスワードに設定する必要があります。URL には lc_version フィールド名が含まれていることにご注意ください。lc_version オプションを指定しない場合、新しい AEM Forms サービス操作を呼び出すことはできません。

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

Ant ビルドスクリプトを実行する BAT ファイルを作成します。Ant ビルドスクリプトの実行を担う BAT ファイルには、次のコマンドを配置できます。

 ant -buildfile "build.xml" wsdl

Ant ビルドスクリプトを C:\Program Files\Java\jaxws-ri\bin ディレクトリに配置します。このスクリプトで、JAVA ファイルを./classes フォルダーに書き込みます。このスクリプトが生成する JAVA ファイル群で、サービスを呼び出すことができます。

これらの JAVA ファイルを 1 つの JAR ファイルにパッケージ化します。Eclipse で作業している場合は、次の手順に従います。

• プロキシ JAVA ファイルを JAR ファイルにパッケージ化するために使用する、Java プロジェクトを作成します。
• プロジェクトにソースフォルダーを作成します。
• ソースフォルダーにcom.adobe.idp.servicesパッケージを作成します。
• com.adobe.idp.servicesパッケージを選択して、JAVA ファイルを adobe/idp/services フォルダーからこのパッケージにインポートします。
• 必要に応じて、org/apache/xml/xmlsoapパッケージをソースフォルダーに作成します。
• ソースフォルダーを選択し、org/apache/xml/xmlsoap フォルダーから JAVA ファイルをインポートしてください。
• Java コンパイラーのコンプライアンスレベルを 5.0 以上に設定します。
• プロジェクトをビルドします。
• プロジェクトを JAR ファイルとしてエクスポートします。
• この JAR ファイルをクライアントプロジェクトのクラスパスに読み込みます。さらに、<Install Directory>\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty にあるすべての JAR ファイルを読み込みます。

クライアントコンピューターに Apache Ant をインストールします。https://ant.apache.org/bindownload.cgi で入手できます。

• bin ディレクトリをクラスパスに追加します。
• ANT_HOME 環境変数を、Ant をインストールしたディレクトリに設定します。

Apache Axis 1.4 をクライアントコンピューターにインストールします。https://ws.apache.org/axis/ で入手できます。

Web サービスクライアントで Axis JAR ファイルを使用するクラスパスを設定します。詳しくは、https://ws.apache.org/axis/java/install.html にある Axis インストール手順を参照してください。

Axis で Apache WSDL2Java ツールを使用して、Java プロキシクラスを生成します。このタスクを実行する Ant ビルドスクリプトを作成します。次のスクリプトは、build.xml という名前の Ant ビルドスクリプトのサンプルです。

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

この Ant ビルドスクリプトでは、url プロパティは、localhost で実行している暗号化サービス WSDL を参照するように設定されています。username プロパティと password プロパティには、AEM Forms の有効なユーザー名とパスワードを設定する必要があります。

Ant ビルドスクリプトを実行する BAT ファイルを作成します。Ant ビルドスクリプトの実行を担う BAT ファイルには、次のコマンドを配置できます。

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

JAVA ファイルは、output プロパティで指定したように、C:\JavaFiles フォルダーに書き込まれます。Forms サービスを正常に呼び出すには、これらの JAVA ファイルをクラスパスにインポートします。

デフォルトでは、これらのファイルは、 com.adobe.idp.services という名前の Java パッケージに属します。これらの JAVA ファイルは、JAR ファイルに配置することをお勧めします。次に、JAR ファイルをクライアントアプリケーションのクラスパスに読み込みます。

URL を EncryptionServiceLocator クラス内で修正して、エンコーディングタイプを指定します。例えば、base64 を使用するには、BLOB オブジェクトが確実にバイナリデータを返すように、 ?blob=base64 を指定します。つまり、 EncryptionServiceLocator クラス内で、次のコード行を探します。

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

これを次のように変更します。

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

Java プロジェクトのクラスパスに以下の Axis JAR ファイルを 追加します。

• activation.jar
• axis.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

これらの JAR ファイルは、[install directory]/Adobe/Adobe Experience Manager Forms/sdk/lib/thirdparty ディレクトリにあります。

MyApplication/EncryptDocumentサービス WSDL を使用する JAX-WS を使用して、Java プロキシクラスを作成します。次の WSDL エンドポイントを使用します。

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

JAX-WS を使用して作成した Java プロキシクラスを JAR ファイルにパッケージ化します。

次のパスに Java プロキシ JAR ファイルと JAR ファイルを含めます。

<Install Directory>\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

を Java クライアントプロジェクトのクラスパスに追加します。

コンストラクターを使用して MyApplicationEncryptDocumentService オブジェクトを作成します。

MyApplicationEncryptDocumentService オブジェクトの getEncryptDocument メソッドを呼び出すことにより、MyApplicationEncryptDocument オブジェクトを作成します。

次のデータメンバーに値を割り当てて、AEM Forms を呼び出すのに必要な接続値を設定します。

• WSDL エンドポイントとエンコーディングのタイプを javax.xml.ws.BindingProvider オブジェクトの ENDPOINT_ADDRESS_PROPERTY フィールドに割り当てます。Base64 エンコーディングを使用する MyApplication/EncryptDocument サービスを呼び出すには、次の URL 値を指定します。

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

• AEM Forms ユーザーを javax.xml.ws.BindingProvider オブジェクトの USERNAME_PROPERTY フィールドに割り当てます。

• 対応するパスワード値を javax.xml.ws.BindingProvider オブジェクトの PASSWORD_PROPERTY フィールドに割り当てます。

次のコード例に、このアプリケーションロジックを示します。

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

MyApplication/EncryptDocument プロセスに送信する PDF ドキュメントを取得するには、コンストラクターを使用して java.io.FileInputStream オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。

バイト配列を作成し、 java.io.FileInputStream オブジェクトの内容を入力します。

それ自身のコンストラクタを使用して、BLOB オブジェクトを作成します。

setBinaryData メソッドを呼び出し、バイト配列を渡すことによって、BLOB オブジェクトを入力します。BLOB オブジェクトの setBinaryData は、Base64 エンコーディングを使用する場合に呼び出すメソッドです。「サービスリクエストでの BLOB オブジェクトの供給」を参照してください。

MyApplicationEncryptDocument オブジェクトの invoke メソッドを呼び出すことによって、MyApplication/EncryptDocument プロセスを呼び出します。PDF ドキュメントを含む BLOB オブジェクトを渡します。呼び出しメソッドは、暗号化された PDF ドキュメントを含む BLOB オブジェクトを返します。

BLOB オブジェクトの getBinaryData メソッドを呼び出して、暗号化された PDF ドキュメントを含むバイト配列を作成します。

暗号化された PDF ドキュメントを PDF ファイルとして保存します。バイト配列をファイルに書き込みます。

Microsoft Visual Studio 2008 を使用して .NET プロジェクトを作成します。

プロジェクト ​メニューから、「サービス参照を追加」を選択します。

住所 ​ダイアログボックスで、AEM Forms サービスへの WSDL を指定します。例：

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

「 移動」をクリックし、「OK」をクリックします。

Microsoft .NET プロジェクトを作成します。

デフォルトのコンストラクタを使用して MyApplication_EncryptDocumentClient オブジェクトを作成します。

System.ServiceModel.EndpointAddress コンストラクタを使用して MyApplication_EncryptDocumentClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスとエンコーディングタイプに渡します。

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

lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。ただし、?blob=mtom を指定する必要があります。

EncryptDocumentClient.Endpoint.Binding データメンバーの値を取得して System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding データメンバーを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

次のタスクを実行して、HTTP 基本認証を有効にします。

• AEM Forms ユーザー名をデータメンバー MyApplication_EncryptDocumentClient.ClientCredentials.UserName.UserName に割り当てます。
• 対応するパスワード値をデータメンバー MyApplication_EncryptDocumentClient.ClientCredentials.UserName.Password に割り当てます。
• 定数値 HttpClientCredentialType.Basic をデータメンバーに BasicHttpBindingSecurity.Transport.ClientCredentialType に割り当てます。
• 定数値 BasicHttpSecurityMode.TransportCredentialOnly をデータメンバーに BasicHttpBindingSecurity.Security.Mode に割り当てます。

次のコードの例に、これらのタスクを示します。

 //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;

コンストラクタを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、MyApplication/EncryptDocument プロセスに渡す PDF ドキュメントを保存するために使用されます。

コンストラクタを呼び出して System.IO.FileStream オブジェクトを作成します。PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡します。

System.IO.FileStream オブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStream オブジェクトの Length プロパティを取得して、バイト配列のサイズを決定することができます。

System.IO.FileStream オブジェクトの Read メソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。

BLOB オブジェクトを入力するには、MTOM データメンバーにバイト配列のコンテンツを割り当てます。

MyApplication/EncryptDocument プロセスを呼び出すには、MyApplication_EncryptDocumentClient オブジェクトの invoke メソッドを呼び出します。PDF ドキュメントを含む BLOB オブジェクトを渡します。このプロセスは、BLOB オブジェクト内で暗号化された PDF ドキュメントを返します。

System.IO.FileStream オブジェクトを作成するには、コンストラクタを呼び出し、保護された PDF ドキュメントのファイルの場所を表す文字列値を渡します。

invoke メソッドが返した BLOB オブジェクトのデータコンテンツを格納するバイト配列を作成します。BLOB オブジェクトの MTOM データメンバーの値を取得して、バイト配列にデータを入力します。

コンストラクターを呼び出して System.IO.FileStream オブジェクトを渡すことによって、System.IO.BinaryWriter オブジェクトを作成します。

System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出してバイト配列を渡すことにより、バイト配列の内容を PDF ファイルに書き込みます。

MyApplication/EncryptDocument サービス WSDL を消費する JAX-WS を使用して、Java プロキシファイルを作成します。次の WSDL エンドポイントを使用します。

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

詳しくは、 JAX-WS を使用した Java プロキシクラスの作成を参照してください。

JAX-WS を使用して作成した Java プロキシクラスを JAR ファイルにパッケージ化します。

次のパスに Java プロキシ JAR ファイルと JAR ファイルを含めます。

<Install Directory>\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

を Java クライアントプロジェクトのクラスパスに追加します。

コンストラクターを使用して MyApplicationEncryptDocumentService オブジェクトを作成します。

MyApplicationEncryptDocumentService オブジェクトの getEncryptDocument メソッドを呼び出すことにより、MyApplicationEncryptDocument オブジェクトを作成します。

次のデータメンバーに値を割り当てて、AEM Forms を呼び出すのに必要な接続値を設定します。

• WSDL エンドポイントとエンコーディングのタイプを javax.xml.ws.BindingProvider オブジェクトの ENDPOINT_ADDRESS_PROPERTY フィールドに割り当てます。SwaRef エンコーディングを使用する MyApplication/EncryptDocument サービスを呼び出すには、次の URL 値を指定します。

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

• AEM Forms ユーザーを javax.xml.ws.BindingProvider オブジェクトの USERNAME_PROPERTY フィールドに割り当てます。

• 対応するパスワード値を javax.xml.ws.BindingProvider オブジェクトの PASSWORD_PROPERTY フィールドに割り当てます。

次のコード例に、このアプリケーションロジックを示します。

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

MyApplication/EncryptDocument プロセスに送信する PDF ドキュメントを取得するには、コンストラクターを使用して java.io.File オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。

FileDataSourceコンストラクターを使用してjavax.activation.DataSourceオブジェクトを作成します。java.io.Fileオブジェクトを渡します。

javax.activation.DataHandler オブジェクトを作成するには、コンストラクタを使用して javax.activation.DataSource オブジェクトに渡します。

コンストラクタを使用して BLOB オブジェクトを作成します。

BLOBオブジェクトを入力するには、setSwaRefメソッドを呼び出してjavax.activation.DataHandlerオブジェクトを渡します。

MyApplication/EncryptDocument プロセスを呼び出すには、MyApplicationEncryptDocument オブジェクトの invoke メソッドを呼び出し、PDF ドキュメントを含む BLOB オブジェクトを渡します。呼び出しメソッドは、暗号化された PDF ドキュメントを含む BLOB オブジェクトを返します。

BLOB オブジェクトの getSwaRef メソッドを呼び出して javax.activation.DataHandler オブジェクトを入力します。

javax.activation.DataHandler オブジェクトを java.io.InputSteam インスタンスに変換するには、javax.activation.DataHandler オブジェクトの getInputStream メソッドを呼び出します。

暗号化された PDF ドキュメントを表す PDF ファイルにjava.io.InputSteamインスタンスを書き出します。

MyApplication/EncryptDocumentサービス WSDL を使用する JAX-WS を使用して、Java プロキシクラスを作成します。次の WSDL エンドポイントを使用します。

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

詳しくは、 JAX-WS を使用した Java プロキシクラスの作成を参照してください。

JAX-WS を使用して作成した Java プロキシクラスを JAR ファイルにパッケージ化します。

次のパスに Java プロキシ JAR ファイルと JAR ファイルを含めます。

<Install Directory>\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty

を Java クライアントプロジェクトのクラスパスに追加します。

コンストラクターを使用して MyApplicationEncryptDocumentService オブジェクトを作成します。

MyApplicationEncryptDocumentService オブジェクトの getEncryptDocument メソッドを呼び出すことにより、MyApplicationEncryptDocument オブジェクトを作成します。

次のデータメンバーに値を割り当てて、AEM Forms を呼び出すのに必要な接続値を設定します。

• WSDL エンドポイントとエンコーディングのタイプを javax.xml.ws.BindingProvider オブジェクトの ENDPOINT_ADDRESS_PROPERTY フィールドに割り当てます。HTTP エンコーディング経由での BLOB を使用して MyApplication/EncryptDocument サービスを呼び出すには、次の URL 値を指定します。

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

• AEM Forms ユーザーを javax.xml.ws.BindingProvider オブジェクトの USERNAME_PROPERTY フィールドに割り当てます。

• 対応するパスワード値を javax.xml.ws.BindingProvider オブジェクトの PASSWORD_PROPERTY フィールドに割り当てます。

次のコード例に、このアプリケーションロジックを示します。

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

コンストラクタを使用して BLOB オブジェクトを作成します。

setRemoteURL メソッドを呼び出して BLOB オブジェクトを入力します。MyApplication/EncryptDocument サービスに渡す PDF ドキュメントの URI の場所を指定する文字列値を渡します。

MyApplication/EncryptDocument プロセスを呼び出すには、MyApplicationEncryptDocument オブジェクトの invoke メソッドを呼び出し、PDF ドキュメントを含む BLOB オブジェクトを渡します。このプロセスは、暗号化された PDF ドキュメントを BLOB オブジェクト内に返します。

暗号化された PDF ドキュメントを表すデータストリームを格納するバイト配列を作成します。BLOB オブジェクトの getRemoteURL メソッド を呼び出します（invoke メソッドで返された BLOB オブジェクトを使用）。

コンストラクタを使用して java.io.File オブジェクトを作成します。このオブジェクトは、暗号化された PDF ドキュメントを表します。

java.io.FileOutputStream オブジェクトを作成するには、コンストラクタを使用して java.io.File オブジェクトを渡します。

java.io.FileOutputStream オブジェクトの write メソッドを呼び出します。暗号化された PDF ドキュメントを表すデータストリームを含むバイト配列を渡します。

DIME を使用してForms サービスの呼び出しを可能にする Microsoft .NET プロジェクトを作成します。必ず web サービス拡張機能 2.0 を含め、AEM Forms サービスへの web 参照を作成します。

MyApplication/EncryptDocument プロセスへの web 参照を設定した後、デフォルトのコンストラクターを使用して EncryptDocumentServiceWse オブジェクトを作成します。

AEM Forms のユーザー名とパスワードの値を指定する System.Net.NetworkCredential 値で、EncryptDocumentServiceWse オブジェクトの Credentials データメンバーを設定します。

コンストラクターを使用して Microsoft.Web.Services2.Dime.DimeAttachment オブジェクトを作成し、次の値を渡します。

• GUID 値を指定する文字列値。System.Guid.NewGuid.ToString メソッドを呼び出すことによって、GUID 値を取得できます。
• コンテンツタイプを指定する文字列値。このプロセスには PDF ドキュメントが必要なため、application/pdf を指定します。
• TypeFormat 列挙値。以下のように TypeFormat.MediaType を指定します。
• AEM Forms プロセスに渡す PDF ドキュメントの場所を指定する文字列値。

BLOB オブジェクトを、そのコンストラクタを使用して作成します。

Microsoft.Web.Services2.Dime.DimeAttachment オブジェクトの Id データメンバーの値を BLOB オブジェクトの attachmentID データメンバーに割り当てて、BLOB オブジェクトに DIME 添付ファイルを追加します。

EncryptDocumentServiceWse.RequestSoapContext.Attachments.Add メソッドを呼び出して、Microsoft.Web.Services2.Dime.DimeAttachment オブジェクトを渡します。

EncryptDocumentServiceWse オブジェクトの invoke メソッドを呼び出し、DIME 添付ファイルを含む BLOB オブジェクトを渡すことによって、MyApplication/EncryptDocument プロセスを呼び出します。このプロセスは、暗号化された PDF ドキュメントを BLOB オブジェクト内に返します。

返された BLOB オブジェクトの attachmentID データメンバーの値を取得することによって、添付ファイルの識別子の値を取得します。

EncryptDocumentServiceWse.ResponseSoapContext.Attachments の添付ファイルを繰り返し処理し、添付ファイルの識別子の値を使用して、暗号化された PDF ドキュメントを取得します。

Attachment オブジェクトの Stream データメンバーの値を取得することによって、System.IO.Stream オブジェクトを取得します。

バイト配列を作成し、そのバイト配列を System.IO.Stream オブジェクトの Read メソッドに渡します。このメソッドは、暗号化された PDF ドキュメントを表すデータストリームでバイト配列を入力します。

コンストラクターを呼び出し、PDF ファイルの場所を表す文字列値を渡すことによって、System.IO.FileStream オブジェクトを作成します。このオブジェクトは、暗号化された PDF ドキュメントを表します。

System.IO.BinaryWriter オブジェクトを作成するには、コンストラクターを呼び出し、System.IO.FileStream オブジェクトを渡します。

System.IO.BinaryWriter オブジェクトの Write メソッドを呼び出し、バイト配列を渡すことによって、バイト配列の内容を PDF ファイルに書き込みます。

Apache Axis を使用して MyApplication/EncryptDocument サービス WSDL を使用する、Java プロキシクラスを作成します（Apache Axis を使用した Java プロキシクラスの作成を参照）。

Java プロキシクラスをクラスパスに含めます。

MyApplicationEncryptDocumentServiceLocator オブジェクトを、それ自身のコンストラクタを使用して作成します。

URL オブジェクトを作成するには、コンストラクターを使用して、AEM Forms サービス WSDL の定義を指定する文字列値を渡します。SOAP エンドポイント URL の末尾に配置された ?blob=dime を、必ず指定してください。例えば、

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

EncryptDocumentSoapBindingStub オブジェクトを作成するには、コンストラクターを呼び出し、MyApplicationEncryptDocumentServiceLocator オブジェクトと URL オブジェクトを渡します。

EncryptDocumentSoapBindingStub オブジェクトの setUsername および setPassword メソッドを呼び出して、AEM Forms のユーザー名とパスワードの値を設定します。

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

MyApplication/EncryptDocument サービスに送信する PDF ドキュメントを取得するには、java.io.File オブジェクトを作成します。PDF ドキュメントの場所を指定する文字列値を渡します。

javax.activation.DataHandler オブジェクトを作成するには、コンストラクターを使用して、javax.activation.FileDataSource オブジェクトを渡します。javax.activation.FileDataSource オブジェクトを作成するには、コンストラクターを使用して、PDF ドキュメントを表す java.io.File オブジェクトを渡します。

org.apache.axis.attachments.AttachmentPart オブジェクトを作成するには、コンストラクターを使用して、javax.activation.DataHandler オブジェクトを渡します。

添付ファイルを添付するには、EncryptDocumentSoapBindingStub オブジェクトの addAttachment メソッドを呼び出し、org.apache.axis.attachments.AttachmentPart オブジェクトを渡します。

コンストラクターを使用して BLOB オブジェクトを作成します。BLOB オブジェクトに添付ファイルの識別子の値を入力するには、BLOB オブジェクトの setAttachmentID メソッドを呼び出し、添付ファイルの識別子の値を渡します。org.apache.axis.attachments.AttachmentPart オブジェクトの getContentId メソッドを呼び出すと、この値を取得できます。

MyApplication/EncryptDocument プロセスを呼び出すには、EncryptDocumentSoapBindingStub オブジェクトの invoke メソッドを呼び出します。DIME 添付ファイルを含む BLOB オブジェクトを渡します。このプロセスは、暗号化された PDF ドキュメントを BLOB オブジェクト内に返します。

返された BLOB オブジェクトの getAttachmentID メソッドを呼び出して、添付ファイルの識別子の値を取得します。このメソッドは、返される添付ファイルの識別子の値を表す文字列値を返します。

EncryptDocumentSoapBindingStub オブジェクトの getAttachments メソッドを呼び出して、添付ファイルを取得します。このメソッドは、添付ファイルを表す Objects の配列を返します。

添付ファイル（Object 配列）を反復処理し、添付ファイルの識別情報の値を使用して、暗号化された PDF ドキュメントを取得します。各要素は org.apache.axis.attachments.AttachmentPart オブジェクトです。

org.apache.axis.attachments.AttachmentPart オブジェクトの getDataHandler メソッドを呼び出して、添付ファイルに関連付けられた javax.activation.DataHandler オブジェクトを取得します。

javax.activation.DataHandler オブジェクトの getInputStream メソッドを呼び出して、java.io.FileStream オブジェクトを取得します。

バイト配列を作成し、java.io.FileStream オブジェクトの read メソッドに渡します。このメソッドは、暗号化された PDF ドキュメントを表すデータストリームでバイト配列を入力します。

コンストラクタを使用して java.io.File オブジェクトを作成します。このオブジェクトは、暗号化された PDF ドキュメントを表します。

java.io.FileOutputStream オブジェクトを作成するには、コンストラクタを使用して java.io.File オブジェクトを渡します。

java.io.FileOutputStream オブジェクトの write メソッドを呼び出して、暗号化された PDF ドキュメントを表すデータストリームを含むバイト配列を渡します。