Получить список записей таймлайна для элемента rpa.timeline.listForItem

Scope: rpa

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

DEPRECATED

Развитие метода остановлено. Используйте смарт-процессы как аналог функционала.

Метод получает список записей таймлайна для элемента itemId процесса typeId.

Записи имеют сортировку по убыванию даты создания, то есть сверху списка расположены самые новые.

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

Название
тип

Описание

typeId
integer

Идентификатор процесса

itemId
integer

Идентификатор элемента

start
integer

Параметр используется для управления постраничной навигацией.

Размер страницы результатов всегда статичный — 50 записей.

Чтобы выбрать вторую страницу результатов, необходимо передавать значение 50. Чтобы выбрать третью страницу результатов — значение 100 и так далее.

Формула расчета значения параметра start:

start = (N - 1) * 50, где N — номер нужной страницы

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

HTTP-статус: 200

{
            "timeline": [
                {
                    "id": 321,
                    "typeId": 24,
                    "itemId": 10,
                    "createdTime": "2020-03-26T20:28:57+02:00",
                    "userId": 1,
                    "title": "Выполнено задание",
                    "description": "",
                    "action": "task_complete",
                    "isFixed": false,
                    "data": {
                        "item": {
                            "name": "New name"
                        },
                        "scope": "task",
                        "stageFrom": {
                            "id": 30,
                            "name": "Утверждение бухгалтером"
                        },
                        "stageTo": {
                            "id": 31,
                            "name": "Утверждено"
                        },
                        "fields": [
                            {
                                "name": "UF_RPA_24_NAME",
                                "title": "Название"
                            }
                        ],
                        "task": {
                            "ID": "91",
                            "USER_ID": "1",
                            "WORKFLOW_ID": "5e7cf3e91ef413.27314358",
                            "ACTIVITY": "RpaRequestActivity",
                            "ACTIVITY_NAME": "A79985_79846_49104_50661",
                            "NAME": "Task",
                            "DESCRIPTION": "",
                            "PARAMETERS": {
                                "DOCUMENT_ID": [
                                    "rpa",
                                    "Bitrix\\Rpa\\Integration\\Bizproc\\Document\\Item",
                                    "24:10"
                                ],
                                "TASK_EDIT_URL": "/rpa/task/id/#ID#/",
                                "ACTIONS": [
                                    {
                                        "color": "3bc8f5",
                                        "stageId": "31",
                                        "label": "Сохранить"
                                    }
                                ],
                                "FIELDS_TO_SHOW": [
                                    "UF_RPA_24_NAME",
                                    "UF_RPA_24_STRING_MANDATORY"
                                ],
                                "RESPONSIBLE_TYPE": null,
                                "APPROVE_TYPE": null,
                                "FIELDS_TO_SET": [
                                    "UF_RPA_24_NAME"
                                ]
                            },
                            "USERS": [
                                1
                            ],
                            "INCOMPLETE_USERS": []
                        }
                    },
                    "createdTimestamp": 1585247337000,
                    "users": {
                        "1": {
                            "id": "1",
                            "name": "Anton",
                            "secondName": "",
                            "lastName": "Gorbylev",
                            "title": null,
                            "workPosition": "",
                            "fullName": "Anton Gorbylev",
                            "link": "/company/personal/user/1/"
                        }
                    }
                },
            ]
        }

Возвращаемые данные

Название

Описание

id

Идентификатор записи

typeId

Идентификатор процесса

itemId

Идентификатор элемента

createdTime

Время создания записи

userId

Идентификатор пользователя, который инициировал действие

title

Заголовок записи

description

Текстовое содержимое записи

action

Код типа действия

isFixed

Флаг прикрепления записи

data

Сериализованные данные о выполненном действии и связанных сущностях на момент создания записи. В зависимости от типа действия может содержать разный набор данных

Объект data

Название

Описание

item

Данные об элементе:

  • item[name] — название элемента на момент выполнения действия

scope

Код источника действия. Может принимать значение:

  • manual — вручную
  • task — при выполнении задания
  • automation — роботом
  • rest — приложением

stageFrom

Данные об исходной стадии на момент выполнения действия

  • id — идентификатор
  • name — название

stageTo

Данные о новой стадии, если она была изменена при выполнении действия

fields

Массив данных о полях, значения которых были изменены при выполнении действия

  • name — код поля
  • title — заголовок поля

task

Данные о задании, если действие было сделано при выполнении задания

users

Данные о пользователях, которые имели отношение к действию

Продолжите изучение

Предыдущая
Обновить флаг прикрепления записи
Следующая
Удалить запись таймлайна