JobInspectionLine (Jobinspectieregel)
JobInspectionLine is de uitvoeringsregel van een inspectie-item op een Job. Elke regel registreert het resultaat van één controlepunt: of het item gedaan is, de gemeten waarde, een puntenscore, eventuele bevindingen en de medewerker die de uitvoering heeft voltooid of overgeslagen. De entiteit wordt gebruikt voor reguliere inspecties op jobs, looproutes, MT- en TD-acceptaties en bulk-PO-controles — het brede statusmodel (12 statussen) en de 6 eigen databasetriggers weerspiegelen de centrale rol die JobInspectionLine heeft in het uitvoeringsproces.
Entiteitsnaam: JobInspectionLine
Databasetabel: JobInsp
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | JobInspectionLineContext.None | Standaard |
| 1 | JobInspectionLineContext.Standard | Standaard |
| 2 | JobInspectionLineContext.CourseRoute | Looproute |
| 4 | JobInspectionLineContext.MTAcceptance | MT acceptatie |
| 8 | JobInspectionLineContext.BulkPO | Bulk-PO |
| 16 | JobInspectionLineContext.TDAcceptance | TD acceptatie |
| 32 | JobInspectionLineContext.Inspection | Inspectie |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | JobInspectionLineStatus.Trash | Trash |
| 0 | JobInspectionLineStatus.None | None |
| 1 | JobInspectionLineStatus.Created | Open |
| 2 | JobInspectionLineStatus.Approved | Goedgekeurd |
| 4 | JobInspectionLineStatus.Active | Actief |
| 16 | JobInspectionLineStatus.Finished | Gereed |
| 32 | JobInspectionLineStatus.Closed | Gesloten |
| 64 | JobInspectionLineStatus.Requested | Aanvraag |
| 128 | JobInspectionLineStatus.Skipped | Overgeslagen |
| 4096 | JobInspectionLineStatus.Completed | Compleet |
| 8192 | JobInspectionLineStatus.Postponed | Uitgesteld |
| 16384 | JobInspectionLineStatus.Invoiced | Gefactureerd |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 70 properties. Hieronder de belangrijkste; gebruik
lookup_entity("JobInspectionLine")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Description | UltimoString(85) | JOBIDESCR | Ja | Omschrijving van de inspectieregel zoals overgenomen van het inspectieplan | |
| Id.Job | Job | JOBIJOBID | Nee | De job waartoe deze inspectieregel behoort (eerste deel van de samengestelde sleutel) | |
| BulkEquipment | Equipment | JOBIEQMID | Ja | Equipment dat bij een bulk-PO-inspectie wordt gecontroleerd | |
| FollowUpJob | Job | JOBIFOLLOWUPJOB | Ja | Vervolgactie-job die is aangemaakt als gevolg van een afwijkend resultaat op deze regel | |
| GeneratedJob | Job | JOBIGENJOBID | Ja | Job die door het systeem is gegenereerd vanuit deze inspectieregel (bv. storingsopdracht) | |
| InspectionLine | InspectionLine | JOBIISLID | Ja | Referentie naar de InspectionLine-definitie waarop deze uitvoeringsregel is gebaseerd | |
| InspectionLineType | InspectionLineType | JOBIISLTID | Ja | Type inspectiepunt (bepaalt welke invoervelden zichtbaar zijn in de UI) | |
| JobJobPlan | JobJobPlan | JOBIJOBJPLID | Ja | Koppeling naar het jobplan-onderdeel dat deze regel heeft gegenereerd | |
| JobPlan | JobPlan | JOBIJPID | Ja | Jobplan waaruit deze inspectieregel voortkomt | |
| MeasureCode | MeasureCode | JOBIMSRID | Ja | Meetcode die de eenheid of schaal aangeeft voor de gemeten waarde | |
| PmJob | PmJob | JOBIPMJPMWID, JOBIPMJID | Ja | , | Preventief-onderhoudsorder (PmJob) waaruit deze job en dus deze inspectieregel zijn voortgekomen |
| PreviousJobInspectionLine | JobInspectionLine | JOBIPREVIOUSJOBID, JOBIPREVIOUSLINEID | Ja | , | Verwijzing naar de inspectieregel uit de vorige uitvoeringscyclus (voor trendanalyse) |
| ProviderMutationDate | DateTime? | JOBIPROVIDERMUTDATE | Ja | Laatste mutatiedatum vanuit een externe data-provider | |
| RecordChangeDate | DateTime? | JOBIRECCHANGEDATE | Ja | Laatste wijzigingsdatum van het record | |
| RecordCreateDate | DateTime? | JOBIRECCREATEDATE | Ja | SYSDATETIME | Aanmaakdatum van het record (systeemveld) |
| SafetyIncident | SafetyIncident | JOBISAFIID | Ja | Veiligheidsincident dat is geregistreerd naar aanleiding van deze inspectieregel | |
| SkipReason | SkipReason | JOBISRID | Ja | Reden waarom dit controlepunt is overgeslagen | |
| StatusFinishedDate | DateTime? | JOBIFINISHEDDATE | Ja | Datum waarop de regel de status Gereed heeft gekregen | |
| StatusFinishedEmployee | Employee | JOBIFINISHEDEMPID | Ja | Medewerker die de regel op Gereed heeft gezet | |
| StatusSkippedDate | DateTime? | JOBISKIPPEDDATE | Ja | Datum waarop de regel de status Overgeslagen heeft gekregen | |
| StatusSkippedEmployee | Employee | JOBISKIPPEDEMPID | Ja | Medewerker die de regel heeft overgeslagen | |
| SystemCompany | Company | JOBICOMPID | Nee | Bedrijf waarbinnen de jobinspectieregel is aangemaakt (verplicht) | |
| Id.LineId | UltimoString(9) | JOBILINEID | Nee | Regelnummer binnen de job (tweede deel van de samengestelde sleutel) | |
| _Createdjob | UltimoString(21) | _JOBICREATEDJOB | Ja | Intern veld: ID van een gerelateerde aangemaakte job (klant-extensie, prefix underscore) | |
| _Glasrondeaantal | UltimoString(20) | _JOBIGLASRONDEAANTAL | Ja | Intern klant-extensieveld: aantal voor glasronde-inspecties | |
| _Glasrondelocatie | UltimoString(20) | _JOBIGLASRONDELOCATIE | Ja | Intern klant-extensieveld: locatie voor glasronde-inspecties | |
| _Glasrondeonderdeel | UltimoString(20) | _JOBIGLASRONDEONDERDEEL | Ja | Intern klant-extensieveld: onderdeel voor glasronde-inspecties | |
| Context | Context | JOBICONTEXT | Nee | 1 | Context die het type jobinspectie bepaalt (standaard, looproute, MT acceptatie, TD acceptatie, bulk-PO, inspectie) |
Functionaliteit & property-gedragbewerken
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 workflowsActionField1266enActionField1815schrijvenJobJobPlanen creëren daarmee de koppeling tussen de regel en het bijbehorende jobplan-onderdeel. Het bronsjabloon (InspectionLine) wordt doorInspectionLine_PreDeletebewaakt: zodra een inspectielijn-definitie wordt verwijderd, worden de hieraan gekoppeldeInspectionLine-verwijzingen op de openstaande uitvoeringsregels genulleerd. Het veldJobPlanis daarna nog leesbaar doorJobInspectionLine_ValidationsenJob_GetPreviousJobPlanvoor volgorde- en historiecontroles.Resultaat invullen (
QualityOk,QualityNotOk,Value,Value2,Text1) — Het kernresultaat van een controlepunt wordt doorJobInspectionLine_ProcessInspectionResultin één handeling gesetteld: deze workflow schrijftQualityOk,QualityNotOk,Value,Value2enText1op basis van het ingevoerde antwoord. Vanuit de mobiele app (Ultimo Go) doetMobile_JobInspectionLinehetzelfde voorQualityOk,ValueenText1, enMobile_JobInspectionLine_Okstelt uitsluitendQualityOkin voor een snelle OK-registratie. Bij het resetten van een al ingevulde regel wistJobInspectionLine_ResetFindingsde veldenQualityOk,QualityNotOk,Value,Value2enEquipmentIndicatorValue— handig als een uitvoerder een antwoord wil corrigeren vóór het afronden van de inspectie.ActionField1218vultQualityOkenText1in bij generieke OK-afhandeling. Consultanttip: zorg dat formuliervalidatie (JobInspectionLine_Validations) weet welk type antwoord verwacht wordt viaInspectionLineType, anders kanProcessInspectionResultgeen correcte evaluatie doen.OK/niet-OK-logica en
Status-overgang — Na het invullen van het resultaat bepaaltJobInspectionLine_ProcessInspectionResultook de nieuweStatusvan de regel (Gereed of een afwijkende status).JobInspectionLine_PostImportenJobInspectionLine_Skipzijn de andere twee statusschrijvers. De statusfilters (JobJobPlan_CheckOpenDetailLines,JobJobPlan_PreCanceled,Validation_NumberOfOpenInspectionLines) lezenStatusom 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 workflowJobInspectionLine_Skiphet overslaan: hij zetStatusop Overgeslagen (128), registreertSkipReasonen slaat de vrije-tekst reden op inText2. De dialoogworkflowDialog_JobInspectionLine_SkipleestSkipReasonenText2om de gebruiker een keuzeformulier te tonen. Na het overslaan legtJobInspectionLine_PostSkippedToCreatedofJobInspectionLine_PostSkippedToFinishedde beëindiging van de overgeslagen status vast doorSkipReasonenText2te herinstellen indien de regel toch wordt hervat. Het vorige overgeslagen resultaat wordt viaJobInspectionLine_CopyPreviousResultmeegenomen naar de volgende cyclus.Vervolgactie genereren (
FollowUpJob,GeneratedJob) — Als een inspectieregel een afwijking registreert, schrijftJobInspectionLine_CreateFollowUpJobde verwijzing naar de nieuw aangemaakte job inFollowUpJob.JobInspectionLine_ProcessInspectionResultenJobInspectionLine_CopyPreviousResultlezen dit veld ook om te voorkomen dat dubbele vervolgacties worden aangemaakt. In rapportages kunt uFollowUpJobenGeneratedJobcombineren om na te gaan welke afwijkingen tot een werkorder hebben geleid.Afbeeldingen vastleggen (
InspectionImageFile1-4) — De vier afbeeldingsvelden worden uitsluitend doorJobInspectionLine_CopyPreviousInspectionImageFilesgeschreven (bij het kopiëren van vorige inspectieresultaten naar de nieuwe cyclus) en doorMobile_JobInspectionLine_DeleteImage(bij het verwijderen van een foto vanuit de mobiele app). De workflowJobInspectionLine_ProcessInspectionImageFilesleest 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 (contextCourseRoute) schrijftMobile_JobInspectionLine_CourseRoutedeEquipmentIndicatorValueals getal voor de toestandsindicator van het betreffende equipment.JobInspectionLine_ProcessInspectionResultenJobInspectionLine_ResetFindingsbeheren dit veld ook bij de reguliere flow.NumberOfConditionFlawPresentswordt automatisch bijgehouden doorConditionFlawPresent_Create(bij aanmaken van een gebrek) enConditionFlawPresent_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 workflowJobInspectionLine_CopyPreviousResultleest de vorige uitvoeringscyclus viaPreviousJobInspectionLineen kopieertQualityOk,QualityNotOk,Value,Text1,Text2,SkipReasonenFollowUpJobnaar de nieuwe regel. Dit biedt inspecteurs een startpunt en maakt trendanalyse mogelijk.Job_GetPreviousJobPlanfiltert opJobPlanom 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.
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Nullable |
|---|---|---|
| Id.Job | Job | Nee |
| BulkEquipment | Equipment | Ja |
| FollowUpJob | Job | Ja |
| GeneratedJob | Job | Ja |
| InspectionLine | InspectionLine | Ja |
| InspectionLineType | InspectionLineType | Ja |
| JobJobPlan | JobJobPlan | Ja |
| JobPlan | JobPlan | Ja |
| MeasureCode | MeasureCode | Ja |
| PmJob | PmJob | Ja |
| PreviousJobInspectionLine | JobInspectionLine | Ja |
| SafetyIncident | SafetyIncident | 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 JobInspectionLine:
| Entiteit | Via property |
|---|---|
| ConditionFlawPresent | JobInspectionLine |
Tips voor consultantsbewerken
- 6 eigen triggers: De tabel
JobInspheeft 6 eigen triggers (plus 1 externe). De triggerTRGI_JobInsp/TRGU_JobschrijftJobiRecStatus. NooitJobiRecStatusrechtstreeks via SQL aanpassen — gebruik altijd de Ultimo-applicatielaag of een workflow-ActionField. - PreviousJobInspectionLine voor trendanalyse: Via
PreviousJobInspectionLinekoppelt Ultimo opeenvolgende uitvoeringen van hetzelfde controlepunt aan elkaar. Gebruik deze keten voor conditietrendanalyse of regrapporten: vergelijkValue/Pointover meerdere cycli. - FollowUpJob en GeneratedJob: Als een inspectieregel een afwijking registreert, kan een vervolgactie-job worden aangemaakt (
FollowUpJob).GeneratedJobregistreert de job die automatisch door een workflow is gegenereerd. Controleer beide velden in rapportages om opvolging te bewaken. - Brede statusset: De 12 statussen (Open, Goedgekeurd, Actief, Gereed, Gesloten, Overgeslagen, Compleet, Uitgesteld, Gefactureerd, etc.) weerspiegelen dat JobInspectionLine ook wordt gebruikt voor factureringsplichtige service-inspecties. Zorg dat workflows status-overgangen bewaken en stel autorisatie in op kritische overgangen zoals Gefactureerd.
- Underscore-velden zijn klant-extensies:
_Createdjob,_Glasrondeaantal,_Glasrondelocatieen_Glasrondeonderdeelzijn klantvelden (prefix_). Ze worden niet door de standaard Ultimo-applicatie gevuld; gebruik ze alleen als het klantspecifieke maatwerk dit vereist. - Inspectieafbeeldingen: De velden
InspectionImageFile1-4enInstructionImageFile1-4slaan pad-referenties op naar foto's van bevindingen respectievelijk instructies. Gebruik deze bij mobiele inspecties (Ultimo Go) voor visuele documentatie van afwijkingen. - BulkEquipment voor serienummer-inspecties: De context
BulkPOgecombineerd metBulkEquipmentwordt gebruikt om per equipment-item in een batch-inkoop een afzonderlijke aanvaardingsinspectie vast te leggen. VulBulkEquipmentpas in na koppeling van het individuele equipment aan de inkooporder.
Database Detailsbewerken
De tabel dba.JobInsp bevat 67 kolommen, 6 eigen trigger(s), 1 externe triggers en 18 foreign keys.
Kolommen gezet door triggersbewerken
Deze kolommen worden automatisch bijgewerkt door database-triggers en mogen niet handmatig worden aangepast.
| Kolom | Type | Trigger(s) |
|---|---|---|
JobiRecStatus |
int | TRGI_JobInsp, TRGU_Job |
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
JobiContext |
1 |
JobiRecStatus |
0 |
JobiDone |
0 |
JobiEqmState |
0 |
JobiNmbrOfCndtnFlawPrsnts |
0 |
JobiNoState |
0 |
JobiPoint |
0 |
JobiPrfState |
0 |
JobiQualOk |
0 |
JobiRecCreateDate |
sysdatetimeoffset() |
JobiTransferNextTime |
0 |
JobiUnfindable |
0 |
JobiValue2 |
0 |
JobiZeroState |
0 |
JobiQualityNotOk |
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("JobInspectionLine")· reference/entities/JobInspectionLine Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("JobInsp")· reference/tables/JobInsp Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="JobInspectionLine")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml. - Property-gebruik —
lookup_property_usage("JobInspectionLine", "QualityOk")· reference/properties/JobInspectionLine Welke workflowsQualityOk(en andere JobInspectionLine-properties) lezen, schrijven of filteren. Bron:workflows.xml. - Workflow-XML van een vuller —
lookup_workflow("JobInspectionLine_ProcessInspectionResult")De volledige logica achter het bepalen van resultaat, OK/niet-OK, vervolgactie en statusovergang na het invullen van een inspectieregel. Bron:workflows.xml.
Zie ookbewerken
- job - De job waartoe deze inspectieregel behoort
- inspection-plan - Het inspectieplan-sjabloon dat de regeldefinitie bevat
- pm-job - De preventief-onderhoudsorder waaruit de job en regelset zijn voortgekomen
- job-plan - Het jobplan dat de regelset heeft gegenereerd
- equipment - Equipment dat bij BulkPO-inspecties per regel wordt geregistreerd
- safety-incident - Veiligheidsincident dat voortvloeit uit een afwijkende inspectieregel
- employee - Medewerker die de regel heeft afgehandeld of overgeslagen