Bewerken: ShiftLogLine (Ploegenlogboekregel)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Een `ShiftLogLine` doorloopt tijdens zijn levenscyclus meerdere statusovergangen die elk door een eigen workflow worden bewaakt. Hieronder een beschrijving van de belangrijkste mechanismen, gegrond op de workflow-evidence.

**Aanmaken en initialisatie.** Nieuwe regels worden aangemaakt via `ShiftLogLine_Edit` (handmatig vanuit het scherm of de Ultimo Go-app via `Mobile_ShiftLog_CreateShiftLogLine`). Bij het opslaan vullen de triggers `TRGI_ShiftLogLine` en `TRGU_ShiftLogLine` automatisch `ShllContext`, `ShllDepId` en `ShllPrfId` — de consultant hoeft afdeling en procesfunctie zelden handmatig in te vullen als equipment of procesfunctie correct is gekoppeld. `RecordCreateDate` wordt gezet op `SYSDATETIME` en `Reporter` op `USERID`, zodat de melder altijd traceerbaar is.

**Statusmachine en doorschuiven.** De status (`ShllRecStatus`) is het centrale sturingsmechanisme. `ShiftLogLine_Edit` en `ShiftLogLine_EditPattern` schrijven de status bij elke bewuste actie; `ShiftLog_ShiftOpenShiftLogLines` is de sleutelworkflow die bij het sluiten van een dienst alle nog-open regels (`Status = Open`) doorschuift naar de volgende `ShiftLog` en daarbij `OriginShiftLogLine` zet op de oorspronkelijke regel. `ShiftLogbook_CreateShiftLog` filtert en kopieert relevante regels bij aanmaak van een nieuw wachtverslag. De workflow `ShiftLog_CloseAndOptionallyCreateNext` filtert op `Context` en `ShiftLogLineType` om te bepalen welke regels in een nieuw verslag moeten verschijnen.

**Planning en tijdvensters.** `ScheduledStartDate`, `ScheduledEndDate`, `ScheduledStartWorkPeriod` en `ScheduledEndWorkPeriod` vormen samen het planningsvenster van een regel. `ShiftLogLine_ActionField1005_Dates` berekent en corrigeert deze datums in samenhang met de werkperiode van de gekoppelde `ShiftLog`. `Dialog_PlanOrReplanShiftLogLine` biedt een dialoog voor herplanning zonder de hoofdregel te overschrijven. Terugkerende regels (bijv. dagelijkse inspectiepunten) gebruiken `Pattern` (TimeslotPattern) en `Frequency`: `ShiftLogLine_EditPattern` valideert en slaat het herhalingspatroon op, terwijl `EndDateOfRecurrencePattern` de einddatum bewaakt.

**Werkorder- en downtimekoppeling.** Vanuit een logboekregel kan een [[job|Job]] worden aangemaakt via `ActionField1008` en `ActionField1722`; `Job.ShiftLogLine` verwijst dan terug naar de bronregel. Stilstand wordt geregistreerd via `ObjectDowntime`: `ActionField1723` en `ActionField1725` schrijven `ObjectDowntime` en `ReportObjectDowntime` op de regel; `Mobile_ShiftLogLine_RegisterDowntime` doet hetzelfde vanuit de mobiele app. Wanneer de gekoppelde job in de prullenbak verdwijnt (`Job_PostTrash`), wordt ook de logboekregel opgeruimd.

**Inspecties, meterlezingen en veiligheidsincidenten.** `ShiftLogLine_ProcessInspectionResult` verwerkt het inspectieresultaat en schrijft het terug naar `Text` en de `InspectionImageFile`-velden. `ShiftLogLine_ProcessMeterReading` verwerkt een meterlezing via `EquipmentMeasurementPoint`; `Dialog_ShiftLogLine_GetMeterReading` haalt de huidige stand op als dialoog. Voor veiligheidsincidenten geldt `Mobile_ShiftLogLine_ReportSafetyIncident` (app) en `ActionField1010` (desktop): beide schrijven `SafetyIncident` op de regel.

**Vergadering- en meetingkoppeling.** Logboekregels met status `ToMeeting` kunnen worden omgezet naar vergaderagendapunten via `Meeting_CreateMeetingTopicFromShiftLogLine`; daarbij wordt `CreatedMeetingTopic` gezet. Omgekeerd kan een overlegpunt een nieuwe logboekregel genereren, waarbij `CreatedFromMeetingTopic` de oorsprong vastlegt. `ActionField1004` is de directe knop voor de stap "maak overlegpunt".

**Mobiele afhandeling.** De Ultimo Go-app gebruikt een eigen reeks workflows: `Mobile_ShiftLogLine_Close` sluit de regel (schrijft `Status` en leest `ObjectDowntime`), `Mobile_ShiftLogLine_ReportJob` koppelt of maakt een job, en `Mobile_ShiftLogLine_ReportSafetyIncident` registreert een incident. Deze mobiele workflows lezen de `ShiftLog`- en `ShiftLogbook`-koppeling om de juiste context te bepalen — de regel moet dus altijd aan een actief wachtverslag hangen voordat mobiele acties werken.

---