New features, improvements and bug fixes done for version 2.2.0

New button View Snapshots (replaces old More button) will open Snapshot (versions) dialog with buttons to create/edit/open desired version.
Publish will take draft's Name and Description to Master Archive (even if there are snapshots with different names).
Published versions can be have Name and Description edited. This can be done only by users with Advanced Archive Manager role.

New type of import → "ObjectData"

Done under JIRA issue [HDC-2073] - import from excel to update existing objects

New type of TDXM import has been added to HDC. It's called ObjectData.

This import can only update metadata of objects by reading list of objects from excel (.xls) file using mapping done in External Domain.

ObjectData import cannot add new objects, documents or raster files.

Preparing package for ObjectData import

Package for this import requires that zip contains only one .xls or .xlsx file.

Each excel file should have tab or tabs called as object classes to be updated.
Those excel files can be prepared manually or they can be exported from HDC and then updated.

To create automatic sheet with objects, select array of objects on HDC Tree and then export connected objects from Grid panel using Export button. Exported objects can come from currently chosen tab (Export button) or objects from all tabs in current perspective (Export all button).

On screen above we can export just "Arkitekt" class objects or all objects from Grid panel connected to array of objects selected on Tree panel.
Such .xsl file can then be edited and updated with desired changes. File should be zipped, uploaded as ObjectData package and then it can be imported using created External Domain.

Preparing External Domain in TDXM for import

Object Classes

When preparing External Domain which will be used for class and field mapping you can import Object Classes from XLS file you are going to import data from.

Go to External Domain\Object Classes
Click on Import button and select XLS
Choose file from disc

Class names will be taken from sheet's tabs and class fields will be taken from columns headers.

This step is not needed if you are going to have prepared sheets without 1st row having class fields names.
In such case as class fields for all object classes you can use excel columns names - A, B, C, D etc.

Object Mapping

Class and fields mapping is done in same way as in other imports types.
If A, B, C.. columns are used then they need to be normally matched with target fields.

TOBIS

All classes requires that one field is matched as TOBIS as per other imports.

Updating field that is matched as TOBIS is not possible as such object will not be found during import process.

Performing import

ObjectData import has only one import option

Use 1st row as class fields - declares whether first row in excel file should be treated as class fields names or not.

Batch download of document's content

Done under JIRA issue [HDC-2181] - Batch download of files via object set window

Current implementationonly allow to download attachments, raster drawings and their TAF files.

Select number of documents on Grid panel.
Add them to object set with Add to OS button above document list.
On the object set window, select all or some of documents using checkboxes and click on Download button.
A ZIP file containing documents contents will be prepared prepared and delivered to you based on your browser settings.

ZIP file downloaded name is <site_name>_<timestamp>.zip
Timestamp format is <year-month-day-hour-minute-second> (without hyphens)
Files downloaded names are <document_label_field>_<orignal_file_name>.extension

Integration - Custom Menu Items

Done under JIRA issue [HDC-2156] - Custom right-click context menu items for DocView

User right-clicks one or more rooms and the usual menu is shown but with additional items provided by external application.

Clicking an item provided by external application triggers provided callback function.

Detailed description is here.

Select root on application load

Done under JIRA issue [HDC-2219] - How to get document to load automatically on root object in FM Access?

When new option Auto Select Root is checked then Root object (for Tree default perspective set) will be selected and default document on Grid for this object will be selected.

This is global settings for all users.

Reports improvement to XLS import type

Done under JIRA issue [HDC-2141] - Import log for Excel package to show more useful information

Improvements to XLS import type were done. Some safety guards have been introducing so some error (corrupted data in XLS) is now ignored.

Also several situations that resulted in failed XLS import without proper error message are not handled and proper error message is presented so that it's should be easier to fix package/domain configuration and run import again.

Most common situation is when Document to be imported from XLS stylesheet cannot be connected to target object in Tree as this object is not present in target DB.

Such situation will Result in import status Finished with Errors. In reports section on, Objects tab those not imported documents will be listed.
Error message will be provided with name of object that was not found in database.

Error reported is

Hierarchy matching for object failed during matching: id Rotundan 3/Byggnad 1/Plan 01 - KV -3TR, source class 105 and destination: id 006537225584, destination class 110

That means that document of external ID 006537225584 (HDC destination class 110) cannot be linked to object of class 105 that have path Rotundan 3/Byggnad 1/Plan 01 - KV -3TR in Perspective used for import. In this case Floor Plan 01 - KV -3TR did not exist.

TOBIS Field not set for class - this will be reported in Unmatched tab
Objects present in XLS sheet but without mapping in domain configuration - will be will be reported in Unmatched tab.

Document added but content not attached. This can happen when path to file (that consist of 3 columns in excel) is not fully filled.

Such situation will be visible both on Objects and Unmatched tab of import reports.

Bugs fixed for this version

[HDC-2196] - Document Links are not imported - kbb.bim.cloud
[HDC-2205] - Undelete operation corrections
[HDC-2207] - Console errors when document does not have content
[HDC-2208] - Error showing composite document with empty text on vector layer
[HDC-2209] - AV manager additional fixes after improvements
[HDC-2217] - Ihus Ldap does not work
[HDC-2171] - Supplement missing attributes for deleted files

API Changes

(check /apidocs for more details about new/changed webservices)

New Webservice
PUT /api/av/history/json/{versionId}
Edit snapshot's name and description.
New Webservice
PUT /av/advanced/history/json/{versionId}
Edit Published version name and description.

New Webservice
PUT /admin/tdxmconfig/importconfig/xls/{domainId}
Import XLS file to write down Object Classes and their fields to chosen External Domain.
Modified Webservice
POST /perspective/metadata/xls/{perspectiveId}
added QueryParam isBatchExport - default is set to "false"

Modified Webservice

GET /av/history/json

- versionLabelDescr field was added to response
- versionLabel field removed
Modified Webservice
POST /av/alternative/version/{alternativeId}
Publish draft - added json payload:
```
{"versionName":"MyVersionName","versionDescription":"MyVersionDescription"}
```

HyperDoc (HDC) Manual

Release notes for version 2.2.0

Table of Contents

Version / Draft Changes Visualization

New HOPA Parameter - MaskMode

Copy (duplicate) spots to Redline

Copy / paste spots

Single selection drag point for multi-selected spots/groups

Improved Archive manager labels and published version displaying draft's description