ShiftLogLine (Ploegenlogboekregel)
Een ShiftLogLine is een individuele regel in een ploegenlogboek — de rijke werkeenheid van het wachtoverdracht-domein. Elke regel beschrijft een bevinding, taak of meetwaarde die bij een ploegwisseling wordt geregistreerd, doorgeschoven of afgehandeld: van een afwijking aan een installatie tot een gepland inspectiepunt of een gemelde veiligheidsincident. Samen met ShiftLog (het overkoepelende verslag per dienst) en ShiftLogbook (het logboek per afdeling of locatie) vormt ShiftLogLine het hart van het wachtoverdracht-proces in Ultimo.
Entiteitsnaam: ShiftLogLine
Databasetabel: ShiftLogLine
Primaire sleutel: SHLLID (UltimoString(13))
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | ShiftLogLineContext.None | Standaard |
| 1 | ShiftLogLineContext.ShiftHandover | Wachtoverdracht |
| 2 | ShiftLogLineContext.AutonomousMaintenance | Autonoom onderhoud |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | ShiftLogLineStatus.Trash | Trash |
| 0 | ShiftLogLineStatus.None | None |
| 1 | ShiftLogLineStatus.Open | Open — nieuw aangemaakt, nog niet behandeld |
| 2 | ShiftLogLineStatus.Shifted | Doorgeschoven naar volgende ploeg/dienst |
| 4 | ShiftLogLineStatus.Planned | Gepland — voorzien van een tijdvenster |
| 8 | ShiftLogLineStatus.ToShiftLogbook | Naar wachtboek — ter kennis van het logboek |
| 16 | ShiftLogLineStatus.ToShiftLog | Naar wachtverslag — opgenomen in het verslag |
| 32 | ShiftLogLineStatus.Closed | Gesloten |
| 64 | ShiftLogLineStatus.ToMeeting | Naar overleglijst — geagendeerd voor vergadering |
| 128 | ShiftLogLineStatus.Finished | Gereed |
| 256 | ShiftLogLineStatus.Skipped | Overgeslagen |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 60 properties. Hieronder de belangrijkste; gebruik
lookup_entity("ShiftLogLine")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Id | UltimoString(13) | SHLLID | Nee | Uniek ID van de logboekregel | |
| Description | UltimoString(200) | SHLLDESCR | Ja | Korte omschrijving of titel van de melding/taak | |
| CreatedFromMeetingTopic | MeetingTopic | SHLLCREATEDFROMMEETTID | Ja | Overlegpunt waaruit deze logboekregel is gegenereerd | |
| CreatedMeetingTopic | MeetingTopic | SHLLCREATEDMEETTID | Ja | Overlegpunt dat vanuit deze logboekregel is aangemaakt | |
| Department | Department | SHLLDEPID | Ja | Afdeling verantwoordelijk voor afhandeling; door trigger gevuld vanuit context | |
| EndDateOfRecurrencePattern | DateTime? | SHLLENDDATEOFRECURRENCEPATTERN | Ja | Einddatum van het herhalingspatroon (terugkerende regels) | |
| Equipment | Equipment | SHLLEQMID | Ja | Gekoppelde installatie of object waarop de melding betrekking heeft | |
| EquipmentMeasurementPoint | EquipmentMeasurementPoint | SHLLEQMMSPEQMID, SHLLEQMMSPMSPID | Ja | , | Meetpunt op het gekoppelde equipment (voor meterlezingen) |
| Frequency | Frequency | SHLLFRQID | Ja | Frequentiedefinitie voor terugkerende logboekregels | |
| Job | Job | SHLLJOBID | Ja | Gekoppelde werkorder die vanuit of voor deze regel is aangemaakt | |
| MeterReadingDate | DateTime? | SHLLMETERREADINGDATE | Ja | Datum van de meterlezing die bij deze regel hoort | |
| ObjectDowntime | ObjectDowntime | SHLLOBJDWTID | Ja | Gekoppelde stilstandsregistratie (downtime) voor het object | |
| OriginShiftLogLine | ShiftLogLine | SHLLORIGINSHLLID | Ja | Bronregel bij doorschuiven: verwijst naar de originele logboekregel | |
| Pattern | TimeslotPattern | SHLLPATTERN | Ja | Tijdslotpatroon voor terugkerende inspecties of taken | |
| ProcessFunction | ProcessFunction | SHLLPRFID | Ja | Procesfunctie; door trigger afgeleid uit equipment of handmatig gezet | |
| ProcessFunctionMeasurementPoint | ProcessFunctionMeasurementPoint | SHLLPRFMSPPRFID, SHLLPRFMSPMSPID | Ja | , | Meetpunt op de gekoppelde procesfunctie |
| ProviderMutationDate | DateTime? | SHLLPROVIDERMUTDATE | Ja | Datum laatste externe mutatie (integratie/provider) | |
| RecordChangeDate | DateTime? | SHLLRECCHANGEDATE | Ja | Tijdstip van laatste wijziging; door trigger TR_SHIFTLOGLINE bijgewerkt |
|
| RecordCreateDate | DateTime? | SHLLRECCREATEDATE | Ja | SYSDATETIME | Aanmaaktijdstip; automatisch gezet bij INSERT |
| Reporter | Employee | SHLLREPORTEMPID | Ja | USERID | Medewerker die de regel heeft aangemaakt; default de ingelogde gebruiker |
| SafetyIncident | SafetyIncident | SHLLSAFIID | Ja | Gekoppeld veiligheidsincident dat vanuit deze regel is gemeld | |
| ScheduledEndDate | DateTime? | SHLLSCHEDULEDENDDATE | Ja | Geplande einddatum/tijd van de taak of het tijdvenster | |
| ScheduledEndWorkPeriod | WorkPeriod | SHLLSCHEDULEDENDWPID | Ja | Werkperiode (dienst) waarbinnen de taak uiterlijk moet eindigen | |
| ScheduledStartDate | DateTime? | SHLLSCHEDULEDSTARTDATE | Ja | Geplande startdatum/tijd van de taak of het tijdvenster | |
| ScheduledStartWorkPeriod | WorkPeriod | SHLLSCHEDULEDSTARTWPID | Ja | Werkperiode (dienst) waarbinnen de taak gepland staat te starten | |
| ShiftLog | ShiftLog | SHLLSHLID | Ja | Het wachtverslag (ShiftLog) waarbij deze regel hoort | |
| ShiftLogbook | ShiftLogbook | SHLLSHLBID | Ja | Het overkoepelende ploegenlogboek (ShiftLogbook) | |
| ShiftLogLineType | ShiftLogLineType | SHLLSHLLTID | Ja | Type logboekregel (categorisering: melding, inspectie, meterlezing, etc.) |
Functionaliteit & property-gedragbewerken
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 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.
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Nullable |
|---|---|---|
| CreatedFromMeetingTopic | MeetingTopic | Ja |
| CreatedMeetingTopic | MeetingTopic | Ja |
| Department | Department | Ja |
| Equipment | Equipment | Ja |
| EquipmentMeasurementPoint | EquipmentMeasurementPoint | Ja |
| Frequency | Frequency | Ja |
| Job | Job | Ja |
| ObjectDowntime | ObjectDowntime | Ja |
| OriginShiftLogLine | ShiftLogLine | Ja |
| ProcessFunction | ProcessFunction | Ja |
| ProcessFunctionMeasurementPoint | ProcessFunctionMeasurementPoint | Ja |
| Reporter | Employee | Ja |
| SafetyIncident | SafetyIncident | Ja |
| ScheduledEndWorkPeriod | WorkPeriod | Ja |
| ScheduledStartWorkPeriod | WorkPeriod | Ja |
| ShiftLog | ShiftLog | Ja |
| ShiftLogbook | ShiftLogbook | Ja |
| ShiftLogLineType | ShiftLogLineType | Ja |
| SkipReason | SkipReason | Ja |
| StatusFinishedEmployee | Employee | Ja |
| StatusSkippedEmployee | Employee | Ja |
| SystemCompany | Company | Nee |
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar ShiftLogLine:
| Entiteit | Via property |
|---|---|
| Job | ShiftLogLine |
| MeetingTopic | ShiftLogLine |
| SafetyIncident | ShiftLogLine |
Tips voor consultantsbewerken
- Status bepaalt wat er mogelijk is. Controleer altijd welke status een logboekregel heeft voordat je een actie uitvoert; workflows zoals
ShiftLogLine_EditenShiftLog_ShiftOpenShiftLogLinesfilteren actief op status. Een regel in statusFinishedofClosedkan niet meer worden doorgeschoven. - OriginShiftLogLine is de audittrail. Bij elke doorschuifactie zet
ShiftLog_ShiftOpenShiftLogLineseen nieuwe logboekregel aan metOriginShiftLogLineverwijzend naar de vorige. Dit vormt een keten die je altijd kunt terugvolgen; gebruiklookup_property_usage("ShiftLogLine", "OriginShiftLogLine")voor de betrokken workflows. - Triggers vullen afdeling en procesfunctie automatisch. Koppel equipment correct aan een procesfunctie — dan worden
DepartmentenProcessFunctionop de logboekregel doorTRGI_ShiftLogLinegevuld zonder handmatige invoer. Bij afwijkingen: controleer eerst de equipment-configuratie, daarna pas de workflow. - Herhalende regels vereisen een actief ShiftLogbook. Regels met
PatternenFrequencyworden alleen doorgerold als hetShiftLogbookactief een nieuweShiftLogaanmaakt viaShiftLogbook_CreateShiftLog. Zorg dat de logboek-automatisering (ShiftLogbook_AutoCloseAndCreateShiftLog) correct is geconfigureerd. - Mobiele workflows verwachten een actieve ShiftLog.
Mobile_ShiftLogLine_Close,Mobile_ShiftLogLine_ReportJoben aanverwante app-workflows lezenShiftLogenShiftLogbookbij elke stap. Als een medewerker mobiel een fout krijgt, is de meest voorkomende oorzaak dat er geen openShiftLogis voor de betreffende periode en afdeling. - JobContext bewaken bij job-aanmaak. Vanuit een logboekregel aangemaakt via
ActionField1008ofActionField1722krijgt de Job standaard context TD (1). Wil je een andere context (bijv. Incident), dan moet je de workflow aanpassen of een UCT-override toevoegen. - Vergaderagenda-integratie werkt tweerichting.
CreatedFromMeetingTopicenCreatedMeetingTopiczijn twee afzonderlijke velden; een regel kan zowel uit een overlegpunt zijn voortgekomen als er één hebben aangemaakt. Vermijd dubbele aanmaak door de status te bewaken bijMeeting_CreateMeetingTopicFromShiftLogLine.
Database Detailsbewerken
De tabel dba.ShiftLogLine bevat 62 kolommen, 3 eigen trigger(s), 1 externe triggers en 24 foreign keys.
Kolommen gezet door triggersbewerken
Deze kolommen worden automatisch bijgewerkt door database-triggers en mogen niet handmatig worden aangepast.
| Kolom | Type | Trigger(s) |
|---|---|---|
ShllContext |
bigint | TRGI_ShiftLogLine, TRGU_ShiftLogLine |
ShllDepId |
nvarchar(11) | TRGI_ShiftLogLine, TRGU_ShiftLogLine |
ShllPrfId |
nvarchar(50) | TRGI_ShiftLogLine, TRGU_Equipment, TRGU_ShiftLogLine |
ShllRecChangeDate |
datetimeoffset(7) | TR_SHIFTLOGLINE |
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
ShllContext |
0 |
ShllRecStatus |
0 |
ShllCreatedInCurrentShiftLog |
1 |
ShllPatternDuration |
0 |
ShllRecCreateDate |
sysdatetimeoffset() |
ShllReportObjectDowntime |
0 |
ShllMeterReading |
0 |
ShllQualityOk |
0 |
ShllQualityNotOk |
0 |
ShllTransferNextTime |
0 |
ShllFrequencyInterval |
0 |
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("ShiftLogLine")· reference/entities/ShiftLogLine Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("ShiftLogLine")· reference/tables/ShiftLogLine Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="ShiftLogLine")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml. - Property-gebruik —
lookup_property_usage("ShiftLogLine", "Status")· reference/properties/ShiftLogLine Welke workflows een specifieke ShiftLogLine-property lezen/schrijven/filteren (bijv.Statuswordt door 14 workflows geschreven). Bron:workflows.xml. - Workflow-XML van een vuller —
lookup_workflow("ShiftLog_ShiftOpenShiftLogLines")De centrale doorschuif-workflow die open logboekregels overdraagt bij ploegwisseling. Bron:workflows.xml.
Zie ookbewerken
- wachtoverdracht - Conceptueel overzicht van het wachtoverdracht-domein (ShiftLog, ShiftLogbook, ShiftLogLine)
- Job - Werkorder die vanuit een logboekregel kan worden aangemaakt
- Equipment - Installatie waaraan een logboekregel is gekoppeld
- ObjectDowntime - Stilstandsregistratie gekoppeld aan een logboekregel
- SafetyIncident - Veiligheidsincident gemeld vanuit een logboekregel
- ProcessFunction - Procesfunctie voor contextuele indeling van logboekregels
- Employee - Medewerker als melder of afhandelaar