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

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 8 Minuten Lesedauer
  • Die RTE-Vorgangstypen (Robust Transform Engine) sind gängige Betriebsmethoden für die 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 in 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

    Die Ausgabe ist der kombinierte Wert der angegebenen Felder als eine einzelne Zeichenfolge.

    Zusätzliche Felder joining_string (optional)
    Tabelle : 1. Beispiel
    Eingabe „joining_string“ Ergebnis
    „Eingabe_1“, „Eingabe_2“, „Eingabe_3“ ", " Eingabe_1, Eingabe_2, Eingabe_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

    Die Eingabe ist ein Zeichenfolgenwert.

    Ausgabefeld target_sys_rte_eb_field

    Die Ausgabe ist wahr, wenn die Eingabe wahr oder 1ist, andernfalls ist die Ausgabe falsch. (Groß-/Kleinschreibung beachten)

    Tabelle : 2. Beispiel
    Eingabe Ergebnis
    Eingabe_1 falsch
    true wahr
    1 wahr
    0 falsch
    11 falsch

    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 einer Entität in ein Datum [sys_rte_eb_to_date_operation]
    Eingabefeld source_sys_rte_eb_field

    Die Eingabe ist ein Datenzeitstempelwert im 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 die Analyse überhaupt nicht 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“ "2018-09-20 16:21:00"
    „2018/09/20 01:21:00 PM EST“ mit date_format „jjjj/MM/tt hh:mm:ss az“ „2018-09-20 18:21:00“
    „20.09.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

    Die Ausgabe ist ein numerischer Wert. Wenn der Eingabewert nicht numerisch ist, ist die Ausgabe leer.

    Tabelle : 4. Beispiel
    Eingabe Ergebnis
    Eingabe_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, boolesch): Bei „ wahr“ 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 eine bestimmte Anzahl von Dezimalstellen in der Ausgabe.
    • remainder_target_field (optional, Verweis auf Feld): Auf den gekürzten Rest des Quellfelds festlegen, nachdem der erste numerische Wert entfernt wurde.
    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

    Sucht in der Datenbank anhand der Zieltabelle, 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 (Zeichenfolge): Kommagetrennte Liste von 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 (Zeichenfolge): Kommagetrennte Liste von 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, Washington
    • Eingabefeld 2: MD
    • Zieltabelle: Standort (cmn_location)
    • Glide-Übereinstimmungsfelder: Straße, Bundesland/Kanton
    • 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“ sind für die IRE-Verarbeitung nur eindeutige Eingabewerte im Daten-Batch enthalten. Andernfalls werden alle Feldwerte des Eingabeobjekts eingeschlossen.

    Beispiel für die Verwendung von use_unique_input_setsmit einer Skriptfunktion, die record_type und operational_system als Eingabe akzeptiert und record_with_oszurü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, die die im Feld target_sys_rte_eb_fields angegebenen Zielfelder als mehrere Ausgaben für dieses Skript festlegen.

    Details
    Tabelle RTE – Entitätsvorgang mit mehreren Eingabe-/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);

    Ersetzen Sie den regulären Ausdruck

    Ersetzt jede Teilzeichenfolge der Eingabezeichenfolge, die dem im Feld [] angegebenen Muster für den regulären Ausdruck entspricht, durch die im Feld replacement_regex match_regex angegebene Zeichenfolge.

    Details
    Tabelle RTE – Vorgang zum Ersetzen eines regulären Ausdrucks [sys_rte_eb_regex_replace_operation]
    Eingabefeld source_sys_rte_eb_field

    Die 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
    „Zeichenfolge&Mit(Sonder)$Zeichen“ mit übereinstimmendem_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 – Vorgang zum Ersetzen einer Entität [sys_rte_eb_replace_operation]
    Eingabefeld source_sys_rte_eb_field

    Die 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 „replacement_string“ = „Ersatz“ „Ersatzzeichenfolge“

    Runder numerischer Wert

    Rundet den eingegebenen numerischen Wert auf die nächste ganze Zahl ab. Nicht-Nummern werden gekürzt.

    Details
    Tabelle RTE – Rundungsvorgang für numerischen Wert einer Entität [sys_rte_eb_runde_numerische_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“ sind für die IRE-Verarbeitung nur eindeutige Eingabewerte im Daten-Batch enthalten. Andernfalls werden alle Feldwerte des Eingabeobjekts eingeschlossen. Ein Beispiel und weitere Einzelheiten finden Sie unter Skript-Transformation mit mehreren Eingaben.
    Das Quellfeld ist in der Variablen „Batch“ als „Eingabe“ des JavaScript-Felds 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);
    */ 

    festlegen

    Legt den Wert des Felds target_sys_rte_eb_field auf die im Feld set_value ] angegebene Zeichenfolge fest.

    Details
    Tabelle RTE – Entitätssatzvorgang [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, boolesch) : 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 den Höchst- oder Mindestwert der Werte aus allen Eingabefeldern fest.

    Details
    Tabelle RTE – Min/Max-Vorgang [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 Höchst- oder Mindestwert basierend auf dem Wert min_max.

    Zusätzliche Felder
    • data_type (Auswahlliste mit Werten als STRING, NUMERIC und DATE)
    • min_max (Auswahlliste mit Werten als MIN und MAX)
    Tabelle : 11. Beispiele
    Eingabe Ausgabe
    "2", "-1", "0" 2
    „a“, „b“ c
    „2“, „-1“, „0“ -1
    „a“, „b“ a

    Teilen

    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 dem Feld target_sys_rte_eb_field der Reihe nach zu.

    Details
    Tabelle RTE – Vorgang zur Entitätenteilung [sys_rte_eb_split_operation]
    Eingabefeld source_sys_rte_eb_field

    Die 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
    "Wert1||Wert2||Wert3", Splitting_String:"||" mit target_sys_rte_eb_fields {target1,target2,target3} Ziel1: Wert1, Ziel2: Wert2, Ziel3: Wert3
    "Wert1||Wert2||Wert3", 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> , target3 :

    Kürzen

    Entfernt alle Leerzeichen am Anfang und am Ende der Zeichenfolge, die im Eingabewert source_sys_rte_eb_field enthalten ist, und weist das Ergebnis dem Feld target_sys_rte_eb_field zu. Diese Transformation entspricht der Java String-Methode „trim()“.

    Details
    Tabelle RTE – Entitätskürzungsvorgang [sys_rte_eb_trim_operation].
    Eingabefeld source_sys_rte_eb_field

    Die Eingabe ist ein Zeichenfolgenwert.

    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Eingabezeichenfolgenwert, jedoch ohne führende und nachfolgende 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

    Die 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ürzen.

    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

    Die 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“