Bewerken: Appointment (Afspraak)

Sectie: Tips voor consultants

Reden:

## Tips voor consultants

- **Appointment is een verzendwachtrij**: Eindgebruikers maken geen afspraken handmatig aan; ze worden gegenereerd door workflows (bv. bij statuswijziging van een job of reservering). Beheer de aanmaaklogica uitsluitend in [[workflow-engine|workflows]].
- **`UniqueIdentifier` moet stabiel blijven**: Bij een wijziging in de afspraak (bv. nieuwe locatie of tijd) verhoog je `Sequence` maar behoud je hetzelfde `UniqueIdentifier`. Zo werkt Exchange/Outlook de bestaande afspraak bij in plaats van een nieuwe te maken.
- **`Canceled = true` + `ToCancel`**: Gebruik het annuleringspatroon om een eerder verstuurde afspraak expliciet in te trekken. Zet `Canceled = true` en vul `ToCancel` in; het systeem verstuurt dan een iCal-CANCEL-bericht.
- **Foutdiagnose via status**: Controleer bij status `Failed` (8) altijd `ErrorMessage` en `LastFailureTime`. Status `ToBeSentAfterError` (4) houdt de afspraak in de wachtrij voor een volgende poging; `Invalid` (16) vereist handmatige correctie.
- **`MarkAsFree` voor informatieve afspraken**: Gebruik dit veld voor afspraken die de ontvanger willen informeren zonder zijn/haar agenda als 'bezet' te markeren — bv. planningsmeldingen of beschikbaarheidsmededelingen.
- **`AppointmentRecipient` voor meerdere ontvangers**: De `To`-kolom is een vrij tekstveld; voor gestructureerde meerder-ontvanger-afspraken gebruik je de deelentiteit `AppointmentRecipient`, die ook de acceptatiestatus per ontvanger kan bijhouden.

---