Поделиться через


Обновление компонентов хост-сайта с надстройкой в SharePoint

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

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

При обновлении части надстройки SharePoint заменяет старую версию новой версией в коллекции веб-частей. Убедитесь в изменении свойства Name объекта ClientWebPart при обновлении веб-части надстройки. Это гарантирует, что после обновления надстройки SharePoint удалит старую версию веб-части надстройки (которая больше не является веб-частью надстройки) со всех страниц, на которые она была добавлена. Пользователи должны повторно добавить на страницы новую версию.

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

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

Дальнейшие действия

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

См. также