Konfiguration der Monitor-Spalten

Durch die Angabe von false wird kein Renderer verwendet. Bei true wird in der Konfiguration der Monitor-Komponente (Monitor_CustomRenderer) zuerst nach einem Renderer mit passendem Namen gesucht. Das Matching erfolgt über Renderername = Dataindex der Spalte (Bsp.: PROCESSID = PROCESSID). Der Zweck ist, für verschiedene Werte in derselben Spalte verschiedene Renderer darzustellen. Sollte kein Renderer mit passendem Namen gefunden werden, wird auf den defaultRenderer zugegriffen.

Wenn man den Namen des Renderers als String angibt, wird in column_customerRenderer nach einem Renderer mit dem angegebenen Namen gesucht. .Beispiel "customRenderer": "TEST-RENDERER" erwartet einen Eintrag "TEST-RENDERER" in column_customRenderer.

Für die Nutzung eigener Renderer-Funktionen muss die Syntax MODUL!_!FUNKTION bei der Konfiguration genutzt werden. Diese Angabe wird in die Form MODUL.Module.FUNKTION() überführt. Diese Funktion wird ausgewertet und es wird die Renderer-Funktion als Rückgabewert erwartet. Um eine eigene Funktion zu nutzen, muss diese beim Aufruf des Monitors bereit geladen sein. Dies kann z.B. durch das Einbinden eines eigenen BPC-Moduls oder der Konfiguration "view_additionalFiles" (siehe Core Services Einstellungen) geschehen.

Wenn kein Renderer definiert ist, wird geprüft, ob die jeweilige Spalte den dataIndex STATUS besitzt. Falls ja, wird der defaultRenderer aus dem Objekt verwendet. Weitere Spaltenkonfigurationsparameter können direkt aus der ExtJS-Dokumentation abgeleitet werden.

Wird in der Spaltenkonfiguration das Attribut formatter auf "translate" gesetzt, werden die Werte dieser Spalte übersetzt, sofern eine entsprechende Übersetzung vorhanden ist.

Wird in der Spaltenkonfiguration das Attribut formatter beispielsweise auf "date(Y-m-d)" gesetzt, werden die Werte dieser Spalte im Monitor als Datum im angegebenen Format dargestellt.

Wird in der Spaltenkonfiguration das Attribut formatter beispielsweise auf "round(2)" gesetzt, so werden die Werte dieser Spalte auf zwei Nachkommastellen gerundet.

Wird in der Spaltenkonfiguration das Attribut formatter beispielsweise auf "lowercase" gesetzt, so werden die Werte dieser Spalte in Kleinbuchstaben dargestellt. Analog funktioniert diese Konfiguration auch mit uppercase.

Für weitergehende Informationen zu Formatierungen in Monitorspalten, siehe die ExtJS Dokumentation.

Die templatecolumn bietet die Möglichkeit, den Wert der Spalte im Frontend zu modifizieren. Man kann ihn beispielsweise kürzen, umwandeln oder um Werte aus anderen Spalten anreichern. Hiermit kann bspw. eine Hyperlink-Spalte erzeugt werden. Um eine Spalte mit Hyperlink zu erzeugen, kann in der ColumnConfig der Spalte der xtype templatecolumn und das Template tpl definiert werden. Über Platzhalter mit geschweiften Klammern kann auf sämtliche Daten (Spalten) des aktuellen Datensatzes (der aktuellen Zeile) über deren dataIndex zugegriffen werden. Sollen noch Funktionen auf den Wert angewendet werden, müssen innerhalb der geschweiften Klammern zusätzlich eckige Klammern eingefügt werden. In diesem Fall muss den dataIndizes noch values. vorangestellt werden.

In diesem Beispiel wird eine Spalte mit dem dataIndex "JIRA" erzeugt, die im OpenSearch einen Jira-Link enthält. Im BPC wird die Spalte mit einem Hyperlink gefüllt, der in einem neuen Fenster (target="_blank") öffnet. Dessen href ist der Wert der Spalte selbst: {JIRA}. Der Text des Links wird mit der JavaScript-Funktion values.JIRA.substr(values.JIRA.lastIndexOf('/') + 1) auf den Substring nach dem letzten Slash gekürzt. Dies wird im Template via {[values.JIRA.substr(values.JIRA.lastIndexOf('/') + 1)]} erreicht.

Bei diesem Spaltentyp wird versucht, den Wert der Spalte als Datum zu interpretieren und formatiert darzustellen. Das Datumsformat kann über das Attribut format gesteuert werden. Die Syntax für das Format ist in der ExtJS Dokumentation zu finden. Wird an der Spalte kein Format angegeben, so wird das Datumsformat der Monitorinstanz verwendet.

Sind in einem Monitor Aktions-Spalten konfiguriert, die durch die Toolbar oder das Kontextmenü ausgeführt werden können, so ist es möglich, durch das Hinzufügen dieser Spalte pro Zeile einen Aktions-Button zu erzeugen. Mehrere Aktions-Spalten und auch mehrere Einträge von Aktionen in einer Spalte werden in einem Dropdown zusammengefasst. Die Anzahl der Aktionen wird auf dem Button angezeigt. Ist nur eine Aktion vorhanden, kann die Aktion direkt durch Klick auf den Button gestartet werden. Die Spalte kann den zusätzlichen Parameter showIconOnly entgegennehmen, der true oder false als Wert akzeptiert. Damit kann gesteuert werden, ob der Button pro Spalte den vollen Text anzeigt oder nur das Icon und die Anzahl an verfügbaren Aktionen. Der Standardwert ist false.

Dieser Spaltentyp kann verwendet werden, um direkt einen Download-Button für Spalten anzubieten, die eine Datei enthalten.
Es werden folgende Monitoreinstellungen verwendet.

Es ist möglich, eine Spalte für Wahrheitswerte zu definieren, die eine Checkbox anstelle des Wertes darstellt. Die Werte für "wahr" sind:

Um einen entsprechenden Filter für die Spalte zu nutzen, muss type innerhalb von filter auf 'check' gesetzt werden.

Um aus dem Monitor heraus zu einem anderen Modul (z.B. einem weiteren Monitor) springen zu können, muss in der column_config eine zusätzliche Spalte mit dem xtype bpcModuleJumpColumn eingefügt werden. In dieser wird die ID des Zielmoduls unter targetModule eingetragen. Die Spalte wird dann mit einem Icon in jeder Zeile des Monitors angezeigt. Durch Klicken auf das Icon wird der Sprung ausgeführt.

Außerdem besteht die Möglichkeit, den Sprung zum Zielmodul über das Kontextmenü auszulösen. Im Kontextmenü kann das Öffnen des Zielmoduls in drei verschiedenen Modi ausgeführt werden:

Werden sourceColumn und targetColumn angegeben, wird beim Sprung der aktuelle Wert aus der sourceColumn als Filter im Zielmonitor an der Spalte targetColumn gesetzt.

Wurde ein CustomRenderer für eine Spalte definiert, wird dieser auch bei der Vorschlagsliste am Filterfeld angewendet.

Dabei wird erst der gerenderte Wert angezeigt, anschließend der Ursprungswert in Klammern und am Ende, falls bekannt, die Anzahl der Datensätze mit diesem Wert. Soll der Ursprungswert nicht angezeigt werden, kann dieser mit der Angabe "hideRawValue": true in der Filterkonfiguration ausgeblendet werden.

Bei diesem Filter ist die Eingabe von beliebigem Text zum Filtern möglich.

Der dynamicList-Filter erlaubt es dem Benutzer, Filterwerte aus einer automatisch generierten Liste zu setzen. Die Liste wird aus allen im Monitor verfügbaren Werten dieser Spalte zusammengesetzt. Für den Fall, dass diese Ergebnisliste nicht vollständig ist, wird eine Warnung mit der Anzahl der nicht angezeigten Werte angezeigt. Falls alle Werte angezeigt werden sollen, kann der Filter entweder auf remote gesetzt oder der maxQuerySize-Parameter erhöht werden.

Dieser Filter bietet eine Auswahlkomponente für absolute und relative Zeiträume. Die Schnellauswahl der gleitenden Zeiträume kann über den Konfigurationsparameter dateRange_favorites konfiguriert werden. Über die fieldConfig an den Spalten kann die Komponente bei Bedarf angepasst werden.

Dieser Filter ermöglicht das Filtern mit numerischen Werten. Der Standard-Operator kann in der ColumnConfig definiert werden. Wenn keiner definiert ist, ist = der Standard-Operator. Über das Spalten-Menü kann zusätzlich der Operator (>, <, =, ⇐, >=) festgelegt werden.

Ermöglicht das Filtern in strukturierten Daten. Er ermöglicht es, mehrere Filterkriterien für eine einzige Spalte zu kombinieren.