alfresco-ng2-components/docs/release-notes/RelNote330.md

Title

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.

See the ADF roadmap for details of features planned for future versions of ADF.

Contents

• New package versions
• Goals for this release
  • Form field visibility
  • Start a process with a form
  • Multilingual support for forms
  • Form validation
  • Form variables
  • REST source for dropdown menu on forms
  • Date format localization
• Localisation
• References
• 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, the next generation Cloud Native implementation of Activiti.

The functionality and enhancements of this release are focused on forms. Form 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. You can collaborate on this release or share feedback by using the discussion tools on Gitter.

The following are the most important features of this release:

• Form visibility
• Start a process with a form
• Multilingual support for forms
• Form validation
• Forms variables
• REST source for dropdown menu on forms
• Date format localization

Form field visibility

Form 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:

<adf-cloud-start-process 
     [appId]="YOUR_APP_ID"
     [variables]="{ 'my-key1' : 'myvalue', 'my-key2' : 'myvalue2'}">
</adf-cloud-start-process>

It is also possible to start a process with a form and pass in the form values at the same time:

<adf-cloud-start-process 
     [appId]="YOUR_APP_ID"
     [values]="[{'name': 'firstName', 'value': 'MyName'}, {'name': 'lastName', 'value': 'MyLastName'}]">
</adf-cloud-start-process>

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:

{
  "FORM": {
    "FIRSTNAME": "First Name",
    "LASTNAME": "Last Name"
  }
}

and in your it.json:

{
  "FORM": {
    "FIRSTNAME": "Nome",
    "LASTNAME": "Cognome"
  }
}

Your app will now change the label of the form using the translations files.

Form validation

Form validation will now display whether a form is valid or invalid.

Form variables

Form 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

All components have also been refactored to use the same date format and we have created a new localized date pipe 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
• Alfresco ADF Documentation on the Builder Network
• Gitter chat supporting Alfresco ADF
• ADF examples on GitHub
• Official GitHub Project - alfresco-ng2-components
• Official GitHub Project - alfresco-js-api
• Official GitHub Project - generator-ng2-alfresco-app

Please refer to the official documentation for further details and suggestions.

Issues addressed

The following is the list of JIRA issues that were closed for this release:

• [ADF-4618] - Update the tutorial on RTL languages support
• [ADF-4653] - Creating the npm audit report
• [ADF-4655] - Review the documentation for the release
• [ADF-4656] - Release note for version 3.3.0
• [ADF-4657] - Tutorial on how to upgrade from ADF 3.2.1 to ADF 3.3.0
• [ADF-4658] - Update the compatibility matrix
• [ADF-4659] - Generate the list of third party Open Source components

Feature

• [ADF-3126] - Automatic translation support for Info Drawer
• [ADF-4127] - Claim a task on the new generation of BPM engines
• [ADF-4342] - Date Format in ADF should be centralised
• [ADF-4349] - Cloud - task-form-component - Create a new component
• [ADF-4527] - Create a reusable HTML block for the buttons in the task form cloud component
• [ADF-4543] - Language Menu - set text orientation
• [ADF-4544] - Cloud Task From - Refresh the buttons and form after an action is complete
• [ADF-4545] - Context Menu - RTL support
• [ADF-4550] - Get the repository from the Process Storage instead of the app.config.jsonTask
• [ADF-4558] - Dialogs - RTL support
• [ADF-4631] - Start Process Cloud - Ability to start a process with a form as start event

Story

• [ADF-4375] - Simplifying the development of ADF Extensions
• [ADF-4377] - Simplifying the deployment of ADF Extensions
• [ADF-4484] - Quick themable Snackbar notifications

Bug

• [ADF-1559] - People control is referencing the rest api instead of enterprise for pictures
• [ADF-3192] - [Form] - The fields are not properly aligned
• [ADF-4034] - Task list cloud - The Deleted task is changing the Status from "Deleted" in "Canceled"
• [ADF-4041] - People Cloud Component - preselected values not working to be filtered by username
• [ADF-4137] - PeopleCloudComponent - Use new translation key for search label
• [ADF-4268] - Unable to change any other property in the Info drawer for any other file after trying to change the name to one with special characters
• [ADF-4293] - The date is not displayed properly when rtl is enabled
• [ADF-4314] - [Process - Cloud] - can not claim a process task without any assignee
• [ADF-4338] - [Process-service-cloud] - TaskHeaderCloudComponent is using wrong date format
• [ADF-4364] - The user is infinitely redirected to the file opened in viewer when clicking on close icon
• [ADF-4408] - Setting copyContent to false on datatable cell html is not working as expected
• [ADF-4466] - There are alignment issues in IE11 browser for Multiselect checkboxes.
• [ADF-4467] - Upload File Widget layout issue
• [ADF-4468] - FormCloud - Not able to show a value of a form variable
• [ADF-4469] - Changing the name of a file to an already existing one in the Metadata info dialog, errors in console.
• [ADF-4473] - Cloud Task Header - Priority should take only integer values
• [ADF-4474] - Coud Form - Unable to submit form with date value
• [ADF-4476] - Cloud start task and start process have different styles
• [ADF-4478] - Layout container overflowing
• [ADF-4488] - FormCloud - Not able to render a dropdown with a RestService bind
• [ADF-4489] - Error should appear in the info drawer when trying to add illegal characters in the Name field
• [ADF-4495] - Remove Alfresco Dependencies script not working properly on Linux Machine
• [ADF-4498] - StickyHeader should be disabled when there is no header.
• [ADF-4530] - The multiple process definitions in the app are not displayed in the dropdown when creating a new Process instance.
• [ADF-4531] - The typeahead and filtering based on context doesn't work for the 'Select Process' dropdown in cloud.
• [ADF-4546] - Visibility conditions for Form variables don't work on Multiline Widget.
• [ADF-4548] - The place holder text for the Dropdown widget is not displayed.
• [ADF-4552] - Rating component not working properly
• [ADF-4564] - Yeoman's template for Activiti Cloud contains hardcoded URLs
• [ADF-4569] - Fix smart build script
• [ADF-4578] - Language Menu - list shows 2 Arabic entries
• [ADF-4585] - Can't save the form or complete the task when the dropdown has a value saved from rest response.
• [ADF-4586] - DropdownCloud - form not preselecting the saved option
• [ADF-4588] - Copy content not showing correctly for ellipsis cell
• [ADF-4596] - Assignee field in start task is not translated to any other language
• [ADF-4597] - Demo shell is not translated Czech when the app language is changed to Czech
• [ADF-4612] - The linting is not working correctly in "npm-build-all.sh" script
• [ADF-4623] - Document List row shows "name" instead of metadata
• [ADF-4625] - Search Input does not respect RTL mode
• [ADF-4626] - Breadcrumb does not respect RTL
• [ADF-4634] - [APA] - Different statuses should load for Tasks than for Processes
• [ADF-4636] - Datatable background only takes table height, not the entire datatable
• [ADF-4637] - Login/Logout Bug from Applications/ADF
• [ADF-4640] - Consumer / Contributer can not unshare a file that he shared
• [ADF-4651] - Task form cloud not displayed
• [ADF-4661] - The 'Start process' and 'Cancel' button are displayed on left instead of right.
• [ADF-4665] - [ADF] - Application is refreshed when you have two instances of application opened
• [ADF-4667] - Document list sorting icon looks cut off in RTL
• [ADF-4674] - Validation isn't working in form-cloud
• [ADF-4677] - Date isn't displayed properly in DocumentList

Task

• [ADF-4054] - GroupCloudService - Use composite api to fetch group roles
• [ADF-4232] - e2e - filePreviewPage - expect() calls are never reached
• [ADF-4288] - Automation task for ADF-3977
• [ADF-4378] - Creating the adf-extension schematic
• [ADF-4380] - Enhancing the compilation of plugins to make them dynamic
• [ADF-4389] - Manage the case of a process definition with name property set to null
• [ADF-4402] - Move component related styles from demo-shell to ADF components
• [ADF-4421] - Edit task filters excluded test fix
• [ADF-4442] - Create a configuration editor option to change the whole app.config.json
• [ADF-4462] - Create manual and automated test for Restore version does not refresh the document list
• [ADF-4477] - Add a check for end date for task header cloud tests
• [ADF-4482] - Automation tests for Social component
• [ADF-4490] - Create manual and automated tests for task-form cloud component
• [ADF-4496] - Share dialog should raise error notifications for unshare action
• [ADF-4503] - Check coverage for Number widget
• [ADF-4505] - Check coverage for Date widget
• [ADF-4506] - Check coverage for Dropdown widget
• [ADF-4507] - Check coverage for Amount widget
• [ADF-4508] - Check coverage for Radio button widget
• [ADF-4509] - Check coverage for Hyperlink widget
• [ADF-4512] - Check coverage for Display value widget
• [ADF-4513] - Check coverage for Display text widget
• [ADF-4514] - Move widgets pages to Testing package
• [ADF-4519] - Attach an ACS content to a form
• [ADF-4521] - Multilingual support for forms
• [ADF-4529] - Create method to automate the form editor page
• [ADF-4535] - [FIX E2E] people-group-cloud-component.e2e.ts
• [ADF-4536] - [FIX E2E] process-custom-filters.e2e.ts
• [ADF-4538] - [FIX E2E] start-task-custom-app-cloud.e2e.ts C297675
• [ADF-4540] - [FIX E2E] Task-list-properties.e2e.ts C297480 C297486 C297691
• [ADF-4541] - [FIX E2E] task-form-cloud-component.e2e.ts C307095
• [ADF-4547] - Fix flaky e2e tests
• [ADF-4576] - Remove duplicate getDeployedApplicationsByStatus service
• [ADF-4579] - App Layout - RTL support
• [ADF-4582] - User preference - set layout orientation based on locale
• [ADF-4583] - Upload dialog - RTL support
• [ADF-4584] - Header RTL styling
• [ADF-4587] - Fix e2e tests
• [ADF-4601] - DemoShell - Side navigation RTL support
• [ADF-4614] - User Preference Service in Process Workspace
• [ADF-4633] - MatIcon directionality
• [ADF-4638] - Import the new i18n language
• [ADF-4639] - ADF CLI to create the third party licenses and npm audit report

Feature Documentation

• [ADF-4435] - Information about claim and unclaim buttons is missing from task form cloud component
• [ADF-4450] - Remove showSaveButton property from task form cloud component

Feature Bug

• [ADF-4309] - [Process-Cloud] - Standalone Task - Can not claim a task after releasing it
• [ADF-4311] - [Process-Cloud] - Incorrect label loaded for unclaim option -> "Resqueue" should be "Release"
• [ADF-4315] - [Process Cloud] - The unclaimed task remains in wrong status
• [ADF-4433] - The attached form is not displayed on a standalone task
• [ADF-4436] - The implementation related to claim, unclaim, complete shouldn't be part of form cloud component
• [ADF-4437] - showRefreshButton property shouldn't be part of task form cloud component
• [ADF-4439] - Validation icon is displayed even when the form has invalid values
• [ADF-4440] - Not able to see the form on a completed task
• [ADF-4441] - Save button should be disabled when form fields values are invalid
• [ADF-4443] - Able to complete a task that has invalid values on the form
• [ADF-4445] - showSaveButton property is missing from form-cloud component

Feature (Task)

• [ADF-4568] - Automate ADF-4269 - Task of a process cannot be completed if unassigned
• [ADF-4577] - Automate ADF-4389 - Should display the validation message when Process definition has name property set to null
• [ADF-4580] - Automate C309878
• [ADF-4600] - Automate - Should be able to filter groups based on composite roles
• [ADF-4604] - Fix process-filters-cloud
• [ADF-4607] - Fix task-list-properties
• [ADF-4609] - Fix task-form-cloud
• [ADF-4610] - Fix people-group-cloud-filter-component
• [ADF-4613] - Fix tag-component

Please refer to the Alfresco issue tracker for other known issues in this release. If you have any questions about the release, please contact us using Gitter.

Thanks to the whole application team and the amazing Alfresco community for the hard work.