GlideImportLog:スコープ対象、グローバル

GlideImportLog API は、ログエントリをインポートログ [import_log] テーブルに直接書き込むメソッドを提供します。

GlideImportLog オブジェクトは、 GlideImportSetTransformer API で使用できます。このオブジェクトは GlideImportSetTransformer API には必要ありません。インポートログを特定のインポートセット変換に関連付けることができます。

関連概念

• GlideImportSetRun
• GlideImportSetTable
• GlideImportSetTransformer
• GlideImportSetTransformMap
• GlideTransformLog

GlideImportLog - GlideImportLog(GlideImportSetRun、importSetRun、文字列、ソース)

GlideImportLog オブジェクトをインスタンス化します。

表 : 1. パラメーター

名前	タイプ	説明
importSetRun	GlideImportSetRun	オプション。すべてのログが関連付けられるインポートセット実行レコード。
ソース	文字列	オプション。インポートセットプロセスのどこからこのメッセージがログに記録されたかを定義するインポートログレコードに添付されたソースフィールド値。たとえば、「ロード中」はロードステップを表し、「クリーンアップ」は変換後のクリーンアップ中を表します。

オプションのソースパラメーターを使用しない例。

var importSetRun = new GlideImportSetRun();
var importLog = new GlideImportLog(importSetRun);

オプションのソースパラメーターを使用する例。

var importSetRun = new GlideImportSetRun();
var importLog = new GlideImportLog(importSetRun, 'Scripted ImportSetTransformer');

GlideImportLog - error(文字列メッセージ, 文字列ソース)

エラータイプのメッセージをインポートログ [import_log] テーブルに記録します。

GlideImportLog

表 : 2. パラメーター

名前	タイプ	説明
メッセージ	文字列	ログメッセージ。最大長は 4000 文字です。
ソース	文字列	オプション。インポートセットプロセスのどこからこのメッセージがログに記録されたかを定義するインポートログレコードに添付されたソースフィールド値。たとえば、「ロード中」はロードステップを表し、「クリーンアップ」は変換後のクリーンアップ中を表します。

表 : 3. 戻り値

タイプ	説明
なし

var importLog = new GlideImportLog();
importLog.error('Error executing transform');

GlideImportLog - getImportRunHistory()

このインポートログに関連付けられているインポート実行レコードのsys_idを返します。

表 : 4. パラメーター

名前	タイプ	説明
なし

表 : 5. 戻り値

タイプ	説明
文字列	変換履歴 [sys_import_set_run] テーブルからのインポートセット実行レコードのSys_id。

var importSet = new GlideRecord('sys_import_set');
importSet.name = 'Scripted Import Set';
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var importLog = new GlideImportLog();
var transformer = new GlideImportSetTransformer();
transformer.setLogger(importLog);
transformer.transformAllMaps(importSet);
var importRunSysId = importLog.getImportRunHistory();

GlideImportLog - info(文字列メッセージ, 文字列ソース)

Info タイプのメッセージをインポートログ [import_log] テーブルに記録します。

GlideImportLog

表 : 6. パラメーター

名前	タイプ	説明
メッセージ	文字列	ログメッセージ。最大長は 4000 文字です。
ソース	文字列	オプション。インポートセットプロセスのどこからこのメッセージがログに記録されたかを定義するインポートログレコードに添付されたソースフィールド値。たとえば、「ロード中」はロードステップを表し、「クリーンアップ」は変換後のクリーンアップ中を表します。

表 : 7. 戻り値

タイプ	説明
なし

var importLog = new GlideImportLog();
importLog.info('Successfully executed transform');

GlideImportLog:setImportRunHistory(文字列 importRunHistory)

GlideImportLog オブジェクトを特定のインポートセット実行レコードに関連付けます。

表 : 8. パラメーター

名前	タイプ	説明
インポート実行履歴	文字列	変換履歴 [sys_import_set_run] テーブルのレコードのsys_id。

表 : 9. 戻り値

タイプ	説明
なし

var importRunSysId = '4aa3a8d55ba10010953330ad5981c79f';
var importLog = new GlideImportLog();
importLog.setImportRunHistory(importRunSysId);

GlideImportLog - warn(文字列メッセージ, 文字列ソース)

警告タイプのメッセージをインポートログ [import_log] テーブルに記録します。

GlideImportLog

表 : 10. パラメーター

名前	タイプ	説明
メッセージ	文字列	ログメッセージ。最大長は 4000 文字です。
ソース	文字列	オプション。インポートセットプロセスのどこからこのメッセージがログに記録されたかを定義するインポートログレコードに添付されたソースフィールド値。たとえば、「ロード中」はロードステップを表し、「クリーンアップ」は変換後のクリーンアップ中を表します。

表 : 11. 戻り値

タイプ	説明
なし

var importLog = new GlideImportLog();
importLog.warn('Transform taking longer than expected.');