Exemples de mappage d'importation en bloc

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

    • Il est essentiel de mapper vos documents d'employés sources aux éléments requis dans Employee Document Management pour réussir l'importation en bloc.

    Cette rubrique fournit des exemples sur la façon de mapper vos documents d'employés sources aux éléments requis dans Employee Document Management. Les valeurs fournies sont des exemples conçus pour vous guider à travers la configuration du mappage d'importation.

    Mapper des champs et des valeurs directement à partir de noms de fichiers existants

    Utiliser vos noms de fichiers de documents d'employés existants est recommandé lorsque vos documents d'employés sources sont situés dans un référentiel local.

    Par exemple, un document d'employé peut contenir toutes les métadonnées dans le nom de fichier Abel_Tuter_tuition.pdf à mapper dans Employee Document Management.
    Remarque :
    Lorsque vous utilisez des expressions régulières (RegEx) pour définir une valeur de remplacement, utilisez un site de test de l'expression régulière pour assurer une analyse correcte.
    Exemple de nom de fichier
    L'exemple de nom de fichier est abel_tuter_tuition.pdf.
    Pour trouver et extraire le nom du fichier du référentiel source, voir l'exemple ci-dessous :
    Mappage d'importation — Nom du fichier
    Le mappage d'importation recherche un élément source appelé fileName.
    Le mappage d'importation va traduire cet élément source en un élément mappé appelé fileName.
    La Regex recherche le format du nom de fichier first_last_xxx.pdf.
    Exemple de nom de fichier vers nom d'employé
    Le nom d'employé est extrait à partir du nom du fichier. Le nom d'employé est obligatoire pour Employee Document Management.
    Mappage d'importation — Nom d'employé
    Le mappage d'importation recherche un élément source appelé fileName.
    Le mappage d'importation va traduire cet élément source en un élément mappé appelé employee.
    La Regex recherche le format du nom de fichier first_last_tuition.pdf (\w+)_(\w+)_(\w+).(\w+).
    Elle remplace le nom de fichier original par first.last ($1.$2)
    Exemple de nom de fichier vers type de document
    Le type de document est extrait à partir du nom du fichier. Le type de document est obligatoire pour Employee Document Management.
    Mappage d'importation — docType
    Le mappage d'importation recherche un élément source appelé fileName.
    Le mappage d'importation va traduire cet élément source en un élément mappé appelé docType.
    La Regex recherche le format du nom de fichier first_last_tuition.pdf (\w+)_(\w+)_(\w+).(\w+).
    Elle crée un docType d'enseignement ($3).
    Remarque :
    Il est fortement recommandé de placer tous les documents d'employés sources dans un référentiel central, d'avoir une structure d'annuaire simple et d'utiliser une convention de dénomination cohérente pour réduire les erreurs.

    Analyser et mapper les champs et valeurs à partir d'un fichier de sortie JSON

    Utiliser un fichier de sortie JSON est recommandé lorsque les documents d'employés sources sont situés dans un référentiel tiers basé sur le cloud.

    Tableau 1. Enregistrement de mappage pour l'élément item
    Champ Description
    Type de mappage Champ
    Élément mappé items

    Recherche l'élément items de mappage dans un tableau d'éléments du dossier.

    Ce mappage est utilisé après la source d'importation Étape — Répertoire.
    Élément source entries

    Élément source dans le fichier de sortie JSON qui représente les éléments d'un dossier. Par exemple, Box utilise entries comme élément source.

    JSON — entries

    Tableau 2. Enregistrement de mappage pour l'élément employee
    Champ Description
    Type de mappage Champ
    Élément mappé Élément

    Recherche l'article, une entrée dans un tableau d'éléments dans le dossier.

    Ce mappage est utilisé après la source d'importation Étape — Répertoire pour exécuter des opérations contre un seul élément.
    Élément source id

    Pour chaque élément du tableau, trouvez l'ID du fichier dans le fichier de sortie JSON.
    Regex de filtre fichier

    Combiné au champ de filtre pour exclure les sous-dossiers.
    Champ de filtre type

    Filtrer le fichier de sortie à l'endroit où le champ de type est égal au fichier dans lequel exclure des sous-dossiers.

    JSON — item

    Tableau 3. Ajouter des enregistrements de mappage pour l'élément employee (suite)
    Champ Description
    Type de mappage Champ
    Regex (\w+)\s(\w+)

    Traduction de chaînes pour convertir fname lname en fname.lname.
    Remplacer $1.$2

    Convertit les fichiers trouvés dans le champ Regex fname lname en fname.lname.
    Élément mappé employee

    Recherche l'élément de mappage employee. Employee est un champ dans l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source owned_by.name

    Recherche le nom dans l'objet owned_by. Il permet de contourner les objets imbriqués avec une notation de point.
    Regex de filtre
    JSON — Owned by et Name
    Tableau 4. Ajouter un enregistrement de mappage pour l'élément employee (alternatif)
    Champ Description
    Type de mappage Valeur

    Sélectionner Valeur permet de mapper l'élément employee dans un tableau d'informations de votre document source en une valeur spécifique dans Employee Document Management.
    Remplacer david.loo

    La valeur par laquelle vous souhaitez remplacer l'élément source dans Employee Document Management.

    Employee Document Management exige que les noms d'employés soient au format fname.lname.
    Élément mappé employee

    Recherche l'élément de mappage employee qui est un champ dans l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source davidl

    Recherche la valeur source de davidl.
    Cet exemple décrit comment utiliser le mappage de la valeur pour extraire un nom d'employé de votre document source et le mapper au format exigé par Employee Document Management.
    Tableau 5. Ajouter des enregistrements de mappage pour l'élément docType
    Champ Description
    Type de mappage Champ
    Élément mappé docType

    Recherche l'élément de mappage docType intégré dans le champ de description de l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source description

    Recherche le nom dans la description.
    Regex de filtre
    JSON — description
    Tableau 6. Ajouter des enregistrements de mappage pour l'élément docType (suite)
    Champ Description
    Type de mappage Valeur

    Utilisez Valeur pour mapper une valeur spécifique dans votre référentiel tiers basé sur le cloud en une valeur dans Employee Document Management.
    Remplacer employee verifications

    Remplacer verification (source) par employee verifications (Employee Document Management).
    Élément mappé docType

    Recherche l'élément de mappage docType intégré dans le champ de description de l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source verification

    Recherchez la valeur de nom de verification dans le fichier JSON.
    Tableau 7. Ajouter des enregistrements de mappage pour l'élément docType (suite)
    Champ Description
    Type de mappage Valeur

    Utilisez Valeur pour mapper une valeur spécifique dans votre référentiel tiers basé sur le cloud en une valeur dans Employee Document Management.
    Remplacer transcripts

    Remplacez school (source) par transcripts (Employee Document Management).
    Élément mappé docType

    Recherche l'élément de mappage docType intégré dans le champ de description de l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source school

    Recherchez la valeur de nom school.
    Tableau 8. Ajouter un enregistrement de mappage pour l'élément fileName
    Champ Description
    Type de mappage champ
    Élément mappé fileName

    Recherche l'élément de mappage fileName intégré dans le champ de nom de l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source nom

    Recherche le nom du fichier dans la description du fichier de sortie JSON.
    Regex de filtre

    JSON — Nom

    Tableau 9. Ajouter un enregistrement de mappage pour l'élément URL
    Champ Description
    Type de mappage champ
    Élément mappé URL

    Recherche l'élément de mappage url intégré dans le champ id dans l'élément de fichier.

    Ce mappage est utilisé après la source d'importation Étape — Fichier.
    Élément source Recherche id dans le fichier de sortie JSON.
    Remarque :
    certains référentiels tiers basés sur le cloud utilisent l'ID de fichier. La source d'importation de capture construit une URL à partir de cette valeur.
    JSON — id

    Enregistrements de mappage d'importations en bloc

    Exemple de mappage d'importation des documents d'employés

    Mappage d'importation

    Lorsqu'une connexion à votre référentiel source est confirmée et que les mappages d'importation sont configurés correctement, vous pouvez cliquer sur Démarrer la tâche de préparation à partir de Liens connexes.