Créer une carte de transformation ETL

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 43 minutes de lecture
  • Centre d’intégration ETL fournit une configuration guidée qui vous guide tout au long de l’achèvement de toutes les tâches nécessaires pour créer une carte de transformation ETL pour une intégration spécifique.

    Configuration guidée

    La configuration guidée organise toutes les tâches dans le bon ordre, suit leur achèvement et applique toutes les dépendances de tâches. Les tâches qui dépendent de l’achèvement d’autres tâches sont activées ou désactivées lorsque vous parcourez l’outil et que vous terminez les tâches.

    Utilisez la configuration guidée sur la page Assistant de carte de transformation ETL pour effectuer les tâches suivantes.

    Importez des données sources et spécifiez les détails de base.

    Fournissez des détails de base pour l’intégration, tels que la source des données que vous souhaitez intégrer dans CMDB, et importez les données sources.

    Avant de commencer

    La source de données que vous envisagez de sélectionner pour la carte de transformation ETL doit exister dans le même périmètre de l’application que celui utilisé dans la session actuelle.

    Lorsque vous ouvrez une carte de transformation ETL, la carte n’est par défaut pas validée. Vous pouvez activer cette étape de validation en ajoutant la propriété système sn_int_studio.validation.enabled à la table Propriétés système [sys_properties], puis en la définissant sur vrai. Une fois la validation terminée, vous choisissez comment gérer les erreurs de validation.

    Rôle requis : cmdb_inst_admin

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store. À partir de Centre d’intégration ETL v3.2, les intégrations sont regroupées par valeur CMDB Application , auquel cas développez le groupe respectif pour localiser une intégration.
    2. Cliquez sur le nom d’une intégration à afficher ou modifier, ou cliquez sur Créer.
      Si la propriété sn_int_studio.validation.enabled système est définie sur vrai, Centre d’intégration ETL valide la carte de transformation ETL que vous chargez. En cas d’erreurs de validation, la boîte de dialogue Données de mappage non valides détectées s’affiche, répertoriant toutes les erreurs spécifiques détectées. Vous pouvez choisir de supprimer les mappages non valides et de continuer avec uniquement les mappages valides, ou vous pouvez choisir de conserver les mappages non valides. Toutefois, les notifications concernant les mappages non valides continueront de s’afficher à mesure que vous continuerez à travailler avec l’intégration.
      Le système détecte des erreurs telles que :
      • Champs source ou cible manquants dans les enregistrements de mappages de champs du moteur de transformation robuste (RTE) correspondants
      • Colonnes de table manquantes dans un jeu d’importation
        Remarque :
        Dans ce cas, tous les enregistrements de métadonnées correspondants dans RTE ne sont plus valides et sont automatiquement supprimés. Les enregistrements tels que les mappages de champs et les opérations de transformation associés aux colonnes de table manquantes dans le jeu d’importation sont supprimés.
      • Règle de recherche IRE (Identification and Reconciliation Engine) manquante pour une classe de recherche
    3. Sur la page Assistant de carte de transformation ETL, dans la section Spécifier les détails de base de la configuration guidée, sélectionnez la tâche Importer les données sources et fournir les détails de base .
    4. Remplissez le formulaire.
      Champ Description
      Application CMDB

      Application CMDB associée à la carte de transformation ETL.

      Vous pouvez sélectionner Add new (Ajouter nouveau), qui ajoute les champs Application CMDB et Source de découverte pour la nouvelle application CMDB.

      Nom Nom de la carte de transformation ETL.
      Description Description de l’intégration.
      Source de données Liste de toutes les sources de données dans le système.
      Remarque :
      Soyez prudent lorsque vous modifiez ultérieurement la source de données, car elle peut entraîner des changements substantiels dans l’intégration des données. L’alignement sur la table d’ensembles de données à importer de la nouvelle source de données peut nécessiter la suppression de colonnes et de transformations associées, ou l’ajout de nouvelles colonnes. Les processus de validation ETL du Centre d’intégration détecteront toutes les mises à jour requises et vous permettront d’accepter ou de refuser ces mises à jour.
      Exemple de jeu d'importation

      Jeu d’importation associé à la source de données spécifiée.

      Un sous-ensemble de ces données de jeu d’importation est utilisé pour prévisualiser les données sources.

      Sélectionnez l’option Extraire automatiquement un nouveau jeu d’importation pour extraire un nouveau jeu d’importation de la source de données associée.

      À partir de Centre d’intégration ETL v3.2, si aucun jeu d’importation n’est spécifié, la carte est chargée et est automatiquement définie pour être en mode lecture seule. Vous pouvez examiner les configurations dans la carte, mais vous ne pouvez pas modifier les mappages ou les transformations.

      Prévisualiser le remplacement de taille

      Nombre d’enregistrements de données qui sont chargés et utilisés comme échantillon pour l’aperçu de cette carte de transformation. Si défini, ce paramètre personnalisé remplace la valeur de la sn_int_studio.preview.size propriété système et s’applique uniquement à la carte de transformation actuelle.

      Si l’option Charger le schéma complet est désactivée, la structure des données imbriquées pour la carte est générée uniquement en fonction du nombre spécifié d’enregistrements chargés.

      Champ disponible à partir du Centre d’intégration ETL v3.2.

      Charger le schéma complet

      Activez ou désactivez le chargement de l’intégralité du schéma de données pour générer la structure de données pour la carte.

      Lorsque cette option est désactivée, la structure des données imbriquées pour la carte est générée uniquement en fonction du nombre d’enregistrements chargés en tant qu’exemples d’enregistrements pour l’aperçu. Le nombre d’enregistrements chargés est déterminé soit par le paramètre Prévisualiser le remplacement de taille , soit par la propriété sn_int_studio.preview.sizesystème globale.

      Champ disponible à partir du Centre d’intégration ETL v3.2.

      Application CMDB Nom d’une nouvelle application CMDB. S’affiche si vous définissez l’application CMDB sur Ajouter nouveau.
      Source de découverte

      Source de découverte associée à une nouvelle application CMDB. S’affiche si vous définissez l’application CMDB sur Ajouter nouveau.

    5. Cliquez sur Enregistrer pour enregistrer les modifications actuelles ou sur Marquer comme terminé.

      Un horodatage apparaît dans l’en-tête lorsque vous cliquez sur Enregistrer, qui reste pendant la durée de la session ETL du Centre d’intégration pour la carte de transformation ETL. Lorsque vous entrez à nouveau dans la session ou que vous passez d’une carte ETL à l’autre, l’horodatage disparaît.

    Prévisualiser et préparer les données

    Examinez des exemples d’enregistrements de données sources brutes, qui seront intégrées à la CMDB. Transformez et préparez les données pour qu’elles soient alignées sur les classes et attributs cibles, si nécessaire.

    Avant de commencer

    Le nombre d’enregistrements dans les exemples de données est globalement déterminé par la propriété sn_int_studio.preview.sizesystème , qui est définie par défaut sur 100. Le nombre maximal d’enregistrements dans les exemples de données qu’IntegrationHub ETL peut traiter est de 10 000. Si vous définissez cette propriété au-dessus de la limite de 10 000, Centre d’intégration ETL ne traite que 10 000 enregistrements maximum et un message s’affiche à cet effet.

    À partir de Centre d’intégration ETL v3.2, vous pouvez remplacer la valeur de la sn_int_studio.preview.size propriété en définissant le champ Prévisualiser le remplacement de taille sur le formulaire Importer les données sources et fournir les détails de base, par carte.

    Pour traiter les données imbriquées à partir d’une charge utile imbriquée, la source de données respective doit être définie avec l’option Données en colonne unique .

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Passez en revue les valeurs des colonnes de données des exemples de données et identifiez les colonnes qui ne correspondent pas aux exigences des classes et attributs cibles prévus. Vous pouvez transformer les données, par exemple, en convertissant le format des données, en remplaçant des valeurs et en concaténant des colonnes de données. Vous pouvez appliquer des transformations les unes sur les autres, créant ainsi une chaîne de transformations de données. Vous pouvez également définir une colonne de données à ignorer dans le processus de mappage et d’intégration.
    Remarque :
    Pour définir un attribut CMDB comme vide, utilisez la chaîne « < EMPTYֹ_STRING> ».

    Les colonnes de données imbriquées s’affichent à côté du reste des données, avec une notation Nested Objects (Objets imbriqués ) dans l’en-tête de colonne de données. Le nombre d’éléments de données imbriqués par objet s’affiche avec un lien qui vous permet d’accéder à des niveaux plus profonds des données imbriquées. Pour afficher la structure des données imbriquées dans un panneau distinct, activez l’option Afficher la structure des données .

    Le panneau Structure des données dispose de deux options pour afficher les données imbriquées :

    • Arborescence : données imbriquées regroupées par objets, où chaque nœud d’objet correspond à une entrée d’enregistrement dans les données sources. Développez les nœuds d’objets pour afficher toutes les données imbriquées pour l’enregistrement.
    • Collection : données imbriquées regroupées par objet de niveau supérieur (par défaut), puis par éléments de données imbriqués tels que les logiciels. Développez un nœud, tel qu’un logiciel, pour indiquer quel logiciel est installé sur chaque ordinateur.
    Vous pouvez parcourir les niveaux de données imbriquées dans le panneau Structure des données, le chemin d’accès aux fils d’Ariane ou les liens numériques qui apparaissent dans les données sources elles-mêmes. Vos sélections et les données qui s’affichent sont synchronisées entre toutes les vues des données imbriquées, quelle que soit la navigation.

    Pour une démonstration sur l’utilisation des données de charge utile imbriquées, regardez la vidéo de démonstration de la fonctionnalité de charge utile imbriquée Centre d’intégration - ETL sur la chaîne YouTube ServiceNow.

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL, puis cliquez sur le nom d’une intégration.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store.
    2. Sur la page Assistant de carte de transformation ETL, dans la section Préparer les données sources au mappage de la configuration guidée, sélectionnez Prévisualiser et préparer les données.
    3. Facultatif : Sélectionnez Afficher la structure des données pour ouvrir le panneau Structure des données qui affiche la structure des données imbriquées. Dans le panneau Structure des données, vous pouvez explorer les niveaux des données imbriquées.
    4. Facultatif : Sélectionnez le menu d’action d’une colonne, puis sélectionnez une opération de tri.
    5. Sélectionnez le menu d’action d’une colonne, puis sélectionnez Grouper par pour regrouper les données par colonne respective. Sélectionnez Dissocier pour annuler l’opération de regroupement.
    6. Facultatif : Cliquez sur Nouvelle transformation , puis sélectionnez Utiliser la colonne source . Vous pouvez également sélectionner le menu d’action d’une colonne, puis sélectionner Nouvelle transformation pour transformer la colonne sélectionnée.

      Vous ne pouvez pas créer de nouvelles transformations pour les objets imbriqués dans cette vue de niveau supérieur des données. Une colonne d’objet imbriqué contient des liens numériques qui indiquent le nombre d’éléments imbriqués pour l’enregistrement. Pour créer une transformation pour les objets imbriqués, cliquez sur ce lien numérique pour explorer les données imbriquées réelles. Vous pouvez également naviguer dans le panneau Structure des données jusqu’à l’objet imbriqué pour lequel vous souhaitez créer une transformation.

      Une transformation de données imbriquées peut référencer des objets parents des données imbriquées en cours de transformation. En prenant l’exemple de payload pour les données imbriquées comme exemple, une transformation pour un objet d’interface peut référencer l’objet de l’ordinateur parent, mais ne peut pas référencer un objet logiciel.

      1. Dans la barre latérale Nouvelle transformation à droite, sélectionnez un type de transformation et modifiez la description de la transformation le cas échéant.
        Pour en savoir plus sur les types de transformation, reportez-vous à la section Types de transformation dans Centre d’intégration ETL.
      2. Facultatif : Sélectionnez Hide initial column used for this transform (Masquer la colonne initiale utilisée pour cette transformation ) afin de masquer de la vue actuelle toutes les colonnes qui ont été utilisées pour cette transformation.
        Ce paramètre est temporaire pour la session en cours. Si vous actualisez la page, la colonne masquée réapparaît. Pour afficher une colonne masquée, vous pouvez également cliquer sur l’icône d’engrenage sur le cadre de la bannière. Ensuite, déplacez la colonne masquée de la liste Disponible vers la liste Sélectionné et cliquez sur OK.
      3. Sélectionnez ou vérifiez la colonne d’entrée dont les valeurs sont en cours de transformation.
      4. Facultatif : Modifiez le nom de la colonne de sortie pour l’une des colonnes qui seront ajoutées avec les valeurs transformées.
      5. Cliquez sur Appliquer.
        Une nouvelle colonne avec les valeurs transformées apparaît, classée par ordre alphabétique en fonction du nom de la colonne de sortie. Si vous avez utilisé le nom de colonne de sortie suggéré, la nouvelle colonne apparaît à droite de la colonne d’entrée.
      6. Examinez les données transformées et ajustez les transformations, si nécessaire.
    7. Facultatif : Pour appliquer la transformation « Définir la colonne de valeurs fixes » :
      1. Cliquez sur Nouvelle transformation , puis sélectionnez Définir la colonne de valeurs fixes.
      2. Dans la barre latérale Définir la colonne de valeurs fixes, entrez un nom de colonne et une description de colonne pour la nouvelle colonne. Ensuite, définissez Affecter la valeur de colonne sur la valeur fixée pour la nouvelle colonne.
      3. Cliquez sur Appliquer.
    8. Facultatif : Sélectionnez le menu d’action d’une colonne, puis sélectionnez Ignorer dans le mappage pour exclure la colonne du mappage et de l’intégration dans la session actuelle.

      Dans une session ultérieure, le paramètre Ignorer dans le mappage ne s’applique pas et la colonne sera incluse dans le mappage.

      Vous pouvez cliquer sur Inclure dans le mappage pour annuler le paramètre Ignorer dans le mappage pour la colonne.

    9. Facultatif : Sélectionnez le menu d’actions d’une colonne, puis sélectionnez Supprimer cette colonne et les colonnes en aval. Cette action de suppression supprime la colonne ainsi que toutes les colonnes ajoutées à l’aide de cette colonne comme colonne d’entrée.
    10. Facultatif : Cliquez sur Nouvelle transformation , puis sélectionnez Recherche de table , qui vous permet de spécifier une table à rechercher et à extraire des valeurs supplémentaires. Renseignez les champs de la barre latérale de recherche de table à droite.
      Les valeurs de la table de recherche spécifiée correspondent aux données mappées. Pour les enregistrements correspondants, les valeurs spécifiées à partir de la table de recherche sont ajoutées en tant que colonne aux données en cours de préparation pour le mappage.
      Tableau 1. Recherche dans la table
      Champ Description
      Table de recherche Table à utiliser pour la correspondance avec les données en cours de mappage. Lorsque les enregistrements de la table de recherche et les données mappées satisfont à la condition de recherche, les valeurs spécifiées de la table de recherche sont extraites de l’enregistrement respectif et ajoutées aux données mappées.
      Condition de recherche

      Ensemble de paires de conditions de colonne. Chaque paire spécifie une colonne dans la table de recherche et une colonne dans les données mappées, qui tentent d’être mises en correspondance.

      • Si les valeurs de la colonne de table cible : la colonne de la table cible à associer à une colonne des données mappées.
      • Valeurs de correspondance de la table de données source : colonne des données mappées à associer à une colonne de la table de recherche.

      Vous pouvez ajouter plusieurs paires de colonnes à faire correspondre.

      Condition de recherche

      Valeurs à extraire de la table de recherche lorsqu’il existe une correspondance avec les données mappées.

      Ensuite, les valeurs de sortie des colonnes suivantes : Colonnes de table de recherche à partir desquelles extraire les valeurs, lorsque les valeurs de la table de recherche et des données mappées satisfont à la condition de recherche.

      Vous pouvez spécifier plusieurs colonnes de table de recherche dont extraire les valeurs. Pour chaque colonne que vous spécifiez, un champ Nom de colonne de sortie correspondant s’affiche automatiquement. Spécifiez une étiquette pour la colonne qui sera ajoutée avec les valeurs extraites.

      Nom de la colonne de sortie

      Une étiquette pour la colonne qui sera ajoutée aux données mappées, avec les valeurs extraites de la table de recherche.

      Un champ Nom de colonne de sortie est automatiquement ajouté pour chaque colonne que vous spécifiez dans Puis les valeurs de sortie des colonnes suivantes.

    11. Examinez les données et assurez-vous que l’ensemble de données à intégrer est transformé, correctement formaté et préparé pour l’importation.
    12. Cliquez sur Marquer comme terminé.

    Résultats

    Les données sont préparées lorsque l’ensemble des colonnes de données sources et des colonnes transformées que vous souhaitez intégrer répond aux exigences de formatage et autres exigences de valeur des classes et attributs CMDB cibles. Ces colonnes sont ensuite prêtes à être mappées et intégrées aux classes et attributs CMDB.

    À propos du mappage des colonnes de données aux classes et attributs CMDB

    Il existe plusieurs exigences et directives pour le mappage des données sources aux classes et attributs CMDB cibles. En outre, il est possible de désactiver les mappages de classe tout en préservant les paramètres pour une réactivation facile. Passez en revue ces concepts pour assurer un traitement approprié par le moteur Identification et réconciliation (IRE).

    Mappages requis

    Vous devez mapper les données à tous les attributs requis de la classe cible, en plus du mappage aux attributs qui ne sont pas configurés comme requis. En outre, les deux champs suivants s’affichent par défaut et vous ne pouvez pas les supprimer :
    Clé native de la source
    IRE est utilisé pour identifier de façon unique un enregistrement et pour établir des relations et des références. Améliore également les performances des opérations d’insertion et de mise à jour. Lors du traitement d’une charge utile, IRE génère une erreur si ce champ est vide.
    Horodatage de la récence de la source

    IRE permet d’identifier les enregistrements plus anciens que l’enregistrement actuel et qui peuvent donc être ignorés, afin de résoudre les valeurs d’attribut en conflit. Si une valeur est fournie, elle n’est utilisée que si elle est ultérieure à la valeur actuellement stockée dans la CMDB. Si aucune valeur n’est fournie, IRE met à jour l’attribut avec l’horodatage actuel.

    Les propriétés système suivantes vous permettent de modifier la façon dont IRE utilise la valeur d’une source_recency_timestamp charge utile pour mettre à jour l’attribut last_scan dans la table Source [sys_object_source] :
    Pour plus d’informations sur l’utilisation et l’identification des CI par IRE, consultez Moteur d’identification et de rapprochement (IRE).source_recency_timestampsource_native_key

    Classe conditionnelle

    Une classe conditionnelle vous permet de mapper différents ensembles d’enregistrements de données à différentes classes cibles en fonction de valeurs de colonne spécifiques ou de l’état d’un module d’extension spécifique.

    Par exemple, si un nom d’affichage contient « Windows », « Windows Server » est sélectionné comme classe cible. Mais si le nom d’affichage contient « Linux », « Serveur Linux » est sélectionné comme classe cible. Pour les enregistrements qui ne répondent à aucune de ces conditions (le nom d’affichage ne contient ni « Windows » ni « Linux »), « Serveur » est sélectionné comme classe cible.

    Classe associée

    Une classe associée vous permet de sélectionner la classe CMDB à associer à une table non CMDB cible. La définition d’une classe associée est requise pour le traitement IRE si la table non CMDB n’est pas configurée pour le traitement IRE. Pour une table non CMDB prise en charge et configurée pour le traitement IRE, la définition d’une classe associée est facultative. Consultez la section Prise en charge IRE pour les tables non-CMDB pour plus d’informations.

    L’instance logicielle est une classe non-CMDB, mais aucune règle IRE ne lui est associée. Donc, les choses que nous avons dites à ce sujet ici avant l’Utah sont toujours valables. Cependant, pour les classes non-CMDB avec règles IRE, il n’est pas obligatoire d’avoir une association. Par exemple, « si la classe cible pour le mappage est une classe non CMDB avec une référence à une classe CMDB, vous devez sélectionner la classe CMDB à laquelle associer la classe cible non CMDB » Classe non CMDB avec règles IRE Au lieu de « vous devez », cela devrait être. « Tu peux ». Idem pour l’exemple, il n’est pas valide pour les non-CMDB avec règles IRE.

    Si la classe cible pour le mappage est une classe non CMDB avec une référence à une classe CMDB, vous devez sélectionner la classe CMDB à laquelle associer la classe cible non CMDB. Une classe non CMDB fait référence à une classe, par exemple le numéro de série [cmdb_serial_number], qui n’étend pas la classe Configuration Item (Élément de configuration) [cmdb_ci]. La classe Entrée connexe [cmdb_related_entry] peut contenir plusieurs associations de classes CMDB pour la même classe non CMDB. Par conséquent, sélectionnez l’association appropriée pour permettre aux processus IRE de mettre à jour la classe non CMDB cible.

    Par exemple, la classe Entrée connexe [cmdb_related_entry] comporte un enregistrement qui associe la classe Instance logicielle [cmdb_software_instance] non CMDB à la classe Package logiciel CMDB [cmdb_ci_spkg]. Si vous sélectionnez Instance logicielle comme classe cible, vous devez associer la classe Instance logicielle à la classe Package logiciel [cmdb_ci_spkg].

    Désactivation des mappages de classes

    Lorsque vous modifiez une carte de transformation ETL, fournie par un connecteur du graphe de services par exemple, vous pouvez supprimer un mappage de classe pour empêcher le remplissage de la classe lors de l’exécution de l’intégration. Toutefois, si vous décidez ultérieurement de renseigner cette classe, vous devez la rajouter et reconfigurer tous les mappages de classes. Au lieu de cela, vous pouvez désactiver un mappage de classe pour ignorer temporairement la classe pendant l’exécution de l’intégration, tout en conservant toute sa configuration de mappage. Une classe que vous choisissez de désactiver est grisée dans l’interface utilisateur, mais vous pouvez continuer et modifier les mappages de classes. Vous pouvez réactiver ultérieurement un mappage de classe pour permettre de remplir la classe, sans avoir besoin de reconfigurer les mappages de classe.

    Certaines classes que vous choisissez de désactiver déclenchent la désactivation automatique des classes supplémentaires que vous n’avez pas directement choisi de désactiver. Les classes automatiquement désactivées dépendent de la classe que vous avez choisie de désactiver. Par exemple, si la classe a des relations dépendantes ou des classes associées. Les classes désactivées automatiquement :
    • Apparaissent en gris clair dans l’interface utilisateur et vous ne pouvez pas les réactiver.
    • Sont automatiquement réactivés lorsque vous réactivez :
      • Classe que vous avez initialement désactivée et qui a déclenché la désactivation automatique
      • Toutes les classes dont dépend la classe désactivée

    Toutes les classes pour lesquelles vous désactivez directement les mappages et les mappages de classes qui en résultent et qui sont automatiquement désactivés ne sont pas renseignés lorsque l’intégration s’exécute. En outre, les relations et les tables de recherche associées à ces classes ne sont pas renseignées lors de l’exécution de l’intégration.

    Mappage de classe et autres scénarios de désactivation :
    • Désactivez une classe dont aucune classe ne dépend et qui n’a aucune classe associée :

      Déclenche la désactivation automatique de toutes les règles de recherche et relations associées à la classe désactivée.

    • Désactivez une règle de recherche, telle qu’un numéro de série, dans un mappage de classes :

      Ne déclenche aucune désactivation automatique.

    • Désactivez une classe CMDB associée à une classe non CMDB :
      • Déclenche une désactivation automatique de la classe non CMDB associée.
      • La désactivation de la classe non CMDB n’a pas d’impact sur la classe CMDB associée.
    • Désactiver une classe avec des relations dépendantes (s’applique uniquement si la relation dépendante existe dans Centre d’intégration ETL) :
      • Déclenche la désactivation automatique de toute classe qui a une seule relation dépendante avec la classe désactivée.
      • Si une classe comporte plusieurs relations dépendantes, elle n’est automatiquement désactivée que lorsque vous désactivez toutes les classes dépendantes.

        Par exemple, un scénario dans lequel la classe File System a des relations dépendantes avec la classe Computer et une classe Server (Ordinateur) et une classe Server (Serveur). Si vous désactivez la classe Computer (Ordinateur), la classe File System (Système de fichiers) n’est pas automatiquement désactivée. Si vous désactivez également la classe Server, la classe File System (Système de fichiers) est automatiquement désactivée.

    • Désactivez une classe conditionnelle ou un mappage de classe au sein d’une classe conditionnelle :
      • La désactivation ou l’activation d’une classe conditionnelle déclenche une désactivation ou une activation automatique de tous les mappages de classe conditionnelle au sein de la classe conditionnelle.
      • Désactivation d’un mappage de classe au sein d’une classe conditionnelle : empêche le remplissage de la classe désactivée lors des exécutions d’intégration. Toutefois, les conditions associées « Si », « Sinon si » ou « Sinon » restent elles-mêmes en vigueur dans la condition de la classe conditionnelle. Par exemple, si vous désactivez le mappage de classe suivant :

        [Si] [operating_system] [contient] [Linux] Alors [Class] [is] [Linux Server].

        Ensuite, la classe Linux Server n’est pas renseignée, mais la condition [If] [operating_system] [contains] [Linux] est en vigueur.

    Mapper les colonnes de données aux classes et attributs CMDB

    Choisissez les classes et attributs cibles dans le CMDB pour mapper les colonnes de données sources. Vous pouvez mapper une colonne de données à une classe cible spécifique ou ajouter des conditions de sorte que le choix de la classe cible dépende de valeurs de données spécifiques.

    Avant de commencer

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Les colonnes de données que vous mappez peuvent être soit des colonnes de données sources qui n’ont pas été transformées, soit des colonnes de données transformées. Par exemple, pour intégrer une colonne de données dans les classes Computer (Ordinateur) et Software Package (Package logiciel), sélectionnez ces classes en tant que classes cibles, puis mappez les colonnes de données dans des attributs spécifiques de ces classes.

    Lorsque vous configurez le mappage d’une classe, d’une relation ou d’une règle de recherche, ces éléments sont toujours initialement définis comme activés. Pour plus de détails sur les résultats de la désactivation des mappages, consultez Désactivation des mappages de classe.

    Remarque :
    La modification d’une classe impacte tous les mappages déjà configurés pour la classe, et parfois la suppression de ces mappages. Les détails sur les mappages affectés et l’impact s’affichent dans la boîte de dialogue Mappages affectés avant de procéder au changement de classe. Toutefois, ces détails n’apparaissent que lorsque le changement concerne le changement d’une classe CMDB vers une autre classe CMDB ou d’une classe non CMDB vers une autre classe non CMDB.

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL, puis cliquez sur le nom d’une intégration.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store.
    2. Sur la page Assistant de carte de transformation ETL, dans la section Mapper les données au CMDB et Ajouter des relations de la configuration guidée, sélectionnez Sélectionner des classes CMDB pour mapper des données sources.
      Les attributs configurés selon les besoins de la plateforme sont notés et vous devez mapper une colonne de données à chacun d’eux.
    3. Cliquez sur Ajouter une classe pour ajouter une classe cible vers laquelle effectuer le mappage, ou cliquez sur Modifier la classe pour modifier une classe.
      1. Dans la boîte de dialogue Ajouter une classe, sélectionnez une classe CMDB.
      2. Cliquez sur Enregistrer.
      3. Facultatif : Activez ou désactivez le commutateur Activer/désactiver le mappage d’une classe. Si la boîte de dialogue Mappages de classes affectés s’affiche, passez en revue la liste des classes affectées, puis cliquez sur Continuer.
        Lorsque vous ajoutez une classe non CMDB, elle est initialement désactivée et le commutateur Activer/désactiver le mappage est désactivé, jusqu’à ce que vous ajoutiez une classe associée active.
    4. Cliquez sur Ajouter une classe conditionnelle , puis dans la boîte de dialogue Ajouter une classe conditionnelle , spécifiez les conditions qui doivent être remplies pour que les données soient mappées sur différentes classes cibles.
      1. La collection est automatiquement définie sur la branche de données de la hiérarchie associée à l’attribut de niveau inférieur. Vous pouvez modifier la valeur de la branche de données à partir de laquelle vous souhaitez mapper les données, qui doit se trouver à un niveau supérieur dans la même branche de données de la hiérarchie.
      2. Dans la liste déroulante Si , sélectionnez les conditions d’attribut que les valeurs de données doivent remplir ou saisissez des modules d’extension dans la zone de recherche et spécifiez une condition de module d’extension. Vous pouvez ensuite spécifier que les enregistrements restants, qui ne correspondent à aucune condition, sont mappés à une classe cible encore différente. Les enregistrements de données sont mappés à différentes classes cibles en fonction des conditions remplies.

        Lors du traitement des données imbriquées, un préfixe désigne le premier niveau de la hiérarchie imbriquée pour les éléments d’attribut.

        Remarque :
        Lorsque vous sélectionnez une classe non CMDB, elle est initialement désactivée et le commutateur Activer/désactiver le mappage est désactivé, jusqu’à ce que vous ajoutiez une classe associée active.
      3. Cliquez sur Enregistrer.
      4. Facultatif : Activez ou désactivez le commutateur Activer/désactiver le mappage pour une classe conditionnelle. Si la boîte de dialogue Mappages de classes affectés s’affiche, passez en revue la liste des classes affectées, puis cliquez sur Continuer.
      5. Facultatif : Cliquez sur Modifier la classe pour modifier les paramètres d’une classe conditionnelle. Dans la boîte de dialogue Modifier la classe conditionnelle, définissez le commutateur Activer/désactiver le mappage pour un mappage de classe sur activé ou désactivé. Cliquez sur Enregistrer et, si la boîte de dialogue Mappages de classes affectés s’affiche, passez en revue la liste des classes affectées, puis cliquez sur Continuer.
        • Une classe désactivée n’est pas remplie pendant les exécutions d’intégration, cependant, cela n’affecte pas la condition associée. Les conditions « Si », « Sinon si » et « Sinon » elles-mêmes restent en vigueur dans la condition de la classe conditionnelle et les CI correspondants sont filtrés en conséquence.
        • Le commutateur de la classe conditionnelle reflète le résumé des états de tous les mappages de classe conditionnelle au sein de la classe conditionnelle. Si au moins un des mappages de classes conditionnelles est activé, le commutateur de la classe conditionnelle apparaît comme activé. Sinon, le commutateur de la classe conditionnelle apparaît comme désactivé.
    5. Pour une classe non CMDB, cliquez sur Ajouter une classe associée pour associer la classe non CMDB à une classe CMDB et pour activer le commutateur Activer/désactiver le mappage. Sinon, cliquez sur Modifier la classe associée pour modifier une classe déjà associée.
      1. Dans la boîte de dialogue Ajouter une classe associée, sélectionnez une classe CMDB. La liste inclut toutes les entrées de la classe Entrée connexe [cmdb_related_entry] pour la table non CMDB spécifiée (les classes désactivées ne sont pas incluses).
      2. Cliquez sur Ajouter.
      3. Facultatif : Activez ou désactivez le commutateur Activer/désactiver le mappage d’une classe associée.
        Remarque :
        Si une classe associée n’a pas été ajoutée ou est désactivée, le commutateur Activer/désactiver le mappage est désactivé.
    6. Cliquez sur Configurer le mappage pour configurer le mappage d’une classe nouvellement ajoutée, ou cliquez sur Modifier le mappage pour modifier un mappage.
      1. Pour mapper, faites glisser les colonnes de données de la barre latérale de données à droite vers l’attribut cible CMDB sur le côté gauche de la page de mappage. Vous pouvez également cliquer sur l’icône Sélectionner une colonne dans Centre d’intégration ETL. pour rechercher et sélectionner des colonnes de données pour le mappage.
        Lors du mappage de données imbriquées :
        • Les colonnes de données de la barre latérale de données s’affichent sous la forme d’une arborescence qui représente la structure des données imbriquées. Chaque attribut est associé à des exemples de données pour l’attribut.
        • Les colonnes transformées sont signalées par un point cyan.
        • Tous les mappages à une classe CMDB spécifique doivent provenir de la même branche source dans les données imbriquées. Seule la branche à partir de laquelle vous avez sélectionné la première colonne à mapper est valide pour sélectionner des colonnes dans les mappages suivants.

          Cette restriction s’applique différemment lors du mappage à des attributs dans des tables de recherche. Tous les mappages aux attributs d’une table de recherche doivent également provenir de la même branche source. Toutefois, cette branche source peut être différente de la branche source que vous avez utilisée avec les tables sans recherche.

          Remarque :
          Vous pouvez contourner cette restriction en utilisant la transformation Copier de l’étape de préparation des données, pour copier des attributs d’un niveau parent vers un niveau enfant. Préparez les données de manière à ce que tous les attributs que vous souhaitez mapper soient au même niveau.
        • Lorsque vous faites glisser une colonne à mapper à partir de la barre latérale de données, les champs des attributs cibles CMDB qui sont valides pour le mappage sont mis en surbrillance par un cadre vert. Si vous tentez de supprimer une colonne dans un attribut cible non valide, le champ respectif est mis en surbrillance par un cadre rouge et une erreur s’affiche.
      2. Cliquez sur Ajouter un attribut. Ensuite, dans la boîte de dialogue Ajouter un attribut, dans la liste Attribut, sélectionnez un ou plusieurs éléments comme attributs cibles auxquels mapper les données. Vous pouvez également faire défiler la page vers le bas jusqu’à la section Paramètres IRE de la liste et sélectionner l’une des propriétés du transformateur d’ensemble d’importation robuste . Cliquez sur Enregistrer.
        Pour plus d’informations sur l’ordre de priorité entre les propriétés du transformateur d’ensemble d’importation robuste définies au niveau de l’élément individuel et au niveau de la charge utile IRE, consultez Propriétés du transformateur d’ensemble d’importation robuste .
      3. Mappez toutes les règles de recherche telles que la règle « Recherche du numéro de série 1 ».

        Les règles de recherche sont dans un état désactivé jusqu’à ce que vous les mappiez. Cliquez sur l’icône de filtre de la règle de recherche pour modifier ou ajouter des filtres de recherche. Dans la boîte de dialogue Filtre de recherche, spécifiez les conditions d’attribut ou de module d’extension qui doivent être remplies pour que les données soient mappées aux différentes classes cibles. Cliquez ensuite sur Enregistrer.

        Après avoir mappé un champ d’une règle de recherche, vous pouvez activer ou désactiver le commutateur Activer/désactiver une règle de recherche pour une règle.

      4. Facultatif : Cliquez sur Afficher les détails de la classe pour afficher la classe actuelle dans Gestionnaire de classe de CI.
      5. Facultatif : Cliquez sur l’onglet Transformer les données pour accéder à la page Préparation des données où vous pouvez examiner et transformer davantage les données que vous souhaitez mapper.
      6. Revenez à la page Sélectionner des classes CMDB pour mapper des données sources.
    7. Cliquez sur Marquer comme terminé.

    Ajouter des relations

    Ajoutez des relations qui existent entre les classes CMDB cibles, pour une intégration.

    Avant de commencer

    • La classe que vous souhaitez ajouter à la relation doit être à l’état activé.
    • Une relation de base ou une relation au sein d’une relation conditionnelle que vous souhaitez modifier doit avoir l’état activé.
    • Dans une relation conditionnelle que vous souhaitez modifier, au moins une condition de relation doit avoir l’état Activé. Sinon, le bouton Modifier la relation est grisé.

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Lors de la création de relations avec des données imbriquées, vous ne pouvez pas créer de relation entre des objets frères et sœurs à partir des données imbriquées. En utilisant l’exemple de charge utile pour les données imbriquées comme exemple, vous ne pouvez pas créer de relation entre les interfaces et le logiciel.

    Visibilité ITOM, le cas échéant, utilise des modèles de détection améliorés pour identifier et ajouter des relations CI à la table Relations suggérées dans le système de base. Le cas échéant, utilisez la table Relations suggérées pour sélectionner les relations conformes aux Modèle de données de services de base normes (CSDM).

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL, puis cliquez sur le nom d’une intégration.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store.
    2. Sur la page Assistant de carte de transformation ETL, dans la section Mapper les données au CMDB et Ajouter des relations de la configuration guidée, sélectionnez Ajouter des relations.
    3. Pour ajouter des relations, sélectionnez Ajouter une relation ou Ajouter une relation conditionnelle si vous souhaitez spécifier les conditions d’attribut qui doivent être remplies avant d’ajouter une relation. Ensuite, effectuez les actions suivantes selon les besoins.
      OptionDescription
      Ajouter une relation
      1. Sélectionnez les valeurs Parent, Enfant et Type de relation .
      2. Cliquez sur Ajouter.
      Ajouter une relation conditionnelle
      1. Dans la liste Choisir un champ , sélectionnez les conditions d’attribut que les valeurs de données doivent remplir.
      2. Sélectionnez les valeurs Parent, Enfant et Type de relation .
      3. Cliquez sur Enregistrer.

      Lors du traitement des données imbriquées, un préfixe désigne le premier niveau de la hiérarchie imbriquée pour les éléments d’attribut.

      Le menu de liste Type de relation change en fonction de la classe parent et enfant sélectionnée :
      • S’il existe une relation dépendante, la liste est désactivée et le type de relation est automatiquement renseigné.
      • S’il existe plusieurs relations dépendantes, la liste affiche les options de relation d’imbrication et d’hébergement, et le type de relation d’imbrication est automatiquement renseigné.
      • S’il n’y a pas de relation dépendante, la liste affiche les relations suggérées , la première relation suggérée étant automatiquement sélectionnée, suivie des types de relations du système de base.
      • S’il n’y a aucune relation suggérée, la liste affiche Aucune relation suggérée , suivie par les types de relations du système de base.
    4. Cliquez sur Enregistrer pour enregistrer les modifications actuelles ou sur Marquer comme terminé.

      Un horodatage apparaît dans l’en-tête lorsque vous cliquez sur Enregistrer, qui reste pendant la durée de la session ETL du concentrateur d’intégration pour la carte de transformation ETL. Lorsque vous entrez à nouveau dans la session ou que vous passez d’une carte ETL à l’autre, l’horodatage disparaît.

    Prévisualiser les résultats du mappage

    Prévisualisez les résultats de l’intégration des exemples de données.

    Avant de commencer

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Exécutez un test d’intégration et affichez un résumé des résultats pour les exemples de données (par défaut, jusqu’à 100 enregistrements). Le résumé comprend le nombre total de relations créées, les classes mappées, les charges utiles partielles et incomplètes qu’IRE n’a pas pu traiter. Vous pouvez également afficher des messages détaillés à partir du moteur de transformation robuste (RTE) et du moteur d’identification et de rapprochement (IRE).
    Remarque :
    La plupart des messages du journal ETL du Centre d’intégration (provenant de RTE et IRE) sont à caractère informatif. Toutefois, même si les glide.importlog.log_to_table propriétés système sont définies pour ne pas ajouter de messages du journal INFO, Centre d’intégration com.glide.import_set.importlog_level ETL affiche les messages du journal INFO. Pour plus de détails sur ces propriétés, voir Propriétés des ensembles de données à importer.

    Une fois que vous avez affiché les détails sur la page de résumé, vous pouvez revenir à n’importe quelle étape pour apporter des ajustements, puis réexécuter l’intégration.

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL, puis cliquez sur le nom d’une intégration.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store.
    2. Sur la page Assistant de carte de transformation ETL, dans la section Prévisualiser les échantillons des résultats d’intégration et l’importation du calendrier de la configuration guidée, sélectionnez Résultats d’intégration de test et de restauration.
    3. Sur la page Résultats d’intégration de test et de restauration, cliquez sur Exécuter l’intégration.
    4. Affichez la page de résumé et cliquez sur les différents onglets pour afficher les résultats de l’exécution de l’intégration pour les classes CMDB affectées. Vous pouvez sélectionner l’icône d’aperçu pour ouvrir les formulaires CI et afficher les informations.
      Remarque :
      L’ordre des colonnes d’attribut suit la liste des colonnes par défaut pour la classe dans la plateforme. Tout d’abord, les colonnes par défaut de la classe s’affichent de gauche à droite, suivies du reste des colonnes d’attributs organisées par ordre alphabétique. Par exemple, pour afficher la liste des colonnes par défaut de la classe Ordinateurs, accédez à Tous > Configuration > Ordinateurs.
    5. Facultatif : Sélectionnez un onglet de classe et cliquez sur Modifier le mappage pour revenir à la page Sélectionner des classes CMDB pour mapper des données sources où vous pouvez examiner et modifier les paramètres de mappage.
      Remarque :
      Cliquer sur Modifier le mappage restaure tous les changements qui ont été apportés à la CMDB à la suite de cette exécution de l’intégration.
    6. Facultatif : Cliquez sur l’onglet Relations et passez en revue toutes les relations qui ont été créées.
    7. Facultatif : Cliquez sur Modifier les relations pour revenir à la page Ajouter des relations où vous pouvez examiner et changer toutes les configurations de relation.
      Remarque :
      Cliquez sur Modifier les relations pour restaurer tous les changements qui ont été apportés à la CMDB à la suite de l’exécution de cette intégration.
    8. Cliquez sur les onglets Journal d’erreurs, Journal d’activité ou Journal d’avertissement pour afficher les détails respectifs consignés par IRE et RTE pendant l’intégration.

      Les enregistrements de journal IRE sont regroupés par catégories et organisés selon la classe respective. Pour les messages du journal IRE, la colonne Message contient uniquement les messages eux-mêmes qui ont été extraits du message du journal brut. La colonne Message du journal contient le message complet du journal, qui inclut la classe et la catégorie en plus du message lui-même. Les journaux RTE apparaissent dans la catégorie Autre.

      Utilisez le commutateur détaillé pour modifier le mode d’affichage des colonnes Message et Message du journal :
      • Détaillé activé : affiche le texte des messages du journal entièrement développé.
      • Détaillé désactivé : affiche une version condensée des messages du journal. Le texte entièrement développé des messages du journal s’affiche lorsque vous pointez sur un message.
    9. Cliquez sur les onglets Charges utiles incomplètes et Charges utiles partielles pour plus de détails sur les charges utiles IRE pour l’exécution de l’intégration.
    10. Sélectionnez Marquer comme terminé.
      La boîte de dialogue Options de restauration s’affiche et vous pouvez choisir l’une des options suivantes.
      • Conserver les données : tous les changements apportés à la CMDB résultant de cette intégration sont conservés.
      • Effectuer une restauration : tous les changements apportés à la CMDB résultant de cette intégration sont restaurés et la CMDB est restaurée à son état avant d’exécuter l’intégration.

    Fournir le calendrier d’intégration

    Configurez un calendrier pour l’importation de données vers CMDB à l’aide de cette carte de transformation ETL.

    Avant de commencer

    Rôle requis : cmdb_inst_admin

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETL, puis cliquez sur le nom d’une intégration.
      La page de destination du Centre d’intégration ETL répertorie toutes les intégrations qui existent dans le système, y compris celles qui ont été téléchargées à partir du ServiceNow Store.
    2. Sur la page Assistant de carte de transformation ETL, dans la section Prévisualiser les échantillons des résultats d’intégration et l’importation du calendrier de la configuration guidée, sélectionnez Définir le calendrier de l’importation.
    3. Sur la page Fournir un calendrier, cliquez sur Définir les calendriers.
    4. Dans la vue de liste Importations de données planifiées (qui s’ouvre dans un nouvel onglet), cliquez sur Nouveau.
    5. Remplissez le formulaire Importation de données planifiée, puis cliquez sur Soumettre.
      Voir Planifier une importation de données pour plus d’informations sur les champs de formulaire.
    6. Cliquez sur Marquer comme terminé.

    Types de transformation dans Centre d’intégration ETL

    Utilisez diverses transformations dans Centre d’intégration ETL pour convertir et préparer les données sources au mappage à la CMDB.

    Les transformations de l’application du magasin Integration Commons pour CMDB sont également disponibles dans Centre d’intégration ETL.

    Concaténation

    Combine les valeurs des champs d’entrée en une seule chaîne, en les joignant dans le champ facultatif joining_string .

    Détails
    Table sys_rte_eb_concat_operation
    Champs d'entrée source_sys_rte_eb_fields
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires joining_string (facultatif)
    Exemple
    Entrée « input_1 », « input_2 », « input_3 »
    Champs supplémentaires joining_string = ”, ”
    Résultat « input_1, input_2, input_3 »

    Convertir en booléen

    Convertit la valeur entrante en booléen. Les valeurs « vrai » et « 1 » sont converties en « vrai » (sans respect de la casse), et toutes les autres valeurs sont converties en « faux ».

    Détails
    Table sys_rte_eb_to_boolean_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Exemples :
    • Toutes les entrées suivantes renvoient « vrai » :
      • VRAI
      • 1
    • Toutes les entrées suivantes renvoient la valeur « faux » :
      • « input_1 »
      • “”
      • 0
      • 11

    Convertir en date

    Tente de convertir la valeur entrante en valeur en appliquant GlideDateTime le date_format à la valeur entrante. Tente de convertir directement en utilisant GlideDateTime si le date_format est incorrect.

    Détails
    Table sys_rte_eb_to_date_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field

    Renvoie une valeur vide si l’analyse est impossible du tout.

    Champs supplémentaires date_format (format de date simple Java)
    Exemple
    Entrée « 20/09/2018 11:21:00 HNE »
    Champs supplémentaires date_format = « aaaa/MM/jj hh :mm :ss a z »
    Résultat “2018-09-20 16:21:00”
    Exemple
    Entrée « 20/09/2018 13:21:00 HNE »
    Champs supplémentaires date_format = « aaaa/MM/jj hh :mm :ss a z »
    Résultat “2018-09-20 18:21:00”
    Exemple
    Entrée "09/20/18”
    Champs supplémentaires date_format = « aaaa/MM/jj hh :mm :ss a z »
    Résultat “0018-09-20 00:00:00”

    Convertir en numérique

    Convertit la valeur entrante en nombre.

    Détails
    Table sys_rte_eb_to_numeric_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field

    Si la valeur entrante n’est pas numérique, la sortie est vide.

    Exemple
    Entrée 1.23
    Résultat 1.23
    Exemple
    Entrée 1.00
    Résultat 1
    Exemple
    Entrée input_1
    Résultat null
    Exemple
    Entrée deux
    Résultat null

    Copier

    Copie la valeur du champ source vers tous les champs cibles.

    Détails
    Table sys_rte_eb_copy_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_fields
    Champs supplémentaires overwrite_existing_value (facultatif, booléen) : si la valeur est vrai, les valeurs des champs cibles sont remplacées. Dans le cas contraire, aucune valeur non vide n’est remplacée.

    Extraire le numérique de début

    Définit le champ cible comme étant la première valeur numérique trouvée dans le champ source.

    Détails
    Table sys_rte_eb_extract_numeric_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • decimal_places (facultatif, nombre) : force la sortie à avoir un nombre spécifié de décimales.
    • remainder_target_field (facultatif, référence à un champ) : défini sur le reste tronqué du champ source, après suppression de la première valeur numérique.
    Exemple
    Entrée « 100 Mo »
    Résultat « 100 »
    Exemple
    Entrée « 100.123 Mo »
    Résultat “100.123"
    Exemple
    Entrée « 100.123 Mo »
    Champs supplémentaires decimal_places = 2
    Résultat “100.12”
    Exemple
    Entrée « 100 Mo »
    Champs supplémentaires decimal_places = 2
    Résultat “100.00”
    Exemple
    Entrée « 100 Mo »
    Champs supplémentaires remainder_target_field = <champ>
    Résultat « 100 » et <champ> = « Mo »

    Recherche Glide

    Effectue une recherche dans la base de données sur le target_table.

    Détails
    Table sys_rte_eb_glide_lookup_operation
    Champs d'entrée source_sys_rte_eb_fields
    Champ de sortie target_sys_rte_eb_fields
    Champs supplémentaires
    • target_table
    • glide_matching_fields (chaîne) : liste séparée par des virgules des noms de colonnes dans la table cible. Pour chaque champ d’entrée dans source_sys_rte_eb_fields, il doit y avoir le même nombre de valeurs dans glide_matching_fields
    • glide_target_fields (chaîne) : liste séparée par des virgules des noms de colonnes dans la table cible. Pour chaque champ cible dans target_sys_rte_eb_fields, il doit y avoir un nombre égal de valeurs dans glide_target_fields.
    Exemple
    Entrée
    • Champ d’entrée 1 : 100 South Charles Street, Baltimore
    • Champ d’entrée 2 : MD
    Champs supplémentaires
    • Table cible : emplacement (cmn_location)
    • Champs de correspondance Glide : street,state
    • Champs cibles Glide : sys_id
    Résultat Champ de sortie 1 : 25ab9c4d0a0a0bb300f7dabdc0ca7c1c

    Min/Max

    Définit le champ cible sur la valeur maximale ou minimale des valeurs de tous les champs d’entrée.

    Détails
    Table sys_rte_eb_min_max_operation
    Champs d'entrée source_sys_rte_eb_fields
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • data_type (liste de choix <STRING,NUMERIC,DATE>)
    • min_max (liste de choix <MIN, MAX>)
    Exemple
    Entrée “2”, “-1”, “0”
    Champs supplémentaires
    • data_type = NUMÉRIQUE
    • min_max = MAX.
    Résultat “2”
    Exemple
    Entrée « a », « b »
    Champs supplémentaires
    • data_type = CHAÎNE
    • min_max = MAX.
    Résultat « b »
    Exemple
    Entrée “2”, “-1”, “0”
    Champs supplémentaires
    • data_type = NUMÉRIQUE
    • min_max = MIN.
    Résultat “-1”
    Exemple
    Entrée « a », « b »
    Champs supplémentaires
    • data_type = CHAÎNE
    • min_max = MIN.
    Résultat « Un »

    Script d’entrée multiple

    Exécute un script avec plusieurs entrées, en définissant la target_field sortie == pour ce script.

    Chaque champ source est disponible à l’intérieur de la variable « batch » en tant que champs JavScript. Le nom du champ JavaScript est l’attribut de champ du champ d’entité (en sys_rte_eb_field.fieldregardant , pas sys_rte_eb_field.name).

    Détails
    Table sys_rte_eb_multi_in_script_operation
    Champs d'entrée source_sys_rte_eb_fields
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • script (script)
    • use_unique_input_sets (booléen) : lorsque la valeur est vrai, seules les valeurs d’entrée uniques sont incluses dans le lot de données pour le traitement IRE. Sinon, toutes les valeurs de champ de l’objet d’entrée sont incluses.
    Exemple d’utilisation use_unique_input_setsde , avec une fonction de script qui prend record_type et operating_system comme entrée et renvoie record_with_os:
    Tableau 2. Données d'entrée
    Enregistrement record_type operating_system record_with_os
    1 ordinateur Windows XP
    2 ordinateur Linux
    3 ordinateur Windows XP
    Si use_unique_inputs_sets la valeur est définie sur true, le script ne traite que deux valeurs (ordinateur + Windows XP et ordinateur + Linux). Si use_unique_inputs_sets est défini sur faux, chacune des trois valeurs est traitée individuellement (ordinateur + Windows XP, ordinateur + Linux et ordinateur + Windows XP).
    Exemple de script :
                (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].<field> gives access to the field value 
                            var in0 = gs.nil(batch[i].record_type) ? '' : batch[i].record_type;
                            var in1 = gs.nil(batch[i].operating_system) ? '' : batch[i].operating_system;
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + "_" + in1; 
                        } 
                    } 
                })(batch, output);
    Exemple de script :
                /* Example Script
                 // In this example the script input fields are 'input_field_1', 'input_field_2' - replace these with the fields used as script inputs // There is a static field 'input' that has all the input field values concatenated with a '|' (function(batch, output) {
                     for (var i = 0; i < batch.length; i++) {
               
                         //step1: access the input variables
                         var a = batch[i].input_field_1; //Value of the first source field.
                         var b = batch[i].input_field_2; //Value of the second source field.
                 
                         //step2: Your script/code goes here.
                         var c = a + b;
               
                         //step3: set the output for each elements
                         output[i] = b;
                     }
               
                 })(batch, output);
                */

    Remplacement Rexeg

    Remplace chaque sous-chaîne de la chaîne entrante qui correspond à la valeur de chaîne spécifiéematch_regexreplacement_regex.

    Détails
    Table sys_rte_eb_regex_replace_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • match_regex (chaîne, expression régulière)
    • replacement_regex (chaîne)
    Exemple
    Entrée « String&With(Spécial)$Characters »
    Champs supplémentaires
    • match_regex = « [^0-9a-zA-Z]+ »
    • replacement_regex = “ ”
    Résultat « chaîne avec des caractères spéciaux »

    Remplacer

    Remplace chaque sous-chaîne de la chaîne entrante qui correspond au , spécifié match_string, par la valeur de chaîne replacement_string .

    Détails
    Table sys_rte_eb_replace_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • match_string (chaîne)
    • replacement_string (chaîne)
    Exemple
    Entrée « Chaîne d’origine »
    Champs supplémentaires
    • match_string = « Original »
    • replacement_string = « Remplacement »
    Résultat « Chaîne de remplacement »

    Numérique arrondi

    Arrondit la valeur au nombre entier le plus proche. Les numéros non nombreux sont tronqués.

    Détails
    Table sys_rte_eb_round_numeric_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Exemple
    Entrée “1.5”
    Résultat « 2 »
    Exemple
    Entrée “1.4”
    Résultat « 1 »
    Exemple
    Entrée « Je suis une chaîne »
    Résultat ""

    Script

    Exécute un script avec entrée, en définissant la sortie target_field == pour ce script.

    Cette transformation a été remplacée par la transformation de script à entrées multiples et est incluse pour des raisons de rétrocompatibilité avec les configurations existantes.

    Détails
    Table sys_rte_eb_script_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • script (script)
    • use_unique_input_sets (booléen) : lorsque la valeur est vrai, seules les valeurs d’entrée uniques sont incluses dans le lot de données pour le traitement IRE. Sinon, toutes les valeurs de champ de l’objet d’entrée sont incluses. Pour obtenir un exemple et pour plus de détails, consultez la transformation de script d’entrée multiple.
    Le champ source est inclus dans la variable « batch » en tant que champ JavaScript « input ».
              (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].input gives access to the field value 
                            var in0 = gs.nil(batch[i].input) ? '' : batch[i].input; 
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + " modified by script”; 
                        } 
                    } 
                })(batch, output); 
    Exemple :
    /* Example Script
     (function(batch, output) {
         for (var i = 0; i < batch.length; i++) {
             //step1: access the input variables
             var a = batch[i].input; //Value of the source field.
     
             //step2: Your script/code goes here.
             var b = a + 1;
             //step3: set the output for each elements
             output[i] = b;
         }
     })(batch, output);
    */ 

    Ensemble

    Définit la valeur du champ cible sur la chaîne spécifiée dans set_value.

    Détails
    Table sys_rte_eb_set_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Champs supplémentaires
    • set_value (chaîne)
    • overwrite_existing_value (facultatif, booléen) : lorsque la valeur est vrai, la valeur actuelle du champ cible est remplacée. Sinon, une valeur non vide n’est pas remplacée.

    Division

    Divise la valeur du champ source sur le splitting_string et affecte chaque élément résultant de la division au , dans l’ordre target_sys_rte_eb_fields.

    Détails
    Table sys_rte_eb_split_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_fields
    Champs supplémentaires splitting_string (chaîne)
    Exemple
    Entrée "valeur1||valeur2||value3", avec target_sys_rte_eb_fields {target1,target2,target3}
    Champs supplémentaires splitting_string = ”||”
    Résultat target1 : value1, target2 : value2, target3 : value3
    Exemple
    Entrée "valeur1||valeur2||value3", avec target_sys_rte_eb_fields {target1}
    Champs supplémentaires splitting_string = ”||”
    Résultat target1 : valeur1
    Exemple
    Entrée « value1 », avec target_sys_rte_eb_fields {target1,target2,target3}
    Champs supplémentaires splitting_string = ”||”
    Résultat target1 : value1, target2 : <null>, target3 : <null>

    Découpage

    Supprime les espaces de début et de fin de la source_sys_rte_eb_field valeur et affecte le résultat à la target_sys_rte_eb_field. Cette transformation est équivalente à un String.trim() Java.

    Détails
    Table sys_rte_eb_trim_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Exemple
    Entrée « valeur 1 »
    Résultat « valeur 1 »

    Majuscule

    Majuscule la source_sys_rte_eb_field valeur et affecte le résultat à target_sys_rte_eb_field.

    Détails
    Table sys_rte_eb_upper_case_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Exemple
    Entrée « valeur 1 »
    Résultat « VALEUR1 »

    Découpage des majuscules

    Combine les transformations Majuscule et Découpage.

    Détails
    Table sys_rte_eb_upper_case_trim_operation
    Champs d'entrée source_sys_rte_eb_field
    Champ de sortie target_sys_rte_eb_field
    Exemple
    Entrée « valeur 1 »
    Résultat « VALEUR1 »