Обзор

Продукт SharePoint Framework (SPFx) устанавливается слоями: пакет в каталоге приложений, приложение на сайтах, которые его используют, веб-части на страницах, при необходимости приложение Teams и утверждённые для него разрешения API. Удаление означает обратный проход по этим слоям. SharePoint не делает этого за вас: удалить пакет из каталога приложений можно одним кликом, но после этого на страницах остаются неработающие веб-части, в Teams - приложение, больше не связанное с пакетом, а в тенанте - утверждённые разрешения.

В этой статье описано полное удаление продукта Vitextra из тенанта Microsoft 365 в порядке, который позволяет избежать ошибок на страницах, а также что делать с данными, созданными продуктом, и с лицензией. Шаги одинаковы для всех продуктов Vitextra для SharePoint Online; продукты для SharePoint Server удаляются иначе, см. KB10022. Как удалить продукт Vitextra из SharePoint Server.

📝 Заметка
Чтобы перестать платить за продукт, удалять его не нужно: отмените подписку в учётной записи Vitextra, и веб-части перестанут работать по окончании оплаченного периода. Удаляйте продукт, когда хотите убрать его из тенанта.

Перед началом

  • Выясните, где используется продукт. В SharePoint нет отчёта о страницах, на которых используется веб-часть; спросите владельцев сайтов или поищите имя продукта по страницам сайтов интрасети. Веб-части, развёрнутые на весь тенант, могут находиться на любой странице любого сайта.
  • Решите, что будет с данными. Некоторые продукты хранят данные в списках SharePoint или в OneDrive (см. раздел Данные, созданные продуктом ниже). Экспортируйте всё нужное до удаления.
  • Необходимые роли. Владельцы сайтов могут удалять веб-части и приложения со своих сайтов. Администратор SharePoint управляет каталогом приложений, а Администратор Teams — приложением Teams. Для управления доступом к API используйте учётную запись с соответствующими полномочиями; см. KB10360.

Шаг 1. Удалите веб-части со страниц

Начните со страниц. Если сначала удалить пакет, каждая страница, на которой ещё есть веб-часть, покажет вместо содержимого заглушку с ошибкой, и редакторы страниц увидят ту же заглушку в режиме редактирования.

  1. Откройте страницу и кликните Изменить.
  2. Выберите веб-часть Vitextra и кликните значок Удалить веб-часть (корзина) на её панели инструментов.
  3. Повторно опубликуйте страницу.

Удаление веб-части со страницы

Удаление веб-части со страницы

Повторите для каждой страницы. Параметры веб-части хранятся в странице, поэтому удаление веб-части удаляет и её конфигурацию.

Шаг 2. Удалите приложение с сайтов

Этот шаг относится только к продуктам, которые добавлялись на сайты по отдельности (из раздела Содержимое сайта → Создать → Приложение). Продукты, развёрнутые с параметром Включить это приложение и добавить его на все сайты, не отображаются в содержимом сайта и пропускают этот шаг.

  1. На сайте откройте Параметры → Содержимое сайта.
  2. Найдите приложение Vitextra, откройте его меню (…) и кликните Удалить.
  3. Подтвердите.

Удаление приложения с сайта

Удаление приложения с сайта

Удалённое приложение попадает в корзину сайта, откуда его можно восстановить.

Шаг 3. Удалите приложение из Microsoft Teams

Если продукт был опубликован в Teams командой Добавить в Teams, он существует в каталоге приложений Teams вашей организации как пользовательское приложение, независимо от SharePoint.

  1. Откройте Центр администрирования Microsoft Teams и перейдите в раздел Приложения Teams → Управление приложениями.
  2. Найдите продукт Vitextra по имени и откройте его.
  3. Кликните Удалить и подтвердите.

Удаление приложения в центре администрирования Teams

Удаление приложения в центре администрирования Teams

Вкладки и личные приложения, которые пользователи создали из этого приложения, перестают работать и исчезают из Teams. Если приложение было закреплено политикой настройки приложений, удалите его и из политики (Приложения Teams → Политики настройки).

📝 Заметка
Конфигурация личного приложения Teams, которую администратор сохранил из группы Личное приложение (Microsoft Teams) панели свойств (Employee Directory, Organizational Chart, RSS Reader), хранится службой лицензирования Vitextra для вашего тенанта. После удаления приложения она не используется и перезаписывается при следующей настройке продукта.

Шаг 4. Удалите пакет из каталога приложений

  1. В Центре администрирования SharePoint откройте Дополнительные функции → Приложения → Открыть, чтобы перейти на страницу Управление приложениями.
  2. Выберите пакет Vitextra и кликните Удалить. Подтвердите.

Удаление пакета из каталога приложений

Удаление пакета из каталога приложений

3. Пакет перемещается в корзину сайта каталога приложений. Чтобы удалить его окончательно, откройте сайт каталога приложений (его адрес показан на странице Управление приложениями), перейдите в раздел Содержимое сайта → Корзина, удалите пакет там, а затем ещё раз из Корзины второго уровня. До этого момента пакет можно восстановить.

❗ Важно
Как только пакет удалён, все оставшиеся экземпляры его веб-частей перестают работать - на страницах, пропущенных на шаге 1, и на сайтах, где приложение не было удалено. Чтобы они снова заработали, пакет придётся восстановить из корзины. Если продукт использовался широко, подумайте о том, чтобы сначала отключить его: выберите пакет, откройте Свойства, снимите флажок Включено и дождитесь отзывов владельцев сайтов, прежде чем удалять.

Если продукт был развёрнут также из каталогов приложений семейств сайтов, удалите его таким же образом из библиотеки Приложения для SharePoint каждого из этих семейств сайтов.

Шаг 5. Отзовите разрешения API

Удаление пакета не отзывает разрешения Microsoft Graph или Azure DevOps, которые были для него утверждены. Разрешения действуют на весь тенант и являются общими для всех решений SPFx, поэтому отзывайте их, только если они не нужны другому решению.

  1. В Центре администрирования SharePoint разверните раздел Дополнительно и откройте Доступ к API.
  2. На вкладке Утвержденные запросы выберите разрешение и кликните Удалить доступ. Повторите для каждого разрешения, которое использовал только удалённый продукт.

Разрешения каждого продукта и общий характер разрешений описаны в статье KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint. Продукты без разрешений API (List Filter Online, Smart Tiles, Quick Poll, QR Code Generator, Announcements Carousel, Questions & Answers, RSS Reader, Smart Search) пропускают этот шаг.

Данные, созданные продуктом

Удаление веб-части или пакета никогда не удаляет данные, с которыми они работали. Решите для каждого продукта, что оставить:

ПродуктГде находятся данныеЧто делать
Absence & CoverageШесть списков SharePoint на выбранном сайте: AbsenceTypes, Absences, Substitutions, Balances, Holidays, SettingsПри необходимости экспортировать в Excel или CSV, затем удалить списки
Quick PollСписки Vitextra Quick Poll Questions и Vitextra Quick Poll Responses на сайтеОставить как обычные списки или удалить
Questions & Answers, Announcements CarouselПользовательский список или список объявлений, который был выбран или создан для веб-частиОставить как обычные списки или удалить
Password VaultЗашифрованный файл vitextra-password-vault.json в папке приложения в OneDrive каждого пользователя (папка Apps)Пользователи экспортируют свои записи до удаления и могут удалить файл самостоятельно
Employee DetailsПоля профиля, изменённые пользователями, хранятся в их профиле Microsoft Entra ID, а не в веб-частиОчищать нечего; данные остаются частью профилей пользователей
Employee Directory, Organizational Chart, My Tasks, Smart Search, RSS ReaderЧитают данные из Microsoft 365 или внешних каналов; в SharePoint ничего не создаётся, кроме параметров веб-частей на страницахОчищать нечего
Smart Tiles, QR Code Generator, List Filter OnlineПараметры в свойствах веб-части на страницеУдаляются вместе с веб-частью на шаге 1

Данные, которые некоторые продукты хранят в браузере, - кэш каталога Employee Directory и Organizational Chart, личные параметры представления My Tasks, сохранённые фильтры List Filter Online и сохранённые поисковые запросы Smart Search - остаются на устройствах пользователей, пока не будут очищены данные браузера для этого сайта. Полный перечень см. в статье KB10363. Где продукты Vitextra хранят ваши данные: конфиденциальность, расположение данных и GDPR.

Шаг 6. Освободите лицензию

Удаление продукта не меняет вашу подписку. Войдите на vitextra.com, откройте Account → My Subscriptions (Учётная запись → Мои подписки), выберите подписку и либо удалите назначение лицензии тенанту кнопкой Remove (если планируете использовать лицензию в другом тенанте), либо выберите Cancel Subscription. Шаги описаны в статье KB10037. Как управлять подпиской на продукты Vitextra. Если продукт использовался только в пробном режиме, делать ничего не нужно.

📝 Заметка
Если позднее вы установите продукт снова, пробный период не начнётся заново: он привязан к тенанту и продукту. Продукту, пробный период которого уже закончился, лицензия понадобится сразу после переустановки.

Контрольный список

  1. Веб-части удалены со всех страниц, страницы повторно опубликованы.
  2. Приложение удалено с каждого сайта, куда оно добавлялось по отдельности.
  3. Пользовательское приложение удалено в Центре администрирования Teams и исключено из политик настройки.
  4. Пакет удалён из каталога приложений тенанта (и из каталогов приложений семейств сайтов) и из обеих корзин.
  5. Разрешения API, которые использовал только этот продукт, удалены на странице Доступ к API.
  6. Данные экспортированы или осознанно удалены.
  7. Назначение лицензии удалено или подписка отменена.

Вопросы и ответы

Задайте вопрос по статье и получите официальный ответ нашей команды.

Вопросов пока нет. Задайте первый вопрос.

Рекомендуемые статьи

Настройка оформления QR-кода: форма, цвета, градиент и углы

Справочник по разделам оформления веб-части Vitextra QR Code Generator: шесть форм точек, цвет точек и фона с прозрачностью, линейный и радиальный градиент, форма и цвет угловых квадратов и угловых точек, уровни коррекции ошибок и практические правила, при которых оформленный QR-код остаётся читаемым.

101 5 мин
Устранение неполадок Questions and Answers: «Не настроено», отсутствующие столбцы, скрытые вопросы и разрешения

Руководство по устранению неполадок веб-части Vitextra Questions and Answers: экран «Не настроено», список, который не предлагается в варианте «Существующий список» (отсутствуют обязательные столбцы), вопросы, которых не видят читатели («Опубликовано» = «Нет»), отсутствующая кнопка «Задать вопрос», поиск, который ничего не находит, комментарии, которые не добавляются, видео, которое не воспроизводится, Markdown, который не отображается, фильтр по категориям, который не появляется, бесконечная загрузка и сообщение о лицензии - с проверкой и решением для каждого случая.

56 8 мин
Как создать QR-код события календаря

Пошагово: создайте QR-код, который добавляет событие в календарь смартфона, с помощью веб-части Vitextra QR Code Generator - введите название, место, начало и окончание, учтите часовой пояс, проверьте код и разместите его на плакате, в приглашении или на странице SharePoint.

100 3 мин

Поделиться