Bewerken: JobInspectionLine (Jobinspectieregel)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel JobInspectionLine-properties worden niet handmatig ingevuld maar door workflows berekend en gevuld. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik `lookup_property_usage("JobInspectionLine", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **Aanmaak vanuit inspectieplan (`JobJobPlan`, `JobPlan`, `InspectionLine`)** — Inspectieregels worden nooit handmatig aangemaakt. De workflows `ActionField1266` en `ActionField1815` schrijven `JobJobPlan` en creëren daarmee de koppeling tussen de regel en het bijbehorende jobplan-onderdeel. Het bronsjabloon (`InspectionLine`) wordt door `InspectionLine_PreDelete` bewaakt: zodra een inspectielijn-definitie wordt verwijderd, worden de hieraan gekoppelde `InspectionLine`-verwijzingen op de openstaande uitvoeringsregels genulleerd. Het veld `JobPlan` is daarna nog leesbaar door `JobInspectionLine_Validations` en `Job_GetPreviousJobPlan` voor volgorde- en historiecontroles.

- **Resultaat invullen (`QualityOk`, `QualityNotOk`, `Value`, `Value2`, `Text1`)** — Het kernresultaat van een controlepunt wordt door `JobInspectionLine_ProcessInspectionResult` in één handeling gesetteld: deze workflow schrijft `QualityOk`, `QualityNotOk`, `Value`, `Value2` en `Text1` op basis van het ingevoerde antwoord. Vanuit de mobiele app (Ultimo Go) doet `Mobile_JobInspectionLine` hetzelfde voor `QualityOk`, `Value` en `Text1`, en `Mobile_JobInspectionLine_Ok` stelt uitsluitend `QualityOk` in voor een snelle OK-registratie. Bij het resetten van een al ingevulde regel wist `JobInspectionLine_ResetFindings` de velden `QualityOk`, `QualityNotOk`, `Value`, `Value2` en `EquipmentIndicatorValue` — handig als een uitvoerder een antwoord wil corrigeren vóór het afronden van de inspectie. `ActionField1218` vult `QualityOk` en `Text1` in bij generieke OK-afhandeling. Consultanttip: zorg dat formuliervalidatie (`JobInspectionLine_Validations`) weet welk type antwoord verwacht wordt via `InspectionLineType`, anders kan `ProcessInspectionResult` geen correcte evaluatie doen.

- **OK/niet-OK-logica en `Status`-overgang** — Na het invullen van het resultaat bepaalt `JobInspectionLine_ProcessInspectionResult` ook de nieuwe `Status` van de regel (Gereed of een afwijkende status). `JobInspectionLine_PostImport` en `JobInspectionLine_Skip` zijn de andere twee statusschrijvers. De statusfilters (`JobJobPlan_CheckOpenDetailLines`, `JobJobPlan_PreCanceled`, `Validation_NumberOfOpenInspectionLines`) lezen `Status` om te beoordelen of alle regels van een job zijn afgerond voordat de bovenliggende job kan worden gesloten. Pas de volgorde van statusovergangsworkflows dus niet aan zonder ook de validatielogica mee te controleren.

- **Overslaan (`SkipReason`, `Text2`, `Status`)** — Als een controlepunt niet uitvoerbaar is, initieert de workflow `JobInspectionLine_Skip` het overslaan: hij zet `Status` op Overgeslagen (128), registreert `SkipReason` en slaat de vrije-tekst reden op in `Text2`. De dialoogworkflow `Dialog_JobInspectionLine_Skip` leest `SkipReason` en `Text2` om de gebruiker een keuzeformulier te tonen. Na het overslaan legt `JobInspectionLine_PostSkippedToCreated` of `JobInspectionLine_PostSkippedToFinished` de beëindiging van de overgeslagen status vast door `SkipReason` en `Text2` te herinstellen indien de regel toch wordt hervat. Het vorige overgeslagen resultaat wordt via `JobInspectionLine_CopyPreviousResult` meegenomen naar de volgende cyclus.

- **Vervolgactie genereren (`FollowUpJob`, `GeneratedJob`)** — Als een inspectieregel een afwijking registreert, schrijft `JobInspectionLine_CreateFollowUpJob` de verwijzing naar de nieuw aangemaakte job in `FollowUpJob`. `JobInspectionLine_ProcessInspectionResult` en `JobInspectionLine_CopyPreviousResult` lezen dit veld ook om te voorkomen dat dubbele vervolgacties worden aangemaakt. In rapportages kunt u `FollowUpJob` en `GeneratedJob` combineren om na te gaan welke afwijkingen tot een werkorder hebben geleid.

- **Afbeeldingen vastleggen (`InspectionImageFile1-4`)** — De vier afbeeldingsvelden worden uitsluitend door `JobInspectionLine_CopyPreviousInspectionImageFiles` geschreven (bij het kopiëren van vorige inspectieresultaten naar de nieuwe cyclus) en door `Mobile_JobInspectionLine_DeleteImage` (bij het verwijderen van een foto vanuit de mobiele app). De workflow `JobInspectionLine_ProcessInspectionImageFiles` leest alle vier velden om de definitieve bestandslocaties te verwerken na opslaan. Consultanttip: afbeeldingen worden als pad-string opgeslagen — zorg dat de opslag-directory geconfigureerd is en toegankelijk is voor de mobiele gebruikers.

- **Conditiebeoordeling en gebreken (`EquipmentIndicatorValue`, `NumberOfConditionFlawPresents`)** — Bij een looproute-inspectie (context `CourseRoute`) schrijft `Mobile_JobInspectionLine_CourseRoute` de `EquipmentIndicatorValue` als getal voor de toestandsindicator van het betreffende equipment. `JobInspectionLine_ProcessInspectionResult` en `JobInspectionLine_ResetFindings` beheren dit veld ook bij de reguliere flow. `NumberOfConditionFlawPresents` wordt automatisch bijgehouden door `ConditionFlawPresent_Create` (bij aanmaken van een gebrek) en `ConditionFlawPresent_PreTrash` (bij verwijderen): dit teltje maakt het mogelijk om in één oogopslag te zien hoeveel gebreken aan een inspectieregel zijn gekoppeld zonder een sublijst te raadplegen.

- **Overneming vorig resultaat (`PreviousJobInspectionLine`)** — De workflow `JobInspectionLine_CopyPreviousResult` leest de vorige uitvoeringscyclus via `PreviousJobInspectionLine` en kopieert `QualityOk`, `QualityNotOk`, `Value`, `Text1`, `Text2`, `SkipReason` en `FollowUpJob` naar de nieuwe regel. Dit biedt inspecteurs een startpunt en maakt trendanalyse mogelijk. `Job_GetPreviousJobPlan` filtert op `JobPlan` om de juiste vorige cyclus te identificeren.

> Het volledige, gegenereerde overzicht van álle JobInspectionLine-properties met hun schrijvende/lezende/filterende workflows staat in [[reference/properties/JobInspectionLine]].

---