--- title: "Каталог приложений клиента или каталог приложений семейства сайтов: куда развёртывать приложения Vitextra" description: "Справочник для администраторов SharePoint: чем отличаются каталог приложений клиента и каталог приложений семейства сайтов в SharePoint Online, как каждый из них влияет на развёртывание продуктов Vitextra на SPFx — доступность на сайтах, развёртывание на весь клиент, разрешения API, Microsoft Teams, обновления и лицензирование — и какой каталог выбрать." url: https://vitextra.com/ru/support/kb/10361 language: ru published: 2026-10-30 modified: 2026-10-29 author: "Roger Gagne" tags: ["каталог приложений клиента или семейства сайтов", "каталог приложений SharePoint Online", "каталог приложений семейства сайтов SPFx", "Add-SPOSiteCollectionAppCatalog", "Включить это приложение и добавить его на все сайты", "развёртывание SPFx на весь клиент", "куда загружать sppkg", "развернуть веб-часть на одно семейство сайтов", "библиотека Приложения для SharePoint", "развёртывание Vitextra"] --- # Каталог приложений клиента или каталог приложений семейства сайтов: куда развёртывать приложения Vitextra Справочник для администраторов SharePoint: чем отличаются каталог приложений клиента и каталог приложений семейства сайтов в SharePoint Online, как каждый из них влияет на развёртывание продуктов Vitextra на SPFx — доступность на сайтах, развёртывание на весь клиент, разрешения API, Microsoft Teams, обновления и лицензирование — и какой каталог выбрать. ## Обзор Каждый продукт Vitextra для SharePoint Online поставляется в виде пакета SharePoint Framework (`.sppkg`), который нужно загрузить в ::каталог приложений::. SharePoint Online предлагает два вида каталогов: **каталог приложений клиента (тенанта) Microsoft 365**, который обслуживает всю организацию, и **каталоги приложений семейства сайтов**, каждый из которых обслуживает одно семейство сайтов. От вашего выбора зависит, кто может развернуть пакет, где появятся веб-части, как обрабатываются разрешения API и Microsoft Teams и сколько мест придётся обновлять позднее. В этой статье два каталога сравниваются с точки зрения развёртывания Vitextra и даётся рекомендация. Сами шаги загрузки описаны в статье [KB10035. Как установить продукт Vitextra в SharePoint Online](https://vitextra.com/ru/support/kb/10035). ## Два каталога вкратце | | Каталог приложений клиента | Каталог приложений семейства сайтов | |---|---|---| | Количество на клиент | Один (по одному на географическое расположение в клиенте Multi-Geo) | Любое количество, по одному на семейство сайтов | | Кем создаётся | Администратором SharePoint в Центре администрирования SharePoint | Администратором SharePoint с помощью SharePoint Online Management Shell | | Кто может загружать пакеты | Владельцы сайта каталога приложений (обычно администраторы SharePoint) | Администраторы этого семейства сайтов | | Где можно использовать веб-части | На любом сайте клиента | Только в этом семействе сайтов | | **Включить это приложение и добавить его на все сайты** (развёртывание на весь клиент) | Веб-части появляются в наборе инструментов каждого сайта без добавления приложения | Действует только на сайты этого семейства сайтов | | Запросы разрешений API (Microsoft Graph, Azure DevOps) | Появляются на странице **Доступ к API** и утверждаются на весь клиент | Должны быть уже утверждены в клиенте | | **Добавить в Teams** | Доступно | Недоступно | | Обновления | Загрузить новый пакет один раз | Загружать новый пакет в каждый каталог приложений семейства сайтов отдельно | | Лицензия Vitextra | Одна лицензия на клиент | Та же лицензия: лицензирование не зависит от каталога | ## Каталог приложений клиента Каталог приложений клиента — это особое семейство сайтов, которое администратор SharePoint один раз создаёт из раздела **Дополнительные функции → Приложения** Центра администрирования SharePoint. На его странице **Управление приложениями** пакеты загружаются, включаются, обновляются, добавляются в Teams и удаляются. Когда вы загружаете пакет Vitextra, панель **Включить приложение** предлагает параметр **Включить это приложение и добавить его на все сайты**. Все продукты Vitextra поддерживают такое *развёртывание на весь клиент*: - **Выбран** — веб-части продукта сразу появляются в наборе инструментов веб-частей каждого сайта клиента. Владельцам сайтов не нужно добавлять приложение на свои сайты, и продукт не отображается в разделе **Содержимое сайта → Создать → Приложение**. - **Не выбран** — продукт доступен для добавления, и владелец каждого сайта, которому он нужен, один раз добавляет его из раздела **Содержимое сайта → Создать → Приложение** (или **Из вашей организации** в окне выбора приложений). Веб-части появляются в наборе инструментов только этого сайта. ![Панель «Включить приложение» с выбранным развёртыванием на весь клиент](https://static.vitextra.com/articles/10361/enable-app-ru.png) *Панель «Включить приложение» с выбранным развёртыванием на весь клиент* Решение не окончательное: позднее на странице **Управление приложениями** можно выбрать пакет и воспользоваться командой **Добавить на все сайты** или **Прекратить добавление на новые сайты**. Две возможности доступны только из каталога приложений клиента: - **Запросы разрешений API.** Продукты, которые читают Microsoft Graph, — Employee Directory, Employee Details, Organizational Chart, Absence & Coverage, My Tasks, Password Vault — объявляют нужные им разрешения, и при развёртывании пакета здесь SharePoint создаёт соответствующие запросы на странице **Доступ к API**. См. [KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint](https://vitextra.com/ru/support/kb/10360). - **Добавить в Teams.** Каталог приложений Teams общий для всего клиента, поэтому опубликовать веб-часть Vitextra как вкладку или личное приложение Microsoft Teams можно только из каталога приложений клиента. 💡 **Совет** Для продуктов Vitextra выбирайте **Включить это приложение и добавить его на все сайты**. Веб-части становятся доступны везде сразу, а каждый владелец сайта сам решает, размещать ли их на странице. Веб-части ничего не меняют на сайте, пока кто-нибудь не добавит их на страницу. ## Каталог приложений семейства сайтов Каталог приложений семейства сайтов — это библиотека **Приложения для SharePoint** внутри обычного семейства сайтов. Администратор SharePoint включает его для конкретного семейства сайтов с помощью SharePoint Online Management Shell: ```powershell Connect-SPOService -Url https://contoso-admin.sharepoint.com Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing ``` После этого **администраторы семейства сайтов** могут загружать пакеты в раздел **Содержимое сайта → Приложения для SharePoint**, не имея никакой роли в клиенте, а развёрнутые там решения можно использовать только внутри этого семейства сайтов. Каталог приложений клиента должен уже существовать: без него командлет завершается ошибкой. ![Библиотека «Приложения для SharePoint» каталога приложений семейства сайтов](https://static.vitextra.com/articles/10361/site-collection-app-catalog-ru.png) *Библиотека «Приложения для SharePoint» каталога приложений семейства сайтов* Что меняется для развёртывания Vitextra: - **Область действия.** Веб-части доступны только на сайтах этого семейства сайтов. Если выбрать здесь **Включить это приложение и добавить его на все сайты**, под «всеми сайтами» понимаются сайты того же семейства сайтов. - **Разрешения API.** Каталог приложений семейства сайтов не создаёт запросов на странице **Доступ к API**. Для продукта, которому нужны разрешения Microsoft Graph, сначала разверните пакет в каталоге приложений клиента, утвердите запросы и только потом используйте каталог приложений семейства сайтов; предоставления действуют на весь клиент и общие для обеих копий. Продукт без разрешений API (List Filter Online, Smart Tiles, Quick Poll, QR Code Generator и другие) работает из каталога приложений семейства сайтов без дополнительных шагов. - **Microsoft Teams.** Команда **Добавить в Teams** не предлагается; использовать продукт в Teams можно, только если он развёрнут из каталога приложений клиента. - **Обновления.** Каждый каталог приложений семейства сайтов обновляется отдельно: новая версия, загруженная в каталог приложений клиента, не попадает в пакеты, развёрнутые в каталогах семейств сайтов, и наоборот. - **Управление.** Список семейств сайтов с каталогом приложений хранится в каталоге приложений клиента по адресу `/Lists/SiteCollectionAppCatalogs`. `Remove-SPOSiteCollectionAppCatalog` отключает каталог приложений семейства сайтов: библиотека остаётся, но решения в ней перестают работать. ❗ **Важно** Решение, развёрнутое из каталога приложений семейства сайтов, всё равно выполняется в браузере пользователя с разрешениями этого пользователя и может вызывать любой API, утверждённый в клиенте. Меньшая область действия ограничивает то, *где можно разместить веб-части*, а не то, *к чему они имеют доступ*. Проверяйте сторонние пакеты для каталога приложений семейства сайтов так же тщательно, как и для каталога приложений клиента. ## Лицензирование и пробный период Лицензии Vitextra выдаются **на клиент Microsoft 365** независимо от каталога, количества сайтов и количества пользователей. Бесплатный 14-дневный пробный период начинается автоматически, когда продукт развёрнут и впервые открыт в клиенте, а лицензия назначается на идентификатор клиента (Tenant ID) — см. [KB10206. Лицензирование и учётная запись Vitextra: как приобрести и активировать лицензию](https://vitextra.com/ru/support/kb/10206). Для развёртывания одного и того же продукта из каталога приложений клиента и из одного или нескольких каталогов приложений семейств сайтов нужна одна лицензия. ## Какой каталог выбрать **Используйте каталог приложений клиента**, когда: - продукт предназначен для интрасети в целом или для нескольких семейств сайтов (Employee Directory, Organizational Chart, Smart Tiles на центральных сайтах и сайтах подразделений); - продукту нужны разрешения Microsoft Graph или он будет использоваться в Microsoft Teams; - вы хотите иметь единое место для обновлений и единую версию в клиенте. **Используйте каталог приложений семейства сайтов**, когда: - подразделение или проектная команда проводит пилот или нуждается в продукте, которого не получит остальная организация; - ваши правила управления требуют, чтобы ничто не развёртывалось на весь клиент без отдельной проверки, и вы хотите делегировать развёртывание администраторам семейства сайтов; - продукту не нужны разрешения API и он не будет использоваться в Teams. Большинство заказчиков Vitextra развёртывают продукты из каталога приложений клиента с параметром **Включить это приложение и добавить его на все сайты**, а каталоги приложений семейств сайтов используют, если вообще используют, для пилотов.