Папка внутри приложения

Метод создаёт новую дочернюю папку.

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

const folder = await Context.data.item?.getFolder();
const childFolder = await folder.createFolder('name');

Метод получает массив дочерних папок.

В примере с помощью метода мы получаем все папки второго уровня вложенности. Они являются дочерними по отношению к папкам на уровне приложения.

const folders = await Application.getFolders();
const allChildren: TFolder[] = [];
folders.forEach(folder => {
    const children = await folder.getChildren();
    allChildren.push(...children);
});

Метод получает родительскую папку.

В примере с помощью метода мы получаем родительскую папку элемента приложения.

const folder = await Context.data.item?.getFolder();
const parentFolder = await folder.getParent();

Получает права доступа, установленные для данной папки.

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

В примере с помощью метода мы получаем установленные для папки права и добавляем права на обновление инициатору процесса.

const folder = await Context.data.item?.getFolder();
const user = Context.data.__createdBy;

if (folder) {
     const currPermissions = await folder.getPermissions()
     currPermissions.values.push(new PermissionValue(user, [PermissionType.UPDATE]))
     await folder.setPermissions(currPermissions);
}

Метод позволяет изменить имя папки.

Пример использования:

const folders = await Application.getFolders();

if (folders.length !== 0) {
     const folder = folders[0];
     await folder.setName('NEW_NAME');
}

Метод устанавливает новые права на папку.

Метод полностью заменяет существующие права новыми.

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

const folder = await Context.data.item?.getFolder();
const user = Context.data.executor;

if (folder) {
     const permissions = new Permissions([new PermissionValue(user, [PermissionType.DELETE, PermissionType.UPDATE])]);
     await folder.setPermissions(permissions);
}