Introduktion

Systemet kan utföra metadatasynkronisering med Asset+ tjänst från Service Works Global.

Metadata för objekt synkroniseras åt bägge håll. Om konflikter upptäcks (data har uppdaterats i bägge systemen sedan senaste synkronisering), måste objektet "migreras" manuellt av användaren. 

Live datavy mot Asset+

Systemet stödjer visning av live data från Asset+ i en dedikerad extern objektflik.

Denna visar även omappad metadata om objekt direkt från Asset+ servern.

För att aktivera vy, skapa en ny extern informationsdomän, EID, och aktivera Pluginen AssetPlusConnector under fliken "Datakälla för live datatjänst": 

Open

Open

Synkronisering av objektmetadata

Automatisk synkronisering

Då Automatisk synkronisering är aktiverad (se avsnittet Konfiguration), så synkroniseras alla ändringar automatiskt till Asset+ servern.

Synkronisering sker vid händelser t.ex. omedelbart då ett objekt sparas. Data som uppdaterats i Asset+ hämtas enlig schema, t.ex. var 5:e minut.

Manuell Synkronisering

Manuell synkronisering kan köras från Synkroniseringshanteraren. Manuell synkronisering körs vanligen bara för objekt i speciell synkroniseringsstatus, t.ex objekt där automatisk synkronisering misslyckats.

Fönster för synkroniseringsstatus

Synkroniseringshanterare

Synkroniseringsstatus

Initial synkronisering

Processen för en initial synkronisering kan startas genom att använda funktionen "Full synkronisering"

 Varning - då "Full synkronisering" körs reinitialiseras synkroniseringsdata och data från Asset+ kommer alltid att användas, vilket innebär att data som finns i FM Access i fält som synkroniseras med Asset+ kommer att skrivas över med det data som finns i Asset+.

Om datat är identiskt i de båda systemen kommer inga ändrigar att göras och objekten sätts i status "Synkroniserade". Denna körning kan göras närsomhelst men kommer alltid att resultera i att datat i Asset+ synkroniseras till objekten i FM Access om det finns olikheter. 

Synkronisera alla

Synkroniserar data för alla objekt som visas i listan. Detta är en funktion som kontrollerar att det inte finns nyare förändringar som inte synkats i FM Access, men den hämtar även data från Asset+ som jämförs med datat i FM access. Om ändringar hittas utförs synkronisering av de hittade objekten.

Synkronisera valda

Samma funktion som "Synkronisera alla" men utförs enbart för markerade poster i listan.

Exportera

Exporterar visad lista till excel. 

Migreringsprocedur

Objekt som har status "Konflikter" bör migreras. Konflikter innebär att det inte går att synkronisera data till Asset+ utan att skriva över något som är uppdaterat efter senaste synk. Data måste då migreras av en användare som aktivt bestämmer vilket data som är korrekt och skall synkas till bägge systemen.

Det kan hända att synkroniseringen registrerar konflikter även för data som inte finns mappad i synkroniseringen. Systemet känner av senaste uppdateringstiden för objektet men kan inte se om det gäller data i de fält som synkroniseras med FM Access, därför kan data se helt identiska ut i synkroniseringsfönstret. Det krävs ändå att data markeras och synkroniseras av användaren, annars kommer inte den automatiska synken att fungera för dessa objekt.

Objekt med konfliktstatus, synkronisering kommer inte att genomföras:

Välj funktionen "Sammanfoga", använd sedan vänster- / högerpilarna för att välja rätt data att migrera. Då allt ser korrekt ut kolumnen "Sammanslagen metadata" välj "Spara sammanslagen metadata". Det sammanslagna datat kommer nu att uppdateras i bägge systemen. 

Konfiguration

Systeminställningar

Välj Asset+ vid "Assetversion" och korrekt extern domän som innehåller fältmappningen mellan FM Access och Asset+. 

Aktivera även Automatisk synkronisering och välj den användare vars behörighet ska användas vid denna schemalagda synkronisering. Användaren måste ha behörighet att redigera alla objekttyper och de metadata som angivits i mappningen i den externa domänen.

Ställ även in hur ofta den automatiska synkroniseringen ska köras. 

Under fliken "Andra" måste ett antal parametrar ställas in, markerade med röd rektangel i bilden nedan:

• asset_api_key, denna nyckel är unik för varje uppsättning och ska komma från Asset+

• assetIdp_name, asset-kc-oidc

• asssetIdp_audience, asset-api

• assetIdp_subjectField, email

• asset_api_url, denna url är unik för varje uppsättning

Inställningar i Externa Informations Domäner (EID)

Skapa en extern domän som anväds för att konfigurera mappningar mellan objektklasser (kategorier) i systemen.

Definiera alla kategorier och deras metadatafält som ska mappas från Asset+:

Mappa sedan till respektive fält i FM Access:

 OBS:

• fälttyper måste matcha mellan systemen: datumfält till datumfält, textfält till textfält, nummerfält till nummerfält, osv. 

• GUID- / ID-fält behöver inte anges - alla objekt identifieras automatiskt via systemGUIDar (FM GUID i Asset+ och MasterGUID i FM Access)

Autetiseringsinställningar

Autentisering mellan FM Access och Asset+ baseras på Identity Provider konfiguration i KeyCloak.

För datasynk används anges ett användarkonto i systeminställningarna i FM Access. Samma användare måste finnas med rätt behörighet i Asset+ (identifieras via emailadress som ska vara samma i bägge systemen).

Dataaccess för 3D-vy och live metadataflik baseras på inloggad användare. Användare med samma email måste finnas i Asset+.

Skapa en ny Identity Provider:

• Öppna KeyCloak som administratör och välj Identity providers välj Add Provider och välj OpenID Connect client.

• Alias, asset-kc-oidc måste vara registrerat i systeminställningarna för Asset+.

• Använd URL till en välkänd Asset+ endpoint

  • https://sso-test.serviceworksglobal.cloud/auth/realms/AssetDB/.well-known/openid-configuration (detta är bara ett exempel)

• Ange valid Client ID och Client Secret

 Notera: denna Provider krävs för att utväxlingen av tokens mellan systemen ska fungera. Den baseras på Client ID och Client Secret.

Providern kan även användas för SSO login mellan FM Access och Asset+, om så önskas.