このステップでは、Web サービスの SOAP オペレーション GetEmployees を作成し、そのインバウンド・パラメータおよびアウトバウンド・パラメータを定義します。

GetEmployees は、部門コードと課コードを指定するパラメータを受け取り、この部門と課の全社員の詳細リスト (配列) を返します。

  1. SOAPウィザードの [オペレーション] タブを選択します。

  2. [オペレーション] パネルで右クリックしてコンテキスト・メニューを開きます。


  3. コンテキスト・メニューで [オペレーションの新規作成] を選択します。


  4. 表示されたダイアログに [オペレーション名] getEmployees を入力し、[OK] をクリックします。

  5. 次にインバウンド・パラメータを定義します。以下の手順にしたがってください。
    1. getEmployees オペレーションを右クリックして、コンテキスト・メニューを開きます。
    2. コンテキスト・メニューで [パラメータの新規作成] を選択します。
    3. パラメータのタイプ (String) を選択します。

  6. 表示されたダイアログにパラメータ名 departmentCode を入力し、[了解] をクリックします。


  7. 残りのインバウンド・パラメータ sectionCode についても同じ手順を繰り返し (同じくStringを選択)、[OK] をクリックします。

  8. 戻りのパラメータ、つまりアウトバウンド・パラメータを定義します。これは、インバウンド・パラメータと同様の手順に従います。
    1. getEmployees を右クリックしてコンテキスト・メニューを開きます。
    2. コンテキスト・メニューで [戻りパラメータセット] を選択し、サブメニューで [サーバータイプ...] を選択します。
      サーバー・タイプを選択するのは、戻りパラメータが「ステップ 2. カスタム SOAP サーバー・タイプを定義する」で作成したサーバー・タイプになるからです。

  9. [サーバー・タイプ] ダイアログ・ボックスには、社員サーバー・タイプの 2 つのエントリーがあります。最初のエントリーは、単一インスタンスの社員です。2番目の [...] が付いたエントリーは、社員の配列を表しています。

    今回は社員の配列を返すため、Employee [...] を選択して [OK] をクリックします。
    SOAP ウィザードの [オペレーション] タブに戻ります。このウィザードでは、定義したインバウンド・パラメータとアウトバウンド・パラメータを確認できます。戻りパラメータ Employee のエントリーを展開すると、社員サーバー・タイプを構成するエレメントが表示されます。

    これで、SOAP オペレーションとそのパラメータの定義が終わりました。 
    Web サービス定義する際は、恐らく複数の SOAP オペレーションを定義すると思いますが、この演習では作成するのは1つのオペレーションのみです。

  10. 変更内容を保存します。
  • No labels