Alfresco Governance Services functionality for end users is available, including record declaration and archival of files into long term storage. Alfresco Process Services processes and tasks can also be accessed and completed from Alfresco Digital Workspace.
The Alfresco Digital Workspace simplifies content management and provides comprehensive extensibility features for developers, using ADF, and allows them to easily and quickly create custom solutions for specific use cases.
The Alfresco Digital Workspace is automatically deployed as part of Alfresco Content Services using Helm charts or a Docker Compose file. You can also manually install Alfresco Content Services using standard war files and then configure the installation to include Alfresco Digital Workspace.
This documentation is also available in the following languages: Čeština [1], Dansk [2], Deutsch [3], Español [4], Français [5], Italiano [6], 日本語 [7], Bokmål [8], Nederlands [9], Polski [10], Português (Brasil) [11], Русский [12], Svenska [13], Suomi [14], 中文简体 [15].
See the following video for a quick introduction.
See what's new in this Alfresco Digital Workspace 1.6 release.
Alfresco Process Services functionality available in Alfresco Digital Workspace
You can now access Alfresco Process Services functionality in Alfresco Digital Workspace. You can create process definitions in Alfresco Process Services and use those within the Alfresco Digital Workspace. You can start processes, view and manage tasks as well complete them.
For more information see Process Services [20].
For more information on this release see the release notes in the Alfresco Support Portal [26].
It is recommended you familiarize yourself with the concepts of containerized deployment before working with Helm charts, and Docker. See Understanding containerized deployment [34] for more information.
http://<acsservername>:port
http://<appservername>:port/digital-workspace (digital-workspace being the name of the war file)
To disable Quickshare, set system.quickshare.enabled=false in the \tomcat\shared\classes\alfresco-global.properties file. For more information, see Using the alfresco-global.properties file [38].
http://<appservername>:8080/digital-workspace
http://<acsservername>:port
http://<appservername>:port/digital-workspace (digital-workspace being the name of the war file)
To disable Quickshare, set system.quickshare.enabled=false in the \tomcat\shared\classes\alfresco-global.properties file. For more information, see Using the alfresco-global.properties file [38].
http://<appservername>:8080/digital-workspace
Property | Sub-property | Example value | Description |
---|---|---|---|
adf-start-process | name | The default setting for this is %{processDefinition} - %{datetime}, which will produce, 'Capital Approval Process - Jun 17, 2020, 11:02:07 AM'. | The name of the process as it appears in Alfresco Process Services including the current days date and time. |
processDefinitionName | Capital Approval Process definition. | The name of the definition of the process you are using to create an instance. | |
adf-versions-manager | allowComments | true | Toggle version comments on/off. |
aosHost | "https://repository.domain.com/alfresco/aos" Note: Server address has to be
https.
|
Server address of the AOS endpoint. | |
application | name | "Digital Workspace" | Application name that will be shown in the header of the application and in the page/tab title. |
copyright | "© 2017 - 2020 Alfresco Software, Inc. All rights reserved." | Copyright text shown on the login page. | |
logo | "assets/images/alfresco-logo-flower.svg" | Path to the logo shown in the application header. | |
authtype | Basic | Determines the type of authentication. To use Single Sign-on mode you must change this property to OAuth. See Single Sign-On (SSO) [42]. | |
bpmHost | "https://processservices.domain.com:port" | Server address of Alfresco Process Services. | |
content-metadata | presets | Add custom aspects and properties to be shown in the information drawer. | |
custom | Add custom aspects and properties to be shown in the information drawer. | ||
ecmHost | "https://repository.domain.com:port" | Server address of Alfresco Content Services. | |
files | excluded | ".DS_Store", "desktop.ini", "Thumbs.db", ".git" | Restrict users from uploading certain types of files and folders by setting or extending the list of rules at the "files.excluded" path. |
Match-options, no case | true | Ensures that the exclusions are case insensitive. | |
allowDownload | true | Toggle downloads of versions on/off. | |
headerColor | #2196F3 | Value for the header background color of the application. | |
languagePicker | false | Enable manual language selection menu. | |
languages | key | "en" | Key for language picker menu options. |
label | "English" | Label to display in the language picker menu. | |
pagination | size | 25 | Set the default number of items to be displayed on a page. |
supportedPageSizes | 25, 50, 100 | Change the items available in the pagination control. | |
processService | "true" Note: You must include the quotation
marks.
|
Toggles the Alfresco Process Services plugin to be on/off. | |
search | include | Specify the node information returned by the API with the search results set. | |
sorting | Search result sorting options available, and which option is the default. | ||
filterQueries | Specify what content should, and shouldn’t be returned in the results set. | ||
facetFields | Allows the configuration of the search results filter options. | ||
facetQueries | Allows the configuration of the search results filter options. | ||
categories | Allows the configuration of the search results filter options. | ||
aca:fields | Specify the metadata fields that will be included in search queries. | ||
sideNav | preserveState | true | Remember the users choice of sidenav minimized or expanded. |
expandedSidenav | true | Side navigation expanded by default. | |
viewer.maxRetries | 2 | The preview mechanism used to view a file tries to open it and if its unsuccessful it waits 20 seconds and then tries again. The process involves converting the file (multiple file formats are supported depending on content type) and if it takes more than 20 seconds the system will say that the content isn't supported. This time out can be increased by adding a value for this property. If you enter 2 the wait time before time out will be 40 seconds. |
These features require Alfresco Governance Services, and for archival to long term storage, Alfresco Content Connector for AWS S3.
See the following video for a quick introduction to the new governance features.
Understanding records icons
These icons represent actions and states of your records and files.
Alfresco Governance Services icon | Alfresco Governance Services icon for small resolution monitors | Description |
---|---|---|
![]() |
Click the icon to declare a file as a record. | |
![]() |
![]() |
The file has been successfully declared as a record. |
![]() |
![]() |
The file has been rejected as a record. A message displays the reason why it was rejected. For example for having incomplete metadata. |
Archiving and retrieving your files is an important part of information governance. Archiving your files minimizes the cost of storage for infrequently accessed files or you may have a regulatory requirement to archive.
Use the right click menu in Digital Workspace to send your files to be archived. Once archived files are still visible and can also be retrieved using the right click menu.
Understanding archival icons
Archival icon | Description |
---|---|
![]() |
The file is archived. |
![]() |
Your file was archived and is currently being restored. The amount of time taken to restore your file depends on which retrieval type you selected. |
![]() |
Your files automatic restore time has been extended. |
These features require Alfresco Process Services to be configured with Alfresco Content Services.
If you are an administrator and want to create new processes in Alfresco Process Services for use in Alfresco Digital Workspace see Create your first process [45].
What can be entered into the form will be specific to your organization and the type of form in Alfresco Process Services.
Once the process starts you can view the running process by clicking View running process at the bottom of the window.
The headings are pre defined filters.
You can see all the tasks associated with that process.
The headings are pre defined filters.
Leveraging a powerful rules engine, developers can control the look and feel of the main areas of the application using pre-built rules or custom rules. For example, removing toolbar buttons based on permissions or group memberships.
For more in-depth documentation about extending Digital Workspace, see Extending [53].
When attempting to login a problem with CORS is reported.
Refer to CORS configuration [39] and Cross-Origin Resource Sharing (CORS) [40].
back to top [62]Can I customize Alfresco Digital Workspace?
Yes, there are a number of customizations available that can be configured in ../digital-workspace/app.config.json. See Configuring Digital Workspace [18] for more details. The application can also be extended using the ADF Extension framework. See Extending [53].
back to top [62]I have installed an extension and Alfresco Digital Workspace does not work.
First disable the extension and check Alfresco Digital Workspace works correctly. If this resolves the issue contact the extension developer for assistance.back to top [62]
Does Alfresco Digital Workspace work with Alfresco Governance Services?
Yes, Alfresco Digital Workspace supports Alfresco Governance Services. See Governance Services [19].
back to top [62]Does Alfresco Digital Workspace support Smart Folders?
Smart Folder access is supported but Smart Folders cannot be created in this application.
back to top [62]How do I setup SSL?
SSL configurations differ from one installation to the next. Here is one approach to the setup of NGINX using SSL, see https://nginx.org/en/docs/http/configuring_https_servers.html [63].
For information on generating self-trusted certificates for local testing and development purposes, see https://letsencrypt.org/docs/certificates-for-localhost/ [64].
back to top [62]
What browsers does Alfresco Digital Workspace support?
Alfresco Digital Workspace supports the following Evergreen browsers:
Is Single Sign-On (SSO) supported with Alfresco Digital Workspace?
Yes, Digital Workspace supports Single Sign-On with the Identity Service. See Alfresco SSO Guide [65] for more details.
Alfresco Digital Workspace does not support SAML Single Sign-On (SSO) for Alfresco Content Services. Users can login with their credentials using basic authentication, but SAML authentication must not be enforced.
See SAML Single Sign-On (SSO) for Alfresco Content Services [66] and Configuring SAML (SSO) settings for REST API using the Admin Console [67] for more.
back to top [62]While Alfresco has used commercially reasonable efforts to ensure the accuracy of this documentation, Alfresco assumes no responsibility for the accuracy, completeness, or usefulness of any information or for damages resulting from the procedures provided. Furthermore, this documentation is supplied "as is" without guarantee or warranty, expressed or implied, including without limitation, any warranty of fitness for a specific purpose.
Copyright 2020 by Alfresco and others.
Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Alfresco. The trademarks, service marks, logos, or other intellectual property rights of Alfresco and others used in this documentation ("Trademarks") are the property of Alfresco and their respective owners. The furnishing of this document does not give you license to these patents, trademarks, copyrights, or other intellectual property except as expressly provided in any written agreement from Alfresco.
The United States export control laws and regulations, including the Export Administration Regulations of the U.S. Department of Commerce, and other applicable laws and regulations apply to this documentation which prohibit the export or re-export of content, products, services, and technology to certain countries and persons. You agree to comply with all export laws, regulations, and restrictions of the United States and any foreign agency or authority and assume sole responsibility for any such unauthorized exportation.
You may not use this documentation if you are a competitor of Alfresco, except with Alfresco's prior written consent. In addition, you may not use the documentation for purposes of evaluating its functionality or for any other competitive purposes.
If you need technical support for this product, contact Customer Support by email at support@alfresco.com. If you have comments or suggestions about this documentation, contact us at docs@alfresco.com.
This copyright applies to the current version of the licensed program.
Links:
[1] https://docs.alfresco.com/adw-cs/concepts/welcome-adw.html
[2] https://docs.alfresco.com/adw-da/concepts/welcome-adw.html
[3] https://docs.alfresco.com/adw-de/concepts/welcome-adw.html
[4] https://docs.alfresco.com/adw-es/concepts/welcome-adw.html
[5] https://docs.alfresco.com/adw-fr/concepts/welcome-adw.html
[6] https://docs.alfresco.com/adw-it/concepts/welcome-adw.html
[7] https://docs.alfresco.com/adw-ja/concepts/welcome-adw.html
[8] https://docs.alfresco.com/adw-no-nb/concepts/welcome-adw.html
[9] https://docs.alfresco.com/adw-nl/concepts/welcome-adw.html
[10] https://docs.alfresco.com/adw-pl/concepts/welcome-adw.html
[11] https://docs.alfresco.com/adw-pt-br/concepts/welcome-adw.html
[12] https://docs.alfresco.com/adw-ru/concepts/welcome-adw.html
[13] https://docs.alfresco.com/adw-sv/concepts/welcome-adw.html
[14] https://docs.alfresco.com/adw-fi/concepts/welcome-adw.html
[15] https://docs.alfresco.com/adw-zh-cn/concepts/welcome-adw.html
[16] https://docs.alfresco.com/../references/whats-new-adw.html
[17] https://docs.alfresco.com/../tasks/deploying.html
[18] https://docs.alfresco.com/../concepts/configuration.html
[19] https://docs.alfresco.com/../concepts/governance-adw.html
[20] https://docs.alfresco.com/../concepts/process-adw.html
[21] https://docs.alfresco.com/../concepts/developing-extensions.html
[22] https://docs.alfresco.com/../references/troubleshooting.html
[23] https://docs.alfresco.com/../reuse/disclaimer.html
[24] https://docs.alfresco.com/../reuse/copyright.html
[25] https://docs.alfresco.com/whats-new-adw.html%23whats-new-adw__3
[26] https://support.alfresco.com/
[27] https://docs.alfresco.com/../concepts/welcome-adw.html
[28] https://docs.alfresco.com/containerized-deployment.html
[29] https://docs.alfresco.com/deploy-tomcat.html
[30] https://docs.alfresco.com/setup-in-webserver.html
[31] https://docs.alfresco.com/../tasks/containerized-deployment.html
[32] https://docs.alfresco.com/../tasks/deploy-tomcat.html
[33] https://docs.alfresco.com/../tasks/setup-in-webserver.html
[34] http://docs.alfresco.com/6.2/concepts/deploy-overview.html
[35] http://docs.alfresco.com/6.2/tasks/deploy-helm-aws.html
[36] https://docs.alfresco.com/6.2/tasks/deploy-docker-compose.html
[37] https://docs.alfresco.com/6.2/concepts/ch-install.html
[38] https://docs.alfresco.com/6.2/concepts/global-props-intro.html
[39] https://docs.alfresco.com/6.2/concepts/enabling-cors.html
[40] https://enable-cors.org/
[41] https://alfresco-content-app.netlify.com/#/features/
[42] https://www.alfresco.com/abn/adf/docs/core/components/login.component/#single-sign-on-sso
[43] https://docs.alfresco.com/../concepts/workspace-ags-icons.html
[44] https://docs.alfresco.com/../concepts/workspace-archival-icons.html
[45] https://docs.alfresco.com/process-services1.11/tasks/gs-create-process.html
[46] https://docs.alfresco.com/../tasks/workspace-process.html
[47] https://docs.alfresco.com/../tasks/managing-processes.html
[48] https://docs.alfresco.com/../tasks/managing-tasks.html
[49] https://docs.alfresco.com/../tasks/config-aps.html
[50] https://docs.alfresco.com/process-services1.11/concepts/acs-sso.html
[51] https://docs.alfresco.com/deploying.html
[52] https://www.alfresco.com/abn/adf/docs/process-services/
[53] https://alfresco-content-app.netlify.com/#/extending/
[54] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__1
[55] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__2
[56] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__3
[57] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__4
[58] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__5
[59] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__8
[60] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__9
[61] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__10
[62] https://docs.alfresco.com/troubleshooting.html%23troubleshooting__top
[63] https://nginx.org/en/docs/http/configuring_https_servers.html
[64] https://letsencrypt.org/docs/certificates-for-localhost/
[65] https://docs.alfresco.com/sso/concepts/intro.html
[66] https://docs.alfresco.com/saml/concepts/saml-overview.html
[67] http://docs.alfresco.com/saml/tasks/saml-restapi-console.html