Het Officebooking-platform maakt het mogelijk om bedrijfsresources te delen en beschikbaar te stellen voor reserveringen door gebruikers en medewerkers. Wij ondersteunen verschillende interactiepunten voor eindgebruikers, waaronder web, mobiel en interactieve signage-oplossingen. Zo worden gebruikers ondersteund gedurende hun volledige gebruikersreis.
Deze handleiding begeleid je bij het instellen van synchronisatie met on-premise Microsoft Exchange 2013- of Exchange 2016-serverinstallaties. Voor Office 365-integraties verwijzen wij u naar onze Office 365-integratiehandleiding.
Stap 1: Toegang tot OfficeAdmin en de Exchange-omgeving
Deze handleiding gaat ervan uit dat iemand binnen jouw organisatie (of Officebooking Support) al een beheerdersaccount voor je heeft aangemaakt. Met dit account krijg je toegang tot het OfficeAdmin-portaal.
Daarnaast heb je beheerdersrechten nodig voor de Exchange-omgeving van jouw organisatie. Zodra je toegang hebt tot beide omgevingen, kan je starten met de implementatie van de integratie.
Stap 2: Voeg resource-mailboxen toe voor de ruimtes die je wilt synchroniseren (Microsoft Admin Center)
- Log in op het Exchange Admin Center met jouw Exchange-beheerdersaccount.
- Selecteer in het hoofdmenu ‘Recipients’ en vervolgens ‘Resources’.
- Kies ‘+ Add resource’ en vul de gegevens van de ruimte in. De minimaal vereiste gegevens per ruimte zijn:
- Naam
- E-mailadres van de ruimte
- Voorbeeld:
- Naam = Boardroom I
- E-mailadres = boardroom369@wilderman.nl
- Locatie = Puntegaal
- Capaciteit = 8
Let goed op het e-mailadres van de ruimte. Het domein (bijvoorbeeld @wilderman.nl) wordt meestal automatisch ingevuld door Exchange. Het gedeelte vóór het @-teken moet uniek zijn voor de ruimte en wordt gebruikt voor synchronisatiedoeleinden.
Wij gebruiken het e-mailadres als unieke identificatie. Noteer dit unieke e-mailadres zorgvuldig, omdat je dit later in Officebooking moet toevoegen.
Controleer ook of de optie ‘Accept or decline booking requests automatically’ is geselecteerd.
Via de knop ‘More options’ kan je daarnaast een gebruiksvriendelijke alias instellen voor de ruimte, naast de formele naam zoals “Boardroom I”. Gebruikers kunnen in Exchange ook zoeken op deze alias.
Sla vervolgens de instellingen op en ga verder met de volgende stap.
Stap 3: Maak een nieuw serviceaccount aan
Voor de integratie moet Exchange Web Services (EWS) beschikbaar zijn. Dit is standaard aanwezig in Microsoft Exchange 2013 en de meeste andere Exchange-versies.
Voor communicatie met de server moet een Officebooking-serviceaccount worden aangemaakt binnen de Exchange-omgeving. Dit account krijgt delegate-rechten op alle resources die gesynchroniseerd moeten worden.
Maak een nieuwe generieke Exchange-gebruiker aan, bijvoorbeeld:
-
Officebooking Service Account
Gebruik een sterk wachtwoord volgens het beveiligingsbeleid van jouw organisatie en noteer de inloggegevens zorgvuldig.
De gebruikersnaam van het serviceaccount moet bijvoorbeeld de volgende structuur hebben:
-
service_account@uwdomein.com of uwdomein\service_account
Stap 4: Geef delegate-toegang aan het serviceaccount
Het nieuwe serviceaccount heeft delegate-toegang nodig tot de resources die gesynchroniseerd moeten worden.
Stel de rechten als volgt in:
- Open het Exchange Admin Center.
- Selecteer een resource en kies ‘Edit’.
- Ga naar het menuonderdeel ‘Delegates’.
- Kies ‘Select delegates who can accept or decline booking request’.
- Voeg het serviceaccount toe dat in de vorige stap is aangemaakt.
- Selecteer vervolgens ‘Accept or decline booking requests automatically’.
- Sla de instellingen op.
Stap 5: Stel de juiste titelweergave voor reserveringen in via PowerShell
Standaard vervangt Exchange de titel van een meeting door de naam van de organisator. Dit kan worden aangepast met PowerShell.
Start PowerShell als administrator en voer de volgende commando’s uit:
$UserCredential = Get-CredentialVoer je inloggegevens in.
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirectionSet-ExecutionPolicy RemoteSigned
Import-PSSession $SessionGet-Mailbox -RecipientTypeDetails RoomMailbox | Set-CalendarProcessing -AddOrganizerToSubject $false -DeleteSubject $false -DeleteComments $falseMeer informatie vind je in de Microsoft-documentatie:
-
Managing Office 365 and Exchange Online with Windows PowerShell
-
Connect to Exchange Online using remote PowerShell
Stap 6: Activeer synchronisatie in OfficeAdmin
Om de synchronisatie te activeren:
- Log in op OfficeAdmin.
- Open de pagina ‘Settings’.
- Ga naar het tabblad ‘Integrations’.
- Kies ‘Exchange (EWS)’.
- Vul de EWS-URL, gebruikersnaam en wachtwoord van het Officebooking-serviceaccount in. De URL ziet er ongeveer als volgt uit:
https://mail.[uwdomein]/ews/Exchange.asmx - Klik op ‘Save’.
Stap 7: Koppel een asset in Officebooking aan de juiste vergaderruimte
- Open de pagina ‘Assets’ in OfficeAdmin.
- Zoek de vergaderruimte die u wilt koppelen.
- Filter eventueel op categorie, bijvoorbeeld ‘Meeting room’.
- Selecteer de asset en kies ‘Edit’.
- Vul het Exchange-e-mailadres van de ruimte in.
- Kies ‘Save asset’.
Stap 8: Start met testen
Controleer of de gebruiker waarmee je test zowel bestaat in Exchange als in Officebooking. Beide accounts moeten hetzelfde e-mailadres hebben.
Test: reservering van Outlook naar Officebooking
- Maak een meeting aan in Outlook.
- Voeg de vergaderruimte toe als deelnemer.
- Controleer de bevestiging vanuit Outlook.
- Binnen ongeveer één minuut verschijnt de meeting in Officebooking.
- Controleer dit via:
- ‘Reservations’
- Tabblad ‘List’
- Selecteer de juiste datum
- Controleer of alle gegevens correct zijn weergegeven.
Test: reservering van Officebooking naar Outlook
- Log in op de Officebooking-app.
- Zoek de gewenste ruimte.
- Maak een reservering aan.
- Controleer de reservering in ‘My Reservations’.
- Log vervolgens in op Exchange met dezelfde gebruiker.
- Controleer of de reservering zichtbaar is in de agenda.
Houd rekening met de synchronisatie-interval.
Probleemoplossing
Ik krijg geen toegang tot EWS op mijn mailserver
- De gebruikersnaam van het serviceaccount
- Het wachtwoord
- De EWS-URL
De gebruikersnaam moet bijvoorbeeld zijn: username@uwdomein.com of jedomein\username
De URL moet er ongeveer zo uitzien:
https://mail.uwdomein.com/ews/Exchange.asmxHoe kan ik testen of mijn serviceaccount correct werkt?
Gebruik de Microsoft-testtool:
https://testconnectivity.microsoft.com/
- Kies ‘Microsoft Exchange Web Services Connectivity Tests’.
- Selecteer ‘Service account Access’.
- Vul de gegevens van het serviceaccount en de resource-mailbox in.
Ik zie mijn reservering nog niet verschijnen
Wij synchroniseren elke 3–6 minuten via EWS.
Controleer:
- Of de resource-mailadressen identiek zijn in Exchange en Officebooking
- Of de resource op ‘bookable’ staat
- Of de gebruiker in beide systemen bestaat
Ik ontvang annuleringen nadat synchronisatie is geactiveerd
Controleer of de organisator van de meeting bestaat in zowel Officebooking als Exchange. Wanneer gebruikers slechts in één van beide systemen bestaan, kunnen reserveringen automatisch worden geannuleerd tijdens de synchronisatie. Dit komt vooral voor bij migraties naar een nieuwe Exchange-omgeving gecombineerd met een nieuwe Officebooking-omgeving.