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

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 17 Minuten Lesedauer
  • Die RTE-Transformationen (Robuste Transformations-Engine) sind Vorgänge mit Vorlagen, die in der Store-App Gemeinsame Komponenten für CMDB-Integrationen (sn_cmdb_int_util) enthalten sind.

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

    CI-Suchvorgang

    Verwenden Sie diese Option, um den Wert eines Felds in einem vorhandenen Konfigurationselement (CI) in der CMDB durch den nativen Quellschlüssel abzurufen.

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

    Der Vorgang fragt die Quelltabelle [sys_object_source] nach der Discovery-Quelle und dem 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 auf dem CI, der mit der Suche des nativen Schlüssels der Quelle übereinstimmt, oder eine leere Zeichenfolge, wenn es keine Übereinstimmung gibt.

    Die Tabelle „Quelle“ [sys_object_source] wird anhand der Discovery-Quelle und des nativen Quellschlüssels in der Reihenfolge des letzten Scans abgefragt. Die Tabelle durchläuft die Ergebnisse der Abfrage und fragt die Zieltabelle anhand 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 diese Option, um den Namen des Hardwareherstellers 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 Dreifachpipeline (|||).

    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseCompany(input)

    Wenn kein übereinstimmender Datensatz vorhanden ist, wird ein neuer Datensatz in core_company 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 Plattform-API von MakeAndModelJS aufgerufen wird.

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

    Hardwaremodell bereinigen

    Verwenden Sie diese Option, 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 der Reihenfolge:
    1. Der Name des Herstellers
    2. Modellname

    Wenn einer der Werte selbst angegeben wird, verarbeitet der Vorgang nur das, was gefunden wurde.

    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_id und der Name des Unternehmens in core_company sowie die sys_id und der Name des Modells in cmdb_model – alle verkettet durch Dreifachpipeline (|||).

    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 an die MakeAndModelJS-Plattform-API gesendet.

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

    Hardwaremodell mit Modellnummer bereinigen

    Verwenden Sie diese Option, 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 mit Modellnummer bereinigen“ [sn_cmdb_int_util_cleanse_hardware_model_number_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in der Reihenfolge:
    1. Der Name des Herstellers
    2. Modellname
    3. Die Modellnummer
    4. CI-Klasse
      Hinweis:
      Das Feld CI-Klasse ist ein optionales Eingabefeld. Wenn es enthalten ist, ruft die MakeAndModelJS- Plattform-API den Modelldatensatz ab, indem die Produktmodellklasse aus der Modellkategorietabelle [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 selbst angegeben wird, verarbeitet der Vorgang nur das, was gefunden wurde.

    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist die resultierende sys_id und der Name des Unternehmens in core_company sowie die sys_id und der Name des Modells in cmdb_model – alle verkettet durch Dreifachpipeline (|||).

    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 die MakeAndModelJS- Plattform-API gesendet.

    Tabelle : 4. Beispiel
    Herstellername Modellname Modellnummer Ergebnis
    ServiceNow Incorporated SERVICENOW BC0AA8000C56 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb303710200044e0bfc8bcbe5d6d |||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 getestet (eine IPv4 mit Leerzeichen anstelle von Punkten). 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
    Müll
    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 unzuverlässig sein könnte.

    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 eingegebene IP-Adresswert wird 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 diese Option, 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 Name des zu bereinigenden Betriebssystems.

    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 die Werte des Microsoft-Betriebssystems, mit Ausnahme allgemeiner Bereinigungen wie dem Korrigieren von Groß-/Kleinschreibung.

    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 Kubuntu Linux Ubuntu
    Linux Ubuntu-Server Linux Ubuntu-Server

    Seriennummer bereinigen

    Verwenden Sie diese Option, 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
    ec2aa2da-5312-aa3e-804c-c35feabeda5f ec2aa2da-5312-aa3e-804c-c35feabeda5f
    1045–1209–6738–4668–7696–2783 1045–1209–6738–4668–7696–2783

    Softwaremodell bereinigen

    Verwenden Sie diese Option, um ein Softwaremodell zu bereinigen und zu erstellen. Außerdem, um Hersteller und Softwaremodell zu erstellen, falls sie nicht vorhanden sind, und anschließend einen Aufteilungsvorgang durchzuführen.

    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 der Reihenfolge:
    1. Der Name des Herstellers
    2. Der Name der Software
    3. Die Softwareversion (nicht erforderlich)

    Wenn nur Hersteller oder Name angegeben ist, 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 Version der bereinigten Software, alle verkettet durch eine dreifache Pipeline (|||).

    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 des Herstellers enthält (sofern der Hersteller nicht leer oder ungültig ist).

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

    Der Name und die Version der Software werden bereinigt, formatiert und zurückgegeben. Die Version wird aus dem Softwarenamen entfernt, falls vorhanden.

    Tabelle : 10. Beispiele
    Hersteller Softwarename Softwareversion Ergebnisse
    Dell Inc.
    NoManufacturer
    1.0.0.0
    Dell Inc. Daten-Engine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    OriginalIntel Test Software 1.0.0.1 7aad6d00c611228400f00e0f80b67d2d|||Intel|||TestSoftware|||1.0.0.1
    Dell Inc. Test Software 232 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||232
    Dell Inc. Test Software 123.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||123.0
    Amerika Online Test Software 1.0.0.0 0c43d035c61122750000251553f6f8e8|||America Online|||TestSoftware|||1.0
    Amerika Online Test Software 1.0.0.0 0c43d035c61122750000251553f6f8e8|||America Online|||TestSoftware|||1.0
    Dell Kleinbuchstaben 1.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Kleinbuchstaben|||1.0

    Dell, Inc.

    Incorporated, Corp.

    Test Software 1.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||1.0
    Microsoft

    Microsoft SQL

    Server 2016 Enterprise

    2.0.0 0e8b8e650a0a0b3b004f285ffbb1a4fc|||Microsoft|||Microsoft SQL Server 2016 Enterprise|||2.0
    Dell-Computer Daten-Engine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    Adobe Test Software 1 b7e8b5c4c0a80169008b49e468920048|||Adobe Systems|||TestSoftware|||1.0

    Software-Instanznamen erstellen

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

    Eingabe in der Reihenfolge:

    1. Der Hardwarename
    2. Der Name der Software
    3. Die Softwareversion (nicht erforderlich)
    Ausgabefeld target_sys_rte_eb_field

    Ausgabe ist der Software-Instanzname.

    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().createSoftwareInstanceName(hw_name_in, sw_name_in, sw_version_in)
    Tabelle : 11. Beispiele
    Hardwarename Softwarename 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 ein Computerdatensatz verarbeitet wird und ein Modell bereitgestellt wird, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen vom Typ „CI-Klasse ableiten“ 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 der Reihenfolge:
    1. 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 liegt als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server ist. Sucht nur in der Hierarchie cmdb_ci_computer und durchläuft cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, untergeordnete Elemente von cmdb_ci_server).

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

    Tabelle : 12. Beispiele
    Modell Klasse Klassenergebnisse
    Windows-Server 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 bereitgestellt wird, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen vom Typ „CI-Klasse ableiten“ verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse aus nativem Wert ableiten“ [sn_cmdb_int_util_derive_class_from_native_value_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in der 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 liegt als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server ist. Sucht nur in der Hierarchie cmdb_ci_computer und durchläuft cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, untergeordnete Elemente von cmdb_ci_server).

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

    Tabelle : 13. Beispiele
    Native Klasse Klasse Klassenergebnisse
    Windows-Server 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 ein Computerdatensatz verarbeitet wird und ein Betriebssystem bereitgestellt wird, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen vom Typ „CI-Klasse ableiten“ verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse aus Betriebssystem ableiten“ [sn_cmdb_int_util_derive_class_from_os_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in der Reihenfolge:
    1. Der Name des Betriebssystems
    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 liegt als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server ist. Sucht nur in der Hierarchie cmdb_ci_computer und durchläuft cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, untergeordnete Elemente von cmdb_ci_server).

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

    Tabelle : 14. Beispiele
    Betriebssystem Klasse Klassenergebnisse
    Windows-Server 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

    Wird verwendet, wenn ein Computerdatensatz verarbeitet wird, der virtuell sein kann, ein Hardwaremodell bereitgestellt wird und der virtuelle Status nicht eindeutig ist. Kann zusammen mit anderen Virtuell aus-Transformationen 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 der Reihenfolge:
    1. Der Name des Hardwaremodells
    2. Aktueller Wert der virtuellen Kennzeichnung
    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
    Hardwaremodell Virtuelle Kennzeichnung Ergebnisse der virtuellen Kennzeichnung
    ThinkPad Wahr Wahr
    ThinkPad false false
    ThinkPad false
    VMware Inc Wahr true
    true true
    „false“ eingestellt ist „false“ eingestellt ist
    false

    Virtuell von nativem Indikator ableiten

    Wird verwendet, wenn ein Computerdatensatz verarbeitet wird, der virtuell sein kann, ein virtueller Indikator von der Quelle bereitgestellt wird und der virtuelle Status mehrdeutig ist. Kann zusammen mit anderen Virtuell aus-Transformationen verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_virtual_from_native_value_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in der Reihenfolge:
    1. Der native Indikator
    2. Aktueller Wert der virtuellen Kennzeichnung
    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 Virtuelle Kennzeichnung Ergebnisse der virtuellen Kennzeichnung
    virtual false Wahr
    virtual Wahr
    virtual Wahr Wahr
    J false Wahr
    J Wahr
    J Wahr Wahr
    Ja false Wahr
    Ja Wahr
    Ja Wahr true
    true falsch true
    true true
    true true Wahr
    t false Wahr
    t Wahr
    t Wahr Wahr
    sonstige false false
    sonstige false
    sonstige Wahr Wahr
    nicht virtuell false false
    nicht virtuell false
    nicht virtuell Wahr true
    „false“ eingestellt ist „false“ eingestellt ist
    „false“ eingestellt ist
    true Wahr

    Virtuell von Seriennummer ableiten

    Wird verwendet, wenn ein Computerdatensatz verarbeitet wird, der virtuell sein kann, eine Seriennummer von der Quelle bereitgestellt wird und der virtuelle Status mehrdeutig ist. Kann zusammen mit anderen Virtuell aus-Transformationen verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_virtual_from_serial_number_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in der Reihenfolge:
    1. Die Seriennummer
    2. Aktueller Wert der virtuellen Kennzeichnung
    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 Virtuelle Kennzeichnung Ergebnisse der virtuellen Kennzeichnung
    123 Wahr Wahr
    123 false false
    123 false
    vmware-123 Wahr true
    true true
    „false“ eingestellt ist „false“ eingestellt ist
    false

    Extrahieren und nach Einheiten skalieren

    Verwenden Sie diese Option, wenn die Quelle numerische Werte hat, die skaliert werden müssen, und einen numerischen Wert 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, wird das Feld für die Dezimalstelle standardmäßig auf 2 festgelegt.

    Hinweis:
    In diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden.
    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 haben, die ähnliche Informationen enthalten, die einem einzelnen Feld zugeordnet werden müssen, und Sie die Reihenfolge festlegen möchten, in der sie diese Werte bereitstellen können.

    Beispiel: Intern in SolarWinds gibt es eine Hierarchie von Tabellen, die verbunden sind. In einem Beispiel könnte der Name eines Computers aus der untergeordneten Tabelle „Most“ oder einer der übergeordneten Tabellen stammen, aber jede dieser Tabellen ist ein separates Feld im Abruf. Beginnend mit der spezifischsten Tabelle werden die Werte nach der ersten Instanz eines Namenswerts durchsucht.

    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-Wert (oder leeren) enthält.

    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationFirstNonNullValueUtil().firstNonNullValue(batch[i])
    Tabelle : 19. Beispiel
    Feld 1 Feld 2 Feld 3 Ergebnis
    foo FOOT2 foo

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

    Verwenden Sie diese Option, wenn die Quelle Name, Domäne, FQDN oder DNS-Informationen bereitstellt. Kann nur für eine Teilmenge davon verwendet werden (wenn die Quelle beispielsweise nur Name und Domäne bereitstellt). Wenn eine Quelle nur Felder bereitstellt, die sich in der Eingabeliste (FQDN) weiter unten befinden, kann die Skripteinbindung CmdbIntegrationHardwareNameUtil von einem Skriptvorgang aus aufgerufen werden, um die Erstellung leerer Dummy-Felder so gering wie möglich zu halten.

    Details
    Tabelle sn_cmdb_int_util_process_name_set_operation
    Eingabefelder source_sys_rte_eb_fields
    Nimmt bis zu vier Eingabefelder auf (alle zusätzlichen 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 mit einer Dreifachpipe (|||): {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 verfügt über einen zusätzlichen regulären Ausdruck für die Erkennung, der übergeben werden muss (über Eigenschaften): glide.discovery.fqdn.regex – Standard: ^([^.]+)\\.((?:[^.]+\\.)+[ ^.]+)$

    Mögliche Namens- 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 Erkennungskennzeichnungen geändert:
    1. glide.discovery.hostname.case – Standard: Keine Änderung. Kann festgelegt werden auf „Kleinbuchstaben“, „Großbuchstaben“, „Keine Änderung“
    2. glide.discovery.hostname.include_domain – Standard: false. Bei „wahr“ wird die Domäne zum endgültigen Namenswert hinzugefügt
    Tabelle : 20. Beispiele
    Name Domäne FQDN DNS Ergebnisse
    meinName other.net sonstigerName.andere.net mycomp.servicenow.com myName|||other.net|||otherName.other.net|||mycomp.servicenow.com
    na other.net sonstigerName.andere.net mycomp.servicenow.com otherName|||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 Benennungsfelder 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, das einen FQDN enthält.

    Ausgabefeld target_sys_rte_eb_field

    Die Ausgabe ist ein verketteter Satz von Werten in derselben Reihenfolge mit einer Dreifachpipe (|||): {name}|||{domain}|||{fqdn}|||{dns}

    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet('’, '’, fqdn, '’)

    Die Verarbeitung folgt der gleichen Logik wie die Transformation „Name, Domäne, FQDN, DNS-Satz verarbeiten“, außer dass nur der 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 hat, 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 Zielfeld in der CMDB ab.

    Details
    Tabelle sn_cmdb_int_util_scale_unit_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingaben in der 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 auf die Zieleinheiten skaliert wird. Wenn für die aktuellen Einheiten keine Einheiten gefunden werden, wird der Eingabewert zurückgegeben. Wenn keine aktuellen 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, aber eine Mac-Softwarepaket-ID bereitstellt. Software-Bundle-ID-Suche sucht Datensätze in der Tabelle „Bundle-ID-Suche“ [sn-cmdb_int_util_bundleid_lookup] nach bundle_id. Wenn ein Datensatz mit der angegebenen bundle_id vorhanden ist, wird der entsprechende Softwareherausgeber extrahiert. Andernfalls wird ein neuer Datensatz erstellt, der beim nächsten Ausführen 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

    Die Ausgabe ist der resultierende Künstlername, der Titelname und der Verkäufername, alle verkettet durch eine Dreifachpipe (|||), 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 Inc.|||Microsoft Word||| Microsoft, Inc

    Suche nach Anwender

    Verwenden Sie diese Option, um einen Benutzer in der Benutzertabelle [sys_user] nach Benutzername oder E-Mail-Adresse zu suchen, und versuchen Sie, eine Übereinstimmung in der folgenden Reihenfolge zu finden:
    1. Der Benutzername, der dem Attribut user_name entspricht.
    2. Die E-Mail, die dem E-Mail-Attribut entspricht.
    3. Wenn nichts übereinstimmt, wird leer zurückgegeben.
    Details
    Tabelle sn_cmdb_int_util_user_lookup_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingaben in der Reihenfolge:
    1. Benutzername
    2. E-Mail (optional)
    Ausgabefeld target_sys_rte_eb_field

    sysId von sys_user.

    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationUserLookup. lookupUser(username, email)
    Tabelle : 24. Beispiele
    Eingabe Ergebnis
    Eingabefeld 1: abel.tuter 62826bf03710200044e0bfc8bcbe5df1
    • Eingabefeld 1: atuter
    • Eingabefeld 2: abel.tuter@example.com
    62826bf03710200044e0bfc8bcbe5df1