Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Получить массив элементов процесса rpa.item.list». Вы узнаете экспертные методики работы с rpa.item.list и научитесь избегать типичных ошибок начинающих разработчиков.

Получить массив элементов процесса rpa.item.list

> Scope: rpa
>
> Кто может выполнять метод: любой пользователь

Метод получает список элементов процесса с идентификатором typeId.

Параметры метода

Обработка ответа

HTTP-статус: 200

В ответе будут только основные поля элементов, без данных о заданиях и пользователях элементов:

{
    "items": [
        {},
        {}
    ]
}

Примеры фильтра {#filters}

1. Найти элементы, на которых есть невыполненные задания текущего пользователя

    {
        "filter": {
            "tasks": "has_tasks"
        }
    }

Чтобы найти элементы, на которых нет заданий пользователя, надо передать значение no_tasks.

2. Найти элементы, обновленные пользователем с идентификатором 4

    {
        "filter": {
            "=updatedBy": "4"
        }
    }

3. Найти элементы, обновленные или сдвинутые пользователем с идентификатором 4

    {
        "filter": {
            "logic": "or",
            "0": {
                "=updatedBy": "4"
            },
            "1": {
                "=movedBy": "4"
            }
        }
    }

4. Найти элементы, у которых заполнено пользовательское поле с кодом UF_RPA_1_STRING

    {
        "filter": {
            "!=UF_RPA_1_STRING": "",
        }
    }

5. Найти элементы, которые были созданы, изменены и сдвинуты в период с 19.03 по 22.03

    {
        "filter": {
            ">createdTime":"2020-03-19T02:00:00+02:00",
            ">movedTime":"2020-03-19T02:00:00+02:00",
            ">updatedTime":"2020-03-19T02:00:00+02:00",
            "<createdTime":"2020-03-22T02:00:00+02:00",
            "<movedTime":"2020-03-22T02:00:00+02:00",
            "<updatedTime":"2020-03-22T02:00:00+02:00"
        }
    }

6. Найти элементы, которые были или созданы, или изменены или сдвинуты в период с 19.03 по 22.03

    {
        "filter": {
            "logic":"OR",
            "0":{
                ">createdTime":"2020-03-19T02:00:00+02:00",
                "<createdTime":"2020-03-22T02:00:00+02:00"
            },
            "1":{
                ">movedTime":"2020-03-19T02:00:00+02:00",
                "<movedTime":"2020-03-22T02:00:00+02:00"
            },
            "2":{
                ">updatedTime":"2020-03-19T02:00:00+02:00",
                "<updatedTime":"2020-03-22T02:00:00+02:00"
            }
        }
    }

• [](./index)
• [](./rpa-item-add)
• [](./rpa-item-update)
• [](./rpa-item-get)
• [](./rpa-item-get-tasks)
• [](./rpa-item-delete)