crm.item.list

Scope: crm Права на выполнение: для всех

Описание и параметры

crm.item.list({entityTypeId: number, select:?[] = ['*'], order: ?{} = null, filter: ?{} = null, start: ?number = 0})

Метод вернет массив элементов смарт-процесса с идентификатором entityTypeId:

{
	"items": []
}

где каждый элемент массива - это структура, аналогичная ответу на запрос crm.item.get.

Параметры

Параметр	Описание
entityTypeId	Идентификатор смарт-процесса.
select	Массив имен полей для выборки.
order	Список для сортировки, где ключ - поле, а значение - `ASC` или `DESC`.
filter	Список для фильтрации. Примеры фильтров ниже.
start	Сдвиг для постраничной навигации.

Обработка select

Параметр select может содержать в себе только названия полей для этого смарт-процесса или '*'.

По умолчанию будет произведена выборка всех полей. Аналогичное поведение будет, если в списке полей присутствует '*'.

Примеры:

Будут выбраны все поля.
```
{
	"select": ["*", "title", "id"],
}
```
Будет выбрано только поле id. Названия полей надо передавать в явном виде или '*'.
```
{
	"select": ["id", "uf_*"],
}
```
Будут выбраны поля id, title и categoryId.
```
{
	"select": ["id", "title", "categoryId"],
}
```

Примеры фильтра

Найти элементы, у которых ответственным является пользователь с идентификатором 4
```
{
	"filter": {
		"=assignedById": "4"
	}
}
```
Найти элементы, находящиеся на финальных стадиях, доступные для всех, либо у которых ответственным является пользователь с идентификатором 4
```
{
	"filter": {
		"@stageId": ["DT132_17:SUCCESS", "DT132_17:FAIL"],
		"0": {
			"logic": "OR",
			"0": {
				"=assignedById": 4
			},
			"1": {
				"=opened": "Y"
			}
		}
	}
}
```
Найти элементы, у которых заполнено пользовательское поле с кодом ufCrm24_1616150749
```
{
	"filter": {
		"!=ufCrm24_1616150749": ""
	}
}
```

Найти элементы, которые были созданы, изменены и сдвинуты в период с 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"
	}
}

Найти элементы, которые были или созданы, или изменены или сдвинуты в период с 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"
		}
	}
}