Folder located in an app

In this example, we use the method to get a folder that an app item is located in and create a new folder in it.

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

The example below shows how to use the method to get all folders of the second nesting level. They are considered child folders of folders inside the app.

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

The example shows how to get the parent folder of a folder in an app.

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

Use this method if you need to add new access permissions to those that already exist. In the example, we used the method to get the current permissions to the folder and add new update permissions for the process initiator.

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); 
} 

Example:

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

The method completely replaces the existing access permissions with new ones. In the example, we used the method to set new permissions to a folder for the process initiator.

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); 
}