Return to Builder Network Home

Alfresco Application Development Framework, version 1.9.0 Release Note

These release notes provide information for the 1.9.0 release of Alfresco Application Development Framework.

This is the next Limited Available release of Application Development Framework, containing the Angular components to build a Web Application on top of the Alfresco Services. The release can be found on GitHub at this link.

Contents

Goals for this release

In the ADF 1.9 release we've enhanced a number of components, such as Document List, Viewer and Breadcrumbs. We continue the effort to migrate to @angular/material, only a few more components remain until we are fully switched to Angular Material Design. Again in this release we have enhanced the accessibility and we have started to consolidate, streamline and enhance our documentation. Before everything was inside the individual README.md files, this has now been pulled out into a separate directory, and a new Doc Index to help navigate it.

This is the last LA release, we are targeting ADF 2.0 by the end of November at which point it will become General Available and fully supported by Alfresco. As part of this effort we have increased the efforts on resolving bugs and stabilisation.

This release builds on last month's contains bug fixes and the new features. See the list below for major details.

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.

Notable new features

Below the most relevant features of this release:

  • Infinite scrolling
  • Requeue option added to adf-task-header
  • Tasklist now support multi-select
  • Page title service
  • Viewer enhancements
  • Document List presets
  • Login redirect options
  • Logout directive
  • Breadcrumb enhancements
  • Documentation

1.Infinite scrolling

The document list now provides two different way to paginate the results the normal pagination or the infinite scrolling. In order to enable this feature, you need to specify the paginationStrategy properties 'Infinite'. The infinite scrolling is also now used as default in the object picker component

2.Requeue option added to adf-task-header

The requeue feature has been added into the ADF 1.9.0. This means that after a task has been claimed by the user, the user will see a button Requeue to un-claim the task.

Unclaim the task

3.Tasklist multi-selection support

With the latest code, the tasklist component exposes the multiselect property. If the value is true a checkbox is rendered at the beginning of each row. In this way, the user can select more than one row.

<adf-tasklist
    [multiselect]="true"
    [appId]="'1'"
    [state]="'open'"
    [assignment]="'assignee'">
</adf-tasklist>

This is the result:

Tasklist multiselection

The component also provides a new event rowSelected that contains all the selected rows:

<adf-tasklist
    [appId]="'1'"
    [state]="'open'"
    [assignment]="'assignee'"
    (rowsSelected)="console.log($event)">
</adf-tasklist>

task list rowsSelected

4.Page Title Service

The 1.9.0 version features a new service "PageTitleService" in the "ng2-alfresco-core" package. This service allows changing the title of the page (browser tab) on demand from the code. The format of the title is always "<Application Name> - <Title>" where "<Application Name>" is taken from the application configuration file:

{
  "application": {
    "name": "Alfresco ADF Appplication"
  }
}

5.Viewer Enhancements

Viewer component has been updated with improved UI and support for integration with Angular Router. The major features and improvements are:

  • New toolbar component for all Viewer types
  • Automatic PDF rendition fetching for various content types (".docx", ".pptx", etc.)
  • Floating action toolbar for the PDF viewer

6.Document List Presets

It is now possible to store layouts for Document List in the global application configuration file ("app.config.json") for default mode or special aliases like "-trashcan-", "-favorites-", etc. The DocumentList component automatically falls back to the defaults if no customizations are present.

{
    ...,

    "document-list": {
        "supportedPageSizes": [5, 10, 15, 20],
        "presets": {
            "-trashcan-": [
                {
                    "key": "$thumbnail",
                    "type": "image",
                    "srTitle": "ADF-DOCUMENT-LIST.LAYOUT.THUMBNAIL",
                    "sortable": false
                },
                {
                    "key": "name",
                    "type": "text",
                    "title": "ADF-DOCUMENT-LIST.LAYOUT.NAME",
                    "cssClass": "full-width ellipsis-cell",
                    "sortable": true
                },
                {
                    "key": "path",
                    "type": "location",
                    "title": "ADF-DOCUMENT-LIST.LAYOUT.LOCATION",
                    "format": "/files",
                    "sortable": true
                },
                {
                    "key": "content.sizeInBytes",
                    "type": "fileSize",
                    "title": "ADF-DOCUMENT-LIST.LAYOUT.SIZE",
                    "sortable": true
                },
                {
                    "key": "archivedAt",
                    "type": "date",
                    "title": "ADF-DOCUMENT-LIST.LAYOUT.DELETED_ON",
                    "format": "timeAgo",
                    "sortable": true
                },
                {
                    "key": "archivedByUser.displayName",
                    "type": "text",
                    "title": "ADF-DOCUMENT-LIST.LAYOUT.DELETED_BY",
                    "sortable": true
                }
            ],

            "default": [
                ...
            ]
        }
    }
}

7.Login redirect options

The Login component provides a new successRoute property as a way to automatically redirect the user to the particular application route upon successful sign in.

<adf-login successRoute="/dashboard" ...></adf-login>

8.Logout directive

You can turn any clickable HTML element or other Angular Component into a Logout feature. ADF provides a new adf-logout directive to help you building application menus or toolbar buttons that sign the user out:

<button adf-logout>Log out</button>

9.Breadcrumb enhancements

The Breadcrumb component exposes a new rootId property to allow you restricting the root element to a particular node. Component automatically trims the elements if full node path needs to be cut. You can use this together with the root property that allows renaming the root (first) element of the path.

<adf-breadcrumb root="Personal Files" rootId="<GUID>" ...></adf-breadcrumb>

10.Documentation

All the documentation was inside the individual README.md files of any components, this has now been pulled out into a separate directory, and a new Doc Index to help navigate it.

References

Below you can find a brief list of references to help you start to use the new release.

Official GitHub Project - alfresco-ng2-components

Getting started guides with Alfresco Application Development Framework

Component catalog

Gitter chat supporting Alfresco ADF

ADF examples

List of all components

Alfresco-JS-API

ADF App Generator

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

Issues addressed

Below you can find a detailed list of tickets addressed in the new release. For a better understanding, the list is grouped by topic.

Release Notes - Apps Development Framework - Version 1.9.

Documentation

  • [ADF-1603] - remove all the reference to deprecated <template> from the documentation

Feature

  • [ADF-226] - No 'Requeue' option after claiming a task. - 1599 Github
  • [ADF-1531] - Enhance document list breadcrumb with an input option to provide custom root id.
  • [ADF-1574] - Info Drawer - Add a mechanism to know the current active tab
  • [ADF-1609] - Tasklist - Provide a Multi selection property
  • [ADF-1622] - Provide ability for components to change browser page title.
  • [ADF-1623] - Integration of Viewer with Router
  • [ADF-1632] - Task Header - Parent name default value should be None

Bug

  • [ADF-1012] - The checklist delete button of a completed task is displayed
  • [ADF-1259] - Process Filter - Wrong process filter is selected when a new process is created
  • [ADF-1291] - [Attachment list] after upload list is not instantly refreshed
  • [ADF-1338] - Document list should automatically be refreshed after undoing/cancelling a file upload.
  • [ADF-1364] - The pagination is not properly displayed when moving a file or folder
  • [ADF-1444] - File name is not fully displayed.
  • [ADF-1455] - When an app has a long name, is displayed under the logo.
  • [ADF-1467] - ADF components custom theming
  • [ADF-1478] - Pagination is not properly displayed when resizing the browser window.
  • [ADF-1479] - Pagination is not working properly on Document List.
  • [ADF-1488] - Document List does not reset selection on "node" change
  • [ADF-1493] - Cannot tab in menu option within file/folder
  • [ADF-1503] - Completed process and task displays, can still upload content
  • [ADF-1506] - Upon node deletion the toast message shows guid
  • [ADF-1516] - Date widget is swapping days with months.
  • [ADF-1520] - Advanced date widget doesn't display the correct date.
  • [ADF-1521] - Display value fields configured with process variables are not rendered in ADF 1.8.
  • [ADF-1523] - APS task form remains disabled when no custom outcome is provided in ADF 1.8.
  • [ADF-1525] - In APS forms, hyperlink fields are not rendered when configured with process variables
  • [ADF-1526] - The form component is not responsive in ADF 1.8.
  • [ADF-1528] - Form renderer does not display generated documents - github 2303
  • [ADF-1529] - Broken styles for toolbar buttons.
  • [ADF-1530] - [Viewer] Extension viewer doens't work anymore
  • [ADF-1533] - Multi-line form field contains a bug where red required warnings are shown incorrectly
  • [ADF-1535] - Wrong StatusEnum implementation for Rendition
  • [ADF-1537] - People widget needs to check null for native element onAfterViewInit
  • [ADF-1538] - PDF viewer causes memory/cpu issues with scroll events
  • [ADF-1545] - Supported page sizes are hardcoded for Document List pagination
  • [ADF-1547] - Column tooltips are not translated for DataTable/DocumentList
  • [ADF-1553] - [Demo shell] Scroll present in small and x-small devices
  • [ADF-1554] - People widget with visibility conditions is not displayed on a complete start event.
  • [ADF-1555] - Search popup always stays on the screen
  • [ADF-1557] - Search does not collapse if its input is focused
  • [ADF-1559] - People control is referencing the rest api instead of enterprise for pictures
  • [ADF-1560] - Process fields are not translated when starting a process and on process page
  • [ADF-1561] - When clicking on 'Active Tasks' on Process it redirects always to the first task from 'My Tasks' list
  • [ADF-1562] - Report list is not aligned.
  • [ADF-1565] - Not able to delete/copy/move a file or a folder in Document List
  • [ADF-1568] - IE 11 problems with upload and downloading
  • [ADF-1569] - [Activiti Form] People widget doesn't' render all the users image
  • [ADF-1570] - [Start task] Date component is not aligned
  • [ADF-1573] - Not able to remove a user from the "Involved People".
  • [ADF-1577] - 'No process details found.' message is displayed after cancelling a process
  • [ADF-1580] - Widgets do not display values on a start event.
  • [ADF-1581] - Settings login are update also when press the back button
  • [ADF-1582] - Error/Required widget tooltips are not aligned.
  • [ADF-1583] - Expression has changed after it was checked
  • [ADF-1585] - [Document list/Data table] hover color style is not theme compatible
  • [ADF-1590] - Cursor pointer is not displayed on expand/collapse Task and Process Filters.
  • [ADF-1594] - Date widget does not display value on a complete start event.
  • [ADF-1595] - Typeahead does not display value on a complete start event.
  • [ADF-1597] - Dropdown does not display the value in readonly mode
  • [ADF-1598] - 508 Fixes comments
  • [ADF-1610] - [Task List] doesn't allow keyboard enter to select a task- 508 Issue
  • [ADF-1611] - Toolbar doesn't react to the resizing
  • [ADF-1615] - Datatable - The ellipsis class doesn't work for a custom template
  • [ADF-1617] - The bottom part of any input box text is cut off
  • [ADF-1618] - Default login dialog has problem displaying validation message
  • [ADF-1621] - ECM Auth Guard does not always redirect to login
  • [ADF-1624] - Typeahead displays the list number of the name.
  • [ADF-1625] - Typeahead widget is not aligned
  • [ADF-1626] - [Task List] User should press TAB twice to navigate through the tasks
  • [ADF-1627] - [Process List] doesn't allow keyboard enter to select a process
  • [ADF-1628] - Content from a page is still selected when navigating to a different page when 'Multiple' Selection Mode is selected
  • [ADF-1629] - Console throws error if visibility conditions refer to a following widget.
  • [ADF-1630] - Folder name should be abbreviated in the breadcrumb when path is too long
  • [ADF-1631] - The bottom part of Search Bar text is cut off
  • [ADF-1636] - Translation override file is not overriding translation labels
  • [ADF-1637] - [Pagination] Select Page Dropdown is not working
  • [ADF-1638] - Console displays error after completing a task.
  • [ADF-1640] - Start form is blank after a complete process.
  • [ADF-1642] - [Login component] error message change the size of the component
  • [ADF-1643] - [Checklist] add checklist produce a consolo error
  • [ADF-1644] - Search Icon is not properly displayed
  • [ADF-1646] - [Settings] prefix icon is not aligned
  • [ADF-1651] - Site List drop down from Document List component does not display all sites
  • [ADF-1653] - Suggestion list on people widget is still displayed after deleting all letters inside the input
  • [ADF-1654] - Cannot add a checklist within a task.
  • [ADF-1662] - [User info] name is not centered
  • [ADF-1664] - [Login component] icon show password dark theme
  • [ADF-1666] - Comments can not be added to completed tasks and processes
  • [ADF-1667] - Form component displays 'Nameless Task'
  • [ADF-1668] - The task or process details are not loaded when double clicked
  • [ADF-1669] - Attach File widget doesn't display file after complete.
  • [ADF-1671] - Widgets don't display value if they have visibility conditions related to multiline text widget.
  • [ADF-1674] - [Form Component] Ammount prefix should be aligned
  • [ADF-1675] - Cannot view a file on a complete start event.
  • [ADF-1677] - Pagination is not working properly on 'Sites' Custom Sources page
  • [ADF-1685] - Sometimes the task list is not loading after logout
  • [ADF-1687] - Profile picture icon is not displayed anymore on process comments after refreshing the page

New Feature

  • [ADF-1090] - Expand access to validation of the DynamicTableWidget - 2082 Github
  • [ADF-1477] - Automatic i18n support for breadcrumb root element
  • [ADF-1522] - Load Document List presets from the app.config file
  • [ADF-1524] - Provide support for route to redirect on successful Login
  • [ADF-1613] - Logout directive

Task

Feature (Task)

  • [ADF-1534] - Automatic PDF rendition loading for Viewer Dialog
  • [ADF-1542] - Toggle all toolbar elements in the Viewer Dialog from code

Please refer to the Alfresco issue tracker for other known issues in this release. If you have more questions, please reply here or contact us using gitter.

Github iconEdit on github

© 2023 Alfresco Software, Inc. All Rights Reserved.