4D Doc Center : Web Services (Client)

4D v14.3

Web Services (Client)

定数	型	値	コメント
Web Service compression	倍長整数	1
Web Service detailed message	倍長整数	1	エラーの説明メッセージ。メインのエラータイプに応じてメッセージは異なります。 - 9910 (Soap fault): SOAPエラーの原因が返されます (例: “リモートメソッドが存在しません”)。 - 9911 (Parser fault): XMLドキュメント中のエラーの個所が返されます。 - 9912 (HTTP fault): - HTTPエラーが [300-400] の場合 (問題がリクエストされたドキュメントの場所に関連する場合)、リクエストURLの新しい場所が返されます。 - 他のHTTPエラーコードの場合、<body>が返されます。 - 9913 (Network fault): ネットワークエラーの原因が返されます (例: “ServerAddress: DNS lookup failure”) - 9914 (Internal fault): 内部エラーの原因が返されます。
Web Service display auth dialog	倍長整数	4	value = 0 (ダイアログボックスを表示しない) または 1 (ダイアログボックスを表示する) このオプションはWEB SERVICE CALLコマンド実行時の認証ダイアログボックスの表示を管理します。デフォルトでダイアログボックスは表示されません。通常WEB SERVICE AUTHENTICATEコマンドを使用して認証を行わなければなりません。しかし認証ダイアログボックスを表示してユーザに認証情報を入力させたい場合、このオプションを使用します。value に1を渡すとダイアログを表示、0を渡すと表示しません。ダイアログボックスはWebサービスが認証を要求する場合のみ表示されます。
Web Service dynamic	倍長整数	0
Web Service error code	倍長整数	0	(4Dが定義した) 主たるエラーコード。このコードはErrorシステム変数にも返されます。返される可能性のあるコードは以下のとおりです: 9910: Soap fault (参照 Web Service Fault Actor) 9911: Parser fault 9912: HTTP fault (参照 Web Service HTTP Error code) 9913: Network fault 9914: Internal fault.
Web Service fault actor	倍長整数	3	エラーの原因 (SOAPプロトコルにより返される、メインエラーが9910の場合に使用)。 - バージョンが合わない - 引数解釈エラー (必須として定義された引数をサーバが解釈できない) - 送信側側のエラー - 受信側のエラー - 未知のエンコーディング
Web Service HTTP compression	倍長整数	6	value = Web Service Compression このオプションは、SOAPリクエストによる4Dアプリケーション間のデータ交換を高速化する目的で、内部的な圧縮メカニズムを有効にするために使用します。WEB SERVICE SET OPTION(Web Service HTTP Compression; Web Service Compression) ステートメントをWebサービスの4Dクライアント上で実行すると、クライアントから送信される次のSOAPリクエストのデータは、4D SOAPサーバーに送信される前に、標準のHTTPメカニズム (リクエストの内容に応じて"gzip" または "deflate") を使用して圧縮されます。サーバーはリクエストを解凍・解析し、自動で同じメカニズムを使用して応答します。WEB SERVICE SET OPTIONコマンドの呼出し直後のリクエストのみに影響します。すなわち圧縮を使用したいリクエスト毎にこのコマンドを呼び出す必要があります。デフォルトで4DはWebサービスHTTPリクエストを圧縮しません。注: このメカニズムは11.3以前の4D SOAPサーバーへのリクエストでは利用できません。この機能を最適化するために、リクエストの圧縮を行う閾値や圧縮率を設定する追加のオプションがあります。これらのオプションを設定するにはSET DATABASE PARAMETERコマンドを使用します。
Web Service HTTP error code	倍長整数	2	HTTPエラーコード (メインエラーが9912の場合に使用)。
Web Service HTTP timeout	倍長整数	1	value = 秒単位で指定するクライアント側のタイムアウトクライアント側のタイムアウトは、サーバが返答しない場合のWebサービスクライアント側の待ち時間です。この時間経過後、クライアントはセッションを閉じ、リクエストは失われます。このタイムアウトはデフォルトで180秒です。特定の理由 (ネットワークの状態、Webサービスの仕様等) でこの値を変更できます。
Web Service manual	倍長整数	3
Web Service manual in	倍長整数	1
Web Service manual out	倍長整数	2
Web Service reset auth settings	倍長整数	5	value = 0 (情報を消去しない) または 1 (情報を消去する) このオプションを使用して、4Dにユーザの認証情報 (ユーザ名とパスワード、認証メソッド等) を記憶させ、それを再利用するかどうかを指定できます。デフォルトでこの情報はWEB SERVICE CALLコマンドを呼び出すたびに消去されます。value に0を渡すと情報は保持され、1を渡すと消去されます。0を渡した場合、情報はセッションの間保持されます。
Web Service SOAP header	倍長整数	2	value = SOAPリクエストのヘッダとして挿入するXMLルート要素参照このオプションを使用して、WEB SERVICE CALLコマンドで生成される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が指定されます。
Web Service SOAP_1_1	倍長整数	0
Web Service SOAP_1_2	倍長整数	1