Подготовка данных для импорта

Сервер BOOCO Astra (v 2.x) / Импорт ресурсов

Добавление новых ресурсов

  1. Скачайте шаблон для подготовки данных:
    2. resources_import_template.csv0.7KB
  2. В шаблоне добавьте данные всех новых ресурсов (1 строка — 1 ресурс):
  3. Сохраните обновленный файл в формате .CSV для импорта.

Обновление карточек существующих ресурсов

  1. Экспортируйте в файл .CSV ресурсы, карточки которых нужно обновить.
  2. Отредактируйте данные в любых столбцах, кроме uuid.
    3. ⚠️
    Не меняйте значения в столбце uuid. Ресурс будет обновлен, если его uuid в BOOCO и в файле .CSV совпадают.
  3. Сохраните обновленный файл в формате .CSV для импорта.

Основные параметры

В строке ресурса укажите:

  • id*: уникальный идентификатор ресурса (латиница, цифры);
  • name*: Название ресурса;
  • description: Описание — дополнительная информация о ресурсе;
  • type*: Тип ресурса**;
  • capacity: Вместимость (для помещений);
  • location*: Локация** — здание или блок, в котором находится данный ресурс;
  • locationSegment: Сегмент локации** — расположенный в выбранной локации этаж или опенспейс, где находится данный ресурс;
  • groups: Группы** — группа/группы ресурсов, к которым относится ресурс (через запятую, без пробела);
  • tags: Теги**;
  • appliances: Оборудование** — каким оборудованием оснащен ресурс (через запятую, без пробела).
    • ⚠️
    * Обязательно.

    ** Укажите нужное значение из колонки Наименование в соответствующем справочнике.

Дополнительные параметры (parameters) и доступные значения

Настройки разрешения бронировать ресурс

Параметр
Доступные значения
Описание

Возможность бронировать ресурс — разрешение/запрет на бронирование ресурса/закрепление ресурса за сотрудником

enabled

Бронирование разрешено

disabled

Бронирование запрещено

out-of-order

Выведено из эксплуатации

fixed

Фиксированный ресурс

Настройки для фиксированного ресурса

Параметр
Описание

Для ресурса с bookingStatus=fixed вы можете указать логин (username) или email сотрудника, за которым он закреплен

Настройки доступного интервала бронирования

Параметр
Описание

Время, с которого можно начинать бронировать ресурс (обычно соответствует времени начала рабочего дня в офисе)

Время, до которого можно бронировать ресурс (обычно соответствует времени завершения рабочего дня в офисе)

Настройки продолжительности бронирования

Параметр
Описание

Минимальная продолжительность бронирования

Максимальная продолжительность бронирования

Шаг бронирования в форме создания бронирования

Продолжительность бронирования по умолчанию. Должна быть кратной timeStep (если задан)

Настройки доступных для бронирования дней

Параметр
Доступные значения
Описание

На сколько дней назад можно забронировать ресурс

На сколько дней вперед можно забронировать ресурс

Разрешенные дни бронирования

all

Любые дни (по умолчанию)

workdays

По рабочим дням

holidays

По выходным

Настройки полей для ввода данных о теме и участниках события (для помещений)

Параметр
Доступные значения
Описание

Настройки отображения поля Тема

none

Не показывать поле

optional

Можно ввести тему или оставить поле пустым

required

Отображается поле ввода, обязательно к заполнению

select-or-new

Поле отображается и не может быть пустым. Если задан список быстрых тем (subjectsList), то можно выбрать быструю тему или ввести свою тему. Если subjectsList не задан, то нужно ввести свою тему

select

Необходимо выбрать тему из списка быстрых тем

Если в колонке subjectField указано select-or-new — перечислите темы для отображения в списке с выбором быстрых тем (через запятую с пробелом)

Настройки отображения поля Участники

none

Не показывать поле

required

Показывать поле, необходимо ввести email участника

readonly

Показывать поле, но не разрешать редактировать (в том числе при создании новых бронирований)

optional

Можно ввести валидный email участника или оставить поле пустым

select

Нужно выбрать участников из списка

select-or-new

Нужно выбрать участников из списка или ввести валидный email участника

Настройки разрешения отображать/редактировать время бронирования

Параметр
Доступные значения
Описание

Разрешение показывать поле с выбором времени начала бронирования (например, это не нужно, если будете бронировать по дням)

none

Не показывать поле

required

Показывать поле, можно редактировать

readonly

Показывать поле, но не разрешать редактировать

Разрешение показывать поле с выбором времени завершения периода бронирования (например, это не нужно, если при настройке продолжительности бронирования заданы minPeriod = maxPeriod)

none

Не показывать поле

required

Показывать поле, можно редактировать

readonly

Показывать поле, но не разрешать редактировать

Настройки ввода данных об организаторе

Параметр
Доступные значения
Описание

Настройки отображения поля Организатор

none

Не показывать поле

optional

Можно ввести валидный email организатора или оставить поле пустым

required

Отображается поле ввода, нужно ввести валидный email организатора (обязательно)

readonly

Показывать поле, но не разрешать редактировать (например, если помещение синхронизируется с MS Exchange)

select

Нужно выбрать одного пользователя из списка тех, у кого есть email и кто может бронировать

select-or-new

Нужно выбрать пользователей из списка или ввести валидный email организатора

Настройки списка с выбором частоты повторения бронирования

Параметр
Доступные значения
Описание

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

daily

Ежедневно

weekly

Еженедельно

monthly

Ежемесячно

workdays

Рабочие дни

holidays

Выходные дни

weekdays

Дни недели

Настройки выполнения проверки социальной дистанции (для рабочих мест)

Параметр
Доступные значения
Описание

Выполнять ли проверку социального дистанцирования

none

Проверка не требуется

always

Проверка требуется всегда

Минимально допустимое расстояние между рабочими местами (если проверка требуется)

Метод проверки расстояния между рабочим местом и соседними рабочими местами (если проверка требуется)

none

Не проверяется (значение по умолчанию)

xy

Нельзя бронировать, если есть брони ближе socialDistance по оси X и по оси Y

radius

Нельзя бронировать, если есть брони ближе в радиусе socialDistance

Настройки режима подтверждения бронирования руководителем

Параметр
Доступные значения
Описание

Включить ли режим подтверждения бронирования руководителем

none

Подтверждение не требуется

always

Подтверждение требуется всегда

Настройки подтверждения присутствия (check-in)

Параметр
Доступные значения
Описание

Требуется ли Регистрация (check-in)

none

Регистрация не требуется

always

Регистрация требуется всегда

В течение какого времени до начала события необходимо подтвердить присутствие (в формате: 5 min)

В течение какого времени после начала события необходимо подтвердить присутствие (в формате: 5 min)