Alfresco Application Development Framework (ADF) version 3.0.0 Release Note
These release notes provide information about the 3.0.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.
If you want to be updated on the ADF roadmap, check the public page here.
This is a major release of the Alfresco Application Development Framework, developed to speed up the applications running in production environments, thanks to a porting of the JS-API to Typescript. All the benefits of Extensibility, initially introduced in Alfresco Content Application (ACA) and the Alfresco Digital Workspace (ADW), are now available at the framework level and more enhancements are planned to be introduced in the following releases.
This new major version of ADF has been updated to the latest and greatest Angular 7, together with a first iteration of support for Activiti 7, the next generation Cloud Native implementation of Activiti. Also the Yeoman App Generator has been updated to let you create five small Angular CLI based applications to help get you started: one on content only, two on process only (using APS 1.6.4 or higher or using Activiti 7), two on content and process.
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.
Below are the most important new features of this release:
Extensibility was first introduced into the Alfresco Content Application (ACA) and the Alfresco Digital Workspace (ADW), and has now been moved to the main ADF framework, for the benefit of all developers.
The home of extensibility support in the framework is the @alfresco/adf-extensions library. Check the documentation here for further details on how to add extension features to any ADF application.
Search enhancement
Grouped facet queries
By default, the queries declared in the facetQueries are collected into a single collapsible category.
This new functionality lets you group different facet queries under custom labels by using the group property on those facet queries:
You can now choose to filter facet field results using 'contains' instead of 'starts with', by using the filterWithContains boolean property (default is false):
{
"search": { "filterWithContains": true }
}
Single Sign On enhancement
SSO ticket fix
In order to make the SSO work completely with the new ACS 6.1.0, a new exchange token for alf_ticket mechanism has been introduced via a new flow in the JS-API that performs this operation.
For more details about this issue please refer to the this JIRA ticket.
withCredential
The withCredentials property has been added as a configuration Boolean parameter in the JS-API and in ADF.
This indicates whether or not cross-site Access-Control requests should be made using credentials.
This configuration is usually needed when you are dealing with Kerberos.
The Alfresco JS-API layer has been rewritten in TypeScript. Note that the output of the project is still JavaScript code so you can use in the usual way.
This rewrite has been necessary to make the JS-API lighter and faster with the following benefits:
Tree-shakable.
Strong typing enhances code quality and readability.
In the JS-API project, it is now easier to generate new code thanks our code generator template.
TypeScript already provides a number of features that are planned for future version of JavaScript.
Intellisense in your IDE will now work much better with the JS-API
Note that the following old package names have been deprecated: alfresco-js-api, alfresco-js-api-node.
The Node and Browser version are now both in: @alfresco/js-api
Refer to the official Alfresco JS-API documenation to learn more about this.
Angular 7
Alfresco ADF 3.0.0 has been updated to version 7.0.3 of Angular and Material.
Refer to the official project CHANGELOG files to find out what's new inside:
Following the SEMVER 2.0 strategy, ADF 3.0.0 introduces breaking changes only in major versions like this one. For this reason, all the features, components and services, marked as deprecated in ADF 2.X, have been removed.
Activiti 7 support (Experimental)
From ADF 3.0.0, Alfresco is excited to announce ADF support for Activiti 7. This is a first iteration and more coverage of the services will be added in the following versions of ADF. This is the reason why this support is marked as experimental for this release. The next release (3.1) plans on moving from experimental to standard ADF components with more complete coverage.
This ADF release introduces a collection of brand new components re-designed and implemented from scratch for Activiti 7.
Below is a list of all new components services and pipes added along with
links to documentation and source code:
Universal icon component that supports Material Ligatures and custom registered SVG icons in the same format.
<!-- Font ligature --><adf-iconvalue="alert"></adf-icon><!-- ADF Thumbnail Service --><adf-iconvalue="adf:image/png"></adf-icon><!-- Custom icon from MatIconRegistry --><adf-iconvalue="my-company:my-icon"></adf-icon>
[ADF-3941] - Settings Page - SSO -> Identity Host is not visible when open the page for the first time
[ADF-3956] - [Start Task Cloud] - Fields are not properly alligned
[ADF-3964] - "No results found" is not displayed when no results are found in Search
[ADF-3965] - [Settings Page] - Incorrect label for Client ID - "Client IDd"
[ADF-3966] - [Login SSO] - The page is refreshed twice after login using SSO configuration
[ADF-3974] - Uploading and downloading a document in tasks detais component using the attach document control results in the downloaded file being corrupt
[ADF-3975] - Fix TASK_FILTER_PROPERTY_KEYS and PROCESS_FILTER_PROPERTY_KEYS Property in app.config
[ADF-3997] - People/Group Cloud Demo should update the preselected changes
[ADF-3999] - Card view layout for metadata is messed up
[ADF-4001] - StartProcessCloud - not assign a name to a process
[ADF-4005] - [Demo-Shell] Status column is called 'Name' column
[ADF-4010] - ADF icon "folder" clashes with Material one
[ADF-3870] - Automation test for facet field filter with contains
[ADF-3872] - Add the posibility in configuration editor to change the default columns of adf-process-list-cloud
[ADF-3884] - Create automation tests for Start Process
[ADF-3886] - Automation test for hyperlink navigation
[ADF-3900] - Create automated tests for Universal Icon Component
[ADF-3933] - Implement automated tests for task header cloud
[ADF-3951] - Automate tests to check the upload tooltips
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.
We use cookies on this site to enhance your user experience
By using this site, you are agreeing to allow us to collect and use cookies as outlined in Alfresco’s Cookie Statement and Terms of Use (and you have a legitimate interest in Alfresco and our products, authorizing us to contact you in such methods). If you are not ok with these terms, please do not use this website.