Intégrer SAP Ariba

L’intégration SAP Ariba vous permet d’examiner et d’approuver les demandes sans nécessiter de connexions supplémentaires.

Remarque :

Nous mettons à votre disposition deux modèles d’intégration SAP Ariba. 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.

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

Vérifier les conditions préalables

Vous avez besoin des valeurs suivantes pour ajouter l’intégration HTTP dans les micro-apps Citrix Workspace :

• URL de base : https://openapi.ariba.com/api/approval/v1/prod
• URL du jeton : https://api.ariba.com/v2/oauth/token
• ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation, appelé ID du client OAuth dans SAP. Consultez Obtenir l’ID du client OAuth et la clé de l’application.
• Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible, émise par SAP.
• Ariba APIkey : connue sous le nom de clé de l’application, cette clé remplace une variable dans le processus de script. Consultez Obtenir l’ID du client OAuth et la clé de l’application.
• Domaine Ariba : remplace une variable dans le processus de script. Si vous avez besoin de ce paramètre, contactez votre administrateur SAP pour confirmer votre ID de domaine.
• Ariba lastChangeId : spécifie la dernière modification reçue dans la réponse précédente. La réponse inclut tous les changements depuis celui en cours. Par exemple, utilisez 1 si vous souhaitez charger toutes les modifications depuis le début.

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.

• Votre organisation doit être aux États-Unis ou en Europe.
• Vous devez disposer d’une licence actuelle pour une solution SAP Ariba ou un composant Ariba Network Solution.

• Vous devez disposer d’un compte administrateur SAP Ariba Open APIs. L’administrateur SAP Ariba de votre organisation peut demander l’accès au portail SAP Ariba Open APIs Developer Portal à partir de l’un des liens suivants :

  • États-Unis : https://developer.ariba.com/api/
  • Europe : https://eu.developer.ariba.com/api/
• Configurez Citrix Gateway pour prendre en charge l’authentification unique pour SAP Ariba : 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 Ariba. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-On), consultez Citrix Gateway Service.

Configurer l’intégration SAP Ariba

1. Connectez-vous à https://developer.ariba.com/api/ avec un compte administrateur.
2. Sur la page d’accueil, sélectionnez Créer une application.

3. Pour créer une application, renseignez les champs Nom de l’application et Description, puis sélectionnez Envoyer.

   Votre application est envoyée à l’équipe SAP Ariba Open APIs pour approbation.

Obtenir l’ID du client OAuth et la clé de l’application

Une fois votre demande approuvée (procédure décrite dans la section ci-dessus), vous recevez un e-mail avec la clé secrète client OAuth. L’équipe SAP Ariba Open APIs configure et active le serveur principal avec votre ID de domaine Ariba.

Remarque :

Vous ne pouvez pas continuer tant que vous n’avez pas reçu l’e-mail d’approbation.

1. Connectez-vous et accédez à la page Gérer les applications.
2. Sélectionnez l’application que vous avez créée.
3. Copiez l’ID du client OAuth et la clé de l’application.
4. Enregistrez-les dans un emplacement sécurisé pour une utilisation ultérieure lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.

Ajouter l’intégration aux micro-apps Citrix

Procédez comme suit pour configurer l’intégration HTTP SAP Ariba. 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 SAP Ariba 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://openapi.ariba.com/api/approval/v1/prod.
   • 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. Entrez le paramètre Ariba APIkey. La clé de l’application remplace une variable dans le processus de script. Consultez Obtenir l’ID du client OAuth et la clé de l’application.
6. Entrez le paramètre Domaine Ariba. L’ID de domaine Ariba remplace une variable dans le processus de script. Si vous avez besoin de ce paramètre, contactez votre administrateur SAP pour confirmer votre ID de domaine.
7. Entrez le paramètre Ariba lastChangeId. Ce paramètre spécifie la dernière modification reçue dans la réponse précédente. La réponse inclut tous les changements depuis celui en cours. Par exemple, utilisez 1 si vous souhaitez charger toutes les modifications depuis le début.

8. 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 Informations d’identification du client dans le menu Flux de type d’autorisation.
   2. Entrez client_credentials dans le champ Valeur du type d’autorisation.
   3. Sélectionnez En-tête d’autorisation dans le menu Autorisation de jeton.
   4. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton.
   5. Saisissez l’URL du jeton : https://api.ariba.com/v2/oauth/token
   6. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le serveur OAuth. Consultez Obtenir l’ID du client OAuth et la clé de l’application.
   7. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible. Consultez Obtenir l’ID du client OAuth et la clé de l’application.
9. Activez l’option Limitation du taux de demandes. Entrez 3 pour Nombre de demandes et 1 seconde pour Intervalle de temps.
10. Dans le champ Délais d’expiration des demandes, entrez 120.
11. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
12. 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.

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

Utiliser les micro-apps Ariba

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 SAP Ariba est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Approbation des demandes : permet d’afficher les demandes, ainsi que les détails associés en attente d’approbation, et une action à approuver.

Ajouter l’ancienne intégration SAP Ariba

Ajoutez l’intégration SAP Ariba aux micro-apps Workspace Citrix 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. Une fois l’intégration dans SAP Ariba configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

• URL de l’API
• URL du jeton OAuth
• ID du client OAuth
• Clé secrète client OAuth
• Clé de l’application
• ID de domaine

Procédez comme suit :

1. Sur la page de vue d’ensemble des micro-apps, 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 Ariba.

4. Donnez un nom à l’intégration.

   

5. Renseignez la section Paramètres du connecteur avec les informations que vous avez obtenues dans les procédures précédentes.
   • Entrez vos informations d’identification associées à l’URL de l’API et à l’URL du jeton OAuth pour l’authentification du service de systèmes cibles.
   • Renseignez les champs ID du client OAuth et Clé secrète client.
   • Renseignez les champs clé de l’application et ID de domaine.
   • Activez Sandbox si vous souhaitez charger vos données dans un environnement sandbox.
   • Entrez une valeur pour Limitation du taux de demandes, Nombre maximal de requêtes pour les services Ariba. Ce champ est obligatoire et détermine le nombre d’appels par seconde. Discutez des limites de votre instance avec votre représentant Ariba pour configurer correctement la valeur. Nous recommandons 10 appels/seconde ou moins comme taux initial si la limite maximale n’est pas connue. La valeur zéro peut être utilisée pour désactiver complètement toutes les limitations. Toutefois, un taux de requêtes trop élevé peut entraîner un refus d’accès.
   • Sélectionnez une valeur pour Modifier ID lorsque la synchronisation complète commence. Lorsque la synchronisation complète commence à limiter la quantité de données chargées, les modifications plus anciennes sont ignorées lors de la synchronisation complète. Laissez cette valeur vide pour charger toutes les données.
   • (Facultatif) Activez l’option Ignorer demande incorrecte 400 pendant la synchronisation pour récupérer suite aux erreurs de réponse de demande incorrecte 400. Si des enregistrements Ariba sont supprimés pendant la synchronisation, l’API Ariba renvoie une erreur car les données demandées n’existent plus. Un avertissement est généré dans le journal.
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 la section 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 Ariba.

Anciennes micro-apps SAP Ariba

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’ancienne intégration SAP Ariba est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Approbation des demandes : permet d’afficher les demandes, ainsi que les détails associés en attente d’approbation, et une action à approuver.