Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление
maxLevel1

Запуск робота

1. Поиск робота, которого нужно запустить

...

панель
titleЗапрос для получения списка роботов

...

Блок кода
titleЗапрос
GET https://<адрес вашего сервера>:9443/orchestrator/api/v1/robot-packages/all?pageNumber=1&pageSize=10&name=Дни отпуска
панель
titleЗаголовки запроса
Authorization: Bearer <ваш токен доступа>
Раскрыть
titleПодробнее
  • Обязательные параметры запроса:
    • pageNumber - номер страницы.
    • pageSize - максимальное количество записей (роботов) на указанной странице. Если у робота несколько версий, то каждая версия имеет свою отдельную запись на странице.

(подробнее о работе этих параметров см. в Получение списков).

  • Дополнительно можно указать параметр "name" для уточнения названия искомого робота.

панель
titleОтвет на запрос
Раскрыть
titleРазвернуть
{
    "items": [
        {
            "id": "c2d64bc2-c99f-4824-bf3c-c965f5809c1a",

...

            "uuid": null,
            "contract": "S_web_Robot_dlya_otcheta",
            "version": "1.0.1",
            "createDateTime": "2026-03-11T20:43:29+03:00",
            "publishDateTime": "2026-03-11T20:43:29.240614+03:00",
            "createAuthor": "Головлева А. Д.",
            "name": "Робот для отчета",
            "title": "Робот для отчета",
            "description": "Робот для составления отчета",
            "names": {
                "ru-RU": "Робот для отчета"
            },
            "descriptions": {
                "ru-RU": "Робот для составления отчета"
            },
            "changes": "Добавили действия для отправки отчета",
            "requireUiThread": true,
            "impInfoXml": "<ImplementationInfo version=\"1.0.1\" contract...",
            "storages": [],
            "childCount": null,
            "parentId": null,
            "parentSourceId": null,
            "parameters": [
                {
                    "name": "Папка с документами",
                    "type": "Robin.FolderPath",
                    "title": null,
                    "description": null,
                    "required": false
                },
                {
                    "name": "ФИО ответственного",
                    "type": "Robin.String",
                    "title": null,
                    "description": null,
                  "required": false
                }
            ],
            "results": [],
            "averageDuration": null,
            ...

Из ответа получаем значение параметра "id". Дополнительно можно взять параметры:

  • parameters - содержит входные параметры робота.
  • requireUiThread - признак, требует ли робот наличия UI-сессии на учётной записи машины.

В ответ может вернуться несколько записей с роботами. Найти нужную запись можно по версии робота ("version"), его описанию ("description") или описанию изменений в его версии ("changes"):

панель
titleПример
Раскрыть
titleРазвернуть
{
    "items": [
        {
            "id": "c2d64bc2-c99f-4824-bf3c-c965f5809c1a",
            "uuid": null,
            "contract": "S_web_Robot_dlya_otcheta",
           "version": "1.0.1",
            "createDateTime": "2026-03-11T20:43:29+03:00",
            "publishDateTime": "2026-03-11T20:43:29.240614+03:00",
            "createAuthor": "Головлева А. Д.",
            "name": "Робот для отчета",
            "title
Пример ответа

Image Removed

2. Выбираем учётную запись машины, на которой будем запускать робота

Выполняем запрос:

...

": "Робот для отчета",
           "description": "Робот для составления отчета",
            "names": {
                "ru-RU": "Робот для отчета"
            },
            "descriptions": {
                "ru-RU": "Робот для составления отчета"
            },
           "changes": "Добавили действия для отправки отчета",
            "requireUiThread": true,
          ...
        },
        {
            "id": "c8820b02-6d65-4022-9ca6-c32504d5684b",
            "uuid": null,
            "contract": "S_web_Robot_dlya_otcheta",
           "version": "1.0.0",
            "createDateTime": "2026-03-11T20:42:22+03:00",
            "publishDateTime": "2026-03-11T20:42:22.778898+03:00",
            "createAuthor": "Головлева А. Д.",
            "name": "Робот для отчета",
            "title": "Робот для отчета",
           "description": "Робот для составления отчета",
            "names": {
                "ru-RU": "Робот для отчета"
            },
            "descriptions": {
                "ru-RU": "Робот для составления отчета"
            },
           "changes": "1я версия",
            "requireUiThread": true,
          ...
        }
    ],
    "pageNumber": 1,
    "totalPages": 1,
    "totalItems": 2
}

2. Поиск учётной записи машины, на которой нужно запустить робота

панель
titleЗапрос для получения списка учётных записей машин
GET https://<адрес вашего сервера>:9443/orchestrator/api/v1/hosts/host-users?pageNumber=1&pageSize=

...

10&search=Huawei
панель
titleЗаголовки запроса
Authorization: Bearer <ваш токен доступа>
Раскрыть
titleПодробнее

Обязательные параметры запроса:

    • pageNumber - номер страницы.
    • pageSize - максимальное количество записей (УЗ машин) на указанной странице.

(подробнее о работе этих параметров см. в Получение списков).

  • Дополнительно можно указать параметр "search" для уточнения имени искомой учётной записи.

панель
titleОтвет на запрос
Раскрыть
titleРазвернуть
{
    "items": [
        {
           "id": "4c024d2c-e99d-4789-ba3f-5705e1c52305",
            "username": "LAPTOP-NO7H14PR\\Huawei",
            "host": {
                "id": "d1e77f6c-a0c0-481d-aaf5-5bdd422df012",
                "hostname": "LAPTOP-NO7H14PR",
              "ip": "192.161.7.8",
                "os": "WINDOWS",
                "diskSpaceTotalKB": 495238246,
                "ramTotalKB": 16119104,
                "coresNumber": 6,
                "cpuLoadPercentage": null,
                "diskSpaceFreeKB": null,
              ...

Из ответа получаем значение параметра "id".

В ответ может вернуться несколько записей с учётными записями. Найти нужную запись можно по имени машины ("hostname"), IP-адресу ("ip"), тегам ("tags") или описанию учётной записи ("description"). А также по имени учётной записи ("username"), если в запросе искали только по части имени.

панель
titleПример
Раскрыть
titleРазвернуть
{
    "items": [
        {
            "id": "4c024d2c-e99d-4789-ba3f-5705e1c52305",
           "username": "LAPTOP-NO7H14PR\\Huawei",
            "host": {
                "id": "d1e77f6c-a0c0-481d-aaf5-5bdd422df012",
               "hostname": "LAPTOP-NO7H14PR",
               "ip": "192.161.7.8",
                "os": "WINDOWS",
                "diskSpaceTotalKB": 495238246,
                "ramTotalKB": 16119104,
                "coresNumber": 6,
                "cpuLoadPercentage": null,
                "diskSpaceFreeKB": null,
                "ramFreeKB": null
            },
            "createDateTime": "2023-06-27T13:54:36.86242+03:00",
            "hasUiThread": false,
            "isOnline": false,
            "activeRobotCount": 0,
            "activeUiRobotCount": 0,
            "activeBackgroundRobotCount": 0,
           "tags": [
              "для проверки роботов"
          ]
,
           "description": "Личный ноутбук",
            "software": "",
          ...
        },
        {
            "id": "f9528ab5-8ccd-4865-b6ab-6b2010853fc1",
           "username": "WIN-TEST-01\\test",
            "host": {
                "id": "52c903ec-410a-483c-a565-b4b95c84c011",
               "hostname": "win-test-01",
               "ip": "10.63.7.14",
                "os": "WINDOWS",
                "diskSpaceTotalKB": 44854931,
                "ramTotalKB": 8387608,
                "coresNumber": 1,
                "cpuLoadPercentage": null,
                "diskSpaceFreeKB": null,
                "ramFreeKB": null
            },
            "createDateTime": "2024-03-20T16:48:33.133505+03:00",
            "hasUiThread": false,
            "isOnline": false,
            "activeRobotCount": 0,
            "activeUiRobotCount": 0,
            "activeBackgroundRobotCount": 0,
           "tags": [],
           "description": "для тестирования",
            "software": null,
          ...
        }
    ],
    "pageNumber": 1,
    "totalPages": 1,
    "totalItems": 2
}

3. Запуск робота

панель
titleЗапрос для запуска робота
GET https://<адрес вашего сервера>:9443/orchestrator/api/v1/robots/start
панель
titleЗаголовки запроса
  • Authorization: Bearer <ваш токен доступа>
  • Content-Type: application/json
панель
titleТело запроса
{
"hostUserId": "4c024d2c-e99d-4789-ba3f-5705e1c52305",
"robotPackageId": "c2d64bc2-c99f-4824-bf3c-c965f5809c1a",
  "jsonParameters": [
    {
    "name": "Папка с документами",
    "type": "Robin.FolderPath",
    "value": "C:\\Users\\Huawei\\Desktop\\Материалы"
    },
    {
    "name": "ФИО ответственного",
    "type": "Robin.String",
    "value": "Иванов И.И."
  }
  ],
  "logLevel": "ROBOT_DEVELOPER",
  "allowParallelUiRobotSession": true
}
Раскрыть
titleПодробнее
  • Обязательные параметры в теле запроса:
    • hostUserId - идентификатор учётной записи машины, на которой будет запущен робот (получали в запросе №2).
    • robotPackageId - идентификатор запускаемого робота (получали в запросе №1).
  • Дополнительно можно указать параметры:
    • jsonParameters - для указания входных параметров робота. Название параметров ("name") и их тип ("type") копируем из ответа на запрос №1 (из "parameters"). В "value" указываем значение входного параметра.
    • logLevel - уровень логирования, с которым будет запущен робот.

    • allowParallelUiRobotSession - определяет, может ли робот работать параллельно с другими UI-роботами на той же учётной записи машины. Имеет смысл указывать, если текущему роботу требуется UI-сессия (у робота параметр requireUiThread=true, см. запрос №1), а на указанной учётной записи уже работает UI-робот (или его запустят позже).

панель
titleОтвет на запрос
Раскрыть
titleРазвернуть
{
   "id": "d6ff9f85-a7f5-44cd-9a97-6d94a6a0fa42",
    "createDateTime": "2026-03-12T00:03:52.510176456+03:00",
    "startDateTime": null,
    "stopDateTime": null,
    "pauseDateTime": null,
    "finishDateTime": null,
  ...

 Из ответа может понадобится значение параметра "id". В нем указан идентификатор сессии робота, по которому можно остановить работу робота или поставить ее на паузу.

Управление запуском робота

1. Установка паузы

панель
titleЗапрос для приостановки робота на паузу
GET https://<адрес вашего сервера>:9443/orchestrator/api/v1/robots/start