Esko Logo Back to Esko Support
Choose your language for a machine translation:


Question

Which functionality is available in the "Form Builder" compared to Attribute Category in WebCenter 20.0, 21.03, 21.07, 21.11, 22.03, 22.07, 22.11 and 23.03? What are the gaps and workarounds?

Answer

By now, a lot of use cases are covered in the Forms in Dashboards.

This page will focus on a comparison between the existing Attribute Category functionality and Dashboards.

Legend

(tick) <Feature>Supported in WebCenter 20.0 and 21.03

(tick) <Feature>

NEW IN 21.03

Supported since WebCenter 21.03

(tick) <Feature>

NEW IN 21.07

Supported since WebCenter 21.07

(tick) <Feature>

NEW IN 21.11

Supported since WebCenter 21.11

(tick)<Feature>

NEW IN 22.03

Supported since WebCenter 22.03

(tick)<Feature>

NEW IN 22.07

Supported since WebCenter 22.07

(tick)<Feature>

NEW IN 22.11

Supported since WebCenter 22.11

(tick)<Feature>

NEW IN 23.03

Supported since WebCenter 23.03
(warning) <Feature>Partially supported in WebCenter 20.0, 21.03, 21.07, 22.03, 22.07, 22.11 and 23.03
(error) <Feature>Gap! Not supported in WebCenter 20.0, 21.03, 21.07, 22.03, 22.07, 22.11 and 23.03

(question) indicates a section with known workarounds

Types of Dashboards

FeatureNotes
General

(tick) Inline Editing and form editing

Inline editing: do a single change and save.

When form editing:

(tick) Add Save & Cancel buttons in dashboard

(tick) Add Complete task button in dashboards

Since you add them to the dashboard yourself, you can also choose to not have some of these buttons.
(tick) Can be combined with popups and tab layoutStructure your form as per your requirements.
Editing a project/document/task
(tick) Dashboard to edit a project (inline editing or as a form)
(tick) Dashboard to edit a document (inline editing or as a form)
(tick) Dashboard to edit a task (inline editing or as a form)
Creating a project/document/task with information from a dashboard
(tick) "Creation View" for Project Dashboards

Design your Project Creation form in dashboards.

(tick) Project Autonaming

(tick) Project Template

(tick) As far as we know all template options are supported

(warning) Cannot set Task Forward vs Backwards Planning, Planning Due Date and Requester in the project creation form (but takes setting from the project and applies default behavior)

(warning) Settings for "default role assignments for project creation" (configured in the project template) are currently ignored in Dashboards

Dashboard Locations


Notes
(tick) All places where we can show the dashboards, focus layout, menu, project landing pageEdit information in all Project/Document/Task Dashboards, inline or as a form with a Save button.
(tick) Different Task Dashboards per Task Type

Configure a dashboard in the task type.

This dashboard will be used in the focus layout, Dashboard Todo Feed or Selection Details block.

(tick) Project Landing Dashboards

(tick) Land on a Dashboard when clicking on a document

NEW IN 21.07

In both search and dashboards all links to documents can be configured to go to one of these locations:

  • Document Details
  • Viewer
  • No Link
  • Dashboard Popup

Note that when opening a document in a dashboard by clicking on it, it is always shown in a popup. It is currently not yet possible to open it in the current or a new browser tab.

(tick) Different Dashboard per Project or Document type

NEW IN 21.11

Since WebCenter 21.07, you can customize every search or document reference table to show a different dashboard in a popup when clicking on the document/project name. If similar projects/documents are grouped in the same search/document reference this gives you the freedom to show a different dashboard per type.

Additionally, since WebCenter 21.11, we now have full support for visibility rules in Dashboards. This allows you to show slightly different information depending on certain conditions

Editable Information Overview

FeatureNotes
Project Information
(tick) Edit Project Name, Description, Project Status, Project Manager, Salesperson, Project due date

All Project information can also be edited in a document or task context

Additional options:

  • Link due date to milestone
(tick) Edit text, float, integer, rich text, right to left, date attributes, etc.
(tick) Restricted sets
(tick) Attributes linked to lists with cascading behavior

(warning) Needs to be configured in Attribute Category at the moment. Configuration will improve in the future.

(warning) Limitation: option to correct values on "page load" is not supported (yet?). "Clear All" is also not available.

(warning) Limitation: linking an attribute to the values of another attribute is not supported yet.

(tick) Restrict an attribute to the values of another attribute

NEW IN 22.11

Since 22.11 you can now restrict the values you can select in a project attribute to another project attribute.

(warning) Needs to be configured in attribute category at the moment. Configuration will improve in the future.

(tick) Multi-value attributes(warning) Needs to be configured in attribute category at the moment. Configuration will improve in the future.
(tick) Edit role assignments
(warning) Document References

Not fully featured. For details on individual features, see section below.

(error) Customer/location of a project

Not possible yet to edit customer/location of projects anywhere in dashboards.
Cannot be edited in Project Creation/Edit Project Dashboards or Search inline editing.

(error) Project Documents block

It is not possible to show Project Documents in a Dashboard yet.

(question) Possible workarounds:

  • Use a Saved Search block to show the Project Documents.
    (minus) Disadvantage: not possible to add new documents to the project this way.
  • Use a Document Reference block to add or show documents of the project
    (minus) Disadvantage: not possible to sort, filter, ... and need to maintain a list of documents in the document reference.
(error) Show/Edit Bill Of Materials

Not supported yet.

(tick) All permissions settings of WebCenter are taken into account
(tick) Make only information editable that you want per dashboard

(tick) Mark information that always needs to be filled in as required

NEW IN 21.03

Since WebCenter 21.03, information in a project dashboard can be marked as required in the dashboard builder.

Additionally, since WebCenter 21.07 we have better highlighting of fields that are required but not filled in and "validation scripting" which allows custom checks to be done on the information filled in the form before the form is saved.

Task Information

(tick) Edit Task Name, Description, Task Status, Task due date, Task estimated date, Task assignee

Additional options:

  • Create new user for task assignee inline
  • Link due date to milestone
(tick) Edit text, float, integer, rich text, right to left, date specifications, etc.
(tick) Restricted sets
(tick) Attributes linked to lists with cascading behavior

(warning) Needs to be configured in Task Type Specifications tab at the moment. Configuration will improve in the future.

(warning) Limitation: option to correct values on "page load" is not supported (yet?). "Clear All" is also not available.

(warning) Limitation: linking a specification to the values of another specification is not supported yet.

(tick) Restrict an attribute to the values of another attribute

NEW IN 22.11

Since 22.11 you can now restrict the values you can select in a project attribute to another project attribute.

(warning) Needs to be configured in attribute category at the moment. Configuration will improve in the future.

(tick) Multi-value attributes(warning) Needs to be configured in Task Type Specifications tab at the moment. Configuration will improve in the future.
(warning) Task documentsNot fully featured. For details on individual features, see section below.
(warning) Document referencesNot fully featured. For details on individual features, see section below
(tick) Bulk editing of all editable information in Search (in tasks, documents & projects)New for tasks in WebCenter 20.

(tick) Mark information that always needs to be filled in as required

NEW IN 21.03

Since WebCenter 21.03, information in a task dashboard can be marked as required in the dashboard builder.

Additionally, since WebCenter 21.07 we have better highlighting of fields that are required but not filled in and "validation scripting" which allows custom checks to be done on the information filled in the form before the form is saved.


(warning) Limitation: marking information as required in the dashboard will currently not only block task completion but also saving of the task.

(warning) Required specification can also be configured in the task type. Support for this setting is rather limited though. It will block the task completion, but give no indication of which specifications are missing. If you have specifications marked as required in the task type you should also mark them as required in the dashboard to get a better experience.

(error) Synchronize Project Attributes and Task Specifications

All specifications of the task will overwrite the project attributes if the option is enabled.

However, the dashboard will NOT be auto-filled with the current values for the project attributes or indicate whether there are changes since the previous time that you saved the task.

(question) Possible workarounds using workflow? However, even then indicating changes will not be available.

(warning) Needs to be configured in Task Type Specifications tab at the moment. Configuration will improve in the future.

(tick) Set role assignment using specifications
(tick) Restrict Task to an Allowed Assignee (a Group or Role)
(warning) Completing tasks with passwords is not supported in Search Results Bulk Editing. Cannot complete multiple tasks with bulk editing if a password is required to complete tasks.
(error) Task ChecklistsNot supported yet.
(tick) Task completion options related to documents
  •  

  • Set default Folder for uploaded Documents

(error) Save task without all required information filled inNot supported yet. Saving currently always checks all required information.
(tick) All permissions settings of WebCenter are taken into account
(tick) Make only information editable that you want per dashboard
Document Information
(tick) Edit Document name, Description
(tick) Edit text, float, integer, rich text, right to left, date attributes, etc.
(tick) Restricted sets
(tick) Attributes linked to lists with cascading behavior

(warning) Needs to be configured in Attribute Category at the moment. Configuration will improve in the future.

(warning) Limitation: option to correct values on "page load" is not supported (yet?). "Clear All" is also not available.

(warning) Limitation: linking an attribute to the values of another attribute is not supported yet.

(tick) Restrict an attribute to the values of another attribute

NEW IN 22.11

Since 22.11 you can now restrict the values you can select in a project attribute to another project attribute.

(warning) Needs to be configured in attribute category at the moment. Configuration will improve in the future.

(tick) Multi-value attributes(warning) Needs to be configured in Attribute Category at the moment. Configuration will improve in the future.
(warning) Folder

Cannot change folder after having uploaded or created the document. Target Folder can be configured in the sources (see below).

(tick) Reference Properties
     NEW IN 22.07

Since WebCenter 22.03, reference properties can be shown in Dashboard, but can currently not be edited yet from a Dashboard.

Since WebCenter 22.07 reference properties can be edited in Dashboards as well.

(tick) Restrict reference property values to the values of another multi-value attribute

NEW IN 22.11

Since WebCenter 22.11 in Dashboards, a reference property can be configured to only allow selecting values which are defined in another attribute.

This works similarly to the "Reference Scope Filter" feature in Attribute Category. This feature can be used for "tagging" specific documents in the document reference for certain use in the project.

(tick) PCM related information

    (tick) Display, adding, editing
         NEW IN 22.03

    (tick) Auto-addition of languages
         NEW IN 22.07

    (tick) Auto-translate
         NEW IN 22.07

    (error) Only supports "side by side view"

PCM is fully featured in Dashboards since 22.07.

Note that:

  • Dashboards only supports "side by side" view at the moment.
  • Bulk adding of languages only happens for newly created PCM documents before save. For existing already saved PCM documents new languages are not automatically added, but a button is available to add the missing languages for all statements.
  • Scripting is supported, but only for reading the content and status, writing PCM related information from scripting is not supported at the moment.
(warning) Document ReferencesNot fully featured. For details on individual features, see section below.
(tick) All permissions settings of WebCenter are taken into account
(tick) Make only information editable that you want per dashboard

(tick) Mark information that always needs to be filled in as required

NEW IN 21.03

Since WebCenter 21.03, information in a document dashboard can be marked as required in the dashboard builder.

Additionally, since WebCenter 21.07 we have better highlighting of fields that are required but not filled in and "validation scripting" which allows custom checks to be done on the information filled in the form before the form is saved.

Other
(tick) Basic Rich Text Formatting Options

The following formatting options are available for rich text:

(error) Advanced Rich Text Formatting OptionsNot available yet.
(tick) Showing attributes as checkboxes or radio buttons

Supported since WebCenter 23.03.

Show attributes linked to a "yes/no" restricted set as a single checkbox.

Show multi-value text attributes linked to a list, a restricted set or restricted by another attribute, as a list of checkboxes or radio buttons. Also has support for showing checkboxes with images.

Document Creation/Document Rendering

FeatureNotes
"Add" Sources

(tick) Upload document

    (tick) Configure allowed extensions

Dashboards always use "chunked upload" (new in WebCenter 20) and do not listen to the Configuration option in General Preferences

Also supports drag and drop to upload. Multiple files can be dropped or added in one go.

(tick) Saved Search Document Source
(tick) Saved Search Document Source with SmartNames

SmartNames are supported on all dashboards and take into account non-saved values.

(warning) Know limitations: A few very specific Saved Search SmartNames will not work for non-saved changes yet:
"Project Customer Location Code", "Project Manager Location" and "Project Manager Location Code". 

(error) Saved Search Block with SmartNames

Unlike the "Saved Search Source", the "Saved Search Block" does not take into account non-saved values for SmartNames yet.

Not supported yet.

(tick) "New" Document Source

   (tick) Run a Standard

NEW IN 21.07

Supported since WebCenter 21.07, including Run a Standard.

(tick) Asset Management System (e.g. Mediabeacon)

NEW IN 21.03

Supported since WebCenter 21.03.
(tick) Drag and drop from saved search to dropzone
(error) Current ProjectNot supported. (question) Workaround available using Saved Search Document Source.
(error) Select from ProjectNot supported. (question) Workaround available using Saved Search Document Source.
"Update"

(tick) Upload new version

NEW IN 21.03

Supported since WebCenter 21.03.
(error) ReplaceNot supported yet.

(tick) Duplicate

NEW IN 22.11

The "Duplicate Document" action is supported since WebCenter 22.11.

(warning) Limitation: the duplicate document action only supports duplicating a single document. If the document you try to duplicate has document references with other documents, those documents are not duplicated yet. This might change when we introduce deep copy which is currently also still a gap (see below).

(tick) Update to latest version

NEW IN 22.11

Supported since WebCenter 22.11.

(tick) Remove document

NEW IN 21.03

Supported since WebCenter 21.03.

(question) Workaround before 21.03: a "Cancel" button can be added to the dashboard so the user can cancel his changes. ("cancel" reverts all non-saved changes).

Operations

(tick) Copy

   (tick) Basic Copy

   (error) Local Copy

   (error) Deep Copy

Currently only "basic copy" is supported.

(tick) Use by Reference
(error) LinkNot supported yet.
(error) MoveNot supported yet.
Document type
(tick) Document Autonaming(info) Note: if you are using the "edit field" SmartName in autonaming, this is currently not clear in the UI. It will look like you are entering the whole document name.
(tick) Default Attribute Category(info) Note: When uploading a new document, the default attribute category is only assigned when saving. So, it's not possible to directly edit the attributes before saving. It's the same behavior as in DocTableX.
(tick) Start Task for new Documents
Other options
(tick) Target Folder

Possible to configure a folder in the source. Folder might also be taken from the task type or the document template.

(info) Note: if you need the user to be able to choose between different folders to upload to himself, you will need to make different upload buttons and dropzone areas available. The user will have to drop his document in the right place to upload to the right folder. He cannot change the folder afterwards.

(tick) Document templates

Document templates are fully supported, including the "default" and "default.pdf" document templates.

(info) Note: if you need the user to be able to choose between different document templates himself, you will need to make different upload buttons and dropzone areas available. The user will have to drop his document in the right place to use the right document template. He cannot change the document template afterwards.

(error) Prevent multiple documents

Document references and Task documents are currently always multi-value. Single value is not supported yet.

Options to not allow multiple documents are not taken into account.

Rendering Options
(tick) Show any information which can also be shown in SearchThumbnail, document, Project and Task information, etc. that are available in Search can be shown.
(tick) Allow the user to make additional information visible"Available columns" from Search
(tick) All rendering options for individual cells from SearchShow/hide time, show project status as icon only/color label, etc.
(tick) Search Conditional Formatting on cells in the table
(tick) Custom column headers with translation
(tick) Different layouts

List, Card, Grid, etc.

Even more layouts might be added in the future. (e.g. thumbnails next to each other or a layout similar to the todo feed)

(tick) Hide table header

(tick) Expand button

NEW IN 22.03

Since WebCenter 22.03 we support expanding of document rows. There are two supported variants:

  • Drilldown into a Dashboard, in which there is an expand button at the beginning of the row and clicking it shows a dashboard below the row.
  • Dashboard Layout, in which rows are not shown and instead the list of documents is shown as a list of dashboards
(error) Set "width" of table columnsWe try to provide a good default instead.
(error) "Open links in new tab"

Not supported yet.

(info) Note: since WebCenter 21.07 you can however configure specific links to open as a Dashboard in a popup or disable links to go to the project/document completely.

(tick) Show document references with a lot of documents (e.g. 1000+ documents)

Paging per 20 results.

No support for filtering and sorting yet to browse through this huge list of document references.

Additional Columns

(tick) Re-order rows

NEW IN 22.07

Since 22.07 it is now possible to enable re-ordering for document references.
(error) Local/RemoteNot supported yet.
(error) "Allow Bulk Operations" from Attribute CategoryNot supported yet. Cannot bulk delete, replace, make local, update to latest version.
Actions

(tick) Table Actions

  • View and Annotate
  • Compare in Viewer
  • Download
  • Add to Cart
  • Download Mail Link
  • Custom actions: Start workflow, JavaScript

(warning) JavaScript actions are the ones configured in the menu builder.
These only have access to the document version, document and project ids. Nothing more.
Not to be confused with JavaScript actions in the attribute category. Those are not supported, see below.

(tick) Inline Actions

  • Approve/Reject/Comment
  • View in 3D
  • View and Annotate
  • Open in ArtiosCAD
  • Download
  • Approval Info
  • Mail Download Link
  • Mail link to
  • Lock
  • Add to Cart
  • Custom actions: Start workflow, create task, JavaScript
(warning) JavaScript actions are the ones configured in the menu builder.
These only have access to the document version, document and project ids. Nothing more.
Not to be confused with JavaScript actions in the attribute category. Those are not supported, see below.

Scripting

Most scripting is not available yet. Visibility rules are also not available yet.

FeatureNotes

(tick) Visibility rules

NEW IN 21.11

Whole sections can be hidden by adding visibility rules on any Dashboard block. Additionally, input fields can be made visible, required, hidden or editable based on certain conditions. A lot of information is accessible from the scripting API and can be used to introduce complex conditions.

Note that unlike Attribute Category, in Dashboards it is never necessary to add an attribute which is always hidden. Dashboards will always "keep values" when saving and all information is always accessible from scripting, even if you do not add a block for it.

(tick) Use visibility rules to make sections visible for members of a role or group

NEW IN 22.03


(tick) React to changes in the form

NEW IN 21.11

It is possible to add scripts to an input field in the form. This script would be executed when the user changes the value of the input and can be used to set other values in the form automatically.

(tick) Block Form submission with Scripting

NEW IN 21.07

This type of scripts did not exist in Attribute Category. It allows you to block form submission if the information in the form is not ok. Right before form validation you can also still adapt some values in the form.

All information in the tabs, popups, expanded sections of a document in the form will be validated. Note however that things which are hidden by visibility rules will not be validated.

(tick) JavaScript buttons

NEW IN 22.07

Since WebCenter 22.07, simple JavaScript buttons are now also available for projects and tasks. Before 22.07 those buttons were only available for documents (since 21.07).

(warning) Note that what you can do with these buttons is probably still rather limited since the button does not have access to lists and it cannot do SDK calls as the current user (see below).

(error) Lookup values in a WebCenter list

It is currently not possible to lookup values of a WebCenter list from a script.

(question) Workaround: it might be possible to workaround this feature with the external API connections, see below.

(warning) Access to WebCenter SDK or other ajax calls

Since WebCenter 22.03, Scripting in Dashboards has limited support for calling external APIs.

You can call external APIs, however:

  • Only token authentication is supported for accessing the external API. The token is configured in the admin configuration section.
  • Dashboard Scripting currently only supports JSON or plain text. There is no support for handling XML.

These limitations mean not every external API can be called, but are especially impractical for calling WebCenter SDK. For one, the current limitations mean WebCenter SDK cannot be called as the current logged in user. All requests will use the same token for authentication. Depending on which user is used for the token this is also a security risk as it would give every user more permissions than usual. Even if you could call it and somehow limit the security risk, all WebCenter SDK calls return only XML, which is not supported yet.

For now, avoid calling WebCenter SDK with the external API support. Better functionality to call WebCenter SDK will be provided in the future.

(warning) Styling rules

(tick) Conditional formatting is fully available and live updates while entering values.
(error) It is not possible to use JavaScript yet.
(error) And/Or is not available
(error) Multi-value is not available, but possible to set up multiple rules

(warning) Known limitation of conditional formatting in forms:
You might see formatting change as soon as you start editing any information in the form. The implementation in forms for non-saved values behaves slightly different for date conditions. It does not take into account weekday options configured in the application server. Additionally it executes the rule in the browser timezone, not in the server timezone.

Article information
Applies to

WebCenter 20.0,
WebCenter 21.03
WebCenter 21.07
WebCenter 21.11
WebCenter 22.03
WebCenter 22.07
WebCenter 22.11
WebCenter 23.03

Created

 

Last revised

 

AuthorJEPE
Contents