Micro-apps

Intégrer SAP Concur

L’intégration SAP Concur vous permet d’envoyer des demandes et de recevoir des notifications sur l’état des demandes.

En tant qu’administrateur système, vous utilisez le processus suivant pour activer l’intégration Concur. Assurez-vous de remplir les conditions préalables, puis configurez l’intégration Concur. Une fois l’intégration configurée, vous devez fournir aux employés le nom de l’employé, l’adresse e-mail, l’identifiant de l’employé ou l’identifiant de connexion du compte dédié et leur demander d’ajuster leurs paramètres de profil SAP Concur. 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.

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

Vérifier les conditions préalables

Ces conditions préalables supposent que vous gérez l’instance SAP Concur de votre organisation pour configurer l’intégration. Vous devez disposer des éléments suivants pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL de l’instance
  • Nom d’utilisateur
  • Mot de passe

Pour OAuth 2.0 :

  • ID du client OAuth
  • Clé secrète client OAuth
  • URL d’autorisation

Remarque : 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.

  • Obtenez un nouvel ID du client OAuth (client_id oauth2) et une nouvelle clé secrète client OAuth (client_secret), et définissez l’étendue de l’application du client.

Important : créez un ticket de support Concur pour configurer l’intégration à l’aide d’OAuth 2.0 et enregistrer les adresses URL de rappel d’authentification correctes. Nous vous recommandons d’utiliser le texte suivant dans votre ticket de support :

Nous souhaitons obtenir les informations d’identification OAuth 2.0 pour activer une intégration avec Citrix Workspace. Cet outil télécharge les notes de frais récentes et les détails de lignes associés à l’aide d’un compte de service pour présenter les approbations en attente aux responsables. Il permet aux employés d’envoyer, d’approuver et de rejeter des dépenses rapides. Lorsque les utilisateurs effectuent des actions, ils sont dirigés vers la page d’autorisation 3LO où ils saisissent leurs informations d’identification Concur et approuvent l’accès par l’application Workspace.

Ajoutez votre ID du client Concur.

Ajoutez les adresses URL de redirection autorisées suivantes pour cette intégration à Concur avec l’octroi d’autorisation accordé pour l’accès aux données privées et l’activation des 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 :

  • <https://microapps_server_URL/admin/api/external-services/com.sapho.services.concur.ConcurService/auth/serverContext>

  • <https://microapps_server_URL/app/api/auth/serviceAction/callback>

  • Vous devez avoir acheté le composant Services Web auprès de SAP Concur. Si votre entreprise n’a pas acheté le composant Services Web, demandez à l’administrateur SAP Concur de votre organisation de contacter votre responsable de compte chez SAP Concur.
  • Configurez Citrix Gateway pour prendre en charge l’authentification unique pour SAP Concur : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Suivez les instructions de l’article Configuration de l’authentification unique pour Concur. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-ON), consultez la section Citrix Gateway Service.

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

Ajoutez l’intégration SAP Concur 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.

Procédez comme suit :

  1. Dans 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 SAP Concur.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Concur : URL de l'instance, Méthode d'authentification, Nom d'utilisateur, Mot de passe, Clé du client

  5. Renseignez la section Paramètres du connecteur avec les éléments requis que vous avez obtenus.
    • Entrez l’URL de l’instance.
    • Entrez le Nom d’utilisateur et le Mot de passe.
    • Sélectionnez une Méthode d’authentification. 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é.
    • Entrez une URL d’autorisation pour définir l’adresse URL du serveur d’autorisation fournie lors de la configuration de l’intégration de l’application cible.
    • Sélectionnez une Méthode d’authentification OAuth 2.0.
      • Informations d’identification : les informations d’identification du client sont utilisées à la place du propriétaire de la ressource. Le jeton d’accès est associé soit au client lui-même, soit à l’autorisation déléguée d’un propriétaire de la ressource.
      • Octroi d’autorisation (3LO) : le propriétaire de la ressource autorise l’accès.
    • Entrez l’ID du client OAuth et la Clé secrète client OAuth que vous avez obtenus dans la procédure Vérifier les conditions préalables.
  6. Sélectionnez les boutons radio suivants selon les besoins :

    • Module de dépenses : fournit l’accès au suivi des dépenses des employés.
    • Configuration du groupe de dépenses : récupère la liste de stratégies de dépenses, de types de dépenses et de types de paiement pour le groupe de dépenses auquel le jeton d’accès OAuth est affecté.
    • Détails des notes de frais (allocations et détails) : permet d’extraire les informations d’allocation liées à un ID de note de frais, à un ID d’entrée ou à un ID d’élément.
    • Module de voyage : fournit un accès aux données de voyage, telles que les itinéraires, les profils de voyage et les demandes de voyage.
    • Délégation de frais : récupère une liste d’utilisateurs qui ont accordé des autorisations de délégation à l’utilisateur spécifié dans le jeton d’accès OAuth.
  7. Entrez une valeur pour Nombre de connexions. Cette valeur détermine le nombre de chaînes initiées par la synchronisation des données.

    Remarque : Le nombre de connexions par défaut est 1. L’ouverture d’un plus grand nombre de connexions réduit le temps de synchronisation des données, mais augmente la charge sur le serveur des micro-apps et peut donc influencer ses performances. Si vous avez besoin d’un plus grand nombre de connexions, nous vous recommandons de ne pas dépasser 10.

  8. 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 nouvelle 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 les sections Vérifier les entités requises et Définir la synchronisation des données dans l’article Configurer l’intégration.

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

Utiliser les micro-apps SAP Concur

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.

Important

Les micro-apps SAP Concur suivantes sont désormais obsolètes : Envoyer dépense rapide, Créer un utilisateur et Utilisateur. Les utilisateurs doivent supprimer ces micro-apps car elles seront configurées de façon incorrecte. Pour supprimer la micro-app, sur la page Intégrations de micro-apps, sélectionnez le menu en regard de la micro-app que vous souhaitez supprimer. Sélectionnez Supprimer micro-app et confirmez.

Comment supprimer une micro-app

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

Approbations : permet d’approuver les rapports en attente ou de les renvoyer.

Notification ou Page Workflows de cas d’utilisation
Notification Rappel d’approbation Lorsqu’une note de frais est en attente d’approbation et dépasse un seuil défini avant la date limite (par exemple, 3 jours par défaut), l’approbateur reçoit une notification.
Notification Nouvelle demande Lorsqu’une nouvelle demande d’approbation est attribuée à un approbateur, celui-ci reçoit une notification.
Notification Nouvelle demande (modifiée) Lorsqu’une demande d’approbation est modifiée, l’approbateur reçoit une notification.
Page Détail des dépenses Fournit une vue en lecture seule d’une dépense et de ses détails correspondants.
Page Mes approbations en attente Fournit une liste personnalisée des approbations en attente.
Page Consulter le rapport Fournit un formulaire interactif contenant une vue détaillée d’une note de frais en attente d’approbation.

Dépenses : permet de rechercher et visualiser les dépenses.

Notification ou Page Workflows de cas d’utilisation
Page Détail des dépenses Fournit une vue en lecture seule d’une dépense et de ses détails correspondants.
Page Mes dépenses Fournit une liste personnalisée des dépenses.
Page Détails du rapport Fournit une vue détaillée d’une note de frais, ainsi qu’un champ pour ajouter des commentaires.

Itinéraires : permet de rechercher, d’afficher et de partager des itinéraires.

Notification ou Page Workflows de cas d’utilisation
Notification Nouvel itinéraire réservé avec succès Lorsque le nouvel itinéraire d’un utilisateur est réservé et que le billet est reçu, l’utilisateur reçoit une notification.
Notification Nouvel itinéraire partagé Lorsqu’un itinéraire est partagé avec un utilisateur, il reçoit une notification.
Page Détails de l’itinéraire Fournit la vue de l’itinéraire d’un utilisateur, ainsi qu’un bouton de partage interactif.
Page Mes itinéraires Fournit une liste personnalisée d’itinéraires.
Page Partager l’itinéraire Fournit un formulaire permettant de partager l’itinéraire d’un utilisateur.

Rapports : permet de rechercher et d’afficher vos rapports de notes de frais envoyés.

Notification ou Page Workflows de cas d’utilisation
Notification Demande approuvée Lorsqu’une note de frais d’un utilisateur est approuvée, celui-ci reçoit une notification.
Notification Renvoyer la demande Lorsqu’une note de frais d’un utilisateur est renvoyée, il reçoit une notification.
Page Détail des dépenses Fournit une vue en lecture seule d’une dépense et de ses détails correspondants.
Page Notes de frais Fournit une vue détaillée d’une note de frais, ainsi qu’un champ pour ajouter des commentaires.
Page Mes notes de frais en attente Fournit une liste personnalisée des notes de frais.

Intégrer SAP Concur