alfresco-js-api-node

# AlfrescoGovernanceServicesRestApi.UnfiledContainersApi All URIs are relative to *https://localhost/alfresco/api/-default-/public/gs/versions/1* Method | HTTP request | Description ------------- | ------------- | ------------- [**createUnfiledContainerChildren**](UnfiledContainersApi.md#createUnfiledContainerChildren) | **POST** /unfiled-containers/{unfiledContainerId}/children | Create a record or an unfiled record folder [**getUnfiledContainer**](UnfiledContainersApi.md#getUnfiledContainer) | **GET** /unfiled-containers/{unfiledContainerId} | Get the unfiled records container [**listUnfiledContainerChildren**](UnfiledContainersApi.md#listUnfiledContainerChildren) | **GET** /unfiled-containers/{unfiledContainerId}/children | List unfiled record container's children [**updateUnfiledContainer**](UnfiledContainersApi.md#updateUnfiledContainer) | **PUT** /unfiled-containers/{unfiledContainerId} | Update an unfiled record container <a name="createUnfiledContainerChildren"></a> # **createUnfiledContainerChildren** > UnfiledContainerAssociationPaging createUnfiledContainerChildren(unfiledContainerId, nodeBodyCreate, opts) Create a record or an unfiled record folder Creates a record or an unfiled record folder as a primary child of **unfiledContainerId**. You can set the **autoRename** boolean field to automatically resolve name clashes. If there is a name clash, then the API method tries to create a unique name using an integer suffix. This endpoint supports both JSON and multipart/form-data (file upload). **Using multipart/form-data** Use the **filedata** field to represent the content to upload, for example, the following curl command will create a node with the contents of test.txt in the test user's home folder. ```curl -utest:test -X POST host:port/alfresco/api/-default-/public/gs/versions/1/unfiled-containers/{unfiledContainerId}/children -F filedata=@test.txt``` This API method also supports record and unfiled record folder creation using application/json. You must specify at least a **name** and **nodeType**. You can create a non-electronic record like this: ```JSON { \"name\":\"My Non-electronic Record\", \"nodeType\":\"rma:nonElectronicDocument\", \"properties\": { \"cm:description\":\"My Non-electronic Record Description\", \"cm:title\":\"My Non-electronic Record Title\", \"rma:box\":\"My Non-electronic Record Box\", \"rma:file\":\"My Non-electronic Record File\", \"rma:numberOfCopies\":1, \"rma:physicalSize\":30, \"rma:shelf\":\"My Non-electronic Record Shelf\", \"rma:storageLocation\":\"My Non-electronic Record Location\" } } ``` You can create an empty electronic record: ```JSON { \"name\":\"My Electronic Record\", \"nodeType\":\"cm:content\" } ``` You can create an unfiled record folder like this: ```JSON { \"name\": \"My Unfiled Record Folder\", \"nodeType\": \"rma:unfiledRecordFolder\", \"properties\": { \"cm:title\": \"My Unfiled Record Folder Title\" } } ``` Any missing aspects are applied automatically. You can set aspects explicitly, if needed, using an **aspectNames** field. **Note:** You can create more than one child by specifying a list of nodes in the JSON body. For example, the following JSON body creates a record and an unfiled record folder inside the specified **unfiledContainerId**: ```JSON [ { \"name\":\"My Record\", \"nodeType\":\"cm:content\" }, { \"name\":\"My Unfiled Record Folder\", \"nodeType\":\"rma:unfiledRecordFolder\" } ] ``` If you specify a list as input, then a paginated list rather than an entry is returned in the response body. For example: ```JSON { \"list\": { \"pagination\": { \"count\": 2, \"hasMoreItems\": false, \"totalItems\": 2, \"skipCount\": 0, \"maxItems\": 100 }, \"entries\": [ { \"entry\": { ... } }, { \"entry\": { ... } } ] } } ``` ### Example ```javascript var unfiledContainerId = "unfiledContainerId_example"; // String | The identifier of an unfiled records container. You can use the **-unfiled-** alias. var nodeBodyCreate = new AlfrescoGovernanceServicesRestApi.RMNodeBodyCreate(); // RMNodeBodyCreate | The node information to create. var opts = { 'autoRename': true, // Boolean | If true, then a name clash will cause an attempt to auto rename by finding a unique name using an integer suffix. 'include': ["include_example"], // [String] | Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path 'fields': ["fields_example"] // [String] | A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. }; this.alfrescoJsApi.gsCore.unfiledContainersApi.createUnfiledContainerChildren(unfiledContainerId, nodeBodyCreate, opts).then(function(data) { console.log('API called successfully. Returned data: ' + data); }, function(error) { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **unfiledContainerId** | **String**| The identifier of an unfiled records container. You can use the **-unfiled-** alias. | **nodeBodyCreate** | [**RMNodeBodyCreate**](RMNodeBodyCreate.md)| The node information to create. | **autoRename** | **Boolean**| If true, then a name clash will cause an attempt to auto rename by finding a unique name using an integer suffix. | [optional] **include** | [**[String]**](String.md)| Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path | [optional] **fields** | [**[String]**](String.md)| A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. | [optional] ### Return type [**UnfiledContainerAssociationPaging**](UnfiledContainerAssociationPaging.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, multipart/form-data - **Accept**: application/json <a name="getUnfiledContainer"></a> # **getUnfiledContainer** > UnfiledContainerEntry getUnfiledContainer(unfiledContainerId, , opts) Get the unfiled records container Gets information for unfiled records container **unfiledContainerId** Mandatory fields and the unfiled records container's aspects and properties are returned by default. You can use the **include** parameter (include=allowableOperations) to return additional information. ### Example ```javascript var unfiledContainerId = "unfiledContainerId_example"; // String | The identifier of an unfiled records container. You can use the **-unfiled-** alias. var opts = { 'include': ["include_example"], // [String] | Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path 'fields': ["fields_example"] // [String] | A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. }; this.alfrescoJsApi.gsCore.unfiledContainersApi.getUnfiledContainer(unfiledContainerId, , opts).then(function(data) { console.log('API called successfully. Returned data: ' + data); }, function(error) { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **unfiledContainerId** | **String**| The identifier of an unfiled records container. You can use the **-unfiled-** alias. | **include** | [**[String]**](String.md)| Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path | [optional] **fields** | [**[String]**](String.md)| A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. | [optional] ### Return type [**UnfiledContainerEntry**](UnfiledContainerEntry.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json <a name="listUnfiledContainerChildren"></a> # **listUnfiledContainerChildren** > UnfiledContainerAssociationPaging listUnfiledContainerChildren(unfiledContainerId, , opts) List unfiled record container's children Returns a list of records or unfiled record folders. Minimal information for each child is returned by default. You can use the **include** parameter (include=allowableOperations) to return additional information. ### Example ```javascript var unfiledContainerId = "unfiledContainerId_example"; // String | The identifier of an unfiled records container. You can use the **-unfiled-** alias. var opts = { 'skipCount': 56, // Number | The number of entities that exist in the collection before those included in this list. 'maxItems': 56, // Number | The maximum number of items to return in the list. 'where': "where_example", // String | Optionally filter the list. Here are some examples: * ```where=(isRecord=true)``` * ```where=(isUnfiledRecordFolder=false)``` * ```where=(nodeType='cm:content INCLUDESUBTYPES')``` 'include': ["include_example"], // [String] | Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * aspectNames * association * path * properties 'includeSource': true, // Boolean | Also include **source** (in addition to **entries**) with folder information on the parent node – the specified parent **unfiledContainerId** 'fields': ["fields_example"] // [String] | A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. }; this.alfrescoJsApi.gsCore.unfiledContainersApi.listUnfiledContainerChildren(unfiledContainerId, , opts).then(function(data) { console.log('API called successfully. Returned data: ' + data); }, function(error) { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **unfiledContainerId** | **String**| The identifier of an unfiled records container. You can use the **-unfiled-** alias. | **skipCount** | **Number**| The number of entities that exist in the collection before those included in this list. | [optional] **maxItems** | **Number**| The maximum number of items to return in the list. | [optional] **where** | **String**| Optionally filter the list. Here are some examples: * ```where=(isRecord=true)``` * ```where=(isUnfiledRecordFolder=false)``` * ```where=(nodeType='cm:content INCLUDESUBTYPES')``` | [optional] **include** | [**[String]**](String.md)| Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * aspectNames * association * path * properties | [optional] **includeSource** | **Boolean**| Also include **source** (in addition to **entries**) with folder information on the parent node – the specified parent **unfiledContainerId** | [optional] **fields** | [**[String]**](String.md)| A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. | [optional] ### Return type [**UnfiledContainerAssociationPaging**](UnfiledContainerAssociationPaging.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json <a name="updateUnfiledContainer"></a> # **updateUnfiledContainer** > UnfiledContainerEntry updateUnfiledContainer(unfiledContainerId, unfiledContainerBodyUpdate, opts) Update an unfiled record container Updates unfiled record container **unfiledContainerId**. For example, you can rename an unfiled record container: ```JSON { \"name\":\"My new name\" } ``` You can also set or update description and title properties: ```JSON { \"properties\": { \"cm:description\": \"New Description\", \"cm:title\":\"New Title\" } } ``` **Note:** Currently there is no optimistic locking for updates, so they are applied in \"last one wins\" order. ### Example ```javascript var unfiledContainerId = "unfiledContainerId_example"; // String | The identifier of an unfiled records container. You can use the **-unfiled-** alias. var unfiledContainerBodyUpdate = new AlfrescoGovernanceServicesRestApi.UnfiledRecordContainerBodyUpdate(); // UnfiledRecordContainerBodyUpdate | The unfiled record container information to update. var opts = { 'include': ["include_example"], // [String] | Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path 'fields': ["fields_example"] // [String] | A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. }; this.alfrescoJsApi.gsCore.unfiledContainersApi.updateUnfiledContainer(unfiledContainerId, unfiledContainerBodyUpdate, opts).then(function(data) { console.log('API called successfully. Returned data: ' + data); }, function(error) { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **unfiledContainerId** | **String**| The identifier of an unfiled records container. You can use the **-unfiled-** alias. | **unfiledContainerBodyUpdate** | [**UnfiledRecordContainerBodyUpdate**](UnfiledRecordContainerBodyUpdate.md)| The unfiled record container information to update. | **include** | [**[String]**](String.md)| Returns additional information about the unfiled records container's children. Any optional field from the response model can be requested. For example: * allowableOperations * path | [optional] **fields** | [**[String]**](String.md)| A list of field names. You can use this parameter to restrict the fields returned within a response if, for example, you want to save on overall bandwidth. The list applies to a returned individual entity or entries within a collection. If the API method also supports the **include** parameter, then the fields specified in the **include** parameter are returned in addition to those specified in the **fields** parameter. | [optional] ### Return type [**UnfiledContainerEntry**](UnfiledContainerEntry.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json