Развертывание и установка надстроек SharePoint: методы и параметры
В этой статье вы узнаете больше о возможностях публикации, установки и удаления надстроек SharePoint.
Публикация в Магазине Office или каталоге надстроек организации
Вы можете отправить надстройку SharePoint в общедоступный Магазин Office или в частный каталог надстроек организации. Частный каталог надстроек — это выделенное семейство веб-сайтов в веб-приложении SharePoint (или клиенте SharePoint Online), в котором размещаются библиотеки документов для надстроек SharePoint и надстроек Office. Размещение каталога в собственном семействе веб-сайтов упрощает администратору веб-приложения или администратору клиента ограничение разрешений для каталога.
Если надстройку разместить в общедоступном Магазин Office, Microsoft выполняет в нем ряд операций по проверке. Например, проверку действительности и полноты разметки манифеста надстройки, а также того, не содержат ли какие-либо из пакетов решений SharePoint (файлы WSP) запрещенных элементов или функций, область действия которых шире, чем Web. Содержимое пакета также проверяется на предмет нежелательных элементов. Если надстройка проходит все проверки, пакет надстройки заносится в файл и подписывается Microsoft.
Примечание.
Если вы разрабатываете надстройку и развертываете ее с помощью Инструментов разработчика Microsoft Office для Visual Studio, надстройка устанавливается непосредственно на целевой тестовый сайт SharePoint. А так как она не проходит через Магазин Office, описанная выше проверка не выполняется.
Надстройку SharePoint отправить в каталог надстроек организации можно так же просто, как любой файл — в библиотеку документов SharePoint Foundation. Заполните всплывающую форму, указав локальный URL-адрес пакета надстройки и другие сведения, например имя надстройки. Подобные проверки выполняются, когда надстройка добавляется в каталог надстроек организации. И надстройки, которые их не проходят, помечаются в каталоге как недопустимые или отключенные.
Администраторы клиентов и веб-приложений SharePoint могут приобрести надстройки SharePoint в Магазине Office. Чтобы открыть Магазин Office, нажмите кнопку Добавить надстройку на странице Содержимое сайта и выберите пункт Магазин SharePoint на странице Мои надстройки . Откроется страница Магазина SharePoint с подробными сведениями о надстройках SharePoint от поставщиков (эти сведения можно также найти на сайте office.com).
Надстройки, для которых требуются компоненты, не установленные в веб-приложении или клиенте администратора, отображаются в магазине надстроек тусклым шрифтом и недоступны. Например, если для надстройки требуются неустановленные службы поиска, она недоступна. Администраторы могут просматривать, сортировать и фильтровать список надстроек, читать о них сведения и отзывы, а также покупать для них лицензии.
Решив приобрести лицензию, администратор должен принять условия покупки и согласиться с разрешениями, которые должна иметь надстройка для нормальной работы, такими как доступ к чтению списков или полный доступ к коллекции веб-сайтов.
При покупке одной или более лицензий для надстройки они загружаются в веб-приложение или клиент. Автоматическая загрузка и установка надстройки при покупке лицензии не предусмотрены, хотя администраторы имеют возможность совместить установку с покупкой лицензии.
Пользователи устанавливают надстройки со страницы Ваши надстройки. На странице располагаются такие объединенные списки:
- Надстройки SharePoint из каталога надстроек в организации веб-приложения (или клиента).
- Надстройки SharePoint из Магазина Office, на который организация или клиент уже имеют лицензию веб-сайта, или лицензию, которая была присвоена пользователю.
В списке отображаются все надстройки, которые можно установить сразу. Надстройки можно отфильтровать, чтобы отобразить на странице только те, которые включены в каталог надстроек организации. После установки на веб-сайте надстройка появляется в списке надстроек на странице Содержимое сайта.
Установка надстроек SharePoint
Владельцы веб-сайтов устанавливают Надстройки SharePoint со страницы Ваши надстройки, как было описано ранее в этом разделе. При установке создается экземпляр надстройки. Подробнее об установке надстроек: Добавление надстроек для SharePoint на сайт SharePoint.
Примечание.
Иногда в результате временных сбоев в сетевом соединение установка может быть заблокирована. Если по какой-либо причине при установке происходит сбой, инфраструктура инсталляции повторяет попытку три раза. При неудаче в пользовательском интерфейсе появляется отметка об ошибке. Пользователи могут повторить попытку установки позднее.
Удаление надстроек SharePoint
Владельцы веб-сайтов могут удалить экземпляр надстройки SharePoint с помощью пользовательского интерфейса SharePoint. Удаление экземпляра надстроек SharePoint является чистым. Это означает, что все, что установлено надстройкой, будет удалено.
При этом компоненты, используемые надстройкой, но установленные отдельно от нее, не удаляются. Предположим, у надстройки есть удаленная веб-страница с кнопками, с помощью которых создаются списки на хост-сайте. При удалении надстройки удаляется ее плитка на странице Содержимое сайта, в результате чего удаленная страница становится недоступной для конечных пользователей. При этом созданные надстройкой списки остаются. Система SharePoint не фиксирует, какие списки на хост-сайте были созданы надстройкой, а какие — в пользовательском интерфейсе SharePoint, поэтому она не может удалять списки, созданные надстройкой. Обычно это желательное поведение, так как списки могут содержать данные, которые будут полезны пользователям даже после удаления надстройки, создавшей списки.
Если Надстройка SharePoint включает в себя веб-надстройку, то она удаляется. Благодаря этому достигается более полное удаление, чем при систематическом отключении функций и запуске WSP-файла надстройки в режиме отмены.
Примечание.
Когда пользователь удаляет надстройку, она перемещается в первую корзину. При удалении из первой корзины настройка перемещается во вторую. При удалении из второй корзины она удаляется полностью без возможности восстановления.
Кроме того, при удалении надстройки отзываются разрешения для нее согласно следующим правилам:
- разрешения уровня веб-сайта всегда аннулируются;
- если в семействе веб-сайтов отсутствуют другие экземпляры надстройки, разрешения уровня семейства веб-сайтов также аннулируются;
- Если в подписке сайта (клиенте) нет других экземпляров надстройки, разрешения на уровне клиента также отзываются.
Веб-служба UninstallingEventEndpoint, если она зарегистрирована в манифесте приложения, выполняется в начале процесса деинсталляции (это происходит, когда надстройка удаляется из второй корзины). Рекомендуется пользоваться веб-службой UninstallingEventEndpoint, если вы также пользуетесь веб-службой InstalledEventEndpoint, и настраивать службу UninstallingEventEndpoint так, чтобы она отменяла все действия, выполняемые службой InstalledEventEndpoint. Дополнительные сведения см. в статье Обработка событий в надстройках SharePoint.