QR Code Generator Введение
QR Code Generator поставляется одним пакетом SharePoint Framework. Администратор SharePoint один раз загружает пакет в каталог приложений клиента, и после этого любой автор страниц может добавить веб-часть на страницу. В этой статье описан весь путь: от скачанного ZIP-файла до первого QR-кода, сохранённого на вашем компьютере.
Предварительные требования
Прежде чем начать, убедитесь, что:
- в клиенте есть каталог приложений. Если его нет, администратор SharePoint создаёт его в центре администрирования SharePoint в разделе Дополнительные функции > Приложения;
- для загрузки пакета вы являетесь администратором SharePoint или участником группы владельцев каталога приложений;
- для добавления веб-части вы являетесь владельцем сайта или имеете разрешение на изменение страницы;
- у вас есть скачанный пакет. Это ZIP-файл с именем
Vitextra.QRCodeGenerator.<год>Q<квартал>.zip, напримерVitextra.QRCodeGenerator.2026Q4.zip, содержащий файл решенияvitextra.qr-code-generator.sppkg. Перед загрузкой извлеките файл.sppkg.
📝 Заметка
QR Code Generator строит код в браузере и не запрашивает дополнительных разрешений API. На странице Доступ к API центра администрирования SharePoint ничего утверждать не нужно.
Шаг 1. Загрузите пакет в каталог приложений
- Откройте сайт каталога приложений клиента и перейдите в раздел Приложения для SharePoint.
- Загрузите файл
vitextra.qr-code-generator.sppkgили перетащите его в список. - В открывшемся диалоговом окне выберите Включить это приложение и добавить его на все сайты и подтвердите кнопкой Включить приложение. Пакет собран для развёртывания на уровне всего клиента, поэтому после этого шага веб-часть доступна на каждом сайте клиента и её не нужно добавлять на сайт через Добавить приложение.
Общая процедура со снимками экрана каталога приложений и диалогового окна развёртывания описана в статье KB10035. Установка облачного продукта.
Шаг 2. Добавьте веб-часть на страницу
- Откройте современную страницу, на которой должен отображаться генератор, и нажмите Изменить в правом верхнем углу. Если нужна новая страница, создайте её на сайте через Создать > Страница.
- Наведите указатель на место в разделе, где должна располагаться веб-часть, и нажмите кнопку + (плюс).
- В наборе инструментов введите QR в поле поиска и выберите QR Code Generator. Веб-часть находится в группе Дополнительно.
Веб-часть не требует настройки: она появляется на странице готовой к работе, с выбранной вкладкой URL-адрес и уже введённым адресом текущего сайта, поэтому первый QR-код отображается сразу.
💡 Совет
Пока страница находится в режиме редактирования, над генератором можно ввести заголовок в поле с подсказкой Название веб-части, например Сканируйте, чтобы открыть страницу мероприятия.
Шаг 3. Создайте первый QR-код
- Оставайтесь на вкладке URL-адрес и замените адрес в поле URL-адрес ссылкой, которую должен открывать код, — например, ссылкой на новостную запись или документ.
- Посмотрите на изображение в области QR-код справа: оно перестраивается после каждого изменения. Кнопка Обновить перерисовывает его по требованию.
- Наведите камеру смартфона на изображение и проверьте, что ссылка открывается.
Чтобы закодировать не ссылку, а что-то другое, выберите другую вкладку — Text, vCard, Wi-Fi, Электронная почта, SMS, Телефон, Location или Event. Если вкладки не помещаются по ширине веб-части, остальные скрыты за кнопкой … (ещё) в конце строки. Поля каждой вкладки описаны в статье KB10264. Типы данных QR-кода: URL-адрес, текст, vCard, Wi-Fi, электронная почта, SMS, телефон, местоположение и событие.
📝 Заметка
Если обязательное поле выбранной вкладки пусто, вместо кода выводится сообщение Одно или несколько обязательных полей являются пустыми. Проверьте, чтобы все обязательные поля были заполнены и повторите попытку, а кнопки Обновить, Копировать и Скачать недоступны.
Шаг 4. Скачайте или скопируйте код
- Нажмите Скачать и выберите формат — PNG, JPEG, SVG или WebP. Файл сохраняется в папку загрузок браузера под именем
qrcode. - Нажмите Копировать, чтобы поместить код в буфер обмена как изображение PNG, и вставьте его в письмо, документ или презентацию. Действие подтверждается сообщением Copied to clipboard.
Выбор формата и размера изображения объясняется в статье KB10267. Скачивание и копирование QR-кода: PNG, JPEG, SVG и WebP.
Опубликуйте страницу
Нажмите Повторно опубликовать (или Опубликовать для новой страницы). Генератор сохраняется с теми данными и оформлением, которые были в нём в этот момент, поэтому посетители страницы видят тот же QR-код, который вы подготовили. Они также могут ввести собственные данные и скачать собственные коды; их изменения не сохраняются. См. статью KB10268. Публикация готового QR-кода на странице SharePoint.
Обновление до новой версии
Новый выпуск QR Code Generator устанавливается так же, как и первый: загрузите новый файл vitextra.qr-code-generator.sppkg в раздел Приложения для SharePoint, подтвердите замену существующего файла и снова выберите Включить это приложение и добавить его на все сайты. Каждая страница с веб-частью получает новую версию при следующей загрузке, а сохранённая конфигурация существующих веб-частей остаётся без изменений. Когда доступна более новая версия, чем работающая на странице, веб-часть показывает редактору страницы сообщение Доступна новая версия этого приложения. Получите ее сейчас. Общая процедура описана в статье KB10050. Обновление решения Vitextra на базе SPFx.
Итоги
Установить QR Code Generator — значит загрузить один файл .sppkg в каталог приложений с развёртыванием на уровне клиента и добавить веб-часть QR Code Generator на страницу. Веб-часть работает без настройки: введите данные на одной из вкладок, проверьте код смартфоном и заберите результат кнопкой Скачать или Копировать.
💡 Совет
О том, как придать коду цвета и логотип вашей компании, см. статьи KB10265. Настройка оформления QR-кода: форма, цвета, градиент и углы и KB10266. Как добавить логотип компании в QR-код.