Scripts de modèle de transformations RTE inclus dans l’application Éléments communs d'intégration pour CMDB

Les transformations du moteur de transformation robuste (RTE) sont des opérations basées sur un modèle incluses dans l’application Éléments communs d'intégration pour CMDB (sn_cmdb_int_util) du magasin.

Les transformations RTE basées sur un script suivantes sont disponibles dans l’application Éléments communs d'intégration pour CMDB .

Opération de recherche de CI

Utilisez cette propriété pour obtenir la valeur d’un champ sur un élément de configuration (CI) existant dans la CMDB à l’aide de la clé native source.

Détails
Table	Opération de recherche de CI du moteur de transformation robuste [sn_cmdb_int_util_ci_lookup_operation]
Champ d'entrée	source_sys_rte_eb_field L’entrée dans l’ordre est : Source de découverte Clé native de la source Champ CI L’opération interroge la table Source [sys_object_source] pour la source de détection et la clé native source associée, puis renvoie la valeur Champ CI de l’enregistrement correspondant dans la table cible et l’ID système cible associé.
Champ de sortie	target_sys_rte_eb_field La sortie est la valeur du nom de champ sur le CI correspondant à la recherche de clé native source ou à une chaîne vide s’il n’y a pas de correspondance.

La table Source [sys_object_source] est interrogée à l’aide de la source de découverte et de la clé native source par ordre lors de la dernière analyse. La table itère les résultats de la requête et interroge la table cible par l’ID système cible jusqu’à ce qu’un CI valide soit trouvé. Une fois qu’un CI valide est trouvé, l’opération renvoie la valeur du champ CI sur le CI correspondant.

Tableau 1. Exemple

Source de découverte	Clé native de la source	Champ CI	Résultat
ServiceNow	ServiceNow|||NOM-ORDINATEUR|||Ordinateur-01	nom	Computer-01

Nettoyer la société

Utilisez cette option pour nettoyer le nom du fabricant de matériel et ajouter l’enregistrement à la table Société [core_company] pour renseigner une référence, lorsque le fabricant n’est pas lié à un modèle ou à un logiciel (cpu_manufacturer).

Détails
Table	Opération de la société de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_company_operation]
Champ d'entrée	source_sys_rte_eb_field L’entrée est un nom de société/fabricant.
Champ de sortie	target_sys_rte_eb_field La sortie est le sys_id et le nom de la société en core_company, concaténés par un triple tuyau (|||).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseCompany(input)

Si aucun enregistrement correspondant n’existe, un nouvel enregistrement est créé dans core_company de sorte que le retour inclut toujours un sys_id et un nom (sauf si l’entrée est vide ou non valide). Le nom est nettoyé et une recherche floue est effectuée via l’include de script CmdbIntegrationCompanyModelUtil avant que l’API de la plateforme MakeAndModelJS ne soit appelée.

Tableau 2. Exemple

Entrée	Résultat
SERVICENOW	93d4ecfac0a8000b6294d71b733977fb|||ServiceNow

Nettoyer le modèle de matériel

Utilisez cette fonction pour créer, nettoyer ou rechercher un modèle matériel en vue de créer une référence (model_id).

Détails
Table	Opération du modèle de matériel de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_hardware_model_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Le nom du fabricant Nom du modèle Si l’une ou l’autre des valeurs est fournie seule, l’opération ne traite que ce qui est trouvé.
Champ de sortie	target_sys_rte_eb_field La sortie est le sys_id et le nom de la société dans core_company, ainsi que le sys_id et le nom du modèle dans cmdb_model - tous concaténés par un triple tube (|||).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

Pour le fabricant ou le modèle, si aucun enregistrement correspondant n’existe, un nouvel enregistrement est créé de sorte que le retour inclut toujours sys_ids et les noms des deux enregistrements (sauf si l’entrée est vide ou non valide).

Le nom du fabricant est traité comme la transformation Nettoyer la société, puis le nom du fabricant, le nom du modèle sont envoyés à l’API de la plateforme MakeAndModelJS.

Tableau 3. Exemple

Nom du fabricant	Nom du modèle	Résultat
ServiceNow incorporé	SERVICENOW	93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb303710200044e0bfc8bcbe5d6d |||ServiceNow

Nettoyer le modèle de matériel avec le numéro de modèle

Utilisez cette fonction pour créer, nettoyer ou rechercher un modèle matériel en vue de créer une référence (model_id).

Détails
Table	Opération modèle matériel nettoyage entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_hardware_model_number_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Le nom du fabricant Nom du modèle Le numéro de modèle Classe CI Remarque : Le champ Classe CI est un champ d’entrée facultatif et, lorsqu’il est inclus, l’API de la plateforme MakeAndModelJS obtient l’enregistrement du modèle en interrogeant la classe de modèle du produit à partir de la table Catégorie de modèle [cmdb_model_category]. Sinon, l’API obtient l’enregistrement de modèle à partir de la table Modèles matériels [cmdb_hardware_product_model] uniquement. Si l’une ou l’autre des valeurs est fournie seule, l’opération ne traite que ce qui est trouvé.
Champ de sortie	target_sys_rte_eb_field La sortie est le sys_id et le nom de la société dans core_company, ainsi que le sys_id et le nom du modèle dans cmdb_model - tous concaténés par un triple tube (|||).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

Pour le fabricant ou le modèle, si aucun enregistrement correspondant n’existe, un nouvel enregistrement est créé de sorte que le retour inclut toujours sys_ids et les noms des deux enregistrements (sauf si l’entrée est vide ou non valide).

Le nom du fabricant est traité comme la transformation Nettoyer la société, puis le nom du fabricant, le nom du modèle et le numéro de modèle sont envoyés à l’API de la plateforme MakeAndModelJS .

Tableau 4. Exemple

Nom du fabricant	Nom du modèle	Numéro de modèle	Résultat
ServiceNow incorporé	SERVICENOW	BC0AA8000C56	93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb303710200044e0bfc8bcbe5d6d |||ServiceNow

Nettoyer l'adresse IP

À utiliser lorsqu’un champ fournit une adresse IP.

Détails
Table	Opération de l’IP de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_ip_operation]
Champs d'entrée	source_sys_rte_eb_field L’entrée correspond à l’adresse IP à nettoyer.
Champ de sortie	target_sys_rte_eb_field La sortie est l’adresse IP résultante, qui peut être vide.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseIpAddress(input)

L’adresse IP est testée pour les structures IPv4 et IPv6 ainsi que pour certaines dérivations connues (une IPv4 avec des espaces au lieu de points). Si un résultat est trouvé, il est formaté et renvoyé.

Tableau 5. Exemples

IP	Résultats IP
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
camelote
175912537	10.124.54.89
-1
0

Nettoyer la version de l'IP

À utiliser lorsque la source de données ne fournit pas de version IP ou lorsque la version IP peut ne pas être fiable.

Détails
Table	Opération de version de l’IP de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_ip_version_operation]
Champs d'entrée	source_sys_rte_eb_field L’entrée correspond à l’adresse IP à nettoyer.
Champ de sortie	target_sys_rte_eb_field La sortie est la clé de recherche cmdb_ci_ip_address.ip_version résultante (4, 6 ou vide).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationNetworkUtil().deriveIpVersion(input)

La valeur de l’adresse IP d’entrée est vérifiée pour la structure IPv4 ou IPv6, sinon le renvoi est vide. Cette fonction ne fournit aucun nettoyage IP.

Tableau 6. Exemple

Entrée	Résultat
192.160.89.1	4

Nettoyer l'adresse MAC

À utiliser lorsqu’un champ fournit une adresse MAC.

Détails
Table	Opération MAC de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_mac_operation]
Champs d'entrée	source_sys_rte_eb_field L’entrée est l’adresse MAC à nettoyer.
Champ de sortie	target_sys_rte_eb_field La sortie est l’adresse MAC résultante qui peut être vide.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseMacAddress(input)

L’adresse MAC est testée pour sa structure correcte ainsi que certaines dérivations connues (par exemple, une adresse MAC avec des espaces au lieu de deux-points). Si un résultat est trouvé, il est formaté et renvoyé.

Tableau 7. Exemple

Entrée	Résultat
00 0A 95 9D 68 16	00:0a :95:9d :68:16

Nettoyer le système d'exploitation

Utilisez cette propriété pour extraire, nettoyer et formater un nom de système d’exploitation, lorsque la source fournit une valeur de système d’exploitation.

Détails
Table	Opération du système d’exploitation de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_os_operation]
Champs d'entrée	source_sys_rte_eb_field L’entrée est le nom du système d’exploitation à nettoyer.
Champ de sortie	target_sys_rte_eb_field La sortie est le nom du système d’exploitation résultant. Le nom du système d’exploitation obtenu est également écrit dans le champ de liste cmdb_ci_computer.os.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationOsUtil().cleanseAndInsertOs(input)

La plupart du nettoyage actuel est centré sur les valeurs du système d’exploitation Microsoft, en dehors du nettoyage commun tel que la réparation du boîtier.

Tableau 8. Exemples

Système d'exploitation	Résultats du système d’exploitation
Windows Server 2003 R2 Édition 64 bits Service Pack 2	Serveur Windows 2003 R2
Windows 2003	Windows 2003
Windows Vista Édition 64 bits	Windows Vista
Windows 2000 Professionnel Service Pack 4	Windows 2000 Professionnel
Service Pack Windows XP 2-3	Windows XP
Microsoft Windows Server 2003 R2 Édition 64 bits Service Pack 2	Serveur Windows 2003 R2
Microsoft Windows 2003	Windows 2003
Microsoft Windows Vista Édition 64 bits	Windows Vista
Microsoft Windows 2000 Professionnel Service Pack 4	Windows 2000 Professionnel
Microsoft Windows XP Service Pack 2-3	Windows XP
Linux Ubuntu	Linux Ubuntu
Serveur Linux Ubuntu	Serveur Linux Ubuntu

Nettoyer le numéro de série

Utilisez cette propriété pour nettoyer et supprimer les numéros de série non valides.

Détails
Table	Opération du numéro de série de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_serial_number_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée est le numéro de série à nettoyer.
Champ de sortie	target_sys_rte_eb_field La sortie est le numéro de série résultant.

Tableau 9. Exemples

Numéro de série	Résultats des numéros de série
EC2aa2da-5312-AA3E-804C-C35FEABEDA5F	EC2aa2da-5312-AA3E-804C-C35FEABEDA5F
1045–1209–6738–4668–7696–2783	1045–1209–6738–4668–7696–2783

Nettoyer le numéro de série avec une valeur alternative renvoyée si non valide

Utilisez cette propriété pour nettoyer le numéro de série et vérifier sa longueur. Renvoie la valeur alternative si la longueur du numéro de série n’est pas valide.

Détails
Table	Nettoy. entité moteur de transform. robuste num. série avec retour de val. alt. [sn_cmdb_int_util_cle$anse_serial_number_with_alternate_value_return_if_invalid]
Champs d'entrée	source_sys_rte_eb_fields Entrées : numéro de série, valeur alternative
Champ de sortie	target_sys_rte_eb_field Sortie : numéro de série nettoyé si la longueur est valide, valeur alternative dans le cas contraire.
Fonction Script Include	global.SerialNumberManager().isValid(input)

L’opération nettoie le numéro de série et vérifie si la longueur du numéro de série nettoyé est supérieure ou égale à la valeur spécifiée dans la sn_cmdb_int_util.minimum_valid_serial_number_length propriété système. La valeur par défaut de la propriété est définie sur 7.

Nettoyer le numéro IMEI avec une valeur alternative renvoyée si non valide

Utilisez cette propriété pour nettoyer le numéro IMEI et vérifier sa longueur. Renvoie la valeur alternative si la longueur du numéro IMEI n’est pas valide.

Détails
Table	Nettoy. entité moteur de transform. robuste IMEI retour de val. alt. si inval [sn_cmdb_int_util_cleanse_imei_with_alternate_value_return_if_invalid]
Champs d'entrée	source_sys_rte_eb_fields Entrées : numéro IMEI, autre valeur
Champ de sortie	target_sys_rte_eb_field Sortie : numéro IMEI si la longueur est valide, autre valeur dans le cas contraire.
Fonction Script Include	Néant

L’opération nettoie le numéro IMEI et vérifie si la longueur du numéro IMEI nettoyé est égale à la valeur spécifiée dans la sn_cmdb_int_util.valid_imei_number_length propriété système. La valeur par défaut de la propriété est définie sur 15.

Nettoyer le modèle du logiciel

Utilisez cette propriété pour nettoyer et créer un modèle logiciel. Il permet également de créer un fabricant et un modèle logiciel s’ils n’existent pas et de poursuivre avec une opération de fractionnement.

Détails
Table	Opération du modèle logiciel de nettoyage sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_cleanse_software_model_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Le nom du fabricant Le nom du logiciel La version du logiciel (non requise) Si seul le fabricant ou le nom est fourni, seules ces valeurs sont traitées et renvoyées.
Champ de sortie	target_sys_rte_eb_field La sortie est l’sys_id et le nom de la société résultants dans core_company, le nom du logiciel nettoyé et la version du logiciel nettoyé, tous concaténés par un triple tube (|||).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().cleanseSoftwareModel(company, model, version)

S’il n’existe aucun enregistrement de fabricant correspondant, un nouvel enregistrement est créé afin que le retour inclue toujours le sys_id et le nom du fabricant (si le fabricant n’est pas vide ou non valide).

Le nom du fabricant est traité de la même manière que dans la transformation Nettoyer la société, puis le nom du fabricant est envoyé à l’API de la plateforme MakeAndModelJS.

Le nom et la version du logiciel sont nettoyés, formatés et renvoyés. La version est supprimée du nom du logiciel le cas échéant.

Tableau 10. Exemples

Fabricant	Nom du logiciel	Version du logiciel	Résultats
Dell Inc.
	Aucun fabricant
		1.0.0.0
Dell Inc.	Moteur de données	1.0.17.2	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Moteur de données|||1.0.17.2
Intelrès authentique	Logiciel de test	1.0.0.1	7aad6d00c611228400f00e0f80b67d2d|||Intel|||Logiciel de test|||1.0.0.1
Dell Inc.	Logiciel de test	232	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Logiciel de test|||232
Dell Inc.	Logiciel de test	123.0.0.0	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Logiciel de test|||123.0
Amérique en ligne	Logiciel de test	1.0.0.0	0c43d035c61122750000251553f6f8e8|||Amérique en ligne|||Logiciel de test|||1.0
Amérique en ligne	Logiciel de test	1.0.0.0	0c43d035c61122750000251553f6f8e8|||Amérique en ligne|||Logiciel de test|||1.0
vallon	Minuscule	1.0.0.0	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Minuscules|||1.0
Dell Corporation. Incorporated, Corp.	Logiciel de test	1.0.0.0	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Logiciel de test|||1.0
Microsoft	Microsoft SQL Serveur 2016 Enterprise	2.0.0	0e8b8e650a0a0b3b004f285ffbb1a4fc|||Microsoft|||Microsoft SQL Server 2016 Entreprise|||2.0
Ordinateur Dell	Moteur de données	1.0.17.2	b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||Moteur de données|||1.0.17.2
Adobe	Logiciel de test	1	b7e8b5c4c0a80169008b49e468920048|||Adobe Systems|||Logiciel de test|||1.0

Créer le nom de l'instance de logiciel

À utiliser lorsqu’un nom de matériel, un nom de logiciel et une version de logiciel sont fournis pour créer un nouveau nom d’instance logicielle.

Détails
Table	Opération du nom de l’instance du logiciel de création sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_create_software_instance_name_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Le nom du matériel Le nom du logiciel La version du logiciel (non requise)
Champ de sortie	target_sys_rte_eb_field La sortie est le nom de l’instance logicielle.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().createSoftwareInstanceName(hw_name_in, sw_name_in, sw_version_in)

Tableau 11. Exemples

Nom du matériel	Nom du logiciel	Version du logiciel	Résultats
computer1	Microsoft	2.0.1	Microsoft 2.0.1 : ordinateur1
computer2	adobe		adobe-ordinateur2
computer3	adobe	2.1	Adobe 2.1 - Ordinateur3
hw2	sw3	301	SW3 301-HW2

Dériver la classe CI à partir du modèle

À utiliser lors du traitement d’un enregistrement d’ordinateur et un modèle est fourni, mais la classe de l’ordinateur est ambiguë dans le cas contraire. Peut être utilisé avec d’autres transformations de classe CI de dérivation.

Détails
Table	Dériver la classe de l’opération du modèle sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_derive_class_from_model_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Nom du modèle Le nom de classe actuel
Champ de sortie	target_sys_rte_eb_field La sortie est le nom de classe résultant.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromModelInput(model_in, class_in)

Ne renvoie pas la valeur d’une classe qui est plus élevée dans la hiérarchie des classes (une classe parente) que la classe d’entrée fournie. Par exemple, ne renvoie pas cmdb_ci_computer si l’entrée est cmdb_ci_server. Examine uniquement la hiérarchie des cmdb_ci_computer, en passant par cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, enfants de cmdb_ci_server).

Recherche actuellement des indicateurs Server, Windows Server et Linux Server dans le modèle.

Tableau 12. Exemples

Modèle	Classe	Résultats de la classe
Serveur Windows	cmdb_ci_computer	cmdb_ci_win_server
Serveur Microsoft	cmdb_ci_computer	cmdb_ci_win_server
Serveur Linux	cmdb_ci_computer	cmdb_ci_linux_server
Serveur Microsoft	cmdb_ci_server	cmdb_ci_win_server
Serveur Linux	cmdb_ci_server	cmdb_ci_linux_server
Serveur Red Hat	cmdb_ci_server	cmdb_ci_linux_server
Serveur Arch	cmdb_ci_server	cmdb_ci_linux_server
Serveur Centos	cmdb_ci_server	cmdb_ci_linux_server
Serveur Debian	cmdb_ci_server	cmdb_ci_linux_server
Serveur Fedora	cmdb_ci_server	cmdb_ci_linux_server
Serveur SUSE	cmdb_ci_server	cmdb_ci_linux_server
Serveur Oracle	cmdb_ci_server	cmdb_ci_linux_server
Serveur Rhel	cmdb_ci_server	cmdb_ci_linux_server
Serveur Ubuntu	cmdb_ci_server	cmdb_ci_linux_server
Courrier indésirable
	cmdb_ci_server	cmdb_ci_server
Serveur indésirable	cmdb_ci_computer	cmdb_ci_server
Courrier indésirable	cmdb_ci_computer	cmdb_ci_computer

Dériver la classe CI à partir de l'identificateur de classe native

À utiliser lors du traitement d’un enregistrement d’ordinateur et un indicateur de classe native est fourni, mais la classe de l’ordinateur est ambiguë dans le cas contraire. Peut être utilisé avec d’autres transformations de classe CI de dérivation.

Détails
Table	Dériver la classe de l’opération de la valeur native sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_derive_class_from_native_value_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Identificateur de classe native Le nom de classe actuel
Champ de sortie	target_sys_rte_eb_field La sortie est le nom de classe résultant.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromNativeValue(native_id_in, class_in)

Ne renvoie pas la valeur d’une classe qui est plus élevée dans la hiérarchie des classes (une classe parente) que la classe d’entrée fournie. Par exemple, ne renvoie pas cmdb_ci_computer si l’entrée est cmdb_ci_server. Examine uniquement la hiérarchie des cmdb_ci_computer, en passant par cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, enfants de cmdb_ci_server).

Recherche actuellement les indicateurs Server, Windows Server et Linux Server dans l’identificateur natif.

Tableau 13. Exemples

Classe native	Classe	Résultats de la classe
Serveur Windows	cmdb_ci_computer	cmdb_ci_win_server
Serveur Microsoft	cmdb_ci_computer	cmdb_ci_win_server
Serveur Linux	cmdb_ci_computer	cmdb_ci_linux_server
Serveur Microsoft	cmdb_ci_server	cmdb_ci_win_server
Serveur Linux	cmdb_ci_server	cmdb_ci_linux_server
Serveur Red Hat	cmdb_ci_server	cmdb_ci_linux_server
Serveur Arch	cmdb_ci_server	cmdb_ci_linux_server
Serveur Centos	cmdb_ci_server	cmdb_ci_linux_server
Serveur Debian	cmdb_ci_server	cmdb_ci_linux_server
Serveur Fedora	cmdb_ci_server	cmdb_ci_linux_server
Serveur SUSE	cmdb_ci_server	cmdb_ci_linux_server
Serveur Oracle	cmdb_ci_server	cmdb_ci_linux_server
Serveur Rhel	cmdb_ci_server	cmdb_ci_linux_server
Serveur Ubuntu	cmdb_ci_server	cmdb_ci_linux_server
Courrier indésirable
	cmdb_ci_server	cmdb_ci_server
Serveur indésirable	cmdb_ci_computer	cmdb_ci_server
Courrier indésirable	cmdb_ci_computer	cmdb_ci_computer

Dériver la classe CI à partir du système d'exploitation

À utiliser lors du traitement d’un enregistrement d’ordinateur et un système d’exploitation est fourni, mais la classe de l’ordinateur est ambiguë dans le cas contraire. Peut être utilisé avec d’autres transformations de classe CI de dérivation.

Détails
Table	Dériver la classe de l’opération du système d’exploitation sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_derive_class_from_os_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Nom du système d’exploitation Le nom de classe actuel
Champ de sortie	target_sys_rte_eb_field La sortie est le nom de classe résultant.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromOsName(os_in, class_in)

Ne renvoie pas la valeur d’une classe qui est plus élevée dans la hiérarchie des classes (une classe parente) que la classe d’entrée fournie. Par exemple, ne renvoie pas cmdb_ci_computer si l’entrée est cmdb_ci_server. Examine uniquement la hiérarchie des cmdb_ci_computer, en passant par cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, enfants de cmdb_ci_server).

Recherche actuellement les indicateurs Server, Windows Server et Linux Server dans le nom du système d’exploitation.

Tableau 14. Exemples

Système d'exploitation	Classe	Résultats de la classe
Serveur Windows	cmdb_ci_computer	cmdb_ci_win_server
Serveur Microsoft	cmdb_ci_computer	cmdb_ci_win_server
Serveur Linux	cmdb_ci_computer	cmdb_ci_linux_server
Serveur Microsoft	cmdb_ci_server	cmdb_ci_win_server
Serveur Linux	cmdb_ci_server	cmdb_ci_linux_server
Serveur Red Hat	cmdb_ci_server	cmdb_ci_linux_server
Serveur Arch	cmdb_ci_server	cmdb_ci_linux_server
Serveur Centos	cmdb_ci_server	cmdb_ci_linux_server
Serveur Debian	cmdb_ci_server	cmdb_ci_linux_server
Serveur Fedora	cmdb_ci_server	cmdb_ci_linux_server
Serveur SUSE	cmdb_ci_server	cmdb_ci_linux_server
Serveur Oracle	cmdb_ci_server	cmdb_ci_linux_server
Serveur Rhel	cmdb_ci_server	cmdb_ci_linux_server
Serveur Ubuntu	cmdb_ci_server	cmdb_ci_linux_server
Courrier indésirable
	cmdb_ci_server	cmdb_ci_server
Serveur indésirable	cmdb_ci_computer	cmdb_ci_server
Courrier indésirable	cmdb_ci_computer	cmdb_ci_computer

Dériver le modèle virtuel à partir du modèle du matériel

À utiliser lors du traitement d’un enregistrement d’ordinateur qui peut être virtuel, un modèle matériel est fourni et l’état virtuel est ambigu. Peut être utilisé avec d’autres transformations Dériver le virtuel de.

Détails
Table	Dériver le virtuel de l’opération du modèle sur l’entité du moteur de transformation robuste [sn_cmdb_int_util_derive_virtual_from_model_operation]
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Nom du modèle de matériel Valeur actuelle du marqueur virtuel
Champ de sortie	target_sys_rte_eb_field La sortie est le marqueur virtuel obtenu (vrai/faux). Si le marqueur virtuel actuel est « vrai », le résultat est vrai. Sinon, le résultat est « vrai » ou « faux ».
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromModelName(model_in, is_virtual_in)

Recherche des indicateurs dans le nom du modèle d’un appareil virtuel (VMware).

Tableau 15. Exemples

Modèle de matériel	Marqueur virtuel	Résultats du marqueur virtuel
Thinkpad	VRAI	VRAI
Thinkpad	faux	faux
Thinkpad		faux
VMware Inc	VRAI	VRAI
	VRAI	VRAI
	faux	faux
		faux

Dériver un indicateur virtuel à partir d'un indicateur natif

À utiliser lors du traitement d’un enregistrement d’ordinateur qui peut être virtuel, un indicateur virtuel est fourni par la source et l’état virtuel est ambigu. Peut être utilisé avec d’autres transformations Dériver le virtuel de.

Détails
Table	sn_cmdb_int_util_derive_virtual_from_native_value_operation
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Indicateur natif Valeur actuelle du marqueur virtuel
Champ de sortie	target_sys_rte_eb_field La sortie est le marqueur virtuel obtenu (vrai/faux). Si le marqueur virtuel actuel est « vrai », le résultat est vrai. Sinon, le résultat est « vrai » ou « faux ».
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromNativeIdentifier(native_in, is_virtual_in)

Teste l’indicateur natif par rapport à une liste de valeurs communes et recherche un indicateur booléen « vrai ».

Tableau 16. Exemples

Valeur virtuelle native	Marqueur virtuel	Résultats du marqueur virtuel
virtuel	faux	VRAI
virtuel		VRAI
virtuel	VRAI	VRAI
o	faux	VRAI
o		VRAI
o	VRAI	VRAI
yes	faux	VRAI
yes		VRAI
yes	VRAI	VRAI
VRAI	Faux	VRAI
VRAI		VRAI
VRAI	VRAI	VRAI
T	faux	VRAI
T		VRAI
T	VRAI	VRAI
autre	faux	faux
autre		faux
autre	VRAI	VRAI
non virtuel	faux	faux
non virtuel		faux
non virtuel	VRAI	VRAI
	faux	faux
		faux
	VRAI	VRAI

Dériver un numéro virtuel à partir du numéro de série

À utiliser lors du traitement d’un enregistrement informatique qui peut être virtuel, un numéro de série est fourni par la source, et l’état virtuel est ambigu. Peut être utilisé avec d’autres transformations Dériver le virtuel de.

Détails
Table	sn_cmdb_int_util_derive_virtual_from_serial_number_operation
Champs d'entrée	source_sys_rte_eb_fields L’entrée dans l’ordre est : Le numéro de série Valeur actuelle du marqueur virtuel
Champ de sortie	target_sys_rte_eb_field La sortie est le marqueur virtuel obtenu (vrai/faux). Si le marqueur virtuel actuel est « vrai », le résultat est vrai. Sinon, le résultat est « vrai » ou « faux ».
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromSerialNumber (serial_in, is_virtual_in)

Recherche des indicateurs dans le numéro de série d’un appareil virtuel (VMware).

Tableau 17. Exemples

Numéro de série	Marqueur virtuel	Résultats du marqueur virtuel
123	VRAI	VRAI
123	faux	faux
123		faux
vmware-123	VRAI	VRAI
	VRAI	VRAI
	faux	faux
		faux

Extraire et mettre à l'échelle par unités

À utiliser lorsque la source a des valeurs numériques qui doivent être mises à l’échelle et une valeur numérique avec une entrée telle que 2 048 Mo. La source ne fournit pas toujours les unités, il peut donc être nécessaire de calculer ou de deviner les unités fournies. Les unités cibles dépendent du champ cible dans la CMDB. S’il n’est pas spécifié, le champ de décimale est défini sur 2 par défaut.

Remarque :

Ce champ est sensible à la casse.

Détails
Table	sn_cmdb_int_util_extract_and_scale_by_units_operation
Champs d'entrée	source_sys_rte_eb_fields
Champ de sortie	target_sys_rte_eb_field
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationExtractScaleUnitUtil().extractAndScaleUnits(input,defaultUnit,outputUnit,decimalPlaces)

Tableau 18. Exemples

Valeur d'entrée	Unité par défaut	Unité de sortie	Résultat
2048Mo	Mo	GB	2 Go
17179869184	B	GB	16GB

Première valeur non nulle

À utiliser lorsque vous avez une liste de champs fournissant des informations similaires qui doivent être mappés à un seul champ et que vous souhaitez classer l’ordre dans lequel ils peuvent fournir ces valeurs.

Par exemple, en interne dans SolarWinds, il existe une hiérarchie de tables qui sont jointes. Par exemple, le nom d’un ordinateur peut provenir de la table enfant most ou de l’un de ces parents de tables, mais chacun d’entre eux est un champ distinct dans la pull. En commençant par la table la plus spécifique, les valeurs sont recherchées pour la première instance d’une valeur de nom.

Détails
Table	sn_cmdb_int_util_first_non_null_operation
Champs d'entrée	source_sys_rte_eb_fields L’entrée est une liste de champs de n’importe quelle longueur.
Champ de sortie	target_sys_rte_eb_field La sortie est la valeur du premier champ de la liste qui n’a pas de valeur nulle (ou vide).
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationFirstNonNullValueUtil().firstNonNullValue(batch[i])

Tableau 19. Exemple

Champ 1	Champ 2	Champ 3	Résultat
	foo	foo2	foo

Nom du processus, domaine, FQDN, ensemble DNS

À utiliser lorsque la source fournit le nom, le domaine, le nom de domaine complet ou les informations DNS. Ne peut être utilisé que pour un sous-ensemble de ceux-ci (si, par exemple, la source ne fournit que le nom et le domaine). Dans le cas où une source ne fournit que les champs qui sont plus bas dans la liste d’entrée (FQDN), l’include de script CmdbIntegrationHardwareNameUtil peut être appelé à partir d’une opération de script pour minimiser la nécessité de créer des champs factices vides.

Détails
Table	sn_cmdb_int_util_process_name_set_operation
Champs d'entrée	source_sys_rte_eb_fields Utilise jusqu’à quatre champs d’entrée (tous les champs supplémentaires sont ignorés), dans l’ordre suivant : Nom Domaine FQDN DNS Vous n’avez pas besoin de fournir les quatre valeurs d’entrée, mais vous devez fournir ces valeurs dans l’ordre spécifié. Si, par exemple, vous souhaitez uniquement nettoyer un domaine, vous devez fournir un attribut name, même s’il est vide.
Champ de sortie	target_sys_rte_eb_field La sortie est un ensemble concaténé de valeurs dans le même ordre, à l’aide d’un triple tube (|||) : {name}|||{domaine}|||{fqdn}|||{dns}
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet(name, domain, fqdn, dns)

Le FQDN et le DNS sont d’abord traités pour voir si leurs formats sont corrects. Le nom de domaine complet a une regex de découverte supplémentaire qu’il doit transmettre (via les propriétés) : glide.discovery.fqdn.regex – par défaut : ^([^.]+)\\. ((?:[^.]+\\.)+[^.]+)$

Les valeurs de nom et de domaine possibles sont extraites si possible. Lorsque le nom et le domaine sont traités, s’il n’y a pas de nom de domaine complet, une valeur est générée si possible. Une valeur de nom résultante est également modifiée à l’aide des marqueurs de détection suivants :

1. glide.discovery.hostname.case : par défaut : aucun changement. Peut être défini sur « Minuscules », « Majuscule », « Pas de changement »
2. glide.discovery.hostname.include_domain : valeur par défaut : faux. Si « vrai », le domaine est ajouté à la valeur du nom final

Tableau 20. Exemples

Nom	Domaine	FQDN	DNS	Résultats
monNom	other.net	otherName.other.net	mycomp.servicenow.com	monNom|||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	nom|||servicenow.com|||name.servicenow.com|||name.servicenow.com
		name.servicenow.com		nom|||servicenow.com|||name.servicenow.com|||
		name.servicenow.com		nom|||servicenow.com|||name.servicenow.com|||
nom	servicenow.com			nom|||servicenow.com|||name.servicenow.com|||

FQDN du processus

À utiliser lorsque la source fournit une valeur suspectée de nom de domaine complet, mais pas d’autres champs de nommage tels que nom, domaine ou DNS.

Détails
Table	sn_cmdb_int_util_process_fqdn_operation
Champs d'entrée	source_sys_rte_eb_field L’entrée est un champ unique contenant un nom de domaine complet.
Champ de sortie	target_sys_rte_eb_field La sortie est un ensemble concaténé de valeurs dans le même ordre à l’aide d’un triple tube (|||) : {name}|||{domaine}|||{fqdn}|||{dns}
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet('’, '’, fqdn, '’)

Le traitement suit la même logique que la transformation « Nom du processus, domaine, FQDN, ensemble DNS », sauf que seul le FQDN est utilisé comme entrée.

Tableau 21. Exemple

Entrée	Résultat
mycomputer.servicenow.com	monordinateur|||servicenow.com|||mycomputer.servicenow.com|||

Unité d'échelle

À utiliser lorsque la source a des entrées numériques qui doivent être mises à l’échelle. La source ne fournit pas toujours les unités actuelles, il peut donc être nécessaire de calculer ou de deviner les unités fournies. Les unités cibles dépendent du champ ciblé dans la CMDB.

Détails
Table	sn_cmdb_int_util_scale_unit_operation
Champs d'entrée	source_sys_rte_eb_fields Les entrées dans l’ordre sont les suivantes : Valeur d’entrée Les unités actuelles Les unités cibles
Champ de sortie	target_sys_rte_eb_field La sortie est la valeur d’entrée mise à l’échelle des unités actuelles vers les unités cibles. Si aucune unité n’est trouvée pour les unités actuelles, la valeur d’entrée est renvoyée. Si aucune unité actuelle ou cible n’est trouvée, l’entrée est renvoyée comme sortie.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationScaleUnitUtil().scaleUnits(input_value, input_unit, output_unit)

Tableau 22. Exemple

Entrée	Résultat
Champ d’entrée 1:1 Champ d’entrée 2 : Go Champ d’entrée 3 : Mo	1024

Recherche d'ID de groupe de logiciels

À utiliser lorsqu’une source, telle que Jamf, ne fournit pas l’éditeur du logiciel, mais fournit un ID de groupe de logiciels Mac. Recherche d’ID de groupe de logiciels Recherche les enregistrements dans la table Recherche d’ID d’ensemble [sn-cmdb_int_util_bundleid_lookup] par bundle_id. Si un enregistrement avec la bundle_id spécifiée existe, il extrait l’éditeur du logiciel respectif. Sinon, il crée un nouvel enregistrement qui sera interrogé lors de la prochaine exécution de la source de données Rechercher les ID d’ensemble de logiciels Mac.

Détails
Table	sn_cmdb_int_util_software_bundle_id_lookup_operation
Champs d'entrée	source_sys_rte_eb_field Identifiant de groupe
Champ de sortie	target_sys_rte_eb_field La sortie est le nom de l’artiste, le nom de la piste et le nom du vendeur résultants, tous concaténés par une triple barre verticale (|||), ou une chaîne vide si aucune correspondance n’est trouvée.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationSoftwareBundleIdLookup. lookupSoftware(bundleId)

Tableau 23. Exemple

Entrée	Résultat
Champ d’entrée 1 : com.microsoft.Word	Microsoft Corporation|||Microsoft Word||| Microsoft Corporation

Recherche d'utilisateur

Utilisez cette option pour rechercher un utilisateur dans la table Utilisateur [sys_user] par nom d’utilisateur ou e-mail, en essayant de le faire correspondre dans l’ordre suivant :

1. Nom d’utilisateur correspondant à l’attribut user_name .
2. L’e-mail correspondant à l’attribut email.
3. Si rien ne correspond, il renvoie vide.

Détails
Table	sn_cmdb_int_util_user_lookup_operation
Champs d'entrée	source_sys_rte_eb_fields Les entrées dans l’ordre sont les suivantes : Nom d'utilisateur E-mail (facultatif)
Champ de sortie	target_sys_rte_eb_field sysId du sys_user.
Fonction Script Include	sn_cmdb_int_util.CmdbIntegrationUserLookup. lookupUser(username, email)

Tableau 24. Exemples

Entrée	Résultat
Champ d’entrée 1 : abel.tuter	Référence 62826bf03710200044e0bfc8bcbe5df1
Champ d’entrée 1 : utilisateur Champ d’entrée 2 : [e-mail]	Référence 62826bf03710200044e0bfc8bcbe5df1