Document toolboxDocument toolbox

(no) Asset DB Sync

Owned by Tom Wyczółkowski
Jun 28, 2022
3 min read

Translation needed

The content of this page was copied from another page tree and needs to be translated or updated.

When you finish translation, make sure to

  • Replace the label NEEDS-TRANSLATING with TRANSLATED

  • Remove this macro from the page

 

Configuration

  1. Asset module must be added to customer license to be working in FM Access,

  2. Set up External Domain with correct classes and their mapping,

  3. Enable AssetConector plugin in this External Domain/Live Data Source tab,





  4. Enable autosync user in Admin Panel/Users&Groups/Users (by default it's added as inactive). User should have adjusted proper rights and permissions.

  5. Set up proper configuration in Admin Panel/System Setting/Other/Faciliate Asset 3D

  6. Check Enable automatic synchronization checkbox if you want to have automatic sync working.
    You can also set period of time for sync operation to happen using Asset sync minutes period param. 
     Please note that after changing it's value, site should be recycled so new time period is used.





Only objects existing both in Asset and FM Access can be synced. Object relations are not synced.

 

Auto Sync

  • Push and Pull actions,

  • done once per hour without action,

  • done on object update, import (push action only),

  • incremental based on update date (newer is taken).


If major error occurs in Auto-Sync, "Last execution" column will not be updated. Only finished ones will have their execution time saved. Such error will be reported in Import Log.

 

Manual sync

  • done on specific object per user action ( in Tree, multi-selection is allowed),

  • when pulling, takes data from Asset DB regardless which one is newer,

  • when pushing, takes data from FM Access regardless which one is newer.

To perform manual sync of object, right click on it in a Tree or Grid view and then select External to choose whether to send or receive data from Faciliate Asset.

 

 

Monitoring

When synchronization is done, it will be visible in TDXM in Import Log.

Details tab will note whether the sync was push/pull action as well manual/auto sync action:

  • Stage: CallPlugin AssetConnector Push to Asset - auto-sync push task (see also it was started by autosync user).

  • Stage: CallPlugin AssetConnector Manual pull from Asset - manual update done by user.

In case of Auto-sync task, changed object will be updated based with data from the system in which change is newer.
This can be observed in Import Log, on Objects tab. The color of Operation icon will indicate whether the version of object was taken from FM Access or Asset:

  • red icon 

    : properties taken form FM Access db

  • blue icon 

    : properties taken form Asset db.

 

Object Properties 

It is possible to check object properties from Faciliate DB in FM Access.

Choose Faciliate Asset tab in Object Properties window.

 

Troubleshot

  • Error: Multiple objects mapped to asset object type XXX, guids: YYY, ZZZ 

    That means that somehow more than 1 object in FM Access has the same guid. Auto sync cannot be done, unless all of these objects have distinct guid. 
    One can manually change guids for these objects or remove them. To prevent such case it is recommended that synced guid field with Asset is of type GUID in FM Access.


  • It may occur that object in Asset has different category than configured in import domain - in such case a following message in object detail report will be generated.