アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> getProceduralResult
 
getProceduralResult
executeProcedureまたはexecuteSqlScriptの呼び出しから返されたresultIdに関連付けられた手続き型の結果を取得します。
「isBlocking」がTRUEに設定されている場合、このオペレーションは、実行に関連付けられた処理が完了し、「outputs」エレメントが設定されるまで戻りません。
FALSEに設定すると、実行に関連する処理が完了するとこのオペレーションが返されますが、「outputs」エレメントにデータが入力されるのを待つことはありません。
includeMetadataがTRUEの場合、応答にはメタデータエレメントが含まれます。メタデータエレメントは、この呼び出しまたは後のgetProceduralResultの呼び出しのいずれかで、結果に提供される出力パラメーターデータの名前とタイプを記述します。
完了したエレメントは、考えられるすべての結果が取得されたかどうかを報告します。
requestStatusエレメントは、実行に関連付けられたサーバー要求のステータスを報告します。リクエストのステータスは、次のいずれかになります。
STARTED:リクエストが開始されました。リクエストは作成されましたが、まだ実行されていません。
WAITING:サーバーが要求を処理するために、要求はキューで待機しています。
RUNNING:リクエストは現在サーバーによって実行されています。
COMPLETED:リクエストに関連付けられた実行が完了しました。結果を取得できるようになりました。
CLOSING:リクエストは終了します。
SUCCESS:リクエストは正常に終了しました。
FAILURE:リクエストは失敗して終了しました。
TERMINATED:リクエストは終了しました。
この実行によって影響を受けた行の数がわかっている場合は、rowsAffectedエレメントが設定されます。
outputエレメントには、一連のProcValueインスタンスが含まれています。 outタイプがカーソルの場合、サーバーの結果へのハンドルであるresultIdを取得する必要があります。 getTabularResultおよびcloseResultで使用できます。 outタイプがカーソルでない場合は、実際の出力値を取得する必要があります。
ロケーション
/services/webservices/system/admin/execute/operations/
リクエストエレメント
resultId:結果ID。
isBlocking:TRUE(デフォルト)の場合、実行が完了するまで戻らないでください。
includeMetadata(オプション):TRUEの場合、応答には出力パラメーター名とそのタイプに関する情報が含まれます。デフォルトはFALSEです。
応答エレメント
completed:TRUEの場合、実行に関連するすべての処理が完了しています。
requestStatus:実行を実行しているサーバーリクエストのステータス。
メタdata(オプション):結果内のパラメーター名とタイプをリストするテーブルメタデータ。
パラメータ:パラメータエレメントを参照してください。
rowsAffected(オプション):既知の場合、実行によって影響を受ける行の数。それ以外の場合は設定されていません。
出力(オプション):手続き型出力の型と値のペアのリスト。
エラー解析
IllegalArgument:isBlockingエレメントの形式が正しくない場合。
NotFound:resultIdが現在のトランザクション内に存在しないか、すでに閉じられている場合。
RuntimeError:実行中にエラーが発生した場合。これが発生した場合、resultIdは閉じられます。