Créer une carte de transformation ETL

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 43 minutes de lecture
  • Centre d’intégration ETL fournit une configuration guidée qui vous guide dans l’exécution de toutes les tâches nécessaires à la création d’une carte de transformation ETL pour une intégration spécifique.

    Configuration guidée

    Guided Setup organise toutes les tâches dans le bon ordre, suit leur achèvement et renforce 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 à mesure que 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.

    Importer des données sources et spécifier les détails de base

    Fournissez les détails de base pour l’intégration, tels que la source des données que vous souhaitez intégrer à la 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 active.

    Lorsque vous ouvrez une carte de transformation ETL, par défaut, la carte n’est 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 d’IntegrationHub 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 d’IntegrationHub ETL v3.2, les intégrations sont regroupées par CMDB Application valeur, auquel cas développez le groupe respectif pour localiser une intégration.
    2. Cliquez sur le nom d’une intégration pour l’afficher ou la 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 qui ont été 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 d’apparaître à mesure que vous continuerez à travailler avec l’intégration.
      Le système détecte les erreurs telles que :
      • Champs source ou cible manquants dans les enregistrements de mappages de champs correspondants du moteur de transformation robuste (RTE)
      • 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 du moteur Identification et réconciliation (IRE) 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

      L’application CMDB associée à la carte de transformation ETL.

      Vous pouvez sélectionner Ajouter nouveau, ce qui ajoute les champs Application CMDB et Source Discovery 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 du système.
      Remarque :
      Soyez prudent lorsque vous modifiez ultérieurement la source de données, car cela peut entraîner des changements substantiels dans l’intégration des données. L’alignement sur la table de jeux d’importation 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étectent toutes les mises à jour requises et vous permettent d’accepter ou de rejeter 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 afficher un aperçu des 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 d’IntegrationHub 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 exemple pour l’aperçu de cette carte de transformation. Si activé, 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 terminé est désactivée, la structure de données imbriquée 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 du schéma de données entier pour générer la structure de données de la carte.

      Lorsqu’elle est désactivée, la structure de données imbriquée 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 Remplacement de la taille de l’aperçu , 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 Détection

      Source de détection 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 changements en cours ou sur Marquer comme terminé.

      Un horodatage apparaît dans l’en-tête lorsque vous cliquez sur Enregistrer, qui reste pendant toute 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 les exemples d’enregistrements de données sources brutes, qui seront intégrés dans la CMDB. Transformez et préparez les données pour qu’elles s’alignent sur les classes et attributs cibles, si nécessaire.

    Avant de commencer

    Le nombre d’enregistrements dans les exemples de données est déterminé globalement par la propriété sn_int_studio.preview.sizesystème , définie sur 100 par défaut. 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 d’IntegrationHub ETL v3.2, vous pouvez remplacer la valeur de la sn_int_studio.preview.size propriété en définissant le champ Remplacement de la taille de l’aperçu sur le formulaire Importer des données sources et fournir des 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 dans une seule colonne .

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Examinez les valeurs dans les 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 des données, par exemple en convertissant le format de 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 qu’un attribut CMDB soit vide, utilisez la chaîne « <EMPTYֹ_STRING> ».

    Les colonnes des données imbriquées s’affichent à côté du reste des données, avec une notation 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’explorer des niveaux plus profonds des données imbriquées. Pour afficher la structure des données imbriquées dans un panneau séparé, activez l’option Afficher la structure des données .

    Le panneau Structure des données propose 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 de 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 des logiciels. Développez un nœud, par exemple Logiciel, pour afficher quel logiciel est installé sur chaque ordinateur.
    Vous pouvez naviguer à travers les niveaux de données imbriquées dans le panneau Structure des données, le chemin d’accès au fil 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 charges utiles imbriquées, regardez la vidéo de démonstration de la fonctionnalité de charge utile imbriquée Integration Hub - ETL sur la chaîne YouTube de ServiceNow.

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETLet cliquez sur le nom d’une intégration.
      La page de destination d’IntegrationHub 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. Dans la page ETL Transform Map Assistant, dans la section Prepare Source Data for Mapping (Préparer les données sources pour le mappage) de la configuration guidée, sélectionnez Preview and Prepare Data (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 de 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 la colonne respective, ou sélectionnez Dégrouper pour annuler l’opération de regroupement.
    6. Facultatif : Cliquez sur Nouvelle transformation , puis sélectionnez Utiliser la colonne source , ou sélectionnez le menu d’action d’une colonne et sélectionnez 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’objets imbriqués contient des liens numériques qui indiquent le nombre d’éléments imbriqués pour l’enregistrement. Pour créer une nouvelle transformation pour les objets imbriqués, cliquez sur ce lien numérique pour analyser dans le détail 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. À l’aide de l’exemple de charge utile pour les données imbriquées , une transformation d’un objet d’interface peut faire référence à l’objet de l’ordinateur parent, mais ne peut pas faire référence à 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 si nécessaire.
        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 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, et 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 la bannière. Ensuite, déplacez la colonne masquée de la liste Disponible vers la liste Sélectionné, puis 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 contenant les valeurs transformées s’affiche, placé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 toutes les transformations, si nécessaire.
    7. Facultatif : Pour appliquer la transformation « Définir la colonne de valeur fixe » :
      1. Cliquez sur Nouvelle transformation , puis sélectionnez Définir la colonne à valeur fixe.
      2. Dans la barre latérale Définir une colonne de valeur fixe, entrez un nom de colonne et une description de colonne pour la nouvelle colonne.
      3. Définissez l’option Affecter la valeur de colonne sur la valeur fixée pour la nouvelle colonne.
      4. 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 active.

      Lors d’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’action d’une colonne, puis sélectionnez Supprimer cette colonne et Colonnes en aval pour supprimer la colonne ainsi que toutes les colonnes qui ont été ajoutées à l’aide de cette colonne comme colonne d’entrée.
    10. Facultatif : Cliquez sur Nouvelle transformation , puis sélectionnez Recherche de table, ce qui vous permet de spécifier une table à rechercher et d’extraire des valeurs supplémentaires, puis de remplir les champs dans la barre latérale Recherche de table à droite.
      Les valeurs de la table de recherche spécifiée correspondent aux données mappées. Pour les enregistrements qui correspondent, les valeurs spécifiées de la table de recherche sont ajoutées sous forme de 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 établir une 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 sont tentées d’être appariées.

      • Si les valeurs de la colonne de la table cible : colonne de la table cible à mettre en correspondance avec une colonne des données mappées.
      • Valeurs de correspondance de la table de données sources : colonne des données mappées à mettre en correspondance avec une colonne de la table de recherche.

      Vous pouvez ajouter plusieurs paires de colonnes à associer.

      Condition de recherche

      Valeurs à extraire de la table de recherche en cas de correspondance avec les données mappées.

      Ensuite, générez les valeurs 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 à partir desquelles 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

      Étiquette de 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 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 sur les classes et attributs CMDB cibles. De plus, 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 vous assurer qu’ils sont correctement traités 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 qui sont plus anciens que l’enregistrement actuel et qui peuvent donc être ignorés, afin de résoudre les valeurs d’attribut conflictuelles. 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 la façon dont IRE utilise source_native_key et source_recency_timestamp pour l’identification des CI, consultez Moteur Identification et réconciliation (IRE).

    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. Cependant, si le nom d’affichage contient « Linux », « Serveur Linux » est sélectionné comme classe cible. Pour les enregistrements qui ne remplissent 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 cible non CMDB. 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 Prise en charge IRE pour les tables non CMDB pour en savoir plus.

    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. Toutefois, pour les classes non CMDB avec des 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 des règles IRE Au lieu de « vous devez », cela devrait être. « C’est possible ». 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, telle que Numéro de série [cmdb_serial_number], qui n’étend pas la classe É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 cible non CMDB.

    Par exemple, la classe Entrée connexe [cmdb_related_entry] possède un enregistrement qui associe la classe Instance logicielle non CMDB [cmdb_software_instance] à 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 remplir cette classe, vous devez la rajouter et reconfigurer tous les mappages de classe. 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 préservant 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 classe. Plus tard, vous pouvez réactiver un mappage de classe pour activer le remplissage de la classe, sans avoir besoin de reconfigurer les mappages de classe.

    Certaines classes que vous choisissez de désactiver déclenchent une désactivation automatique des classes supplémentaires que vous n’avez pas directement choisi de désactiver. Les classes qui sont 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. Ces classes sont automatiquement désactivées :
    • 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 :
      • La 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ées lors de l’exécution de l’intégration. En outre, les tables de recherche et les relations 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 pas de classes associées :

      Déclenche une 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’affecte pas la classe CMDB associée.
    • Désactivez une classe ayant des relations dépendantes (s’applique uniquement si la relation dépendante existe dans Centre d’intégration ETL) :
      • Déclenche une désactivation automatique de toute classe qui a une relation dépendante unique avec la classe désactivée.
      • Si une classe a plusieurs relations dépendantes, elle est automatiquement désactivée uniquement 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 à la fois avec la classe Computer et la classe Server. Si vous désactivez la classe Computer, la classe File System n’est pas automatiquement désactivée. La classe File System est automatiquement désactivée uniquement si vous désactivez également la classe Server.

    • Désactivez une classe conditionnelle ou un mappage de classe dans 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 dans une classe conditionnelle : empêche le renseigné de la classe désactivée pendant les exécutions d’intégration. Toutefois, les conditions « If », « Else if » ou « Else » associées restent elles-mêmes en vigueur dans la condition de la classe conditionnelle. Par exemple, si vous désactivez le mappage de classes suivant :

        [Si] [operating_system] [contient] [Linux] Alors [Classe] [est] [Serveur Linux].

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

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

    Choisissez les classes et attributs cibles dans la CMDB auxquels mapper les colonnes de données sources. Vous pouvez mapper une colonne de données à une classe cible spécifique ou ajouter des conditions afin 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 and Software Package (Ordinateur) et Software Package, 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 pour une classe, une relation ou une règle de recherche, ces éléments sont toujours initialement définis comme activés. Pour plus d’informations sur les résultats de la désactivation des mappages, consultez Désactivation des mappages de classes.

    Remarque :
    La modification d’une classe a un impact sur tous les mappages déjà configurés pour la classe, parfois ces mappages sont supprimés. Les détails sur les mappages affectés et l’impact apparaissent 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 est effectué 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 ETLet cliquez sur le nom d’une intégration.
      La page de destination d’IntegrationHub 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. Dans la page ETL Transform Map Assistant (Assistant de carte de transformation ETL), dans la section Map Data to CMDB and Add Relationships (Mapper les données à CMDB et ajouter des relations) de la configuration guidée, sélectionnez Select CMDB Classes to Map Data to Map Data (Mapper des données à CMDB et ajouter des relations) de la configuration guidée, sélectionnez Select CMDB Classes to Map CMDB to Map (Classes CMDB pour mapper des données source).
      Les attributs configurés comme requis dans la plateforme sont notés et vous devez mapper une colonne de données à chacun de ces attributs.
    3. Cliquez sur Ajouter une classe pour ajouter une classe cible à mapper, 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 concerné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 à différentes classes cibles.
      1. La collecte est automatiquement définie sur la branche de données de la hiérarchie associée à l’attribut de niveau le plus bas.
        Vous pouvez modifier la valeur pour 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 entrez des modules d’extension dans la zone de recherche et spécifiez une condition de module d’extension.
        Vous pouvez ensuite spécifier que le reste des enregistrements, qui ne correspondaient à aucune condition, est mappé à 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 des é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 d’une classe conditionnelle.
        Si la boîte de dialogue Mappages de classes affectés s’affiche, passez en revue la liste des classes concerné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, activez ou désactivez l’option Activer/désactiver le mappage pour un mappage de classe. Cliquez sur Enregistrer, puis 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 renseignée pendant les exécutions d’intégration, mais cela n’affecte pas la condition associée. Les conditions « Si », « Sinon si » et « Sinon » 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 classe conditionnelle est activé, le commutateur de la classe conditionnelle apparaît comme activé. Dans le cas contraire, 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 activer le commutateur Activer/désactiver le mappage.
      Vous pouvez également cliquer 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 comprend 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 aucune classe associée n’a é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 pour 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 des données sur la droite, vers l’attribut cible CMDB sur le côté gauche de la page de mappage.
        Sinon, cliquez 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 des données imbriquées :
        • Les colonnes de données de la barre latérale Données s’affichent dans 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 indiquées par un point cyan.
        • Tous les mappages sur 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 vers 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 celle que vous avez utilisée avec des tables sans recherche.

          Remarque :
          Vous pouvez contourner cette restriction en utilisant la transformation Copier dans 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 sorte 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 valides pour le mappage sont mis en évidence par un cadre vert. Si vous tentez de déposer 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.
      3. Dans la liste Attribut de la boîte de dialogue Add Attribute ( Ajouter un attribut ), sélectionnez un ou plusieurs éléments comme attributs cibles auxquels mapper des données.
        Vous pouvez également faire défiler la liste jusqu’à la section Paramètres IRE et sélectionner l’une des propriétés du transformateur de jeu d’importation robuste . Cliquez sur Enregistrer.
        Pour plus d’informations sur l’ordre de priorité entre les propriétés du transformateur de jeu d’importation robuste définies au niveau de l’élément individuel et au niveau de la charge utile IRE, voir Propriétés du transformateur de jeu d’importation robuste .
      4. Mappez toutes les règles de recherche telles que la règle « Recherche de numéro de série 1 ».

        L’état des règles de recherche est désactivé tant que vous ne les avez pas mappées. Cliquez sur l’icône de filtre pour la règle de recherche afin de modifier ou d’ajouter des filtres de recherche. Dans la boîte de dialogue de 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 à diverses 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 la règle de recherche pour une règle.

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

    Ajouter des relations

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

    Avant de commencer

    • Une classe que vous souhaitez ajouter à la relation doit être dans un état activé.
    • Une relation de base ou une relation au sein d’une relation conditionnelle, que vous souhaitez modifier, doit être dans un état activé.
    • Dans une relation conditionnelle que vous souhaitez modifier, au moins une condition de relation doit être dans un é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 à partir des données imbriquées. Si vous prenez l’exemple de payload pour les données imbriquées comme exemple, vous ne pouvez pas créer de relation entre les interfaces et le logiciel.

    Visibilité ITOM, s’il est disponible, 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 ETLet cliquez sur le nom d’une intégration.
      La page de destination d’IntegrationHub 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. Dans la page de l’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. Ajoutez des relations.
      1. Ajoutez des relations en sélectionnant 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.
      2. Effectuez les actions suivantes si nécessaire.
      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 des éléments d’attribut.

      Le menu de liste Type de relation change en fonction de la classe parente 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 avec la première relation suggérée automatiquement sélectionnée, suivie des types de relations du système de base.
      • Si aucune relation n’est suggérée, la liste affiche Aucune relation suggérée suivie des types de relations du système de base.
    4. Cliquez sur Enregistrer pour enregistrer les changements en cours ou sur Marquer comme terminé.

      Un horodatage apparaît dans l’en-tête lorsque vous cliquez sur Enregistrer, qui reste pendant toute 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 les nombres totaux de relations qui ont été créées, les classes mappées, les charges utiles partielles et incomplètes que le moteur IRE n’a pas pu traiter. Vous pouvez également afficher les messages détaillés du moteur de transformation robuste (RTE) et du moteur de rapprochement d’identification (IRE).
    Remarque :
    La plupart des messages de journal ETL d’IntegrationHub (provenant de RTE et d’IRE) sont informatifs. Toutefois, même si les propriétés système com.glide.import_set.importlog_level et and sont glide.importlog.log_to_table définies pour ne pas ajouter de messages de journal INFO, Centre d’intégration ETL affiche les messages de journal INFO. Pour plus d’informations sur ces propriétés, consultez Propriétés des jeux d’importation.

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

    Procédure

    1. Accédez à la Tous > Configuration > Centre d'intégration ETLet cliquez sur le nom d’une intégration.
      La page de destination d’IntegrationHub 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. Dans la page ETL Transform Map Assistant, dans la section Aperçu des échantillons de résultats d’intégration et Planifier l’importation de la configuration guidée, sélectionnez Résultats d’intégration de test et de restauration.
    3. Sur la page Résultats de l’intégration de test et de restauration, cliquez sur Exécuter l’intégration.
    4. Affichez la page récapitulative et cliquez sur les différents onglets pour afficher les résultats d’exécution de l’intégration pour les classes CMDB affectées. Vous pouvez cliquer sur l’icône d’aperçu pour ouvrir les formulaires de CI et afficher les informations.
      Remarque :
      L’ordre des colonnes d’attributs suit la liste des colonnes par défaut de la classe dans la plateforme. Tout d’abord, les colonnes par défaut de la classe apparaissent de gauche à droite, suivies par le 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 n’importe quel 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 examinez toutes les relations qui ont été créées.
      Cliquez sur Modifier les relations pour revenir à la page Ajouter des relations où vous pouvez examiner et modifier toutes les configurations de relations.
      Remarque :
      Cliquer sur Modifier les relations restaure tous les changements qui ont été apportés à la CMDB à la suite de cette exécution de l’intégration.
    7. 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 en fonction de la classe respective. Pour les messages de journal IRE, la colonne Message contient uniquement les messages eux-mêmes qui ont été extraits du message de journal brut. La colonne Message du journal contient le message du journal complet, qui inclut la classe et la catégorie en plus du message lui-même. Les journaux RTE apparaissent sous la catégorie Autre.

      Utilisez le commutateur détaillé pour changer le mode d’affichage des colonnes Message et Message du journal :
      • Détaillé activé : affiche le texte entièrement développé des messages de journal.
      • Détaillé désactivé : affiche une version condensée des messages du journal. Le texte entièrement développé des messages de journal s’affiche lorsque vous pointez vers un message.
    8. Cliquez sur les onglets Charges utiles incomplètes et Charges utiles partielles pour obtenir des détails sur les charges utiles IRE pour l’exécution de l’intégration.
    9. 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 : toutes les modifications apportées à la CMDB résultant de cette intégration sont conservées.
      • 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 ETLet cliquez sur le nom d’une intégration.
      La page de destination d’IntegrationHub 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. Dans la page de l’assistant de carte de transformation ETL, dans la section Prévisualiser les échantillons de résultats d’intégration et l’importation du calendrier de la configuration guidée, sélectionnez Définir le calendrier d’importation.
    3. Sur la page Fournir un calendrier, cliquez sur Définir des calendriers.
    4. Dans la vue de listes 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.
      Reportez-vous à la rubrique Planifier une importation de données pour en savoir plus 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 pour le mappage à la CMDB.

    Les transformations de l’application de stockage Integration Commons for 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 Vraiet 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 « faux » :
      • « input_1 »
      • ""
      • 0
      • 11

    Convertir en date

    Tente de convertir la valeur entrante en GlideDateTime valeur en appliquant la date_format valeur à la valeur entrante. Tente de convertir directement à l’aide GlideDateTime de 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 s’il ne peut pas du tout analyser.

    Champs supplémentaires date_format (format de date simple Java)
    Exemple
    Entrée « 2018/09/20 11 :21 :00 HE »
    Champs supplémentaires date_format = « aaaa/MM/jj hh :mm :ss a z »
    Résultat "2018-09-20 16:21:00"
    Exemple
    Entrée « 2018/09/20 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 « 20/09/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 dans 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. Sinon, les valeurs non vides ne sont pas remplacées.

    Extraire les valeurs numériques 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éfinir sur le reste tronqué du champ source, après avoir supprimé la première valeur numérique.
    Exemple
    Entrée « 100 Mo »
    Résultat « 100 »
    Exemple
    Entrée « 100.123 mb »
    Résultat « 100.123 »
    Exemple
    Entrée « 100.123 mb »
    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 <field> = « mb »

    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 de noms de colonnes séparés par des virgules dans la table cible. Pour chaque champ d’entrée dans source_sys_rte_eb_fields, il doit y avoir un nombre égal de valeurs dans glide_matching_fields
    • glide_target_fields (chaîne) : liste de noms de colonnes séparés par des virgules 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 : rue, état
    • 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 <CHAÎNE,NUMÉRIQUE,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, définissant la target_field sortie == pour ce script.

    Chaque champ source est disponible à l’intérieur de la variable « batch » sous forme de champs JavScript. Le nom du champ JavaScript est l’attribut de champ du champ d’entité (en regardant sys_rte_eb_field.field, et non 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) : si 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 défini sur false, 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 de Rexeg

    Remplace chaque sous-chaîne de la chaîne entrante qui correspond au , spécifié match_regexpar la valeur de chaîne spécifiée replacement_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&amp;With(Special)$Characters »
    Champs supplémentaires
    • match_regex = « [^0-9a-zA-Z]+ »
    • replacement_regex = " "
    Résultat « Chaîne avec caractères spéciaux »

    Remplacer

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

    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 du nombre au nombre entier le plus proche. Les non-nombres 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 corde »
    Résultat ""

    Script

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

    Cette transformation a été remplacée par la transformation du script d’entrée multiple et est incluse pour la 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) : si 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 du 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);
    */ 

    Définir

    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) : si la valeur est vrai, la valeur actuelle du champ cible est remplacée. Dans le cas contraire, une valeur non vide n’est pas remplacée.

    Division

    Fractionne 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 : value1
    Exemple
    Entrée « value1 », avec target_sys_rte_eb_fields {target1,target2,target3}
    Champs supplémentaires splitting_string = "||"
    Résultat target1 : value1, target2 : &lt;null>, target3 : &lt;null>

    Découpage

    Supprime les espaces de début et de fin de la source_sys_rte_eb_field valeur et attribue le résultat à la target_sys_rte_eb_field. Cette transformation est équivalente à une 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

    Met la valeur en majuscules source_sys_rte_eb_field et attribue 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 « valeur1 »
    Résultat « VALEUR1 »

    Découpage des majuscules

    Combine à la fois 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 « valeur1 »
    Résultat « VALEUR1 »