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は閉じられます。