--- Title: Release notes v3.3.0 --- # Alfresco Application Development Framework (ADF) version 3.3.0 Release Note These release notes provide information about the **3.3.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.3.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) - [Form field visibility](#form-field-visibility) - [Start a process with a form](#start-a-process-with-a-form) - [Multilingual support for forms](#multilingual-support-for-forms) - [Form validation](#form-validation) - [Form variables](#form-variables) - [REST source for dropdown menu on forms](#rest-source-for-dropdown-menu-on-forms) - [Date format localization](#date-format-localization) - [Localisation](#localisation) - [References](#references) - [Issues addressed](#issues-addressed) ## New package versions "@alfresco/adf-content-services" : "3.3.0" "@alfresco/adf-process-services" : "3.3.0" "@alfresco/adf-core" : "3.3.0" "@alfresco/adf-insights" : "3.3.0", "@alfresco/adf-extensions": "3.3.0" ## Goals for this release This is the third minor release since of ADF since February 2019 when version 3 was released. This release continues to provide additional support for [Activiti 7](https://www.activiti.org/), the next generation Cloud Native implementation of Activiti. The functionality and enhancements of this release are focused on forms. [`Form`](../../lib/process-services/src/lib/task-list/models/form.model.ts) field visibility has been improved, form validation has been implemented and it is now possible to use form variables. Multilingual support for forms has been enhanced and dropdown menus reading from a REST source have been updated. From an end-user perspective, a process can now be started using a form when the start event contains a valid form. 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). The following are the most important features of this release: - [Form visibility](#form-field-visibility) - [Start a process with a form](#start-a-process-with-a-form) - [Multilingual support for forms](#multilingual-support-for-forms) - [Form validation](#form-validation) - [Forms variables](#form-variables) - [REST source for dropdown menu on forms](#rest-source-for-dropdown-menu-on-forms) - [Date format localization](#date-format-localization) ### Form field visibility [`Form`](../../lib/process-services/src/lib/task-list/models/form.model.ts) field visibility has been improved to respect the visibility conditions configured for each field in the Modelling Application. ### Start a process with a form The `adf-cloud-start-process` component now contains the functionality to start a process using a form. It is possible start a process with a form and variables: ```html ``` It is also possible to start a process with a form and pass in the form values at the same time: ```html ``` ### Multilingual support for forms In previous versions it was not possible to translate a label that was defined as part of a form. Is now possible translate form labels using i18n files. For example, when modelling your form you can now add a label such as `FORM.FIRSTNAME`. In your `en.json` this would be: ```json { "FORM": { "FIRSTNAME": "First Name", "LASTNAME": "Last Name" } } ``` and in your `it.json`: ```json { "FORM": { "FIRSTNAME": "Nome", "LASTNAME": "Cognome" } } ``` Your app will now change the label of the form using the translations files. ### Form validation [`Form`](../../lib/process-services/src/lib/task-list/models/form.model.ts) validation will now display whether a form is valid or invalid. ### Form variables [`Form`](../../lib/process-services/src/lib/task-list/models/form.model.ts) variables can now assigned to forms. When creating an application that contains a form, variables can be assigned and will correctly display as the appropriate values when the form is launched. ### REST source for dropdown menu on forms It is now possible to create a form that contains a dropdown widget that is configured to use a REST Service to populate its values. ### Date format localization Date formats can now be localized in ADF. By default all dates are localized to `en-US`. This can be changed by adding the localization files provided by Angular. For more information refer to the [internationalization user guide](../user-guide/internationalization.md) All components have also been refactored to use the same date format and we have created a new [localized date pipe](../core/pipes/localized-date.pipe.md) to format dates and change locales. ## Localisation This release includes: Arabic, Brazilian Portuguese, Czech, Danish, Dutch, Finnish, French, German, Italian, Japanese, Norwegian (Bokmål), Polish, Russian, Simplified Chinese, Spanish and Swedish versions. ## References The following is a brief list of references to help you get started with 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](https://support.hyland.com/p/alfresco) for further details and suggestions. ## Issues addressed The following is the list of JIRA issues that were closed for this release:

Feature

Story

Bug

Task

Feature Documentation

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.