Outlook-plugin testen buiten Outlook

Aan het einde van deze gids open je de plugin-UI in een gewone browser, met gemockte Outlook-item-data, zodat je de tabs (Contact, Tijdschrijven, CRM, Archief) kunt openen en wijzigingen kunt testen zonder Outlook nodig te hebben.

Werkt alleen op localhost, *.dev.* en *.ngrok hostnames; productie weigert test-mode-parameters.

Wat je nodig hebt

  • Toegang tot een Tapster-API-instance met de plugin gemount op /outlook-plugin/ (lokaal http://localhost:3000/outlook-plugin/, staging https://apiv7.dev.tapster.nl/outlook-plugin/).
  • Een geldige plugin-licentie + Exact-koppeling onder een Outlook-emailadres dat je voor de test gebruikt. Heb je geen koppeling, dan toont de plugin de activatie- of koppel-flow; daarna werkt test-mode pas.

Stappen

  1. Open de plugin-URL met minimaal het test_email-parameter: 
    https://apiv7.dev.tapster.nl/outlook-plugin/?test_email=jan@voorbeeld.nl
  2. De plugin detecteert dat Office.context.mailbox.item ontbreekt en valt terug op de URL-params. De Personen-tab opent met een gemockt contact.
  3. Voor een afspraak-context geef je extra params mee: 
    ?test_email=jan@voorbeeld.nl&test_item_type=Appointment&test_start=2026-03-30T10:00:00&test_end=2026-03-30T11:30:00
  4. Voor een specifieke uitnodiging-onderwerp of contactnaam: 
    ?test_email=jan@voorbeeld.nl&test_name=Jan%20de%20Vries&test_subject=Offerte%20project%20X

Beschikbare parameters

Parameter Verplicht Default Doel
test_email Ja — E-mailadres van het contact dat opgezocht wordt in Exact
test_name Nee “Test Contact” / “Test Organisator” Naam van de afzender of organisator
test_subject Nee “Test E-mail” / “Test Afspraak” Onderwerp; wordt voorgevuld in de Tijd- en Archief-tab
test_item_id Nee “test-item-id” Outlook item-ID; voorkomt idempotentie-collisions met andere tests
test_item_type Nee “Message” Message of Appointment
test_start Nee — Starttijd ISO-8601 (alleen voor Appointment)
test_end Nee — Eindtijd ISO-8601 (alleen voor Appointment)
test_initiator Nee (true) Zet op 0 om de niet-initiator-view in Instellingen te tonen
test_organization Nee “Test Organisatie BV” Override voor de organisatie-naam in de licentie-mock
test_activation_key Nee 00000000-... Override voor de activatiecode in de licentie-mock
test_expires_at Nee over 365 dagen Override voor de licentie-expiry

Wat werkt niet in test-mode

  • Bijlagen in de Archief-tab werken niet — Office.js levert die en die is niet beschikbaar buiten Outlook.
  • Compose-mode (een mail of afspraak schrijven) wordt niet geëmuleerd; we draaien altijd in read-mode-equivalent. Outlook gebruikt nu sowieso alleen read-mode voor de plugin (zie Outlook-plugin explanation).
  • Office.context.ui.displayDialogAsync valt terug op window.open. De OAuth-koppeling werkt dus wel, maar gedraagt zich als een popup; de browser moet popups voor deze origin toestaan.

Verifieer dat je in test-mode draait

Open DevTools en kijk in de console. Bij init zie je:

Outlook plugin initializing...

Daarna ofwel “Office host detected” (echte Outlook) of een stille fall-back naar test-mode wanneer geen Office.context.mailbox.item aanwezig is. In test-mode worden currentEmail, currentSubject etc. uit de URL-params gelezen.

Gerelateerd