ユーザーガイド > リソースの公開 > Webサービスへのリソースの公開 > SOAPデータサービスの公開
 
SOAPデータサービスの公開
このセクションでは、SOAP 1.1または1.2準拠のデータサービスを追加する方法について説明します。
SOAPデータサービスを公開するには
1.リソースツリーで[Data Services(データサービス)]ノードの下にある[Web Services(Webサービス)]ノードを選択します。
2.右クリックして、[New Composite Web Service(新しい複合Webサービス)]を選択します。
3.[Add Composite Web Service(複合Webサービスの追加)]ダイアログで、新しいWebサービスのデータサービス名を入力します。
4.[OK]をクリックします。
5.リソースツリーから、先ほど作成したWebサービスを開きます。
6.必要に応じて、テーブル、ビュー、プロシージャをWebサービスに公開します。
a. リソースツリーで1つ以上のテーブル、ビュー、またはプロシージャを選択し、右クリックします。
b. [Publish(公開)]を選択します。
c. 必要に応じて、[Publish(公開)]ウィンドウで、公開リソースに使用する名前を編集します。
d. リソースの公開先のWebサービスを選択します。
e. [OK]をクリックします。
たとえば、先ほど作成したWebサービスにCompositeViewを公開し、Webサービスが[SOAP]パネルでまだ開いている場合、Webサービスのプロパティ、操作、およびパラメーターを表示するようにパネルが更新されます。
7.画面の[Service(サービス)]部分で、次のプロパティの値を入力または選択します。
プロパティにが必要な場合は、デフォルト値がすでにプロパティに割り当てられています。
プロパティ
必須
説明
[Enabled(有効)]
はい
true (デフォルト値)は、このタブで定義した情報を使用するようにシステムに指示します。
[Target Namespace(ターゲット名前空間)]
はい
デフォルト値をSOAPインストールの場所に置き換えます。
[Port Type Name(ポートタイプ名)]
はい
ポートの名前。
SOAP WebサービスはWSDLで記述されます。WSDLは、ポートタイプを操作の抽象コレクションとして定義します。WSDLを使用してWebサービスを記述し、WSDLにポートタイプエントリーを作成します。ポートタイプ名は任意ですが、有効なQNameである必要があります。
[Binding Name(バインディング名)]
はい
WSDL定義の他の場所から参照できる一意のバインディング名。
[Enable Contract First(コントラクトファーストを有効にする)]
はい
デフォルト値はfalseです。事前定義されたWSDLとWSDL操作を参照する場合は、trueを選択します。サービスの作成方法については、「コントラクトファーストのWSDLおよびSOAPデータサービスの公開」を参照してください。
[Enable MTOM(MTOMを有効にする)]
はい
有効な値はtrueまたはfalseです。trueに設定すると、Webサービスとの間でバイナリーデータを送受信する方法であるメッセージ送信最適化メカニズム(MTOM)を使用できるようになります。有効にした後、バイナリーパラメータータイプの定義を完了する必要があります。
[Security Policy(セキュリティポリシー)]
はい
localhost/policy/securityで定義されている使用可能なすべてのポリシーが一覧表示されます。
[SAML Validator Class(SAMLバリデータークラス)]
いいえ
ユーザーがSAMLアサーションを検証できるようにするJavaクラスの名前。
[Subject Mapper Class(サブジェクトマッパークラス)]
いいえ
次の場所にある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フォルダーに保存します。
[Endpoint URL Path(エンドポイントURLのパス)]
はい
このWebサービスのエンドポイントURLのパス。デフォルトは、Webサービスに使用した名前(スペースが削除されたもの)です。
[SOAP11 Context Url Pat(SOAP11コンテキストURLのパス)]
 
SOAPオブジェクトが表示されるパス。オブジェクトをサイトの特定のページに関連付けます。
[SOAP12 Context Url Pat(SOAP12コンテキストURLのパス)]
 
SOAPオブジェクトが表示されるパス。オブジェクトをサイトの特定のページに関連付けます。
[WSDL URLs(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.[Operations(操作)]セクションの上部で、画面の一部で、使用可能なWebサービステーブル、ビュー、またはプロシージャを選択します。
9.[Operations(操作)]セクションの下部で、次の表に記載されているプロパティの値を入力または選択します。
プロパティ
説明
[Security Policy(セキュリティポリシー)]
localhost/policy/securityで定義されている使用可能なすべてのポリシーが一覧表示されます。
[SOAP Action(SOAPアクション)]
通常、このフィールドは使用されません。この値がコントラクトファーストWSDLの一部として定義されている場合は、このフィールドに値が表示されます。
入力メッセージ
 
[Parameter Style(パラメータースタイル)]
この必須値はすべてのパラメーターに適用されます。
複数のパラメーターがBODYの場所を使用する可能性がある場合は、[WRAPPED(ラップ)]を選択します。ラッパー要素はSOAP BODYの子であり、パラメーター要素はラッパー要素の子です。
BODYの場所があるパラメーターが1つだけで、その要素がSOAP BODYの唯一の子である場合は、[BARE(ベア)]を選択します。同じ方向の他のすべてのパラメーターは、別の場所(HEADERなど)にマップする必要があります。
[Wrapper(ラッパー)]
[Element Name(要素名)]
ラッパー要素に付ける一意の名前。たとえば、ここに「wrappedOrderParams」と入力すると、WSDL XMLに次の要素が含まれます。
<wrappedOrderParams> </wrappedOrderParams>
[Element Type(要素タイプ)]
行要素タイプ。
[Message Name(メッセージ名)]
ラッパーメッセージの一意の名前。
[Part Name(部分名)]
ラッパー要素を表すメッセージ部分の名前。
[Security Policy(セキュリティポリシー)]
入力メッセージで使用するセキュリティポリシー。
出力メッセージ
 
[Parameter Style(パラメータースタイル)]
この必須値はすべてのパラメーターに適用されます。
BODYの場所を使用するパラメーターが複数ある可能性がある場合は、[WRAPPED(ラップ)]を選択します。ラッパー要素はSOAP BODYの子であり、パラメーター要素はラッパー要素の子です。
BODYの場所があるパラメーターが1つだけで、その要素がSOAP BODYの唯一の子である場合は、[BARE(ベア)]を選択します。同じ方向の他のすべてのパラメーターは、別の場所(HEADERなど)にマップする必要があります。
[Wrapper(ラッパー)]
[Element Name(要素名)]
ラッパー要素に付ける一意の名前。たとえば、ここに「wrappedOrderParams」と入力すると、WSDL XMLに次の要素が含まれます。
<wrappedOrderParams> xxx </wrappedOrderParams>
[Element Type(要素タイプ)]
行要素の要素タイプ。
[Message Name(メッセージ名)]
ラッパーメッセージに付ける一意の名前。
[Part Name(部分名)]
ラッパー要素を表すメッセージ部分の名前。
10.Webサービス用に定義する操作またはビューごとに繰り返します。
11.操作にパラメーターがある場合は、画面の[Parameters(パラメーター)]部分の上部に移動し、リストからパラメーターを選択します。
12.画面の[Parameters(パラメーター)]部分の下部では、[Parameters(パラメーター)]セクションの上部で選択したパラメーターのプロパティと値を表示および編集できます。
プロパティ
説明
[Name(名前)]
パラメーターの名前。編集できません。
[Element Name(要素名)]
入力パラメーター、出力パラメーター、または出力カーソルに付ける完全修飾名。または、列に付ける名前(カーソルパスに相対的)。
[Direction(方向)]
(列の場合は表示されません)カーソルの方向を示します。編集できません。
[Binding Location(バインディング場所)]
選択した操作がプロシージャの場合、バインディング場所を定義できます。メッセージが[BARE(ベア)]の場合、1つのパラメーターのみでBODYバインディング場所を使用できます。
入力に使用できる場所は次のとおりです。
BODYHEADER
出力に使用できる場所は次のとおりです。
BODYFAULTHEADERHEADERFAULT
[Row Element Name(行要素名)]
(カーソルのみ)カーソルの行要素に付ける一意の名前。たとえば、ここに「myFavoriteRow」と入力すると、WSDL XMLに次の要素が含まれます。
<myFavoriteRow> </myFavoriteRow>
[Row Type Name(行タイプ名)]
(カーソルのみ)この行要素の値を入力します。
[Cursor Type Name(カーソルタイプ名)]
(カーソルのみ)グローバルカーソル要素を定義するタイプの一意の名前。
[MTOM CONTENT TYPE(MTOMコンテンツタイプ)]
パラメーターがバイナリーの場合は、パラメーター値をVALUE_TYPE_BINARY、VALUE_TYPE_BLOB、またはVALUE_TYPE_CLOBに設定する必要があります。
content-typeの値は、値のリストから選択できます。デフォルトはapplication/octet-stream (バイナリーファイル)です。このヘッダーは、受け入れられるタイプとサブタイプで構成される、メッセージコンテンツのインターネットメディアタイプを示します。
13.Webサービス用に定義するパラメーターごとに繰り返します。
14.定義を保存します。