Activering en informatie over de integratiemodule Space Management

Opmerking

Dit artikel gaat over de stappen die nodig zijn om de integratie van Space Management te activeren vanuit het perspectief van Asset. Voor de volledige end-to-endintegratie is het echter ook relevant om het Spacewell Integration Platform (router) en de Space Management-applicatie in te stellen. Dit specifieke artikel is daarom slechts 1 van de benodigde stappen en het wordt aangeraden om de volledige implementatie te starten via de algemene pagina ‘Integratie van Space Management’ (te vinden via Implementatieconsultants → Standaardintegraties → Integratie van Space Management). Een van de stappen in die artikelen verwijst u terug naar dit artikel!

1. Integratie van Space Management in het algemeen

De Space Management-applicatie is ontworpen om alle gebouwgerelateerde mastergegevens te centraliseren en dient als primaire gegevensbron voor andere Spacewell-applicaties, zoals Asset, Workplace en Energy. Door één centrale bron te gebruiken, hoeft dezelfde masterdata niet meer in meerdere applicaties te worden onderhouden

2. Waar gaat deze module over

Deze module maakt de integratie tussen Asset en de Space Management-applicatie mogelijk. Gebouwgerelateerde mastergegevens die in Space Management worden bijgehouden, worden gesynchroniseerd met Asset, waar ze in verschillende modules kunnen worden gebruikt.

Zie voor meer informatie over de gerelateerde masterdatamodule in Asset:

3. Waarom deze module gebruiken

Als Space Management (als product) wordt gebruikt en mastergegevens zoals gebouwen, verdiepingen en gebieden ook in Asset worden gebruikt (bijvoorbeeld voor gebruik in andere modules zoals Onderhoud), is het relevant om deze integratie in te stellen. De ruimtelijke gegevens hoeven dan maar op één locatie (Space Management) te worden onderhouden en blijven ook in Asset up-to-date.

4. Deze module activeren

Gebruik, zoals voor elke nieuwe module, de optie ‘Module activeren’ op het startboard van de beheerder (alleen beschikbaar voor beheerders van niveau 2 en niveau 3). Zie Module activeren voor meer algemene informatie over deze opties voor het activeren van modules.

De integratie van Space Management heeft een configuratiehandleiding voor de Space Management-applicatie, het Integration Platform en Asset. Deze configuratiehandleiding is te vinden via: Configuratiehandleiding Integratie van Space Management. Het activeren van deze module is slechts 1 stap in de volledige configuratiehandleiding voor de integratie van Space Management.

Deze module inschakelen wanneer de klant geen gebruikmaakt van Asset Baseline

Deze module inschakelen wanneer de klant geen gebruikmaakt van Asset Baseline

Voor klanten die geen gebruikmaken van de Asset Baseline is er geen activeringsproces voor modules waarmee automatisch de relevante objecten en instellingen worden aangemaakt. Zorg ervoor dat u het volgende uitvoert:

  1. Maak de API-connector (integratie van Space Management) handmatig aan via Clientinstellingen → Verificatie. Stel deze in op actief en zorg ervoor dat inkomende webservices zijn toegestaan.
  2. Deze integratie gebruikt een FTP-connector om de gebouwen en gebieden bij elke update in Space Management te importeren. Om voor elk type locatie de juiste categorie te bepalen, kan op klantniveau een fieldmap-item worden toegevoegd aan de root-fieldmaps. Via dit item kan de relevante aangepaste categorie worden bepaald. Als dit niet gebeurt, wordt per object (Property of Area) de eerst beschikbare categorie gebruikt. Dit is mogelijk niet het gewenste gedrag.

Dit is al gedaan in de Asset Baseline voor klanten van Asset Baseline. Deze FTP-connector is te vinden via de API-connector:

image-20260917-093017.png

Deze bevat een lijst met fieldmaps:

image-20260917-093335.png

In elke gekoppelde fieldmap die betrekking heeft op een Property- of Area-object kan een fieldmap-item worden toegevoegd (door een bestaand item te kopiëren). U kunt het beste een voorbeeld van een klant met Asset Baseline gebruiken om te zien hoe u dit per fieldmap doet.

Hieronder staat een voorbeeld voor de fieldmap voor gebouwen:

image-20260917-093226.png

Zodra de bovenstaande stappen zijn uitgevoerd, kan de rest van de configuratie en integratie worden uitgevoerd volgens de stappen voor het instellen van deze integratie in de integratiehandleiding Configuratiehandleiding voor de integratie van Space Management.

4.1 Vereisten voordat deze module wordt geactiveerd

Voor de integratie van Space Management moet de module Masterdata: gebouwen en gebieden zijn geactiveerd.

Zie voor meer informatie over het activeren van deze module:

4.2 Module activeren

Voor deze specifieke moduleactivering wordt de externe app automatisch gegenereerd en correct geconfigureerd. De aanvullende configuratiestappen in het Integration Platform en in de Space Management-applicatie worden beschreven in de configuratiehandleiding.

image-20260420-070326.png

Er zijn momenteel geen instellingen die moeten worden bepaald.

Info

Zodra de integratie van Space Management is geactiveerd, komen verschillende rapporten voor gegevensexport beschikbaar. Deze rapporten worden weergegeven tijdens het activeren van de module en zijn ook toegankelijk via het tabblad ‘Module-instellingen’ → ‘Integraties’ → ‘Integratie van Space Management’.

Als een klant al gebruikmaakt van Asset en de Space Management-applicatie wil gaan gebruiken, kunnen de vereiste gegevens vanuit Asset met deze rapporten worden geëxporteerd en vervolgens in Space Management worden geïmporteerd. Vanaf dat moment wordt de Space Management-applicatie de primaire bron voor de mastergegevens van gebouwen.

4.3 Gegevensimport

Info

De integratie van Space Management gebruikt een FtpConnector en vooraf gedefinieerde importtoewijzingen om gegevens met Asset te synchroniseren. Deze importtoewijzingen zijn uitsluitend bedoeld voor automatische synchronisatie en mogen niet worden gebruikt voor handmatige imports.

Wanneer de externe app tijdens het activeren van de module automatisch wordt gegenereerd en geconfigureerd, wordt er ook automatisch een FtpConnector aan gekoppeld. Deze FtpConnector bevat verschillende importtoewijzingen die worden gebruikt om gegevens vanuit de Space Management-applicatie met Asset te synchroniseren.

De automatisch gegenereerde FtpConnector ‘Import Space Mgmt, Location’ bevat de volgende importtoewijzingen:

Referentie

Naam

Beschrijving

FM-0093

Space Mgmt to Axx, Location 00 TimeZone (Address)

Deze FieldMap wordt gebruikt om de TimeZone van een Site of Building uit Location Master Data te importeren. TimeZones worden opgeslagen in het Address dat aan een Property is gekoppeld.
De uniqueReference van de Property wordt als foreign key gebruikt via Address.externalReference.

FM-0092

Space Mgmt to Axx, Location 01 Region (Property)

Deze FieldMap wordt gebruikt om Regions uit Location Master Data te importeren.

FM-0091

Space Mgmt to Axx, Location 02 Site (Property)

Deze FieldMap wordt gebruikt om Sites uit Location Master Data te importeren.

FM-0090

Space Mgmt to Axx, Location 03 Building (Property)

Deze FieldMap wordt gebruikt om Buildings uit Location Master Data te importeren.

FM-0089

Space Mgmt to Axx, Location 04 Floor (Area)

Deze FieldMap wordt gebruikt om Floors uit Location Master Data te importeren.

FM-0088

Space Mgmt to Axx, Location 05 Space (Area)

Deze FieldMap wordt gebruikt om Spaces uit Location Master Data te importeren.

FM-0087

Space Mgmt to Axx, Location 06 Subspace (Area)

Deze FieldMap wordt gebruikt om Subspaces uit Location Master Data te importeren.

Zie voor meer informatie over gegevensimports in het algemeen: Gegevensimports

4.4 Systeemgroepen

Voor deze moduleactivering zijn geen aanvullende systeemgroepen relevant. Omdat deze module betrekking heeft op de integratie van Space Management, zijn de systeemgroepen die relevant zijn voor de module Masterdata: gebouwen en gebieden van toepassing.

Zie voor meer algemene informatie over gebruikersprofielen, systeemgroepen, gebruikers en het dashboard van gebruikersprofielen: Gebruikers autoriseren

De systeemgroepen voor de gerelateerde module zijn hier te vinden: Activering en informatie over de module Masterdata: gebouwen en gebieden | 4.4 Systeemgroepen

Via de optie ‘Gebruikersprofielbeheer’ op het startboard van de beheerder kunnen deze systeemgroepen worden toegewezen aan bestaande gebruikersprofielen of worden toegevoegd aan nieuw aangemaakte gebruikersprofielen.

4.5 Navigatiemenu en startboardopties

Bij het activeren van de integratie van Space Management komen geen aanvullende navigatiemenu's beschikbaar. In dit geval is het navigatiemenu van de module Masterdata: gebouwen en gebieden van toepassing.

Zie voor meer algemene informatie over het navigatiemenu en het startboard: Navigatiemenu en startboard

5. Aanvullende rapporten

Bij het activeren van de kalenderintegratie zijn geen aanvullende rapporten van toepassing.

6. Aanvullende instellingen en opties na het inschakelen

Voor de meeste modules kunnen aanvullende instellingen na de eerste moduleactivering worden geconfigureerd via de optie ‘Module-instellingen’ op het startboard van de beheerder. Een module wordt altijd geactiveerd met vooraf gedefinieerde, meest gebruikte instellingen. Nadat de module is geactiveerd, zijn er mogelijk meer geavanceerde instellingen beschikbaar die ook via de module-instellingen kunnen worden beheerd.

Ga naar ‘Module-instellingen’ → tabblad ‘Integraties’ → tabblad ‘Integratie van Space Management’ om naar alle instellingen voor de integratie van Space Management te navigeren. Zie voor meer informatie over de configuratie en instellingen in de External App van de integratie van Space Management: Configuratiehandleiding voor de integratie van Space Management

7. Aanvullende informatie

Momenteel is er geen aanvullende informatie

8. Gebruikershandleiding

Er is geen gebruikershandleiding van toepassing op de integratie van Space Management.

9. V&A

Wachten op vragen om te beantwoorden