Options de mappage

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 6 minutes de lecture
  • Vous pouvez mapper les champs de plusieurs façons en fonction des circonstances de l’importation et de la nécessité de transformer les données avant de les charger sur une table de production.

    Il est également important de noter qu’une opération d’importation donnée peut nécessiter l’utilisation de plusieurs méthodes de mappage, et que ces méthodes peuvent être facilement utilisées conjointement les unes avec les autres.

    Utilitaire de mappage automatique

    La méthode de mappage la plus simple consiste à associer tous les noms de champs des jeux d’importation aux noms des champs des tables de production dans lesquelles les données seront transformées. Dans ce cas, cliquez simplement sur Correspondance automatique des champs dans la liste connexe du formulaire Carte de transformation de table et confirmez la correspondance appropriée. En cas de différences dans la façon dont les champs ont été automatiquement mis en correspondance, utilisez l’utilitaire d’aide au mappage pour les corriger. Lorsque tous les champs sont correctement mis en correspondance, cliquez sur le lien connexe Transformer pour commencer à transformer les données dans la table de destination.

    Utilitaire de l’assistant de mappage

    L’utilitaire d’assistant de mappage fournit un environnement visuellement intuitif pour spécifier le mappage entre les champs de jeu d’importation et les champs de table de production. L’utilitaire d’assistant de mappage permet de mapper un seul champ source (champ sur une table de jeu d’importation) sur plusieurs champs de destination (champs sur une table de production).
    Figure 1. Assistant de mappage

    Modification du format de la date

    Si le format de date du champ source ne correspond pas au format du champ cible, vous pouvez définir un mappage de format de date pour transformer les dates d’un format à un autre. Par exemple, ce mappage spécifie que le format de date du fichier source CSV utilise le format MM-jj-aaaa .
    Figure 2. Format de date de la carte de champ
    Figure 3. Options de format de date de la carte de champ
    Les options de format de date sont les suivantes :
    Tableau 1. Options de mappage
    Format de date Description
    jj-mm-aaaa Jour-mois-année
    jj-MM-aaaa hh :mm :ss Jour-mois-année heures-minutes-secondes
    jj-MM-aaaa hh :mm :ss z Jour-mois-année heures-minutes-secondes fuseau horaire
    mm-jj-aaaa Mois-jour-année
    MM-jj-aaaa hh :mm :ss Mois-jour-année heures-minutes-secondes
    MM-jj-aaaa hh :mm :ss z Mois-jour-année, heures, minutes, secondes, fuseau horaire
    aaaa-jj-MM Année-jour-mois
    aaaa-MM-jj Année-mois-jour
    aaaa-MM-jj hh :mm :ss Année-mois-jour heures-minutes-secondes

    Pour indiquer le format d’heure de 24 heures, spécifiez un format de date personnalisé à l’aide de HH :mm :ss au lieu de hh :mm :ss.

    Remarque :

    Si vous passez d’un format de date de 24 heures à un format de date de 12 heures, les plages comprises entre 12 h 00 et 23 h 59 peuvent être formatées entre 00 h 00 et 11 h 59.

    Mappage à un champ de durée

    ServiceNow Les champs Durée utilisent un type de données spécial qui indique le nombre de millisecondes de la valeur de durée. Pour mapper des données importées à un champ de durée, utilisez l’une des méthodes suivantes pour transformer les valeurs sources en durée.
    • Calculer la durée à partir d’une date de début et d’une date de fin
    • Convertir une valeur de durée existante en une ServiceNow valeur de durée

    Calcul d’une valeur de durée à partir d’une date de début et d’une date de fin

    Si la source d’importation a une date de début et une date de fin, vous pouvez calculer une durée avec JavaScript.
    1. Accédez à la Ensembles de données à importations système > Cartes de transformation.
    2. Sélectionnez la carte de transformation pour laquelle vous souhaitez calculer une valeur de durée. Par exemple, la carte de transformation de notification qui importe dans la table Incident.
    3. Cochez la case Exécuter le script .
    4. Entrez JavaScript pour transformer les dates de début et de fin en une durée. Voir l’exemple de script.
    5. Cliquez sur Mettre à jour.
    Cet exemple de script transforme les champs source.u_start et source.u_end en une valeur de durée dans le champ target.duration. Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible selon vos besoins.
    target.duration = gs.dateDiff(source.u_start.getDisplayValue(), source.u_end.getDisplayValue(), false);

    Convertir une valeur de durée en valeur de durée ServiceNow

    Si la source d’importation contient déjà une date de début et une valeur de durée, vous pouvez convertir la durée existante en ServiceNow durée. Par exemple, vous pouvez avoir une source de données Excel qui indique une durée en secondes. ServiceNow S’attend à ce que les durées aient des valeurs en millisecondes.
    1. Accédez à la Ensembles de données à importations système > Cartes de transformation.
    2. Sélectionnez une carte de transformation.

      Par exemple, la carte de transformation de notification qui importe dans la table Incident.

    3. Cochez la case Exécuter le script .
    4. Entrez JavaScript pour convertir les valeurs de durée existantes en valeurs de ServiceNow durée. Voir l’exemple de script.
    5. Cliquez sur Mettre à jour.
    Cet exemple de script convertit une durée en secondes (à partir du source.u_duration champ) en une durée en millisecondes (sur le target.duration terrain). Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible, selon vos besoins.
    //Transform the value in source.u_duration from seconds to milliseconds
    target.duration.setDateNumericValue(source.u_duration * 1000);
    Cet exemple de script convertit une durée déjà en millisecondes (à partir du source.u_duration champ) en une ServiceNow durée (dans le target.duration champ). Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible, selon vos besoins.
    //Transform the value in source.u_duration to ServiceNow format
    target.duration.setDateNumericValue(source.u_duration);

    Utilisation d’un script pour calculer une valeur source

    Vous pouvez utiliser un script source au lieu du champ Source lorsque :
    • La valeur source n’est pas au format de la valeur cible mappée.
    • Vous devez rechercher une valeur avant de la mapper au champ cible.
    • La valeur source doit être calculée à partir de plusieurs champs.
    • Vous devez créer une valeur de fusion composée ou calculée dans le champ cible.
    Par exemple, cet exemple de script source calcule la valeur du champ user_name lorsqu’il est vide dans la source.
    Figure 4. Script source de carte de champ

    Un script source s’attend à ce que la valeur calculée soit définie dans la variable globale answer.

    Mappage des champs binaires ou BLOB

    ServiceNow utilise un processus spécial pour importer des données binaires et BLOB (Binary Large Object) à partir de sources de données JDBC. Toutes les données binaires sont automatiquement converties en enregistrement dans la table des pièces jointes [sys_attachment] avant que la transformation ne se produise. La table de jeu d’importation stocke uniquement la valeur sys_id de l’enregistrement de pièce jointe dans le champ de la table d’importation au lieu de la valeur binaire réelle. Par exemple, supposons que vous utilisez une source de données JDBC pour importer des données à partir d’un système CA Service Desk, qui stocke la valeur de clé de chaque enregistrement sous forme de données binaires. Lorsque vous importez les valeurs de clé du Centre de services dans une ServiceNow table, le ServiceNow champ contient uniquement une référence sys_id aux données binaires correspondantes dans la table Enregistrement de pièce jointe [sys_attachment] plutôt que les données binaires réelles.

    Pour qu’une carte de transformation accède à la pièce jointe, utilisez l’API GlideRecord dans un script onAfter . Le script doit s’exécuter dans un événement onAfter car l’objet target.sys_id n’est disponible qu’une fois les données placées dans la table de jeux d’importation. Par exemple, pour mapper la pièce jointe résultante à l’enregistrement de transformation cible, vous pouvez utiliser le script suivant.
    var agr = new GlideRecord("sys_attachment");
      agr.addQuery("sys_id", source.u_blob_field);
      // the source field needs to be mapped to the source that is the BLOB
      agr.query();
       if(agr.next()) {
        agr.table_name = "cmdb_ci"; // the target table of the transform map
        agr.table_sys_id = target.sys_id; // the target record
        agr.content_type = source.u_contentype; 
        // the content type string if available,  
        // this becomes the mime encoding when clicking an attachment link
        agr.update(); // finally, move/re-attach the attachment to the target row }
    Si vous effectuez un mappage directement à la table db_image , exécutez le script onAfter suivant pour afficher l’image :
    var strTemp = source.u_file_name; 
    var fType = strTemp.substr(- 3); 
    var iCont = "" ;
     
     if(fType == 'jpg') {
      iCont = 'jpeg' ; } 
     else {
      iCont = fType; }
     
     var agr = new GlideRecord("sys_attachment");
     agr.addQuery("sys_id", source.u_blob_field);
     agr.query();
     
     if(agr.next()) {
      agr.table_name = "ZZ_YYdb_image";
      agr.table_sys_id = target.sys_id;
      agr.content_type = 'image/' + iCont;
      agr.file_name = 'image';
      agr.update(); }