Ordnen Sie Transformationsereignisskripts zu

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Transformationsereignisse treten während des Prozesses der Umwandlung einer Importsatztabelle in eine Tabelle auf.

    Diese Ereignisse ändern das Transformationsverhalten aus jeder Art von Zuordnungsspezifikation. Transformationsereignisskripts ändern die Verarbeitung der Ereignisse in verschiedenen Phasen der Transformation.

    Zum Beispiel die Verarbeitung eines Zuordnungsvorgangs, der mit definiert wurde Zuordnungsassistent-Dienstprogramm Kann mithilfe der Ereignisskripts bearbeitet werden. Es gibt eine Reihe von Importsatz-JavaScript-Objekten, auf die während dieser Ereignisse zugegriffen werden kann. Diese Objekte stellen Tabellen oder Teile von Tabellen dar. Es ist wichtig zu beachten, dass das, worauf diese Objekte verweisen, je nach Kontext des Ereignisses variiert, in dem sie referenziert werden.

    Im Folgenden finden Sie eine Tabelle aller Transformationsereignisse und ihrer kontextbezogenen Variablen.
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Tabelle : 1. Transformieren Sie Ereignisse und ihre kontextbezogenen Variablen
    Ereignisname Ereignisparameter
    onStart

    Wenn: Das onStart-Ereignisskript wird zu Beginn einer Importausführung verarbeitet, bevor Datenzeilen gelesen werden.

    Tabelle : 2. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im onStart-Ereignis
    Importsatz-JS-Objekt Typ Kontext im onStart-Importsatz-Ereignis
    Quelle GlideRecord Die erste Zeile der Quelltabelle. Es sind noch keine Daten vorhanden, da die Zeile nicht gelesen wurde.
    import_set GlideRecord Der Importsatz, der derzeit transformiert wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Ignorieren Boolean Bei „wahr“ wird die gesamte Transformation angehalten, und es findet keine weitere Verarbeitung statt.
    Fehler Boolean Wenn dieser Wert auf „wahr“ festgelegt ist, hat dies die gleiche Wirkung wie die Ignorieren-Kennzeichnung zum Stoppen der gesamten Transformation mit einer Fehlermeldung.

    Beispiel:

    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

    Wenn: Das Ereignisskript onComplete wird am Ende einer Importausführung verarbeitet, nachdem alle Datenzeilen gelesen und umgewandelt wurden.

    Tabelle : 3. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im onComplete-Ereignis
    Importsatz-JS-Objekt Typ Kontext im Ereignis „onComplete-Importsatz“
    Quelle GlideRecord Die letzte Zeile der Quellimportsatztabelle.
    Ziel GlideRecord Die letzte Zeile der Zieltabelle.
    import_set GlideRecord Der Importsatz, der derzeit transformiert wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Fehler Boolean Bei „wahr“ wird der aktuelle Importsatzstatus nach Abschluss als „Fehler“ markiert.

    Beispiel:

    // 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

    Wenn: Das onBefore-Ereignisskript wird zu Beginn einer Zeilentransformation verarbeitet, bevor die Quellzeile in die Zielzeile umgewandelt wird.

    Tabelle : 4. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im onBefore-Ereignis
    Importsatz-JS-Objekt Typ Kontext im onBefore-Importsatz-Ereignis
    Quelle GlideRecord Die Zeile der Quelltabelle, die derzeit verarbeitet wird.
    Ziel GlideRecord Die Zeile der Zieltabelle, die derzeit verarbeitet wird.
    import_set GlideRecord Der Importsatz, der derzeit transformiert wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Aktion Zeichenfolge Die Aktion gibt entweder den Wert „INSERT“ oder „Update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Ignorieren Boolean Bei „wahr“ wird die aktuelle Zeilentransformation übersprungen, und die verbleibenden Zeilen werden verarbeitet.

    Wenn Sie ein onAfter-Skript definiert haben, wird das onAfter-Skript für die aktuelle Zeile ausgeführt, auch wenn die Ignorieren-Kennzeichnung auf „wahr“ festgelegt ist.
    status_message Zeichenfolge Definiert eine anwenderdefinierte Nachricht, die in der <status_message>-XML-Antwort gesendet werden soll.
    Fehler Boolean Bei „wahr“ wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten.
    error_message Zeichenfolge Definiert eine anwenderdefinierte Nachricht, die in der <error_message>-XML-Antwort gesendet werden soll.

    Beispiel:

    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

    Wenn: Das onAfter-Ereignisskript wird am Ende einer Zeilentransformation verarbeitet, nachdem die Quellzeile in die Zielzeile umgewandelt und gespeichert wurde.

    Tabelle : 5. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im onAfter-Ereignis
    Importsatz-JS-Objekt Typ Kontext im onAfter-Importsatz-Ereignis
    Quelle GlideRecord Die Zeile der Quelltabelle, die derzeit verarbeitet wird.
    Ziel GlideRecord Die Zeile der Zieltabelle, die derzeit verarbeitet wird.
    import_set GlideRecord Der Importsatz, der derzeit transformiert wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Aktion Zeichenfolge Die Aktion gibt entweder den Wert „INSERT“ oder „Update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert wurde.
    status_message Zeichenfolge Definiert eine anwenderdefinierte Nachricht, die in der <status_message>-XML-Antwort gesendet werden soll.
    Fehler Boolean Bei „wahr“ wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten.
    error_message Zeichenfolge Definiert eine anwenderdefinierte Nachricht, die in der <error_message>-XML-Antwort gesendet werden soll.

    Beispiel:

    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

    Wenn: Das Ereignisskript onForeignInsert wird zu Beginn der Erstellung eines zugehörigen, referenzierten Datensatzes verarbeitet, bevor der Datensatz erstellt wird.

    Tabelle : 6. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im Ereignis onForeignInsert
    Importsatz-JS-Objekt Typ Kontext im Ereignis onForeignInsert Importsatz
    Quelle GlideRecord Die Zeile der Quelltabelle, die derzeit verarbeitet wird.
    Ziel GlideRecord Die Zeile der Zieltabelle, die derzeit verarbeitet wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Aktion Zeichenfolge Die Aktion gibt entweder den Wert „INSERT“ oder „Update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    name Zeichenfolge Wertet den Feldnamen des Zieldatensatzes aus, für den ein Fremddatensatz erstellt werden soll.
    Wert Zeichenfolge Wertet den Anzeigewert aus dem Quelldatensatz aus, für den ein fremder Datensatz erstellt werden soll.
    Ignorieren Boolean Bei „wahr“ wird die Erstellung eines neuen fremden oder zugehörigen Datensatzes ignoriert.
    Fehler Boolean Bei „wahr“ wird die gesamte Transformationszeile abgelehnt. Für diese Zeile werden keine Daten gespeichert.

    Beispiel:

    //Create an event.
var e = new GlideEvent("myimport_ForeignInsert", action, name, "");
e.insert();
    onChoiceCreate

    Wenn: Das Ereignisskript onChoiceCreate wird zu Beginn der Erstellung eines Auswahlwerts verarbeitet, bevor der neue Auswahlwert erstellt wird.

    Tabelle : 7. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im onChoiceCreate-Ereignis
    Importsatz-JS-Objekt Typ Kontext im Ereignis onChoiceCreate Importsatz
    Quelle GlideRecord Die Zeile der Quelltabelle, die derzeit verarbeitet wird.
    Ziel GlideRecord Die Zeile der Zieltabelle, die derzeit verarbeitet wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Aktion Zeichenfolge Die Aktion gibt entweder den Wert „INSERT“ oder „Update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    name Zeichenfolge Wertet den Feldnamen des Zieldatensatzes aus, für den ein Auswahlwert erstellt werden soll.
    Wert Zeichenfolge Wertet den Anzeigewert aus dem Quelldatensatz aus, für den eine Auswahl erstellt werden soll.
    Ignorieren Boolean Bei „wahr“ wird die Erstellung eines Auswahlwerts ignoriert.
    Fehler Boolean Bei „wahr“ wird die gesamte Transformationszeile abgelehnt. Für diese Zeile werden keine Daten gespeichert.

    Beispiel:

    //Create an event
var e = new GlideEvent("myimport_ChoiceCreate", action, value, "");
e.insert();
    onReject

    Wenn: Das Ereignisskript „onReject“ während des Vorkommens eines fremden Datensatzes oder der Auswahlerstellung verarbeitet wird und der fremde Datensatz oder die fremde Auswahl abgelehnt wird, wird die gesamte Transformationszeile nicht gespeichert.

    Tabelle : 8. Importsatz-JS-Objekte, auf die verwiesen werden kann, und ihr Kontext im OnError-Ereignis
    Importsatz-JS-Objekt Typ Kontext im OnError-Importsatz-Ereignis
    Quelle GlideRecord Die Zeile der Quelltabelle, die derzeit verarbeitet wird.
    Ziel GlideRecord Die Zeile der Zieltabelle, die derzeit verarbeitet wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    Aktion Zeichenfolge Die Aktion gibt entweder den Wert „INSERT“ oder „Update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    log Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie fest glide.importlog.log_to_tableEigenschaft auf „wahr“. Weitere Informationen finden Sie unter Importsatzeigenschaften.
    Beispiel:
    //Create an event
var e = new GlideEvent("myimport_onReject", action, "", "");
e.insert();