Release notes

• Model Classifications in separate data dictionaries:
  • Define can now recognise different types of data dictionaries including that some are for classification systems.
  • Usage of Construction objects from Classification dictionaries is restricted so that they cannot be used to create Data templates.
• Users of the Define public view can decide if they want to see archived Data Templates in the list. By default, archived Data Templates are not displayed

• Users of Define authoring can now filter by Data Template visibility. By default, both published and not published Data Templates are displayed

• Property Reference is moved to a separate tab to keep the design of different concept types consistent

• Properties in the prerequisites tab in the Public view are now grouped by Milestone/Purpose/Actor

• Users can now see an indication that content is archived:​
  • In the interface of the Define public view

• • In the exports (Excel, XML, Revit SP)

– Support standardised GUIDs – Define is now keeping track of GUIDs that are published in standards (e.g., EN ISO 22057 or ISO/TS 7127:2023):

• Users in Define can store those GUIDs in a special attribute on property level. Both Microsoft and IFC formats are accepted | video link
• The standardised GUID is visible in the public page and Templates API.

– Archive functionality in Define – Pending updates:​

• Users in Define now get a pending update when a concept is archived prompting them to remove it from the latest version of the parent concept (e.g., if a property is archived, users will be asked to remove it from the latest version of the Group of properties) | video link
• If the child concept cannot be removed or changed, the users are prompted to archive the parent concept (e.g., if a unit is archived, users will be asked to archive the properties using that unit) | video link

– Reference documents in the Public view:​

• Reference documents are now visible for properties in the Public view

• Links to the external source and the European edition of the standard are added for references of properties and data templates. The columns are visible only when there are such links available

Revit Shared parameter file export – Users of the Define Public page can now export a Revit Shared Parameter file and integrate data dictionary content in their real-life processes and tools:

• [Define Authoring] Revit Shared Parameter file set-up:​
  • Define experts can select which properties should be included in the Revit Shared Parameter export | video link
  • Define admin can enable/disable Revit Shared Parameter and other types of exports in the Public view. By default, the Revit SP export is disabled | video link
• [Define Public page] Revit Shared Parameter file export and use:​
  • Users of the Define Public page can now download a Revit Shared Parameter file. The option is available for users with Basic subscription | video link
  • The downloaded file can be imported and used in Revit | video link

1. Context specific attributes

Clients are now able to add attributes on top of approved concepts that are specific for their data dictionary. These attributes do not need approval or trigger a new version of the concept. They can be copied when sharing content to other data dictionaries.

The feature is available for Construction objects, Properties and References and covers the following use cases:

• Add a link to the source where the Reference document can be found.
• Add a link to bsDD definition to enable a connection to another data dictionary;
• Map your properties to available Revit GUIDs;
• Create your own Short name for properties to use in BIM software.

2. [Data Dictionaries] Performance improvements:

• Data template details page is now loading 2 times faster.

3. Archive content in Define – users can now indicate that content is wrong or obsolete by archiving it:

• The functionality is available for users with role ‘Content administrator’
• The functionality is available for all concept types – Construction objects, Templates, Properties, etc.
• Archived content remains visible in Define with an indication that it is archived
• Archived content remains visible in the Templates API
• Published archived content remains visible in the Public page
• Archived content remains visible in the Cobuilder Platform
• Once archived a concept cannot be restored
• Archived concepts can no longer be used to create new content in Define
• Archived content cannot be shared directly to other data dictionaries

4. Bug fixing and regular maintenance.

1. Users can now see the link between properties and documents in the National and European data dictionaries:

• Users of Define authoring can now see linked properties from another data dictionary. The attribute is displayed only if such link exists and if the EN property is shared and visible in the National data dictionary

• Users of Define authoring can now see linked references from another data dictionary. The attribute is displayed only if such link exists and if the EN reference is shared and visible in the National data dictionary

• A tooltip has been added to explain to the user what this relation represents

• Users of the Define public page can now see the linked property from another data dictionary. The attribute is displayed only if such relation exists

2. Filter properties by classification and classification codes mappings in Public view:

• Users of the public view can now filter properties by the mapped classification and classification codes
• All properties mapped to the selected classification and classification codes is displayed regardless of used classification version

3. Filter properties by classification and classification codes mappings in Public view:

• When users filter the properties inside a data template and export it, only the filtered properties will be included in the export file

4. Sharing process improvements:

• Sharing admins now can see an indication if a concept cannot be shared due to not shared 3rd party child concepts

• When clicking on the icon, a list of the not shared related concepts is displayed

5. Deprecated PropertyTag and Document Endpoints have been removed from Templates API.

1. Users are now able to see the mappings of properties inside of the data template

2. Public view PREMIUM subscription – Define public view advanced functionalities (XML export and XLS export with GUIDs) now require users to upgrade to Premium subscription

1. Actors are now available in Define:
   • Users can now create and manage actors in Define
   • Created actors are evaluated as any other concept in Define
   • Users can now assign actors to the properties in the data template just like milestones and purposes, indicating who is responsible to deliver the information
   • Created actors can be shared to other data dictionaries
   • Data templates in Define can be filtered by actor
   • Properties inside the data templates can be filtered by actor
   • Actors are available in the Template API and Define public page

2. Public view responsive design:
   • The public view is now resized according to the screen resolution, allowing the users to better see the content inside

3. Templates API:
   • Templates API v2 endpoints have been removed

4. Requesting content from Define public view:
   • Users are now able to request missing content from the data dictionaries from different places on the UI. They will be able to request missing Data template, Construction object, Property, Values, Purpose, Milestone

5. “In collaboration with” Logos:
   • Context owners are now able to showcase and manage the logos of the Associations and Organization that contributed for creating the published content. Together with the logos they can set the hyperlink that will lead to the collaborator’s webpage

6. Classification view
   • End users will be able to see the Data templates structured in a Classification hierarchy view. Industry actors use different classifications to identify and find relevant content (e.g., CCI, Uniclass, etc.). Navigating in already familiar structure of classification would help the end users to find easier and faster the needed Data templates

1. Users of the Define Public view can now register for free and get limited access to the content.

2. Users of the Define Public view can now download the data templates in XML format

3. Bug fixing and regular maintenance
   1. It is now visible which data dictionary is the source for shared content.
   2. It is now available to filter content by which data dictionary it comes from.
   3. Property tags have been renamed to ‘labels’.
   4. Documents have been renamed to ‘references’.

1. Public view – List of properties displays related properties to the selected Purposes and Milestones
   1. Added columns for Purposes and Milestones in the list of DT’s properties
   2. Added filtration on Purposes and Milestones in the list of DT’s properties
   3. Filtration on Purposes and Milestones from the list of DTs are applied to the filters in the list of DT’s properties after selecting a DT and only the relevant properties are displayed. User is able to remove the filtration in order to display all properties of the DT.
   4. Property tags column is renamed to Labels

2. Public view permissions and configurations (Phase 2 – Basic package)
   1. Configurable pricing link per individual Public view page – Context owners with allowed paid access to their public view can configure the URL to their pricing

3. Improve UX/UI and implement in-system onboarding in Define
   1. Selecting the Help center in Define opens the page in Definehub in the current language used in the Define UI

4. Define – Keep the lights on
   1. Allow the user to see all pending updates in the context – we have added an option for users to see pending updates from other creators

2. Improvements in Relations tab

i.     Version of all related concepts are visible

ii.     Grouping of concepts – All concepts are shown by default in their highest related version and lower related version to be hidden and available upon click

5. Bugfixing

Define – Mappings are now copied when sharing a template to another context

• User will be notified with indication that mappings will not receive update and changes made in the original DT will not be applied to the copies. Icon in the table with shared DTs indicates that the templates will be shared with the mappings.

Define – Parent concept relations are displayed when the parent concept gets a new approved major version

• If a concept has a parent relation, it will be visible whether or not the parent concept has a next approved major version

Public view – registration

• Customers can now decide if their public view should be with limited access. User access is now limited for configured Public views
• Users are prompted to register to the Platform and get access to Data template details or to download Data templates

Public view – excel export

• Mappings are now available in the public view export – on 3rd sheet “DT Properties” after the columns with the Purposes and Milestones we are listing the mappings of the properties

• System and version GUIDs are now available in the public view export. The fields are hidden by default. We are listing the GUIDs in Compressed and Uncompressed format. They can be seen for all concepts in the “Table of Contents” sheet of the excel and for the properties in the “DT Properties” sheet

Public view – Feedback button and form

• New button “Feedback” is added. It directs to feedback form in Define Hub where users will be able to share their feedback about content, issues, UI. The feedback will be received by support team with ability to be received also by the context owner.

Public view – Save filtration between pages –

• Now when browsing between the pages in the public view the system will keep your filtration when going back to the list of DTs. We are keeping parameters on Filtration, Searching, Pagination, Selection, Sorting

Public view – filtration

• Users are now able to filter data templates using a classification tree in the filter of Define public page

Public view – excel export

• Users are now able to select all templates from Define public page and download them. The user need to click on “Select all templates” and then click on “Download selected” button.

• Download file is sent via email ensuring fake emails are not used

Define – Supported language

• Define now supports Portugues language

Public view – Excel export

• Excel export now includes technical definitions, user definitions and examples of properties and data templates
• Export file now includes properties version number. The column is hidden by default

Public view – Technical definition, User definitions and examples

• Users now can see additional information about the Data Templates and Properties – Technical definition, User Definition and examples – by clicking on the info icon the user will see a side modal with the information

Define – Creating of Specific properties

• Specific properties can no longer be created without reference documents

Public view – Data templates list

• User can see Purposes and Milestones assigned to the properties in the data templates and filter by them.

Public view – Excel export:

• User can now export multiple Data template in one excel export.
  Exported file is now translated into the selected UI language

Improve UX/UI

Changes in side navigation

• “Construction objects”, “Units”, “Measures”, “Values” and “Documents” are grouped under one main menu “Core content”
• “Authority”, “Domain”, “Public view” and “Sharing” are now grouped under one main menu “Admin content”

Progress bar for creating all types of concepts with list of steps

New options in Help center

Glossary, FAQs, Support ticketing are now available under the Help center menu

New interface languages

Define user interface is now available in 2 additional languages Danish and Czech

New filtering options for Templates list

Filtering by classification, classification code, purpose, or milestone is now possible

Introduce data auditor role and status enhancements

‘Pending audit’ status is hidden in filters where not applicable

Comments enhancements

All users in a context are now allowed to comment on concepts in active statuses to enable collaboration

National contexts

Data model is extended with new relationship type to allow linking properties from national and EU context

New Public view Customization and Implementation Settings

Added a setting to integrate the public page with default language different than English
The developers have the option to integrate the public view with different default language than English by passing a parameter in the URL

• Default is English

Example: https://platform.cobuilder.com/define/public/08C6Lla2TAVRcCxdZxM49Y/template-list?lang=en

• Passed default language French

Example: https://platform.cobuilder.com/define/public/08C6Lla2TAVRcCxdZxM49Y/template-list?lang=fr-FR

• List with supported language codes (case-sensitive):

en, nb-NO, de-DE, es-ES, fr-FR, it-IT, cs-CZ, da-DK
Note: If the language code is wrong, it will reload the page in the default English language.

Added a setting to integrate the page without navigation bar
Integration of the public view could be implemented with shown or hidden navigation bar.
Hiding the navigation bar has the following benefits: removed white space, removed Login option, removed language settings. This can be used in cases where the solution needs to be in one language and without access to registration/login.

Implementation Guide:
In order to hide the navigation bar our users should use the “showNavbar” query parameter with the relevant value and is added before the language parameter:

• Without navigation bar
  • https://platform.cobuilder.com/define/public/08C6Lla2TAVRcCxdZxM49Y/template-list?showNavbar=false&lang=en

• With navigation bar (default)
  • https://platform.cobuilder.com/define/public/08C6Lla2TAVRcCxdZxM49Y/template-list?showNavbar=true&lang=en
  • https://platform.cobuilder.com/define/public/08C6Lla2TAVRcCxdZxM49Y/template-list?lang=en (Default behavior)

Public View Enhancements

• New URL (page address) for the public page
  The Public Page is located on a new page address. Old Page addresses will still work and redirect to the new page address.
  • Old address: https://app3.cobuilder.com/public/{ID}
  • New address: https://platform.cobuilder.com/define/public/{ID}
• Fix the filtered Classification Codes displayed in the Public page
  The Data Templates page has enhanced filter by Classification as it now filters out and displays only the Classification Codes of the selected Classification.

The image below shows the results after Classification ‘revit categories’ is selected:

• Removed ‘Domain’ column in Data Templates page
  The ‘Domain’ column is removed. It previously showed the domain of a Data Template (I.e. Technical, Architecture, Electrical, Structural).

Before:

After:

Model Milestones and Purposes in Define
Users can now link properties to milestones and purposes in the context of a data template, so they can state that these properties are applicable for the selected milestone/purpose

Introduce Data auditor role and new statuses
Users with data auditor role can now see audit requests in the side navigation list and review the content of contexts subject to data audit

Users can now add comments directly to concepts

Users can see latest comments on the dashboard