Преобразование решений для фермы в модель надстроек SharePoint

Статья
04/08/2023

Если вы расширили свою среду SharePoint с помощью решений для фермы и хотите перенести ваши расширения в модель надстройки SharePoint, чтобы облегчить переход на SharePoint Online, вам нужно преобразовать свои решения для фермы в модель надстройки SharePoint.

Преобразование решений для фермы в модель надстройки SharePoint включает анализ существующих расширений, разработку и проектирование вашей новой надстройки SharePoint, а затем тестирование и развертывание вашей надстройки в рабочей среде.

Данная статья содержит описание процесса и рекомендации, которые можно использовать при преобразовании своих решений для фермы в модель надстройки SharePoint.

Планирование процесса преобразования

При преобразовании решений для фермы в модель надстройки SharePoint, необходимо убедиться, что влияние на ваших пользователей будет минимальным. Выполните тщательный анализ текущих решений для фермы, а потом создайте вашу новую надстройку SharePoint в соответствии с потребностями вашей организации. Мы рекомендуем использовать указанную ниже процедуру, чтобы гарантировать успешное преобразование.

Готовность

Дополнительные сведения:

Модель надстройки SharePoint, различные виды надстроек и параметры размещения. Дополнительные сведения см. в статье Надстройки SharePoint.
Технологии удаленного доступа для доступа к локальным данным.

Оценка решения

Анализ функциональных и рабочих требований:

Определение развернутых решения для фермы в вашей среде. Рекомендуется использовать сторонние средства, которые помогут вам определить развернутые расширения. Выполните углубленный анализ каждого решения для фермы, которое вы определили.
Проверка требований вместе с вашими пользователями. Попросите пользователей продемонстрировать, как они используют существующие решения для фермы для выполнения своей повседневной работы.
Определение, документальное оформление и разработка новых функций, предназначенных для включения в новую надстройку SharePoint. Вы можете использовать список запросов новых функций от ваших пользователей в качестве дополнительного источника идей.
Определение не использовавшихся ранее функций и согласование с пользователями отказа от включения этих функций в новую надстройку SharePoint.
Для каждого решения для фермы необходимо определить, нуждается ли оно в замене на надстройку SharePoint. Некоторые решения, например расширения для администрирования SharePoint, не могут повторяться в модели надстройки SharePoint. Дополнительные сведения см. в статьях Управление жизненным циклом приложений SharePoint и Надстройки SharePoint в сравнении с решениями для SharePoint.

Планирование решения

Разработка нового приложения с помощью модели надстройки SharePoint на основе:

Требований, собранных на этапе оценки решения.
Ваш анализ существующего кода. Во время анализа кода мы рекомендуем определить части кода, которые можно опустить (например, код, который больше не используется, код, не отвечающий изменившимся требованиям).

Разработка и проверка версии модели надстройки SharePoint вашего приложения

Обычно это наиболее значительный по затратам времени этап процесса преобразования.

Развертывание новой надстройки

В зависимости от ваших требований может потребоваться сохранение работоспособного решения для фермы параллельно с новой надстройкой SharePoint, или вы можете отозвать решение для фермы и разрешить пользователям использовать только новую надстройку SharePoint. В любом случае необходимо убедиться, что развертывание стабильно, и отправить необходимые сообщения вашим пользователям.

Если контент в существующем семействе веб-сайтов зависит от решения для фермы (например, если контент был создан с помощью типа контента), перед тем как полностью отозвать решение для фермы, вам нужно преобразовать существующее содержимое для использования решения новой модели надстройки SharePoint решение. Убедитесь, что вы выделяете достаточно времени для выполнения этой задачи, так как она может быть достаточно сложной и затратной по времени.

Способы преобразование для развертывания новой надстройки SharePoint

После завершения разработки и тестирования вашей новой надстройки SharePoint, начните преобразование вашего решения для фермы для новой надстройки SharePoint, используя один из способов преобразования, указанных в приведенной ниже таблице.

Способы преобразования	Описание	Преимущества	Недостатки
На месте	Развертывание новой надстройки SharePoint в существующей среде SharePoint. Необходимо убедиться, что ваш сайт использует новую надстройку SharePoint перед отзывом решения для фермы.	Меньшее влияние на пользователей. Меньшее необходимое количество ресурсов, потому что вы используете уже существующую среду SharePoint. Нет необходимости в использовании сторонних средств. Минимальное время простоя сайта. Обновление одного семейства веб-сайтов за раз, а не обновление всей фермы сразу. URL-адрес не будут изменяться.	Сложно определить ход выполнения для всех затронутых активов на сайте. Большая вероятность получения потерянных записей (когда актив указывает на файл в файловой системе, который не существует, это называется потерянной записью).
Отклонение или миграция контента	Извлечение содержимого существующего семейства веб-сайтов, где ваши решения для фермы развернуты в настоящее время, и развертывание этого содержимого в новом семействе веб-сайтов, которое использует новую надстройку SharePoint. При переносе содержимого в SharePoint Online обычно используется этот процесс.	Чистая среда SharePoint без каких-либо зависимостей от предыдущего решения для фермы. Новое семейство сайтов изолируется от вашей рабочей среды. Выпуск обновленного семейства веб-сайтов производится после полной готовности. .	Требуется использование сторонних средств, которые помогают выполнять перенос контента. Требуется дополнительная среда SharePoint. Обязательный простой сайта в течение определенного времени. URL-адреса могут измениться, если вы поддерживаете оба сайта в рабочем состоянии параллельно в течение определенного периода времени.

Советы и рекомендации для конкретных решений для фермы

Применяйте приведенные ниже рекомендации при преобразовании конкретных решений.

Главные страницы и макеты страниц

На сайтах публикации или сайтах группы могут использоваться настраиваемые макеты страниц и главные страницы.

Для замены главных страниц и макетов страниц:

Загрузите новый макет страницы или образец страницы на сайт. Загрузите новые образцы страницы и макеты страниц в семейство веб-сайтов вручную или с помощью удаленного API. Удаленный API включает клиентскую объектную модель (CSOM) или REST. Это гарантирует, что главные страницы и макеты страниц не будут иметь зависимостей от решения для фермы.
Настройте ваш сайт для использования новых макетов страниц и главных страниц.
Отзовите предыдущую версию макетов страниц и главных страниц.

Веб-части и элементы управления

Для замены веб-частей и элементов управления:

Просмотрите все существующие страницы, чтобы определить, какие страницы имеют веб-части.
(Необязательно) Просмотрите встроенные веб-части, чтобы определить, можно ли с их помощью заменить ваши настраиваемые веб-части.
Замените существующие веб-части экземплярами приложения или с помощью других техник (например, внедрение JavaScript в страницы и макеты страниц), чтобы получить те же функциональные возможности.
Используйте внедренный JavaScript для операций с элементами пользовательского интерфейса.

Примечание.

Чтобы заменить существующие веб-части на части приложений, вам нужно:

Разрешить загрузку неопубликованных приложений в вашей подписке на Office 365. Проконсультироваться с вашим администратором Office 365.
Разрешить загрузку неопубликованных надстроек на сайт с помощью CSOM. Дополнительные сведения см. в статье, посвященной примеру кода Core.SideLoading.
Установить часть приложения на своем сайте.
Отключить загрузку неопубликованных надстроек на сайт.
Отключить загрузку неопубликованных приложений в вашей подписке на Office 365. Проконсультироваться с вашим администратором Office 365.

Управление страницей

Вам может потребоваться реализация управления страницей во время процесса подготовки сайта. В примере кода Provisioning.Pages показаны методы управления страницей, включая создание вики-страницы, добавление HTML-содержимого на страницу, создание списка ссылок с повышением уровня, создание страниц с различными макетами, добавление на страницу встроенных веб-частей и удаление страницы.

Столбцы сайта, определения списка и типы контента

Если столбцы вашего сайта, определения списка и типы контента были созданы с помощью элементов платформы функций (Feature Framework), которые были развернуты с помощью решений для фермы, необходимо использовать метод трансформации, подразумевающий перенос или миграцию контента. Это не касается только элементов платформы функций (Feature Framework), развернутых с помощью изолированных решений. Чтобы использовать метод преобразования с использованием переноса контента, необходимо применять сторонние средства для удаления зависимостей решения для фермы.

Модули или платформа функций

Модули используют для файлов указатели, что означает, что файлы не настраиваются и разворачиваются в файловой системе. Если ваше решение для фермы использует модули, выполните настройку файлов путем развертывания альтернативных версий тех же файлов в базе данных контента, сканирования и обновления ваших решений, чтобы они указывали на новые файлы, хранящиеся в базе данных контента, а затем выполните отзыв решения для фермы, указывающего на файлы, хранящиеся в файловой системе.

Шаблоны сайтов и веб-шаблоны

Необходимо уделить особое внимание преобразованию элементов платформы функций, развернутых шаблоном сайта или веб-шаблоном. Например, убедитесь, что страница default.aspx не заменяется при отзыве решения для фермы.

Задания таймера

Если вы используете SharePoint Online, вы не можете создавать и настраивать задания таймера. Вместо этого вы можете создать консольное приложение, использующее планировщик задач Windows или Azure WebJob для планирования и запуска консольного приложения удаленно.

При создании настраиваемого задания таймера определите, потребуется ли вам конкретная учетная запись или маркер на основе OAuth только для приложения. Пример кода Core.TimerJobs.Samples показывает, как создавать собственные настраиваемые задания таймера.