Hiérarchie de l’organisation Connecteur entrant

À propos du connecteur entrant de la Hiérarchie de l’Organisation

Les hiérarchies d’ organisation vous permettent de télécharger votre structure d’organisation dans XM Discover afin d’améliorer l’analyse des données, la personnalisation des utilisateurs et le contrôle de l’accès aux données. Vous pouvez utiliser le connecteur entrant de hiérarchie d’organisation pour télécharger et mettre à jour les hiérarchies d’organisation.

Préparation d’un fichier de hiérarchie d’organisation

Avant de pouvoir configurer un job de réception de la hiérarchie de l’organisation, vous devez vous assurer que vos données de hiérarchie de l’organisation sont dans le bon format et qu’elles contiennent votre structure d’organisation.

Les hiérarchies d’organisations peuvent être téléchargées à l’aide d’un fichier CSV ou Excel (XLS ou XLSX).

Voir les meilleures pratiques en matière de hiérarchies d’organisation pour des exemples et des directives de mise en forme pour chaque type de fichier.

Exemple : Vous trouverez ci-dessous un fichier Excel présentant un exemple d’organigramme pour une société hôtelière.

Mise en place d’une Hiérarchie de l’Organisation Inbound Job

Suivez les étapes ci-dessous pour configurer un travail de réception de la hiérarchie de l’organisation. Cette configuration nécessite de générer une clé API Hiérarchie dans Studio, ce qui est recommandé avant d’effectuer les étapes ci-dessous.

1. Dans l’onglet Travaux, cliquez sur Nouveau travail.
   
2. Sélectionnez Hiérarchie de l’organisation.
   
3. Donnez un nom à votre travail afin de pouvoir l’identifier.
   
4. Choisissez le projet dans lequel vous souhaitez charger les données.
5. Donnez une description de votre poste afin d’en connaître l’objectif.
6. Cliquez sur Suivant.
7. Choisissez la méthode d’authentification pour votre serveur SFTP :
   • Authentificateur de base: Connexion à l’aide d’un nom d’utilisateur et d’un mot de passe.
   • Clé SSH: Connectez-vous à l’aide d’une clé Secure Shell (SSH) que vous fournissez ou d’une clé fournie par Qualtrics.
8. Utilisez le menu déroulant pour sélectionner une connexion existante ou sélectionnez Ajouter nouveau pour établir une nouvelle connexion. Voir Ajouter un compte SFTP pour plus d’informations sur la création d’une nouvelle connexion.
9. Cliquez sur Suivant.
10. Choisissez le type de hiérarchie :
    • Filtre personnalisé
      • Classification Delta
      • Classification traditionnelle
    • Filtre d’attributs
      Astuce : survolez l’icône d’information suivant le nom de la hiérarchie pour en savoir plus sur celle-ci et ses cas d’utilisation.
11. Cliquez sur Suivant.
12. Si vous utilisez un type de hiérarchie “Hiérarchie traditionnelle”, vous devrez également saisir un Clé API Hiérarchie. Sinon, passez à l’étape suivante.
13. Donnez un nom à votre hiérarchie.
    Astuce : Vous pouvez mettre à jour une hiérarchie existante en vous assurant que le nom que vous saisissez ici correspond exactement au nom de la hiérarchie existante.
14. Choisissez vos paramètres de hiérarchie. Les options proposées ici dépendent du type de hiérarchie sélectionné à l’étape 10 :
    • Classification Delta
      • Télécharger la Hiérarchie de l’organisation: Créer et activer une hiérarchie d’organisation. Par défaut, la hiérarchie de l’organisation activée n’est pas publiée et permet uniquement la personnalisation du tableau de bord. Lorsque cette option est activée, les sous-options suivantes sont également disponibles :
        • Générer des groupes sur la base de ce fichier d’utilisateurs: Créer des groupes sur la base du fichier de la hiérarchie de l’organisation.
        • Ignorer les utilisateurs inexistants: Ignorer les utilisateurs qui ne correspondent pas à des utilisateurs Discover existants.
    • Charger la Hiérarchie de l’Organisation et Publier: Créer, activer et publier une hiérarchie d’organisation. Publier une hiérarchie d’organisation permet de regrouper les informations en fonction de leurs niveaux. Il s’agit d’une condition préalable à l’établissement de rapports sur les pairs et les parents, ainsi que sur les cibles et les écarts. Cela permet également de créer un modèle de catégorie cachée pour prendre en charge d’autres cas d’utilisation. Le modèle reflète la structure et les filtres de la hiérarchie de l’organisation. Lorsque cette option est activée, les sous-options suivantes sont également disponibles :
      • Inclure les enregistrements sans texte: Inclure les enregistrements avec des verbatims vides dans votre hiérarchie de l’organisation.
      • Inclure dans les flux de données incrémentiels: Inclure la hiérarchie de l’organisation dans les flux de données
        incrémentaux
        Astuce : Si vous pensez que la publication d’une hiérarchie d’organisation entrera en conflit avec d’autres flux de données, nous vous recommandons de désélectionner cette option. Le modèle créé et classé par la suite ne bloquera pas les autres flux de données si cette option est désactivée.
      • Appliquer aux données historiques: Appliquer la hiérarchie de l’organisation aux données historiques.
      • Générer des groupes sur la base de ce fichier d’utilisateurs: Créer des groupes sur la base du fichier de la hiérarchie de l’organisation.
      • Ignorer les utilisateurs inexistants: Ignorer les utilisateurs qui ne correspondent pas à des utilisateurs Discover existants.
    • Classification traditionnelle:
      • Télécharger la Hiérarchie de l’organisation: Créer et activer une hiérarchie d’organisation. Par défaut, la hiérarchie de l’organisation activée n’est pas publiée et permet uniquement la personnalisation du tableau de bord. Lorsqu’elle est activée, la sous-option suivante est également disponible :
        • Générer des groupes sur la base de ce fichier d’utilisateurs: Créer des groupes sur la base du fichier de la hiérarchie de l’organisation.
      • Charger la Hiérarchie de l’Organisation et Publier: Créer, activer et publier une hiérarchie d’organisation. Publier une hiérarchie d’organisation permet de regrouper les informations en fonction de leurs niveaux. Il s’agit d’une condition préalable à l’établissement de rapports sur les pairs et les parents, ainsi que sur les cibles et les écarts. Cela permet également de créer un modèle de catégorie cachée pour prendre en charge d’autres cas d’utilisation. Le modèle reflète la structure et les filtres de la hiérarchie de l’organisation. Lorsque cette option est activée, les sous-options suivantes sont également disponibles :
        • Inclure les enregistrements sans texte: Inclure les enregistrements avec des verbatims vides dans votre hiérarchie de l’organisation.
        • Inclure dans les flux de données incrémentiels: Inclure la hiérarchie de l’organisation dans les flux de données
          incrémentaux
          Astuce : Si vous pensez que la publication d’une hiérarchie d’organisation entrera en conflit avec d’autres flux de données, nous vous recommandons de désélectionner cette option. Le modèle créé et classé par la suite ne bloquera pas les autres flux de données si cette option est désactivée.
        • Générer des groupes sur la base de ce fichier d’utilisateurs: Créer des groupes sur la base du fichier de la hiérarchie de l’organisation.
    • Filtre d’attributs
      • Ignorer les utilisateurs inexistants: Ignorer les utilisateurs qui ne correspondent pas à des utilisateurs Discover existants.
15. Cliquez sur Suivant.
16. Choisissez le type de fichier que vous souhaitez télécharger :
    
    • Fichiers “plats” séparés par des délimiteurs
    • Fichiers Excel (XLS, XLSX)
17. Pour les fichiers plats séparés par des délimiteurs, vous pouvez choisir des paramètres supplémentaires :
    
    • Encodage du fichier: Choisissez le système d’encodage du fichier (UTF-8, ASCII, etc)
    • Caractère de délimitation: Saisissez le caractère utilisé pour délimiter les entrées de données. Par défaut, il s’agit d’une virgule pour les fichiers CSV.
    • Caractère de clôture: Saisissez le caractère qui entoure la saisie des données. Laisser ce champ vide si l’option “Pas de clôture” est sélectionnée.
    • Pas de clôture: activez cette option si votre fichier ne contient pas de caractères de clôture.
18. Cliquez sur Parcourir et choisissez le chemin du dossier sur votre serveur SFTP qui contient le fichier que vous souhaitez télécharger.
    Astuce : Lorsque vous choisissez un chemin d’accès à un dossier, vous pouvez cliquer sur l’icône d’un dossier pour le développer. Cliquez sur le nom du dossier pour le sélectionner, puis cliquez sur Ok lorsque vous avez terminé.
19. Saisissez l’expression régulière du nom de fichier qui correspond aux fichiers que vous souhaitez télécharger.
20. Si vos fichiers sont compressés, activez l’option Décompresser le(s) fichier(s) et saisissez l’expression régulière Nom du fichier compressé qui correspond aux fichiers à décompresser.
    
21. Si vos fichiers sont décryptés, activez l’option Décrypter le(s) fichier(s) et entrez ce qui suit :
    • Expression régulière du nom de fichier crypté: Saisissez l’expression régulière du nom de fichier pour les fichiers qui doivent être décryptés.
    • Clé PGP/GPG: Entrez la clé PGP/GPG utilisée pour le cryptage.
    • Phrase de passe: Entrez la phrase d’authentification pour le décryptage.
22. Si vos fichiers sont à la fois compressés et cryptés, vous devez choisir ce qui doit se produire en premier :
    • Décompresser puis décrypter: Les fichiers sont décompressés puis décryptés.
    • Décryptage puis décompression: Les fichiers sont décryptés puis décompressés.
23. Vous devez fournir un échantillon de fichier, qui peut être enregistré sur votre ordinateur ou sur votre serveur SFTP :
    
    • Sélectionnez Télécharger l’échantillon à partir du stockage de fichiers si le fichier échantillon est enregistré sur votre serveur SFTP.
    • Sélectionnez Télécharger l’échantillon depuis mon ordinateur si l’échantillon est enregistré sur votre ordinateur.
      Astuce : si nécessaire, vous pouvez télécharger un fichier modèle en cliquant sur le lien ici affiché dans la configuration du travail.
24. Par défaut, votre fichier échantillon n’est pas utilisé pour générer la hiérarchie de l’organisation. Si vous souhaitez que votre fichier échantillon soit utilisé pour la première exécution du travail, activez l’option Utiliser le fichier échantillon téléchargé pour la première exécution du travail.
25. Cliquez sur le bouton Sélectionner un fichier et choisissez le fichier échantillon sur votre ordinateur ou sur votre serveur SFTP.
26. Un aperçu du fichier s’affiche. Si vous voyez un message d’erreur ou le contenu d’un fichier brut au lieu de l’aperçu, il se peut qu’il y ait un problème avec les options de format de données que vous avez sélectionnées. Reportez-vous à la section Erreurs dans les échantillons de fichiers pour obtenir de l’aide sur le dépannage de votre fichier.
27. Cliquez sur Suivant.
28. Commencez à mettre en correspondance les champs de votre fichier d’échantillons avec les champs de la hiérarchie de l’organisation dans XM Discover. Cliquez sur la case de la colonne Mappage pour choisir un champ de la hiérarchie de l’organisation XM Discover à mettre en correspondance avec votre champ importé. Les champs possibles de la hiérarchie de l’organisation sont les suivants :
    
    • Niveau 1 à Niveau 10: Définissez la structure de votre hiérarchie. Le nombre maximum de niveaux de hiérarchie est de 10.
    • Utilisateurs: Associez les utilisateurs à votre Hiérarchie.
    • Filtres: Définissez les filtres pour votre hiérarchie.
    • Enrichissements: Créez des paramètres d’enrichissement pour votre hiérarchie. Le nombre maximum d’enrichissements est de 6.
29. Si nécessaire, vous pouvez transformer les données entrantes en cliquant sur l’icône en forme de roue dentée dans la colonne Transformations.
30. Vous pouvez ajouter des champs supplémentaires en cliquant sur le signe plus ( + ) ou supprimer des champs en cliquant sur le signe moins ( – ) à côté du champ.
31. Cliquez sur Suivant lorsque vous avez fini de mapper les champs.
32. Choisissez vos paramètres de notification.
    
33. Cliquez sur Suivant.
34. Choisissez Planifier des exécutions incrémentielles si vous souhaitez que votre travail s’exécute périodiquement selon un calendrier, ou Configurer un tirage unique si vous souhaitez que le travail ne s’exécute qu’une seule fois. Pour plus d’informations, voir Planification des tâches.
    
35. Choisissez un délai de conservation pour les fichiers traités. Les fichiers sont supprimés après la période définie.
36. Cliquez sur Suivant.
37. Évaluateur. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape de la configuration du connecteur.
    
38. Cliquez sur Terminer pour enregistrer le travail.