ServiceDeskReportType (Servicedesk meldingstype)
ServiceDeskReportType is het sjabloon waarmee een servicedesk- of self-service melding wordt geconfigureerd: het bepaalt welke defaults (prioriteit, afdeling, kostenplaats, jobplan, leverancier) automatisch worden ingevuld bij het aanmaken van een Job via de servicedesk of via Ultimo Go(+). Elk meldingstype heeft een eigen levenscyclus (Concept → Actief → Vervallen), een publicatie-scope (UseInServiceDesk, UseInSelfService, UseInSelfServiceGo) en uitgebreide configuratiemogelijkheden voor verplichte velden, factuurinstellingen en filterbeheer. Via ObjectServiceDeskReportType kunnen meldingstypes beperkt worden tot specifieke equipmenttypes.
Entiteitsnaam: ServiceDeskReportType
Databasetabel: ServiceDeskReportType
Primaire sleutel: SDRTID (UltimoString(4))
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | ServiceDeskReportTypeContext.None | Standaard |
| 1 | ServiceDeskReportTypeContext.Job | Standaard |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | ServiceDeskReportTypeStatus.Trash | Trash |
| 0 | ServiceDeskReportTypeStatus.None | None |
| 1 | ServiceDeskReportTypeStatus.Concept | Concept |
| 2 | ServiceDeskReportTypeStatus.Active | Actief |
| 4 | ServiceDeskReportTypeStatus.Expired | Vervallen |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 69 properties. Hieronder de belangrijkste; gebruik
lookup_entity("ServiceDeskReportType")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Id | UltimoString(4) | SDRTID | Nee | Uniek ID van het meldingstype (max. 4 tekens), de primaire sleutel | |
| Description | UltimoString(200) | SDRTDESCR | Ja | Naam van het meldingstype zoals die zichtbaar is in de servicedesk en self-service portalen | |
| BackOffice | BackOffice | SDRTBOFID | Ja | BackOffice-definitie waaraan dit meldingstype is gekoppeld voor de afhandeling door de backoffice | |
| Charge | JobChargeType | SDRTCHARGE | Nee | 0 | Factuurtype dat standaard op de gegenereerde job wordt gezet (bv. intern, extern, gratis) |
| CostCenter | CostCenter | SDRTCCRID | Ja | Kostenplaats die standaard op de job wordt overgenomen; kan verplicht of beschermd worden gemaakt | |
| Department | Department | SDRTDEPID | Ja | Afdeling die standaard op de job wordt gezet; kan verplicht of beschermd worden gemaakt | |
| Employee | Employee | SDRTEMPID | Ja | Standaard toegewezen medewerker op de gegenereerde job | |
| Equipment | Equipment | SDRTEQMID | Ja | Standaard equipment dat op de job wordt vooringevuld | |
| InstallmentsTermFrequency | Frequency | SDRTINVOUTTERMTERMFRQID | Ja | Frequentie-eenheid voor termijnfacturatie die via dit meldingstype wordt ingesteld | |
| InternalChargeMethod | InternalChargeMethod | SDRTINVOMID | Ja | Methode voor interne doorbelasting die op de job wordt toegepast | |
| JobPlan | JobPlan | SDRTJPID | Ja | Jobplan dat standaard aan de gegenereerde job wordt gekoppeld; bepaalt de uit te voeren activiteiten | |
| KnowledgeDomain | KnowledgeDomain | SDRTKNDID | Ja | Kennisdomein waarbinnen dit meldingstype valt (koppeling met de kennisbank) | |
| Kwis | Kwis | SDRTKWSID | Ja | KWIS-definitie (kenniswijzer) die aan dit meldingstype is gekoppeld | |
| MultijobTemplate | MultijobTemplate | SDRTMJTID | Ja | Multijob-sjabloon dat bij aanmaken van een melding met meerdere deeljobs wordt gebruikt | |
| Priority | Priority | SDRTPRIID | Ja | Standaard prioriteit die aan de job wordt toegekend | |
| ProgressStatusForJob | ProgressStatus | SDRTSETPRSID | Ja | Voortgangsstatus waarnaar de gegenereerde job direct wordt gezet bij aanmaken | |
| ProviderMutationDate | DateTime? | SDRTPROVIDERMUTDATE | Ja | Laatste mutatiedatum vanuit een externe data-provider | |
| RecordCreateDate | DateTime? | SDRTRECCREATEDATE | Ja | SYSDATETIME | Aanmaaktijdstip van het record; automatisch gevuld via database-default |
| ServiceContract | ServiceContract | SDRTSVCID | Ja | Servicecontract dat standaard op de job wordt gezet | |
| SkillCategory | SkillCategory | SDRTSKCID | Ja | Vaardigheids-categorie die vereist is voor de afhandeling van dit meldingstype | |
| Space | Space | SDRTSPCID | Ja | Standaard ruimte die op de job wordt vooringevuld | |
| StatusActiveDate | DateTime? | SDRTACTIVEDATE | Ja | Datum waarop het meldingstype de status Actief heeft gekregen | |
| StatusActiveEmployee | Employee | SDRTACTIVEEMPID | Ja | Medewerker die het meldingstype op Actief heeft gezet | |
| StatusConceptDate | DateTime? | SDRTCONCEPTDATE | Ja | SYSDATETIME | Datum waarop het meldingstype is aangemaakt in de status Concept; automatisch gevuld |
| StatusConceptEmployee | Employee | SDRTCONCEPTEMPID | Ja | USERID | Medewerker die het meldingstype als Concept heeft aangemaakt; automatisch gevuld met ingelogde gebruiker |
| StatusExpiredDate | DateTime? | SDRTEXPIREDDATE | Ja | Datum waarop het meldingstype de status Vervallen heeft gekregen | |
| StatusExpiredEmployee | Employee | SDRTEXPIREDEMPID | Ja | Medewerker die het meldingstype op Vervallen heeft gezet | |
| SystemCompany | Company | SDRTCOMPID | Nee | Bedrijf waartoe dit meldingstype behoort (verplicht) |
Functionaliteit & property-gedragbewerken
Veel ServiceDeskReportType-properties worden niet (alleen) handmatig ingevuld maar door workflows gelezen en verwerkt op het moment dat een 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 — DeSetContext-property bepaalt in welke Job-context dit meldingstype wordt ingezet.ServiceDeskReportType_ActionField1526_ContextDependentleestSetContexten past het sjabloon direct aan: bij contextSpaceReservationwordenCostCenter,Department,SpaceenMultijobTemplategewist en wordenUseInSelfService/UseInServiceDeskautomatisch opFalsegezet; bij contextItilChangeJobwordtKwisgewist enUseInMultijobTemplateLineopTrueforcered. Het sjabloon is daarmee zelf-consistent: onlogische combinaties worden bij het opslaan geëlimineerd. 14 workflows lezenSetContext— waaronder de job-print-workflowsJobPrint01-06enJob_GenerateSubJobs— om de correcte flow voor die context te kiezen.BackOffice— afhandelroute vastleggen — Elk actief meldingstype verwijst naar een backoffice-definitie (SDRTBOFID).Job_SetServiceDeskReportTypeValuesleestBackOffice.FilterEquipmentContexts,BackOffice.FilterPriorityContextsenBackOffice.FilterWorkOrderTypeContextsvan 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 wordenWorkOrderTypeenPriorityviaAssignWhenEmptyuit 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) wordenSpace,Department,CostCenterenEquipmentvan het meldingstype viaAssignWhenEmptyop de job gezet, mits de job ze nog niet heeft en de applicatiesettingJob.ChangeBackOfficeopFalsestaat. Als er wél al een backoffice is toegewezen, zijn de regels strenger: velden worden overschreven zodraSpaceProtected/DepartmentProtected/CostCenterProtectedopTruestaat of de job het veld leeg heeft.Job_UpdateCostCarriersFromServiceDeskReportTypeherhaalt dezelfde logica bij latere wijzigingen aan het meldingstype op de job en vult ook de gebouwhiërarchie (Building, BuildingFloor) vanuit de gekozenSpace. Consultanttip: zetCostCenterProtectedofDepartmentProtectedopTrueals 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_SendenJob_SendToBackOfficelezen beide properties en passen de job-status aan als onderdeel van de verzendflow.Job_GenerateSubJobsenReservationLine_PreReservedToProcessedlezen ze eveneens bij het genereren van subJobs vanuit een multijob- of reserveringscontext.SetStatus(SDRTSETRECSTATUS) regelt de gewone recordstatus;ServiceDeskReportType_PreActiveschrijft die bij activering van het sjabloon.MultijobTemplate— automatische deeljob-generatie — AlsMultijobTemplategevuld is, transformeertJob_TransformJobIntoMultijob_DetermineTemplatede aangemelde job in een multijob op basis van dit sjabloon.ServiceDeskReportType_ActionField1526_ContextDependentbewaakt consistentie: alleen eenMultijobTemplatemet contextStandardblijft behouden bij TD- en ServiceDesk-context; bij andere contexten wordt het veld gewist.MultijobTemplate_PreDeleteenMultijobTemplate_PreTrashfilteren opMultijobTemplateom 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 viaJob_SendToBackOffice_CopyValuesFromServiceDeskReportType(ook viaAssignWhenEmpty, dus alleen als de job ze nog leeg heeft).SkillCategorywordt aanvullend gezet doorActionField1263tijdens de backoffice-koppeling.Kwiswordt doorJob_SetServiceDeskReportTypeValuesdoorgeschreven naar de job voor de kenniswijzer-functionaliteit.Job_GenerateSubJobs_JobPlanleestJobPlanbij het aanmaken van subJobs zodat elk deeljob hetzelfde plan krijgt.UseInServiceDesk/UseInSelfService/Status— publicatiepoort —ServiceDeskReportType_PreActivecontroleert bij activering ofUseInServiceDeskofUseInSelfServicegevuld is (anders blijft activering geblokkeerd).ServiceDeskReportType_CreateJobenKnowledgeTopic_CreateJobfilteren opStatus == Activevoordat 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 sturenActionField641enJob_Sendaan om bij het verzenden van de melding automatisch een conditionfout (ConditionFlawPresent) of een ITSM-incident aan te maken. Ze worden gezet doorActionField641zelf (bij wijziging) en door de context-initializatieworkflowActionField1526.
Het volledige, gegenereerde overzicht van álle ServiceDeskReportType-properties met hun schrijvende/lezende/filterende workflows staat in reference/properties/ServiceDeskReportType.
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Nullable |
|---|---|---|
| BackOffice | BackOffice | Ja |
| CostCenter | CostCenter | Ja |
| Department | Department | Ja |
| Employee | Employee | Ja |
| Equipment | Equipment | Ja |
| InstallmentsTermFrequency | Frequency | Ja |
| InternalChargeMethod | InternalChargeMethod | Ja |
| JobPlan | JobPlan | Ja |
| KnowledgeDomain | KnowledgeDomain | Ja |
| Kwis | Kwis | Ja |
| MultijobTemplate | MultijobTemplate | Ja |
| Priority | Priority | Ja |
| ProgressStatusForJob | ProgressStatus | Ja |
| ServiceContract | ServiceContract | Ja |
| SkillCategory | SkillCategory | Ja |
| Space | Space | Ja |
| StatusActiveEmployee | Employee | Ja |
| StatusConceptEmployee | Employee | Ja |
| StatusExpiredEmployee | Employee | Ja |
| SystemCompany | Company | Nee |
| Vendor | Vendor | Ja |
| WorkOrderType | WorkOrderType | Ja |
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar ServiceDeskReportType:
| Entiteit | Via property |
|---|---|
| EmailServerAccount | ServiceDeskReportType |
| Job | ServiceDeskReportType |
| KnowledgeTopic | ServiceDeskReportType |
| MultijobTemplate | ServiceDeskReportType |
| MultijobTemplateLine | ServiceDeskReportType |
| ObjectServiceDeskReportType | ServiceDeskReportType |
| ServiceDefinition | ServiceDeskReportType |
| ServiceDeskReportTypeJobPlan | ServiceDeskReportType |
| Task | ServiceDeskReportType |
Tips voor consultantsbewerken
- Levenscyclus bewaken: Een meldingstype start in
Concepten moet expliciet naarActiefworden gezet voordat het beschikbaar is in de servicedesk of self-service. Zet vervallen types opExpiredom ze uit de keuzelijsten te verwijderen — ze zijn dan nog opvraagbaar via historische jobs. - Publicatie-scopes instellen:
UseInServiceDesk,UseInSelfServiceenUseInSelfServiceGozijn onafhankelijk; een type kan voor de backoffice-servicedesk actief zijn maar niet zichtbaar in het self-service portaal van eindgebruikers. Controleer deze vlaggen bij elk nieuw type. - Verplichte en beschermde velden: Met
CostCenterMandatory/CostCenterProtected,DepartmentMandatory/DepartmentProtected,ObjectMandatory/ObjectProtectedenSpaceMandatory/SpaceProtectedstuur je welke velden een melder móet invullen en welke alleen leesbaar zijn. Combineer Mandatory + Protected om een veld stil voor te vullen zonder dat de melder het kan wijzigen. - JobPlan vs. MultijobTemplate: Gebruik
JobPlanvoor standaard enkelvoudige opdrachten. GebruikMultijobTemplateals een melding altijd meerdere deeljobs genereert (bv. een HVAC-storing waarbij zowel een monteur als een inspecteur worden ingepland). - ObjectServiceDeskReportType voor equipmentfilter: Via de koppeltabel
ObjectServiceDeskReportTypebeperk je welke meldingstypes beschikbaar zijn op basis van het geselecteerde equipmenttype. Dit voorkomt dat een melder irrelevante types ziet. - Facturatie-instellingen op meldingstype: De
InstallmentsXxx-velden ondersteunen termijnfacturatie voor servicecontracten; vul deze alleen in als het meldingstype specifiek voor contractfacturatie bedoeld is.
Database Detailsbewerken
De tabel dba.ServiceDeskReportType bevat 68 kolommen, 0 eigen trigger(s), 0 externe triggers en 24 foreign keys.
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
SdrtContext |
0 |
SdrtRecStatus |
0 |
SdrtCharge |
0 |
SdrtCostCenterMandatory |
0 |
SdrtCostCenterProtected |
0 |
SdrtCreateConflPresent |
0 |
SdrtCreateIncident |
0 |
SdrtDepartmentMandatory |
0 |
SdrtDepartmentProtected |
0 |
SdrtInvOutTermFixedPrice |
0 |
SdrtInvOutTermFrqQty |
0 |
SdrtInvOutTermFxdPriceCst |
0 |
SdrtInvOutTermPayInTerms |
0 |
SdrtInvOutTermTermQty |
0 |
SdrtIoTermCost |
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("ServiceDeskReportType")· reference/entities/ServiceDeskReportType Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("ServiceDeskReportType")· reference/tables/ServiceDeskReportType Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="ServiceDeskReportType")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml. - Property-gebruik —
lookup_property_usage("ServiceDeskReportType", "SetContext")· reference/properties/ServiceDeskReportType Welke workflows een specifieke ServiceDeskReportType-property lezen/schrijven/filteren (bv. de 14 lezers vanSetContextof de 5 schrijvers vanCostCenter). Bron:workflows.xml. - Workflow-XML van een vuller —
lookup_workflow("Job_SetServiceDeskReportTypeValues")Volledige logica waarmee de template de job-properties vult, filtert en bewaakt (BackOffice-contextfilters, Priority/WorkOrderType via AssignWhenEmpty, CostCenter/Department-overname). Bron:workflows.xml.
Zie ookbewerken
- job - Jobs die via dit meldingstype worden aangemaakt
- job-plan - Jobplannen die standaard worden gekoppeld
- priority - Prioriteiten instelbaar per meldingstype
- progress-status - Voortgangsstatussen voor automatische job-statusovergangen
- backoffice - BackOffice-definities voor de afhandelingsflow
- skill-category - Vaardigheidscategorieën voor werktoedeling
- contract - Servicecontracten gekoppeld aan meldingstypes