Бипуим: Документация
8-800-505-24-05Сайт Бипиум
  • 😎Отвечаем на ваши вопросы
  • 🎂Версии и обновления
  • ❗Обновление до версии 2.0
  • Документация
    • 🆕С чего начать
      • Регистрация и вход
      • Создаем каталоги и записи
      • Формируем отчёты
      • Настраиваем правовую политику
      • Применяем автоматизации
    • ⚙️Конструктор данных
      • Отделы
      • Каталоги
        • Редактирование структуры
        • Настройка отображения
        • Поиск и фильтрация
        • Импорт записей
          • 📗Импорт из Excel
        • Экспорт записей
        • Активность
      • Системные каталоги
        • Сотрудники
        • События
        • Внешние запросы
        • Сценарии
        • Процессы
        • Доступ к сервисам
        • Вебхуки
      • Виды
      • Записи
    • 📊Отчеты
      • Графики
    • 🔑Права
      • Правила
      • Привилегии
      • Правовые группы
      • Правовые виды
      • Права на поля
      • Комбинация прав
    • 🤖Автоматизации
      • События
        • Изменение данных
        • Внешние запросы
      • Сценарии
        • Компоненты
          • Начало процесса
          • Конец процесса
          • Таймер
          • Ошибка
          • Шлюз «ИЛИ» (условное ветвление)
          • Шлюз «И» (распараллеливание)
          • Получить запись
          • Найти записи
          • Изменить запись
          • Создать запись
          • Удалить запись
          • Структура каталога
          • Загрузить файл
          • Сгенерировать документ
          • Назначение переменных
          • Код (Javascript)
          • Веб-запрос
          • SQL-запрос
          • Конвертер
          • Парсер
          • Запуск процесса
          • Получение почты
          • Отправка почты
          • Соединяющая линия
          • Отправить сообщение
        • Переменные
        • Выражения
        • Входные и выходные параметры компонентов
        • Примеры настройки
          • Условие
          • Цикл
      • Ограничения
  • Лицензии
    • 🌐Тип лицензирования
  • Примеры
    • 🔑Права доступа к данным
    • 🤖Автоматизации
      • Выгрузка файлов на Яндекс Диск
      • Отправка на больничный
      • Автоматизация оплаты счетов
      • Создание наименований записей
      • Расчет скидок для клиентов
      • Запрет на создание дубликатов в каталоге
      • Автозаполнение данных по ИНН
      • Переброс данных между связанными каталогами
      • Очередь сценариев
      • Отслеживание заявок с сайта помощью UTM-меток
      • Просрочка задач по дедлайну
      • Реализация механизма согласования записей
      • Массовое изменение записей
      • Создание каталога для рассылки почты
      • Перенос данных между системами Бипиума
      • Импорт данных из Excel
      • Генерация счет-фактуры
      • Генерация excel-отчетов
      • Планировщик задач
      • Импорт банковских выписок
      • Производственный календарь
      • Складской учет
  • Интеграции
    • 🥂Методы интеграции
      • Интеграция данных
        • API
        • Вебхуки (webhooks)
      • Интеграция интерфейса
        • Веб-формы
        • Веб-расширения
      • Примеры интеграций
        • Тильда
          • Прием данных с формы Tilda
          • Интеграция веб-интерфейса в Tilda
        • Интеграция с сервисом «DaData»
        • Интеграция c «Единой информационной системой в сфере закупок»
        • Мессенджеры
          • Интеграция с Telegram-ботом
        • Почтовые сервисы
          • UniSender
          • MailChimp
        • Сервисы Google
          • Google Calendar
        • Телефония
          • Oktell
            • Панель телефонии Oktell
            • Компонент Bpium в Oktell
        • 1C
    • 🔌API
      • Данные
        • Каталоги (Catalogs)
        • Записи (Records)
        • Связи (Relations)
        • Истории (Histories)
        • Файлы (Files)
        • Отделы (Sections)
        • Виды (Views)
        • Сообщения (Messages)
      • Агрегация
        • Разложения (Values)
        • Сводка (Totals)
      • Отчеты
        • Дашборды (Boards)
        • Графики (Widgets)
      • Поисковые выборки
        • Доступные связи (AvailableRecords)
        • Доступные условия фильтра (AvailableFilterRecords)
        • Сотрудники (Users)
        • Контакты (Contacts)
      • Права (Rights)
      • Профиль (Profile/me)
  • Установка на сервер
    • 🧱Архитектура
      • Варианты разворачивания
    • 🖥️Требования
    • 📂Установка как служба
    • 🛳️Установка через Docker
    • 🎛️Мультидоменная среда
    • 🆘Материалы
      • TLS/SSL Сертификат
      • Параметры config.env
        • Для Bpium
        • Для Bpium S3
        • Для Bpium BPM
      • Запуск
      • Обсуживание
        • Активация
        • Обновление
        • Бэкап и восстановление базы
        • Брендирование (Whitelabel)
        • Удаление
      • Перенос базы из облака
      • Возможные проблемы в ходе установки и работы
  • Обучение
    • Базовый курс
      • Урок 1. Отделы
      • Урок 2. Каталоги с данными
      • Урок 3. Карточки записей
      • Урок 4. Связи между данными
      • Урок 5. Фильтры и виды
      • Урок 6. Приглашение сотрудников
      • Урок 7. Права доступа к данным
      • Урок 8. Графические отчеты
      • Урок 9. Бизнес-процессы
      • Урок 10. Интеграции
    • Технический курс
      • Урок 1. Принцип работы автоматизаций
      • Урок 2. Первая автоматизация изнутри
      • Урок 3. Валидация данных
      • Урок 4. Простые вычисления
      • Урок 5. Расчет суммы заказа
      • Урок 6. Генерация счетов/документов
      • Урок 7. Рассылка почтовых сообщений
      • Урок 8. Прием внешних данных
      • Урок 9. Отправка данных на сторонние сервисы
    • Паттерны проектирования ИС
      • Унификация
      • Упорядоченность
      • Разделение
      • Актуализация
      • Вынос параметров
      • Выделение позиций
      • Слияние
      • Дублирование
      • Типизация
      • Информирование
Powered by GitBook
On this page
  • Получить разложение
  • Получить одно значение разложения
  1. Интеграции
  2. API
  3. Агрегация

Разложения (Values)

Ресурс Values — распределения и подсчет записей в каталоге по выбранным критериям.

PreviousАгрегацияNextСводка (Totals)

Last updated 4 years ago

Ресурс Values доступен начиная с версии Бипиума 1.7.1. В предыдущих версиях Бипиума значения разложения можно получить через ресурс .

Получить разложение

URL: /{api url}/catalogs/{catalogId}/values
            ?value[type]=recordsCount
            &axis[type]=field
            &axis[value]=2
            &recordsFilter[filters][0][fieldId]=12
            &recordsFilter[filters][0][value][0]=CURRENT_USER
            &limit=100
            &offset=0

Метод: GET

Параметры:

  • catalogId (string) — идентификатор каталога

Параметры фильтра (определяют выборку):

  • value[type] (string) — тип подсчитываемого значения

    • recordsCount — количество найденных записей (по умолчанию)

    • field — значение по полю каталога

  • value[value] (string) — идентификатор поля каталога для расчета. Допустимо указывать поля типов: число, прогресс, звезды, статус, набор галочек, выбор, связанный объект.

  • value[subType] (string) — подтип подсчитываемого значения

    • uniqueCount — подсчет уникальных значений (доступно для полей типа связанная запись, сотрудник, текст)

    • timeLeft — время нахождения записей в определенном значении поля (доступно для полей статус, набор галочек, выбор). Например: сколько записи были в определенных статусах.

    • timeLeft — время до момента перехода в в определенное значении поля (доступно для полей статус, набор галочек, выбор). Например: сколько прошло времени до того как записи перешли в определенный статус.

  • valueFn — применяемая функция для подсчета значений

    • '' (пусто) — не применять никакую функцию (для value[type]=recordsCount)

    • count — количество записей (значений)

    • sum — сумма значений

    • max — максимальное значение в группе

    • min — минимальное значение в группе

    • avg — среднее значение в группе (пустые значения не учитываются)

    • avgAll — среднее значение в группе (пустые значения считаются за 0)

  • axis[type] (string) — тип оси для разложения записей:

    • all — без разложения (значение по умолчанию)

    • field — разложение по полю каталога

    • createdTime — разложение по времени создания записи

  • axis[value] (string) — идентификатор поля оси разложения (для axis[type]=field)

  • axis[subType] (string) — тип группировки данных по оси (для полей типа дата)

    • hour — по часам

    • hourOfDay — по часам дня (все дни «схлопываются»)

    • day — по дням

    • dayOfWeek — по дням недели (пн—вс)

    • week — по неделям

    • weekOfYear — по неделям года (все года «схлопываются»)

    • monthOfYear — по месяцам года (все года «схлопываются»)

    • month — по месяцам

    • year — по годам

  • split[type] (string) — тип разделения (ось 2) значений внутри разложения по оси

    • возможные значения аналогичны параметру axis[type]

  • split[value] (string) — идентификатор поля оси 2 (для split[type]=field)

  • split[subType] (string) — тип группировки данных по оси 2 (для полей типа дата)

    • возможные значения аналогичны параметру axis[subType]

  • splitLimit (число) — если по оси2 вариантов разложения много, то берутся не все, а только часть их них, те которые встречаются чаще (по умолчанию 10, максимум 100)

  • sort (string) — тип сортировки полученной выборки. Для разных типов полей значение по умолчанию разное.

    • axis — сортировать по наименованию (порядку) заголовков осей.

      • Для дат — в порядке их следования

      • Для статусов, наборов галочек, выбора — в порядке указания элементов в поле каталога

      • Для текста, связанных записей, сотрудников — по наименованию

    • value — сортировать по величине значений

  • sortType (string) — направление сортировки полученной выборки

    • asc — по алфавиту / в порядке хронологии / в порядке указания в каталоге

    • desc — в обратном порядке

  • recordsType (string) — какие записи учитывать для подсчета значений

    • all — все записи каталога без проверки прав (доступно, если у сотрудника, делающего запрос есть права на просмотр всех записей каталога)

    • available — учитывать только доступные сотруднику записи каталога

  • recordsFilter (object) — фильтры для выборки записей каталога, такие как filter, sort и другие. подробнее в описании параметров .

  • limit (number) — количество возвращаемых разложений (по умолчанию 30, максимум 1000)

  • offset (number) — смещение получаемой выборки разложения относительно начала, используется для постраничного получения данных с параметром limit

Ответ: 200 OK (application/json)

Пример с наличием разложения по оси (axis):

[
{
    "axis": "Анатолий",
    "values": [
        {
            "value": "7"
        }
    ]
},
{
    "axis": "Виктор",
    "values": [
        {
            "value": "4"
        }
    ]
}
]

Пример с наличием разложения по оси (axis) и оси 2 (split):

[
{
    "axis": "Анатолий",
    "values": [
        {
            "split": "1"
            "value": "3"
        },
        {
            "split": "2"
            "value": "4"
        }
    ]
},
{
    "axis": "Виктор",
    "values": [
        {
            "split": "2"
            "value": "3"
        },
        {
            "split": "3"
            "value": "1"
        }
    ]
}
]

Параметры:

  • axis — группа распределения, значение может быть строкой или объектом (в зависимости от оси разложения)

  • values (array of objects) — набор значений

    • split — группа разделения (ось 2), значение может быть строкой или объектом (в зависимости от оси разложения)

    • value (number) — значение в группе (ось) с учетом подгруппы если есть (ось 2)

Получить одно значение разложения

URL: /{api url}/catalogs/{vatalogId}/values/{axisId}
            ?value[type]=recordsCount
            &axis[type]=field
            &axis[value]=2
            &recordsFilter[filters][0][fieldId]=12
            &recordsFilter[filters][0][value][0]=CURRENT_USER
            &limit=100
            &offset=0

Метод: GET

Параметры:

  • catalogId (string) — идентификатор каталога

  • axisId (string) — идентификатор разложения по оси (axis)

Параметры фильтра (определяют выборку):

  • аналогичны параметрам запроса на получение полного разложения

Ограничение: Метод вернет значение только, если указанная ось попала в общую выборку по указанным параметрам, включая параметры limit и offset.

Ответ: 200 OK (application/json)

Пример с наличием разложения по оси (axis):

{
    "axis": "Анатолий",
    "values": [
        {
            "value": "7"
        }
    ]
}

Пример с наличием разложения по оси (axis) и оси 2 (split):

{
    "axis": "Анатолий",
    "values": [
        {
            "split": "1"
            "value": "3"
        },
        {
            "split": "2"
            "value": "4"
        }
    ]
}

Параметры:

  • axis — группа распределения, значение может быть строкой или объектом (в зависимости от оси разложения)

  • values (array of objects) — набор значений

    • split — группа разделения (ось 2), значение может быть строкой или объектом (в зависимости от оси разложения)

    • value (number) — значение в группе (ось) с учетом подгруппы если есть (ось 2)

Естественным языком о смысле параметров описано в статье про .

🔌
интерфейс графика
Widget/Values
получения записей