[ACS-4523] Assigning content to categories (#8451)

* [ACS-4523] Add categories management mode component, manage mode completed

* [ACS-4523] Add categories management fixes and unit tests

* [ACS-4523] Add unit tests to content metadata

* ACS-4523] CR fixes

* [ACS-4523] Tag and category name controls decoupled

* [ACS-4523] CR fixes

* [ACS-4523] CR fixes

* [ACS-4523] CR fixes

* [ACS-4523] Display path for already linked categories

* [ACS-4523] Add new license header

* [ACS-4523] Fix category service import

docs/content-services/components/categories-management.component.md

@@ -0,0 +1,44 @@
+---
+Title: Categories management component
+Added: v6.0.0-A.3
+Status: Active
+Last reviewed: 2023-04-07
+---
+
+# [Categories management component](../../../lib/content-services/src/lib/category/categories-management/categories-management.component.ts "Defined in categories-management.component.ts")
+
+Component allows to both assign/unassign categories to content and create multiple categories depending on selected mode. In assign mode component is composed of: list of categories that will be assigned to a file, input to search for existing categories that user can select and second list under the input containing existing categories that node can be assigned to. In crud mode component is composed of: list of categories that will be created, input to type a name of category that will be created and a list of categories existing under a given parent, in this mode existing categories are not selectable.
+
+## Basic Usage
+
+```html
+<adf-categories-management
+    [(categoryNameControlVisible)]="categoryControlVisible"
+    [disableRemoval]="saving"
+    [categories]="categories"
+    [parentId]="parentId"
+    [managementMode]="categoriesManagementMode"
+    [classifiableChanged]="classifiableChanged"
+    (categoriesChange)="storeCategoriesToAssign($event)">
+</adf-categories-management>
+```
+
+## Class members
+
+### Properties
+
+| Name | Type | Default value | Description |
+| ---- | ---- | ------------- | ----------- |
+| categories | [`Category`](https://github.com/Alfresco/alfresco-js-api/blob/develop/src/api/content-rest-api/docs/Category.md)[] | [] | List of categories to assign/create. |
+| categoryNameControlVisible | `boolean` | false | Determines if category name control is visible. |
+| classifiableChanged | [`Observable<void>`](https://rxjs.dev/guide/observable) | | (optional) Observable emitting when `classifiable` aspect changes for a given node. |
+| disableRemoval | `boolean` | false | Determines if categories assigned/created can be unassigned/removed from the list. |
+| managementMode | `CategoriesManagementMode` | | Management mode determines if component works in assign/unassign mode or create mode. |
+| parentId | `string` | | (optional) ID of a parent category that new categories will be created under. |
+
+### Events
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| categoriesChange | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<`[`Category`](https://github.com/Alfresco/alfresco-js-api/blob/develop/src/api/content-rest-api/docs/Category.md)`>` | Emitted when categories list changes. |
+| categoryNameControlVisibleChange | [`EventEmitter`](https://angular.io/api/core/EventEmitter)`<boolean>` | Emitted when category name control visibility changes. |

docs/content-services/services/category.service.md

@@ -43,6 +43,25 @@ Manages categories in Content Services.
     -   _skipCount:_ `number`  - Specify how many first results should be skipped. Default 0.
     -   _maxItems:_ `number`  - (Optional) Specify max number of returned categories. Default is specified by [UserPreferencesService](../../core/services/user-preferences.service.md).
     -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`ResultSetPaging`](https://github.com/Alfresco/alfresco-js-api/blob/develop/src/api/search-rest-api/docs/ResultSetPaging.md)`>` - [`Observable`](http://reactivex.io/documentation/observable.html)&lt;ResultSetPaging> Found categories which name contains searched name.
+-   **updateCategory**(categoryId: `string`, payload: `CategoryBody`): [`Observable`](http://reactivex.io/documentation/observable.html)`<CategoryEntry>`<br/>
+    Updates category
+    -   _categoryId:_ `string`  - The identifier of a category.
+    -   _payload:_ `CategoryBody`  - Updated category body
+    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<CategoryEntry>` - [`Observable`](http://reactivex.io/documentation/observable.html)&lt;CategoryEntry>
+-   **getCategoryLinksForNode**(nodeId: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CategoryPaging`](https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryPaging.md)`>`<br/>
+    Provides list of categories that node is linked to.
+    -   _nodeId:_ `string`  - Id of a node that is linked to categories
+    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CategoryPaging`](https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryPaging.md)`>` - Found categories that node is linked to.
+-   **unlinkNodeFromCategory**(nodeId: `string`, categoryId: `string`): [`Observable`](http://reactivex.io/documentation/observable.html)`<void>`<br/>
+    Unlinks category from a node.
+    -   _nodeId:_ `string`  - The identifier of a node.
+    -   _categoryId:_ `string`  - The identifier of a category.
+    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<void>`
+-   **linkNodeToCategory**(nodeId: `string`, categoryLinkBodyCreate: `CategoryLinkBody[]`): [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CategoryPaging`]((https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryPaging.md))` | `[`CategoryEntry`](https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryEntry.md)`>`<br/>
+    Links node to a category.
+    -   _nodeId:_ `string`  - The identifier of a node.
+    -   _categoryLinkBodyCreate:_ [`CategoryLinkBody[]`](https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryLinkBody.md)  - Categories that node will be linked to.
+    -   **Returns** [`Observable`](http://reactivex.io/documentation/observable.html)`<`[`CategoryPaging`]((https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryPaging.md))` | `[`CategoryEntry`](https://github.com/Alfresco/alfresco-js-api/blob/master/src/api/content-rest-api/docs/CategoryEntry.md)`>` - Categories that node has been linked to.
 
 ## Details