SOAP データ サービスのパブリッシュ

このセクションでは、SOAP 1.1 または 1.2 準拠のデータ サービスを追加する方法について説明します。

SOAP データ サービスをパブリッシュするには

1. リソース ツリーの データー サービス ノードの下にある Web サービス ノードを選択します。
2. 右クリックして [新しいコンポジット Web サービス] を選択します。
3. [コンポジット Web サービスの追加] ダイアログで、新しい Web サービスのデータ サービス名を入力します。
4. [OK] をクリックします。
5. リソース ツリーから、作成した Web サービスを開きます。
6. 必要に応じて、テーブル、ビュー、およびプロシージャを Web サービスにパブリッシュします。

リソース ツリーで 1 つ以上のテーブル、ビュー、またはプロシージャを選択し、右クリックします。

[パブリッシュ] を選択します。

必要に応じて、[パブリッシュ] ウィンドウで、発行されたリソースに使用する名前を編集します。

リソースをパブリッシュする Web サービスを選択します。

[OK] をクリックします。

たとえば、先ほど作成した Web サービスに CompositeView をパブリッシュし、Web サービスが [SOAP] パネルでまだ開いている場合、Web サービスのプロパティ、オペレーション、およびパラメーターを表示するようにパネルが更新されます。

7. 画面のサービス部分で、次のプロパティの値を入力または選択します。

プロパティにが必要な場合は、デフォルト値がすでにプロパティに割り当てられています。

プロパティ

必須

説明

有効

はい

true (デフォルト値) は、このタブで定義した情報を使用するようにシステムに指示します。

ターゲット ネームスペース

はい

デフォルト値を SOAP インストールの場所に置き換えます。

ポート タイプ名

はい

ポートの名前。

SOAP Web サービスは WSDL で記述されます。WSDL は、ポート タイプをオペレーションの抽象コレクションとして定義します。WSDL を使用して Web サービスを記述し、WSDL にポート タイプエントリーを作成します。ポート タイプ名は任意ですが、有効な QName である必要があります。

バインディング名

はい

WSDL 定義の他の場所から参照できる一意のバインディング名。

コントラクト ファーストの有効化

はい

デフォルト値は false です。事前定義された WSDL および WSDL オペレーションを指すには、true を選択します。サービスの作成方法については、「Contract-First WSDL および SOAP データ サービスのパブリッシュ」を参照してください。

MTOM の有効化

はい

有効な値は true または false です。true に設定すると、Web サービスとの間でバイナリーデータを送受信する方法であるメッセージ送信最適化メカニズム (MTOM) を使用できるようになります。有効にした後、バイナリー パラメーター タイプの定義を完了する必要があります。

セキュリティ ポリシー

はい

localhost/policy/security で定義されている使用可能なすべてのポリシーが一覧表示されます。

SAML バリデーター クラス

いいえ

ユーザーが SAML アサーションを検証できるようにする Java クラスの名前。

サブジェクト マッパー クラス

いいえ

次の場所にある TDV の拡張 Java API サブジェクト マッパーを使用して、SAML コンテンツの Java クラスを定義します。

<TDV_install_dir>\apps\extension\docs\com\compositesw\extension\security\SubjectMapper.html

samlSubject を既存の TDV ユーザーにマップし、この SAML プリンシパルにそのユーザーと同じ権限を割り当てるには、samlSubjectToCompositeUser メソッドを使用します。

Java クラスを作成したら、JAR ファイルを <TDV_install_dir>\apps\server\lib フォルダーに保存します。

エンドポイント URL パス

はい

この Web サービスのエンドポイント URL のパス。デフォルトは、Web サービスに使用した名前 (スペースが削除されたもの) です。

SOAP11 Context URL パス

 

SOAP オブジェクトが表示されるパス。オブジェクトをサイトの特定のページに関連付けます。

SOAP12 Context URL パス

 

SOAP オブジェクトが表示されるパス。オブジェクトをサイトの特定のページに関連付けます。

WSDL URL

 

プロパティ ヘッディング。

HTTP/SOAP 1.1

 

オペレーションへのアクセスに使用できる HTTP SOAP 1.1 WSDL ファイルの URL。

HTTP/SOAP 1.2

 

オペレーションへのアクセスに使用できる HTTP SOAP 1.2 WSDL ファイルの URL が表示されます。

HTTPS/SOAP 1.1

 

オペレーションへのアクセスに使用できる HTTPS SOAP 1.1 WSDL ファイルの URL が表示されます。

HTTPS/SOAP 1.2

 

オペレーションへのアクセスに使用できる HTTPS SOAP 1.2 WSDL ファイルの URL が表示されます。

ビューまたはプロシージャをこのサービスに対してパブリッシュしている場合は、次のステップを実行できます。

8. 操作 セクションの上部から、使用可能な Web サービス テーブル、ビュー、またはプロシージャを選択します。
9. 操作 セクションの下部で、次の表に示すプロパティの値を入力または選択します。

プロパティ

説明

セキュリティ ポリシー

localhost/policy/security で定義されている使用可能なすべてのポリシーが一覧表示されます。

SOAP アクション

通常、このフィールドは使用されません。この値がコントラクト・ファースト WSDL の一部として定義されている場合は、このフィールドに値が表示されます。

入力メッセージ

 

パラメーター スタイル

この必須値はすべてのパラメーターに適用されます。

複数のパラメーターが BODY の場所を使用する可能性がある場合は、[ラップ済み] を選択します。ラッパー エレメントは SOAP BODY の子であり、パラメーター エレメントはラッパー エレメントの子です。
BARE を選択するのは、場所が BODY であり、そのエレメントが SOAP BODY の唯一の子であるパラメーターが 1 つだけの場合です。同じ方向の他のすべてのパラメーターは、別の場所 (HEADER など) にマップする必要があります。

Wrapper (ラッパー)

エレメント名

ラッパーエレメントに付ける一意の名前。たとえば、ここに「wrappedOrderParams」と入力すると、WSDL XML に次のエレメントが含まれます。

<wrappedOrderParams> </wrappedOrderParams>

エレメント タイプ

行エレメント タイプ。

メッセージ名

ラッパー メッセージの一意の名前。

パート名

ラッパー エレメントを表すメッセージ部分の名前。

セキュリティ ポリシー

入力メッセージで使用するセキュリティ ポリシー。

出力メッセージ

 

パラメーター スタイル

この必須値はすべてのパラメーターに適用されます。

BODY の場所を使用するパラメーターが複数ある可能性がある場合は、WRAPPED を選択します。ラッパー エレメントは SOAP BODY の子であり、パラメーター エレメントはラッパー エレメントの子です。
BARE を選択するのは、場所が BODY のパラメーターが 1 つだけあり、そのエレメントが SOAP BODY の唯一の子である場合です。同じディレクションの他のすべてのパラメーターは、HEADER などの別の場所にマップする必要があります。

Wrapper (ラッパー)

エレメント名

ラッパーエレメントに付ける一意の名前。たとえば、ここに「wrappedOrderParams」と入力すると、WSDL XML に次のエレメントが含まれます。

<wrappedOrderParams> xxx </wrappedOrderParams>

エレメント タイプ

行エレメントのエレメント タイプ。

メッセージ名

ラッパー メッセージに付ける一意の名前。

パート名

ラッパーエレメントを表すメッセージ部分の名前。

10. Web サービスに対して定義するオペレーションまたはビューごとに繰り返します。
11. オペレーションにパラメーターがある場合は、画面のパラメーター部分の上部に移動し、リストからパラメーターを選択します。
12. 画面のパラメーター部分の下部では、パラメーター セクションの上部で選択したパラメーターのプロパティと値を表示および編集できます。

プロパティ

説明

名前

パラメーターの名前。編集できません。

エレメント名

入力パラメーター、出力パラメーター、または出力カーソルに付ける完全修飾名。または、カラムに付ける名前 (カーソルパスに相対的)。

ディレクション

(カラムの場合は表示されません) カーソルの方向を示します。編集できません。

バインディング ロケーション

選択したオペレーションがプロシージャの場合、バインディング場所を定義できます。メッセージが [BARE (ベア)] の場合、1 つのパラメーターのみで [BODY] バインディング場所を使用できます。

入力に使用できる場所は次のとおりです。

BODYHEADER

出力に使用できる場所は次のとおりです。

BODYFAULTHEADERHEADERFAULT

行エレメント名

(カーソルのみ) カーソルの行エレメントに付ける一意の名前。たとえば、ここに「myFavoriteRow」と入力すると、WSDL XML に次のエレメントが含まれます。

<myFavoriteRow> </myFavoriteRow>

行タイプ名

(カーソルのみ) この行エレメントの値を入力します。

カーソル タイプ名

(カーソルのみ) グローバル カーソル エレメントを定義するタイプの一意の名前。

MTOM コンテンツ タイプ

パラメーターがバイナリーの場合は、パラメーター値を VALUE_TYPE_BINARY、VALUE_TYPE_BLOB、または VALUE_TYPE_CLOB に設定する必要があります。

content-type の値は、値のリストから選択できます。デフォルトは application/octet-stream (バイナリー ファイル) です。このヘッダーは、受け入れられるタイプとサブ タイプで構成される、メッセージ コンテンツのインターネット メディア タイプを示します。

13. Web サービスに定義する各パラメーターについて繰り返します。
14. 定義を保存します。