4D Doc Center : SET WEB SERVICE OPTION

4D v12.4

SET WEB SERVICE OPTION


SET WEB SERVICE OPTION ( option ; value )

引数	型	説明
option	倍長整数	設定するオプションのコード
value	倍長整数, テキスト	オプションの値

予備的なお知らせ

このコマンドは上級Webサービスユーザのためにデザインされています。使用するかどうかは任意です。

説明

SET WEB SERVICE OPTIONコマンドを使用して、CALL WEB SERVICEコマンドを使用して次回呼び出されるSOAPリクエストで使用されるさまざまなオプションを設定できます。
設定するオプションの数だけこのコマンドを呼び出します。

option 引数には設定するオプションの番号、value 引数にはそのオプションの新しい値を渡します。これらの引数にはWeb Services (Client)テーマの以下の定義済み定数を使用できます:

定数	型	値	コメント
Web Service display auth dialog	倍長整数	4	value = 0 (ダイアログボックスを表示しない) または 1 (ダイアログボックスを表示する) このオプションはCALL WEB SERVICEコマンド実行時の認証ダイアログボックスの表示を管理します。デフォルトでダイアログボックスは表示されません。通常AUTHENTICATE WEB SERVICEコマンドを使用して認証を行わなければなりません。しかし認証ダイアログボックスを表示してユーザに認証情報を入力させたい場合、このオプションを使用します。value に1を渡すとダイアログを表示、0を渡すと表示しません。ダイアログボックスはWebサービスが認証を要求する場合のみ表示されます。
Web Service HTTP Compression	倍長整数	6	value = Web Service Deflate Compression このオプションを使用して、4Dアプリケーション間のデータ交換を高速化するために、SOAPリクエストの内部的な圧縮メカニズムを有効にできます。SET WEB SERVICE OPTION(Web Service HTTP Compression; Web Service Deflate Compression) を4DのWebサービスクライアント側で実行すると、クライアントから送信される次回のSOAPリクエストは、4D SOAPサーバに送信される前に標準のHTTPメカニズムを使用して圧縮されます。サーバはリクエストを解凍し、解析して、自動で同じメカニズムを使用して返信します。SET WEB SERVICE OPTIONコマンドの呼び出しに続くリクエストのみに有効です。つまり圧縮メカニズムを使用するたびにこのコマンドを呼び出す必要があります。デフォルトで、4DはWebサービスHTTPリクエストを圧縮しません。注: "Deflate"は4Dが内部的に使用する圧縮アルゴリズムの名称です。このメカニズムは11.3より前のバージョンの4D SOAPサーバーへのリクエストには使用できません。この動作をさらに最適化するために、圧縮を行うデータサイズの敷居値と圧縮率をSET DATABASE PARAMETERコマンドで設定できます。
Web Service HTTP Timeout	倍長整数	1	value = 秒単位で指定するクライアント側のタイムアウトクライアント側のタイムアウトは、サーバが返答しない場合のWebサービスクライアント側の待ち時間です。この時間経過後、クライアントはセッションを閉じ、リクエストは失われます。このタイムアウトはデフォルトで180秒です。特定の理由 (ネットワークの状態、Webサービスの仕様等) でこの値を変更できます。
Web Service reset auth settings	倍長整数	5	value = 0 (情報を消去しない) または 1 (情報を消去する) このオプションを使用して、4Dにユーザの認証情報 (ユーザ名とパスワード、認証メソッド等) を記憶させ、それを再利用するかどうかを指定できます。デフォルトでこの情報はCALL WEB SERVICEコマンドを呼び出すたびに消去されます。value に0を渡すと情報は保持され、1を渡すと消去されます。0を渡した場合、情報はセッションの間保持されます。
Web Service SOAP Header	倍長整数	2	value = SOAPリクエストのヘッダとして挿入するXMLルート要素参照このオプションを使用して、CALL WEB SERVICEコマンドで生成されるSOAPリクエストにヘッダを挿入できます。デフォルトでSOAPリクエストは特定のヘッダを持っていません。しかしWebサービスによっては、例えば識別情報を管理するために、ヘッダを要求することがあります。
Web Service SOAP Version	倍長整数	3	value = Web Service SOAP_1_1 または Web Service SOAP_1_2 このオプションで、リクエストで使用するSOAPプロトコルのバージョンを指定できます。Web Service SOAP_1_1 定数を value に渡すとバージョン1.1が、Web Service SOAP_1_2 を渡すとバージョン1.2が指定されます。

オプションを呼び出す順番は重要ではありません。同じ option が複数回設定された場合は、最後の呼び出しで設定された値が有効になります。

例題 1

SOAPリクエストにカスタマイズしたヘッダを挿入する:

  ` Creating an XML reference

 C_TEXT(vRootRef;vElemRef)

 vRootRef:=DOM Create XML Ref("RootElement")

 vxPath:="/RootElement/Elem1/Elem2/Elem3"

 vElemRef:=DOM Create XML element(vRootRef;vxPath)

  `Modifying SOAP header with reference

 SET WEB SERVICE OPTION(Web Service SOAP Header;vElemRef)

例題 2

SOAPプロトコルのバージョン1.2を使用する:

SET WEB SERVICE OPTION(Web Service SOAP Version;Web Service SOAP_1_2)