Значения полей разных типов

Краткая шпаргалка. Полные примеры (REST, JS, WebPart, ER, TJ): API: Значения полей.

Тип	Значение в fieldValues
text / multiline_text	строка
html_text	HTML (санитизация на сервере)
choice	одна из settings.choices
number	число
date	YYYY-MM-DD
datetime	ISO 8601
boolean	true / false
lookup	{ "itemId": "…", "display": "…" }
person	массив субъектов { principalType, id, display } (по умолчанию multi); при allowMultiple: false — один объект
link	{ "url": "https://…", "description": "…" }

Паттерн WebPart / Event Receiver / Timer Job / REST

1. GetFieldsAsync / GET .../fields
2. Словарь internal_name → fieldId
3. Читать и писать field_values[fieldId]

Версии элемента

При включённом версионировании списка:

• REST: GET /lists/{listId}/items/{itemRef}/versions
• SDK: GetItemVersionsAsync / GetItemVersionAsync — у каждой версии полный снимок fieldValues

Примеры: API: Значения полей — Версии, API списков.

Паттерн Provisioner

Писать по internal_name — платформа сопоставит поля схемы списка.