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¶m2=password%20MyPassword¶m3=create%20name%20My%20Process
Die Benennung der Parameter ist unwichtig, da sie der Listener des Ressourcen-PCs ignoriert.