Document toolboxDocument toolbox

Release notes for version 4.6.0

New features, improvements and bug fixes done for version 4.6.0

Table of Contents


User related changes

Batch print using print template and scale value based on document's metadata

Issue [HDC-4239

It is possible now to print multiply documents using Batch Print that will use different print template and Scale value per each document based on object's metadata. 

If you have proper configuration done by you Administrator, specific fields in object's metadata will decide on printout template and scale. 
In situation from below screen, each of the printed drawings will use field Print Format to set specific print template (based on assigned template to chosen format).
Based on Print Scale field, printout will set Scale from the field to Main Viewport of the printout drawing (Viewport1).


Batch Print Settings menu is not needed at all unless you want to force printouts to ignore metadata settings - in that case use Force given setting checkbox - then all printouts will use chosen template. 
When PrintFormat metadata is not given but Scale value is correctly set in proper field then it will be still used for template set in Bach Print Settings.

Configuration

  1. New System Dictionary PrintFormats (ID-1) was added and will be visible on dictionaries list - it will consist of all print formats in database. 
  2. Create new Configuration draft and in Configuration/Object Classes add new field or edit existing field to use Dictionary: PrintFormats.
  3. Choose in same manner field for setting scale of printouts - dictionary with scales should be used. 
  4. Each class will now have Print tab, open it to choose Scale field and Format field. From those fields, values will be taken and used to set print template and scale. 
  5. Activate new configuration.
  6. Go to Printing/Formats and assign for each needed print format, desired print template (click on cell under Print Template column to open menu list).
  7. Note: available list of templates is taken from print template set list - if desired template is not on a dropdown list, please add it to template set that your are assign to.




    During Batch print if proper metadata is set Scale Mode of Viewport PRINTVPT-1 will be forced to ScaleMode = Scale View regardless of print template settings.

    Other Viewports will not be modified.

Batch print option to print only background drawing

Issue [HDC-4098

Additional option "Print only background" was added to batch print settings. When checked, only background drawings of selected documents will be printed. Vector elements will not be included in printout.



User selected vector elements can be printed

Issue [HDC-4017

A function to control ad-hoc elements highlight on printout is available in all print modes.

To highlight selected elements, select some spots on the drawing (Use Ctrl + click to select multiple spots):

On the Print menu, there is a Spot highlight button. When enabled, all print and copy view functions will highlight the selection. This function has no effect on spot highlight in standard view mode. 

Open a Print Preview mode and observe the Spots button. You can toggle the highlight while in preview mode and observe the effect on the drawing, in all Viewports.

(info) Note: the style used for highlighting spots in this mode can be set in system settings. Go to Administration - System Settings - HOPA and select proper Tool for spot highlight. 

Color formatting for lookup values

Issue [HDC-4242

To use this functionality, system administrator can enable it via system settings.

In System Settings → General Settings → User Interface please set "Use lookup value color"

Colors are based on Dictionary mapping found in Presentations - Tools Mapping:

Same values are used for presentation filters on drawings.

Expanded Path info column in search results

Issue [HDC-4279

Advanced search view includes option to display full object location (path) directly in the grid. 

Use Display full path toggle button to enable path view. Button has an expandable menu where number of shown segments can be configured to limit the least meaningful segments and save display space. 

Object having multiple links have a red "star" at the end of the path. In such case full list of paths can be viewed using Location column. 

Spot and Object Area Report

Issue [HDC-4031

This function allows user to compare area stored as object metadata with a spot (vector element) linked to given object. 

A user can select an object class, like Room, metadata field - like Area NTA and a  layer that will be used to select spots, like global NTA layer or local drawing layer. 

Area value found in metadata field will be compared automatically with calculated spot area.

A result is presented in form of a report that can be exported as Excel file or converted into a graphical presentation showing correct and wrong area directly on the drawing. 

Run report for specific document and Layer

In the first step, please navigate to the desired document view. Select Document - Manage from the menu:

Next, please select a specific Layer for which you would like to run the report. Spots (vector elements) form this layer will be used in the report. 

This report is "document oriented" - it will include all objects linked to spots on this specific drawing and layer. 

Go to Manage Vector Entities tab and select Check Entity Area function. 


A report window is opened and is preset for this document and layer. Now please select object class and metadata field that you would like to use:

Spot area will be compared against that field with a Comparison precision. Please note that area will be compared after it is rounded to given number of decimal places. 

Example: if calculated spot area is 15.7999 and a metadata field value is 15.80, data used for comparison with 1 decimal place will be: spot: 15.8 and metadata - 15.8. 

When all options are set, please use "run Report" function to create the report. Observe the status column to see if there are any differences or errors. 

Possible results are:

  • Success - there is no difference detected between spot area and metadata field value
  • Area values differ - there is a difference in area detected between spot and object metadata value
  • Missing value - there is no value to compare
  • No Object linked - there is no object linked to given spot
  • Multiple Objects of the same class linked - given spot has more than one object of selected class linked - unable to compare

Run Report from Tree View

To run the report for entire subtree, please use the context menu available under right click on object in TreeView:

The report is now preset to be run for all objects in the given subtree and requires the following options:

Object class, metadata field to be compared, comparison precision and a global layer selection. 

The subtree report can only be run on a global layer. To run report on a specific local layer, please start the report from Drawing Manager. 

Other functions and possibilities are the same for the report run for specific layer, as described in "Run report for specific document and Layer".

Configure Area Presentation style

Presentation is limited to either correct (success) or incorrect (failure) result. To find out more about the error, report details must be inspected. 

System administrator can set specific style for both situations in the General Settings - Area Report section. Please select Success or Failure tab and set appropriate style. 

Apply Area Presentation

Results of the report can be presented as filter on the drawing. Please use "highlight" function on the report window in order to apply filter to current drawing.:

Export results to Excel

Report results can be exported to excel file (.xlsx). On the report window please select Download (XLS) function.  

A task creating the report will be started. When the task is finished, please download the file using get result button:

Sample file content is shown below:

New vector element: Free line shape

Issue [HDC-4030

Free hand draw on a desktop app

A new option do draw "free hand" line shapes was added to vector tools. It can be used to create markups on the drawing without being restricted to predefined shapes. 

A new button is placed on Draw toolbar:

Free line draw works slightly different than predefined shapes. Once enabled it will be active and consecutive elements can be drawn with left mouse button pressed. 

When you no longer wish to draw free lines, please disable the function by clicking on the free line button again, or by using Esc key on your keyboard. 

Zoom and Pan functions are disabled while free line draw function is active. Mouse down and drag will now create a free line instead of a paining a drawing. 

Free hand draw on a mobile app

It is especially useful to use free hand draw on mobile app (both phone and tablet). The function is not available on the primary redline / edit toolbar:

To start drawing free lines, please tap the function button to enable it. It will be active for as long as it is not disabled by the user. 

Additionally, all shape types are now available as part of expandable menu (on a mobile) and full list on a tablet:

Quick access to Vector snap toggle is now available on the draw menu and as a separate button on tablets with larger screen:

   

New vector element: Arc

Issue [HDC-4037

The new vector element can be selected from Draw toolbar: Circle Arc

Select two points for arc base:



Then select third point defining arc:


(warning) Current limitations: it is only possible to create an open Arc today (no "spot" or closed elements or elements combined with polygon/lines are possible)

View objects modified in selected version / draft

Issue [HDC-4029

This function allows a user to view all objects modified (added/edited/deleted) in a specific version.

When user is on:

  • Master version - all changes in that version are shown on the list
  • Draft version - all changed in a draft are shown on the list

To activate this function, open Version info window (1) and select Show modified objects (2) button:

A version history window is opened with a list of modified objects. Available functions include:

  • Path - location of the object (in first column L),
  • Go to object - navigate to selected object,
  • Source - manual input or import,
  • Package name - in cases when source = import.

Object modified window can also be opened form Archive Manager by choosing one of published version or existing draft.




Please note that functionality for deleted objects is limited (Path and Go to object will not work).


Filter field for filtering drafts by name

Issue [HDC-4180

In Archive Manger, new filter was added that will help to narrow list of drafts based on user input in the filter field.

The filter is present for all tabs: My Drafts, Drafts Shared With Me and All Drafts


Advanced search - saved Queries with info about root object used

Issue [HDC-4234

When using Advanced Search in a subtree, such save can be saved with HQL querry and additionally Root object information.


Such saved query can later be used from any subtree search of main search, always using subtree mode with saved object as a root.

Result is the same even though this search is done from Advanced Search where we search through whole database.

Update root version of Draft to latest Master

Issue [HDC-4195

When working with Drafts, a Draft always originates from a specific Master version. When user makes changes to objects in a Draft, only these changes are stored. All other, unmodified objects reflect their state as it was in that original version. 

When in the meantime there are other updates published to Master archive, they will not be visible in that Draft. In order to be able to see these changes, a new function for Drafts called "Update Root" is available. 

This function will change the originating (root) version of the draft to latest version in Master Archive, so that user can see latest changes.

Objects that are modified in the Draft will not be affected by this operation - they will still be "on top" of other changes, regardless of the point in time they were made. 

When not to update

During publish operation only changes made in a Draft are moved to Master Archive, so it is not necessary to update root before publish. It will have no effect on what is actually published. 

When to update

Update is advised if you will be modifying part of the metadata and you would like other, unmodified fields to have latest values.

All metadata from a modified object will be published as a complete set (one record).


Pleas note the status column on the screenshot below. It indicates if the specific Draft originates from a Master version that is currently latest or not.

Possible status values are:

  1. Latest - This Draft is based on latest Master version,

  2. Outdated -  New Master version is available. Use [Update Root] to change

To change the Root version, please use "Update Root" button. A confirmation will be shown, after user selects Yes option, a draft root version will be changed:

Update Root function is also available as a context menu for Drafts:


Possible conflics

Update root operation validates Master's Archive objects versioning history. Operation will not be allowed when any of the objects that are modified (or deleted) in draft has been already deleted from Master Archive.

Same check is applied to objects which were linked with each other in Draft.

In such situation following error would be shown: "Operation not allowed - inconsistent versioning history".


Option to search for objects by their MasterGUID

Issue [HDC-4266

An option to search by system / Master GUID was added to Search window. This function is especially useful for system administrators willing to check if an object with a given system GUID was already registered in the system. 

Master GUID is a special property of an object and it is not a part of user editable metadata, therefore it cannot be searched for with standard search functions. 

To start this function, please open Advanced Search and select Master GUID Search:


Enter or paste one or more GUIDs in the available text area. GUIDs can be pasted in any form, e.g.

  • one under another
  • comma separated
  • JSON list of GUIDs

As long as the system can recognize and extract GUIDs you should be able to paste any form, so that you do not have to prepare the list in advance. 

Some examples:

The results include:

  • Action columns to navigate to object (if object is found and available in current version), object location, object metadata and object information (data source, versions)
  • Master GUID
  • Object exists column indication of the object was found in the system or not
  • ID, class ID and class name if object was found.


Open Composite Drawing Manager from Drawings&Layers toolbar

Issue [HDC-4235

We have added a shortcut from viewer toolbar to Composite Drawing Manager.


On Drawings&Layers dropdown choose a layer. Then click on a button next to it and CDM will open on selected Layer. Shortcut to chosen overlay or raster is also possible.

Clicking on Details button will open another dialog in CDM with selected layer's details - style and list of spots.



Temporary symbols added to first visible global layer

Issue [HDC-4235

Temporary symbols will be added to first visible global layer now - before they could be placed on hidden layers so they would not show on a printout.


Administrative related changes

New  modes for data versioning system

Issue [HDC-4193] - Option to allow updates in master version when "newer version exists"

Issue [HDC-4252] - Control operations allowed in Master Version (View/Add/Edit/Delete)


There are extensive changes in the data versioning system that introduces new options:

  • Allow modifications if newer version exists
  • Allow modifications of past versions


For the relaxed mode in Master archive, new options to restrict editing:

  • Allow add operations in Master archive 
  • Allow update operations in Master archive 
  • Allow delete operation in Master archive


Read more in Versioning Modes section of this article: Version Management


See parent version for draft

In Archive Manager and in Main interface when working on draft, user can see draft's parent (origin version) using ne button Root Version.

Main Interface:

Archive Manager:

User can see root version for each draft he can see in this panel.
Window that will be shown will have draft's name in title and details about parent version in main section.



Configure default values for newly created objects

Issue [HDC-4265]

SINCE V.4.6.1


There is a possibility to set default value for object metadata fields.
Each class can have a default value set for each field.

This default values will be added only at object creation currently (manually or by import).

Values put as default in this panel are not validated in any way (for example text can be put into number field).
Validation is done when new object is created and if types of data are not correct then the object will not be added.


For Boolean type of data use only true or false values as default ones.


Change in System Settings organization

Issue [HDC-3801]

System Settings were re-organized using subtabs to easier find desired settings in constant growing number of parameters.


The main change is adding multiply sub-tabs for General Settings and new System Services main tab, grouping settings in more clearer way. 

Please referrer to System Settings page for more details.


New setting - Custom Toolbar button

Issue [HDC-4240]

System/Settings/General Settings/System Style now consists of new section called Custom toolbar button.

Those settings will allow to set desired text on custom button, it's icon, url link and tooltip. The button is placed on top main toolbar.

New settings - hide/show Flex Search

As "Flex Search" function was not finished, it's usage is limited. Even that it is present in Panels list button.

Administrators can now hide Flex Search from the Panels list button using setting in System/Settings/General Settings/System. 

If options is not checked then the "Flex Search" option will be removed from available panels list.


By default, since version 4.6.0, this option will be set to false so Flex Search will be hidden on all databases.


Possibility to edit existing field validation conditions

Issue [HDC-4006]

Field Validators - existing conditions are now editable (before only Delete action was possible).


Persistent client side logs

Issue [HDC-4227]

Now frontend side errors and log entries are saved as logs on server. This allows to detect, monitor and investigate user problems that take place in the browser.


Icon preview on the admin panel

Icon preview is now available on the list view. Additionally, icon list can be filtered by name. 

User interface branding

Issue [HDC-3897]

Various elements of login page and application start screen can be modified using system settings. 

To make changes, go to Administration - System Settings - General Settings - System Style:



Options in General section:

  1. Name - this is the application title used as header - required when main logo is not provided. 
  2. Subtitle - this is a subtitle shown under main header. in can be used together with the main title (Name) or with main application Icon. Will be omitted when left blank. 
  3. Title Bar Text - text shown in browser title bar - required. 

Options in Colors section:

  1. Background - this content will be used as an background image. Default setting includes a light, vector based pattern.
  2. Background Color - background color used on startup screens.
  3. Main text color - color used for main texts (like application title)
  4. Secondary Text Color - color used for secondary smaller texts like "Privacy policy"

Options in Icons section:

  1. Icon - name of main icon file (application logo)
  2. icon width - width of the main icon in px
  3. Fav Icon - file name of icon to be used as fav icon (visible in browser tab)
  4. System logo - used as logo in the main interface
  5. System logo width - width to reserve for logo on application toolbars

Options in Provider section:

Additional section used below login screen

  1. Provider name - name to be used as Alt text in icon
  2. Provider link - link to be used under provider icon
  3. Provider icon - additional icon to be used below login screen
  4. Provider icon width - width of the icon to set

(warning) Note: icons must be specified by file name. File must be uploaded to system configuration directory into SystemStyle directory. Files cannot be uploaded via API/GUI.

Bug fixes and other improvements

  • HDC-4281 Changing versioning strict/relaxed requires use of Clear Cache button

  • HDC-4205 Use best level of tiles for PDF printout

  • HDC-4209 Internal Export - units in TAF are wrong

  • HDC-4245 HOPA with MM=1 fails - Invalid number of points in LinearRing

  • HDC-4269 User cannot manage their own redline layer without EDIT permission in Security Scheme

  • HDC-4290 Filter in metadata column does not work with "Subtree" function activated

  • Improvements in cache system for improved performance and correctly updated data

  • Improvements for import performance and memory usage