Interfaz HTTP del equipo de recursos

Este documento describe los mecanismos para controlar un equipo de recursos de Blue Prism mediante HTTP.

La comunicación puede ser a través de HTTP GET o HTTP POST. Cada mecanismo ajusta los comandos básicos del equipo de recursos, que pueden emitirse a través de una interfaz telnet.

Solicitudes HTTP GET

Los comandos se pueden emitir en forma de URL. El comando de interés (junto a los argumentos) aparece como si fuera el nombre de un documento por recuperar. Por ejemplo, la URL:

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

corresponde al comando:

crear nombre MyProcess

Tenga en cuenta que los caracteres especiales deben ser de escape, p. ej., el carácter de espacio debe escribirse como %20. Por ejemplo, cualquier carácter no alfanumérico en el nombre de un proceso también deberá ser de escape. Esto se puede lograr en javascript usando la función "escape()" o en .NET framework usando la función "System.Web.HttpUtility.UrlEncode()".

Se pueden especificar varios comandos en línea. Por ejemplo, puede autenticarse a sí mismo (usando los comandos de usuario y contraseña) e iniciar un proceso (usando el comando de ejecución) todo de una sola vez, de la siguiente manera:

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

Tenga en cuenta que los comandos están separados por el carácter &.

Solicitudes HTTP POST

Los comandos se pueden emitir como parámetros dentro de una solicitud HTTP POST. Por ejemplo, el siguiente mensaje publicado en "/automate" realiza la autenticación e inicia un proceso, tal como lo hace el ejemplo de HTTP GET anterior:

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

El nombre de los parámetros no es importante, porque el oyente del equipo de recursos los ignora.