ステップ 2. カスタム SOAP サーバー・タイプを定義する
INT009A - SOAP サービス - サーバーの定義
SOAPサーバー・タイプはSOAPサーバーで使用されるユーザー定義のデータ・タイプであり、要求パラメータと応答パラメータを定義します。サーバー・タイプは1つ以上のエレメントで構成され、それぞれのエレメントは文字列や数字などの簡単なタイプになります。
LANSA Integrator スタジオを使用して定義するサーバー・タイプは独立したもので、これを使用する Web サービスとの関連はありません。
このステップでは、GetEmployees の ソリューション社員サーバー・タイプを定義します。
GetEmployees は、以下の4つのエレメントを返します。
- Employee Id (社員 ID)
- First Name (名)
- Surname (姓)
- Salary (給与)
1. LANSA Integrator スタジオで自身のプロジェクトのタブを選択します。
2. [ソリューション] を選択し、右クリックしてコンテキスト・メニューを開きます。
3. メニューから [SOAP サーバータイプ] のオプションを選択します。
LANSA Integrator SOAP タイプ・エディタが開きます。
4. 空いているスペースを右クリックしてコンテキスト・メニューを開き、[新しいタイプ] を選択します。
[LANSA Integrator SOAP タイプ エディタ] のダイアログが表示されます。
5. [LANSA Integrator SOAP タイプ エディタ] のダイアログ・ボックスに新しいタイプの名前 (Employee) を入力して[OK] をクリックします (または Enter キーを押します)。
6. 次に、この Employee タイプを構成するエレメントを定義する必要があります。
このエレメントを定義するには、以下の手順に従ってください。
a. Employee を右クリックしてコンテキスト・メニューを開きます。
b. コンテキスト・メニューで [新しいエレメント] を選択します。
[エレメント] ダイアログ・ボックスが開きます。
7. 最初のエレメントの名前は employeeId と入力します。このエントリーの大文字/小文字に注意してください。最初の文字は小文字です。その他の単語の最初の文字 (この場合はId) は大文字になっています。
ドロップダウン・リストの [値] で [String] を選択します。
8. [OK] を押します。
ダイアログは、追加のエレメントを入力できるよう、開いた状態になっています。
9. employeeId と同じ方法で 2 番目のエレメントを入力します。
つまり、名前に firstName と入力して、 [値] で [String] を指定します。
10. 3番目のエレメント salary エレメントを作成します。
給与の [値] は、該当する数値タイプ (Double) になります。
11. [値] に [String] を指定して最後のエレメント surname を作成します。
12. エレメントの追加が終了したら、[キャンセル] ボタンをクリックして、[エレメント] ダイアログ・ボックスを閉じます。
これで、Web サービスをサポートするために必要となる SOAP サーバー・タイプが作成されました。
13. 保存ボタン 、Ctrl + S キー、[ファイル] メニューの [保存] のいずれかを使って変更を保存します。
14. [ファイル] メニューの [終了]、または Alt + F4 キーを使って、LANSA Integrator SOAP タイプ エディタ を終了します。