4D v16.3

Web Services (Client)

ホーム

 
4D v16.3
Web Services (Client)

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  


参照 

WEB SERVICE CALL
WEB SERVICE Get info
WEB SERVICE SET OPTION

 
プロパティ 

プロダクト: 4D
テーマ: 定数テーマリスト

 
履歴 

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v16)
ランゲージリファレンス ( 4D v16.1)
ランゲージリファレンス ( 4D v16.2)
ランゲージリファレンス ( 4D v16.3)