crm.item.list

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

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

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

{
	"items": []
}

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

Параметры

Обработка select

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

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

Примеры:

• Будут выбраны все поля.

  {
  	"select": ["*", "title", "id"],
  }

• Будет выбрано только поле id. Названия полей надо передавать в явном виде или '*'.

  {
  	"select": ["id", "uf_*"],
  }

• Будут выбраны поля id, title и categoryId.

  {
  	"select": ["id", "title", "categoryId"],
  }

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

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

   {
   	"filter": {
   		"=assignedById": "4"
   	}
   }
   

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

   {
   	"filter": {
   		"@stageId": ["DT132_17:SUCCESS", "DT132_17:FAIL"],
   		"0": {
   			"logic": "OR",
   			"0": {
   				"=assignedById": 4
   			},
   			"1": {
   				"=opened": "Y"
   			}
   		}
   	}
   }
   

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

   {
   	"filter": {
   		"!=ufCrm24_1616150749": ""
   	}
   }
   

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

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