---
sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Integrationen mit Anwendungen erstellen

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Zuordnung mit Skripts für Transformationsereignisse

# Zuordnung mit Skripts für Transformationsereignisse {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Transformationsereignisse treten während des Transformationsprozesses einer Importsatztabelle in eine Tabelle auf.
Diese Ereignisse ändern das Transformationsverhalten für jede Art von Zuordnungsspezifikation. Skripts für Transformationsereignisse ändern die Verarbeitung von Ereignissen in verschiedenen Phasen der Transformation.

Beispielsweise kann die Verarbeitung eines Zuordnungsvorgangs, der mit dem [Zuordnungsassistent-Dienstprogramm](https://servicenow-prod.fluidtopics.net/uSoDzf2b6oxaDMEQsz9C~w "Abhängig von den Umständen des Imports und davon, ob Daten vor dem Laden in eine Produktionstabelle umgewandelt werden müssen, können Sie Felder auf verschiedene Arten zuordnen.") definiert wurde, mithilfe der Ereignisskripts manipuliert 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 sich diese Objekte beziehen, je nach Kontext des Ereignisses, in dem sie referenziert werden, unterschiedlich ist.  
Im Folgenden finden Sie eine Tabelle aller Transformationsereignisse und ihrer kontextbezogenen Variablen.  
Hinweis:  
Um die Importprotokolle anzuzeigen, legen Sie die Eigenschaft glide.importlog.log_to_table auf „wahr" fest. Weitere Informationen finden Sie unter [Eigenschaften für Importsätze](https://servicenow-prod.fluidtopics.net/zzA6bn3D5vnQDXb9sRljuw "Mehrere Eigenschaften steuern das Verhalten von Importsätzen.").  
{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq__entry__2}

| Ereignisname | Ereignisparameter |
|-|-|
| onStart | Wann: Das Ereignisskript „onStart" wird zu Beginn einer Importausführung verarbeitet, bevor Datenzeilen gelesen werden. {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onStart". | |-|-|-| | Quelle | GlideRecord | In der ersten Zeile der Quelltabelle sind noch keine Daten vorhanden, da die Zeile noch nicht gelesen wurde. | | import_set | GlideRecord | Der Importsatz, der gerade transformiert wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Ignorieren | Boolean | Bei Festlegung auf „wahr" wird die gesamte Transformation angehalten, und es findet keine weitere Verarbeitung statt. | | Fehler | Boolean | Wenn auf „wahr" festgelegt, hat dies den gleichen Effekt wie das Ignorieren der Kennzeichnung, dass die gesamte Transformation mit einer Fehlermeldung angehalten wird. | [Tabelle : 2. Importsatz-JS-Objekte, die zum Referenzieren verfügbar sind, und deren Kontext im onStart-Ereignis] {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq} 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 Ereignisskript „onComplete" wird am Ende einer Importausführung verarbeitet, nachdem alle Datenzeilen gelesen und transformiert wurden. {#r_MapWithTransformationEventScripts__table_hln_4ss_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onComplete". | |-|-|-| | Quelle | GlideRecord | Die letzte Zeile der Importsatz-Quelltabelle. | | Ziel | GlideRecord | Die letzte Zeile der Zieltabelle. | | import_set | GlideRecord | Der Importsatz, der gerade transformiert wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Fehler | Boolean | Bei Festlegung auf „wahr" wird der aktuelle Importsatzstatus nach Abschluss des Importsatzes als „Fehler" markiert. | [Tabelle : 3. Importsatz-JS-Objekte, die zur Referenzierung verfügbar sind, und deren Kontext im onComplete-Ereignis] {#r_MapWithTransformationEventScripts__table_hln_4ss_sq} 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 Ereignisskript „onBefore" wird zu Beginn einer Zeilentransformation verarbeitet, bevor die Quellzeile in die Zielzeile umgewandelt wird. {#r_MapWithTransformationEventScripts__table_myd_kts_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onBefore". | |-|-|-| | Quelle | GlideRecord | Die Zeile der Quelltabelle, die gerade verarbeitet wird. | | Ziel | GlideRecord | Die Zeile der Zieltabelle, die derzeit verarbeitet wird. | | import_set | GlideRecord | Der Importsatz, der gerade transformiert wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Aktion | Zeichenfolge | Die Aktion gibt entweder den Wert „einfügen" oder „aktualisieren" zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll. | | Ignorieren | Boolean | Bei Festlegung auf „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 Kennzeichnung „Ignorieren" auf „wahr" gesetzt ist. | | status_message | Zeichenfolge | Definiert eine anwenderdefinierte Nachricht, die in gesendet werden soll\<status_message\> XML-Antwort. | | Fehler | Boolean | Bei Festlegung auf „wahr" wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten. | | error_message | Zeichenfolge | Definiert eine anwenderdefinierte Nachricht, die in gesendet werden soll\<error_message\> XML-Antwort. | [Tabelle : 4. Importsatz-JS-Objekte, die zur Referenzierung verfügbar sind, und deren Kontext im onBefore-Ereignis] {#r_MapWithTransformationEventScripts__table_myd_kts_sq} 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 Ereignisskript „onAfter" wird am Ende einer Zeilentransformation verarbeitet, nachdem die Quellzeile in die Zielzeile umgewandelt und gespeichert wurde. {#r_MapWithTransformationEventScripts__table_us2_m5s_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Ereignis „onAfter-Importsatz" | |-|-|-| | Quelle | GlideRecord | Die Zeile der Quelltabelle, die gerade verarbeitet wird. | | Ziel | GlideRecord | Die Zeile der Zieltabelle, die derzeit verarbeitet wird. | | import_set | GlideRecord | Der Importsatz, der gerade transformiert wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Aktion | Zeichenfolge | Die Aktion gibt entweder den Wert „einfügen" oder „aktualisieren" zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert wurde. | | status_message | Zeichenfolge | Definiert eine anwenderdefinierte Nachricht, die in gesendet werden soll\<status_message\> XML-Antwort. | | Fehler | Boolean | Bei Festlegung auf „wahr" wird die gesamte Transformation für den aktuellen Importsatz mit einer Fehlermeldung angehalten. | | error_message | Zeichenfolge | Definiert eine anwenderdefinierte Nachricht, die in gesendet werden soll\<error_message\> XML-Antwort. | [Tabelle : 5. Importsatz-JS-Objekte, die zum Referenzieren verfügbar sind, und ihr Kontext im onAfter-Ereignis] {#r_MapWithTransformationEventScripts__table_us2_m5s_sq} 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 Ereignisskript „onForeignInsert" wird zu Beginn der Erstellung eines zugehörigen, referenzierten Datensatzes verarbeitet, bevor der Datensatz erstellt wird. {#r_MapWithTransformationEventScripts__table_o4c_svs_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onForeignInsert". | |-|-|-| | Quelle | GlideRecord | Die Zeile der Quelltabelle, die gerade verarbeitet wird. | | Ziel | GlideRecord | Die Zeile der Zieltabelle, die derzeit verarbeitet wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Aktion | Zeichenfolge | Die Aktion gibt entweder den Wert „einfügen" oder „aktualisieren" zurück, der angibt, ob die aktuelle Zielzeile erstellt oder aktualisiert werden soll. | | name | Zeichenfolge | Gibt den Feldnamen des Zieldatensatzes an, für den ein fremder Datensatz erstellt werden soll. | | Wert | Zeichenfolge | Ergibt den Anzeigewert aus dem Quelldatensatz, für den ein fremder Datensatz erstellt werden soll. | | Ignorieren | Boolean | Bei Festlegung auf „wahr" wird die Erstellung eines neuen fremden oder zugehörigen Datensatzes ignoriert. | | Fehler | Boolean | Bei Festlegung auf „wahr" wird die gesamte Transformationszeile abgelehnt. Für diese Zeile werden keine Daten gespeichert. | [Tabelle : 6. Importsatz-JS-Objekte, die zum Referenzieren verfügbar sind, und deren Kontext im onForeignInsert-Ereignis] {#r_MapWithTransformationEventScripts__table_o4c_svs_sq} 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. {#r_MapWithTransformationEventScripts__table_t4k_pws_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onChoiceCreate". | |-|-|-| | Quelle | GlideRecord | Die Zeile der Quelltabelle, die gerade verarbeitet wird. | | Ziel | GlideRecord | Die Zeile der Zieltabelle, die derzeit verarbeitet wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Protokoll | Funktion | Das Protokollobjekt für die aktuelle Importausführung. Beispiel: log.info(...), log.warn(...), log.error(...). | | Aktion | Zeichenfolge | Die Aktion gibt entweder den Wert „einfügen" oder „aktualisieren" 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 Festlegung auf „wahr" wird die Erstellung eines Auswahlwerts ignoriert. | | Fehler | Boolean | Bei Festlegung auf „wahr" wird die gesamte Transformationszeile abgelehnt. Für diese Zeile werden keine Daten gespeichert. | [Tabelle : 7. Importieren Sie die zur Referenzierung verfügbaren JS-Objekte und deren Kontext im onChoiceCreate-Ereignis] {#r_MapWithTransformationEventScripts__table_t4k_pws_sq} Beispiel: //Create an event var e = new GlideEvent("myimport_ChoiceCreate", action, value, ""); e.insert(); |
| onReject | Wann: Das Ereignisskript „onReject" wird während des Vorkommens eines fremden Datensatzes oder der Erstellung einer Auswahl verarbeitet, und der fremde Datensatz oder die Auswahl wird abgelehnt. Die gesamte Transformationszeile wird nicht gespeichert. {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq__entry__3} | JS-Objekt des Importsatzes | Typ | Kontext im Importsatz-Ereignis „onError". | |-|-|-| | Quelle | GlideRecord | Die Zeile der Quelltabelle, die gerade verarbeitet wird. | | Ziel | GlideRecord | Die Zeile der Zieltabelle, die derzeit verarbeitet wird. | | Zuordnen | GlideTransformMap | Schreibgeschützte Informationen zum aktuellen Datensatz der Transformationszuordnung. | | Aktion | Zeichenfolge | Die Aktion gibt entweder den Wert „einfügen" oder „aktualisieren" 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(...). | [Tabelle : 8. Importieren Sie die zur Referenzierung verfügbaren JS-Objekte und deren Kontext im onError-Ereignis] {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq} Beispiel: //Create an event var e = new GlideEvent("myimport_onReject", action, "", ""); e.insert(); |
[Tabelle : 1. Transformationsereignisse und ihre kontextbezogenen Variablen]

{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq}