Маппинг полей SharePoint → Portal

Таблица соответствия типов полей при миграции через portal-sp-migrate.

Списки и библиотеки

SharePoint BaseTemplate	Portal
100 (Custom List)	List (POST /lists)
101 (Document Library)	Library (POST /libraries)
Прочие шаблоны	Исключаются по умолчанию (настраивается через scope)

Типы полей

SharePoint FieldType	Portal fieldType	Примечание
Text	text
Note (plain)	multiline_text
Note (rich text)	html_text
Choice	choice	settings.choices из SP
MultiChoice	text	Значения через ;
Number, Currency	number
DateTime (date only)	date
DateTime	datetime
Boolean	boolean
User	person	allowMultiple: false, allowUsers/allowGroups: true, principalMap + AD-sync + фаза lookups
UserMulti	person	allowMultiple: true, фаза lookups
Lookup	lookup	Фаза lookups после импорта целевого списка
LookupMulti	lookup	MVP: первое значение
URL	link	{ url, description }
Calculated	—	Пропускается
TaxonomyFieldType	—	Пропускается (или text в будущем)

Системные поля

SharePoint	Portal	Действие
ID	item_number	Авто-назначение Portal
Title	title	Создаётся явно, если отсутствует
Created, Modified	—	Не мигрируются (MVP)
Author, Editor	created_by	Системное поле Portal
ContentType	—	Пропускается

Значения полей

Person

SharePoint возвращает { Email, LookupValue, Title }. Portal ожидает:

• User / одиночное person (allowMultiple: false) — один объект:

{ "principalType": "user", "id": "uuid", "display": "Иванов И.И." }

• UserMulti / multi person — массив объектов:

[
  { "principalType": "user", "id": "uuid", "display": "Иванов И.И." },
  { "principalType": "group", "id": "uuid", "display": "HR" }
]

Резолвинг в фазе lookups:

1. scope.principalMap (логин / email → UUID)
2. GET /api/v1/users?q= / GET /api/v1/groups?q=
3. Fallback: только display без id (если пользователь не найден)

Lookup

Двухпроходная миграция:

1. Фаза items — все списки и элементы (lookup/person пропускаются)
2. Фаза attachments — файлы вложений элементов (POST .../attachments)
3. Фаза lookups — quick-edit update с { itemId, display } по id_map

Choice

Значение должно совпадать с одним из settings.choices в Portal.

Slug-нормализация

Заголовки узлов, списков и internal names транслитерируются в kebab-case / snake_case:

• Задачи → zadachi
• HR Department → hr-department

Что не мигрируется

• Версии файлов
• Workflows, Content Types, Managed Metadata
• Modern Site Pages и WebParts
• List-level ACL в SharePoint Online (Graph) — только site/web ACL

Roadmap

• POST /files/{id}/versions для истории версий
• HTML-отчёт verify