API de tâche

Important : La API de tâche est une nouvelle fonctionnalité de la version 30 et sa disponibilité est limitée à la région des États-Unis (États-Unis Est, États-Unis Ouest et Sandbox États-Unis). Contactez votre responsable de l'assistance à la clientèle (CSM) pour activer cette fonction.

La API de tâche est un nouveau type d'automatisation que vous pouvez créer dans Automation 360 Cloud. Les automatisations d'API fonctionnent sur Cloud pour s'intégrer à n'importe quelle application SaaS ou n'importe quel point de terminaison d'API.

Les Tâches API interagissent avec une application directement via l'API et offrent de meilleures performances en termes de temps de réponse. Utilisez les Tâches API pour créer des automatisations à l'aide de packages pris en charge par Automation 360 Cloud. Créez une API de tâche dans l'éditeur d'API, tout comme des Robots de tâches, et utilisez-la dans :
  • un processus en tant que tâche API ;
  • des formulaires à des fins de recherche dynamique de données via des appels d'API.

Les Tâches API peuvent également être initiées dans Process Composer et utilisées dans n'importe quel processus. Une API de tâche peut se connecter à une API spécifiée pour récupérer des données que l'automatisation de processus doit consommer. Pour plus d'informations, voir À propos de Process Composer.

Bien que les Tâches API soient semblables aux Robots de tâches, elles n'utilisent pas les périphériques Bot Runner locaux, mais s'exécutent entièrement dans Cloud. Les Tâches API utilisent nos connecteurs standard, tels que Salesforce, ServiceNow, Workday, REST et SOAP pour automatiser les flux de travail et les processus. Vous ne pouvez pas utiliser une API de tâche pour automatiser une opération de bureau.
Remarque : Vous ne pouvez pas exécuter une API de tâche à partir de l'éditeur d'API dans le cadre d'une automatisation autonome. Toutefois, vous pouvez tester la API de tâche à partir de l'éditeur d'API à l'aide de la fonctionnalité Débogueur.

Pourquoi utiliser des Tâches API ?

Les Tâches API permettent d'obtenir les résultats suivants pour votre automatisation.
  • Exécutions plus rapides, atteignant la vitesse native de Java
  • Conception de cas d'utilisation à faible latence
  • Temps de réponse inférieur à une seconde
  • Fonctionnement dans un pool de périphériques sur Automation 360.Cloud
  • Possibilité de planifier des tâches API en fonction des besoins de l'entreprise
  • Infrastructure sur site non nécessaire

Appel de Tâches API

Vous pouvez appeler une API de tâche à partir d'un formulaire ou Process Composer, dans lequel vous organisez le flux de travail dans le cadre d'un processus de bout en bout. Un processus de bout en bout peut comprendre : un Robot de tâches, une API de tâche et une tâche humaine. Toutefois, lorsque des Tâches API au sein d'un flux de processus sont exécutées, les automatisations s'exécutent sur des périphériques cloud de l'infrastructure Automation 360, réduisant ainsi le temps de traitement. Les Tâches API s'exécutant sur des périphériques cloud, vous devez configurer une API de pool de périphériques. Pour plus d'informations, voir Créer une API de pool de périphériques et configurer API de tâche.

Appel de Tâches API dans un formulaire

Vous pouvez utiliser des Tâches API dans un formulaire pour rechercher dynamiquement des données par l'intermédiaire de l'appel d'API.

  • Lorsque les Tâches API sont invoquées à partir d'un formulaire, elles s'exécutent sur des périphériques cloud et fournissent une réponse en temps réel.
  • Le API de tâche est préchauffé sur un ou plusieurs périphériques cloud. Vous attribuez des périphériques à préchauffer pour la API de tâche dans Créer une API de pool de périphériques et configurer API de tâche.
  • Le nombre de périphériques que vous préchauffez dépend du niveau de concurrence dont vous avez besoin.
Appel de Tâches API dans un processus

Vous pouvez utiliser des Tâches API dans un processus pour appeler des API asynchrones.

  • Lorsque des Tâches API sont invoquées dans le cadre d'un processus, elles répondent plus rapidement qu'un Robot de tâches appelé dans le même processus.
  • Les Tâches API s'exécutent sur les périphériques non affectés disponibles dans l'API de pool de périphériques au cours de l'exécution.

Installation et configuration de l'utilisateur de API de tâche

Configurez des utilisateurs pour qu'ils créent des Tâches API et définissez-les comme utilisateurs en tant qu'utilisateurs d'exécution. Vous pouvez également attribuer des rôles appropriés aux utilisateurs.

Le diagramme suivant illustre l'installation et la configuration de Tâches API pour les administrateurs et les utilisateurs du Bot Creator :
Flux de travail de tâche API

Rôles :

Vous devez disposer des autorisations suivantes assignées à un rôle (par exemple : api_task_creator) :
  • Robots : Afficher, Exécuter, Exporter, Importer, Étiqueter, Annuler l'extraction
  • Périphériques : Afficher et gérer TOUS les périphériques
  • Afficher les actions du journal d'audit de tout le monde
  • Le rôle AAE_API Task Runner est automatiquement assigné à l'utilisateur apitaskrunner avec les autorisations suivantes :
    • Afficher les packages
    • Enregistrer le périphérique
    • Afficher les informations de base sur les utilisateurs et les rôles
    • Afficher et gérer mes Bot Runners, mes Bot Creators et mes pools de périphériques Créer des pools de périphériques
    • ROBOTS : Afficher, Exécuter, Exporter, Importer, Étiqueter, Annuler l'extraction
    • Onglet Robots : tout sélectionner dans le dossier Robots
    • Périphériques : Afficher et gérer TOUS les périphériques

Utilisateurs :

un utilisateur Exécuter en tant qu'utilisateur par défaut apitaskrunner est automatiquement assigné à chacune des Tâches API configurées dans le pool de périphériques de l'API. Le rôle AAE_API Task Runner sera associé à l'utilisateur apitaskrunner.

Vous pouvez également créer un utilisateur avec une licence Bot Creator avec les rôles suivants :
  • AAE_Base
  • AAE_Bot Developer
  • AAE_Pool Admin
  • api_task_creator (rôle personnalisé que vous avez déjà créé).

Cas d'utilisation de la API de tâche

Voici quelques-uns des cas d'utilisation de Tâches API :
Appels d'API SaaS
L'utilisation de Tâches API dans vos processus simplifie l'intégration de diverses applications SaaS par l'intermédiaire de leurs API. Les API SaaS permettent :
  • De vous connecter à des systèmes SaaS bien connus (Salesforce, Twilio ou ServiceNow, par exemple) pour effectuer des tâches complexes de manière efficace.
  • De l'utiliser comme un connecteur SaaS pour intégrer directement dans votre automatisation des données à la demande provenant d'applications externes.
Consultation de la base de données
Les Tâches API peuvent interroger des bases de données par l'intermédiaire des points de terminaison d'API de base de données. Elles peuvent se connecter rapidement à une application de base de données pour rechercher les données requises et les mettre à disposition pour un traitement ultérieur.