Bewerken: Reservation (Reservering)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel Reservation-properties worden niet handmatig ingevuld maar door workflows ingesteld of gecascadeerd over occurrences en regels. Onderstaande paragrafen beschrijven het gedrag van de kernproperties; gebruik `lookup_property_usage("Reservation", "<property>")` of `lookup_property_usage("ReservationLine", "<property>")` voor de volledige, actuele lijst per property en `lookup_workflow("<naam>")` voor de XML.

- **`Pattern` (TimeslotPattern) — herhalingspatroon en occurrence-aanmaak** — Het herhalingspatroon op de Reservation bepaalt hoeveel ReservationOccurrences worden aangemaakt en op welke datums. `Reservation_EditTimePattern` valideert eerst of de status `Created` is of dat er al een patroon bestaat, haalt via `Reservation_GetOrCreateReservationOccurrence` de eerste occurrence op (of maakt die aan), en toont daarna de patroon-dialoog. Als het patroon uitzonderingen bevat (`Pattern.HasExceptions`) vraagt het systeem om bevestiging. `Reservation_ExtendTimePattern` verlengt een bestaand patroon zonder de bestaande occurrences te raken. `Reservation_RemoveTimePattern` verwijdert het patroon en leegt tevens de occurrences. Consultanttip: een patroon mag pas worden bewerkt als de reservering status `Created` heeft; bij status `Requested` blokkeert de validatie.

- **`Status` (recordstatus) — levenscyclus en cascade** — De statusflow van een Reservation loopt via `Reservation_Request` (zet status op `Requested`) en `Reservation_Cancel` (annulering). Bij annulering leest `Reservation_Cancel` alle actieve occurrences op en biedt de gebruiker een keuze: alleen de huidige occurrence of alle toekomstige occurrences annuleren (`ReservationCancelMethod`). Per occurrence wordt dan `StatusCanceledDate` gezet en de bijbehorende ReservationLines worden gecanceld. `Standard_Reservation_DeleteUnfinishedReservations` filtert op status `Created` en een te oude `StatusCreatedDate` om onafgemaakte reserveringen op te ruimen. `Reservation_PreTrash` leest de `Context` om te bepalen of verwijdering mag.

- **`Applicant` → automatische vulling van contactgegevens en kostenplaats** — `Reservation_OnApplicantChanged` triggert bij elke aanvragerwijziging. De workflow kopieert de aanvrager naar alle gekoppelde occurrences (`ForEach` over `Reservation.Occurrences`), vult `Department`, `ApplicantPhone` en `ApplicantEmailAddress` vanuit de medewerker-stamgegevens, en leidt daarna de `CostCenter` af uit de afdeling. Bij een nieuw record wordt `CostCenter` alleen gezet als het nog leeg is (`AssignWhenEmpty`); bij een bestaand record wordt de kostenplaats altijd overschreven. Tot slot herberekent `Reservation_DetermineTariffGroup` de tariefgroep op basis van de nieuwe aanvrager. Hetzelfde mechanisme geldt bij `Reservation_OnDepartmentChanged` en `Reservation_OnCustomerChanged`.

- **`StartDate` / `EndDate` op ReservationOccurrence — tijdvak en conflictvalidatie** — De tijden van een occurrence worden beheerd door `ReservationOccurrence_CheckTime`: als `StartDate` of `EndDate` nog leeg is, of als het aantal personen nog niet is opgegeven terwijl `AskForNumberOfPersons` actief is, opent het een tijdsdialoog. Via de applicatie-instelling `#{UltimoSettings.ReservationSnapTime}` wordt de minuten-snap bepaald (bijv. kwartieren). Wanneer een tijdvak wordt verplaatst, werkt `ReservationOccurrence_Move` de `StartDate`, `EndDate` en alle bijbehorende `ReservationLine.StartTime`/`EndTime` in één transactie bij. Exchange-reserveringen (`ReservationContext.Exchange`) mogen niet worden verplaatst via deze workflow; daarvoor geldt een aparte validatie.

- **`ReservableObject` op ReservationLine — beschikbaarheidscheck en conflict-status** — Het toewijzen of wijzigen van een reserveerbaar object verloopt via `ReservationLine_Request`: de workflow controleert of het object beschikbaar is (via `ReservationLine_DetermineTimes` + een optionele `CheckForAvailabilityOfReservableObject`-setting), en zet de status op `Reserved` of `Conflict`. `ReservationLine_AlterTimeFindReservableObjectAndUpdateValidations` bevat de extra validaties: Exchange-reserveringen mogen niet worden herroosterd, de context van het article (catering/menu) wordt bepaald via de setting `Reservation.CateringContext`, en de vestiging van het nieuwe object moet overeenkomen met die van de reservering. `PartOfReservationLine` koppelt een sub-regel (bijv. een catering-artikel) aan de bovenliggende ruimteregel; dit veld stuurt cascade-annulering (`ReservationLine_CancelCascade`) en cascade-kopiëren (`ReservationLine_CopyCascade`).

- **`InvoiceCost` / `InvoiceQuantity` op ReservationLine — doorbelasting** — Factuurkosten worden gezet door `ReservationLine_ResetInvoiceCost` en de `ActionField1130`-workflow; de `PreInvoice*`-reeks (`ReservationLine_PreInvoiceNextRunToInvoiceProposal`, `ReservationLine_PreInvoiceProposalToInvoiceZero`, etc.) valideert en beheert de interne doorbelaststransities. `ReservableObjectCommitted` wordt door vier Pre-workflows bijgehouden om te signaleren dat het object definitief geboekt is en niet meer vrijgegeven mag worden zonder expliciete annulering.

- **`NumberOfPersons` — bezettingsbeheer** — Dit veld bestaat zowel op ReservationOccurrence (`RESOCNUMBEROFPERSONS`) als op ReservationLine (`RESLNUMBEROFPERSONS`). `ReservationOccurrence_AddReservableObjectInternal` schrijft het aantal personen naar de occurrence bij het toevoegen van een object, en `ReservationOccurrence_AddDefaultArticle` leest het veld om automatisch standaard catering-artikelen aan te maken per ruimteregel. Dit maakt het mogelijk om per ruimteregel automatisch koffie/water toe te voegen op basis van de verwachte bezetting.

> Het volledige overzicht van álle Reservation-properties met hun schrijvende/lezende/filterende workflows staat in [[reference/properties/Reservation]] en [[reference/properties/ReservationLine]].

---