RTE transformiert Vorlagenskripts, die in enthalten sind Gemeinsame Komponenten für CMDB-Integrationen App

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

    • Die Transformationen der robusten Transformations-Engine (RTE) sind Vorlagenvorgänge, die in enthalten sind Gemeinsame Komponenten für CMDB-Integrationen Store-App (sn_cmdb_int_util).

    Die folgenden skriptbasierten RTE-Transformationen sind in verfügbar Gemeinsame Komponenten für CMDB-Integrationen App.

    CI-Suchvorgang

    Verwenden Sie , um den Wert eines Felds für ein vorhandenes Konfigurationselement (CI) in der CMDB anhand des nativen Quellschlüssels abzurufen.

    Details
    Tabelle CI-Suchvorgang der robusten Transformations-Engine [sn_cmdb_int_util_ci_Lookup_Operation]
    Eingabefeld source_sys_rte_eb_field
    Eingabe in Reihenfolge:
    1. Discovery-Quelle
    2. Nativer Schlüssel der Quelle
    3. CI-Feld

    Der Vorgang fragt die Tabelle „Quelle“ [sys_object_Source] für die Discovery-Quelle und den zugehörigen nativen Quellschlüssel ab und gibt dann den CI-Feldwert des übereinstimmenden Datensatzes in der Zieltabelle und die zugehörige Ziel-SYS-ID zurück.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Wert des Feldnamens im CI, der mit der Suche des nativen Quellschlüssels übereinstimmt, oder eine leere Zeichenfolge, wenn keine Übereinstimmung vorhanden ist.

    Die Tabelle „Quelle“ [sys_object_Source] wird mithilfe der Discovery-Quelle und des nativen Quellschlüssels nach dem letzten Scan abgefragt. Die Tabelle iteriert durch die Ergebnisse der Abfrage und fragt die Zieltabelle nach der Ziel-SYS-ID ab, bis ein gültiges CI gefunden wird. Nachdem ein gültiges CI gefunden wurde, gibt der Vorgang den Wert des CI-Felds für das übereinstimmende CI zurück.

    Tabelle : 1. Beispiel
    Discovery-Quelle Nativer Schlüssel der Quelle CI-Feld Ergebnis
    ServiceNow ServiceNow|||COMPUTERNAME|||Computer-01 name Computer-01

    Unternehmen bereinigen

    Verwenden Sie , um den Namen des Hardware-Herstellers zu bereinigen und den Datensatz der Tabelle „Unternehmen“ [Core_Company] hinzuzufügen, um eine Referenz auszufüllen, wenn der Hersteller nicht mit einem Modell oder einer Software (cpu_manufacturer) verknüpft ist.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Unternehmen bereinigen“ [sn_cmdb_int_util_Cleanse_Company_Operation]
    Eingabefeld source_sys_rte_eb_field

    Eingabe ist ein Unternehmens-/Herstellername.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_ID und der Name des Unternehmens in Core_Company, verkettet durch eine Triple-Pipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseCompany(input)

    Wenn kein übereinstimmender Datensatz vorhanden ist, wird in Core_Company ein neuer Datensatz erstellt, sodass die Rückgabe immer eine sys_ID und einen Namen enthält (es sei denn, die Eingabe ist leer oder ungültig). Der Name wird bereinigt, und eine Fuzzy-Suche wird über die Skripteinbindung CmdbIntegrationCompanyModelUtil durchgeführt, bevor die MakeAndModelJS-Plattform-API aufgerufen wird.

    Tabelle : 2. Beispiel
    Eingabe Ergebnis
    SERVICENOW 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow

    Hardwaremodell bereinigen

    Verwenden Sie , um ein Hardwaremodell zu erstellen, zu bereinigen oder zu suchen, um eine Referenz (model_ID) zu erstellen.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Hardwaremodell bereinigen“ [sn_cmdb_int_util_Cleanse_Hardware_model_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Herstellername
    2. Der Modellname

    Wenn einer der Werte von sich selbst bereitgestellt wird, verarbeitet der Vorgang nur das gefundene Element.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_ID und der Name des Unternehmens in Core_Company sowie sys_ID und Name des Modells in cmdb_model – alle verkettet durch eine Triple-Pipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Wenn für den Hersteller oder das Modell kein übereinstimmender Datensatz vorhanden ist, wird ein neuer Datensatz erstellt, sodass die Rückgabe immer sys_IDs und Namen für beide Datensätze enthält (es sei denn, die Eingabe ist leer oder ungültig).

    Der Herstellername wird wie die Transformation „Unternehmen bereinigen“ und verarbeitet Dann Herstellername und Modellname Werden an die MakeAndModelJS-Plattform-API gesendet.

    Tabelle : 3. Beispiel
    Herstellername Modellname Ergebnis
    ServiceNow Incorporated SERVICENOW 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb30371020004e0bfc8bcbe5d6d |||ServiceNow

    Hardwaremodell mit Modellnummer bereinigen

    Verwenden Sie , um ein Hardwaremodell zu erstellen, zu bereinigen oder zu suchen, um eine Referenz (model_ID) zu erstellen.

    Details
    Tabelle Entität der robusten Transformations-Engine – Hardwaremodell mit Modellnummernbetrieb bereinigen [sn_cmdb_int_util_cleanse_Hardware_model_number_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Herstellername
    2. Der Modellname
    3. Die Modellnummer
    4. CI-Klasse
      Hinweis:
      Die CI-Klasse Das Feld ist ein optionales Eingabefeld, und wenn enthalten, das MakeAndModelJS Die Plattform-API ruft den Modelldatensatz ab, indem die Produktmodellklasse aus der Tabelle „Modellkategorie“ [cmdb_model_category] abgefragt wird. Andernfalls ruft die API den Modelldatensatz nur aus der Tabelle „Hardwaremodelle“ [cmdb_Hardware_Product_model] ab.

    Wenn einer der Werte von sich selbst bereitgestellt wird, verarbeitet der Vorgang nur das gefundene Element.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_ID und der Name des Unternehmens in Core_Company sowie sys_ID und Name des Modells in cmdb_model – alle verkettet durch eine Triple-Pipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Wenn für den Hersteller oder das Modell kein übereinstimmender Datensatz vorhanden ist, wird ein neuer Datensatz erstellt, sodass die Rückgabe immer sys_IDs und Namen für beide Datensätze enthält (es sei denn, die Eingabe ist leer oder ungültig).

    Der Herstellername wird wie die Transformation „Unternehmen bereinigen“ verarbeitet, und dann werden der Herstellername, der Modellname und die Modellnummer an gesendet MakeAndModelJS Plattform-API.

    Tabelle : 4. Beispiel
    Herstellername Modellname Modellnummer Ergebnis
    ServiceNow Incorporated SERVICENOW BC0AA8000C56 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb30371020004e0bfc8bcbe5d6d |||ServiceNow

    IP-Adresse bereinigen

    Verwenden Sie diese Option, wenn ein Feld eine IP-Adresse bereitstellt.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „IP bereinigen“ [sn_cmdb_int_util_cleanse_ip_Operation]
    Eingabefelder source_sys_rte_eb_field

    Eingabe ist die zu bereinigende IP-Adresse.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende IP-Adresse, die leer sein kann.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseIpAddress(input)

    Die IP-Adresse wird sowohl auf IPv4- als auch auf IPv6-Strukturen zusammen mit einigen bekannten Ableitungen (ein IPv4 mit Leerzeichen anstelle von Zeiträumen) getestet. Wenn ein Ergebnis gefunden wird, wird es formatiert und zurückgegeben.

    Tabelle : 5. Beispiele
    IP Ip-Ergebnisse
    192.160.89.1 192.160.89.1
    192.160.89.1,54.21.12.311 192.160.89.1
    192 160 89 1 54 21 12 311 192.160.89.1
    192-160-89-1 192.160.89.1
    2001:0db8:0000:0000:0000:ff00:0042:8329 2001:0db8:0000:0000:0000:ff00:0042:8329
    Junk
    175912537 10.124.54.89
    -1
    0

    IP-Version bereinigen

    Verwenden Sie diese Option, wenn die Datenquelle keine IP-Version bereitstellt oder wenn die IP-Version möglicherweise unzuverlässig ist.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „IP-Version bereinigen“ [sn_cmdb_int_util_Cleanse_ip_Version_Operation]
    Eingabefelder source_sys_rte_eb_field

    Eingabe ist die zu bereinigende IP-Adresse.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Suchschlüssel cmdb_ci_ip_address.ip_Version (entweder 4, 6 oder leer).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationNetworkUtil().deriveIpVersion(input)

    Der Wert der Eingabe-IP-Adresse wird entweder auf die richtige IPv4- oder IPv6-Struktur überprüft, andernfalls ist die Rückgabe leer. Diese Funktion bietet keine IP-Bereinigung.

    Tabelle : 6. Beispiel
    Eingabe Ergebnis
    192.160.89.1 4

    MAC-Adresse bereinigen

    Verwenden Sie diese Option, wenn ein Feld eine MAC-Adresse bereitstellt.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „MAC bereinigen“ [sn_cmdb_int_util_cleanse_mac_Operation]
    Eingabefelder source_sys_rte_eb_field

    Eingabe ist die zu bereinigende MAC-Adresse.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende MAC-Adresse, die leer sein kann.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseMacAddress(input)

    Die MAC-Adresse wird zusammen mit einigen bekannten Ableitungen auf die richtige Struktur getestet (z. B. eine MAC-Adresse mit Leerzeichen anstelle von Doppelpunkten). Wenn ein Ergebnis gefunden wird, wird es formatiert und zurückgegeben.

    Tabelle : 7. Beispiel
    Eingabe Ergebnis
    00 0A 95 9D 68 16 00:0a:95:9d:68:16

    Betriebssystem bereinigen

    Verwenden Sie , um einen Betriebssystemnamen zu extrahieren, zu bereinigen und zu formatieren, wenn die Quelle einen Betriebssystemwert bereitstellt.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „BS bereinigen“ [sn_cmdb_int_util_cleanse_os_Operation]
    Eingabefelder source_sys_rte_eb_field

    Eingabe ist der zu bereinigende Betriebssystemname.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Betriebssystemname. Der resultierende Betriebssystemname wird auch in das Listenfeld cmdb_ci_Computer.os geschrieben.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationOsUtil().cleanseAndInsertOs(input)

    Der Großteil der aktuellen Bereinigung konzentriert sich auf Microsoft-Betriebssystemwerte, abgesehen von allgemeinen Bereinigungen, z. B. Beheben der Gehäuseunterdrückung.

    Tabelle : 8. Beispiele
    Betriebssystem Betriebssystemergebnisse
    Windows Server 2003 R2 64-Bit-Edition Service Pack 2 Windows Server 2003 R2
    Windows 2003 Windows 2003
    Windows Vista 64-Bit-Edition Windows Vista
    Windows 2000 Professional Service Pack 4 Windows 2000 Professional
    Windows XP Service Pack 2-3 Windows XP
    Microsoft Windows Server 2003 R2 64-Bit-Edition Service Pack 2 Windows Server 2003 R2
    Microsoft Windows 2003 Windows 2003
    Microsoft Windows Vista 64-Bit-Edition Windows Vista
    Microsoft Windows 2000 Professional Service Pack 4 Windows 2000 Professional
    Microsoft Windows XP Service Pack 2-3 Windows XP
    linux-ubuntu Linux-Ubuntu
    Linux Ubuntu-Server Linux Ubuntu-Server

    Seriennummer bereinigen

    Verwenden Sie , um ungültige Seriennummern zu bereinigen und zu entfernen.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Seriennummer bereinigen“ [sn_cmdb_int_util_Cleanse_Serial_number_Operation]
    Eingabefelder source_sys_rte_eb_fields

    Eingabe ist die zu bereinigende Seriennummer.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende Seriennummer.
    Tabelle : 9. Beispiele
    Seriennummer Seriennummernergebnisse
    Ec2a2da-5312-aa3e-804c-c35feabeda5f Ec2a2da-5312-aa3e-804c-c35feabeda5f
    1045–1209–6738–4668–7696–2783 1045–1209–6738–4668–7696–2783

    Seriennummer mit Rückgabe eines alternativen Werts bereinigen, falls ungültig

    Verwenden Sie , um die Seriennummer zu bereinigen und die Länge der bereinigten Seriennummer zu überprüfen. Gibt den alternativen Wert zurück, wenn die Länge der Seriennummer ungültig ist.

    Details
    Tabelle Entität Der Robusten Transformations-Engine – Seriennummer Mit Alternative Bereinigen Wertrückgabe

    [sn_cmdb_int_util_cle$anse_Serial_number_with_Alternate_value_return_if_invalid]
    Eingabefelder source_sys_rte_eb_fields

    Eingaben: Seriennummer, alternativer Wert
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe: Bereinigte Seriennummer, wenn die Länge gültig ist, andernfalls alternativer Wert.
    Skripteinbindungsfunktion global.SerialNumberManager().isValid(input)

    Der Vorgang bereinigt die Seriennummer und überprüft, ob die Länge der bereinigten Seriennummer größer oder gleich dem in angegebenen Wert ist sn_cmdb_int_util.minimum_valid_serial_number_lengthSystemeigenschaft. Der Standardwert der Eigenschaft ist auf festgelegt 7 .

    IMEI-Nummer mit Rückgabe eines alternativen Werts bereinigen, falls ungültig

    Verwenden Sie , um die IMEI-Nummer zu bereinigen und die Länge der bereinigten IMEI-Nummer zu überprüfen. Gibt den alternativen Wert zurück, wenn die Länge der IMEI-Nummer ungültig ist.

    Details
    Tabelle Entität der robusten Transformations-Engine – IMEI bereinigen Mit alternativem Wert zurückgeben, wenn bewertet

    [sn_cmdb_int_util_Cleanse_imei_with_Alternate_value_return_if_invalid]
    Eingabefelder source_sys_rte_eb_fields

    Eingaben: IMEI-Nummer, alternativer Wert
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe: IMEI-Nummer, wenn die Länge gültig ist, andernfalls alternativer Wert.
    Skripteinbindungsfunktion Keine

    Der Vorgang bereinigt die IMEI-Nummer und überprüft, ob die Länge der bereinigten IMEI-Nummer dem in angegebenen Wert entspricht sn_cmdb_int_util.valid_imei_number_lengthSystemeigenschaft. Der Standardwert der Eigenschaft ist auf festgelegt 15 .

    Softwaremodell bereinigen

    Verwenden Sie , um ein Softwaremodell zu bereinigen und zu erstellen. Außerdem, um Hersteller und Softwaremodell zu erstellen, wenn sie nicht vorhanden sind, und mit einem Aufteilungsvorgang zu folgen.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Softwaremodell bereinigen“ [sn_cmdb_int_util_Cleanse_Software_model_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Herstellername
    2. Der Software-Name
    3. Die Softwareversion (nicht erforderlich)

    Wenn nur Hersteller oder Name angegeben wird, werden nur diese Werte verarbeitet und zurückgegeben.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_ID und der Name des Unternehmens in Core_Company, der Name der bereinigten Software und die bereinigte Softwareversion, die alle von einer Dreifach-Pipe verkettet sind (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().cleanseSoftwareModel(company, model, version)

    Wenn kein übereinstimmender Herstellerdatensatz vorhanden ist, wird ein neuer Datensatz erstellt, sodass die Rückgabe immer die sys_ID und den Namen für den Hersteller enthält (wenn der Hersteller nicht leer oder ungültig ist).

    Der Herstellername wird genauso verarbeitet wie in der Transformation „Unternehmen bereinigen“, und dann wird der Herstellername an die MakeAndModelJS-Plattform-API gesendet.

    Der Softwarename und die Version werden bereinigt, formatiert und zurückgegeben. Die Version wird aus dem Softwarequenamen entfernt, falls vorhanden.

    Tabelle : 10. Beispiele
    Hersteller Software-Name Softwareversion Ergebnisse
    Dell Inc.
    Kein Hersteller
    1.0.0.0
    Dell Inc. DataEngine 1.0.17.2 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    GenuineIntel Testsoftware 1.0.0.1 7aad6d00c611228400f00e0f80b67d2d|||Intel|||TestSoftware||||1.0.0.1
    Dell Inc. Testsoftware 232 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||232
    Dell Inc. Testsoftware 123.0.0.0 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||123,0
    Amerika Online Testsoftware 1.0.0.0 0c43d035c61122750000251553f6f8e8|||Amerika Online|||TestSoftware||||1,0
    Amerika Online Testsoftware 1.0.0.0 0c43d035c61122750000251553f6f8e8|||Amerika Online|||TestSoftware||||1,0
    dell Kleinbuchstaben 1.0.0.0 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Kleinbuchstaben|||1,0

    Dell Corporation.

    Incorporated, Corp

    		 Testsoftware 1.0.0.0 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||1,0
    Microsoft

    Microsoft SQL

    Server 2016 Enterprise

    		 2.0.0 0e8b8e650a0a0b3b004f285ffb1a4fc|||Microsoft|||Microsoft SQL Server 2016 Enterprise|||2,0
    Dell-Computer DataEngine 1.0.17.2 B7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    Adobe Testsoftware 1 B7e8b5c4c0a80169008b49e468920048|||Adobe Systems||||TestSoftware|||1,0

    Software-Instanznamen erstellen

    Verwenden Sie diese Option, wenn ein Hardware-Name, ein Software-Name und eine Softwareversion angegeben werden, um einen neuen Softwareinstanznamen zu erstellen.
    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Softwareinstanznamen erstellen“ [sn_cmdb_int_util_create_Software_instance_Name_Operation]
    Eingabefelder source_sys_rte_eb_fields

    Eingabe in Reihenfolge:

    1. Der Hardware-Name
    2. Der Software-Name
    3. Die Softwareversion (nicht erforderlich)
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Name der Softwareinstanz.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().createSoftwareInstanceName(hw_name_in, sw_name_in, sw_version_in)
    Tabelle : 11. Beispiele
    Hardware-Name Software-Name Softwareversion Ergebnisse
    computer1 Microsoft 2.0.1 microsoft 2,0.1-computer1
    computer2 Adobe adobe-Computer2
    computer3 Adobe 2.1 adobe 2,1-Computer3
    hw2 sw3 301 sw3 301-hw2

    CI-Klasse von Modell ableiten

    Verwenden Sie diese Option, wenn Sie einen Computerdatensatz verarbeiten und ein Modell bereitgestellt wird, die Klasse des Computers jedoch nicht eindeutig ist. Kann zusammen mit anderen Transformationen für die Ableitung von CI-Klassen verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse aus Modell ableiten“ [sn_cmdb_int_util_derive_class_from_model_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Modellname
    2. Der aktuelle Klassenname
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Klassenname.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromModelInput(model_in, class_in)

    Gibt keinen Wert einer Klasse zurück, die in der Klassenhierarchie (einer übergeordneten Klasse) höher ist als die angegebene Eingabeklasse. Beispiel: Gibt cmdb_ci_Computer nicht zurück, wenn die Eingabe cmdb_ci_Server ist. Betrachtet nur die Hierarchie „cmdb_ci_Computer“, die cmdb_ci_Server durchläuft (cmdb_ci_Computer, cmdb_ci_Server, untergeordnete Elemente von „cmdb_ci_Server“).

    Sucht derzeit nach Indikatoren „Server“, „Windows Server“ und „Linux Server“ im Modell.

    Tabelle : 12. Beispiele
    Modell Klasse Klassenergebnisse
    Fensterserver cmdb_ci_computer cmdb_ci_win_server
    Microsoft-Server cmdb_ci_computer cmdb_ci_win_server
    linux-Server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft-Server cmdb_ci_server cmdb_ci_win_server
    linux-Server cmdb_ci_server cmdb_ci_linux_server
    Red hat-Server cmdb_ci_server cmdb_ci_linux_server
    Arch-Server cmdb_ci_server cmdb_ci_linux_server
    CentOS-Server cmdb_ci_server cmdb_ci_linux_server
    Debian-Server cmdb_ci_server cmdb_ci_linux_server
    Fedora-Server cmdb_ci_server cmdb_ci_linux_server
    SUSE-Server cmdb_ci_server cmdb_ci_linux_server
    Oracle-Server cmdb_ci_server cmdb_ci_linux_server
    RHEL-Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu-Server cmdb_ci_server cmdb_ci_linux_server
    Junk
    cmdb_ci_server cmdb_ci_server
    Junk-Server cmdb_ci_computer cmdb_ci_server
    Junk cmdb_ci_computer cmdb_ci_computer

    CI-Klasse von nativem Klassenbezeichner ableiten

    Verwenden Sie diese Option, wenn ein Computerdatensatz verarbeitet wird und ein nativer Klassenindikator angegeben wird, die Klasse des Computers jedoch nicht eindeutig ist. Kann zusammen mit anderen Transformationen für die Ableitung von CI-Klassen verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse von nativem Wert ableiten“ [sn_cmdb_int_util_derive_class_from_native_value_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der native Klassenbezeichner
    2. Der aktuelle Klassenname
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Klassenname.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromNativeValue(native_id_in, class_in)

    Gibt keinen Wert einer Klasse zurück, die in der Klassenhierarchie (einer übergeordneten Klasse) höher ist als die angegebene Eingabeklasse. Beispiel: Gibt cmdb_ci_Computer nicht zurück, wenn die Eingabe cmdb_ci_Server ist. Betrachtet nur die Hierarchie „cmdb_ci_Computer“, die cmdb_ci_Server durchläuft (cmdb_ci_Computer, cmdb_ci_Server, untergeordnete Elemente von „cmdb_ci_Server“).

    Sucht derzeit im nativen Bezeichner nach Indikatoren „Server“, „Windows Server“ und „Linux Server“.

    Tabelle : 13. Beispiele
    Native Klasse Klasse Klassenergebnisse
    Fensterserver cmdb_ci_computer cmdb_ci_win_server
    Microsoft-Server cmdb_ci_computer cmdb_ci_win_server
    linux-Server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft-Server cmdb_ci_server cmdb_ci_win_server
    linux-Server cmdb_ci_server cmdb_ci_linux_server
    Red hat-Server cmdb_ci_server cmdb_ci_linux_server
    Arch-Server cmdb_ci_server cmdb_ci_linux_server
    CentOS-Server cmdb_ci_server cmdb_ci_linux_server
    Debian-Server cmdb_ci_server cmdb_ci_linux_server
    Fedora-Server cmdb_ci_server cmdb_ci_linux_server
    SUSE-Server cmdb_ci_server cmdb_ci_linux_server
    Oracle-Server cmdb_ci_server cmdb_ci_linux_server
    RHEL-Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu-Server cmdb_ci_server cmdb_ci_linux_server
    Junk
    cmdb_ci_server cmdb_ci_server
    Junk-Server cmdb_ci_computer cmdb_ci_server
    Junk cmdb_ci_computer cmdb_ci_computer

    CI-Klasse von Betriebssystem ableiten

    Verwenden Sie diese Option, wenn Sie einen Computerdatensatz verarbeiten und ein Betriebssystem bereitgestellt wird, die Klasse des Computers jedoch nicht eindeutig ist. Kann zusammen mit anderen Transformationen für die Ableitung von CI-Klassen verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse aus BS ableiten“ [sn_cmdb_int_util_derive_class_from_os_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Betriebssystemname
    2. Der aktuelle Klassenname
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Klassenname.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromOsName(os_in, class_in)

    Gibt keinen Wert einer Klasse zurück, die in der Klassenhierarchie (einer übergeordneten Klasse) höher ist als die angegebene Eingabeklasse. Beispiel: Gibt cmdb_ci_Computer nicht zurück, wenn die Eingabe cmdb_ci_Server ist. Betrachtet nur die Hierarchie „cmdb_ci_Computer“, die cmdb_ci_Server durchläuft (cmdb_ci_Computer, cmdb_ci_Server, untergeordnete Elemente von „cmdb_ci_Server“).

    Sucht derzeit im Betriebssystemnamen nach Indikatoren „Server“, „Windows Server“ und „Linux Server“.

    Tabelle : 14. Beispiele
    Betriebssystem Klasse Klassenergebnisse
    Fensterserver cmdb_ci_computer cmdb_ci_win_server
    Microsoft-Server cmdb_ci_computer cmdb_ci_win_server
    linux-Server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft-Server cmdb_ci_server cmdb_ci_win_server
    linux-Server cmdb_ci_server cmdb_ci_linux_server
    Red hat-Server cmdb_ci_server cmdb_ci_linux_server
    Arch-Server cmdb_ci_server cmdb_ci_linux_server
    CentOS-Server cmdb_ci_server cmdb_ci_linux_server
    Debian-Server cmdb_ci_server cmdb_ci_linux_server
    Fedora-Server cmdb_ci_server cmdb_ci_linux_server
    SUSE-Server cmdb_ci_server cmdb_ci_linux_server
    Oracle-Server cmdb_ci_server cmdb_ci_linux_server
    RHEL-Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu-Server cmdb_ci_server cmdb_ci_linux_server
    Junk
    cmdb_ci_server cmdb_ci_server
    Junk-Server cmdb_ci_computer cmdb_ci_server
    Junk cmdb_ci_computer cmdb_ci_computer

    Virtuell von Hardwaremodell ableiten

    Verwenden Sie diese Option, wenn Sie einen Computerdatensatz verarbeiten, der virtuell sein kann, ein Hardwaremodell bereitgestellt wird und der virtuelle Status mehrdeutig ist. Kann zusammen mit anderen Transformationen „Virtuell aus Transformationen ableiten“ verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Virtuell aus Modell ableiten“ [sn_cmdb_int_util_derive_Virtual_from_model_Operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der Name des Hardwaremodells
    2. Der aktuelle virtuelle Kennzeichnungswert
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende virtuelle Kennzeichnung (wahr/falsch). Wenn die aktuelle virtuelle Kennzeichnung „wahr“ ist, ist das Ergebnis „wahr“. Andernfalls ist das Ergebnis „wahr“ oder „falsch“.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromModelName(model_in, is_virtual_in)

    Sucht nach Indikatoren im Modellnamen für ein virtuelles Gerät (VMware).

    Tabelle : 15. Beispiele
    Hardware-Modell Kennzeichnung Für „Virtuell“ Ergebnisse Der Virtuellen Kennzeichnung
    thinkpad wahr wahr
    thinkpad falsch falsch
    thinkpad falsch
    vmware Inc wahr true
    true true
    „false“ eingestellt ist „false“ eingestellt ist
    falsch

    Virtuell von nativem Indikator ableiten

    Verwenden Sie bei der Verarbeitung eines Computerdatensatzes, der virtuell sein kann, einen virtuellen Indikator von der Quelle bereitgestellt, und der virtuelle Status ist mehrdeutig. Kann zusammen mit anderen Transformationen „Virtuell aus Transformationen ableiten“ verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_Virtual_from_native_value_Operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Der native Indikator
    2. Der aktuelle virtuelle Kennzeichnungswert
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende virtuelle Kennzeichnung (wahr/falsch). Wenn die aktuelle virtuelle Kennzeichnung „wahr“ ist, ist das Ergebnis „wahr“. Andernfalls ist das Ergebnis „wahr“ oder „falsch“.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromNativeIdentifier(native_in, is_virtual_in)

    Testet den nativen Indikator anhand einer Liste allgemeiner Werte und sucht nach einem booleschen Indikator „wahr“.

    Tabelle : 16. Beispiele
    Nativer Virtueller Wert Kennzeichnung Für „Virtuell“ Ergebnisse Der Virtuellen Kennzeichnung
    virtual falsch wahr
    virtual wahr
    virtual wahr wahr
    y falsch wahr
    y wahr
    y wahr wahr
    Ja falsch wahr
    Ja wahr
    Ja wahr true
    true falsch true
    true true
    true true wahr
    t falsch wahr
    t wahr
    t wahr wahr
    Sonstige falsch falsch
    Sonstige falsch
    Sonstige wahr wahr
    Nicht virtuell falsch falsch
    Nicht virtuell falsch
    Nicht virtuell wahr true
    „false“ eingestellt ist „false“ eingestellt ist
    „false“ eingestellt ist
    true wahr

    Virtuell von Seriennummer ableiten

    Verwenden Sie bei der Verarbeitung eines Computerdatensatzes, der virtuell sein kann, eine Seriennummer wird von der Quelle bereitgestellt, und der virtuelle Status ist mehrdeutig. Kann zusammen mit anderen Transformationen „Virtuell aus Transformationen ableiten“ verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_Virtual_from_Serial_number_Operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge:
    1. Die Seriennummer
    2. Der aktuelle virtuelle Kennzeichnungswert
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende virtuelle Kennzeichnung (wahr/falsch). Wenn die aktuelle virtuelle Kennzeichnung „wahr“ ist, ist das Ergebnis „wahr“. Andernfalls ist das Ergebnis „wahr“ oder „falsch“.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromSerialNumber (serial_in, is_virtual_in)

    Sucht nach Indikatoren in der Seriennummer für ein virtuelles Gerät (VMware).

    Tabelle : 17. Beispiele
    Seriennummer Kennzeichnung Für „Virtuell“ Ergebnisse Der Virtuellen Kennzeichnung
    123 wahr wahr
    123 falsch falsch
    123 falsch
    vmware-123 wahr true
    true true
    „false“ eingestellt ist „false“ eingestellt ist
    falsch

    Extrahieren und nach Einheiten skalieren

    Verwenden Sie diese Option, wenn die Quelle numerische Werte hat, die skaliert werden müssen, und numerische Werte mit einer Eingabe wie 2048 MB. Die Quelle stellt nicht immer die Einheiten bereit, daher kann es erforderlich sein, die bereitgestellten Einheiten zu berechnen oder zu erraten. Die Zieleinheiten hängen vom Zielfeld in der CMDB ab. Wenn nicht angegeben, ist das Feld Dezimalstelle standardmäßig auf 2 festgelegt.

    Hinweis:
    Bei diesem Feld wird die Groß-/Kleinschreibung beachtet.
    Details
    Tabelle sn_cmdb_int_util_Extract_and_scale_by_units_Operation
    Eingabefelder source_sys_rte_eb_fields
    Ausgabefeld target_sys_rte_eb_field
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationExtractScaleUnitUtil().extractAndScaleUnits(input,defaultUnit,outputUnit,decimalPlaces)
    Tabelle : 18. Beispiele
    Eingabewert Standardeinheit Ausgabe-Einheit Ergebnis
    2048 Mb Mb GB 2GB
    17179869184 B GB 16GB

    Erster Nicht-Null-Wert

    Verwenden Sie diese Option, wenn Sie eine Liste von Feldern mit ähnlichen Informationen haben, die einem einzelnen Feld zugeordnet werden müssen, und Sie die Reihenfolge einordnen möchten, in der sie diese Werte bereitstellen können.

    Beispielsweise gibt es intern in SolarWinds eine Hierarchie von Tabellen, die verknüpft sind. In einem Beispiel kann der Name eines Computers aus der untergeordneten Tabelle oder einer dieser übergeordneten Tabellen stammen, aber jedes dieser Tabellen ist ein separates Feld im Abruf. Beginnend mit der spezifischsten Tabelle werden die Werte nach der ersten Instanz eines Namenswerts gesucht.

    Details
    Tabelle sn_cmdb_int_util_first_non_null_Operation
    Eingabefelder source_sys_rte_eb_fields

    Die Eingabe ist eine Liste von Feldern beliebiger Länge.
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Wert aus dem ersten Feld in der Liste, das keinen Null- (oder leeren) Wert hat.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationFirstNonNullValueUtil().firstNonNullValue(batch[i])
    Tabelle : 19. Beispiel
    Feld 1 Feld 2 Feld 3 Ergebnis
    foo foo2 foo

    Name, Domäne, FQDN, DNS-Satz verarbeiten

    Verwenden Sie diese Option, wenn die Quelle Informationen zu Name, Domäne, FQDN oder DNS bereitstellt. Kann nur für eine Teilmenge dieser verwendet werden (wenn beispielsweise die Quelle nur Name und Domäne bereitstellt). Wenn eine Quelle nur Felder bereitstellt, die in der Eingabeliste (FQDN) niedriger sind, kann die CmdbIntegrationHardwareNameUtil-Skripteinbindung von einem Skriptvorgang aufgerufen werden, um zu minimieren, dass leere Dummy-Felder erstellt werden müssen.

    Details
    Tabelle sn_cmdb_int_util_Process_Name_Set_Operation
    Eingabefelder source_sys_rte_eb_fields
    Benötigt bis zu vier Eingabefelder (zusätzliche Felder werden ignoriert) in der folgenden Reihenfolge:
    1. Name
    2. Domäne
    3. FQDN
    4. DNS

    Sie müssen nicht alle vier Eingabewerte angeben, aber Sie müssen diese Werte in der angegebenen Reihenfolge angeben. Wenn Sie beispielsweise nur die Domäne bereinigen möchten, müssen Sie ein Namensattribut angeben, auch wenn es leer ist.
    Ausgabefeld target_sys_rte_eb_field

    Die Ausgabe ist ein verketteter Satz von Werten in derselben Reihenfolge, die eine Triple-Pipe (|||) verwenden: {Name}|||{Domain}|||{fqdn}|||{dns}
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet(name, domain, fqdn, dns)

    FQDN und DNS werden zuerst verarbeitet, um festzustellen, ob ihre Formate korrekt sind. FQDN hat einen zusätzlichen regulären Discovery-Ausdruck, der übergeben werden muss (über Eigenschaften): Glide.Discovery.fqdn.regex – Standard: ^([^.]+)\\.(?:[^.]+\\.)+[^.]+)$

    Mögliche Namen- und Domänenwerte werden nach Möglichkeit extrahiert. Wenn Name und Domäne verarbeitet werden und kein FQDN vorhanden ist, wird nach Möglichkeit ein Wert generiert. Ein resultierender Namenswert wird auch mithilfe der folgenden Discovery-Kennzeichnungen geändert:
    1. glide.discovery.hostname.case: Standard: Keine Änderung. Kann auf „Kleinbuchstaben“, „Großbuchstaben“, „keine Änderung“ festgelegt werden
    2. glide.discovery.hostname.include_domain: Standard: Falsch. Bei „wahr“ wird die Domäne dem endgültigen Namenswert hinzugefügt
    Tabelle : 20. Beispiele
    Name Domäne FQDN DNS Ergebnisse
    MYNAME other.net otherName.other.net mycomp.servicenow.com MYNAME|||other.net|||otherName.other.net|||mycomp.servicenow.com
    na other.net otherName.other.net mycomp.servicenow.com Anderer Name|||other.net|||otherName.other.net|||mycomp.servicenow.com
    servicenow.com |||servicenow.com|||||||||
    name.servicenow.com Name|||servicenow.com|||name.servicenow.com|||name.servicenow.com
    name.servicenow.com Name|||servicenow.com|||name.servicenow.com|||
    name.servicenow.com Name|||servicenow.com|||name.servicenow.com|||
    name servicenow.com Name|||servicenow.com|||name.servicenow.com|||

    FQDN verarbeiten

    Verwenden Sie diese Option, wenn die Quelle einen vermuteten FQDN-Wert, aber keine anderen Namensfelder wie Name, Domäne oder DNS bereitstellt.

    Details
    Tabelle sn_cmdb_int_util_Process_fqdn_Operation
    Eingabefelder source_sys_rte_eb_field

    Die Eingabe ist ein einzelnes Feld mit einem FQDN.
    Ausgabefeld target_sys_rte_eb_field

    Die Ausgabe ist ein verketteter Satz von Werten in derselben Reihenfolge mit einer Dreifach-Pipe (|||): {Name}|||{Domain}|||{fqdn}|||{dns}
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet('’, '’, fqdn, '’)

    Die Verarbeitung folgt der gleichen Logik wie die Transformation „Prozessname, Domäne, FQDN, DNS-Satz“, außer dass nur FQDN als Eingabe verwendet wird.

    Tabelle : 21. Beispiel
    Eingabe Ergebnis
    mycomputer.servicenow.com mycomputer|||servicenow.com|||mycomputer.servicenow.com||||

    Einheit skalieren

    Verwenden Sie diese Option, wenn die Quelle numerische Eingaben enthält, die skaliert werden müssen. Die Quelle stellt nicht immer die aktuellen Einheiten bereit, daher kann es erforderlich sein, die bereitgestellten Einheiten zu berechnen oder zu erraten. Die Zieleinheiten hängen von dem Feld ab, das in der CMDB angestrebt wird.

    Details
    Tabelle sn_cmdb_int_util_scale_unit_Operation
    Eingabefelder source_sys_rte_eb_fields
    Eingaben in Reihenfolge:
    1. Der Eingabewert
    2. Die aktuellen Einheiten
    3. Die Zieleinheiten
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Eingabewert, der von den aktuellen Einheiten bis zu den Zieleinheiten skaliert wird. Wenn für die aktuellen Einheiten keine Einheiten gefunden werden, wird der Eingabewert zurückgegeben. Wenn keine aktuellen Einheiten oder Zieleinheiten gefunden werden, wird die Eingabe als Ausgabe zurückgegeben.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationScaleUnitUtil().scaleUnits(input_value, input_unit, output_unit)
    Tabelle : 22. Beispiel
    Eingabe Ergebnis
    • Eingabefeld 1: 1
    • Eingabefeld 2: GB
    • Eingabefeld 3: MB
    		 1024

    Suche nach Software-Bündel-ID

    Verwenden Sie diese Option, wenn eine Quelle, z. B. Jamf, nicht den Softwareherausgeber, sondern eine Mac-Softwarepaket-ID bereitstellt. Software-Paket-ID-Suche sucht nach Datensätzen in der Tabelle „Bundleid-Suche“ [sn-cmdb_int_util_Bundleid_Lookup] nach Bundle_ID Wenn ein Datensatz mit der angegebenen Bundle_ID vorhanden ist, wird der jeweilige Softwareherausgeber extrahiert. Andernfalls wird ein neuer Datensatz erstellt, der bei der nächsten Ausführung der Datenquelle „Mac-Softwarepaket-IDs suchen“ abgefragt wird.

    Details
    Tabelle sn_cmdb_int_util_Software_Bundle_ID_Lookup_Operation
    Eingabefelder
    • Source_sys_rte_eb_field
    • Bundle-ID
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der resultierende Künstlername, der Track-Name und der Verkäufername, alle verkettet durch eine dreifache Pipe (||||) oder eine leere Zeichenfolge, wenn keine Übereinstimmung gefunden wird.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationSoftwareBundleIdLookup. lookupSoftware(bundleId)
    Tabelle : 23. Beispiel
    Eingabe Ergebnis
    Eingabefeld 1: Com.microsoft.Word Microsoft Corporation|||Microsoft Word|||| Microsoft Corporation

    Suche nach Anwender

    Verwenden Sie diese Option, um einen Anwender in der Anwendertabelle [sys_user] nach Anwendername oder E-Mail zu suchen, wobei versucht wird, die Übereinstimmung in der folgenden Reihenfolge zu finden:
    1. Der Anwendername, der mit übereinstimmt user_nameAttribut.
    2. Die E-Mail, die dem E-Mail-Attribut entspricht.
    3. Wenn nichts übereinstimmt, wird ein leeres Element zurückgegeben.
    Details
    Tabelle sn_cmdb_int_util_user_Lookup_Operation
    Eingabefelder source_sys_rte_eb_fields
    Eingaben in Reihenfolge:
    1. Anwendername
    2. E-Mail (Optional)
    Ausgabefeld target_sys_rte_eb_field

    SysId des sys_user.
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationUserLookup. lookupUser(username, email)
    Tabelle : 24. Beispiele
    Eingabe Ergebnis
    Eingabefeld 1: abel.tuter 62826bf0371020004e0bfc8bcbe5df1
    • Eingabefeld 1: Atuter
    • Eingabefeld 2: abel.tuter@example.com
    		 62826bf0371020004e0bfc8bcbe5df1