Bewerken: ServiceDeskReportType (Servicedesk meldingstype)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel ServiceDeskReportType-properties worden niet (alleen) handmatig ingevuld maar door workflows gelezen en verwerkt op het moment dat een [[job|Job]] via de servicedesk of self-service wordt aangemaakt of verzonden. Onderstaande paragrafen beschrijven het gedrag van de meest impactvolle velden; gebruik `lookup_property_usage("ServiceDeskReportType", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **`SetContext` — context-afhankelijke sjabloonsanering** — De `SetContext`-property bepaalt in welke [[job|Job]]-context dit meldingstype wordt ingezet. `ServiceDeskReportType_ActionField1526_ContextDependent` leest `SetContext` en past het sjabloon direct aan: bij context `SpaceReservation` worden `CostCenter`, `Department`, `Space` en `MultijobTemplate` gewist en worden `UseInSelfService`/`UseInServiceDesk` automatisch op `False` gezet; bij context `ItilChangeJob` wordt `Kwis` gewist en `UseInMultijobTemplateLine` op `True` forcered. Het sjabloon is daarmee zelf-consistent: onlogische combinaties worden bij het opslaan geëlimineerd. 14 workflows lezen `SetContext` — waaronder de job-print-workflows `JobPrint01-06` en `Job_GenerateSubJobs` — om de correcte flow voor die context te kiezen.

- **`BackOffice` — afhandelroute vastleggen** — Elk actief meldingstype verwijst naar een backoffice-definitie (`SDRTBOFID`). `Job_SetServiceDeskReportTypeValues` leest `BackOffice.FilterEquipmentContexts`, `BackOffice.FilterPriorityContexts` en `BackOffice.FilterWorkOrderTypeContexts` van het gekoppelde backoffice en past de job direct aan: een gekoppeld object, prioriteit of werkordertype dat buiten het toegestane context-filter valt, wordt gewist. Vervolgens worden `WorkOrderType` en `Priority` via `AssignWhenEmpty` uit het meldingstype overgenomen als de job ze nog niet heeft. Consultanttip: de filtercontexten op de backoffice-definitie bepalen welk equipment en welke prioriteiten een melder überhaupt kan kiezen — een mismatch leidt tot stille wissing.

- **Kostendragers (`CostCenter`, `Department`, `Space`, `Equipment`) — overname bij verzending** — Bij het verzenden van een servicedesk- of self-service melding naar de backoffice (`Job_SendToBackOffice_CopyCostUnitsFromServiceDeskReportType`) worden `Space`, `Department`, `CostCenter` en `Equipment` van het meldingstype via `AssignWhenEmpty` op de job gezet, mits de job ze nog niet heeft en de applicatiesetting `Job.ChangeBackOffice` op `False` staat. Als er wél al een backoffice is toegewezen, zijn de regels strenger: velden worden overschreven zodra `SpaceProtected`/`DepartmentProtected`/`CostCenterProtected` op `True` staat of de job het veld leeg heeft. `Job_UpdateCostCarriersFromServiceDeskReportType` herhaalt dezelfde logica bij latere wijzigingen aan het meldingstype op de job en vult ook de gebouwhiërarchie (Building, BuildingFloor) vanuit de gekozen `Space`. Consultanttip: zet `CostCenterProtected` of `DepartmentProtected` op `True` als de kostendragers nooit mogen afwijken van het sjabloon.

- **`ProgressStatusForJob` & `SetStatus` — directe statusregie** — `ProgressStatusForJob` (`SDRTSETPRSID`) geeft aan naar welke voortgangsstatus de gegenereerde job direct wordt gezet. `Job_Send` en `Job_SendToBackOffice` lezen beide properties en passen de job-status aan als onderdeel van de verzendflow. `Job_GenerateSubJobs` en `ReservationLine_PreReservedToProcessed` lezen ze eveneens bij het genereren van subJobs vanuit een multijob- of reserveringscontext. `SetStatus` (`SDRTSETRECSTATUS`) regelt de gewone recordstatus; `ServiceDeskReportType_PreActive` schrijft die bij activering van het sjabloon.

- **`MultijobTemplate` — automatische deeljob-generatie** — Als `MultijobTemplate` gevuld is, transformeert `Job_TransformJobIntoMultijob_DetermineTemplate` de aangemelde job in een multijob op basis van dit sjabloon. `ServiceDeskReportType_ActionField1526_ContextDependent` bewaakt consistentie: alleen een `MultijobTemplate` met context `Standard` blijft behouden bij TD- en ServiceDesk-context; bij andere contexten wordt het veld gewist. `MultijobTemplate_PreDelete` en `MultijobTemplate_PreTrash` filteren op `MultijobTemplate` om te voorkomen dat een sjabloon dat nog door meldingstypes wordt gebruikt, wordt verwijderd.

- **`JobPlan`, `SkillCategory`, `WorkOrderType` & `Kwis` — uitvoeringsdefaults** — Deze vier properties worden bij verzending naar de backoffice overgenomen op de job via `Job_SendToBackOffice_CopyValuesFromServiceDeskReportType` (ook via `AssignWhenEmpty`, dus alleen als de job ze nog leeg heeft). `SkillCategory` wordt aanvullend gezet door `ActionField1263` tijdens de backoffice-koppeling. `Kwis` wordt door `Job_SetServiceDeskReportTypeValues` doorgeschreven naar de job voor de kenniswijzer-functionaliteit. `Job_GenerateSubJobs_JobPlan` leest `JobPlan` bij het aanmaken van subJobs zodat elk deeljob hetzelfde plan krijgt.

- **`UseInServiceDesk` / `UseInSelfService` / `Status` — publicatiepoort** — `ServiceDeskReportType_PreActive` controleert bij activering of `UseInServiceDesk` of `UseInSelfService` gevuld is (anders blijft activering geblokkeerd). `ServiceDeskReportType_CreateJob` en `KnowledgeTopic_CreateJob` filteren op `Status == Active` voordat ze het meldingstype als sjabloon aanbieden. Gevolg: een meldingstype in Concept of Vervallen verschijnt nooit in de keuzelijst van de melder, ook niet als de ID bekend is.

- **`CreateConditionFlawPresent` & `CreateIncident` — automatische vervolgacties** — Deze twee vlaggen sturen `ActionField641` en `Job_Send` aan om bij het verzenden van de melding automatisch een conditionfout (`ConditionFlawPresent`) of een ITSM-incident aan te maken. Ze worden gezet door `ActionField641` zelf (bij wijziging) en door de context-initializatieworkflow `ActionField1526`.

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

---