HTTP-Schnittstelle von Ressourcen-PCs

Dieses Dokument beschreibt Mechanismen zur Kontrolle eines Blue Prism Ressourcen-PCs per HTTP.

Die Kommunikation kann über HTTP GET oder HTTP POST erfolgen. Jeder Mechanismus umfasst die grundlegenden Ressourcen-PC-Befehle, die über eine Telnet-Schnittstelle erteilt werden können.

HTTP-Anfragen mit GET

Befehle können als URL erteilt werden. Der Befehl erscheint (zusammen mit den Argumenten) wie der Name eines abzurufenden Dokuments. So entspricht die URL:

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

dem Befehl:

create name MyProcess

Achtung: Sonderzeichen müssen escaped werden – z. B. muss eine Leerstelle als %20 geschrieben werden. Sämtliche nicht alphanumerischen Zeichen in einem Prozessnamen sind ebenfalls zu escapen. In JavaScript geschieht dies mit der Funktion „escape()“ und im .NET Framework mit „System.Web.HttpUtility.UrlEncode()“.

Es können mehrere Befehle hintereinander angegeben werden. Zum Beispiel können Sie sich gleichzeitig mit den Befehlen user und password authentifizieren und mit dem Befehl run einen Prozess starten:

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

Beachten Sie, dass Befehle durch das Zeichen & getrennt werden.

HTTP-Anfragen mit POST

In HTTP-Anfragen mit POST können Befehle als Parameter erteilt werden. Die folgende in „/automate“ gepostete Nachricht führt beispielsweise eine Authentifizierung durch und startet einen Prozess, genau wie beim obigen Beispiel zu HTTP GET:

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

Die Benennung der Parameter ist unwichtig, da sie der Listener des Ressourcen-PCs ignoriert.