--- title: "Как установить List Filter Online и добавить её на страницу" description: "Пошагово: загрузите пакет Vitextra List Filter Online в каталог приложений SharePoint, добавьте веб-часть List Filter на современную страницу, выполните минимальную настройку (сайт, список или библиотека, столбцы), опубликуйте страницу и обновите веб-часть до новой версии." url: https://vitextra.com/ru/support/kb/10251 language: ru published: 2026-10-12 modified: 2026-10-12 products: - "List Filter Online" author: "Lidija Reising" tags: ["установка List Filter Online", "развёртывание пакета SharePoint Framework", "sppkg каталог приложений", "добавить веб-часть на страницу SharePoint", "веб-часть List Filter", "Настройка веб-части", "Источник данных Сайт Список Столбцы", "обновление веб-части SPFx", "настройка Vitextra List Filter Online"] --- # Как установить List Filter Online и добавить её на страницу Пошагово: загрузите пакет Vitextra List Filter Online в каталог приложений SharePoint, добавьте веб-часть List Filter на современную страницу, выполните минимальную настройку (сайт, список или библиотека, столбцы), опубликуйте страницу и обновите веб-часть до новой версии. ## Введение [List Filter Online](https://vitextra.com/ru/products/list-filter-online) поставляется одним пакетом ::SharePoint Framework::. Установка состоит из двух шагов, которые обычно выполняют два человека: администратор SharePoint загружает пакет в ::каталог приложений:: клиента, а владелец сайта добавляет веб-часть на страницу и указывает ей список или библиотеку. В этой статье описаны оба шага — от скачанного ZIP-файла до опубликованной страницы — и объясняется, как обновить веб-часть при выходе новой версии. ## Предварительные требования Прежде чем начать, убедитесь, что: - в клиенте есть каталог приложений. Если его нет, администратор SharePoint создаёт его в центре администрирования SharePoint в разделе **Дополнительные функции** > **Приложения**; - для загрузки пакета вы являетесь администратором SharePoint или участником группы владельцев каталога приложений; - для добавления и настройки веб-части вы являетесь владельцем сайта или имеете разрешение на изменение страницы; - у вас есть скачанный пакет. Это ZIP-файл с именем `Vitextra.ListFilterOnline.<год>Q<квартал>.zip`, например `Vitextra.ListFilterOnline.2026Q4.zip`, содержащий файл решения `vitextra.list-filter.sppkg`. Перед загрузкой извлеките файл `.sppkg`. 📝 **Заметка** List Filter Online читает данные через собственный ::REST API:: SharePoint и не запрашивает дополнительных разрешений API. На странице **Доступ к API** центра администрирования SharePoint ничего утверждать не нужно. ## Шаг 1. Загрузите пакет в каталог приложений 1. Откройте сайт каталога приложений клиента и перейдите в раздел **Приложения для SharePoint**. 2. Загрузите файл `vitextra.list-filter.sppkg` или перетащите его в список. 3. В открывшемся диалоговом окне выберите **Включить это приложение и добавить его на все сайты** и подтвердите кнопкой **Включить приложение**. Пакет собран для развёртывания на уровне всего клиента, поэтому после этого шага веб-часть доступна на каждом сайте клиента и её не нужно добавлять на сайт через **Добавить приложение**. Общая процедура со снимками экрана каталога приложений и диалогового окна развёртывания описана в статье [KB10035. Установка облачного продукта](https://vitextra.com/ru/support/kb/10035). 📝 **Заметка** Тот же пакет регистрирует команду **Открыть в List Filter** для панели команд списков и библиотек. Команда остаётся скрытой во всех списках, пока администратор не настроит её в расширениях уровня клиента и не укажет страницу, которую она должна открывать. Если вы её не настроите, в ваших списках ничего не изменится. Настройка описана в статье [KB10254. Открытие выбранных элементов в List Filter Online из стандартного списка SharePoint](https://vitextra.com/ru/support/kb/10254). ## Шаг 2. Добавьте веб-часть на страницу 1. Откройте современную страницу, на которой должен отображаться список, и нажмите **Изменить** в правом верхнем углу. Если нужна новая страница, создайте её на сайте через **Создать** > **Страница**. 2. Наведите указатель на место в разделе, где должна располагаться веб-часть, и нажмите кнопку **+** (плюс). 3. В наборе инструментов введите *List Filter* в поле поиска или прокрутите до группы **Документы, списки и библиотеки** и выберите **List Filter**. Веб-часть добавляется на страницу и сразу показывает контрольный список настройки, описанный в следующем шаге. ![Веб-часть List Filter в наборе инструментов страницы](https://static.vitextra.com/articles/10251/web-part-toolbox-ru.png) *Веб-часть List Filter в наборе инструментов страницы* ## Контрольный список настройки Пока источник данных не задан полностью, веб-часть показывает контрольный список с заголовком **Не настроено** и тремя строками, каждая из которых отмечена либо галочкой, либо надписью **Не настроено**: 1. **Сайт** — сайт, на котором находится список. По умолчанию уже выбран текущий сайт, поэтому эта строка обычно заполнена сразу. 2. **Список или библиотека** — список или ::библиотека документов:: для отображения. 3. **Столбцы** — столбцы, которые нужно показывать в таблице. Пока не выбран хотя бы один столбец, в строке выводится сообщение *Необходимо выбрать хотя бы один столбец для отображения в этом представлении.* В режиме редактирования контрольный список завершается кнопкой **Настройка веб-части**, которая открывает область свойств веб-части. Та же область открывается значком карандаша веб-части. ![Контрольный список настройки веб-части](https://static.vitextra.com/articles/10251/configuration-checklist-ru.png) *Контрольный список настройки веб-части* ## Минимальная настройка Все три обязательных параметра находятся в группе **Источник данных** — первой группе области свойств. 1. **Область.** Оставьте **Текущий сайт**, чтобы показать список сайта, которому принадлежит страница. Выберите **Другой сайт**, чтобы показать список с другого сайта клиента: ниже появится средство выбора **URL-адрес сайта**; введите название или URL-адрес сайта и выберите его из предложений. Выбранный сайт отображается с логотипом, названием и URL-адресом. 2. **Список.** Выберите список или библиотеку в раскрывающемся списке. В нём перечислены списки и библиотеки выбранного сайта. 3. **Столбцы.** Нажмите **Выбрать столбцы**. В панели **Столбцы** отметьте отображаемые столбцы в колонке **Отображать** таблицы и нажмите **Сохранить**. Здесь же можно изменить **Заголовок** и **Порядок** столбца; остальные параметры описаны в статье [KB10258. Настройка столбцов в List Filter Online: заголовки, форматы и параметры отображения](https://vitextra.com/ru/support/kb/10258). Как только третий параметр задан, контрольный список исчезает, и веб-часть показывает первые элементы списка. ![Группа «Источник данных» в области свойств](https://static.vitextra.com/articles/10251/data-source-group-ru.png) *Группа «Источник данных» в области свойств* ❗ **Важно** Смена сайта или списка сбрасывает зависимые настройки: выбранные столбцы, столбцы области фильтра и предопределённый фильтр очищаются, поскольку они относятся к предыдущему списку. Сначала выберите источник данных, а затем настраивайте остальное. ## Опубликуйте и проверьте Нажмите **Повторно опубликовать** (или **Опубликовать** для новой страницы). Откройте страницу так, как её увидит пользователь, и проверьте, что: - таблица показывает ожидаемые столбцы и элементы; - пользователи видят только те элементы, к которым у них есть доступ, — веб-часть читает список от имени текущего пользователя, поэтому разрешения списка действуют без изменений; - область фильтра и панель инструментов отображаются, если они вам нужны. Обе включены по умолчанию и отключаются в группах **Область фильтра** и **Панель инструментов**. 💡 **Совет** Веб-часть может быть и единственным содержимым страницы: создайте страницу по шаблону **Приложения** (страница приложения с одной веб-частью) и выберите **List Filter**. Такая страница удобна в качестве вкладки канала Microsoft Teams. ## Обновление до новой версии Новый выпуск List Filter Online устанавливается так же, как и первый: загрузите новый файл `vitextra.list-filter.sppkg` в раздел **Приложения для SharePoint**, подтвердите замену существующего файла и снова выберите **Включить это приложение и добавить его на все сайты**. Поскольку пакет развёрнут на уровне всего клиента, каждая страница с веб-частью получает новую версию при следующей загрузке; ничего перенастраивать не нужно, а настройки существующих веб-частей сохраняются. Когда доступна более новая версия, чем работающая на странице, веб-часть показывает редактору страницы сообщение *Доступна новая версия этого приложения. Получите ее сейчас.* ## Итоги Установить List Filter Online — значит загрузить один файл `.sppkg` в каталог приложений с развёртыванием на уровне клиента, а затем добавить веб-часть **List Filter** на страницу и задать три обязательных параметра — **Сайт**, **Список или библиотека** и **Столбцы**. После этого веб-часть работает для каждого пользователя страницы с его собственными разрешениями. 💡 **Совет** Все настройки области свойств — папки, максимальное число элементов, сортировка, группировка, итоги, предопределённый фильтр и область фильтра — описаны в статье [KB10201. Настройка веб-части List Filter Online](https://vitextra.com/ru/support/kb/10201). Для тех, кто будет пользоваться страницей, см. статью [KB10252. List Filter Online: краткое руководство для пользователей](https://vitextra.com/ru/support/kb/10252).