v_record - スコープ対象、グローバル

v_record API を使用すると、リモートテーブルレコードに例外またはエラーメッセージを設定できます。リモートテーブルを使用すると、外部ソースから、または REST サービスや SOAP サービスを使用して別のインスタンスからデータを取得できます。

この API は、ワークスペースまたはリストとフォームを変更することなく、スクリプト内で GlideRecord の作成、更新、および削除メソッドが使用されている場所で実行されます。

この API では、リモートテーブルプラグイン (com.glide.script.vtable) をアクティブ化する必要があります。 詳細については、「Create script definitions for a remote table」を参照してください。

v_query – スコープ、グローバルスクリプト可能オブジェクトでv_recordを使用してリモートテーブルをクエリし、v_table – スコープ、グローバル API を使用してリモートテーブルを作成します。

v_record:setLastErrorMessage(文字列 lastErrorMessage)

リモートテーブルレコードの編集可能な操作中、フォームまたはリストビュー、およびシステムログに表示する例外またはエラーメッセージを設定します。

注:

v_record挿入、更新、または削除操作が実行されるリモートレコードを表すため、このメソッドを使用した結果としてテーブルは更新されません。

表 : 1. パラメーター

名前	タイプ	説明
最後のエラーメッセージ	文字列	リモートテーブルレコードの最後のエラーまたは例外として表示する例外またはエラーメッセージ。フォームまたはリストビューに表示され、システムログに書き込まれます。

表 : 2. 戻り値

タイプ	説明
なし

次の例では、リモートテーブルレコードでの編集可能な操作中に表示される例外メッセージ "挿入の実行中に例外が発生しました" を設定します。

(function executeInsert(v_record) { 
   try{ 
//add logic to insert the record in the remote table 
   } catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the insert");
   } 
})(v_record); 
(function executeUpdate(v_record, v_changed_fields) { 
   try{
//add logic to update the record in the remote table from the changed fields in 	
// v_changed_fields 
   }catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the update"); 
   } 
})
(v_record, v_changed_fields); 
(function executeDelete(v_record) { 
   try{ 
//add logic to delete the record in the remote table 
   }catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the delete"); 
   } 
})(v_record);

出力:

"Exception encountered executing the insert"

出力は、リモートシステムで実行される操作 (挿入、更新、削除など) に例外がある場合に setLastErrorMessage() を使用して設定された例外メッセージです。例外が返されなかった場合、操作は成功したと見なされます。