Grid Widgets

Grid Widgets zijn aangepaste gridweergaven en widgetcomponenten die in schermen en op dashboards kunnen worden ingesloten. Ze bieden specifieke functionaliteit zoals het filteren, groeperen of weergeven van gegevens per entiteit.

Gerelateerd: dashboards, application-element-tree, screens, explorers

Waar vind je Grid Widgets?bewerken

Configuratie in UCTbewerken

UCT > User Interface > Grid Widgets

De lijstweergave bevat circa 81 items met kolommen voor: - Nummer — uniek widget-nummer - Entity — de entiteit waarvoor de widget geldt (bijv. Job, BuildingEvent, HealthcareCase) - Name — technische naam van de widget - Description — beschrijving

Het detailpaneel bevat vier tabbladen: - Basic — met het Entity-veld - Actions — beschikbare acties op de widget - Typing — typeconfiguratie - Card — kaartweergave-instellingen

Bestanden op de File Servicebewerken

Grid widget-bestanden staan in de map gridwidgets op de Ultimo File Service (UCT > Tools > File Service Data).

Standaard dashboard widgetsbewerken

Ultimo levert een reeks standaard grid widgets die op dashboards kunnen worden geplaatst. Hieronder de belangrijkste met hun widget-ID's.

Contractbeheerbewerken

Werkorderbeheerbewerken

Vlootbeheerbewerken

Overige widgetsbewerken

Veelvoorkomende entiteiten met grid widgets zijn: - Job — widgets voor werkorders, toewijzing, documentbeheer (bijv. CompleteAllPendingByRequestedDocument, AssignCompany, EquipmentHistoryReportWithRequestedDocument) - BuildingEvent — widgets voor gebouwgebeurtenissen - HealthcareCase — widgets voor gezondheidszorgcases

Sidebar widgets (job-schermen)bewerken

Naast grid widgets op dashboards zijn er sidebar widgets op job-schermen. De sidebar is een rechter zijpaneel met drie secties: Widgets, Documents en Images.

Beschikbare sidebar widgetsbewerken

Feature toggles: UseSidebar en EnableSidebarDocuments Beschikbaar in schermen: JOB01, JOB03, JOB04

Zie feature-toggles voor het beheer van feature toggles.

Widgets activeren en autoriserenbewerken

Grid widgets worden standaard ongeautoriseerd geleverd. Om een widget beschikbaar te maken:

Stap 1: Autorisatie via AETbewerken

1. Ga naar UCT > Authorisation > Application Element Tree
2. Zoek op de widget-ID (bijv. SkillCatJobsAssignedToBeProcessed)
3. Zet de autorisatie op Authorised voor de gewenste groepen/gebruikers

Zie application-element-tree voor details over AET-autorisatie.

Stap 2: Widget toevoegen aan dashboardbewerken

1. Ga naar de dashboard-configuratie
2. Voeg de widget toe op application level, group level of user level
3. Bepaal de positie en grootte van de widget

Onderlinge relatiesbewerken

Best practicesbewerken

1. Activeer alleen relevante widgets — te veel widgets op een dashboard leidt tot traagheid en onoverzichtelijkheid
2. Autoriseer per rol — geef alleen de widgets vrij die relevant zijn voor de gebruikersgroep
3. Test na activering — controleer of de widget correct data toont
4. Documenteer custom widgets — leg vast wat custom grid widgets doen en voor wie ze zijn bedoeld
5. Sidebar widgets — activeer sidebar widgets alleen op de schermen waar ze relevant zijn

Compleet overzicht van alle 73 standaard grid widgetsbewerken

Hieronder volgt het volledige overzicht van alle 73 grid widgets die standaard in Ultimo worden meegeleverd, gegroepeerd per module. De kolom "Belangrijkste kolommen" toont de meest relevante velden die in het grid zichtbaar zijn.

Werkorderbeheer (Jobs)bewerken

Selfservice / Meldingenbewerken

Reacties en klanttevredenheidbewerken

Kennisbeheerbewerken

Inkoopbewerken

Contractenbewerken

HSE (Health, Safety & Environment)bewerken

Modificatiebeheer (Management of Change)bewerken

Fleet (Vlootbeheer)bewerken

Assets / Objectenbewerken

Financieel / Budgetbewerken

Reserveringen en bezoekersbewerken

Overigbewerken

Hoe configureer je grid widgets (stap-voor-stap)bewerken

Het activeren van een grid widget omvat drie niveaus: autorisatie, dashboard-plaatsing en (optioneel) personalisatie door eindgebruikers.

Stap 1: Autorisatie via AETbewerken

1. Ga naar UCT > Authorisation > Application Element Tree (zie application-element-tree)
2. Zoek op het widget-ID, bijvoorbeeld SkillCatJobsAssignedToBeProcessed
3. Elk widget heeft een of meer gekoppelde ApplicationElements die bepalen welke acties beschikbaar zijn (bijv. DomainObject_OpenScreen voor het openen van het detailscherm, of specifieke ActionFields voor goedkeuren/afwijzen)
4. Zet de autorisatie op Authorised voor de gewenste gebruikersgroepen
5. Herhaal dit voor alle ApplicationElements die bij het widget horen

Tip: Veel widgets gebruiken het generieke element \Application\Common\View (DomainObject_OpenScreen). Sommige widgets hebben daarnaast specifieke acties, zoals ActionField436 (Goedkeuren) en ActionField437 (Afwijzen) bij OrderRequestsToBeApproved.

Stap 2: Widget toevoegen aan dashboardbewerken

1. Ga naar de dashboard-configuratie in UCT
2. Voeg het widget toe op application level (iedereen), group level (specifieke groep) of user level (individuele gebruiker)
3. Bepaal de positie en grootte van de widget op het dashboard
4. Sla op en test de configuratie

Stap 3: Personalisatie door eindgebruikersbewerken

1. Eindgebruikers kunnen hun eigen dashboard aanpassen via het pencil icon (potloodicoon) op hun dashboard
2. Ze kunnen widgets toevoegen, verwijderen of herordenen
3. Dit werkt alleen voor widgets waarvoor ze geautoriseerd zijn via de AET

Custom grid widgets makenbewerken

Naast de 73 standaard widgets kun je custom grid widgets maken voor klantspecifieke dashboards. Dit is een krachtige manier om specifieke KPI's en overzichten te tonen.

SQL query schrijvenbewerken

De basis van elk grid widget is een SQL query. Belangrijke regels:

• Gebruik altijd het dba. schema-prefix voor tabellen (bijv. dba.Job, dba.Equipment)
• Gebruik de {USERID} placeholder om te filteren op de ingelogde gebruiker. Ultimo vervangt dit runtime door het Employee-ID van de huidige gebruiker
• Gebruik SYSDATETIMEOFFSET() in plaats van GETDATE() voor datumvergelijkingen (Ultimo werkt met datetimeoffset)
• Filter op RecStatus om alleen actieve records te tonen (waarden varieren per entiteit)
• Filter op Context om het juiste type record te selecteren

Kolommen definiërenbewerken

Elke kolom in het grid wordt gedefinieerd met:

Tip: Gebruik Width="0" voor kolommen die nodig zijn voor het openen van detailschermen maar niet zichtbaar hoeven te zijn voor de gebruiker (bijv. CompId-velden voor multi-company filtering).

ApplicationElements koppelenbewerken

ApplicationElements bepalen welke acties beschikbaar zijn in het grid widget:

Meerdere ApplicationElements kunnen gekoppeld worden aan een widget. De Order bepaalt de volgorde van de knoppen in het grid.

Toewijzen aan AET-elementbewerken

Na het aanmaken van het custom widget: 1. Registreer het widget in UCT > User Interface > Grid Widgets 2. Koppel het aan de juiste entity 3. Maak een bijbehorend AET-element aan of gebruik een bestaand element 4. Autoriseer het element voor de gewenste gebruikersgroepen 5. Voeg het widget toe aan het gewenste dashboard

Voorbeelden van nuttige SQL queriesbewerken

De onderstaande SQL queries uit standaard widgets zijn bijzonder nuttig voor consultants die widgets willen begrijpen of aanpassen.

Voorbeeld 1: Laatste gemelde storingen (LastReportedFailures)bewerken

Deze query toont alle correctieve jobs (storingen) van de afgelopen 30 dagen. Nuttig als basis voor storingsoverzichten.

SELECT JobId, JobDescr, EmpDescr, JobReportDate, JobSchStartDate, 
       JobTargetDate, PriDescr, PrsDescr
FROM dba.Job
    LEFT JOIN dba.Employee ON JobReportFKEmpId = EmpId
    LEFT JOIN dba.Priority ON PriId = JobPriId
    LEFT JOIN dba.ProgressStatus ON JobPrsId = PrsId
    JOIN dba.WorkOrderType ON JobWotId = WotId
WHERE JobRecStatus IN (1, 2, 4, 64, 8192)
    AND WotCategory = 'C'              -- Alleen correctieve jobs
    AND JobPmId IS NULL                 -- Geen PM-gerelateerde jobs
    AND JobReportDate > DATEADD(DAY, -30, SYSDATETIMEOFFSET())
ORDER BY JobReportDate DESC

Aanpassingsmogelijkheden: - Wijzig -30 naar een ander aantal dagen - Voeg AND JobSkcId = 'xxx' toe om te filteren op vakgroep - Voeg AND JobPriId = 'xxx' toe om te filteren op prioriteit

Voorbeeld 2: Contracten met naderende opzegtermijn (ContractWithUpcomingNoticeDate)bewerken

Deze query berekent hoeveel dagen er resten voordat actie ondernomen moet worden op contracten. Essentieel voor contractbeheerders.

SELECT SContract.SvcId, SContract.SvcDescr1, Vendor.VdrDescr, 
       ContractType.SvctDescr, SContract.SvcCommences, SContract.SvcExpires, 
       SContract.SvcTermWarning, 
       DATEDIFF(DAY, SYSDATETIMEOFFSET(), 
                DATEADD(MONTH, -(SvcTermWarning), SvcExpires)) AS DaysToTakeAction
FROM dba.ServContract AS SContract
    LEFT JOIN dba.Vendor AS Vendor ON SvcVdrId = VdrId
    LEFT JOIN dba.ServContractType AS ContractType ON SvcSvctId = svctid
WHERE SvcRecStatus = 128              -- Alleen actieve contracten
    AND (SvcOwnerEmpId = {USERID} OR SvcManagEmpId = {USERID})
    AND SvcContext NOT IN (4, 16, 512)
    AND SvcToExpire <> 1              -- Niet al opgezegd
    AND SvcSilentProlong <> 1         -- Niet stilzwijgend verlengd
    AND SvcExpires < (SELECT DateAdd(MONTH, SvcTermWarning, 
                             DateAdd(DAY, 30, SYSDATETIMEOFFSET())))
ORDER BY DaysToTakeAction ASC

Aanpassingsmogelijkheden: - Verwijder de {USERID}-filter om alle contracten te tonen - Wijzig 30 dagen naar een andere attentieperiode - Voeg JOIN dba.Equipment toe om contracten per installatie te groeperen

Voorbeeld 3: Afgeronde jobs met ontbrekende storingsdata (FinishedJobsWithMissingFailureData)bewerken

Deze query vindt correctieve jobs die afgerond zijn maar waarbij storingsanalyse-velden niet zijn ingevuld. Cruciaal voor datakwaliteit en FMEA-analyses.

SELECT job.JobId, job.JobDescr, eqmt.EqmtDescr, cmpt.CmptDescr, 
       cmptp.CmptpDescr, fal.FalDescr1, rmy.RmyDescr
FROM dba.Job AS job
    LEFT JOIN dba.Component AS cmpt ON JobCmptId = CmptId
    LEFT JOIN dba.ComponentProblem AS cmptp ON JobCmptpId = CmptpId
    LEFT JOIN dba.FailType AS fal ON JobFalId = FalId
    LEFT JOIN dba.Remedy AS rmy ON JobRmyId = RmyId
    LEFT JOIN dba.WorkOrderType AS wot ON JobWotId = WotId
    LEFT JOIN dba.EqmType AS eqmt ON JobEqmtId = EqmtId 
WHERE job.JobRecStatus = 16           -- Status = Gereed
    AND wot.WotCategory = N'C'        -- Correctief
    AND job.JobContext IN (1, 16384, 32768)
    AND (
        job.JobCmptId IS NULL         -- Component ontbreekt
        OR job.JobCmptpId IS NULL     -- Componentprobleem ontbreekt
        OR job.JobFalId IS NULL       -- Storingsoorzaak ontbreekt
        OR job.JobRmyId IS NULL       -- Oplossing ontbreekt
    )
ORDER BY job.JobId

Aanpassingsmogelijkheden: - Voeg een datumfilter toe: AND job.JobRecCreateDate >= DATEADD(MONTH, -3, SYSDATETIMEOFFSET()) - Filter op specifiek objecttype: AND eqmt.EqmtId = 'xxx'

Voorbeeld 4: Mijn te verwerken jobs (MyJobsToBeProcessed)bewerken

De meest gebruikte widget: toont alle openstaande jobs van de ingelogde medewerker. Let op het gebruik van DISTINCT en de join met JobSchedulePart om ook ingeplande medewerkers mee te nemen.

SELECT DISTINCT(j.JobId), j.JobDescr, p.PrsDescr, j.JobSchStartDate, 
       j.JobTargetDate, j.JobFinalFinishDate, j.JobPrfId, jobprf.PrfDescr, 
       j.JobEqmId, JobEqm.EqmDescr, JobWot.Wotdescr1, Pri.PriDescr
FROM dba.Job AS j
    LEFT JOIN dba.ProgressStatus AS p ON JobPrsId = PrsId
    LEFT JOIN dba.Priority AS Pri ON JobPriId = PriId
    LEFT JOIN dba.JobSchedulePart AS JobSp ON JobId = JobspJobId
    LEFT JOIN dba.ProcessFunction AS JobPrf ON PrfId = JobPrfId
    LEFT JOIN dba.Equipment AS JobEqm ON EqmId = JobEqmId
    LEFT JOIN dba.WorkOrderType AS JobWot ON WotId = JobWotId
WHERE j.JobContext <> 1024            -- Geen actiepunten
    AND (JobEmpId = {USERID} OR JobspEmpId = {USERID})  -- Toegewezen OF ingepland
    AND j.JobRecStatus IN (1, 2, 4, 8, 8192)
ORDER BY j.JobSchStartDate ASC, j.JobId ASC

Aanpassingsmogelijkheden: - Voeg LEFT JOIN dba.Department toe om afdelingsinformatie te tonen - Voeg extra kolommen toe zoals JobSvcTargetDate voor SLA-deadlines - Filter op jobsoort: AND JobWot.WotCategory = 'P' voor alleen preventief onderhoud

Zie ookbewerken

• dashboards — Dashboard configuratie
• application-element-tree — AET-autorisatie
• feature-toggles — Feature toggles (sidebar)
• screens — Schermconfiguratie
• explorers — Explorer configuratie