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¶m2=password%20MyPassword¶m3=create%20name%20My%20Process
Les noms des paramètres ne sont pas importants, car l'écouteur de ressources machine les ignore.