--- Title: Release notes v3.2.0 --- # Alfresco Application Development Framework (ADF) version 3.2.0 Release Note These release notes provide information about the **3.2.0 release** of the Alfresco Application Development Framework. This is the latest **General Available** release of the Application Development Framework, which contains the Angular components to build a Web Application on top of the Alfresco Platform. The release can be found on GitHub at [this location](https://github.com/Alfresco/alfresco-ng2-components/releases/tag/3.2.0). See the [ADF roadmap](../roadmap.md) for details of features planned for future versions of ADF. ## Contents - [New package versions](#new-package-versions) - [Goals for this release](#goals-for-this-release) - [More on Activiti 7](#more-on-activiti-7) - [Five more languages available](#five-more-languages-available) - [List separator configuration in multi-value metadata](#list-separator-configuration-in-multi-value-metadata) - [Option to chose which panel to show first in info drawer](#option-to-chose-which-panel-to-show-first-in-info-drawer) - [Confirm Dialog third extra button option and custom HTML message](#confirm-dialog-third-extra-button-option-and--custom-html-message) - [Configuration option to change the default viewer zoom](#configuration-option-to-change-the-default-viewer-zoom) - [Drop events for DataTable component](#drop-events-for-datatable-component) - [Sidenav Layout Direction property](#sidenav-layout-direction-property) - [Custom local storages prefix property](#custom-local-storages-prefix-property) - [Datatable Component new Json cell type](#datatable-component-new--json-cell-type) - [Localisation](#localisation) - [References](#references) - [Issues addressed](#issues-addressed) ## New package versions "@alfresco/adf-content-services" : "3.2.0" "@alfresco/adf-process-services" : "3.2.0" "@alfresco/adf-core" : "3.2.0" "@alfresco/adf-insights" : "3.2.0", "@alfresco/adf-extensions": "3.2.0" ## Goals for this release This is the second minor release since ADF version 3 which was released in February 2019. This release goes a step further in the direction of complete support for [Activiti 7](https://www.activiti.org/), the next generation Cloud Native implementation of Activiti. Also, some enhancements have been introduced to the Metadata viewer to properly manage multi-value properties, together with the event handling during header row action, to properly manage use cases like the drag & drop feature, requested from some developers. We are pleased to announce that starting from ADF 3.2, five more languages are now supported, together with the other ten. The new languages are: Danish, Finnish, Swedish, Czech, Polish. Please report issues with this release in the [issue tracker](https://github.com/Alfresco/alfresco-ng2-components/issues/new). You can collaborate on this release or share feedback by using the discussion tools on [Gitter](http://gitter.im/Alfresco/alfresco-ng2-components). Below are the most important new features of this release: - [More on Activiti 7](#more-on-activiti-7) - [Five more languages supported](#five-more-languages-supported) - [Event handling during header row action](#event-handling-during-header-row-action) - [List separator configuration in multi-value metadata](#list-separator-configuration-in-multi-value-metadata) ### More on Activiti 7 In ADF 3.0.0 (released in February) we announced the introduction of the new `*Cloud` package. This contains a set of components to support [Activiti 7](https://www.activiti.org/), the next generation Cloud Native implementation of Activiti BPM Engine. With the ADF 3.2 release, the journey continues with more supported features, like: #### Task Form component This component is responsible to show the form renderer in case the task has a form attached or the standard standalone card with the Claim/Release/Complete buttons. ```html ``` For more details refer to the: - [`TaskFormCloudComponent`](../process-services-cloud/components/task-form-cloud.component.md). #### Form Cloud This component is responsible to render the form cloud definition attached to the task. ```html ``` In case the form has an upload widget and the alfresco content has been configured\*, the attached file will be stored into the alfresco repository. Note\*: Don't forget to set the `providers` property to `ALL` and `ecmHost` value in the `app.config.json`. e.g. ```json "ecmHost": "http://alfrescocontent.example.com", "bpmHost": "http://alfrescoaps2.example.com", "providers": "ALL" ``` For more details refer to the: - [`FormCloudComponent`](../process-services-cloud/components/form-cloud.component.md). #### New permission template to app list A new message template is now displayed when a user doesn't have permissions #### Cloud form definition selector component Cloud form definition selector component is a dropdown that shows all the form present in your app. ```html ``` For more details refer to the: - [`FormDefinitionSelectorCloudComponent`](../process-services-cloud/components/form-definition-selector-cloud.component.md). #### Start a standalone task with a form The start task cloud is now using the `cloud-form-definition-selector` that allows the user to attach a form to a task ### Five more languages available Starting from ADF 3.2, five more languages are now available, together with the other ten already in the list. The new languages supported are: Danish, Finnish, Swedish, Czech, Polish. ### List separator configuration in multi-value metadata As of this version of ADF, developers can configure the list separator of multi-value properties into the metadata viewer. Since this version of ADF, to customize the separator you can set it in your `app.config.json` file inside your `content-metadata` configuration. Below an example. ```json "content-metadata": { "presets": { ... }, "multi-value-pipe-separator" : " - " } ``` For more details refer to the: - [Content Metadata Card component](../content-services/components/content-metadata-card.component.md) ### Option to chose which panel to show first in info drawer Is now possible define which aspect show expanded by default in the metadata card applying the optional property `displayAspect` ![feature-1](https://user-images.githubusercontent.com/14145706/56648273-a45efd80-66a0-11e9-866b-4f13c7df4b80.gif) For more details refer to the: - [Content Metadata Card component](../content-services/components/content-metadata-card.component.md) ### Confirm Dialog third extra button option and custom HTML message Is now possible add an extra button in the Confirm Dialog #### Dialog inputs | Name | Type | Default value | Description | | ---- | ---- | ------------- | ----------- | | title | `string` | `Confirm` | It will be placed in the dialog title section. | | yesLabel | `string` | `yes` | It will be placed first in the dialog action section | | noLabel | `string` | `no` | It will be placed last in the dialog action section | | thirdOptionLabel (optional) | `string` | | It is not a mandatory input. it will be rendered in between yes and no label | | message | `string` | `Do you want to proceed?` | It will be rendered in the dialog content area | | htmlContent | `HTML` | | It will be rendered in the dialog content area | ![yes-all](https://user-images.githubusercontent.com/14145706/56139451-87e30700-5fb6-11e9-8121-e58008231df2.png) For more details refer to the: - [Confirm Dialog](../core/dialogs/confirm.dialog.md) ### Configuration option to change the default viewer zoom You can set a default zoom scaling value for pdf viewer by adding the following code in `app.config.json`. Note: For the pdf viewer the value has to be within the range of 25 - 1000. ```json "adf-viewer": { "pdf-viewer-scaling": 150 } ``` In the same way, you can set a default zoom scaling value for the image viewer by adding the following code in `app.config.json`. ```json "adf-viewer": { "image-viewer-scaling": 150 } ``` By default, the viewer's zoom scaling is set to 100%. For more details refer to the: - [Viewer Component](../docs/core/components/viewer.component.md) ### Drop events for DataTable component #### Drop Events Below are the four new DOM events emitted by the DataTable component. These events bubble up the component tree and can be handled by any parent component. | Name | Description | | ---- | ----------- | | header-dragover | Raised when dragging content over the header. | | header-drop | Raised when data is dropped on the column header. | | cell-dragover | Raised when dragging data over the cell. | | cell-drop | Raised when data is dropped on the column cell. | #### Drop Events All custom DOM events related to `drop` handling expose the following interface: ```ts export interface DataTableDropEvent { detail: { target: 'cell' | 'header'; event: Event; column: DataColumn; row?: DataRow }; preventDefault(): void; } ``` Note that `event` is the original `drop` event, and `row` is not available for Header events. According to the [HTML5 Drag and Drop API](https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API), you need to handle both `dragover` and `drop` events to handle the drop correctly. Given that DataTable raises bubbling DOM events, you can handle drop behavior from the parent elements as well: ```html
``` ### Sidenav Layout Direction property If you use the [Sidenav Layout component](../core/components/sidenav-layout.component.md) you can choose set the direction property in it using the property direction ans set it to **'rtl'** ```html ...... ``` ![preview](https://user-images.githubusercontent.com/3947156/55820667-507ee100-5b04-11e9-81ee-a9951982b237.gif) ### Custom local storages prefix property If you are using multiple ADF apps, you might want to set the following configuration so that the apps have specific storages and are independent of others when setting and getting data from the local storage. In order to achieve this, you will only need to set your app identifier under the `storagePrefix` property of the app in your `app.config.json` file. ```json "application": { "storagePrefix": "ADF_Identifier" } ``` ### Datatable Component new Json cell type The datale is now able to render in a better way JSON text : Show Json formated value inside datatable component. ```html ``` ## Localisation This release includes: French, German, Italian, Spanish, Arabic, Japanese, Dutch, Norwegian (Bokmål), Russian, Danish, Finnish, Swedish, Czech, Polish, Brazilian Portuguese and Simplified Chinese versions. ## References Below is a brief list of references to help you start using the new release: - [Getting started guides with Alfresco Application Development Framework](https://community.alfresco.com/community/application-development-framework/pages/get-started) - [Alfresco ADF Documentation on the Builder Network](../README.md) - [Gitter chat supporting Alfresco ADF](https://gitter.im/Alfresco/alfresco-ng2-components) - [ADF examples on GitHub](https://github.com/Alfresco/adf-examples) - [Official GitHub Project - alfresco-ng2-components](https://github.com/Alfresco/alfresco-ng2-components) - [Official GitHub Project - alfresco-js-api](https://github.com/Alfresco/alfresco-js-api) - [Official GitHub Project - generator-ng2-alfresco-app](https://github.com/Alfresco/generator-ng2-alfresco-app) Please refer to the [official documentation](http://docs.alfresco.com/) for further details and suggestions. ## Issues addressed Below is the list of JIRA issues that were closed for this release.

Feature

Epic

Story

Bug

Task

Feature Bug

Feature (Task)

Please refer to the [Alfresco issue tracker](https://issues.alfresco.com/jira/projects/ADF/issues/ADF-581?filter=allopenissues) for other known issues in this release. If you have any questions about the release, please contact us using [Gitter](https://gitter.im/Alfresco/alfresco-ng2-components). Thanks to the whole application team and the amazing Alfresco community for the hard work.