GlideImportSetTransformer : dans le champ d’application, global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • L’API GlideImportSetTransformer fournit des méthodes pour créer un objet transformateur de jeu d’importation utilisé pour exécuter une transformation de jeu d’importation.

    Pour exécuter une transformation de jeu d’importation :
    1. Créez une table de jeu d’importation à l’aide de l’API GlideImportSetTable .
    2. Créez une carte de transformation à l’aide de l’API GlideImportSetTransformMap .
    3. Créez ou utilisez un jeu d’importation existant à l’aide de l’API GlideRecord .
    4. Exécutez une transformation de jeu d’importation à l’aide de l’API GlideImportSetTransformer .
    Une fois que vous avez créé l’enregistrement du jeu d’importation, il doit être consommé par l’API GlideImportSetTransformer pour déclencher la transformation.
    var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSetGr);

    GlideImportSetTransformer : GlideImportSetTransformer()

    Instancie un objet GlideImportSetTransformer.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun 
    var transformer = new GlideImportSetTransformer();

    GlideImportSetTransformer : getImportSetRun()

    Obtient l’objet Exécution du jeu d’importation associé à un objet GlideImportSetTransformer.

    Tableau 2. Paramètres
    Nom Type Description
    Aucun
    Tableau 3. Renvoie
    Type Description
    GlideImportSetRun Objet GlideImportSetRun créé lors de l’exécution d’une transformation ou de l’argument fourni à la méthode setImportSetRun( ). 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);
var importSetRun = transformer.getImportSetRun();

    GlideImportSetTransformer : isError()

    Renvoie une valeur booléenne spécifiant si une erreur s’est produite ou non lors d’une transformation.

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    Tableau 5. Renvoie
    Type Description
    Booléen Marqueur indiquant s’il y a eu une erreur.
    • true : erreur.
    • faux : Succès.
    		 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);
if(transformer.isError()) {
	gs.error('Error executing the transform');
}

    GlideImportSetTransformer : setImportSetID(ID de chaîne)

    Associe un enregistrement de jeu d’importation à un objet GlideImportSetTransformer spécifique.

    Tableau 6. Paramètres
    Nom Type Description
    id Chaîne La sys_id d’un enregistrement de jeu d’importation à partir de la table Jeux d’importation [sys_import_set].
    Tableau 7. Renvoie
    Type Description
    nul 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.setImportSetID(importSetID);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer : setImportSetRun(GlideImportSetRun, importSetRun)

    Associe un objet d’exécution du jeu d’importation à un objet GlideImportSetTransformer spécifique.

    Tableau 8. Paramètres
    Nom Type Description
    importSetRun GlideImportSetRun Objet GlideImportSetRun représentant l’enregistrement ImportSetRun pour suivre l’historique de transformation.
    Tableau 9. Renvoie
    Type Description
    nul 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var importSetRun = new GlideImportSetRun(importSetID);
var transformer = new GlideImportSetTransformer();
transformer.setImportSetRun(importSetRun);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer : setLogger(journal GlideImportLog)

    Associe un objet GlideImportLog à un objet GlideImportSetTransformer spécifique.

    Si cette méthode n’est pas appelée avant d’appeler la méthode transformAllMaps( ), un objet GlideImportLog est créé en interne côté serveur.

    Tableau 10. Paramètres
    Nom Type Description
    journal Journal d’importation Glide Objet GlideImportLog à lier à l’historique des ensembles d’importation. Une fois défini, tout appel de l’objet GlideImportLog est associé à l’historique d’exécution du jeu d’importation pour cette transformation spécifique.
    Tableau 11. Renvoie
    Type Description
    nul 
    var importSet = new GlideRecord('sys_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);

    GlideImportSetTransformer : setMapID(String mapID)

    Associe une carte de transformation à un objet GlideImportSetTransformer spécifique.

    Tableau 12. Paramètres
    Nom Type Description
    mapID Chaîne Un sys_id de la table Cartes de transformation de table [sys_transform_map].
    Tableau 13. Renvoie
    Type Description
    nul 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformMapId = '<sys id of transform map>';
var transformer = new GlideImportSetTransformer();
transformer.setMapID(transformMapId);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer : setSyncImport (booléen synchrone)

    Permet l’exécution de transformations synchrones.

    Tableau 14. Paramètres
    Nom Type Description
    synchrone Booléen Définit le mode de transformation.

    Valeurs valides :

    • vrai : exécuter la transformation de façon synchrone
    • faux : exécuter la transformation de façon asynchrone

    Valeur par défaut : false
    Tableau 15. Renvoie
    Type Description
    nul 
    
var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.setSyncImport(true);
transformer.transformAllMaps(importSet);

    GlideImportSetTransformer : transformAllMaps(GlideRecord importSet, chaîne rowSysId)

    Exécute la transformation du jeu d’importation.

    Tableau 16. Paramètres
    Nom Type Description
    Ensemble d’importSets GlideRecord GlideRecord de l’ensemble d’importation à exécuter.
    rowSysId Chaîne Facultatif. Limite la transformation à un seul enregistrement en transmettant le sys_id d’un enregistrement de la table Jeux d’importation [sys_import_set].

    Par défaut : transformer toutes les lignes
    Tableau 17. Renvoie
    Type Description
    nul 
    var importSet = new GlideRecord('sys_import_set');
importSet.short_description = 'Import set from scripted rest api';
importSet.table_name = importSetTableName;
var importSetID = importSet.insert();
var transformer = new GlideImportSetTransformer();
transformer.transformAllMaps(importSet);