Micro-apps

Intégrer SAP SuccessFactors

L’intégration de SAP SuccessFactors vous permet d’accéder aux informations sur les employés, les compétences et les cours à partir de n’importe quel emplacement.

Remarque :

Nous mettons à votre disposition deux modèles d’intégration SuccessFactors. Nous vous recommandons d’utiliser la nouvelle intégration HTTP SuccessFactors EC pour les cas d’utilisation SAP SuccessFactors Employee Central. L’intégration HTTP est plus performante pour configurer la structure de données mise en cache.

Pour obtenir une liste complète des micro-apps SuccessFactors prêtes à l’emploi, consultez la section Utiliser les micro-apps SuccessFactors.

Vérifier les conditions préalables

Une fois l’intégration dans SAP SuccessFactors configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace en fonction du type d’intégration que vous devez activer. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.

  • Les informations de configuration requises pour vous connecter à SAP SuccessFactors dépendent de l’utilisation ou non du module d’apprentissage.
  • Créez un utilisateur administrateur dans l’instance Provisioning. Généralement, un consultant certifié SuccessFactors exécute toutes les activités dans Provisioning. Donnez à l’utilisateur un nom unique.
  • Configurez Citrix Gateway pour prendre en charge l’authentification unique pour SuccessFactors : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-On), consultez la section Citrix Gateway Service.

Remarque :

Un débit maximal s’applique aux intégrations de SuccessFactors en fonction du nombre de requêtes par minute. Cela peut avoir un impact sur les instances de test. Pour éviter les problèmes, fixez le débit maximal à 8 appels par seconde. Pour plus d’informations, consultez votre consultant SuccessFactors pour connaître le débit maximal de requêtes accepté.

Pour l’intégration SuccessFactors EC :

  • URL de base : l’URL de base suit ce modèle : https://{tenant}.successfactors.{region}/odata/v2
  • Nom d’utilisateur : votre ID utilisateur unique.
  • ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Consultez Obtenir l’ID de l’entreprise et l’ID du client.
  • ID de l’entreprise : l’ID de l’entreprise est une chaîne courte de caractères qui identifie chaque système SAP SuccessFactors, comme un nom d’utilisateur pour votre organisation. Consultez Obtenir l’ID de l’entreprise et l’ID du client.
  • Clé privée : il s’agit de la clé API provenant de l’enregistrement du client OAuth2. Consultez Enregistrer le client OAuth2.
  • URL OAuth : il s’agit de l’URL de l’application générée dans le modèle et suivant ce modèle : https://{tenant}.successfactors.{region}/oauth. Vous en avez besoin pour le processus Enregistrer le client OAuth2.

Pour l’intégration SuccessFactors HCM :

  • URL de l’API
  • ID de l’entreprise
  • ID utilisateur (nom d’utilisateur)
  • ID client (clé API)
  • Clé privée client (clé privée cryptée)

Pour l’intégration SuccessFactors Learning :

  • URL pour le module d’apprentissage
  • ID de l’entreprise pour le module d’apprentissage
  • ID utilisateur pour le module d’apprentissage
  • ID du client pour le module d’apprentissage
  • Clé secrète client pour le module d’apprentissage

Configurer l’intégration de SuccessFactors HCM

Suivez ce processus si vous devez configurer l’intégration de base de SuccessFactors HCM ou l’intégration de base avec le module d’apprentissage. À l’aide de vos informations d’identification administrateur, vous créez un rôle d’autorisation, créez un groupe d’autorisations et attribuez le groupe d’autorisations au rôle d’autorisation.

Créer un rôle d’autorisation

Pour créer un rôle d’autorisation, procédez comme suit :

  1. Connectez-vous à SAP SuccessFactors Admin Center avec les informations d’identification administrateur.
  2. Recherchez et sélectionnez Manage Permission Roles, puis sélectionnez Create New.
  3. Renseignez le champ Role Name avec un nom unique et sélectionnez Permission.
  4. Faites défiler la page jusqu’à Manage Integration Tools, cliquez sur Select All, puis sélectionnez Done.
  5. Sélectionnez Enregistrer les modifications.

Créer un groupe d’autorisations

Pour créer un groupe d’autorisations, procédez comme suit :

  1. Dans SAP SuccessFactors Admin Center, recherchez et sélectionnez Manage Permission Groups, puis sélectionnez Create New.
  2. Renseignez le champ Group Name avec un nom unique.
  3. Sous Choose Group Members: People Pool, sélectionnez la catégorie Username.
  4. Entrez le nom de l’utilisateur dédié, cochez la case en regard du nom, puis sélectionnez Done.
  5. Sélectionnez à nouveau Done.

Attribuer le nouveau groupe d’autorisations au rôle d’autorisation

Pour attribuer le nouveau groupe d’autorisations au rôle d’autorisation, procédez comme suit :

  1. Dans SAP SuccessFactors Admin Center, recherchez et sélectionnez Manage Permission Roles, puis sélectionnez le rôle d’autorisation précédemment créé.
  2. Faites défiler la page jusqu’à Grant this role to et sélectionnez Add.
  3. Sous Grant this role to: Permission Group, cliquez sur Select.
  4. Recherchez le groupe précédemment créé, cochez la case en regard du nom et sélectionnez Done.
  5. Sélectionnez à nouveau Done, puis Save Changes.

    Vous avez attribué le groupe d’autorisations utilisateur au rôle d’autorisation.

Enregistrer le client OAuth2

Pour enregistrer le client OAuth2, procédez comme suit :

  1. Dans SAP SuccessFactors Admin Center, recherchez et sélectionnez Manage OAuth2 Client Applications, puis sélectionnez Register Client Application.
  2. Entrez les informations suivantes :

    Nom de l’application

    URL de l’application

  3. Sélectionnez Generate X.509 Certificate.
  4. Entrez un nom commun Common Name (CN), puis sélectionnez Generate.
  5. Sélectionnez Download pour télécharger une copie du certificat X.509. La clé privée client se trouve dans le fichier de certificat en tant que clé privée cryptée. Copiez et enregistrez cette clé. Vous utilisez ces détails lors de la configuration de l’intégration.
  6. Sélectionnez Register.

    La nouvelle application est répertoriée sur la page Manage OAuth2 Client Applications.

  7. Sous Actions, sélectionnez View.
  8. Copiez la clé API et stockez-la pour une utilisation ultérieure.

Configurer l’intégration de SuccessFactors Learning

Suivez ce processus si vous avez besoin de configurer l’intégration de base de SuccessFactors avec le module d’apprentissage ou simplement le module d’apprentissage. À l’aide de vos informations d’identification administrateur, vous obtenez l’ID de l’entreprise et l’ID du client, et générez une nouvelle clé secrète client.

Obtenir l’ID de l’entreprise et l’ID du client

Pour obtenir l’ID de l’entreprise et l’ID du client, procédez comme suit :

  1. Connectez-vous à l’environnement d’administration SAP SuccessFactors Learning pour votre locataire.
  2. Accédez à System Admin > Configuration > OAuth Token Server.
  3. Sur l’écran Application Administration, copiez l’ID de l’entreprise (Company ID) et l’ID du client (Client ID), et stockez-les pour une utilisation ultérieure.

Générer une nouvelle clé secrète client

Pour générer une nouvelle clé secrète client, procédez comme suit :

  1. Sur l’écran Application Administration, sélectionnez Generate a new Client Secret et sélectionnez OK pour confirmer.

    Le champ Newly Generated Client Secret est renseigné sous l’ID du client.

  2. Copiez la clé secrète client et stockez-la pour une utilisation ultérieure.

    La clé secrète client n’est pas enregistrée. Lorsque vous quittez la page OAuth Token Server, la clé secrète disparaît.

Ajouter des URL de rappel

Ajoutez une adresse URL personnalisée à votre configuration d’instance pour accorder l’accès aux données privées et activer les actions utilisateur authentifiées par OAuth. Le premier rappel répertorié ne change pas. Le second rappel dépend de l’application cible et se trouve dans votre barre d’adresse URL lors de la création de l’intégration. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Connectez-vous à SuccessFactors en tant qu’administrateur et ajoutez les URL de redirection autorisées suivantes pour cette intégration :

  • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.successfactors.SuccessFactorsService/auth/serverContext
  • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Ajouter l’intégration SuccessFactors EC

Suivez ces étapes pour configurer l’intégration SuccessFactors EC. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Nous vous recommandons d’utiliser la nouvelle intégration HTTP pour la plupart des cas d’utilisation. L’intégration HTTP est plus performante pour configurer la structure de données mise en cache.

Procédez comme suit :

  1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  2. Choisissez la vignette SuccessFactors EC sous Intégrations.
  3. Donnez un nom d’intégration à l’intégration.
  4. Renseignez la section Paramètres du connecteur.
    • Entrez l’URL de base de l’instance : https://{tenant}.successfactors.{region}/odata/v2.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.
  5. Sous Authentification du service, sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué. Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

    1. Sélectionnez SAML 2.0 SuccessFactors dans le menu Flux de type d’autorisation.
    2. Laissez le champ Étendue vide.
    3. Renseignez le champ Nom d’utilisateur.
    4. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Consultez Obtenir l’ID de l’entreprise et l’ID du client.
    5. Renseignez le champ ID de l’entreprise. L’ID de l’entreprise est une chaîne courte de caractères qui identifie chaque système SAP SuccessFactors, comme un nom d’utilisateur pour votre organisation. Consultez Obtenir l’ID de l’entreprise et l’ID du client.
    6. Renseignez le champ Clé privée. Il s’agit de la clé API provenant de l’enregistrement du client OAuth2. Consultez Enregistrer le client OAuth2.
    7. Le champ URL OAuth est automatiquement générée. Il s’agit de l’URL de l’application générée dans le modèle et suivant ce modèle : https://{tenant}.successfactors.{region}/oauth. Vous en avez besoin pour le processus Enregistrer le client OAuth2.
  6. Laissez l’option Authentification des actions de service désactivée.
  7. Le bouton Activer la limitation du taux de demandes est activé. Laissez 1 pour Nombre de demandes et 1 seconde pour Intervalle de temps. Le champ Délai d’expiration de la demande est défini sur 120 par défaut.
  8. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  9. Sélectionnez Enregistrer pour continuer.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Utiliser les micro-apps SuccessFactors EC

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins. L’intégration SuccessFactors EC est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Annuaire : permet de rechercher des employés et prévisualiser leurs détails, y compris leurs compétences.

Notification ou Page Workflows de cas d’utilisation
Page Utilisateur Fournit une liste consultable des utilisateurs.
Page Compétences des utilisateurs Fournit une vue des détails des utilisateurs et de leurs compétences.

Compétences : permet de rechercher des compétences et de prévisualiser les employés, ainsi que leurs compétences correspondantes.

Notification ou Page Workflows de cas d’utilisation
Notification Évaluation des compétences modifiée Lorsqu’un responsable modifie l’évaluation des compétences d’un employé, l’employé reçoit une notification.
Page Compétences Fournit une liste consultable des compétences à connecter aux utilisateurs.
Page Compétences des utilisateurs évaluées Fournit une vue détaillée des compétences évaluées. Les compétences évaluées sont des compétences que les employés et leurs responsables évaluent dans le portlet Profil de compétences.
Page Compétences déclarées Fournit une vue détaillée des compétences déclarées. Les compétences déclarées sont ajoutées manuellement dans le portlet Profil de compétences.
Page Utilisateurs Fournit une vue des compétences d’un utilisateur.

Ajouter l’intégration SuccessFactors aux micro-apps Citrix Workspace

Ajoutez l’intégration SuccessFactors aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Utilisez le processus suivant pour activer l’intégration SuccessFactors. Assurez-vous de remplir les conditions préalables et décidez de l’intégration à configurer :

  • Intégration de base SuccessFactors HCM
  • Intégration de base avec le module d’apprentissage
  • Module d’apprentissage uniquement

Procédez comme suit :

  1. Sur la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette SuccessFactors.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur SuccessFactors : Module de l'employé existant, Module d'apprentissage, URL de l'API, ID de l'entreprise, ID utilisateur, ID du client, Clé privée client (mêmes paramètres pour le module d'apprentissage)

  5. Renseignez la section Paramètres du connecteur avec les éléments requis que vous avez obtenus.
    • Sélectionnez Oui/Non dans la section Utilisez-vous le module central de l’employé ?
      • Renseignez le champ URL de l’API. Par exemple, https://api12preview.sapsf.eu/odata/v2v.
      • Renseignez le champ ID de l’entreprise.
      • Renseignez le champ ID utilisateur.
      • Renseignez le champ ID du client.
      • Renseignez le champ Clé privée client.
    • Sélectionnez Oui/Non dans la section Utilisez-vous le module d’apprentissage ?
      • Renseignez le champ URL pour le module d’apprentissage.
      • Renseignez le champ ID de l’entreprise pour le module d’apprentissage.
      • Renseignez le champ ID utilisateur pour le module d’apprentissage.
      • Renseignez le champ ID du client pour le module d’apprentissage.
      • Renseignez le champ Clé secrète client pour le module d’apprentissage.
  6. Sélectionnez Ajouter.

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation. Pour plus d’informations, consultez Vérifier les entités requises. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur SuccessFactors.

Utiliser les micro-apps SuccessFactors

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

L’intégration SuccessFactors est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Répertoire : permet de rechercher, d’afficher et de modifier les employés, ainsi que les détails correspondants.

Notification ou Page Workflows de cas d’utilisation
Notification Nouveau collègue Lorsqu’un nouvel employé est ajouté, tous les abonnés reçoivent une notification spécifiant le nom de leur nouveau collègue et son poste.
Notification Poste changé Lorsque le poste d’un employé change, tous les abonnés reçoivent une notification spécifiant le nom de leur collègue et son nouveau poste.
Page Mes détails Fournit un formulaire permettant d’afficher des informations personnelles, ainsi qu’un lien vers les sous-détails du responsable.
Page Mon équipe Fournit une vue tabulaire des collègues d’un employé, ainsi que des liens vers les détails de l’utilisateur.
Page Détails de l’utilisateur Fournit un formulaire permettant d’afficher les détails d’un utilisateur, ainsi qu’un lien vers les sous-détails de son responsable et de ses collaborateurs directs.
Page Sous-détails de l’utilisateur Fournit un formulaire permettant d’afficher les sous-détails d’un utilisateur, ainsi qu’un lien vers ses détails principaux.
Page Utilisateurs Fournit une vue tabulaire des utilisateurs avec fonctionnalité de recherche, ainsi qu’un lien vers les détails correspondants.

Apprentissage : permet de rechercher, de consulter, de partager et de s’inscrire aux cours de formation disponibles.

Notification ou Page Workflows de cas d’utilisation
Notification Cours populaire Lorsqu’un cours d’apprentissage est défini comme populaire en fonction de son classement, tous les abonnés reçoivent une notification.
Page Cours Fournit une liste des cours disponibles, y compris un lien vers les détails de l’activité d’apprentissage correspondante.
Page Détails de l’activité d’apprentissage Fournit une vue tabulaire des activités d’apprentissage, y compris un lien vers les détails de l’offre programmée et une option de partage par e-mail.
Page Détails de l’offre programmée Fournit une vue détaillée d’une offre programmée, y compris une liste d’instructeurs et une option d’inscription à l’offre.