New features, improvements and bug fixes done for version 4.9.0

Table of Contents

User related changes

New Functionality

Option to display all tabs in Grid view

New System and User setting to control visibility of object/document tabs in Grid View.

When this option is enabled, Grid View will include all allowed tabs. If its disabled, only tabs with content will be shown.

Display geolocation information for objects (NOT DONE YET)

Issue [HDC-4495]

By using Object Information panel, users can now check if there is a geo location stored for that object.

Data displayed is specific for a selected system version. Data can be displayed in native format or in WGS84 reference system.

Verify spots option

Issue [HDC-4419]

It sometime happens that some spots after import to FM Access gets into wrong place (due to units or insertations points mismatch).
This will couse an effect in viewer that nothing is shown at first glance.

But the groups of spots can be placed in opposite corners of a drawing (so the initial zoom tries to show whole extents).

If this happens you can activate Verify Spots option.

When checked, enter Edit mode and then use the Reload button from the toolbar.
If the Verify function enctoures seperated groups of spots then this window will appear:

Click Yes if you want to check those groups of spots. You will be zoomed in to first group of spots.

Click Yes to delete those spots, if they are wrong/not needed or No to leave them and zoom in to next group of spots.
After removing troublesome spots, the drawing should display correctly.

Change Requests related changes

New Functionality

Issue [HDC-XXXX]

Data Exchange changes

New Functionality

Issue [HDC-XXXX]

System Administration changes

Allow to change Internal group name in FM Access

Issue [HDC-4433]

Changing group name in Groups panel from FM Access is now possible.

Panel listing groups now also includes information about Group Category

System Group - built in system group (name can be changed, but function of the group will be dictated by its Type)
User Group - user defined group

Group Types:

System users - always includes all system users
Standard - members are controlled by a system administrator.

Changed name will also be reflected in the security administration panel:

Warning: make sure your group mappings reflect the new group names. (Identity Providers - Mappings)

Improved MasterGUID (FMGUID) Handling

MasterGUID (FMGUID) is a unique identifier for an object. In a typical scenario, it should never be changed and must remain consistent across all integrated systems.

There were several limitations with this property, as it was not stored as part of the object's metadata, and the identifier was maintained as unique across versions and drafts.

This release introduces several improvements to how we handle this identifier and expands the user's capabilities regarding it.

Support in Quick Search

Now, any object can be found using QuickSearch and its associated MasterGUID.

QuickSearch will automatically check if a query is a GUID and, if so, return any matching results from the MasterGUID registry.

Note: A search by MasterGUID will be performed if the query string is a valid GUID.

Partial match is not supported in this type of search.

Support in Advanced Search

Advanced search functionality now enables users to search for specific objects using their GUIDs.

Every object class now includes a new system field called MasterGUID, which is searchable.

Note: When a GUID field is selected, a query string must be a valid GUID.

Edit MasterGUID

In rare cases where objects are registered with an incorrect MasterGUID, you can update the MasterGUID from the object edit form.

Please note that this operation will update the master object registry, resulting in the selected object having a new GUID registered across the system, affecting all versions and drafts. Exercise caution when performing this operation.

Select edit button located next to a GUID field:

Note:

GUID field cannot be updated together with other metadata
In addition to edit permissions for the object, an Administrator role is required. (Access Basic Admin Operations)

Change the GUID and save.

MasterGUID in API Calls

Several API calls now support the direct use of MasterGUID instead of ObjectClass and ObjectId.

If an integrated system has access to MasterGUID, there is no need to go through the object translation process to obtain the internal ID. This simplifies and streamlines API interactions.

HOPA Calls

A MasterGUID can be used to identify object. ObjectId and ClassId are not needed in that case.

Sample call: http://localhost:8080/HopaGetView4Object?guid=2a58a5bc-0b46-4ae1-8f4f-85492d3d984d&DocumentForSpot=1&Width=600&Height=801&SpotMarginPercent=122&psetId=17

Samples

Update object metadata by GUID:

PUT /object/byguid/json

{
    "metadata": {
        "space_descr": "KORRIDOR 22",
        "space_bra": 25.79,
        "space_nta": 22.04,
        "space_bta": 25.3
    },    
    "systemGuid": "e5668597-eceb-4e11-8b38-483f56350bfe"
}

Check if object(s) exists by GUIDs

POST http://localhost:8080/api/object/byguids

Payload

{
    "list": [
        {
            "systemGuid": "a026793b-fac4-4599-a52f-be81fe9971f3"
        },
        {
            "systemGuid": "ab91b37c-7cc4-4a5a-861e-9d3aa8aff9f8"
        },
        {
            "systemGuid": "a8c47e9b-63a8-456e-a1a6-9b330e669961"
        },
        {
            "systemGuid": "1b121e84-8c73-4072-8328-df07e5675231"
        },
        {
            "systemGuid": "d159e390-b0d2-4247-81af-2e056d258474"
        }
    ]
}

Response

{
    "list": [
        {
            "classId": 134,
            "objectId": 5420,
            "systemGuid": "d159e390-b0d2-4247-81af-2e056d258474"
        },
        {
            "classId": 134,
            "objectId": 5416,
            "systemGuid": "a026793b-fac4-4599-a52f-be81fe9971f3"
        },
        {
            "classId": 134,
            "objectId": 5418,
            "systemGuid": "1b121e84-8c73-4072-8328-df07e5675231"
        },
        {
            "classId": 134,
            "objectId": 5425,
            "systemGuid": "a8c47e9b-63a8-456e-a1a6-9b330e669961"
        },
        {
            "classId": 134,
            "objectId": 5415,
            "systemGuid": "ab91b37c-7cc4-4a5a-861e-9d3aa8aff9f8"
        }
    ]
}

Fetch Metadata for object by GUID

GET http://localhost:8080/api/object/byguid/json/e5668597-eceb-4e11-8b38-483f56350bfe

Response:

{
    "metadata": {
        "hdid": 3989,
        "space_id": "101",
        "space_name": "101",
        "space_descr": "KORRIDOR 22",
        "space_bra": 25.79,
        "space_nta": 22.04,
        "space_bta": 25.3,
        "space_guid": "8a71f4f5-0548-4670-8f56-24ef3cbc016a",
        "space_ru_nr": "403-13-2063"
    },
    "contentType": 0,
    "contentId": 0,
    "securityMask": 71,
    "ssid": 1,
    "classId": 135,
    "objectId": 3989,
    "objectName": "101",
    "systemGuid": "e5668597-eceb-4e11-8b38-483f56350bfe"
}

A list of services supporting GUID as an object identifier can be found in API Docs by query "byguid".

Object API

/object/byguid/eraseproperty
/object/byguid/json
/object/byguid/linkedspots
/object/byguid/erase/{guid}
/object/byguid/group/json
/object/byguid/json/{guid}
/object/byguid/link/{srcGuid}
/object/byguid/linkedspots/{guid}
/object/byguid/links/{guid}
/object/byguid/path/{guid}
/object/byguid/undelete/{guid}
/object/byguid/unlink/{srcGuid}
/object/byguid/default/{guid}/{perspectiveSetId}
/object/byguid/defaulthyperlink/{guid}/{entityId}
/object/byguid/group/properties/json
/object/byguid/hyperlink/{srcObjectId}/{dstGuid}
/object/byguid/link/{dstGuid}/{srcGuid}
/object/byguid/list/json/{guid}
/object/byguid/versions/json/{guid}
/object/byguid/link/default/{guid}/{perspectiveSetId}
/object/byguid/link/default/{dstClassId}/{dstObjectId}/{srcClassId}/{srcObjectId}/{perspectiveSetId}

Perspective API

/perspective/byguid/entityarea/xls

/perspective/byguid/json/{perspectiveId}/{contextGuid}

/perspective/byguid/metadata/json/{perspectiveId}
/perspective/byguid/metadata/xls/{perspectiveId}
/perspective/byguid/metadata/json/{perspectiveId}/{contextGuid}
/perspective/byguid/metadata/json/{perspectiveId}/{requiredObjectId}
/perspective/byguid/metadata/selected/{outputType}/{perspectiveId}
/perspective/byguid/parent/json/{perspId}/{contextGuid}
/perspective/byguid/subtree/json/{perspId}/{contextGuid}
/perspective/byguid/tree/json/{perspId}/{contextGuid}
/perspective/byguid/metadata/json/{perspectiveId}/{contextGuid}/{requiredObjectId}

Presentation API

/presentation/byguid/json/{drawingId}/{presentationId}
/presentation/byguid/filters/json/{drawingId}/{presentationId}

Search API

/search/byguid/advanced/objects/{childClassId}

Bug fixes and other improvements

paste link here

API Changes

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

Issue [HDC-XXXX] - Issue name

Old Webservice:
METHOD /PATH
New Webservice:
METHOD /PATH

Release notes for version 4.9.0

User related changes

New Functionality

Option to display all tabs in Grid view

Display geolocation information for objects (NOT DONE YET)

Verify spots option

Change Requests related changes

New Functionality

Data Exchange changes

New Functionality

System Administration changes

Allow to change Internal group name in FM Access

Improved MasterGUID (FMGUID) Handling

Support in Quick Search

Support in Advanced Search

Edit MasterGUID

MasterGUID in API Calls

Bug fixes and other improvements

API Changes