Categorie: configuration Bijgewerkt: 2026-04-07 explorer-links navigatie screens uct

Explorer Links

Explorer Links definieren de navigatieverbindingen tussen schermen in Ultimo. Ze bepalen hoe een gebruiker vanuit een invoerveld op het ene scherm een record kan selecteren uit een ander scherm via een explorer-dialoog. Dit is een essentieel onderdeel van de gebruikersnavigatie in Ultimo.

Gerelateerd: explorers, screens, menu-designer, database-objects

Standaard kan een gebruiker in Ultimo een waarde selecteren uit een gerelateerde tabel via een dropdown-lijst (selection list). Explorer Links bieden een alternatief: ze openen een explorer-dialoog waarin de gebruiker door een boomstructuur kan navigeren om een waarde te selecteren.

Voorbeeldbewerken

Op het werkorderscherm (JOB01) verwijst het veld "Installatie" naar de tabel Equipment. Met een explorer link kan de gebruiker via de explorer-knop een boomstructuur openen met locaties, gebouwen en installaties om het juiste equipment te selecteren, in plaats van te zoeken in een platte lijst.

Hoe werkt het?bewerken

  1. Een invoerveld op een scherm verwijst naar een foreign key in een gekoppelde tabel
  2. De explorer link koppelt dit veld aan een specifieke explorer
  3. Wanneer de gebruiker op de explorer-knop klikt, opent de explorer in een dialoog
  4. De gebruiker selecteert een node in de boomstructuur
  5. De waarde wordt overgenomen in het invoerveld
  6. De explorer link bepaalt via link parts welke nodes geldig zijn als invoer voor het veld

Locatie in UCTbewerken

UCT > User Interface > Explorer Links

Schermstructuurbewerken

Lijstweergavebewerken

De lijstweergave toont alle beschikbare explorer links met de volgende kolommen:

Kolom Beschrijving
Explorer link ID Uniek nummer van de link (standaard links hebben een ID < 1000)
Target table De doeltabel waarnaar genavigeerd wordt
Explorer ID Het nummer van de gekoppelde explorer
Explorer description Beschrijving van de gekoppelde explorer
Custom Vinkje als de link is aangepast ten opzichte van de standaard

Detailpaneelbewerken

Na het selecteren van een explorer link toont het detailpaneel twee tabbladen:

Tabblad Basic

Veld Beschrijving
Explorer link ID Unieke identificatiecode van de link
Explorer De explorer waarop de link van toepassing is
Target table De tabel waarnaar de geselecteerde node-data wordt gekopieerd
Show screen Toont het standaardscherm in de explorer-dialoog
Use field value as root Opent de explorer-dialoog met alleen de tak voor de node die gerelateerd is aan de huidige veldwaarde. Als het veld leeg is, opent de explorer met de volledige structuur

Tabblad Definition

Het Definition-tabblad toont de volledige JSON-definitie van de explorer link met syntaxkleuring. Hier zijn de link parts zichtbaar die bepalen welke explorer-nodes geldig zijn als invoerwaarden voor een specifiek databaseveld.

De link parts bevatten padverwijzingen (bijv. JOBLELEMENT -> BI.ELEMENTPLAN.BI.BUILDIN) die definieren via welke relatiepaden de navigatie verloopt.

Stap 1: Bepaal de behoeftebewerken

  1. Ga naar UCT > User Interface > Explorer Links
  2. Klik op Toevoegen om een nieuwe link aan te maken

Stap 3: Configureer de basisbewerken

  1. Vul het Explorer link ID in (gebruik een ID >= 1000 voor custom links)
  2. Selecteer de Explorer die de boomstructuur levert
  3. Stel de Target table in op de tabel van het doelveld
  4. Configureer eventueel Show screen en Use field value as root
  1. Ga naar het tabblad Definition
  2. Definieer de relatiepaden die bepalen welke nodes geldig zijn als invoer
  3. Elk link part koppelt een explorer-node aan een foreign key veld

Stap 5: Koppel aan het schermveldbewerken

  1. Ga naar UCT > User Interface > Screens (zie screens)
  2. Open het scherm waar het veld zich bevindt
  3. Selecteer het invoerveld en ga naar het tabblad View in de properties
  4. Stel het veld Explorer link in op de zojuist aangemaakte link
  5. Als er al een standaard explorer link bestaat, kun je de optie "Default" selecteren

Stap 6: Testen en opnemenbewerken

  1. Test de explorer link in de applicatie door op de explorer-knop te klikken
  2. Controleer of de juiste nodes selecteerbaar zijn
  3. Neem de wijziging op in een package via de package-manager
Eigenschap Standaard links (ID < 1000) Custom links (ID >= 1000)
Aangemaakt door Ultimo Consultant/klant
Verwijderbaar Nee Ja
Aanpasbaar Ja, maar herstelbaar naar fabrieksdefinitie Volledig aanpasbaar
Bij upgrade Fabrieksdefinitie wordt bijgewerkt Niet gewijzigd door Ultimo

Fabrieksdefinitie herstellenbewerken

Standaard explorer links (ID < 1000) die zijn aangepast kunnen worden teruggezet:

  1. Open UCT > User Interface > Explorer Links
  2. Selecteer de link met een vinkje in de kolom Custom
  3. Klik op Remove configuration
  4. Bevestig met Yes om de custom definitie te verwijderen en de fabrieksdefinitie te herstellen
Gebruik Mechanisme Wanneer?
Explorer link Selectie van een waarde via een boomstructuur Als de gebruiker een foreign key moet invullen en de gerelateerde tabel een logische hiërarchie heeft (bijv. locatie > gebouw > installatie)
Menu-item Navigatie naar een scherm via het hoofdmenu Als de gebruiker direct naar een scherm wil navigeren zonder een waarde te selecteren
Selection list Platte dropdown-lijst Als de gerelateerde tabel weinig records bevat of geen hiërarchie heeft

Onderlinge relatiesbewerken

Component Relatie met Explorer Links
explorers Explorer links verwijzen naar explorers via het Explorer ID
screens Het invoerveld op een scherm wordt gekoppeld aan de explorer link
menu-designer Menu Designer definieert navigatie op hoger niveau; explorer links definieren navigatie op veldniveau
database-objects De target table en foreign key relaties verwijzen naar database-objecten
package-manager Wijzigingen aan explorer links worden opgenomen in packages

Best practicesbewerken

  1. Test altijd na aanpassing — een fout in een link path leidt ertoe dat de navigatie niet werkt of verkeerde gegevens toont
  2. Gebruik "Use field value as root" — dit beperkt de explorer tot de relevante tak, wat de selectie versnelt bij grote boomstructuren
  3. Documenteer custom links — leg vast welke custom explorer links zijn aangemaakt, voor welk scherm, en waarom
  4. Herstel standaard links alleen bewust — het verwijderen van een custom definitie op een standaard link zet deze terug naar de fabrieksdefinitie
  5. Neem wijzigingen op in een package — zodat ze overdraagbaar zijn naar andere omgevingen (OTAP)

Zie ookbewerken