Маппинг полей SharePoint → Portal
Эта страница — справочник для администратора миграции: какой тип колонки SharePoint станет каким полем Portal при работе программы portal-sp-migrate.
Пошаговый запуск мастера: Миграция из SharePoint.
Термины «список», «библиотека», «подстановка» — в словаре.
1. Списки и библиотеки
Заголовок раздела «1. Списки и библиотеки»| В SharePoint | В Portal | Комментарий |
|---|---|---|
| Обычный список (Custom List) | Список | Таблица с элементами |
| Библиотека документов | Библиотека | Файлы и папки |
| Другие шаблоны | Обычно не переносятся | Можно сузить/расширить область в настройках миграции (scope) |
2. Типы полей (колонок)
Заголовок раздела «2. Типы полей (колонок)»| SharePoint | Поле в Portal (как в UI) | Что важно знать |
|---|---|---|
| Text | Однострочный текст | |
| Note (простой текст) | Многострочный текст | |
| Note (форматированный) | HTML-текст | |
| Choice | Выбор | Варианты берутся из SharePoint |
| MultiChoice | Однострочный текст | Несколько значений склеиваются через ; |
| Number, Currency | Число | |
| DateTime (только дата) | Дата | |
| DateTime | Дата и время | |
| Boolean | Да/Нет | |
| User | Пользователь/группа | Один человек; заполняется на этапе lookups |
| UserMulti | Пользователь/группа | Несколько людей/групп; этап lookups |
| Lookup | Подстановка | Этап lookups после импорта целевого списка |
| LookupMulti | Подстановка | Сейчас берётся первое значение |
| URL | Ссылка | Адрес + описание |
| Calculated | — | Пропускается |
| Taxonomy / Managed Metadata | — | Пропускается |
Для полей «сотрудник» нужны синхронизация пользователей (AD) и таблица соответствий (principalMap) — иначе в Portal может остаться только отображаемое имя без привязки к учётке.
3. Системные поля
Заголовок раздела «3. Системные поля»| SharePoint | Portal | Действие миграции |
|---|---|---|
| ID | Номер элемента | Portal назначает свой номер |
| Title | Название / title | Создаётся явно, если его ещё нет |
| Created, Modified | — | В текущей версии не переносятся |
| Author, Editor | «Кем создано» | Системное поле Portal |
| Content Type | — | Пропускается |
Идентификаторы в Portal новые. Связь «старый ID → новый» хранится в файле состояния миграции — для повторных запусков и этапа подстановок.
4. Как заполняются сложные значения
Заголовок раздела «4. Как заполняются сложные значения»Сотрудник (User / UserMulti)
Заголовок раздела «Сотрудник (User / UserMulti)»- Сначала программа ищет соответствие в principalMap (логин / email → пользователь или группа Portal).
- Если не нашла — ищет по каталогу пользователей/групп Portal.
- Если и так не нашла — может оставить только отображаемое имя без жёсткой привязки.
Поэтому перед миграцией прав и person-полей полезно прогнать ad-sync.
Подстановка (Lookup)
Заголовок раздела «Подстановка (Lookup)»Двухпроходная схема:
- Сначала переносятся все списки и обычные поля (подстановки временно пропускаются).
- Затем вложения.
- Затем этап lookups проставляет ссылки на уже созданные элементы.
Выбор (Choice)
Заголовок раздела «Выбор (Choice)»Значение должно совпасть с одним из вариантов в настройках поля Portal. Если в SharePoint было «В работе», а в Portal вариантов нет — значение может не сохраниться корректно.
5. Как образуются адреса (slug) и внутренние имена
Заголовок раздела «5. Как образуются адреса (slug) и внутренние имена»Названия на русском/с пробелами превращаются в короткие латинские идентификаторы для URL и внутренних имён:
| Было | Станет примерно |
|---|---|
Задачи | zadachi |
HR Department | hr-department |
В интерфейсе сотрудники по-прежнему видят человеческое название.
6. Что не мигрируется (напоминание)
Заголовок раздела «6. Что не мигрируется (напоминание)»- История версий файлов
- Workflows, Content Types, Managed Metadata
- Современные страницы сайта и веб-части SharePoint
- Права на уровне списка в SharePoint Online (часто только права сайта)