Zuordnung mit Transformations-Event-Skripts

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

    • Transformationsereignisse treten während der Transformation einer Import Set-Tabelle in eine -Tabelle auf.

    Diese Ereignisse ändern das Transformationsverhalten jeder Art von Zuordnungsspezifikation. Transformations-Event-Skripts ändern die Verarbeitung der Events in verschiedenen Phasen der Transformation.

    Beispielsweise kann die Verarbeitung eines Zuordnungsvorgangs, der mit dem Mapping Assist-Dienstprogramm definiert wurde, mithilfe der Event-Skripts manipuliert werden. Es gibt eine Reihe von Import Set-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 der Verweis auf diese Objekte vom Kontext des Events abhängt, in dem sie referenziert werden.

    Die folgende Tabelle enthält alle Transformationsereignisse und ihre kontextbezogenen Variablen.
    Hinweis:
    Um die Importprotokolle anzuzeigen, legen Sie die Eigenschaft glide.importlog.log_to_table auf „true“ fest. Weitere Informationen finden Sie unter Import Set-Eigenschaften.
    Tabelle : 1. Transformations-Events und ihre kontextbezogenen Variablen
    Ereignisname Ereignisparameter
    onStart

    Wann: Das Event-Skript onStart wird zu Beginn einer Importausführung verarbeitet, bevor Datenzeilen gelesen werden.

    Tabelle : 2. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onStart-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis „onStart“.
    Quelle GlideRecord In der ersten Zeile der Quelltabelle 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.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Ignorieren Boolean Bei „true“ wird die gesamte Transformation angehalten, und es erfolgt keine weitere Verarbeitung.
    Fehler Boolean Wenn dies auf „true“ gesetzt ist, hat dies die gleiche Wirkung wie die Kennzeichnung „Ignorieren“, die die gesamte Transformation anhält, 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

    Wann: Das Event-Skript onComplete wird am Ende einer Importausführung verarbeitet, nachdem alle Datenzeilen gelesen und transformiert wurden.

    Tabelle : 3. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onComplete-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis „onComplete“.
    Quelle GlideRecord Die letzte Zeile der Quell-Import Set-Tabelle.
    Ziel GlideRecord Die letzte Zeile der Zieltabelle.
    import_set GlideRecord Der Importsatz, der derzeit transformiert wird.
    Zuordnen GlideTransformMap Schreibgeschützte Informationen zum aktuellen Transformationszuordnungsdatensatz.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Fehler Boolean Bei „true“ wird der aktuelle Import Set-Status 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

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

    Tabelle : 4. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onBefore-Ereignis
    Import Set 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.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Aktion Zeichenfolge Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Ignorieren Boolean Bei „true“ 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 Kennzeichnung „Ignorieren“ auf „true“ gesetzt ist.
    status_message Zeichenfolge Definiert eine benutzerdefinierte Nachricht, die im gesendet werden soll<status_message> XML-Antwort.
    Fehler Boolean Bei „true“ wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten.
    error_message Zeichenfolge Definiert eine benutzerdefinierte Nachricht, die im gesendet werden soll<error_message> XML-Antwort.

    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

    Wann: Das Event-Skript „onAfter“ wird am Ende einer Zeilentransformation verarbeitet, nachdem die Quellzeile in die Zielzeile umgewandelt und gespeichert wurde.

    Tabelle : 5. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onAfter-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis onAfter
    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.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Aktion Zeichenfolge Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert wurde.
    status_message Zeichenfolge Definiert eine benutzerdefinierte Nachricht, die im gesendet werden soll<status_message> XML-Antwort.
    Fehler Boolean Bei „true“ wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten.
    error_message Zeichenfolge Definiert eine benutzerdefinierte Nachricht, die im gesendet werden soll<error_message> XML-Antwort.

    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

    Wann: Das Event-Skript onForeignInsert wird zu Beginn der Erstellung eines zugehörigen, referenzierten Datensatzes verarbeitet, bevor der Datensatz erstellt wird.

    Tabelle : 6. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onForeignInsert-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis „onForeignInsert“.
    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.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Aktion Zeichenfolge Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Name Zeichenfolge Ergibt den Feldnamen des Zieldatensatzes, für den ein fremder Datensatz erstellt werden soll.
    Wert Zeichenfolge Ermittelt den Anzeigewert aus dem Quelldatensatz, für den ein fremder Datensatz erstellt werden soll.
    Aktion Zeichenfolge Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Ignorieren Boolean Bei „true“ wird die Erstellung eines neuen fremden oder zugehörigen Datensatzes ignoriert.
    Fehler Boolean Bei „true“ 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

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

    Tabelle : 7. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onChoiceCreate-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis „onChoiceCreate“.
    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.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Aktion Zeichenfolge Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Name Zeichenfolge Ergibt den Feldnamen des Zieldatensatzes, für den ein Auswahlwert erstellt werden soll.
    Wert Zeichenfolge Ergibt den Anzeigewert aus dem Quelldatensatz, für den eine Auswahl erstellt werden soll.
    Ignorieren Boolean Bei „true“ wird die Erstellung eines Auswahlwerts ignoriert.
    Fehler Boolean Bei „true“ 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

    Wann: Das Event-Skript „onReject“ wird während des Vorkommens eines fremden Datensatzes oder einer fremden Auswahlmöglichkeit verarbeitet, und der fremde Datensatz oder die fremde Auswahl wird abgelehnt, und die gesamte Transformationszeile wird nicht gespeichert.

    Tabelle : 8. Import Set-JS-Objekte, die referenziert werden können, und ihr Kontext im onError-Ereignis
    Import Set JS-Objekt Typ Kontext im Import Set-Ereignis „onError“.
    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 Aktion gibt den Wert „insert“ oder „update“ zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll.
    Protokoll Funktion Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...).
    Beispiel:
    //Create an event
var e = new GlideEvent("myimport_onReject", action, "", "");
e.insert();