RTE-Vorgangstypen, die in der App Gemeinsame Komponenten für CMDB-Integrationen enthalten sind

Die RTE-Vorgangstypen (Robust Transform Engine) sind gängige Vorgangsmethoden zur Verwendung in ETL, ohne dass Sie Ihre eigenen komplexen Datentransformationen schreiben müssen.

Die folgenden Vorgangstypen sind in der App Gemeinsame Komponenten für CMDB-Integrationen verfügbar.

Verkettung

Kombiniert die Werte aus Eingabefeldern zu einer einzelnen Zeichenfolge und verbindet sie im optionalen Feld joining_string.

Details
Tabelle	RTE-Entitätsverkettungsvorgang [sys_rte_eb_concat_operation]
Eingabefeld	source_sys_rte_eb_fields Die Eingabe ist ein Satz von Feldern und Konstanten.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der kombinierte Wert der angegebenen Felder als einzelne Zeichenfolge.
Zusätzliche Felder	joining_string (optional)

Tabelle : 1. Beispiel

Eingabe	Joining_string	Ergebnis
„Eingabe_1“, „Eingabe_2“, „Eingabe_3“	, „	„input_1, input_2, input_3“

In booleschen Wert konvertieren

Konvertiert den eingehenden Wert in einen booleschen Wert.

Details
Tabelle	RTE – Vorgang zum Konvertieren einer Entität in einen booleschen Wert [sys_rte_eb_to_boolean_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Die Ausgabe ist „ true “, wenn die Eingabe „ true“ oder „ 1“ ist, andernfalls ist die Ausgabe „ false“. (Groß-/Kleinschreibung beachten)

Tabelle : 2. Beispiel

Eingabe	Ergebnis
input_1	false
true	Wahr
1	Wahr
0	false
11	false

In Datum konvertieren

Versucht, den eingehenden Wert in einen GlideDateTime-Wert zu konvertieren, indem date_format auf den eingehenden Wert angewendet wird.

Details
Tabelle	RTE – Vorgang zum Konvertieren von Entitäten in Datum [sys_rte_eb_to_date_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Daten-Zeitstempelwert mit Datumsformat.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der Datums-/Zeitstempel im angegebenen Datumsformat. Versucht eine direkte Konvertierung mit GlideDateTime, wenn date_format falsch ist. Gibt einen leeren Wert zurück, wenn überhaupt keine Analyse möglich ist.

Tabelle : 3. Beispiel

Eingabe	Ergebnis
„2018/09/20 11:21:00 AM EST“ mit date_format „jjjj/MM/tt hh:mm:ss az“	„20.09.2018 16:21:00“
„2018/09/20 01:21:00 PM EST“ mit date_format „jjjj/MM/tt hh:mm:ss az“	„20.09.2018 18:21:00“
„09/20/18“ mit date_format „jjjj/MM/tt hh:mm:ss az“	„“0018-09-20 00:00:0“

In numerischen Wert konvertieren

Konvertiert den eingehenden Wert in eine Zahl.

Details
Tabelle	RTE – Vorgang zum Konvertieren einer Entität in einen numerischen Wert [sys_rte_eb_to_numeric_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Wert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist ein numerischer Wert. Wenn der Eingabewert nicht numerisch ist, ist die Ausgabe leer.

Tabelle : 4. Beispiel

Eingabe	Ergebnis
input_1	Null
1.23	1.23
1,00	1
zwei	Null

Kopieren

Kopiert den Wert des Quellfelds in alle Zielfelder.

Details
Tabelle	RTE – Entitätskopiervorgang [sys_rte_eb_copy_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Wert.
Ausgabefeld	target_sys_rte_eb_fields Ausgabe ist der kopierte Quellfeldwert.
Zusätzliches Feld	overwrite_existing_value (optional, Boolean): Bei „ true“ werden die Werte der Zielfelder ersetzt. Andernfalls wird ein nicht leerer Wert nicht überschrieben.

Ersten numerischen Wert extrahieren

Legt das Zielfeld als ersten numerischen Wert im Quellfeld fest.

Details
Tabelle	RTE – Numerischen Vorgang extrahieren [sys_rte_eb_extract_numeric_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Wert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der in der Eingabe gefundene numerische Wert.
Zusätzliche Felder	decimal_places (optional, Zahl): Erzwingt, dass die Ausgabe eine bestimmte Anzahl von Dezimalstellen enthält. remainder_target_field (optional, Verweis auf Feld): Nach dem Entfernen des ersten numerischen Werts auf den gekürzten Rest des Quellfelds setzen.

Tabelle : 5. Beispiel

Eingabe	Ergebnis
100 MB	100
100,123 MB	100,123
100,123 MB mit decimal_places= 2	100,12
100 MB mit decimal_places= 2	100,00
100 MB mit remainder_target_field	MB

Glide-Suchvorgang

Führt eine Suche in der Datenbank in der Zieltabelle durch, die im Feld target_table angegeben ist.

Details
Tabelle	RTE-Glide-Suchvorgang [sys_rte_eb_glide_lookup_operation]
Eingabefeld	source_sys_rte_eb_fields Die Datenbanktabelle für die Suche.
Ausgabefeld	target_sys_rte_eb_fields Die resultierenden Daten basierend auf dem Suchvorgang.
Zusätzliche Felder	target_table glide_matching_fields (string): Kommagetrennte Liste mit Spaltennamen in der Zieltabelle. Für jedes Eingabefeld in source_sys_rte_eb_fields muss die gleiche Anzahl von Werten in glide_matching_fields vorhanden sein. glide_target_fields (string): Kommagetrennte Liste mit Spaltennamen in der Zieltabelle. Für jedes Zielfeld in target_sys_rte_eb_fields muss die gleiche Anzahl von Werten in glide_target_fields vorhanden sein.

Tabelle : 6. Beispiel

Eingabe	Ergebnis
Eingabefeld 1: 100 South Charles Street, Baltimore Eingabefeld 2: MD Zieltabelle: Standort (cmn_location) Glide-Übereinstimmungsfelder: Straße, Status Glide-Zielfelder: sys_id	Ausgabefeld 1: 25ab9c4d0a0a0bb300f7dabdc0ca7c1c

Mehrfacheingabeskript

Führt ein Skript mit mehreren Eingaben aus und legt das Feld target_sys_rte_eb_field als Ausgabe für dieses Skript fest.

Details
Tabelle	RTE – Entitätsvorgang mit mehreren Eingabeskripts [sys_rte_eb_multi_in_script_operation]
Eingabefeld	source_sys_rte_eb_fields Eingabe ist ein Skript.
Ausgabefeld	target_sys_rte_eb_field Die Ausgabe ist das Ergebnis des Eingabeskripts.
Zusätzliche Felder	script (Skript) use_unique_input_sets(Boolean): Bei „ true“ werden nur eindeutige Eingabewerte in den Datenbatch für die IRE-Verarbeitung aufgenommen. Andernfalls werden alle Feldwerte des Eingabeobjekts eingeschlossen.

Beispiel für die Verwendung von use_unique_input_setsmit einer Skriptfunktion, die „record_type“ und „ operating_system “ als Eingabe verwendet und „record_with_os“ zurückgibt:

Tabelle : 7. Beispiele

Datensatz	record_type	operating_system
1	Computer	Windows XP
2	Computer	Linux
3	Computer	Windows XP

Wenn use_unique_inputs_sets auf truefestgelegt ist, verarbeitet das Skript nur zwei Werte (Computer + Windows XP und Computer + Linux). Wenn use_unique_inputs_sets auf falsefestgelegt ist, wird jeder der drei Werte einzeln verarbeitet (Computer + Windows XP, Computer + Linuxund Computer + Windows XP).

Beispielskript:

(function(batch, output) { 
                for (var i = 0; i < batch.length; i++) { 
                        // batch[i] is the unique set of inputs/individual record 
                        // batch[i].<field> gives access to the field value 
                        var in0 = gs.nil(batch[i].record_type) ? '' : batch[i].record_type;
                        var in1 = gs.nil(batch[i].operating_system) ? '' : batch[i].operating_system;
                        // output[i] is the output for the specific combination of inputs/individual record 
                        output[i] = in0 + "_" + in1; 
                    } 
                } 
            })(batch, output);

Mehrere Ein-/Ausgabeskripts

Führt ein Skript mit mehreren Eingaben aus und legt die im Feld target_sys_rte_eb_fields angegebenen Zielfelder als mehrere Ausgaben für dieses Skript fest.

Details
Tabelle	RTE – Entitätsvorgang mit mehreren Ein-/Ausgabeskripts [sys_rte_eb_multiple_input_output_script_operation]
Eingabefeld	source_sys_rte_eb_fields Eingabe ist ein Skript.
Ausgabefeld	target_sys_rte_eb_fields Die Ausgabe ist das Ergebnis des Eingabeskripts.
Zusätzliche Felder	script (Skript)

Beispielskript:

(function(batch, output) { 
                for (var i = 0; i < batch.length; i++) { 
                        var userId = (batch[i].user_id);
                        var userIdParts = userId.split(".");
                        output[i].first_name = userIdParts[0]; 
                        output[i].last_name = userIdParts[1];
                    } 
                } 
            })(batch, output);

Regulärer Ausdruck Ersetzen

Ersetzt jede Teilzeichenfolge der Eingabezeichenfolge, die dem im Feld [] angegebenen Muster des regulären Ausdrucks entspricht, durch die im Feld replacement_regex match_regex angegebene Zeichenfolge.

Details
Tabelle	RTE – Vorgang zum Ersetzen eines regulären Ausdrucks für Entität [sys_rte_eb_regex_replace_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist die ersetzte Zeichenfolge.
Zusätzliche Felder	match_regex (Zeichenfolge, regulärer Ausdruck) replacement_regex (Zeichenfolge)

Tabelle : 8. Beispiel

Eingabe	Ergebnis
"String&With(Special)$Characters" mit match_regex="[^0-9a-zA-Z]+" und ersatz_regex=" "	„Zeichenfolge mit Sonderzeichen“

Ersetzen

Ersetzt jede Teilzeichenfolge der Eingabezeichenfolge, die der im Feld match_string [] angegebenen Zeichenfolge entspricht, durch die im Feld replacement_string angegebene Zeichenfolge.

Details
Tabelle	RTE – Entitätsersetzungsvorgang [sys_rte_eb_replace_operation].
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist die ersetzte Zeichenfolge.
Zusätzliche Felder	match_string (Zeichenfolge) replacement_string (Zeichenfolge)

Tabelle : 9. Beispiel

Eingabe	Ergebnis
„Ursprüngliche Zeichenfolge“ mit match_string = „Original“ und ersatz_zeichenfolge = „Ersatz“	„Ersatzzeichenfolge“

Runder numerischer Wert

Rundet den eingegebenen numerischen Wert auf die nächste ganze Zahl. Nicht-Zahlen werden abgeschnitten.

Details
Tabelle	RTE – Rundungsvorgang für numerischen Wert für Entität [sys_rte_eb_around_numeric_operation]
Eingabefeld	source_sys_rte_eb_field Die Eingabe ist ein numerischer Wert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist eine ganze Zahl.
Zusätzliche Felder	match_string (Zeichenfolge) replacement_string (Zeichenfolge)

Tabelle : 10. Beispiel

Eingabe	Ergebnis
„1,5“	„2“
„1,4“	„1“
„ich bin eine Zeichenfolge“	„“

Skriptvorgang

Führt ein Skript mit einer Eingabe aus und legt das Feld target_sys_rte_eb_field als Ausgabe für dieses Skript fest.

Hinweis:

Der Skriptvorgangstyp wurde weitgehend durch den Mehrfacheingabe-Skriptvorgang ersetzt und ist aus Gründen der Abwärtskompatibilität mit den vorhandenen Konfigurationen enthalten.

Details
Tabelle	RTE – Entitätsskriptvorgang [sys_rte_eb_script_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Skript.
Ausgabefeld	target_sys_rte_eb_field Die Ausgabe ist das Ergebnis des Eingabeskripts.
Zusätzliche Felder	script(Skript) use_unique_input_sets (Boolean): Bei „ true“ werden nur eindeutige Eingabewerte in den Datenbatch für die IRE-Verarbeitung aufgenommen. Andernfalls werden alle Feldwerte des Eingabeobjekts eingeschlossen. Ein Beispiel und weitere Details finden Sie unter der Mehrfacheingabeskript-Transformation.

Das Quellfeld ist in der Variablen „batch“ als JavaScript-Feld „input“ enthalten.

(function(batch, output) { 
                for (var i = 0; i < batch.length; i++) { 
                        // batch[i] is the unique set of inputs/individual record 
                        // batch[i].input gives access to the field value 
                        var in0 = gs.nil(batch[i].input) ? '' : batch[i].input; 
                        // output[i] is the output for the specific combination of inputs/individual record 
                        output[i] = in0 + " modified by script"; 
                    } 
                } 
            })(batch, output); 

Beispiel:

/* Example Script
 (function(batch, output) {
     for (var i = 0; i < batch.length; i++) {
         //step1: access the input variables
         var a = batch[i].input; //Value of the source field.
 
         //step2: Your script/code goes here.
         var b = a + 1;
         //step3: set the output for each elements
         output[i] = b;
     }
 })(batch, output);
*/ 

Legen Sie fest

Legt den Feldwert target_sys_rte_eb_field auf die im Feld set_value ] angegebene Zeichenfolge fest.

Details
Tabelle	RTE – Vorgang zum Festlegen von Entitäten [sys_rte_eb_set_operation]
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der Wert, der dem Feld set_value zugeordnet ist.
Zusätzliche Felder	set_value (Zeichenfolge) overwrite_existing_value (optional, Boolean): Bei „wahr“ wird der aktuelle Wert des Zielfelds überschrieben. Andernfalls wird ein nicht leerer Wert nicht ersetzt.

Min/Max. festlegen

Legt das Zielfeld entweder auf das Maximum oder Minimum der Werte aus allen Eingabefeldern fest.

Details
Tabelle	RTE – Min/Max-Vorgang für Entität [sys_rte_eb_min_max_operation]
Eingabefeld	source_sys_rte_eb_fields Die Eingabe ist ein Satz von Werten.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der maximale oder minimale Wert basierend auf dem Wert min_max.
Zusätzliche Felder	data_type (Auswahlliste mit Werten wie STRING, NUMERIC und DATE) min_max (Auswahlliste mit Werten wie MIN und MAX)

Tabelle : 11. Beispiele

Eingabe	Ausgabe
„2“, „-1“, „0“	2
„a“, „b“	c
„2“, „-1“, „0“	-1
„a“, „b“	a

Aufteilen

Teilt die im Eingabewert source_sys_rte_eb_field enthaltene Zeichenfolge an dem im Feld splitting_string angegebenen Trennzeichen und weist das resultierende Array von Zeichenfolgen der Reihe nach dem Feld target_sys_rte_eb_field zu.

Details
Tabelle	RTE – Vorgang zur Entitätenteilung [sys_rte_eb_split_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_fields Ausgabe ist eine Liste von Teilzeichenfolgen.
Zusätzliche Felder	splitting_string (Zeichenfolge)

Tabelle : 12. Beispiel

Eingabe	Ergebnis
"value1||value2||value3", splitting_string:"||" mit target_sys_rte_eb_fields {target1,target2,target3}	Ziel1: Wert1, Ziel2: Wert2, Ziel3: Wert3
"value1||value2||value3", splitting_string:"||" mit target_sys_rte_eb_fields {target1}	target1 : value1
"value1", splitting_string:"||" mit target_sys_rte_eb_fields {target1,target2,target3}	Ziel1: Wert1, Ziel2:<null> , Ziel3:

Kürzen

Entfernt alle Leerzeichen am Anfang und am Ende der im Eingabewert source_sys_rte_eb_field enthaltenen Zeichenfolge und weist das Ergebnis dem Feld target_sys_rte_eb_field zu. Diese Transformation entspricht der Java String Trim()-Methode.

Details
Tabelle	RTE – Entitätskürzungsvorgang [sys_rte_eb_trim_operation].
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der Eingabezeichenfolgenwert, jedoch ohne führende und nachgestellte Leerzeichen.

Tabelle : 13. Beispiel

Eingabe	Ergebnis
„ Wert 1 “	„ Wert 1 “

Großbuchstaben

Ändert alle Zeichen des Eingabewerts source_sys_rte_eb_field in Großbuchstaben und weist das Ergebnis dem Feld target_sys_rte_eb_field zu.

Details
Tabelle	RTE – Großbuchstabenvorgang für Entität [sys_rte_eb_upper_case_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der Zeichenfolgenwert in Großbuchstaben.

Tabelle : 14. Beispiel

Eingabe	Ergebnis
„ Wert 1 “	„WERT1“

Großbuchstaben beschneiden

Kombiniert die Transformationen für Großbuchstaben und Kürzung.

Details
Tabelle	RTE – Kürzungsvorgang für Großbuchstaben für Entität [sys_rte_eb_upper_case_trim_operation]
Eingabefeld	source_sys_rte_eb_field Eingabe ist ein Zeichenfolgenwert.
Ausgabefeld	target_sys_rte_eb_field Ausgabe ist der Zeichenfolgenwert in Großbuchstaben ohne Leerzeichen am Anfang und Ende.

Tabelle : 15. Beispiel

Eingabe	Ergebnis
„Wert1“	„WERT1“