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

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

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

関連概念

• GlideImportSetRun
• GlideImportSetTable
• GlideImportSetTransformer
• GlideImportSetTransformMap
• GlideTransformLog

GlideImportLog - GlideImportLog(GlideImportSetRun importSetRun, 文字列 source)

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

表 : 1. パラメーター

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

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

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

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

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

GlideImportLog - error(文字列 message, 文字列 source)

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

GlideImportLog

表 : 2. パラメーター

名前	タイプ	説明
message	文字列	ログメッセージ。最大長：4,000 文字。
source	文字列	オプション。インポートログレコードに添付されたソースフィールド値。これは、インポートセットプロセス内のどこからこのメッセージが記録されたかを定義します。たとえば、Loading はロードステップを表し、Cleanup は変換後のクリーンアップ中を表している可能性があります。

表 : 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(文字列 message, 文字列 source)

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

GlideImportLog

表 : 6. パラメーター

名前	タイプ	説明
message	文字列	ログメッセージ。最大長：4,000 文字。
source	文字列	オプション。インポートログレコードに添付されたソースフィールド値。これは、インポートセットプロセス内のどこからこのメッセージが記録されたかを定義します。たとえば、Loading はロードステップを表し、Cleanup は変換後のクリーンアップ中を表している可能性があります。

表 : 7. 返される内容

タイプ	説明
なし

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

GlideImportLog - setImportRunHistory(文字列 importRunHistory)

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

表 : 8. パラメーター

名前	タイプ	説明
importRunHistory	文字列	変換履歴 [sys_import_set_run] テーブルからのレコードの sys_id。

表 : 9. 返される内容

タイプ	説明
なし

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

GlideImportLog - warn(文字列 message, 文字列 source)

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

GlideImportLog

表 : 10. パラメーター

名前	タイプ	説明
message	文字列	ログメッセージ。最大長：4,000 文字。
source	文字列	オプション。インポートログレコードに添付されたソースフィールド値。これは、インポートセットプロセス内のどこからこのメッセージが記録されたかを定義します。たとえば、Loading はロードステップを表し、Cleanup は変換後のクリーンアップ中を表している可能性があります。

表 : 11. 返される内容

タイプ	説明
なし

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