Créer une carte de transformation ETL

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 42 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

    La configuration guidée organise toutes les tâches dans le bon ordre, suit l’achèvement des tâches 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 à mesure que vous utilisez l’outil et que vous terminez des 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 de 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, 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 le mode de gestion des erreurs de validation.

    Rôle requis : cmdb_inst_admin

    Procédure

    1. Accédez à la Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    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 true, IntegrationHub 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 et répertorie 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, des notifications concernant les mappages non valides continueront de s’afficher à 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 correspondants de mappages de champs du moteur de transformation robuste (RTE)
      • Colonnes de table manquantes dans un jeu d’importation
        Remarque :
        Dans ce cas, 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 qui sont associés aux colonnes de table manquantes dans le jeu d’importation sont supprimés.
      • Règle de recherche IRE (moteur Identification et rapprochement) 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 des 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 de détection 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 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 des 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 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 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.

      Si vous ne sélectionnez pas de jeu d’importation ou si la source de données spécifiée n’est associée à aucun jeu d’importation, un jeu d’importation de 100 enregistrements maximum est automatiquement créé et sélectionné.

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

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

    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 de 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 données témoins est déterminé globalement par la propriété sn_int_studio.preview.sizesystème , qui est définie sur 100 par défaut. Le nombre maximal d’enregistrements dans les échantillons 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.

    Pour traiter des 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 de l’échantillon 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 définir un attribut CMDB comme 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 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 source. 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 fil d’Ariane ou les liens numériques qui apparaissent dans les données source 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 de données de charge utile 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 Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    2. Dans la page ETL Transform Map Assistant, 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 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 Grouper par pour regrouper les données selon la colonne respective. Sélectionnez Dégrouper 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 transformations pour les objets imbriqués dans cette vue de niveau supérieur des données. Une colonne d’objet imbriquée 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 faire référence à des objets parents des données imbriquées en cours de transformation. En utilisant l’exemple de charge utile pour les données imbriquées comme exemple, une transformation pour un objet d’interface peut faire référence à l’objet 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 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 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ée 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 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 une colonne de valeurs fixes » :
      1. Cliquez sur Nouvelle transformation , puis sélectionnez Définir une colonne de 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. 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 en cours.

      Lors d’une session suivante, le paramètre Ignorer dans le mappage ne s’applique pas et la colonne est incluse dans le mappage.

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

    9. Facultatif : Sélectionnez le menu d’action d’une colonne, puis sélectionnez Supprimer cette colonne et Colonnes en aval. Cette action de suppression supprime 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 dans la table qui vous permet de spécifier une table à rechercher et d’en extraire des valeurs supplémentaires. Renseignez les champs de la barre latérale de recherche de table sur la droite.
      Les valeurs de la table de recherche spécifiée sont mises en correspondance avec les données mappées. Pour les enregistrements qui correspondent, les valeurs spécifiées 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

      Un 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 mises en correspondance.

      • Si les valeurs de la colonne de la table cible : colonne de la table cible à faire correspondre à une colonne des données mappées.
      • Valeurs de correspondance de la table de données source : 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 lorsqu’il existe une correspondance avec les données mappées.

      Puis 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 les données mappées satisfont à la condition de recherche.

      Vous pouvez spécifier plusieurs colonnes de table de recherche à partir desquelles extraire des 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 les valeurs de sortie Then 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.

    A 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. De plus, il est possible de désactiver les mappages de classes tout en préservant les paramètres pour une réactivation facile. Passez en revue ces concepts pour vous assurer qu’ils sont traités correctement par le moteur Identification et Rapprochement (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. De plus, les deux champs suivants s’affichent par défaut et vous ne pouvez pas les supprimer :
    Clé native de la source
    IRE permet d’identifier de façon unique un enregistrement et d’établir des relations et des références. En outre, améliore 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 posté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 Identification et 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 colonnes 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 », alors « 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 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. Voir Prise en charge IRE pour les tables non CMDB pour plus d’informations.

    L’instance logicielle est une classe non CMDB, mais elle n’est pas associée à des règles IRE. Donc, les choses que nous avons dites à ce sujet ici avant l’Utah sont toujours valables. Mais 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 des règles IRE Au lieu de « vous devez », elle devrait l’être. « C’est possible ». Idem pour l’exemple : ce n’est pas valide pour les règles non CMDB avec 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 d’éléments 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] possède un enregistrement qui associe la classe d’instance logicielle non CMDB [cmdb_software_instance] à la classe de package logiciel CMDB [cmdb_ci_spkg]. Si vous sélectionnez l’instance logicielle comme classe cible, vous devez associer la classe d’instance logicielle à la classe de 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 l’ajouter à nouveau 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 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 classe. Ultérieurement, vous pouvez réactiver un mappage de classe pour activer le remplissage de la classe, sans avoir à 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 ont été 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 classe 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 lorsque l’intégration s’exécute.

    Mappage de classes 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 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’a pas d’impact sur la classe CMDB associée.
    • Désactivez une classe avec 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 de la classe Computer et d’une 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 si vous désactivez également la classe Server.

    • 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 dans une classe conditionnelle : empêche la classe désactivée d’être renseigné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 en vigueur.

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

    Choisissez les classes et les attributs cibles dans la 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 pour 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 des colonnes de données sources qui n’ont pas été transformées ou des colonnes de données transformées. Par exemple, pour intégrer une colonne de données dans les classes Computer and Software Package, sélectionnez ces classes en tant que classes cibles, puis mappez les colonnes de données en attributs spécifiques dans 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 affecte tous les mappages qui ont déjà été configurés pour la classe, parfois en supprimant ces mappages. Les détails relatifs aux 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 se fait 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 Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    2. Dans 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 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ées 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 à différentes classes cibles.
      1. La collecte est automatiquement définie sur la branche de données dans la hiérarchie associée à l’attribut de niveau le plus bas. Vous pouvez modifier la valeur de la branche de données à partir de laquelle vous souhaitez mapper des 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 les autres enregistrements, qui ne correspondaient à 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 d’abord 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ées 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, activez ou désactivez le commutateur Activer/désactiver le mappage d’un mappage de classe. Cliquez sur Enregistrer, puis si la boîte de dialogue Mappages de classes affectées 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 » 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 dans 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 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 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 Set Up Mapping (Configurer le mappage ) pour configurer le mappage d’une classe récemment ajoutée, ou cliquez sur Edit Mapping (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 à droite vers l’attribut cible CMDB à 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 des données imbriquées :
        • Les colonnes de données de la barre latérale de données s’affichent dans un format d’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 aux attributs dans les tables de recherche. Tous les mappages vers des attributs dans 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 des tables autres que de recherche.

          Remarque :
          Vous pouvez contourner cette restriction en utilisant la transformation Copier de l’étape de préparation des données, pour copier les attributs d’un niveau parent vers un niveau enfant. Préparez les données de sorte que tous les attributs que vous voulez mapper soient au même niveau.
        • Lorsque vous faites glisser une colonne à mapper à partir de la barre latérale Données, les champs des attributs cibles CMDB valides pour le mappage sont mis en surbrillance par un cadre vert. Si vous tentez de déposer une colonne dans un attribut cible non valide, le champ concerné 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 en tant qu’attributs cibles auxquels mapper les données. Vous pouvez également faire défiler vers le bas jusqu’à la section Paramètres IRE de la liste et sélectionner l’une des propriétés robustes du transformateur de jeu d’importation . 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 chaque élément et au niveau de la charge utile IRE, consultez Propriétés du transformateur de jeu d’importation robuste .
      3. Mappez toutes les règles de recherche telles que la règle de « Recherche de numéro de série 1 ».

        Les règles de recherche sont désactivées 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 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 à 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 la règle de recherche d’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 de préparation des données dans laquelle 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 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 à l’état activé. Dans le cas contraire, le bouton Modifier la relation est grisé.

    Rôle requis : cmdb_inst_admin

    Pourquoi et quand exécuter cette tâche

    Lorsque vous créez des 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. 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 le tableau 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 Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    2. Dans 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 au besoin.
      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 la 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’existe aucune 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.
      • 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 données témoins (par défaut, jusqu’à 100 enregistrements). Le résumé inclut le nombre total de relations créées, de classes mappées, de charges utiles partielles et incomplètes qu’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 du Centre d’intégration (RTE et IRE) sont informatifs. Toutefois, même si les propriétés système com.glide.import_set.importlog_level et sont glide.importlog.log_to_table définies pour ne pas ajouter de messages du journal INFO, Centre d’intégration ETL affiche les messages du journal INFO. Pour plus d’informations sur ces propriétés, reportez-vous à la rubrique 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 Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    2. Dans la page ETL Transform Map Assistant, dans la section Prévisualiser les échantillons de résultats d’intégration et planifier l’importation de la configuration guidée, sélectionnez Tester et restaurer les résultats d’intégration.
    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 de résumé 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 CI et afficher les informations.
      Remarque :
      L’ordre des colonnes d’attributs suit la liste de colonnes par défaut de la classe dans la plateforme. Tout d’abord, les colonnes par défaut de la classe s’affichent 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 à Tout > 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 annule tous les changements qui ont été apportés à la CMDB à la suite de l’exécution de cette 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 modifier toutes les configurations de relation.
      Remarque :
      Cliquer sur Modifier les relations annule tous les changements qui ont été apportés à la CMDB à la suite de cette exécution d’intégration.
    8. Cliquez sur les onglets Journal d’erreurs, Journal d’activité ou Journal d’avertissements pour consulter les détails respectifs consignés par IRE et RTE au cours de l’intégration.

      Les enregistrements de journaux IRE sont regroupés par catégories et organisés par 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 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 du journal.
      • 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 vers un message.
    9. 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.
    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 : toutes les modifications apportées à la CMDB suite à 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 dans son état d’avant l’exécution de 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 Tout > 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 les intégrations qui ont été téléchargées à partir du ServiceNow Store.
    2. Dans la page 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 de l’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 Envoyer.
      Pour plus d’informations sur les champs de formulaire, reportez-vous à la rubrique Planifier une importation de données .
    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 provenant de l’application IntegrationCommons for CMDB Store 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 « faux » :
      • « input_1 »
      • “”
      • 0
      • 11

    Convertir en date

    Tente de convertir la valeur entrante en GlideDateTime valeur en appliquant la date_format à 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 en cas d’impossibilité d’analyse.

    Champs supplémentaires date_format (format de date Java simple)
    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 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 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 avoir supprimé 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 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 le maximum ou le minimum 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, en 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 entité (à la recherche de sys_rte_eb_field.field, et non sys_rte_eb_field.namede ).

    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 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 au , spécifié match_regex, par 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&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 correspondant à la valeur de chaîne spécifiée match_string, par 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 entrée, définissant la sortie target_field == pour ce script.

    Cette transformation a été remplacée par la transformation de script multi-entrées 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) : 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 du script à entrées multiples.
    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 vrai, la valeur actuelle du champ cible est remplacée. Dans le cas contraire, 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 : valeur1, cible2 : valeur2, cible3 : valeur3
    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

    Met la valeur en majuscule 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 « valeur 1 »
    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 « valeur 1 »
    Résultat « VALEUR1 »