Объект приложения

Использовать массовое действие.

Используется для сохранения, обновления или удаления множества элементов приложения.

Для работы массовых действий в настройках приложения текущему пользователю должны быть выданы права на импорт данных.

Метод создаёт новый элемент приложения.

После создания и заполнения полей элемент необходимо сохранить с помощью метода BaseApplicationItem.save.

const item = Application.create();
item.data.__name = Context.data.request_subject;
await item.save();

Метод создаёт новую папку на уровне приложения (1-й уровень вложенности).

В примере с помощью метода мы создаём новую папку в приложении.

const folder = await Application.createFolder('name');

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

В примере метод позволяет получить все папки приложения.

const folders = await Application.getFolders();

Метод возвращает права доступа, установленные для данного приложения.

Подробнее о работе метода в BaseApplicationItem.getPermissions.

Возвращает настройки, установленные для данного приложения.

const settings = await Application.getSettings();

// Включена ли регистрация
const on_registry = settings.registrationSettings.enabled

// Список ID дел, в которых доступна регистрация для данного приложения
const nomIDs = settings.registrationSettings.nomenclatureIds

// Возвращает список дел, доступных для данного приложения
const nomenclatures = settings.registrationSettings.getNomenclatures();

Метод проверяет наличие права доступа для пользователя, группы, элемента оргструктуры, роли.

Метод позволяет выполнить поиск по элементам приложения.

Подробнее о поиске по элементам приложения можно прочитать в статье «Работа с приложениями».

Метод устанавливает новые права на элемент приложения.

Подробнее о работе метода в BaseApplicationItem.setPermissions.

Метод позволяет выполнить поиск по истории изменений статусов элементов приложения.

Метод возвращает объект StatusHistorySearch, который поддерживает фильтрацию и сортировку результатов поиска.

// Получим историю переходов в статус Сделано (`done`) за последний день
const today = new Datetime();
const yesterday = today.addDate(0, 0, -1);
const changes = Application.statusHistory()
    .where((f, g) => g.and(
        f.__createdAt.gte(yesterday),
        f.target.eq(Application.fields.__status.variants.done.id),
    ))
    .all();

// Получим полные данные всех элементов,
// статус которых изменился на Сделано (`done`)
const items = await Promise.all(changes.map(change => change.data.item!.fetch()));