Reservation (Reservering)

De Reservation-entiteit beheert alle soorten reserveringen in Ultimo, van zaalreserveringen en poolauto's tot catering en bezoekersregistratie. Reserveringen werken samen met reserveerbare objecten (ReservableObject) en worden uitgesplitst in occurrences (herhalingen) en regels.

Entiteitsnaam: Reservation Databasetabel: Reservation Primaire sleutel: RESID (nvarchar 6)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

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.

Relaties met andere entiteitenbewerken

Subentiteitenbewerken

ReservationOccurrencebewerken

Elke herhaling van een reservering wordt vastgelegd als een ReservationOccurrence met eigen start-/einddatum en status.

ReservationLinebewerken

De daadwerkelijke reservering van een specifiek object (ruimte, auto, catering-item) met tijden, kosten en status.

Tips voor consultantsbewerken

• Zaalreservering: Context SpaceReservation (1) is de meest gebruikte context. Hierbij worden ruimtes (Space) gereserveerd via ReservableObject.
• Poolauto's: Context PoolCar (16) wordt gebruikt voor het reserveren van deelauto's/bedrijfsvoertuigen.
• Exchange-integratie: Context Exchange (256) synchroniseert reserveringen met Microsoft Outlook/Exchange.
• Herhalingen: Via het Pattern (TimeslotPattern) kunnen terugkerende reserveringen worden aangemaakt.
• Catering: Context Catering (4) wordt gebruikt voor het bestellen van catering bij een zaalreservering.
• Bezoekersregistratie: Context Visit (8) wordt gebruikt voor het registreren van bezoekers.
• Doorbelasting: Via CostCenter, CostType en de kosten op ReservationLine kan doorbelasting worden ingericht.
• Conflictdetectie: Ultimo detecteert automatisch conflicten bij overlappende reserveringen.

Database Detailsbewerken

De tabel dba.Reservation bevat 35 kolommen. Reservation heeft geen computed columns en geen trigger-gestuurde kolommen.

Belangrijke defaultsbewerken

Triggersbewerken

Reservation heeft geen eigen triggers en geen externe triggers.

Consultanttip: Let op dat ResApplicantToExchange standaard op true staat. Dit betekent dat nieuwe reserveringen automatisch naar Outlook/Exchange worden gesynchroniseerd als de Exchange-integratie is geconfigureerd. Zet dit op false als Exchange-synchronisatie niet gewenst is. De eenvoudige database-structuur (geen triggers) betekent dat alle complexe logica (conflictdetectie, herhalingen, etc.) via workflows en applicatielogica wordt afgehandeld.

Brondatabewerken

Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.

• Entity-definitie — lookup_entity("Reservation") · reference/entities/Reservation Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("Reservation") · reference/tables/Reservation Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="Reservation") Alle Before/After Save events en andere workflow-ActionFields voor Reservation. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("Reservation", "Pattern") · reference/properties/Reservation Welke workflows Pattern, Status, Applicant en andere Reservation-properties lezen/schrijven/filteren. Zie ook reference/properties/ReservationLine voor het gedrag van StartTime, EndTime, ReservableObject, PartOfReservationLine en InvoiceCost op regelniveau. Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("ReservationLine_Request") De volledige beschikbaarheidscheck-logica: hoe ReservableObject wordt gevalideerd en de status op Reserved of Conflict wordt gezet. Bron: workflows.xml.

Zie ookbewerken

• job - Jobs gegenereerd vanuit reserveringen (bijv. Zaalreservering-context)
• equipment - Reserveerbare equipment (bijv. poolauto's)
• project - Projectkoppeling