...
Утилита запускается на машине с Vitro SP с доступом к SQL Server (база Vitro и контентная база SharePoint WSS_Content). Строка подключения к SQL читается из Conf\vitro.config сервера Vitro MP (объект SqlConnectionString), а не из config.json.
Рядом с исполняемым файлом должны находиться config.json и каталог Scripts\ с SQL-процедурами. Логи пишутся в каталог logs\ (файлы SPToMPMigrate-YYYYMMDD-HHmm.log).
...
Параметры задаются в файле config.json в каталоге с исполняемым файлом.
| Параметр | Пример значения | Описание |
|---|---|---|
| Customer | "Default" | Имя заказчика для кастомных SQL-скриптов в Scripts\{Customer}\. Если скрипт не найден, используется Scripts\procMigration_{Mode}.sql. |
| WebUrl | http://sp.vitrocad.ru | Адрес Vitro SP |
| Url | https://mp.vitrocad.ru | Адрес Vitro MP |
| Login | admin_user | Логин технической учётной записи Vitro MP |
| Password | admin_password | Пароль технической учётной записи Vitro MP |
| ModeList | [ "Folder", "File", "Reference" ] | Список и порядок режимов работы утилиты |
| SkipFieldMapError | true | Флаг пропуска ошибок маппинга лукапов. Если в Vitro SP есть значения справочников, которые не сопоставились в MP, они выводятся в лог. При false утилита завершит работу при наличии таких записей |
| SkipUserMapError | true | Флаг пропуска ошибок маппинга пользователей. Если в Vitro SP есть пользователи, которых нет в MP, они выводятся в лог. При false утилита завершает работу. Сопоставление — по email |
| DefaultUserId | 00000000-0000-0000-0000-000000000001 | GUID пользователя MP, подставляемый при отсутствии сопоставления по email |
| SwitchOffIriParsing | false | Отключение обработки ссылок от скрытых символов. Полезно, если в SP есть файлы или папки с «невидимыми» символами в имени и из-за этого не удаётся получить файл |
| ThreadNumber | 2 | Количество потоков. Параллельно работают все режимы, кроме Folder (всегда 1 поток) |
| MigrateAllFileVersion | true | При true переносятся все версии файла, при false — только последняя |
| QrCodeReplace | false | При true и установленном поле QR в SP тело файла формируется заново (PDF с QR-кодом), иначе файл читается из SP или внешнего хранилища |
| LibraryMap | { "http://sp2013/TempLibrary/Project1": "966e62c5-a803-49a0-a1be-e680d130c481" } | Переносимые корни: URL библиотеки или папки SP → GUID родительской папки или списка в MP |
| ContentTypeMap | [ [ "Проект", "540ff572-..." ], [ "Папка", "09ad2c16-..." ] ] | Маппинг типов контента SP (название) → тип элемента MP (GUID). Не указанные: папка → «Папка», файл → «Файл проекта», элемент справочника → «Элемент» |
| FieldMap | [ [ "VitroBaseStatus", "document_status", "sp_id_list" ] ] | Маппинг столбцов SP → атрибутов MP (internal name). Третий параметр — только для лукапов (поле sp_id в справочнике MP, по умолчанию sp_id) |
| ListMap | { "http://sp2013/Lists/seStatusList": "9618f977-0447-4010-88f7-76d8edca255c" } | Справочники для режима List: URL списка SP → GUID списка MP |
| ListMapCriterion | [ "Title", "name", "sp_id" ] | Критерий сопоставления в режиме List. При совпадении проставляется поле SP ID; иначе — ошибка или создание записи (см. CreateListMapItem) |
| CreateListMapItem | false | В режиме List: при false только проставление sp_id на существующих записях; при true — создание новых по ContentTypeMap и FieldMap |
...
Принцип работы
- Определяется список типов контента и полей (столбцов), которые необходимо перенести из SP в MP.
- Создаются соответствующие типы элементов и атрибуты в Vitro MP.
- Задаётся конфигурация утилиты: маппинги ТК, полей и
LibraryMap. - Создаются справочники для лукапов в MP с полем sp_id (числовой ID элемента в SP). Заполняются утилитой (режим List), вручную или комбинированно. Несопоставленные значения выводятся в лог.
- Утилита создаёт и заполняет таблицу Migration — по ней отслеживаются прогресс, объём и ошибки.
- Запускается режим Folder. Контролируются таблица Migration и лог. Ошибки на верхнеуровневых папках критичны: неперенесённый проект повлечёт ошибки у всех дочерних элементов. Ошибки устраняют или вручную корректируют запись в Migration; при повторном запуске режим обработает их снова.
- Запускается режим File. Утилита может работать в несколько потоков (
ThreadNumber). Учитывать нагрузку на Vitro SP — оптимальное число потоков подбирается на площадке. - Запускается режим Reference (обязательный этап после файлов).
- При необходимости запускаются Member, Sign, Issue (добавить в
ModeListпосле Reference). - При ошибках — анализ лога и
Migration, исправление и повторный запуск нужного режима.
...