GlideImportSetTransformer : champ d’application, global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • L’API GlideImportSetTransformer fournit des méthodes pour créer un objet Import Set Transformer 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
    Néant 
    var transformer = new GlideImportSetTransformer();

    GlideImportSetTransformer : getImportSetRun()

    Obtient l’objet d’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éé par 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 s’il y a eu ou non une erreur au cours d’une transformation.

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    Tableau 5. Renvoie
    Type Description
    Booléen Marqueur indiquant s’il y a une erreur.
    • true : erreur.
    • false : réussite.
    		 
    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 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 de 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 à relier à l’historique des jeux 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
    ID de carte 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 d’exécuter des transformations synchrones.

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

    Valeurs valides :

    • true : exécuter la transformation de façon synchrone
    • false : 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, String rowSysId)

    Exécute la transformation du jeu d’importation.

    Tableau 16. Paramètres
    Nom Type Description
    Ensemble d’importation GlideRecord GlideRecord du jeu d’importation à exécuter.
    rowSysId Chaîne Facultatif. Limite la transformation à un seul enregistrement en transmettant la sys_id d’un enregistrement à partir 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);