---
sourceDocument: Australie Workflow Data Fabric
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications

 Release :

    - australia

ft:locale :

    - fr-FR

ft:publication_title :

    - Australie Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Carte avec scripts d'événements de transformation

# Carte avec scripts d'événements de transformation {#ariaid-title1}

* Rversion finale: Australia
* 
* Mis à jour 12 mars 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes de lecture

Les événements de transformation se produisent pendant le processus de transformation d'une table de jeux d'importation en table.
Ces événements modifient le comportement de transformation de tout type de spécification de mappage. Les scripts d'événements de transformation modifient le traitement des événements à différentes étapes de la transformation.

Par exemple, le traitement d'une opération de mappage définie à l'aide de [l'utilitaire Assistant de mappage](https://servicenow-prod.fluidtopics.net/aieFtO8NaKKuQZa2pm_jMA "Vous pouvez mapper les champs de plusieurs façons selon les circonstances de l’importation et si les données doivent être transformées avant le chargement sur une table de production.") peut être manipulé à l'aide des scripts d'événements. Il existe un certain nombre d'objets JavaScript de jeu d'importation qui sont accessibles pendant ces événements. Ces objets représentent des tables ou des parties de tables. Il est important de noter que la référence de ces objets varie en fonction du contexte de l'événement dans lequel ils sont référencés.  
Vous trouverez ci-dessous une table de tous les événements de transformation et de leurs variables contextuelles.  
Remarque :  
Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer.").  
{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq__entry__2}

| Nom d'événement | Paramètres d'événement |
|-|-|
| onStart | Quand : le script d'événement onStart est traité au début d'une exécution d'importation, avant la lecture des lignes de données. {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onStart | |-|-|-| | source | GlideRecord | La première ligne de la table source, il n'y a pas encore de données car la ligne n'a pas été lue. | | import_set | GlideRecord | L'ensemble de données à importer en cours de transformation. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | ignorer | Booléen | Lorsque la valeur est définie sur vrai, l'ensemble de la transformation est interrompu et aucun autre traitement ne se produit. | | erreur | Booléen | Lorsque la valeur est définie sur vrai, elle a le même effet que l'indicateur Ignorer d'arrêter toute la transformation, avec un message d'erreur. | [Tableau 2. Objets JS de jeu d'importation pouvant être référencés et leur contexte dans l'événement onStart] {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq} Exemple : var info = "Starting Import Set Transformation Mapping operation using Data source, " + map.table_source + " and Transform Map " + map.name + " on import set " + import_set.number; log.info( info ); |
| onComplete | Quand : le script d'événement onComplete est traité à la fin d'une exécution d'importation, une fois que toutes les lignes de données ont été lues et transformées. {#r_MapWithTransformationEventScripts__table_hln_4ss_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onComplete | |-|-|-| | source | GlideRecord | Dernière ligne de la table de jeux d'importation source. | | target | GlideRecord | La dernière ligne de la table cible. | | import_set | GlideRecord | L'ensemble de données à importer en cours de transformation. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | erreur | Booléen | Lorsque la valeur est définie sur vrai, marque l'état actuel de l'ensemble d'importation sur Erreur une fois l'opération terminée. | [Tableau 3. Ensembles de données à importer Objets JS pouvant être référencés et leur contexte dans l'événement onComplete] {#r_MapWithTransformationEventScripts__table_hln_4ss_sq} Exemple : // Create a myimport_completed event that can be reacted by an email notification or script action // (there is already an import.finished event that the system will create at the end of an import) var e = new GlideEvent("myimport_completed", import_set.sys_id, map.sys_id, ""); e.insert(); |
| onBefore | Quand : le script d'événement onBefore est traité au début d'une transformation de ligne, avant que la ligne source ne soit transformée en ligne cible. {#r_MapWithTransformationEventScripts__table_myd_kts_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onBefore | |-|-|-| | source | GlideRecord | Ligne de la table source en cours de traitement. | | target | GlideRecord | Ligne de la table cible en cours de traitement. | | import_set | GlideRecord | L'ensemble de données à importer en cours de transformation. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | action | Chaîne | L'action renvoie une valeur \<\< insérer \>\> ou \<\< mettre à jour \>\> indiquant si la ligne cible actuelle est sur le point d'être créée ou mise à jour. | | ignorer | Booléen | Lorsque la valeur est définie sur vrai, la transformation de ligne actuelle est ignorée et les lignes restantes sont traitées. Si vous avez défini un script onAfter, le script onAfter s'exécute pour la ligne actuelle même si le marqueur Ignorer est défini sur vrai. | | status_message | Chaîne | Définit un message personnalisé à envoyer dans la réponse XML de l'\<status_message\>. | | erreur | Booléen | Lorsque la valeur est définie sur vrai, l'ensemble de la transformation est interrompu pour le jeu d'importation actuel, avec un message d'erreur. | | error_message | Chaîne | Définit un message personnalisé à envoyer dans la réponse XML de l'\<error_message\>. | [Tableau 4. Jeu d'importation Objets JS pouvant être référencés et leur contexte dans l'événement onBefore] {#r_MapWithTransformationEventScripts__table_myd_kts_sq} Exemple : var name = source.u_name.toString(); var info = "Before the row is transformed, " + name; log.info( info ); // Make sure a company name has been provided var company = source.u_company.toString(); if(company.length == 0 ){ ignore = true; info ="No company name, row ignored! " + name; log.info( info ); } |
| onAfter | Quand : le script d'événement onAfter est traité à la fin d'une transformation de ligne, une fois que la ligne source a été transformée en ligne cible et enregistrée. {#r_MapWithTransformationEventScripts__table_us2_m5s_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de définition de données à importer onAfter | |-|-|-| | source | GlideRecord | Ligne de la table source en cours de traitement. | | target | GlideRecord | Ligne de la table cible en cours de traitement. | | import_set | GlideRecord | L'ensemble de données à importer en cours de transformation. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | action | Chaîne | L'action renvoie une valeur \<\< insérer \>\> ou \<\< mettre à jour \>\> indiquant si la ligne cible actuelle a été créée ou mise à jour. | | status_message | Chaîne | Définit un message personnalisé à envoyer dans la réponse XML de l'\<status_message\>. | | erreur | Booléen | Lorsque la valeur est définie sur vrai, l'ensemble de la transformation est interrompu pour le jeu d'importation actuel, avec un message d'erreur. | | error_message | Chaîne | Définit un message personnalisé à envoyer dans la réponse XML de l'\<error_message\>. | [Tableau 5. Jeu d'importation Objets JS pouvant être référencés et leur contexte dans l'événement onAfter] {#r_MapWithTransformationEventScripts__table_us2_m5s_sq} Exemple : if(source.new=="true"){ gs.include('Cart');var bundle =new GlideRecord('sc_cat_item'); bundle.addQuery('name','CONTAINS','comp'); bundle.query(); if(bundle.next()){ var new_comp_cart = new Cart(); var cart = new Cart(); var item = cart.addItem(bundle); var rc = cart.placeOrder(); log.info(rc.number);}} |
| onForeignInsert | Quand : le script d'événement onForeignInsert est traité au début de la création d'un enregistrement connexe référencé, avant la création de l'enregistrement. {#r_MapWithTransformationEventScripts__table_o4c_svs_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onForeignInsert | |-|-|-| | source | GlideRecord | Ligne de la table source en cours de traitement. | | target | GlideRecord | Ligne de la table cible en cours de traitement. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | action | Chaîne | L'action renvoie une valeur \<\< insérer \>\> ou \<\< mettre à jour \>\> indiquant si la ligne cible actuelle est sur le point d'être créée ou mise à jour. | | nom | Chaîne | Évalue le nom de champ de l'enregistrement cible pour lequel un enregistrement étranger est sur le point d'être créé. | | valide | Chaîne | Évalue la valeur d'affichage de l'enregistrement source pour lequel un enregistrement étranger est sur le point d'être créé. | | ignorer | Booléen | Lorsque la valeur est définie sur vrai, ignore la création d'un nouvel enregistrement étranger ou connexe. | | erreur | Booléen | Lorsque la valeur est définie sur vrai, rejette la ligne de transformation entière et aucune donnée n'est enregistrée pour cette ligne. | [Tableau 6. Ensembles de données à importer Objets JS pouvant être référencés et leur contexte dans l'événement onForeignInsert] {#r_MapWithTransformationEventScripts__table_o4c_svs_sq} Exemple : //Create an event. var e = new GlideEvent("myimport_ForeignInsert", action, name, ""); e.insert(); |
| onChoiceCreate | Quand : le script d'événement onChoiceCreate est traité au début de la création d'une valeur de choix, avant la création de la nouvelle valeur de choix. {#r_MapWithTransformationEventScripts__table_t4k_pws_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onChoiceCreate | |-|-|-| | source | GlideRecord | Ligne de la table source en cours de traitement. | | target | GlideRecord | Ligne de la table cible en cours de traitement. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | | action | Chaîne | L'action renvoie une valeur \<\< insérer \>\> ou \<\< mettre à jour \>\> indiquant si la ligne cible actuelle est sur le point d'être créée ou mise à jour. | | nom | Chaîne | Évalue le nom de champ de l'enregistrement cible pour lequel une valeur de choix est sur le point d'être créée. | | valide | Chaîne | Évalue la valeur d'affichage de l'enregistrement source pour lequel un choix est sur le point d'être créé. | | ignorer | Booléen | Lorsque la valeur est définie sur vrai, ignore la création d'une valeur de choix. | | erreur | Booléen | Lorsque la valeur est définie sur vrai, rejette la ligne de transformation entière et aucune donnée n'est enregistrée pour cette ligne. | [Tableau 7. Objets JS de jeu d'importation pouvant être référencés et leur contexte dans l'événement onChoiceCreate] {#r_MapWithTransformationEventScripts__table_t4k_pws_sq} Exemple : //Create an event var e = new GlideEvent("myimport_ChoiceCreate", action, value, ""); e.insert(); |
| onReject | Lorsque : le script d'événement onReject est traité lors de la création d'un enregistrement ou d'un choix étranger, et que l'enregistrement ou le choix étranger est rejeté, la ligne de transformation entière n'est pas enregistrée. {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq__entry__3} | Objet JS du jeu d'importation | Type | Contexte dans l'événement de jeu d'importation onError | |-|-|-| | source | GlideRecord | Ligne de la table source en cours de traitement. | | target | GlideRecord | Ligne de la table cible en cours de traitement. | | carte | GlideTransformMap | Informations en lecture seule sur l'enregistrement actuel de la carte de transformation. | | action | Chaîne | L'action renvoie une valeur \<\< insérer \>\> ou \<\< mettre à jour \>\> indiquant si la ligne cible actuelle est sur le point d'être créée ou mise à jour. | | journal | Fonction | Objet de journal pour l'exécution de l'importation actuelle. Par exemple, log.info(...), log.warn(...), log.error(...). Remarque : Pour afficher les journaux d'importation, définissez la glide.importlog.log_to_table propriété sur vrai. Pour plus d'informations, consultez [Propriétés des ensembles de données à importer](https://servicenow-prod.fluidtopics.net/u1YdcfjQUa0ORRZD8qB9fQ "Plusieurs propriétés contrôlent le comportement des ensembles de données à importer."). | [Tableau 8. Objets JS de jeu d'importation pouvant être référencés et leur contexte dans l'événement onError] {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq} Exemple : //Create an event var e = new GlideEvent("myimport_onReject", action, "", ""); e.insert(); |
[Tableau 1. Les événements de transformation et leurs variables contextuelles]

{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq}