Web サービス レファレンスの作成
-
に移動します。
[Web サービス レファレンス] ページが表示されます。
-
[新規] をクリックします。
[新しい Web サービス レファレンス] ダイアログ ボックスが表示されます。
-
デフォルトでは、システムによって新しい Web サービス レファレンスが作業カテゴリに自動的に保存されます。Web サービス レファレンスを別のカテゴリに保存するには、[カテゴリ] リストでカテゴリを選択します。
Web サービスを分類することは、Web サービスへのアクセスを特定のユーザーに制限する際に役立ちます。
注 Web サービスを持つプロセス マップまたはフォームをエクスポート/インポートすると、TotalAgility はその Web サービスのカテゴリもエクスポート/インポートします。また、カテゴリがまだ存在しない場合、TotalAgility は Web サービスのカテゴリを作成します。 -
設定する Web サービスの [サービス タイプ] を選択します。利用可能なオプションは次のとおりです。
-
[SOAP] (デフォルト): Web サービスの Web サービス記述言語 (WSDL) ファイルを参照する URL を指定します。たとえば、http://localhost/PlatformManagerWs/PlatformManagerWs.asmx?WSDL と指定します。
-
[SOAP WCF]: .svc 拡張子を持つ Web サービスを指定します。
-
[RESTful]: 次の 4 つの HTTP メソッドをマップする URL を指定します。GET、PUT、POST、DELETE。「RESTful サービス アクティビティ」および「RESTful サービス アクティビティの構成」を参照してください。
サポートされている Web サービスの詳細については、「TotalAgility でサポートされる Web サービス」を参照してください。
-
- Web サービスの [名前] を入力します。
-
Web サービスの [URL] を入力します。
注 システム設定で
すべて許可
が有効になっていない場合は、ホワイトリストに登録された Web サービス URL とエンドポイント URL のみを入力できます。それ以外の URL を入力した場合は、URL 接続文字列がホワイトリストに登録されていないため接続が拒否されたことを示すメッセージが表示されます。 -
Web サービスのプロキシ DLL を再生成することなく Web サービスの実行場所を変更するには、[エンドポイント URL] を使用します。たとえば、移行を容易にするために、[エンドポイント URL] を使用して実行場所をテスト サーバーから実稼働サーバーに動的に変更します。URL を指定するには、次の手順を実行します。
- [エンドポイント URL] で、[はい] をクリック]します。(デフォルト: いいえ)
- エンドポイントの [URL] を入力します。
注 エンドポイント URL は、WSDL リンクではなく、Web サービスの場所である必要があります。エンドポイント URL は、SOAP および WCF にのみ使用します。エンドポイント URL では、RESTful Web サービスはサポートされません。 -
構成済みの TotalAgility Enterprise サービス アカウントへのアクセスを制限するだけでなく、Web サービスへのアクセスを制御するには、次の手順を実行します。
- [ユーザー資格情報] で [はい] をクリックします。(デフォルト: いいえ)
- エンドポイントの [ユーザー名] および [パスワード] を入力します。
-
Web サービスにカスタム ヘッダーを追加するには、次の手順を実行します。
- [カスタム ヘッダー] の をクリックします。
- [名前] を Host などと入力します。
- [値] を localhost などと入力します。
- [追加] をクリックします。
- [保存] をクリックします。
インターネット Web サービスとやりとりするには、Web サービス アクティビティを作成するか、Web サービス イベントを追加します。パブリック クラスとパブリック メソッドを備えたすべての Web サービスは、Web サービス アクティビティから呼び出すことができます。各パブリック メソッドには、変数を割り当てる必要があるパラメータのリストがあります。
関連付けの表示
Web サービス レファレンスに関連付けられた項目を表示できます。
- Web サービス レファレンスのリスト ページに移動します。
-
関連付けを表示する Web サービス レファレンスのコンテキスト メニューで、[関連付け] をクリックします。
統合の関連付け - <Web サービス レファレンス名> ダイアログ ボックスが表示されます。
現在の Web サービス レファレンスで使用されているプロセスなどの項目名は、ハイパーリンクとして表示されます。項目名のリンクをクリックして、新しいブラウザ タブで項目を開き、必要に応じて変更することができます。
注 (RESTful サービス タイプに対する) Web サービス統合が TotalAgility 7.7.0 以前のいずれかのバージョンで構成されている場合、7.8.0 へのアップグレード時に、Web サービス統合に関連するプロセスはリストされません。この統合を使用してプロセスを表示するには、統合を再構成する必要があります。
こちらも参照してください。