Interface HTTP de ressource machine

Ce document décrit les mécanismes de contrôle d'une ressource machine Blue Prism à l'aide des mécanismes HTTP.

La communication peut être établie via HTTP GET ou HTTP POST. Chaque mécanisme englobe simplement les commandes de ressource machine de base, qui peuvent être émises via une interface telnet.

Requêtes HTTP GET

Les commandes peuvent être émises sous forme d'URL. La commande qui vous intéresse (avec les arguments) s'affiche comme s'il s'agissait du nom d'un document à récupérer. Par exemple, l'URL

http://localhost:8181/create%20name%20MyProcess

correspond à la commande

create name MyProcess (créer nom MonProcessus)

Veuillez noter que les caractères spéciaux doivent être évités, par exemple un espace doit être remplacé par %20. Tous les caractères autres qu'alphanumériques, dans un nom de processus par exemple, doivent également être évités. Il est possible d'obtenir cela dans javascript en utilisant la fonction « escape() » ou dans .NET Framework en utilisant la fonction « System.Web.HttpUtility.UrlEncode() ».

Plusieurs commandes peuvent être spécifiées comme incluses. Par exemple, vous pouvez vous authentifier (à l'aide des commandes utilisateur et mot de passe) et lancer un processus (à l'aide de la commande exécuter) d'un seul tenant, de la manière suivante :

http://localhost:8181/user%20admin&password%20MyPassword&create%20name%20My%20Brilliant%20Process

Veuillez noter que les commandes sont séparées par le caractère &.

Requêtes HTTP POST

Les commandes peuvent être émises en tant que paramètres dans une requête HTTP POST. Par exemple, le message suivant posté dans « /automate » effectue l'authentification et lance un processus, comme le fait l'exemple HTTP GET ci-dessus :

POST / HTTP/1.1
Host: localhost:8181
User-Agent: Mozilla/4.0
Content-Length: 92
Content-Type: text/plain

param1=user%20admin&param2=password%20MyPassword&param3=create%20name%20My%20Process

Les noms des paramètres ne sont pas importants, car l'écouteur de ressources machine les ignore.