Que sont les API REST ?
Naturellement, la plupart des applications et services créés et exécutés dans le cloud s'appuient sur les API REST :
- REST (= Transfert d'état représentatif)
- est un style architectural qui définit certaines directives et contraintes sur la façon de concevoir des composants sur le Web. Il met particulièrement l'accent sur l'interaction et la communication de ces composants.
- API (= interfaces de programmation d'applications)
- définit la manière dont les composants peuvent être contactés par d'autres composants afin de déclencher certaines fonctionnalités ou d'échanger des données.
Une API REST (également API RESTful) est une API qui respecte les directives et les contraintes définies par le style architectural REST.
En règle générale, les utilisateurs finaux n'accèdent pas directement aux API REST des applications et services Cloud. Ils utilisent principalement une application qui fournit une interface utilisateur graphique (GUI) et compose des informations pertinentes à partir d'autres applications et composants Cloud, utilisant les API REST. Ainsi, les API REST sont masquées pour l'utilisateur final. Mais cela peut être différent pour les développeurs ou les administrateurs, car ils peuvent vouloir utiliser ou tester une fonctionnalité qui n'est pas fournie par une application avec GUI.
Au cours du processus de développement, le développeur peut avoir besoin de tester ou de simuler les fonctionnalités individuelles de certains composants indépendamment d'autres composants pertinents pour l'ensemble du système ou de l'architecture. Par exemple, le développeur travaille sur un nouveau processus pour l'approbation des demandes d'absence. Dans le scénario productif, le processus est censé être déclenché par une application développée par une autre équipe. L'application appellera une API REST de SAP Build Process Automation afin de déclencher le processus d'approbation des absences. Comme l'application n'existe pas encore, le développeur souhaite déclencher manuellement l'API REST lors du processus de développement à des fins de test. À cette fin, ils peuvent utiliser un client appelé REST.
Un client REST est un outil qui simplifie la communication technique avec les API REST. Il fournit une interface pour les protocoles de communication techniques requis tels que HTTPS et facilite leur utilisation.
Un autre rôle susceptible de s'intéresser aux clients REST dans le contexte de SAP Build Process Automation est l'opérateur ou l'administrateur. Ce rôle administre, traite et peut avoir besoin d'effectuer des tâches irrégulières une fois de temps en temps. Il peut s'agir, par exemple, de tâches de nettoyage. De nombreuses fonctions d'administration et d'exploitation de SAP Build Process Automation sont disponibles via les applications "Suivi des processus et des instances de workflow" et "Gestion des processus et des workflows", mais certaines fonctions peuvent uniquement être disponibles via son API REST.
Découverte des API d'automatisation des processus SAP Build dans SAP Business Accelerator Hub
Lorsque vous accédez à SAP API Business Hub (lien à remplacer prochainement) et que vous recherchez le produit SAP Build Process Automation, vous trouverez le package d'API correspondant. Vous trouverez ci-dessous les différentes API qu'il contient et un exemple chacune sur la manière dont ces API peuvent être exploitées.
- Exécution de l'automatisation
- Créez une application qui vous permet de lancer des automatisations spécifiques en un seul clic.
- Monitorage d'automatisation
- Récupérez les journaux des exécutions d'automatisation passées et administrez-les dans un autre outil.
- Décisions
- Exécutez un service de règles à l'aide d'un client REST pour tester qu'il fournit les résultats attendus.
- Corbeille d'arrivée
- Créez une application Boîte de réception personnalisée, qui a une apparence différente de celle de l'application standard Ma boîte de réception fournie par SAP. Ce cas d'utilisation requiert également l'API Processus et workflows.
- Workflows
- Laissez une autre application déclencher de nouvelles instances de processus ou de workflow.
- Scénarios de visibilité
- Gagnez en visibilité sur les processus ou les workflows dans les systèmes externes en transférant les événements de processus dans le service SAP Build Process Automation.
- Espace de travail de visibilité
- Obtenir une synthèse des scénarios de visibilité auxquels un utilisateur spécifique a accès.
Trouver un point de terminaison à utiliser
Supposons que vous souhaitiez savoir comment déclencher un nouveau processus ou une nouvelle instance de workflow à l'aide des API de SAP Build Process Automation.
Dans le package API SAP Build Process Automation, sélectionnez l'API REST des workflows. Vous obtenez une synthèse et une description de l'API REST.
Sélectionnez Référence d'API pour afficher les détails des différents points de terminaison d'API qu'elle fournit.
Sélectionnez Instances de workflow, puis le point de terminaison POST pour démarrer de nouvelles instances.
Vous pouvez maintenant voir les détails du point d'extrémité correspondant. Cette vue est particulièrement importante car elle fournit également des détails sur les rôles ou périmètres requis pour exécuter l'API et sur les paramètres requis lors de l'appel de l'API. Dans l'exercice suivant, vous allez découvrir exactement les étapes requises lors de l'utilisation d'une API SAP Build Process Automation.
