Handling a folder

The Folder service exposes all the operations available around FOLDER type components.

Folder retrieval

The examples below show how to retrieve folders from a list of identifiers.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <IDS>        list of folder identifiers to be retrieved
curl -X GET "<CORE_HOST>/rest/folders/<IDS>" \
  -H "token: <TOKEN>"

JAVA

@Autowired
private FolderService folderService;

public List<Folder> get() throws TechnicalException, FunctionalException
{
    List<Id> ids = Lists.newArrayList(new Id("folderId"));
    return folderService.get(ids);
}

Folder creation

The examples below show how to create a list of folders.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
curl -X POST "<CORE_HOST>/rest/folders" \
  -H "token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "category": "FOLDER",
    "data": {
      "ACL": "acl-folder",
      "classId": "FolderClass",
      "owner": "jna"
    },
    "name": "My Folder",
    "tags": [
      {
        "name": "FolderRef",
        "readOnly": false,
        "value": [
          "REF-001"
        ]
      },
      {
        "name": "Description",
        "readOnly": false,
        "value": [
          "Sample folder"
        ]
      }
    ]
  }
]'

JAVA

@Autowired
private FolderService folderService;

public List<Folder> create() throws FunctionalException, TechnicalException
{
    Folder folder = ComponentBuilder.component(Category.FOLDER).name("My Folder")
            .classId(new Id("FolderClass")).acl("acl-folder").build();
    folder.getData().setOwner("jna");
    folder.setTags(new Tags());
    folder.getTags().getTags().add(TagBuilder.name("FolderRef").value("REF-001").build());
    folder.getTags().getTags().add(TagBuilder.name("Description").value("Sample folder").build());
    return folderService.create(Arrays.asList(folder));
}

Folder modification

This operation updates the data in a folder: tags and data (class identifier, ACL, owner, etc.).

info

This service operates on a cancel and replace basis, so all tag values must be supplied by the service at the time of update. It is therefore advisable to retrieve the folder, make the changes and call the update service.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <IDS>        list of folder identifiers to be updated
curl -X POST "<CORE_HOST>/rest/folders/<IDS>" \
  -H "token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "category": "FOLDER",
    "data": {
      "ACL": "acl-folder",
      "classId": "FolderClass",
      "owner": "jna"
    },
    "name": "My Updated Folder",
    "tags": [
      {
        "name": "FolderRef",
        "readOnly": false,
        "value": [
          "REF-001"
        ]
      },
      {
        "name": "Description",
        "readOnly": false,
        "value": [
          "Updated description"
        ]
      }
    ]
  }
]'

JAVA

@Autowired
private FolderService folderService;

public List<Folder> update(Folder folder) throws FunctionalException, TechnicalException
{
	folder.setName("My Updated Folder");
	folder.getData().setACL(new Id("acl-folder"));
	folder.getData().setClassId(new Id("FolderClass"));
	ComponentHelper.setTagValue(folder, "Description", "Updated description");
	return folderService.update(Arrays.asList(folder));
}

Folder search

The search operations all work on the same model as described here.

Folder deletion

The examples below show how to delete a list of folders from a list of identifiers.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <IDS>        list of folder identifiers to be deleted
curl -X DELETE "<CORE_HOST>/rest/folders/<IDS>" \
  -H "token: <TOKEN>"

JAVA

@Autowired
private FolderService folderService;

public void delete() throws FunctionalException, TechnicalException
{
    List<Id> ids = Lists.newArrayList(new Id("folderId"));
    folderService.delete(ids);
}

Managing children

Folders can contain children (documents, tasks, or other folders). The following operations allow managing the children of a folder.

Adding children

This operation adds children to a folder without removing existing ones.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <ID>         folder identifier
curl -X PUT "<CORE_HOST>/rest/folders/<ID>/children" \
  -H "token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "id": "documentId1",
    "category": "DOCUMENT"
  },
  {
    "id": "taskId1",
    "category": "TASK"
  }
]'

JAVA

@Autowired
private FolderService folderService;

public void addChildren() throws FunctionalException, TechnicalException
{
    Id folderId = new Id("folderId");
    List<ComponentReference> children = new ArrayList<>();
    children.add(new ComponentReference(new Id("documentId1"), Category.DOCUMENT));
    children.add(new ComponentReference(new Id("taskId1"), Category.TASK));
    folderService.addChildren(folderId, children);
}

Replacing children

This operation replaces all existing children with the provided list.

warning

This operation removes all existing children before adding the new ones. Make sure to include all desired children in the request.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <ID>         folder identifier
curl -X POST "<CORE_HOST>/rest/folders/<ID>/children" \
  -H "token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "id": "documentId1",
    "category": "DOCUMENT"
  },
  {
    "id": "documentId2",
    "category": "DOCUMENT"
  }
]'

JAVA

@Autowired
private FolderService folderService;

public void replaceChildren() throws FunctionalException, TechnicalException
{
    Id folderId = new Id("folderId");
    List<ComponentReference> children = new ArrayList<>();
    children.add(new ComponentReference(new Id("documentId1"), Category.DOCUMENT));
    children.add(new ComponentReference(new Id("documentId2"), Category.DOCUMENT));
    folderService.replaceChildren(folderId, children);
}

Removing children

This operation removes specific children from a folder.

REST

# <CORE_HOST>  FlowerDocs Core base URL
# <TOKEN>      authentication token
# <ID>         folder identifier
curl -X DELETE "<CORE_HOST>/rest/folders/<ID>/children" \
  -H "token: <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "id": "documentId1",
    "category": "DOCUMENT"
  }
]'

JAVA

@Autowired
private FolderService folderService;

public void removeChildren() throws FunctionalException, TechnicalException
{
    Id folderId = new Id("folderId");
    List<ComponentReference> children = new ArrayList<>();
    children.add(new ComponentReference(new Id("documentId1"), Category.DOCUMENT));
    folderService.deleteChildren(folderId, children);
}