GlideImportLog - 범위, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • GlideImportLog API는 로그 항목을 임포트 로그 [import_log] 테이블에 직접 기록하는 메서드를 제공합니다.

    GlideImportLog 객체는 GlideImportSetTransformer API에서 소비할 수 있습니다. 이 객체는 GlideImportSetTransformer API에 필요하지 않으며, 임포트 로그를 특정 임포트 세트 변환과 연결할 수 있습니다.

    GlideImportLog - GlideImportLog(GlideImportSetRun importSetRun, 문자열 소스)

    GlideImportLog 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    importSetRun GlideImportSetRun 옵션입니다. 모든 로그가 연결될 임포트 세트 실행 기록입니다.
    소스 문자열 옵션입니다. 임포트 세트 프로세스에서 이 메시지가 기록된 위치를 정의하는 임포트 로그 기록에 첨부된 소스 필드 값입니다. 예를 들어 로드는 로딩 단계를 나타낼 수 있고, 정리는 변환 후 정리 중에 나타낼 수 있습니다.

    선택적 source 매개변수가 없는 예입니다.

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

    선택적 source 매개변수를 사용하는 예입니다.

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

    GlideImportLog - 오류(문자열 메시지, 문자열 소스)

    임포트 로그 [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 - 정보(문자열 메시지, 문자열 소스)

    임포트 로그 [import_log] 테이블에 정보 유형의 메시지를 기록합니다.

    GlideImportLog

    표 6. 매개변수
    이름 유형 설명
    메시지 문자열 로그 메시지입니다. 최대 길이 4000자입니다.
    소스 문자열 옵션입니다. 임포트 세트 프로세스에서 이 메시지가 기록된 위치를 정의하는 임포트 로그 기록에 첨부된 소스 필드 값입니다. 예를 들어 로드는 로딩 단계를 나타낼 수 있고, 정리는 변환 후 정리 중에 나타낼 수 있습니다.
    표 7. 반환
    유형 설명
    없음 
    var importLog = new GlideImportLog();
importLog.info('Successfully executed transform');

    GlideImportLog - setImportRunHistory(String importRunHistory)

    GlideImportLog 객체를 특정 임포트 세트 실행 기록과 연결합니다.

    표 8. 매개변수
    이름 유형 설명
    importRunHistory 문자열 변환 이력 [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.');