Allgemeines

Der Explorer ist die zentrale Stelle, um Ihre Plattform-Inhalte zu organisieren. Er zeigt alle von Ihnen angelegten Struktureinträge (z. B. Datenquellen, Assets) sowie die damit verbundenen Signale und weitere Elemente in einer Baumstruktur an – ähnlich wie ein Dateibrowser. Im Explorer können Sie Einträge finden, anlegen, bearbeiten, verschieben und löschen.

Aufbau des Explorers

Ganz oben in der Struktur befindet sich die Wurzel (Root-Knoten):

• Die Wurzel trägt den von Ihnen vergebenen Namen (z. B. für einen Standort, Mandanten oder Datenbereich).
• Auf der obersten Ebene gibt es nur diesen einen Eintrag.
• Alle Inhalte werden unterhalb dieser Wurzel organisiert.

Explorerinhalte

Im Explorer können unterschiedliche Arten von Einträgen vorkommen. Typischerweise sehen Sie unterhalb der Wurzel u. a.:

• Assets (zur Strukturierung und Gruppierung)
• Signale und virtuelle Signale
• Signalgruppen
• Workflow-Konfigurationen
• Konstanten
• Formulare
• Dashboards

Welche Einträge Ihnen zur Verfügung stehen, hängt von Konfiguration und Berechtigungen ab.

Einträge hinzufügen

Neue Einträge legen Sie direkt im Explorer an. Öffnen Sie dazu das Kontextmenü eines Eintrags und wählen Sie Hinzufügen → gewünschter Typ.

Unter „Hinzufügen“ stehen folgende Optionen zur Verfügung:

Bereich „Datenquellen“

• Signal
• Virtuelles Signal
• Workflow-Konfiguration
• Konstante
• Signalgruppe
• Formulare

Bereich „Sonstige“

• Asset
• Dashboard

Wichtig

Neue Einträge werden immer unterhalb des Eintrags angelegt, den Sie zuvor ausgewählt haben. So bestimmen Sie direkt den richtigen Ort in der Struktur.

Navigation und Übersicht im Explorer

• Über die Auf- und Zuklappen-Symbole (Pfeile) können Sie Strukturzweige ein- oder ausblenden.
• Wenn Sie einen Eintrag auswählen, zeigt die Plattform die zugehörigen untergeordneten Einträge dieses Strukturzweigs an (auch über mehrere Ebenen). Dadurch erhalten Sie schnell einen vollständigen Überblick über den ausgewählten Bereich.

Einträge verschieben

Einträge können innerhalb des Explorers verschoben werden, um die Struktur anzupassen.

Dabei gilt:

• Beim Verschieben eines Eintrags werden alle Einträge, die darunter eingeordnet sind, mit verschoben.
• Die interne Struktur bleibt dabei erhalten.

Einträge löschen und wiederherstellen

Einträge können gelöscht werden. Beim Löschen berücksichtigt die Plattform, ob der Eintrag weitere untergeordnete Inhalte enthält:

• Wenn Sie ein Asset löschen und darunter noch Inhalte eingeordnet sind, erhalten Sie einen Hinweis.
• Gelöschte Einträge werden markiert und nicht mehr angezeigt.
• Gelöschte Assets können bei Bedarf wiederhergestellt werden. Hierfür ist der Anwendungssupport zu kontaktieren.
• Inhalte, die unterhalb des gelöschten Eintrags eingeordnet waren, werden im selben Schritt ebenfalls als gelöscht markiert.

Auswirkungen auf Workflows und Dashboards

Wenn Workflows oder Dashboards auf Einträge verweisen, die im Explorer gelöscht wurden, bleiben diese weiterhin funktionsfähig. Das Löschen wirkt sich damit primär auf die Strukturansicht und Verwaltung im Explorer aus.

Eigenschaften

Wenn Sie im Explorer für einen Eintrag Eigenschaften öffnen, erscheint eine Bearbeitungsansicht (z. B. „Asset bearbeiten“). In dieser Ansicht können Sie die grundlegenden Angaben des ausgewählten Eintrags ändern und zusätzliche Eigenschaften pflegen.

Kopfbereich der Bearbeitungsansicht

• Titel: zeigt an, was Sie gerade bearbeiten (z. B. „Asset bearbeiten“).
• Schließen (X): beendet die Bearbeitung und schließt die Ansicht.
• Typ: direkt unter dem Titel wird der Typ des Eintrags angezeigt (z. B. „Typ Ordner“). Das hilft zu erkennen, welche Art von Eintrag Sie bearbeiten.

Bereich „Allgemeines“

Im Abschnitt Allgemeines pflegen Sie die Basisdaten des Eintrags:

• Name (Pflichtfeld) – hier vergeben oder ändern Sie die Bezeichnung des Eintrags (z. B. „Test Standort“). Der Name wird im Explorer in der Struktur angezeigt.
• Beschreibung (optional) – hier können Sie eine kurze textliche Beschreibung hinterlegen, z. B. den Zweck, den Status oder Hinweise für andere Nutzer. Häufig gibt es eine Zeichenbegrenzung, die z. B. mit 9 / 255 dargestellt wird.

Die Abschnitte können über das Auf-/Zuklappen-Symbol rechts im Abschnittstitel ein- oder ausgeblendet werden.

Bereich „Eigenschaften“ (zusätzliche Attribute)

Im Abschnitt Eigenschaften verwalten Sie zusätzliche Merkmale des Eintrags.

• Über die Schaltfläche „+ Eigenschaften hinzufügen“ können Sie dem Eintrag weitere Eigenschaften hinzufügen. Diese Eigenschaften dienen dazu, Einträge genauer zu beschreiben oder zu klassifizieren (z. B. zur Strukturierung, Auswertung oder für interne Konventionen).

Auch dieser Abschnitt lässt sich über das Auf-/Zuklappen-Symbol ein- oder ausblenden.

Berechtigungen der Einträge

Über den Menüpunkt Berechtigungen legen Sie fest, wer einen Eintrag im Explorer verwenden darf und mit welchem Umfang. Die Berechtigungen werden in einer eigenen Ansicht angezeigt (Titel: „Berechtigungen“) und können über das X oben links wieder geschlossen werden.

Die Ansicht ist in drei Register unterteilt: Gruppen, Benutzer und Effektive Berechtigungen.

Register „Gruppen“

Im Register Gruppen vergeben Sie Berechtigungen an Benutzergruppen.

• Suchfeld „Suchen…“: Filtert die Liste der Gruppen.
• Schaltfläche „+ Hinzufügen“: Legt eine neue Berechtigungszuweisung für eine Gruppe an (z. B. „Anzeigen“ oder „Bearbeiten“, abhängig von der Plattform-Konfiguration).
• Spalte „Berechtigungen“: Zeigt an, welche Berechtigungsstufe einer Gruppe zugeordnet ist.
• Info-Symbol (i): Kontextinformationen zur Bedeutung der Berechtigungen.
• Zahnrad-Symbol: Öffnet zusätzliche Optionen/Einstellungen für die Berechtigungsansicht (je nach Konfiguration).

Gruppen sind in Keycloak zu konfigurieren. Hierfür ist ggf. der Anwendungssupport zu kontaktieren.

Register „Benutzer“

Im Register Benutzer vergeben Sie Berechtigungen an einzelne Nutzer.

• Suchfeld „Suchen…“: Filtert nach Benutzernamen.
• Schaltfläche „+ Hinzufügen“: Fügt einen Benutzer hinzu und weist ihm eine Berechtigung zu.
• Pro Benutzer wird die zugewiesene Berechtigung angezeigt (im Beispiel: „Bearbeiten“).
• Neben der Berechtigungs-Auswahl befindet sich ein Papierkorb-Symbol zum Entfernen der Zuweisung.

Benutzer sind in Keycloak zu konfigurieren. Hierfür ist ggf. der Anwendungssupport zu kontaktieren.

Register „Effektive Berechtigungen“

Im Register Effektive Berechtigungen sehen Sie die tatsächlich wirksamen Rechte von Benutzern auf ein bestimmtes Explorer-Objekt. Diese Übersicht ist besonders hilfreich, wenn Berechtigungen aus mehreren Quellen zusammenkommen (z. B. direkte Benutzerzuweisung + Gruppenmitgliedschaft + Vererbung).

• Benutzername: Für wen die Berechtigung gilt.
• Berechtigung: Welche Berechtigung effektiv gilt (z. B. „Bearbeiten“).
• Zuordnung durch: Woher die Berechtigung stammt (z. B. „Benutzer“, wenn sie direkt vergeben wurde).
• Vererbung durch: Von welchem Eintrag die Berechtigung ggf. geerbt wird (im Beispiel: „Test Standort“).

Änderungshistorie der Einträge

Über den Menüpunkt Änderungshistorie können Sie nachvollziehen, wann ein Eintrag geändert wurde, wer die Änderung durchgeführt hat und welche Werte sich dabei verändert haben. Die Historie wird in einer eigenen Ansicht angezeigt (Titel: „Änderungshistorie“) und kann über das X oben links geschlossen werden.

Aufbau der Änderungshistorie

Die Änderungshistorie ist als Tabelle aufgebaut. Jede Zeile steht für eine protokollierte Änderung an einem Feld des Eintrags.

Spalte	Bedeutung
Änderungszeitpunkt	Zeitpunkt der Änderung (Datum und Uhrzeit).
Anmeldename	Benutzerkonto, das die Änderung durchgeführt hat.
Feld	Das Feld bzw. die Einstellung, die geändert wurde.
Aktueller Wert	Der Wert nach der Änderung.
Früherer Wert	Der Wert vor der Änderung.

Filtern und Suchen

• Zeitraum-Filter im Bereich Änderungszeitpunkt: Über Startzeitpunkt und Endzeitpunkt grenzen Sie die Historie auf einen Zeitraum ein.
• Suche nach Anmeldename: Über das Suchfeld können Sie Änderungen eines bestimmten Benutzers filtern.
• Suche nach Feld: Über das Suchfeld können Sie gezielt nach einem Feld- bzw. Einstellungsnamen suchen.

Ausführungshistorie anzeigen

Über den Menüpunkt Ausführungshistorie öffnen Sie eine Übersicht der bisherigen Ausführungen. Die Übersicht zeigt, wann eine Ausführung gestartet wurde, wie lange sie gedauert hat, welche Daten verarbeitet wurden und ob sie erfolgreich abgeschlossen wurde.

hinweis

Diese Ansicht ist nur für bestimmte Objekte verfügbar (z. B. virtuelle Signale oder Workflow-Konfigurationen).

Aufbau der Ausführungshistorie

Die Ausführungen werden tabellarisch dargestellt. Für jede Ausführung werden unter anderem folgende Informationen angezeigt:

• Startzeitpunkt: Datum und Uhrzeit, zu der die Ausführung gestartet wurde.
• Gesamtdauer (s): Gesamtdauer der Ausführung in Sekunden.
• Datenbereitstellung (s): Zeit, die für die Bereitstellung der Daten benötigt wurde.
• Datenpunkte geladen: Anzahl der Datenpunkte, die für die Ausführung geladen wurden.
• Datenausgabe (s): Zeit, die für die Ausgabe beziehungsweise Verarbeitung der Daten benötigt wurde.
• Datenpunkte gesendet: Anzahl der Datenpunkte, die im Rahmen der Ausführung gesendet oder ausgegeben wurden.
• Status: Ergebnis der Ausführung, beispielsweise Erfolgreich.
• Fehlertyp: Zeigt gegebenenfalls die Art eines aufgetretenen Fehlers an. Bei einer erfolgreichen Ausführung wird kein Fehlertyp angezeigt.
• Öffnen: Über diesen Eintrag können Sie die Details einer einzelnen Ausführung öffnen.

Ausführungen filtern

• Verwenden Sie die beiden Felder unter Startzeitpunkt, um einen Startzeitraum festzulegen.
• Filtern Sie nach Status, um beispielsweise nur erfolgreiche oder fehlgeschlagene Ausführungen anzuzeigen.
• Verwenden Sie den Filter Fehlertyp, um nach einer bestimmten Fehlerart zu suchen.

Die Tabelle zeigt außerdem an, wie viele Einträge insgesamt vorhanden sind und wie viele davon aktuell angezeigt werden.

Details einer Ausführung öffnen

Klicken Sie in der gewünschten Zeile auf Öffnen, um weitere Informationen zu dieser Ausführung anzuzeigen. Die Detailansicht unterstützt Sie dabei, einzelne Ausführungen genauer zu prüfen.