GlideImportLog : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API GlideImportLog fournit des méthodes permettant d’écrire des entrées de journal directement dans la table Journal d’importation [import_log].

    Un objet GlideImportLog est consommable par l’API GlideImportSetTransformer . Cet objet n’est pas requis pour l’API GlideImportSetTransformer , il vous permet d’associer les journaux d’importation à une transformation de jeu d’importation spécifique.

    GlideImportLog : GlideImportLog(GlideImportSetRun, importSetRun, source de chaîne)

    Instancie un objet GlideImportLog.

    Tableau 1. Paramètres
    Nom Type Description
    importSetRun GlideImportSetRun Facultatif. Enregistrement d’exécution du jeu d’importation auquel tous les journaux doivent être associés.
    source Chaîne Facultatif. Valeur de champ source associée à l’enregistrement du journal d’importation qui définit l’emplacement depuis lequel ce message a été journalisé dans le processus de jeu d’importation. Par exemple, Chargement peut représenter l’étape de chargement, Nettoyage peut représenter pendant le nettoyage après la transformation, et ainsi de suite.

    Exemple sans paramètre source facultatif.

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

    Exemple utilisant un paramètre source facultatif.

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

    GlideImportLog : erreur (message de chaîne, source de chaîne)

    Consigne un message de type Erreur dans la table Journal d’importation [import_log].

    Journal d’importation GlideImport

    Tableau 2. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale 4 000 caractères.
    source Chaîne Facultatif. Valeur de champ source associée à l’enregistrement du journal d’importation qui définit l’emplacement depuis lequel ce message a été journalisé dans le processus de jeu d’importation. Par exemple, Chargement peut représenter l’étape de chargement, Nettoyage peut représenter pendant le nettoyage après la transformation, et ainsi de suite.
    Tableau 3. Renvoie
    Type Description
    Néant 
    var importLog = new GlideImportLog();
importLog.error('Error executing transform');

    GlideImportLog : getImportRunHistory()

    Renvoie une sys_id de l’enregistrement d’exécution d’importation associé à ce journal d’importation.

    Tableau 4. Paramètres
    Nom Type Description
    Néant
    Tableau 5. Renvoie
    Type Description
    Chaîne Sys_id d’un enregistrement d’exécution d’un jeu d’importation à partir de la table Historique de transformation [sys_import_set_run]. 
    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 de chaîne, Source de chaîne)

    Consigne un message de type Info dans la table Journal d’importation [import_log].

    Journal d’importation GlideImport

    Tableau 6. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale 4 000 caractères.
    source Chaîne Facultatif. Valeur de champ source associée à l’enregistrement du journal d’importation qui définit l’emplacement depuis lequel ce message a été journalisé dans le processus de jeu d’importation. Par exemple, Chargement peut représenter l’étape de chargement, Nettoyage peut représenter pendant le nettoyage après la transformation, et ainsi de suite.
    Tableau 7. Renvoie
    Type Description
    Néant 
    var importLog = new GlideImportLog();
importLog.info('Successfully executed transform');

    GlideImportLog : setImportRunHistory(Chaîne importRunHistory)

    Associe l’objet GlideImportLog à un enregistrement d’exécution d’ensemble d’importation spécifique.

    Tableau 8. Paramètres
    Nom Type Description
    importRunHistory Chaîne sys_id d’un enregistrement de la table Historique de transformation [sys_import_set_run].
    Tableau 9. Renvoie
    Type Description
    nul 
    var importRunSysId = '4aa3a8d55ba10010953330ad5981c79f';
var importLog = new GlideImportLog();
importLog.setImportRunHistory(importRunSysId);

    GlideImportLog : warn(Message de chaîne, Source de chaîne)

    Consigne un message de type Avertissement dans la table Journal d’importation [import_log].

    Journal d’importation GlideImport

    Tableau 10. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale 4 000 caractères.
    source Chaîne Facultatif. Valeur de champ source associée à l’enregistrement du journal d’importation qui définit l’emplacement depuis lequel ce message a été journalisé dans le processus de jeu d’importation. Par exemple, Chargement peut représenter l’étape de chargement, Nettoyage peut représenter pendant le nettoyage après la transformation, et ainsi de suite.
    Tableau 11. Renvoie
    Type Description
    Néant 
    var importLog = new GlideImportLog();
importLog.warn('Transform taking longer than expected.');