Универсальные списки — это инструмент для создания и управления структурированной информацией. Они позволяют создавать настраиваемые таблицы c различными типами полей: текст, число, дата, файл и другие.
Универсальные списки интегрируются с модулями Битрикс24, что дает возможность автоматизировать обработку данных и управлять доступом. Представьте, что есть список заявок на отпуск сотрудников. Для списка настроен бизнес-процесс и заданы права так, что только руководитель и сотрудники HR-отдела могут изменять заявки. В результате, когда сотрудник подает заявку на отпуск, HR-менеджер автоматически получает уведомление, чтобы рассмотреть и одобрить или отклонить заявку.
Каждый список представляет собой информационный блок. Используйте группу методов lists.* для работы со списками.
Быстрый переход: все методы
Пользовательская документация: списки в Битрикс24
Разделы. Используются для группировки информации и построения удобной иерархии. Управление разделами выполняется через методы lists.section.*.
Элементы. Хранят основную информацию. Управляются группой методов lists.element.*.
Бизнес-процессы в универсальных списках создают индивидуальный сценарий обработки элементов. Управление бизнес-процессами выполняется с помощью групп методов bizproc.workflow.* и bizproc.task.*.
{% note tip "Пользовательская документация" %}
{% endnote %}
Поля элементов уникальны для каждого списка. Создавать, изменять и удалять поля можно с помощью группы методов lists.field.*.
Параметр TYPE определяет тип данных поля. Перечень доступных типов приведен в описании параметра FIELDS метода lists.field.add.
Информация в универсальных списках может быть связана с CRM и Диском через поля следующих типов:
- Привязка к элементам CRM (
S:ECrm) - Файл (Диск) (
S:DiskFile)
Об особенностях этих типов читайте в статье Поля универсального списка: обзор методов.
Универсальные списки интегрированы в рабочие группы и проекты. Создавать свои списки можно внутри любой группы или проекта с различными уровнями доступа для участников.
Идентификатор типа инфоблоков IBLOCK_TYPE_ID для списков групп принимает значение lists_socnet.
Scope:
listsКто может выполнять метод: любой пользователь
#| || Метод | Описание || || lists.add | Создает список || || lists.delete | Удаляет список || || lists.get | Возвращает данные по спискам || || lists.update | Обновляет существующий список || || lists.get.iblock.type.id | Возвращает идентификатор типа инфоблока || |#
#| || Метод | Описание || || lists.element.add | Создает элемент списка || || lists.element.delete | Удаляет элемент списка || || lists.element.get | Возвращает список элементов или элемент || || lists.element.update | Обновляет элемент списка || || lists.element.get.file.url | Возвращает путь к файлу || |#
#| || Метод | Описание || || lists.field.add | Создает поле списка || || lists.field.delete | Удаляет поле списка || || lists.field.get | Возвращает данные поля || || lists.field.type.get | Возвращает доступные типы полей для указанного списка || || lists.field.update | Обновляет поле списка || |#
#| || Метод | Описание || || lists.section.add | Создает раздел списка || || lists.section.get | Возвращает даные о разделах || || lists.section.update | Обновляет раздел списка || || lists.section.delete | Удаляет раздел списка || |#
[*iblock]: Информационный блок — это специальный объект для хранения новостей, услуг, статей, каталогов товаров и других данных, имеющих четкую структуру.