Board
Die Widget-Ansicht Board erlaubt die Darstellung von Datensätzen als verschiebbare Zettel, die in vertikalen Gruppen angeordnet sind.

Konfiguration
-
Datentyp: Auswahl des Datentyps, der auf dem Board dargestellt wird.
-
Gruppierung: Einteilung der darzustellenden Datensätze in Gruppen.
-
nach Feld: Auswahl eines Felds, über das die Datensätze anhand des jeweiligen Feldwerts in Gruppen eingeteilt werden.
-
durch Makro: Auswahl eines Makros vom Typ Board-Gruppierung, welches die darzustellenden Gruppen definiert und ihnen entsprechend Datensätze zuordnet.
-
-
Sortierung: Mehrfach-Auswahl von Feldern, nach denen die Datensätze innerhalb der Gruppen sortiert werden.
-
Darstellung: Aussehen der Kärtchen, auf denen die Datensätze dargestellt werden.
-
Einfärbung: Wie die Farbe des Titelbands individuell pro Kärtchen ermittelt wird.
-
Titel: Welche Information als "Überschrift" im Titelband des Kärtchens angezeigt wird.
-
Untertitel: Welche Information unterhalb des Titelbands mittig auf dem Kärtchen angezeigt wird.
-
Details: Welche Informationen am unteren Rand als "Badges" (Mini-Wappen) dargestellt werden.
-
Hinweise
Folgende Hinweise sind bei der Erstellung eines Board-Widgets zu beachten:
Gruppierung "nach Feld"
- Im Auswahlfeld stehen ausschließlich Felder zur Auswahl, die eine fest definierte Wertemenge haben. Dies sind:
- Listenfelder
- Enums / Aufzählungen
- Status
- Für jedes Element der Werteliste wird eine Gruppe erzeugt. Die Sortierung der Gruppen ist chronologisch nach ihrer Position in der Wertemenge.
- Eine Gruppe mit Namen "(kein Wert)" wird erzeugt, wenn es Datensätze gibt, an denen das Feld leer ist, nach dem gruppiert wird. Diese Gruppe erscheint dann immer ganz vorne im Board.
- Gibt es Datensätze mit Werten außerhalb der Wertemenge, werden für diese Werte zusätzliche Gruppen am Ende des Boards erzeugt und die Datensätze dort einsortiert. Die Reihenfolge dieser "Zusatz-Gruppen" ist zufällig und kann je nach Datenquelle variieren.
Gruppierung "durch Makro"
- Im Makro-Auswahlfeld werden alle Makros vom Typ Board-Gruppierung angezeigt, die für den entsprechenden Board-Datentyp angelegt wurden.
- Es können allerdings nur Makros ausgewählt werden, auf die der Benutzer Zugriffsrechte hat und die sich im Status "zugelassen" befinden.
Gruppierung "durch Makro"
- Es ist nicht möglich, Datensätze über das Makro auszublenden, die von der Datenquelle geliefert wurden. Wird ein Datensatz keiner Gruppe zugeordnet, wird der Aufbau des Boards mit einem Validierungsfehler abgebrochen.
- Auch das Zuweisen von Datensätzen in mehrere Gruppen ist nicht erlaubt. Auch in diesem Fall wird der Aufbau des Boards mit einem Validierungsfehler abbrechen.
Darstellung
- Im Auswahlfeld Einfärbung kann aus folgenden Farbschemata gewählt werden:
- Standard: alle Karten haben dieselbe Farbe
- wie Status: die Status-Farbe wird verwendet
- wie Priorität: die Priorität-Farbe wird verwendet
- wie Validierungshinweis: die Farbe des Validierungshinweis am Titel-Feld wird verwendet
- Titel, Untertitel und Details unterstützen keine Darstellung von formatierten Texten und diaLIMS-Links.
Darstellung
- Als Titel sollte ein Feld gewählt werden, welches den Datensatz eindeutig ausweist, z.B. die Kurzbezeichnung/Identifikations-Nummer oder OID.
- Als Untertitel sollte ein Feld gewählt werden, welches für den Datensatz eine wichtige zusätzliche Information darstellt, z.B. das Feld "Beschreibung".
- In den Details sollten kürzere Informationen erscheinen, die individuell für den Verwendungszweck des Boards relevante Informationen darstellen.
Einrichtungsbeispiel
Probennahme-Übersicht
In diesem Beispiel sollen die geplanten Probennahmen der aktuellen Kalenderwoche gruppiert nach Wochentag dargestellt werden. Die Proben sollen innerhalb der Gruppen nach Priorität sortiert und eingefärbt werden.
-
Makro-Konfiguration
-
Datentyp Probe
-
Typ Board-Gruppierung
-
Status zugelassen
-
Benutzer (angemeldeter Benutzer)
Code
import java.time.DayOfWeek;import com.dialog.util.DateUtil;// Listen für die Proben jedes WochentagsmontagList = new ArrayList<>();dienstagList = new ArrayList<>();mittwochList = new ArrayList<>();donnerstagList = new ArrayList<>();freitagList = new ArrayList<>();samstagList = new ArrayList<>();sonntagList = new ArrayList<>();for(Probe probe : objects) {datum = probe.getPlandatum();// Wochentag ermitteln und anhand dessen einordnendayOfWeek = DateUtil.dateToLocalDate(datum).getDayOfWeek();if (dayOfWeek == DayOfWeek.MONDAY) {montagList.add(probe);} else if (dayOfWeek == DayOfWeek.TUESDAY) {dienstagList.add(probe);} else if (dayOfWeek == DayOfWeek.WEDNESDAY) {mittwochList.add(probe);} else if (dayOfWeek == DayOfWeek.THURSDAY) {donnerstagList.add(probe);} else if (dayOfWeek == DayOfWeek.FRIDAY) {freitagList.add(probe);} else if (dayOfWeek == DayOfWeek.SATURDAY) {samstagList.add(probe);} else if (dayOfWeek == DayOfWeek.SUNDAY) {sonntagList.add(probe);}}// Wochentag-Listen in richtiger Reihenfolge dem Board hinzufügenboard.put("Montag", montagList);board.put("Dienstag", dienstagList);board.put("Mittwoch", mittwochList);board.put("Donnerstag", donnerstagList);board.put("Freitag", freitagList);board.put("Samstag", samstagList);board.put("Sonntag", sonntagList); -
-
Widget-Konfiguration
-
Titel Probennahmen diese Woche
-
Datenquelle Groovy-Skript
-
Ansicht BoardBeta
-
Skript
import com.dialog.dialims.business.db.CriteriaHelper;date = DateUtil.getServerDate();pc = ProbeController.getInstance();c = CriteriaHelper.kwEq("plandatum", date);pc.findByCriteria(c); -
Datentyp Probe
-
Gruppierung über Makro (zuvor eingerichtetes Makro zuordnen)
-
Sortierung Priorität (aufsteigend)
-
Darstellung
-
Einfärbung wie Priorität
-
Titel Probe
-
Untertitel Beschreibung
-
Details Probennehmer, Plandatum
-
-