Application Development Framework ADF Documentation Release notesRelease notes v3.4.0

Alfresco Application Development Framework (ADF) version 3.4.0 Release Note

These release notes provide information about the 3.4.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.

New package versions

"@alfresco/adf-content-services" : "3.4.0"
"@alfresco/adf-process-services" : "3.4.0"
"@alfresco/adf-core" : "3.4.0"
"@alfresco/adf-insights" : "3.4.0",
"@alfresco/adf-extensions": "3.4.0"

Goals for this release

This is the fourth minor release of ADF since February 2019 when version 3.0.0 was released.

The highlights of this release include additional support for Activiti 7 and an Angular Material upgrade.

Further enhancements have been made to forms in this release including improvements to form field visibility and the ability to attach forms to standalone tasks. End users can now also take advantage of the preference service to store custom filters for task and process lists and have them accessible between different sessions and devices.

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 field visibility

Visibility conditions form fields has been enhanced to cover additional use cases within the Modeling Application. In this release of ADF the relevant components have been updated to support this new set of capabilities.

Preference service

The edit process filter cloud component and edit task filter cloud component were introduced in a previous release of ADF to support custom filters for end users. The limitation of the components was that the filters were stored in a user's local browser storage and only available until that session expired.

In this release a server side preference service now stores that information, so that task and process list filters can be stored on a user-by-user basis and be made available between sessions and devices.

Note This functionality is not available in the community edition, Activiti Cloud. Custom filters are still stored in the local browser storage for community implementations.

Forms in standalone tasks

Forms can now be used in standalone tasks and not just those that form part of a user task within a process. To be able to use a form in a standalone task, the modeler needs to explicitly allow it during its design.

The following is an example JSON of a form definition with the new boolean property standAlone which toggles whether the form is available to attach to standalone tasks:

{
    "formRepresentation": {
        "id": "form-5601d74a-77b6-4fc5-88b3-3bdcd1e914cc",
        "name": "holiday-request-form",
        "description": "A form to request leave",
        "version": 2,
        "standAlone": true,
        "formDefinition": {
        ...

Angular and Material upgrade

ADF has been updated to :

- @angular/material*  7.3.7
- @angular/* 7.2.15

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:

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:

Documentation

[ADF-4776] - Release note for version 3.4.0
[ADF-4777] - Creating the npm audit report for ADF 3.4.0
[ADF-4778] - Generate the list of third party Open Source components for 3.4.0

Feature

[ADF-4461] - Form Cloud - Refactor the formService and split validation responsibility
[ADF-4590] - Cloud start task - Change the model
[ADF-4694] - Not able to attach multiple files from ACS repository with an attach file widget
[ADF-4699] - Allow a form to be used (or not used) in standalone tasks
[ADF-4731] - [Process - Cloud] - Improve IdentityUserService
[ADF-4755] - [CardViewDate&SelectItemComponent] Provide a way to reset date and add None option as default.

Story

[ADF-4614] - User preferences in process filters
[ADF-4711] - User preferences in task filters
[ADF-4713] - Number formatting for ADF based applications

Bug

[ADF-4041] - People Cloud Component - preselected values not working to be filtered by username
[ADF-4314] - [Process - Cloud] - can not claim a process task without any assignee
[ADF-4424] - Password dialog does not close when pressing Escape
[ADF-4480] - Viewer shows endless spinner for unsupported files
[ADF-4574] - The form variable value is not displayed in a display value widget
[ADF-4635] - [APA] - The Status drop-down is looking different for Processes than for Tasks
[ADF-4682] - The Date is not saved correctly on Process-services form.
[ADF-4696] - "Ownable" and "Lockable" aspect Owner property is incorrectly displayed
[ADF-4704] - Unreliable unit tests - StartProcessCloudComponent
[ADF-4709] - Fix travis run on the App Generator
[ADF-4715] - Fix filter processes - remove CREATED status
[ADF-4716] - Dynamic Table not working properly (regression)
[ADF-4717] - Unreliable e2e tests - process-filter-results.e2e.ts
[ADF-4720] - FormFieldModel - Error loaded: TypeError: Cannot read property 'find' of undefined
[ADF-4721] - Date not properly displayed in date picker and date time picker
[ADF-4722] - Wrong date is displayed when updating row of dynamic table
[ADF-4726] - File Size header not aligned with cell content below
[ADF-4729] - AboutComponent - doesn't work in case the versions.json is in a subdomain
[ADF-4732] - Breadcrumb folder names do not shrink when path is too long to fit the screen
[ADF-4754] - Fix Date related e2e tests on ADF
[ADF-4756] - Fix Content services e2e tests
[ADF-4758] - Can not complete a task that has an invisible field on a form with a value
[ADF-4765] - The form rendering components should not consider text and date as equals when they both have same value
[ADF-4774] - Field remains visible when having visibility condition of 2 checkboxes that are not equal
[ADF-4775] - Form date fields - Incorrect validation for date fields - Only YYYY-MM-DD date display format is working
[ADF-4782] - Visibility condition chaining is not working on ADF
[ADF-4788] - Form with Date widget with assigned process variable failing to complete
[ADF-4790] - Field is visible when visibility condition between a checkbox field and a value/variable is false
[ADF-4791] - Form - Visibility conditions not working correctly when comparing two empty fields
[ADF-4792] - Unable to instantiate a basic process instance with the attached project.
[ADF-4793] - The filters don't work on community-edition.
[ADF-4795] - The form is editable after completing the task in aps1.
[ADF-4800] - The datetime is saved an hour less when completing a form task in Process Services APS1

Task

[ADF-4026] - Implement edit process filters automated tests
[ADF-4426] - Move CSS overrides from ACA to ADF - 2nd round
[ADF-4448] - Automate - Should be able to start a task with a form
[ADF-4457] - Clear AppConfigService from StorageService (and static import of app.config.json?)
[ADF-4592] - Remove e2e tests that are automating "demo shell" features
[ADF-4594] - Disable Animations Module for e2e testing
[ADF-4642] - Add unit test to test the typeahead filtering unit test on start process cloud.
[ADF-4647] - Implement Download Service
[ADF-4660] - Automate ADF-3883 - Testing the various Process Filter results.
[ADF-4671] - Automate - C311277 Start Process Cloud - Should be able to start a process with a form as start event
[ADF-4684] - Content Metadata Card dates should be localised
[ADF-4687] - Automate C311280 - Task header cloud component will pick up the default date format specified in the app configuration
[ADF-4697] - Automate - attach content to process-cloud task form using upload widget.
[ADF-4698] - Automate C311296 - Should be able to attach single or multiple files through externally defined content link
[ADF-4705] - [Testing]Automate forms manual test cases for checkbox widget
[ADF-4707] - ContentNodeSelectorComponent Search doesn't include Properties
[ADF-4710] - Apply the new VisibilityCondition format in ADF components
[ADF-4733] - AdfCli - Create a dispatcher command to run commands
[ADF-4734] - Update documentation for task list and process list filters
[ADF-4737] - Use local fonts when running e2e tests and demo shell
[ADF-4745] - Review and fix subscription/memory leaks
[ADF-4746] - AdfCli - Create a command for kubectl
[ADF-4747] - [Testing]Change the file used for automation tests on ADF for form visibility on cloud
[ADF-4773] - [ADF-E2E] Fixing failing tests in Process Services Cloud
[ADF-4784] - Release 3.4 - Translation keys
[ADF-4786] - AdfCli - Expose a kubectl command to delete pods based on label

Feature (Task)

[ADF-4701] - Upgrade angular material to latest non-breaking change version - 7.3.7
[ADF-4735] - Automation test visibility condition for APS1

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.

Edit on github