GlideImportLog : dans le champ d’application, global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • L’API GlideImportLog fournit des méthodes pour é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 à partir duquel 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 le nettoyage après la transformation, et ainsi de suite.

    Exemple sans paramètre de 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 : error(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 Glide

    Tableau 2. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale de 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 à partir duquel 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 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 de l’exécution de l’importation associé à ce journal d’importation.

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    Tableau 5. Renvoie
    Type Description
    Chaîne Sys_id d’un enregistrement d’exécution de 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 Informations dans la table Journal d’importation [import_log].

    Journal d’importation Glide

    Tableau 6. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale de 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 à partir duquel 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 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(String importRunHistory)

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

    Tableau 8. Paramètres
    Nom Type Description
    importRunHistory Chaîne La 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 Avertir dans la table Journal d’importation [import_log].

    Journal d’importation Glide

    Tableau 10. Paramètres
    Nom Type Description
    message Chaîne Message du journal. Longueur maximale de 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 à partir duquel 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 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.');