Widgets füllen dein Dashboard mit Leben. Je nachdem, welche Daten du anzeigen möchtest, stehen dir die Widget-Typen Diagramm, Einzelne Zahl, 4APQL Tabelle oder Verknüpfung zur Verfügung.

Jedes Widget hat Presets mit voreingestellten Daten, sodass du auch ohne Vorkenntnisse direkt loslegen und ausprobieren kannst.

Dashboard mit den Widget-Typen "Diagramm", "Verknüpfung" und "Tabelle"

Widget hinzufügen & bearbeiten

Öffne das Modul Dashboard (falls es nicht dein Startmodul ist) über das Mega Menü. Wähle das Dashboard aus, mit dem du arbeiten möchtest.
Bevor du Widgets hinzufügen kannst, musst du zuerst ein Dashboard erstellen.

Neues Widget hinzufügen

Klicke in der Dashboard Hauptansicht oben rechts auf die Schaltfläche
Es öffnet sich ein Auswahl-Pop-Up mit den verfügbaren Widget-Typen.
Wähle den passenden Widget-Typ aus:
Nach der Auswahl öffnet sich ein Konfigurations-Pop-Up mit drei Bereichen:
1. Seitenleiste
  Wähle aus, ob du ein neues Widget erstellen oder ein Preset mit vorausgefüllten Daten für einen schnellen Start verwenden möchtest.
2. Widget-Vorschau
  So sieht dein Widget auf dem Dashboard aus. Die Vorschau passt sich an, sobald du Größe oder Daten konfigurierst.
3. Widget-Konfiguration
  - Lege den Namen für dein Widget und seine Breite fest.
    Die Höhe und die Breite kannst du später auf dem Dashboard anpassen.
  - Im Anschluss bestimmst du die Daten, die dein Widget anzeigen soll. Die Optionen unterscheiden sich je nach Widget-Typ.
  - Nutzt du eine Query, klicke "Filter-Query übernehmen" zur Bestätigung.
  - Das Ergebnis der Konfiguration kannst du in der Vorschau sehen.
  Die drei Bereiche des Konfigurations-Pop-Ups
Wenn du fertig bist, kannst du dein Widget erstellen:
1. Klicke "Als Preset speichern", wenn du dein Widget als persönliche Vorlage speichern möchtest. Es erscheint dann in der linken Seitenleiste.
2. Klicke "Erstellen", um das Widget deinem Dashboard hinzuzufügen.
  Du kannst deine Einstellungen nach dem Speichern jederzeit bearbeiten.

Über die Schaltfläche "Vorherige" kehrst du zur Widget-Auswahl zurück.

Bitte beachte

Die Konfigurationsmöglichkeiten unterscheiden sich je Widget-Typ. Alle Details zu den Typen und ihrer Konfiguration findest du hier: Widget-Typen & Konfiguration.

Widget bearbeiten

Jedes Widget auf deinem Dashboard kann über sein Drei-Punkte-Menü jederzeit angepasst werden. Du hast folgende Optionen:

Bearbeiten
- Öffnet das Konfigurations-Pop-Up. Hier kannst du alle Einstellungen anpassen.
- Beachte: Es gibt keine Funktion "Speichern unter". Möchtest du deine alte Variante behalten, speichere sie vorher als Preset oder dupliziere dein Widget auf dem Dashboard.
Duplizieren
- Beim Duplizieren wird eine Kopie des Widgets erstellt. Er erscheint an der ersten freie Position des Dashboards. Der Name wird ebenfalls kopiert.
Löschen
- Willst du das Widget für einen späteren Zeitpunkt erhalten, speichere es vorher als Preset.

Über das Drei-Punkte-Menü kannst du Widgets bearbeiten, duplizieren oder löschen

Bitte beachte
Wenn du ein Widget bearbeitest oder löscht, das auf einem geteilten Dashboard liegt, bearbeitest und löschst du es auch für andere Benutzer.

Widget-Typen & Konfiguration

Je nachdem, welchen Widget-Typen du beim Erstellen auswählst, hast du unterschiedliche Optionen bei der Konfiguration und Darstellung:

Diagramm: Zeigt die Objekte eines Moduls als Balken- oder Donut-Diagramm, sortiert nach den Werten eines bestimmten Metadatenfelds
Einzelne Zahl: Zeigt eine automatisch erfasste Systemmetrik, z.B. tägliche Anzahl der Uploads oder der verfügbare Speicherplatz auf dem Mount-Laufwerk
4APQL Tabelle: Zeigt die Objekte eines Moduls und alle ausgewählten Metadatenfelder in eine Tabelle, auf Basis einer 4APQL Query
Verknüpfung: Zeigt Links zu häufig benötigten Modulen oder Websites

Klicke zum Erstellen den jeweiligen Typ im Auswahl-Pop-Up an:

Widget "Diagramm"

Mit einem Diagramm kannst du ein Balken- oder Donut-Diagramm erstellen, das die Objekte eines Moduls nach den Werten eines Metadatenfelds sortiert.

So kannst du z.B. sehen, wie viele Dateien in welchem Freigabestatus liegen.

Im Bereich Widget-Konfiguration stehen dir folgende Felder zur Verfügung:

Feldname	Beschreibung
Diagrammtyp	Wähle für die Darstellung entweder Balkendiagramm oder Donut aus. Für viele unterschiedliche Werte bietet sich ein Balkendiagramm über die gesamte Dashboard-Breite an.
Modul	Wähle über das Drop-Down-Menü das Modul aus, dessen Objekte dich interessieren, z.B. "Dateien".
Feld	Erscheint erst nach der Modulauswahl. Wähle hier ein modulspezifisches Metadatenfeld aus, für das du dich interessierst, z.B. "Freigabestatus".
Query (optional)	Du kannst deine Modul- und Feldauswahl über eine 4APQL Query weiter verfeinern und z.B. bestimmte Werte ausblenden. Klicke nach Änderungen "Filter-Query übernehmen". Details: Was ist 4APQL und wie nutze ich sie?
Gesamt	Standardmäßig aktiv. Zeigt in deinem Diagramm auch den Gesamtwert der Modulobjekte an.
Legende	Nur für den Diagrammtyp "Donut". Standardmäßig aktiv. Zeigt rechts neben dem Donut die Legende mit Werten an.

Nutze die Widget-Vorschau, um deine Konfiguration zu prüfen.

Die Diagramm-Typen "Balkendiagramm" oder "Donut" im Vergleich

Bitte beachte
Dir werden nur Module und Metadatenfelder angezeigt, für die du auch die Rechte hast. Unterschiedliche Rollen können daher unterschiedliche Inhalte angezeigt bekommen.

Widget "Einzelne Zahl"

Dieser Widget-Typ stellt eine einzelne, aussagekräftige Zahl dar. Du hast die Auswahl zwischen mehreren Systemmetriken, die das 4ALLPORTAL automatisch erfasst, z.B. "Anzahl aller Dateien" oder "Nutzbarer Speicherplatz auf dem Mount-Laufwerk".

Im Konfigurations-Pop-Up kannst du die für dich interessante Metrik aus einem Drop-Down-Menü auswählen:

Die der Metrik entsprechende Zahl wird dir dann in deinem Widget angezeigt.

Aktualisierung

Für das Widget "Einzelne Zahl" werden automatisch erfasste Metriken verwendet (z.B. für "Tägliche Anzahl der Uploads").

Beachte, dass diese nicht live abgebildet werden können, sondern mit einer Verzögerung.

Widget "4APQL Tabelle"

Mit einer 4APQL Tabelle kannst du eine individuelle Tabelle erstellen, die die Objekte eines Moduls mit den Werten mehrerer Metadatenfelder anzeigt. Mithilfe einer 4APQL Query musst du deine Tabelle spezifizieren.

So kannst du z.B. alle Aufgaben anzeigen, die dir zugeordnet sind und den Status "Offen" haben.

Im Bereich Widget-Konfiguration stehen dir folgende Felder zur Verfügung:

Feldname	Beschreibung
Modul	Wähle über das Drop-Down-Menü das Modul aus, dessen Objekte dich interessieren, z.B. "Aufgaben".
Query	Du musst deine Modul- und Feldauswahl über eine 4APQL Query eingrenzen, z.B.: `assignees.username = '[email protected]'`. Klicke nach Änderungen "Filter-Query übernehmen". Beachte: Ohne Query lässt sich dieses Widget nicht speichern. Details: Was ist 4APQL und wie nutze ich sie?
Felder	Erscheint erst nach der Modulauswahl. Wähle hier ein oder mehrere modulspezifische Metadatenfelder aus, die als Spalten in deiner Tabelle angezeigt werden sollen, z.B. "Status" und "Fälligkeitsdatum". Du kannst die Reihenfolge über die Schaltfläche anpassen.

Nutze die Widget-Vorschau, um deine Konfiguration und deine Query zu prüfen.

Wenn du das Widget "4APQL Tabelle" nutzen, aber keine Query verwenden willst, trage 0 = 0 ein. Das Widget lässt sich mit dieser Query speichern und zeigt als Ergebnis alle Modulobjekte an.

Je mehr Metadatenfelder du auswählst, desto breiter solltest du die Tabelle anlegen

Bitte beachte
Dir werden nur Module und Metadatenfelder angezeigt, für die du auch die Rechte hast. Unterschiedliche Rollen können daher unterschiedliche Inhalte angezeigt bekommen.

Widget "Verknüpfung"

Mit einer Verknüpfung kannst du dir eine beliebige URL auf dein Dashboard legen, so dass du sie direkt im Zugriff hast.

Auch interne Links zu Modulen oder Detailansichten sind möglich, z.B. ein Link zu einer bestimmten Sammlung, die du häufig nutzt. Kopiere dafür einfach die entsprechende URL aus der Adressleiste.

Externe Links werden in einem neuen Tab geöffnet, interne Links bleiben im selben Tab.

Im Bereich Widget-Konfiguration stehen dir folgende Felder zur Verfügung:

Feldname	Beschreibung
URL	Gib hier die URL ein, zu der der Link führen soll. Die URL benötigt `https://` oder `http://`
URL anzeigen	Standardmäßig aktiv. Zeigt die URL auf deiner Widget-Kachel an.

Verknüpfungen können auf externe und interne URLs verweisen

Was ist 4APQL und wie nutze ich sie?

4APQL ist eine systemeigene, an SQL angelehnte Abfragesprache für direkte Anfragen an die Datenbank (4ALLPORTAL Query Language).

Das Widget "4APQL Tabelle" muss mit einer manuell eingegebenen 4APQL Query erstellt werden.

Hier sind ein paar Tipps und Beispiele für das Anlegen einer Query:

Schaue dir die verwendeten Querys in den Presets an, vielleicht kannst du sie für deine Zwecke abwandeln.
Nutze die Widget-Vorschau zur Kontrolle. Wenn deine Query nicht funktioniert, zeigt die Vorschau eine Fehlermeldung an.
Beziehst du dich auf die Metadatenfelder des ausgewählten Moduls, musst du ihren technischen Feldnamen verwenden.
- Beispiel: "Ersteller" im Modul Aufgaben muss als created_by notiert werden.
Beziehst du dich auf ein Relationsfeld, musst du es entsprechend der Syntax Metadatenfeld Ausgangs-Modul.Metadatenfeld Referenz-Modul notieren.
- Beispiel: Der Bearbeiter einer Aufgabe bezieht sich auf das Modul Benutzer. Das Metadatenfeld Bearbeiter muss als assignees.username notiert werden.
Beziehst du dich auf Text-basierte Werte (Strings) aus Metadatenfeldern, müssen sie in einfache Anführungszeichen gesetzt werden.
- Beispiel: release_status IN ('free', 'blocked', 'restricted')
- Beispiel: assignees.username = '[email protected]'
Beziehst du dich auf Nummer-basierte Werte oder Werte, die den Zustand eines Feldes beschreiben wie null, true oder false, müssen sie ohne einfache Anführungszeichen gesetzt werden.
- Beispiel: keywords IS null
- Beispiel: size >= 5242880
Beziehst du dich auf ein bestimmtes Objekt, kannst du dessen ID benutzen. Öffne dafür den Datensatz, kopiere die ID aus der URL (hinter "record=") und verwende sie in deiner Query. Öffne z.B. dein Profil für deine eigene ID.
- Beispiel: created_by = '70394110-d808-4697-bb58-14a5cf36f0ge'

Weiterführende Informationen
Alle unterstützten Query-Parameter und weitere Beispiele findest du in der technischen Dokumentation: 4ALLPORTAL Query Language.

Um das Zusammenstellen von Querys in Zukunft zu erleichtern, arbeiten wir schon an der Unterstützung von Typeahead-Vorschlägen. 💪

Presets

Presets sind Widgets mit bereits vorausgefüllten Werten, die du in der Seitenleiste des Konfigurations-Pop-ups auswählen und direkt erstellen kannst.

Im Standard werden pro Widget-Typ zwei Presets mitgeliefert, mit denen du direkt starten kannst.

Wenn du ein Widget mit eigenen Werten erstellst, kannst du es jederzeit als Preset speichern und so als persönliche Vorlage nutzen.

Die mitgelieferten und persönlichen Presets erscheinen in jedem Konfigurations-Pop-Up des entsprechenden Widget-Typs.

Bestehende Presets nutzen

Wähle das Dashboard aus, mit dem du arbeiten möchtest.
Klicke in der Dashboard Hauptansicht oben rechts auf die Schaltfläche
Wähle im Auswahl-Pop-Up den passenden Widget-Typ aus.
Es öffnet sich das Konfigurations-Pop-Up.
Wähle in der Seitenleiste unter "Presets" ein Preset aus.
Im Bereich Widget-Vorschau siehst du, was dieses Widget auf deinem Dashboard anzeigen würde.
Im Bereich Widget-Konfiguration siehst du die vorausgefüllten Werte.
Mache bei Bedarf noch individuelle Anpassungen der Werte. Die Effekte siehst du direkte in der Vorschau.
Speichere bei Bedarf als neues Preset.
Klicke "Erstellen", damit das Widget auf deinem Dashboard erscheint.

Mitgelieferte Presets für den Widget-Typ "4APQL Tabelle"

Persönliche Presets speichern

Du kannst ein Widget jederzeit als Preset speichern. Zum Beispiel, wenn es eine nützliche Grundlage für andere Widgets ist oder um es zu sichern, bevor du es von einem Dashboard löschen möchtest.

Du hast zwei Möglichkeiten:

Direkt beim Erstellen
- Klicke im Konfigurations-Pop-Up zuerst auf die Schaltfläche "Als Preset speichern", bevor du auf "Erstellen" klickst.
Jederzeit nach dem Erstellen
- Öffne in der rechten oberen Ecke eines Widgets auf dem Dashboard das Dreipunkte-Menü.
- Klicke darin auf die Schaltfläche "Widget bearbeiten".
- Klicke im Konfigurations-Pop-Up auf die Schaltfläche "Als Preset speichern".

Nach dem Speichern erscheint dein Preset als oberster Eintrag direkt in der Seitenleiste.

Bitte beachte: Persönliche Presets sind nur für dich sichtbar.

Widget vom Typ "4APQL Tabelle" gespeichert als persönliches Preset

Presets löschen

Um ein nicht mehr benötigtes Preset zu löschen, fahre einfach mit deiner Maus über einen Preset-Eintrag in der Seitenleiste. Die Schaltfläche Papierkorb "Preset löschen" erscheint und du kannst das Preset löschen.

💡 Häufige Fragen (FAQ)

Kann ich ein Widget nachträglich in einen anderen Typ umwandeln?
Nein, du musst ein neues Widget mit dem gewünschten Typ erstellen.
Warum sehe ich nicht alle Module oder Felder?
Dir werden nur Inhalte angezeigt, für die du auch die entsprechenden Rechte hast.
Wie kann ich ein Widget duplizieren, ohne es neu zu konfigurieren?
Öffne das Drei-Punkte-Menü und klicke auf "Duplizieren". Das neue Widget erscheint automatisch auf deinem Dashboard.
Was passiert, wenn ich ein Widget auf einem geteilten Dashboard lösche?
Es wird auch für alle anderen Benutzer entfernt, die Zugriff auf dieses Dashboard haben.
Kann ich Presets mit Kollegen teilen?
Nein, deine persönlichen Presets sind nur für dich sichtbar.