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

  • Freigeben Version: Xanadu
  • Aktualisiert 30. August 2024
  • 18 Minuten Lesedauer

    • Die RTE-Transformationen (Robust Transform Engine) sind auf Vorlagen basierende Vorgänge, 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

    Dient zum Abrufen des Werts eines Felds in einem vorhandenen Configuration Item (CI) in der CMDB nach dem nativen Quellschlüssel.

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

    Der Vorgang fragt die Tabelle „Quelle“ [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

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

    Die Tabelle „Quelle“ [sys_object_source] wird anhand der Discovery-Quelle und der nativen Schlüsselreihenfolge der Quelle beim letzten Scan abgefragt. Die Tabelle iteriert die Ergebnisse der Abfrage und fragt die Zieltabelle mit 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 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 verknüpft ist (cpu_manufacturer).

    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 die Dreifachpipe (|||).
    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 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 ist:
    1. Der Herstellername
    2. Der Modellname

    Wenn einer der Werte von ihm selbst bereitgestellt wird, verarbeitet der Vorgang nur den gefundenen.
    Ausgabefeld target_sys_rte_eb_field

    Die 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“, jeweils verkettet durch die Dreifachpipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Wenn für Hersteller oder 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. Anschließend werden der Herstellername sowie 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, 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 Modellnummervorgang bereinigen“ [sn_cmdb_int_util_cleanse_hardware_model_number_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge ist:
    1. Der Herstellername
    2. Der 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 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 ihm selbst bereitgestellt wird, verarbeitet der Vorgang nur den gefundenen.
    Ausgabefeld target_sys_rte_eb_field

    Die 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“, jeweils verkettet durch die Dreifachpipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Wenn für Hersteller oder 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. Anschließend 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 angibt.

    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 auf IPv4- und IPv6-Strukturen zusammen mit einigen bekannten Ableitungen (eine IPv4 mit Leerzeichen anstelle von Punkten) 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
    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 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

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

    Der eingegebene IP-Adresswert wird entweder auf die richtige IPv4- oder IPv6-Struktur überprüft, andernfalls ist die Ausgabe leer. Diese Funktion bietet keine IP-Bereinigung.

    Tabelle : 6. Beispiel
    Eingabe Ergebnis
    192.160.89.1 4

    MAC-Adresse bereinigen

    Wird verwendet, 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 (z. B. eine MAC-Adresse mit Leerzeichen anstelle von Doppelpunkten) auf die richtige Struktur getestet. Wenn ein Ergebnis gefunden wird, wird es formatiert und zurückgegeben.

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

    Betriebssystem bereinigen

    Dient zum Extrahieren, Bereinigen und Formatieren eines Betriebssystemnamens, wenn die Quelle einen Betriebssystemwert bereitstellt.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Betriebssystem 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, neben der allgemeinen Bereinigung wie z. B. der Korrektur von Gehäusen.

    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
    MicrosoftWindows 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-Ubundu 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

    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 bereinigen mit alternativem Rückgabewert [

    [sn_cmdb_int_util_cle$anse_serial_number_with_alternat_value_return_if_invalid]
    Eingabefelder source_sys_rte_eb_fields

    Eingaben: Seriennummer, Alternativwert
    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 prüft, ob die Länge der bereinigten Seriennummer größer oder gleich dem in der Systemeigenschaft sn_cmdb_int_util.minimum_valid_serial_number_length angegebenen Wert ist. Der Standardwert der Eigenschaft ist auf 7festgelegt.

    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 – IMe mit Rückgabe eines alternativen Werts bereinigen, wenn ungültig [

    [sn_cmdb_int_util_cleanse_imei_with_alternat_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 prüft, ob die Länge der bereinigten IMeI-Nummer dem in der Systemeigenschaft sn_cmdb_int_util.valid_imei_number_length angegebenen Wert entspricht. Der Standardwert der Eigenschaft ist auf 15festgelegt.

    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 anschließend einen Teilungsvorgang 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 Reihenfolge ist:
    1. Der Herstellername
    2. Der Softwarename
    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 Version der bereinigten Software, alle verkettet durch eine Dreifachpipe (|||).
    Skripteinbindungsfunktion sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().cleanseSoftwareModel(company, model, version)

    Wenn kein passender 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.

    Name und 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.
    Kein Hersteller
    1.0.0.0
    Dell Inc. DataEngine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    OriginalIntel 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 Inc.

    Incident, Corp.

    		 TestSoftware 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 DataEngine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    Adobe TestSoftware 1 b7e8b5c4c0a80169008b49e468920048|||Adobe Systeme|||TestSoftware|||1.0

    Software-Instanznamen erstellen

    Verwenden Sie diese Option, wenn ein Hardwarename, ein Softwarename und eine Softwareversion angegeben werden, 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 Reihenfolge ist:

    1. Der Hardwarename
    2. Der Softwarename
    3. Die Softwareversion (nicht erforderlich)
    Ausgabefeld target_sys_rte_eb_field

    Die 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
    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 angegeben ist, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen der 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 Reihenfolge ist:
    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 höher ist (eine übergeordnete Klasse) als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server lautet. Betrachtet nur die 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
    Architekturserver 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
    FeWo-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 ist, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen der CI-Klasse ableiten verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Vorgang „Klasse aus nativen Wert ableiten“ [sn_cmdb_int_util_derive_class_from_native_value_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge ist:
    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 höher ist (eine übergeordnete Klasse) als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server lautet. Betrachtet nur die 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
    Architekturserver 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
    FeWo-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, wenn ein Computerdatensatz verarbeitet wird und ein Betriebssystem angegeben ist, die Klasse des Computers jedoch ansonsten mehrdeutig ist. Kann zusammen mit anderen Transformationen der CI-Klasse ableiten verwendet werden.

    Details
    Tabelle Entität der robusten Transformations-Engine – Klasse aus BS-Vorgang ableiten [sn_cmdb_int_util_derive_class_from_os_operation]
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge ist:
    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 höher ist (eine übergeordnete Klasse) als die angegebene Eingabeklasse. Beispielsweise gibt cmdb_ci_computer nicht zurück, wenn die Eingabe cmdb_ci_server lautet. Betrachtet nur die 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
    Architekturserver 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
    FeWo-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, wenn ein Computerdatensatz verarbeitet wird, der virtuell sein kann, ein Hardwaremodell bereitgestellt wird und der virtuelle Status mehrdeutig ist. Kann zusammen mit anderen Transformationen des Typs „Virtuell von 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 ist:
    1. Der Name des Hardwaremodells
    2. Der aktuelle 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 Virtuelle Kennzeichnungsergebnisse
    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, wenn ein Computerdatensatz verarbeitet wird, der virtuell sein kann, wenn von der Quelle ein virtueller Indikator bereitgestellt wird und der virtuelle Status mehrdeutig ist. Kann zusammen mit anderen Transformationen des Typs „Virtuell von ableiten“ verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_virtual_from_native_value_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge ist:
    1. Der native Indikator
    2. Der aktuelle 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 vom Typ „wahr“.

    Tabelle : 16. Beispiele
    Nativer virtueller Wert Virtuelle Kennzeichnung Virtuelle Kennzeichnungsergebnisse
    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, 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 Transformationen des Typs „Virtuell von ableiten“ verwendet werden.

    Details
    Tabelle sn_cmdb_int_util_derive_virtual_from_serial_number_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingabe in Reihenfolge ist:
    1. Die Seriennummer
    2. Der aktuelle 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 Virtuelle Kennzeichnungsergebnisse
    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 einen numerischen Wert mit einer Eingabe wie z. B. 2048 MB. Die Quelle stellt die Einheiten nicht immer bereit, daher kann es erforderlich sein, die bereitgestellten Einheiten zu berechnen oder zu raten. 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:
    Bei 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
    2.048 MB MB GB 2GB
    17179869184 B GB 16GB

    Erster Nicht-Null-Wert

    Verwenden Sie diese Option, wenn Sie über eine Liste von Feldern mit ähnlichen Informationen verfügen, die einem einzelnen Feld zugeordnet werden müssen, und Sie möchten die Reihenfolge festlegen, in der diese Werte bereitgestellt werden können.

    Beispiel: Intern in SolarWinds gibt es eine Hierarchie von Tabellen, die verknüpft werden. In einem Beispiel könnte der Name eines Computers aus der untergeordnetsten Tabelle oder einem der ü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 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) Wert enthält.
    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 davon verwendet werden (z. B. wenn die Quelle nur Name und Domäne bereitstellt). Für den Fall, dass eine Quelle nur Felder bereitstellt, die sich in der Eingabeliste (FQDN) weiter unten befinden, kann die Skripteinbindung CmdbIntegrationHardwareNameUtil von einem Skriptvorgang aufgerufen werden, um die Erstellung leerer Dummy-Felder zu minimieren.

    Details
    Tabelle sn_cmdb_int_util_process_name_set_operation
    Eingabefelder source_sys_rte_eb_fields
    Verwendet bis zu vier Eingabefelder (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, bei dem eine Dreifachpipe (|||) verwendet wird: {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 (über Eigenschaften) übergeben werden muss: 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 Discovery-Flags geändert:
    1. glide.discovery.hostname.case – Standard: Keine Änderung. Kann festgelegt werden auf „Kleinschreibung“, „Großschreibung“, „Keine Änderung“
    2. glide.discovery.hostname.include_domain – Standard: falsch. Bei „wahr“ wird die Domäne zum endgültigen Namenswert hinzugefügt
    Tabelle : 20. Beispiele
    Name Domäne FQDN DNS Ergebnisse
    meinName other.net otherName.other.net mycomp.servicenow.com meinName|||other.net|||otherName.other.net|||mycomp.servicenow.com
    na other.net otherName.other.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 angibt, aber keine anderen Benennungsfelder wie Name, Domäne oder DNS.

    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 unter Verwendung einer Dreifachpipe (|||): {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 meincomputer|||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 liefert nicht immer die aktuellen Einheiten, daher müssen die bereitgestellten Einheiten möglicherweise berechnet oder geschätzt werden. Die Zieleinheiten hängen vom Zielfeld in der CMDB ab.

    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 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 wie Jamf nicht den Softwareherausgeber, aber eine Mac-Softwarepaket-ID bereitstellt. „Software-Bundle-ID-Suche“ sucht nach Datensätzen in der Tabelle „Bündel-ID-Suche“ [sn-cmdb_int_util_bundleid_lookup] anhand der Paket-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

    Ausgabe ist der resultierende Künstlername, Titelname und 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, um einen Anwender in der Tabelle „Anwender [sys_user]“ anhand des Anwendernamens oder der E-Mail-Adresse zu suchen und in der folgenden Reihenfolge zu finden:
    1. Der Anwendername, der dem user_name -Attribut entspricht.
    2. Die dem email-Attribut entsprechende E-Mail-Adresse.
    3. Wenn nichts übereinstimmt, wird ein leerer Wert zurückgegeben.
    Details
    Tabelle sn_cmdb_int_util_user_lookup_operation
    Eingabefelder source_sys_rte_eb_fields
    Eingaben in Reihenfolge:
    1. Anwendernamen
    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 62826bf03710200044e0bfc8bcbe5df1
    • Eingabefeld 1: atuter
    • Eingabefeld 2: abel.tuter@example.com
    		 62826bf03710200044e0bfc8bcbe5df1