Extraire les données du salarié depuis la tâche SuccessFactors
À propos de l’extraction des données des employés depuis SuccessFactors
La tâche Extraire les données des salariés de SuccessFactors automatise l’exportation des données des salariés depuis SuccessFactors. Vous pouvez importer les données principales des employés (nom, e-mail, identifiant unique), les métadonnées des employés (sexe, rôle, service, etc.) et les données de hiérarchie d’organisation (responsable, site) selon une planification récurrente que vous définissez. Une fois vos données importées dans Qualtrics, elles doivent être enregistrées à l’aide d’une tâche de chargement de données, généralement les utilisateurs chargés dans la tâche du répertoire EX.
Configuration d’une tâche d’extraction des données salariés depuis SuccessFactors
- Créez un workflow ETL.
- Sélectionnez Source de données (extracteur ETL).
- Sélectionnez Extraire les données des employés de SuccessFactors.
- Sélectionnez un compte SuccessFactors à utiliser.
- Si vous souhaitez ajouter un nouveau compte SuccessFactors à utiliser, cliquez sur Ajouter un nouveau compte utilisateur.
Astuce Qualtrics : après avoir cliqué sur Ajouter un nouveau compte utilisateur, vous serez invité à saisir les informations de votre compte SuccessFactors. Consultez les informations de votre compte SuccessFactors pour obtenir de l’aide sur les champs requis.
- Cliquez sur Suivant.
- Quatre champs seront automatiquement mappés pour vous. Ces champs correspondent aux principaux champs de données des employés et sont généralement importés dans Qualtrics. Ces champs correspondent au prénom, au nom, à l’adresse e-mail et à l’identifiant unique de votre collaborateur. Si nécessaire, vous pouvez supprimer ces zones de votre mappage.
- Pour ajouter des champs supplémentaires à importer, cliquez sur Ajouter un champ.
Astuce Qualtrics : la plateforme Qualtrics ne prend pas en charge les emplois multiples pour un participant individuel de SuccessFactors. Si une zone a plusieurs valeurs, l’extracteur extrait la valeur qui a été la plus récemment modifiée. Nous ne prenons actuellement pas en charge la sélection d’autres valeurs. En outre, si vous avez plusieurs enregistrements pour le même employé dans SuccessFactors, la tâche Transformation de base doit être utilisée pour filtrer les valeurs qui ne sont pas l’emploi principal.
- Sélectionnez un champ SuccessFactors en cliquant sur le champ et en le sélectionnant dans la liste. Vous pouvez également saisir le nom de zone pour le retrouver plus rapidement. Vous pouvez effectuer une recherche par nom de zone (si disponible, par exemple, “Sexe”) ou par chemin de zone dans SuccessFactors (par exemple : personal_information/bir_name).
Astuce Qualtrics : les champs personnalisés peuvent être importés en saisissant le nom de champ SuccessFactors approprié (p. ex., personal_information/custom_fieldname). Les champs personnalisés n’apparaîtront pas lors de la saisie dans les résultats de la recherche. Les champs personnalisés doivent avoir un sous-champ “lastModifiedDateTime” pour être importés.
- Pour supprimer une zone, cliquez sur le signe moins ( – ) à droite de la zone.
- Cliquez sur Suivant.
- Un aperçu s’affiche, vous montrant un exemple de ce qui sera importé pour chaque champ que vous avez sélectionné.
- Si l’aperçu semble OK, cliquez sur Enregistrer. Si vous devez apporter des modifications à vos zones, cliquez sur le bouton Retour à la place.
Après avoir configuré votre tâche SuccessFactors, vous devez indiquer à Qualtrics où enregistrer vos données avec une tâche du chargeur de données. En règle générale, il s’agit du chargement des utilisateurs dans la tâche du répertoire EX.
Trouver les informations de votre compte SuccessFactors
Après avoir cliqué sur Ajouter un nouveau compte utilisateur, vous accédez à un écran vous permettant de saisir les identifiants OAuth de SuccessFactors. Rendez-vous sur notre page Configuration des tâches SuccessFactors avec identifiants OAuth pour obtenir les informations requises pour la configuration.
- Nom : il s’agit de l’intitulé que vous donnez à votre compte. Cette zone n’est pas utilisée pour l’authentification.
- Nom d’utilisateur : votre ID utilisateur SAP.
Avertissement : votre nom d’utilisateur et votre ID utilisateur SAP peuvent être différents. L’ID utilisateur est sensible à la casse.
- Clé API, clé privée du certificat X.509 : l’authentification par certificat X.509 ajoute une couche de protection supplémentaire à vos données. Lorsque vous enregistrez un client OAuth à l’aide de ce certificat, une clé API est également générée.
Astuce Qualtrics : il existe 2 options pour générer le certificat et la clé privée. Vous pouvez générer votre propre certificat et votre propre clé privée, ou SAP a une option à générer lors de l’enregistrement de l’application client OAuth2, que vous pouvez télécharger depuis SuccessFactors. Si vous générez une clé privée, elle doit être au format PKCS8. Pour plus d’informations, consultez la documentation de SAP.
Pour plus de détails sur ce processus, consultez la documentation SAP suivante :
-
- Enregistrement de votre application client OAuth2
- Création d’un certificat X.509 dans SAP SuccessFactors
- Génération d’une assertion SAML
- Demande d’un jeton d’accès
- Affichage de la validité d’un jeton d’accès
Astuce Qualtrics : les 3 derniers documents de cette liste sont destinés aux utilisateurs administrateurs de SuccessFactors ou à tout autre utilisateur autorisé à créer des intégrations OAuth. Pour obtenir de l’aide supplémentaire sur l’authentification du certificat, contactez le support de SuccessFactors.
- Domaine du centre de données : votre domaine SuccessFactors.
Astuce Qualtrics : N’incluez pas l’adresse http:// dans l’URL.
- Identifiant de l’entreprise : votre identifiant d’entreprise SuccessFactors.
Vous trouverez quelques-uns de ces champs sur votre page de connexion à SuccessFactors :
- Votre nom d’utilisateur est saisi dans le champ Nom d’utilisateur.
Avertissement : votre nom d’utilisateur et votre ID utilisateur SAP peuvent être différents. L’ID utilisateur est sensible à la casse.
- L‘identifiant de votre société apparaîtra au-dessus des champs de connexion.
Exemple : un ID de société exemple est Benefits itsSB.
- Votre domaine de centre de données se trouve dans votre URL une fois connecté à SuccessFactors.
Astuce Qualtrics : N’incluez pas l’adresse http:// dans l’URL.Exemple : un exemple de domaine de centre de données est apisalesdemo4.successfactors.com.
Si vous avez besoin d’aide pour accéder à vos informations SuccessFactors, consultez notre page Configurer les tâches SuccessFactors avec les identifiants OAuth ou contactez le support de SuccessFactors.
Dépannage des tâches SuccessFactors
Pour dépanner votre workflow, accédez au reporting des workflows et affichez la sortie de votre workflow. Si votre workflow a échoué, il contiendra des informations sur la raison de cet échec.
Identifiants de compte incorrects
Voir Configuration des tâches SuccessFactors avec les identifiants OAuth.
Les champs importés sont vides.
La tâche d’extraction des données des salariés de SuccessFactors affiche tous les champs non personnalisés associés à un compte SuccessFactors, mais il est possible que le champ sélectionné dans la tâche n’ait pas d’informations associées dans SuccessFactors. Assurez-vous que le chemin d’accès de la zone que vous avez sélectionné correspond à une zone renseignée dans SuccessFactors. Notez que certains noms de champs peuvent être associés à plusieurs sites dans SuccessFactors. Par exemple, “/personal_information/created_by” et “address_information/created_by” sont des champs différents !
Erreurs de champs courantes
Ce tableau répertorie les erreurs courantes et leurs résolutions. Ces erreurs apparaissent lors de l’affichage de l’aperçu de vos données importées dans la tâche d’extraction des données des salariés de SuccessFactors.
Message d’erreur | Résolution |
La demande d’enregistrement de l’aperçu a réussi, mais aucun résultat n’a été reçu. | Contactez le service d’assistance de SuccessFactors pour savoir pourquoi aucun enregistrement n’est renvoyé. |
Impossible d’analyser le chemin de champ {{Chemin de champ ici}} à partir de la réponse. Le chemin du champ doit être de type booléen ou chaîne. | Il s’agit d’un message d’avertissement indiquant que le chemin du champ n’était pas un booléen ou une chaîne dans l’enregistrement d’aperçu.
Vérifiez le type de zone dans le dictionnaire OData dans SuccessFactors. |
Une erreur s’est produite pendant l’extraction du jeton OAuth depuis SuccessFactors : {{Error from SuccessFactors}}. | Erreur d’identification lors de la demande de jeton OAuth. Le motif spécifique figurera dans le message de SuccessFactors.
Raisons connues :
Pour résoudre cette erreur, mettez à jour vos identifiants pour qu’ils soient corrects. Pour plus d’informations, voir Configuration des tâches SuccessFactors avec les identifiants OAuth. |
Une erreur s’est produite depuis SuccessFactors pendant l’extraction de l’enregistrement d’aperçu : {{Error from SuccessFactors}}. | Erreur lors de l’appel de l’API OData depuis SuccessFactors. Le motif spécifique figurera dans le message de SuccessFactors. Cette erreur se produit car la propriété est introuvable.
Voir la sous-section « Propriété introuvable » ci-dessous pour plus d’informations sur la résolution de cette erreur. |
Une erreur interne inattendue s’est produite lors de la récupération de l’enregistrement de l’aperçu à partir de SuccessFactors. | Erreur interne côté Qualtrics. Veuillez contacter le support de Qualtrics. |
Propriété introuvable
Si vous tentez d’importer des champs SuccessFactors personnalisés, le format ne peut pas être validé dans notre liste déroulante de champs. Si vous obtenez une erreur inattendue dans lors de l’affichage de l’aperçu de votre importation, par exemple « Noms de propriété non valides », vérifiez dans SuccessFactors que le chemin du champ est correct.
Pour rechercher un champ, accédez au Centre d’administration dans SuccessFactors, puis à votre dictionnaire de données d’API OData.
À partir de là, accédez à l’onglet Entité et recherchez le champ que vous souhaitez ajouter. Confirmez que le champ existe et que le chemin du champ correspond à ce que vous avez ajouté dans la tâche Extraire les données des employés de SuccessFactors de Qualtrics. En général, “PerPerson” est l’entité de base par laquelle commencer pour trouver le chemin de zone correct. Si le chemin du champ est correct et que vous rencontrez toujours une erreur, contactez le service clientèle de SuccessFactors pour obtenir de l’aide.