Créer une carte de champ

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • Les cartes de champs établissent une relation entre un champ d’une table de jeu d’importation et un champ de la table cible.

    Avant de commencer

    Rôle requis : import_transformer, import_admin ou admin

    Pourquoi et quand exécuter cette tâche

    La carte de champs détermine les valeurs de la table source que la transformation ajoute à la table cible.

    Procédure

    1. Accédez à la Tout > Ensembles de données à importations système > Cartes de transformation.
    2. Ouvrez une carte de transformation.
    3. Dans la liste connexe Cartes de champ, cliquez sur Nouvelle.
    4. Renseignez le formulaire.
      Tableau 1. Champs de carte de champs
      Champ Description
      Carte Carte de transformation qui utilise ce mappage de champs (rempli automatiquement).
      Table source Table à partir de laquelle les données brutes du jeu d’importation sont chargées (la source de la transformation). Rempli automatiquement à partir de la carte de transformation.
      Champ source Champ de la table source à transformer. Peut être vide si la table source ne contient que des données brutes.
      Action d'option Spécifie l’action à effectuer si le jeu d’importation contient une valeur de référence ou de choix autre que celles disponibles. S’affiche si le champ cible est une liste de choix ou un champ de référence.
      • create : créer un nouveau choix ou un nouvel enregistrement dans la table de référence.
      • ignorer : ignorer la nouvelle valeur de la table source.
      • rejeter : ignorer la ligne entière (enregistrement) contenant la nouvelle valeur et passer à la ligne suivante.
      Format de date Format de date du champ source. S’affiche si le champ cible est un champ Date ou Date/Heure.
      Remarque :
      Pour en savoir plus sur les formats de date autorisés, consultez Format de champ de date et d’heure global.
      Utiliser script source Case à cocher pour utiliser un script au lieu du champ Source.
      Demande Périmètre de l’application : global ou par application.
      Table cible Table dans laquelle les données transformées sont insérées. Vous pouvez sélectionner uniquement les tables dans le périmètre de l’application actuellement sélectionné ou le périmètre global, ou les tables qui accordent l’accès en écriture à d’autres applications.
      Champ cible Champ dans la table cible où la valeur du champ source est stockée.
      Nom de la valeur de champ référencé Lorsque le champ cible est un champ de référence, la carte de transformation doit trouver un moyen de faire correspondre les valeurs sources entrantes aux enregistrements existants dans la table source du champ de référence. Étant donné que la plupart des importations ne fournissent pas de valeur sys_id de 32 caractères, vous devez spécifier une colonne à partir de la table source du champ de référence qui contient des valeurs qui correspondent aux valeurs source entrantes.

      Lorsqu’il existe un enregistrement correspondant, la carte de transformation stocke le sys_id de l’enregistrement correspondant dans le champ cible. S’il n’y a pas d’enregistrement correspondant, la carte de transformation crée un nouvel enregistrement dans la table du champ de référence et stocke le sys_id du nouvel enregistrement dans le champ cible.

      Si vous laissez ce champ vide, la carte de transformation recherche les valeurs correspondantes dans la colonne Valeur d’affichage de la table des champs de référence.

      Par exemple, supposons que vous importez des enregistrements d’incidents et que les données entrantes répertorient les ID d’utilisateurs pour le champ Affecté à . Si vous laissez le nom du champ de la valeur référencée vide, la carte de transformation recherche les valeurs correspondantes dans la colonne de valeur d’affichage de la table Utilisateur : nom. En définissant le nom du champ Valeur référencée sur la colonne user_name, vous pouvez faire correspondre les valeurs de l’ID d’utilisateur aux enregistrements utilisateur appropriés.

      Fusion La configuration d’un champ cible à fusionner entraîne le traitement du champ par le jeu d’importation comme une clé unique. Lorsque cette option est sélectionnée, l’application de jeu d’importation tente de faire correspondre les valeurs sources aux enregistrements avec des valeurs d’un enregistrement existant. Si une correspondance est trouvée, la carte de transformation met à jour l’enregistrement au lieu de créer un nouvel enregistrement. Si la valeur est définie sur false, l’application de jeu d’importation crée toujours de nouveaux enregistrements pour chaque transformation. Si plusieurs champs sont définis pour fusionner, toutes les valeurs de fusion doivent correspondre à un enregistrement existant. Si deux champs sont définis pour la fusion et qu’une valeur correspondante est trouvée pour l’un des champs de fusion, mais pas pour l’autre, un nouvel enregistrement est inséré.

      Vous devez créer un index sur la table cible si aucun des champs de fusion n’est indexé. L’indexation peut améliorer les performances des opérations de lecture et d’écriture. Si un ou plusieurs champs de fusion ont déjà un index, vous n’avez pas besoin de créer un index supplémentaire.

      Après avoir défini la valeur Fusion pour tous les champs de la table cible, utilisez le lien connexe Indexer les champs de fusion pour créer un index. Avant de créer l’index, assurez-vous que la valeur Fusion est définie correctement pour tous les champs de la table cible afin d’éviter de créer des index inutiles pour la même table cible.

      L’index doit être concaténé ; ce qui signifie que tous les champs spécifiés pour être fusionnés doivent être dans le même index. La configuration correcte consiste à inclure un index tous les champs fusionnés.

      Fusion de champs vides Case à cocher pour faire correspondre une valeur de champ source vide à une valeur de champ cible vide. Par exemple, la carte de transformation de l’utilisateur fusionne dans le champ E-mail. Lorsque cette option est sélectionnée, un enregistrement source contenant une adresse e-mail vide fusionne en un enregistrement cible contenant une adresse e-mail vide.
      Sensible à la casse lors de la fusion Case à cocher pour que les valeurs de fusion sensibles à la casse entraînent la création de nouveaux enregistrements. Par défaut, les valeurs marquées comme Fusion sont utilisées dans une recherche non sensible à la casse pour les enregistrements existants. Les enregistrements non sensibles à la casse mettent à jour uniquement les enregistrements existants et n’entraînent pas la création de nouveaux enregistrements.
    5. Cliquez sur Enregistrer.
    6. Répétez les étapes 3 à 5 pour chaque mappage de champs.
    7. Cliquez sur Mettre à jour.