Module Space Management-integratie

1. Waar gaat deze module over?

Deze module synchroniseert stamgegevens, zoals regio’s, terreinen, gebouwen, ruimtes en subruimtes, tussen Space Management en Asset.

1.1 Synchronisatierichting

1.1.1 Van Space Management naar Asset

Space Management is altijd de bron. Synchronisatie gaat alleen naar Asset, niet terug en niet in beide richtingen.

Gesynchroniseerde gegevens zijn beschermd tegen handmatige wijzigingen in Asset zodat onderhoud alleen in Space Management gebeurt.

Zie 1.3 Beperkte toegang in Asset hieronder.

1.1.2 Initiële migratie uit Asset

Bestaande Asset-stamgegevens kunnen voor de eerste migratie worden geëxporteerd en in Space Management geïmporteerd.

Rapporten staan op het beheerdersstartboard onder Integrations → Space Management → Export Reports.

image-20260608-124036.png

Ze sluiten direct aan op de importsjablonen zonder handmatige aanpassing.

image-20260608-125931.pngimage-20260608-130710.png

Export valideert de gegevens, bijvoorbeeld dat een gebouw niet rechtstreeks onder een regio staat.

image-20260608-131613.png

De controles:

  • Een regio staat onder een andere regio of op het hoogste niveau
  • Een regio zonder ouder vereist een begindatum
  • Een regio begint niet vóór de bovenliggende regio
  • Een terrein staat onder een regio of op het hoogste niveau
  • Een terrein begint niet vóór de regio
  • Een gebouw staat onder een terrein of op het hoogste niveau
  • Een gebouw begint niet vóór het terrein
  • Een verdieping staat onder de hoofdruimte van een gebouw
  • Een ruimte staat onder een verdieping
  • Een subruimte staat onder een Building section

1.2 Importconnector

Info

Deze informatie is vooral voor het onderzoeken van synchronisatieproblemen. Imports gebeuren automatisch op de achtergrond bij locatieaanmaak of -wijziging.

Een FtpConnector synchroniseert stamgegevens naar Asset en is automatisch aan de Space Management API Connector gekoppeld.

image-20260608-115526.png

De connector bevat mappings naar de bijbehorende Asset-objecten. Raadpleeg deze voor gesynchroniseerde velden en objecten.

Anders dan standaardimports met download- en uploadknoppen, gebruikt deze connector een technische interface en FtpConnectorRun om elke synchronisatie te volgen.

image-20260611-073317.png

Info

Vóór de eerste uitvoering verschijnt de standaardimportpagina. Na minimaal één uitvoering schakelt de technische pagina automatisch in.

1.2.1 Importlogboek

Tabbladen tonen recente, wachtende en mislukte runs.

image-20260610-142526.png

Importuitvoeringen (FtpConnectorRuns) zijn per status ingedeeld: succesvol, wachtend of mislukt.

Een FtpConnectorRun toont aantallen aangemaakte en bijgewerkte objecten en fouten.

Elke run bevat de CSV en een logbestand voor controle en foutonderzoek.

image-20260611-080240.png

1.3 Beperkte toegang in Asset

1.3.1 Velden

De volgende velden zijn niet bewerkbaar als het object in Space Management wordt beheerd.

  • Area.areaTypeCode
  • Area.capacity
  • Area.description
  • Area.name
  • Area.parentAreaId
  • Area.propertyId
  • Area.reservable
  • Property.constructionDate
  • Property.description
  • Property.name
  • Property.parentPropertyId
  • Property.propertyTypeCode 

Andere velden kunnen in Asset worden bijgewerkt maar synchroniseren niet terug.

1.3.2 Functies

De volgende functies geven een fout voor door Space Management beheerde stamgegevens:

  • delete
  • archive
  • template
  • duplicate
  • close

1.3.3 Hiërarchie

Naast gesynchroniseerde objecten kunnen nog Asset-objecten worden aangemaakt, met beperkingen:

  • Een Asset-gebouw mag geen door Space Management beheerd gebouw als ouder hebben. Dit geeft een fout.
  • Een Asset-ruimte mag geen door Space Management beheerde ruimte als ouder hebben. Dit geeft een fout.
  • Een Asset-ruimte mag niet aan een door Space Management beheerd gebouw worden gekoppeld. Dit geeft een fout.