Asset en integratieplatform voor Reservation Sync configureren

Doelgroep: consultants, partners alleen Asset-stappen

Inrichting van de verbinding tussen Asset en Exchange/Google.

Vooraf

  • Asset-omgeving.

1. Asset

1.1 Activeren

Kalendermodule activeren via: Kalenderintegratie (Outlook/Google): activering

1.2 Connector-mappings

Info

Meer informatie: API Connector.

Ga naar Client settings → Authentication → API Connectors en open kalenderconnector. Het onderdeel Mappings opent standaard.

image-20240919-110639.png

grant_type', ‘token_urlenwebhookworden door activering ingevuld.

Vulclient_idenclient_secretuit platformtenant in

image-20240919-111049.png

1.3 Ruimtes koppelen

Open Reservables en Search voor gekoppelde ruimtes.

image-20240919-111332.png

Klik Search voor bestaande objecten.

Klik Assign, zoek naam/referentie en kies synchronisatieruimtes.

image-20240919-111545.pngimage-20240919-112138.png

1.4 Sleutel tonen/maken

Open Trust relation en Key link.

image-20240919-115539.png

Info

Alleen partnergebruikers kunnen tonen/maken.

Klik Reveal key bij bestaande, anders Generate key . Alleen partners.

Kopieer voor stap 2.1.

image-20240919-120028.pngimage-20240919-120251.png

1.5 Overige onderdelen

  • Workflow interaction: processen voor kalenderbron. Zonder klantoverride standaard Asset Baseline; maatwerk aanpassen volgens 1.6.
  • Observations: bij actieve mapping automatisch, vanaf dan synchronisatie en meldingen.
  • Event log (24 hours): laatste 24 uur voor onderzoek.

1.6 Eigen workflow

Ook FMB-maatwerk aanpassen voor juiste statussen/meldingen:

  • Alle connectoren naar Cancel: postsetter syncActionCode = Cancel.
  • Handmatige taak Cancel via Exchange voor Integration external owner:
    • Display in task list en Display task description = No

    • Cancel group van reservation confirmed tot reservation ended
    • Naar Cancelled: function cancel, pre-setter reservationStatusCode = Cancelled, datum cancelTime
  • Handmatige taak Change via Exchange voor Integration external owner:
    • Display in task list en Display task description = No

    • Cancel group van reservation confirmed tot reservation ended
    • Naar Change: function change, pre-setter reservationStatusCode = Change
  • Alle connectoren van eerste taak: post-setter syncActionCode = Synchronize.
  • Eerste taak naar confirmed: pre-setter reservationStatusCode = Confirmed, conditie syncDirectionCode = Incoming.
  • Script op handmatige Change dat inbound-wijziging verhindert.

Reeksen

  1. Uitgaand in FMB via Schedule.scheduleGenerationStatusCode = Ready na generatie; zet syncActionCode op Sync voor Outlook.
  2. Scripts op Reservation.approveDate, closeTime en cancelTime werken ReservationSchedule bij:
    • Alles goedgekeurd: reeks goedgekeurd;
    • Alles geannuleerd: reeks geannuleerd;
    • Alles gesloten: reeks gesloten;
    • Alles geannuleerd maar sommige gesloten/niet annuleerbaar: reeks gesloten.

Neem mee bij eigen reeksworkflow. Vraag Product bij twijfel.

2. Integratieplatform

Instellingen voor kalender en Asset.

Log in op Spacewell-integratieplatform en kies tenant. Zie Integratieplatform (intern Spacewell)

2.1 Asset verbinden

Ga naar Reservation Sync > Connectors. Onder ActionskiesAdd voor connector:

image-20260923-112740.png

Type AXXERION en gegevens:

Veld

Waarde

Opmerking

display name

Herkenbare vrije naam

GEEN ASSET-WAARDE NODIG

appId

Kalenderconnectorreferentie, bijvoorbeeld FMB-EA-001

encryptionKey

Access ID van trustrelation

Na opslaan verborgen

name

Tenantnaam/clientreferentie

presharedKey

Sleutel uit 1.4

Na opslaan verborgen

url

Klant-URL, bijvoorbeeld spacewell.axxerion.com

Vervolg volgens Microsoft/Google:

2.2a Microsoft verbinden

Reservation Sync > Connectors > Actions > Add, type MICROSOFT:

Veld

Waarde

directoryId

Klant-tenant-ID

clientId

Klant-app-ID

clientSecret

Klantsecret

domains

Klantdomeinen kommagescheiden

version

v1.0

Klik Add. Pop-up voor Sync Settings. Eén Microsoft-connector per Exchange-omgeving.

2.2b Google verbinden

Reservation Sync > Connectors > Actions > Add, type GOOGLE:

Veld

Waarde

domains

Domeinen kommagescheiden

impersonation

Gedelegeerde e-mail

issuer

Serviceaccount client_email

key

Klantprivésleutel

version

v3

2.3 Sync Settings

Ga naar Reservation Sync-> Sync Settings:

Instelling

Werking

Sync Mode

Bidirectional, Inbound kalender naar Spacewell, of Outbound omgekeerd

Failure Notifications via Email

Fout-/mappingmeldingsadressen kommagescheiden; ook afstemming vereist ontvangers als optie uit.

Notify organizer/responsible on failure

Realtime foutmail naar organisator/beheerder

Max Occurrences

Standaard 180, langere reeksen niet gesynchroniseerd.

Afstemmen met max scheduled occurrences in Asset.

Max Updates

Standaard 50 tegen update-lus

Time Zone

Verplicht vangnet zonder provider-/Asset-tijdzone

Validate mailbox

Periodieke alias-/naamupdates, zie Ruimtekoppeling en koppelstatus

Always host online / Conference provider

Link bij Workplace-boeking, zie Onlinevergaderlinks

Opmerking

Sync Settings voor elke Microsoft-connector.

2.4 Ruimtes koppelen

Zie Ruimtekoppeling en koppelstatus

3. Inzicht en onderzoek

Asset

Na activering: Calendar integration knoppen op Integrations-startpagina, Calendar op beheerstartboard:

image-20250408-112040.png
  • Information – documentatie
  • API Connector – directe toegang
  • Event Logs – elke API-aanroep, zoeken per reserveringsupdate
  • Debugging – overzichten:
    • Ontbrekende verplichte mappingwaarden zoals secret;

    • Wel gekoppeld maar geen platformmapping/Observation;
    • Reserve in advance until afstemmen op Exchange.

Integratieplatform

Onder Logsexporteer GCP .txt/.log voor 6/12/24 uur of eigen periode tot zeven dagen, maximaal 90 dagen terug.