クライアント・アプリケーションは、Web サービス API に要求を送信し
、Web サービス API からの応答を受信します。プロキシー・クライアントを使用して、
複合データ・タイプのフォーマット設定を行う通信クラスおよびヘルパー・クラスを管理すると、
クライアント・アプリケーションから、Web サービス・メソッドをローカル機能のように
呼び出すことができます。
始める前に
クライアント・アプリケーションの作成を開始する前に、プロキシー・クライアントと
必要なヘルパー・クラスを生成します。
このタスクを実行する理由と実行時期
.NET 対応の開発ツール (Visual Studio .NET など) を使用すれば
、.NET クライアント・アプリケーションを開発できます。どのタイプの .NET アプリケーションを
ビルドしても、汎用の Web サービス API を呼び出すことができます。
このタスクのステップ
- 新規クライアント・アプリケーション・プロジェクトを作成します。 例えば、Visual Studio で WinFX Windows® Application を
作成します。
- プロジェクト・オプションで、プロキシー・クライアントのダイナミック・リンク・ライブラリー (DLL) ファイルに
参照を追加します。 ビジネス・オブジェクト定義を含むすべてのヘルパー・クラスを
プロジェクトに追加します。例えば Visual Studio では、
オプションを実行します。
- プロキシー・クライアント・オブジェクトを作成します。 以下に例を挙げます。
HTMClient.HTMReference.HumanTaskManagerComponent1Export_HumanTaskManagerHttpService service =
new HTMClient.HTMReference.HumanTaskManagerComponent1Export_HumanTaskManagerHttpService();
- メッセージで使用され、Web サービスとの間で送受信される
ビジネス・オブジェクト・データ・タイプを宣言します。 以下に例を挙げます。
HTMClient.HTMReference.TKIID id = new HTMClient.HTMReference.TKIID();
ClipBG bg = new ClipBG();
Clip clip = new Clip();
- 特定の Web サービス関数を呼び出し、必要なパラメーターを指定します。 例えば、ヒューマン・タスクを作成して開始するには、以下のようにします。
HTMClient.HTMReference.createAndStartTask task =
new HTMClient.HTMReference.createAndStartTask();
HTMClient.HTMReference.StartTask sTask = new HTMClient.HTMReference.StartTask();
sTask.taskName = "SimpleTask";
sTask.taskNamespace = "http://myProcess/com/acme/task";
sTask.inputMessage = bg;
task.inputTask = sTask;
id = service.createAndStartTask(task).outputTask;
- リモートのプロセスおよびタスクは、永続 ID (上記の例では id) で
識別されます。 例えば、上記で作成したヒューマン・タスクを要求するには、
以下のようにします。
HTMClient.HTMReference.claimTask claim = new HTMClient.HTMReference.claimTask();
claim.inputTask = id;