Получить элементы листа
Элемент считывает элементы списка SharePoint и сохраняет их в переменную типа DataTable: одна строка таблицы — один элемент списка, столбцы — поля. Для корректной работы следует поместить элемент в контейнер Microsoft 365.
Свойства
Описание общих свойств элемента см. в разделе Свойства элемента .
Символ * в названии свойства указывает на обязательность его заполнения.
| Свойство | Тип | Описание |
|---|---|---|
| Параметры: | ||
| Лист* | List | Список, полученный элементом Получить информацию о листе |
| Фильтр | String | Условие отбора элементов, например "fields/Status eq 'Новая'" |
| Колонки | List<String> | Внутренние имена считываемых полей, например new List<string> { "Title", "Status" }. Если не заполнено — все поля |
| Результат: | ||
| Результат | DataTable | Переменная для сохранения элементов |
| Элементы | List<ListItem> | Переменная для сохранения элементов в виде объектов. Используется в элементах Редактировать элемент листа и Удалить элемент листа. Необязательное свойство |
Примечание: Имена столбцов результата — внутренние имена полей. Кроме полей списка результат содержит служебные столбцы: id — идентификатор элемента, Created, Modified и другие. См. Имена полей.
Примечание: Все значения возвращаются в виде строк. Даты — в формате ISO 8601 в UTC, например 2026-09-24T07:30:00Z.
Практический пример
Новые заявки
- Лист:
list - Фильтр:
"fields/Status eq 'Новая'" - Колонки:
new List<string> { "Title", "Status", "Amount" } - Результат:
items
Значение поля первого элемента: items.Rows[0]["Title"].
Пример 2: изменение найденной записи
- Получить элементы листа: Лист —
list, Фильтр —"fields/Title eq 'Заявка №125'", Элементы —spItems. - Элемент выполнения кода:
spItems[0].Fields.AdditionalData["Status"] = "Выполнена"; - Редактировать элемент листа: Элемент —
spItems[0].
Возможные ошибки
| Ошибка | Причина и решение |
|---|---|
Не указан лист | Не заполнено свойство Лист |
Field '...' cannot be referenced in filter or orderby as it is not indexed | Поле из Фильтра не индексировано. Добавьте индекс в параметрах списка SharePoint |