Process Monitor-Grid anpassen

Die folgenden Abschnitte erläutern, wie Sie Process Monitor-Grids für die Auswertung konfigurieren und ja nach Bedarf an Ihre Anforderungen anpassen.

Process Monitor-Grids werden in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration konfiguriert.

So gehen Sie vor

  1. Öffnen Sie den Technical Workflow BPC_299_PM_Configuration in der Diagrammgruppe BPC__configuration zum Editieren.

  2. Öffnen Sie das Variablenmapping des Moduls BPC_Assign_hook.

  3. Wählen Sie die Quellvariable XSLT.

  4. Klicken Sie im Bereich Quelle den Button Bearbeiten neben Stylesheet, um den XSLT-Editor zu öffnen.

  5. Passen Sie das/die in den folgenden Abschnitten beschriebenen Element(e) an.

  6. Speichern Sie die Änderungen und publizieren Sie den Workflow BPC_299_PM_Configuration.

Anzahl und Anzeige der Grids anpassen

Im Auslieferungszustand erzeugen die mitgelieferten Workflows standardmäßig fünf Process Monitor-Grids, die auf ein Single Grid und jeweils 2 Grid Groups verteilt sind:

process monitor grid group

Mehrere Grids können zu einer Grid-Gruppe zusammengefasst werden. Eine Grid Group kann aus mehreren (Single) Grids bestehen, und Sie können für jede Grid Group wählen, ob die Grids untereinander oder auf Tabs angezeigt werden sollen:

  • Single grid

    Enthält ein einzelnes Process Monitor-Grid plus dazugehöriges Dashboard.

  • Grid group 1

    Enthält standardmäßig zwei Process Monitor-Grids (Single Grids), die jeweils auf einem eigenen Tab (Sub Tab 1 und Sub Tab 2) angezeigt werden. Für die gesamte Grid Group wird standardmäßig sowohl ein Gruppen-Dashboard als auch für jedes Grid pro Tab ein eigenes Dashboard angezeigt.

  • No tabbed Group

    Enthält standardmäßig ebenfalls zwei Process Monitor-Grids, die jedoch nicht nebeneinander in Tabs, sondern untereinander angezeigt werden.

Sie können Anzahl und Anzeige der Grids individuell anpassen: Sie können sowohl mehrere einzelne Grids als auch mehrere Gruppen von Grids anzeigen.

Prinzipiell wird jedes Process Monitor-Grid über ein Grid-Element und jede Grid-Gruppe über ein Group-Element in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration dargestellt. Die Gruppierung der Grids wird durch Verschachtelung der Grid-Elemente im Group-Element dargestellt:

process monitor guide 1382 0

Einzelne Single Grids anzeigen

Einzelne Grids werden jeweils über ein Grid-Element in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration konfiguriert.

process monitor guide 1383 0

Voraussetzungen

Das Datenbankschema ist vorhanden, aber es sind noch keine Tabellen erzeugt.

Siehe Logging-Datenbank zentral verwalten

So gehen Sie vor

  1. Wenn Sie mehrere einzelne Grids anzeigen möchten, fügen Sie in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration mehrere Grid-Elemente analog zum obigen Ausschnitt aus der XML-Konfiguration ein:

    1. Öffnen Sie den Workflow BPC_299_PM_Configuration zum Bearbeiten.

    2. Öffnen Sie das Variablenmapping des Moduls BPC_Assign_hook.

    3. Wählen Sie die Quellvariable XSLT.

    4. Klicken Sie im Bereich Quelle den Button Bearbeiten neben der Bezeichnung Stylesheet, um den XSLT-Editor zu öffnen.

    5. Setzen Sie unter LoadInformation/ProcessMonitor/DefaultGridOptions den Wert des Elements tabbing auf false.

  2. Publizieren Sie das Modul.

  3. Legen Sie eine neue Datenbanktabelle an:

    Siehe Datenbanktabellen erstellen

  4. Melden Sie sich am Portal an, um die Änderung anzuzeigen.

Single Grids zu Grid Groups zusammenfassen

Sie können mehrere Grids zu Grid Groups zusammenfassen bzw. gruppieren und für jede Grid Group wählen, ob die Grids nebeneinander auf Tabs oder untereinander angezeigt werden sollen.

Voraussetzungen

Das Datenbankschema ist vorhanden, aber es sind noch keine Tabellen erzeugt.

Siehe Logging-Datenbank zentral verwalten

So gehen Sie vor

  1. Fügen Sie in der XSLT-Variablen des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration ein Group-Element ein.

  2. Kopieren Sie ein bzw. mehrere Grid-Elemente mit allen Unterelementen und fügen Sie diese in das Group-Element ein. Alternativ können Sie auch neue Grid-Elemente im Group-Element anlegen. Die XML-Struktur für eine Grid Group sieht z.B. so aus:

    process monitor guide 1384 1

  3. Stellen Sie sicher, dass das Attribut gridGroupId aller Unterelemente in einer Gruppe (Grid oder Group) dem Wert des id-Attributs des Group-Elements entspricht, nach folgendem Muster:

    Group(id=abc)
+ Grid(gridGroupId=abc)
+ Grid(gridGroupId=abc)
+ Group(id=xyz; gridGroupId=abc)
+ Grid(gridGroupId=xyz)
+ Grid(gridGroupId=xyz)

    Alle id-Attribute von Grid- und Group-Elementen im gesamten Init_Load müssen eindeutig sein. Die Attribute gridGroupId müssen dagegen mehrfach vorhanden sein.

  4. Definieren Sie, ob die Grids in der Grid Group auf Registern (Tabs) oder untereinander angezeigt werden sollen:

    • Gruppe mit Tabbing

      Prüfen Sie, ob unter LoadInformation/ProcessMonitor/DefaultGridOptions der Wert des Elements tabbing wie im Auslieferungszustand definiert auf true gesetzt ist.

    • Gruppe ohne Tabbing

      Fügen Sie unter LoadInformation/ProcessMonitor/Group/Options ein Element tabbing ein und setzen Sie dessen Wert auf false.

  5. Definieren Sie ggf. für die Grid Group einen Titel im Attribut title des Group-Elements und - falls Tabs angelegt wurden - jeweils Tab-Titel im Attribut title des Grid-Elements.

    Sie können auch Grid Groups noch weiter gruppieren, indem Sie diese nach dem Muster der Gruppierung von Grids in der XML-Konfiguration verschachteln.

  6. Publizieren Sie das Modul.

  7. Legen Sie eine neue Datenbanktabelle an:

    Siehe Datenbanktabellen erstellen

  8. Melden Sie sich am Portal an, um die Änderung anzuzeigen.

Höhe des Process Monitor-Grids anpassen

Sie können festlegen, welche Höhe das Process Monitor-Grid haben soll, indem Sie den heightOffset als Mindestabstand in Pixel zwischen dem Grid und einem Element am unteren Rand des Browserfensters definieren. Im Auslieferungszustand hat der heightOffset den Wert 200.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Geben Sie unter LoadInformation/ProcessMonitor/Options als Wert des heightOffset-Elements den minimalen Abstand zum unteren Rand des Browserfensters ein.

  3. Publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Höhe des Child-Grids anpassen

Sie können festlegen, welche Höhe in Pixel das Child-Grid haben soll, indem Sie das Element heightChildGrid definieren. Im Auslieferungszustand hat heightChildGrid den Wert 150.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Geben Sie unter LoadInformation/ProcessMonitor/Grid/Options als Wert des heightChildGrid-Elements die gewünschte Größe des Child-Grids ein.

    Diese Einstellung können Sie auch für ein Grid innerhalb einer Group vornehmen. Navigieren Sie hierzu zum heightChildGrid-Element in den Options des betreffenden Grids in der Group: LoadInformation/ProcessMonitor/Group/Grid/Options/heightChildGrid.

  3. Publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Initiale Sortierung der Logeinträge anpassen

Sie können festlegen, wie die Logeinträge initial sortiert werden sollen. Im Auslieferungszustand werden die Einträge nach ihrem Zeitstempel sortiert (LoadInformation/ProcessMonitor/DefaultGridOptions/initialSortField:timestamp).

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Geben Sie unter LoadInformation/ProcessMonitor/DefaultGridOptions als Wert des initialSortField-Elements den Namen eines beliebigen XML-Elements, das eine Tabellenspalte erzeugt, ein, z.B. initialSortField:status. Es werden dann die Parent-Logeinträge nach dieser Spalte im Grid sortiert.

  3. Um die Richtung der Sortierung zu definieren, geben Sie als Wert des initialSortDirection-Elements entweder desc (absteigend sortieren) oder asc (aufsteigend sortieren) ein.

    Wenn Sie die initiale Sortierung der Child-Logeinträge ändern wollen, fügen Sie die Properties initialChildSortField bzw. initialChildSortDirection mit den gewünschten Werten analog zu den Schritten 2 und 3. hinzu.

  4. Publizieren Sie den Workflow.

  5. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Sortierung von Spalten steuern

Sie können festlegen, ob die Logeinträge im Process Monitor-Grid oder in den Child-Grids durch den Anwender nach Spalten sortierbar werden können oder nicht. Verwenden Sie dazu für die betreffenden Spalten das Attribut sortable, dem Sie den Wert true (sortierbar) oder false (nicht sortierbar) zuweisen.

Im Auslieferungszustand sind einige Spalten sortierbar (z.B. Status), andere nicht (z.B. remoteFilterTest). Wird das Attribut nicht verwendet, ist die Spalte sortierbar.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Suchen Sie die Spaltendefinitionen des betreffenden Grids auf, dessen Spalten Sie konfigurieren wollen:

    LoadInformation/ProcessMonitor/Grid/Data bzw. LoadInformation/ProcessMonitor/Group/Grid/Data.

  3. Um die Sortierung einer Spalte zu steuern, definieren Sie für das zugehörige Element das Attribut sortable und setzen dessen Wert auf true (sortierbar) oder auf false (nicht sortierbar), z.B. LoadInformation/ProcessMonitor/Grid/Data/IconTest/sortable = false:

    process monitor guide 1387 1

    Soll die Spalte sortierbar sein, können Sie auf die Definition des Attributs verzichten.

  4. Publizieren Sie den Workflow.

  5. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Spaltenreihenfolge im Process Monitor-Grid festlegen

Die Reihenfolge der Spalten in einem Process Monitor-Grid wird festgelegt durch die Reihenfolge der entsprechenden XML-Elemente in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration unterhalb des entsprechenden Grid-Elements im Data-Element:

  • Reihenfolge der XML-Elemente im Stylesheet:

    process monitor guide 1388 0

Benutzer können die Spaltenreihenfolge in der Detailansicht per Drag-and-Drop ändern.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Passen Sie die Reihenfolge der Elemente unterhalb des Grid-Elements im Data-Element an.

  3. Publizieren Sie den Workflow.

  4. Melden Sie sich am Portal ab und wieder an, um die Änderungen anzuzeigen.

Spalten im Process Monitor-Grid ein-/ausblenden

Grundsätzlich gilt für die Sichtbarkeit der Datenbanktabellen in Form von Grid-Spalten: Standardmäßig sind alle durch XML-Elemente konfigurierten Datenbanktabellen als Spalten im Process Monitor-Grid verfügbar.

Im Grid können Sie die Spalten dann ggf. per Checkbox-Aktivierung aus- bzw. einblenden:

Siehe Funktionen im Grid

Sie können über die XML-Konfiguration Spalten in einem Process Monitor-Grid gezielt aus- oder einblenden (Attribut hidden) und in der Auswahlliste der Spalten im Grid verfügbar oder nicht verfügbar machen (Attribut hideable).

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Fügen Sie der Spalte, die im Grid ausgeblendet werden soll, das Attribut hidden=true hinzu, z.B.:

    process monitor guide 1388 1

    Die entsprechende Spalte wird nicht im Process Monitor-Grid angezeigt. Sie ist jedoch über die Spalten-Auswahlliste im Kontextmenü der Grid-Spalten jederzeit zuschaltbar.

  3. Um die Anzeige der Spalte in der Spalten-Auswahlliste im Grid zu deaktivieren, fügen Sie zum entsprechenden XML-Element das Attribut hideable=false hinzu, z.B.:

    process monitor guide 1389 1

    Wenn Sie das Attribut hidden=false in Kombination mit dem Attribut hideable=false setzen, erzeugen Sie eine sichtbare Spalte, die auch über die Spalten-Auswahlliste nicht ausgeblendet werden kann.

  4. Publizieren Sie den Workflow.

  5. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Namen der Spalten im Process Monitor-Grid ändern

Der Name von Spalten wird im title-Attribut definiert. Standardmäßig definiert sich der Wert über einen Key und dessen Key-Value aus der Properties-Datei der gewünschten Sprache; dazu ist der Wert des useRessourceBundleHeader- Attributs true. Wenn Sie den Spaltentitel ändern möchten, können Sie das entweder über das Ändern des Key-Value in der passenden Properties-Datei tun oder direkt über die Eingabe des gewünschten Titels als Wert des title-Elements.

Wenn Sie als Wert des title-Attributes einen Spaltentitel eingeben, zu dem es keinen Key(-Value) in der Properties-Datei gibt und gleichzeitig useRessourceBundleHeader=true gesetzt ist, wird im Portal ein ErrorString (Wert des title-Elements ergänzt um "*.undefined" z.B. “ProzessID.undefined”) angezeigt. Um einen beliebigen Spaltentitel für das title-Attribut einzugeben, müssen Sie den Wert des useRessourceBundleHeader-Attributs auf false setzen.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Wählen Sie das XML-Element, das die Spalte erzeugt, deren Titel Sie ändern möchten, z.B.:

    process monitor guide 1389 2

  3. Wählen Sie einen der gewünschten Wege zum Ändern des Spaltentitels:

    • Spaltentitel über Properties-Datei ändern

      1. Merken Sie sich den Key, der den Wert des title-Elements der gewünschten Spalte definiert.

      2. Zeigen Sie das Register Repository an.

      3. Zeigen Sie das Verzeichnis ProcessMonitor > ressourceBundle an.

      4. Öffnen Sie die Datei der gewünschten Sprache, z.B. Application_de_DE.properties zum Bearbeiten.

      5. Suchen Sie den Key, der den Wert des title-Elements der gewünschten Spalte definiert.

      6. Ändern Sie den Key-Value.

      7. Speichern Sie Ihre Änderungen.

      8. Schließen Sie die Properties-Datei.

    • Spaltentitel über Wert des title-Elements ändern

      1. Setzen Sie den Wert des Elements useRessourceBundleHeader auf false. Jetzt wird der Spaltentitel nicht mehr automatisch aus der Properties-Datei gezogen.

      2. Zeigen Sie das Register Repository an.

      3. Definieren Sie für das title-Element einen beliebigen Wert, der als Titel der Spalte angezeigt werden soll.

      4. Speichern Sie Ihre Änderungen und publizieren Sie den Workflow.

      5. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

        Um die Mehrsprachigkeit zu nutzen, muss für jede Spalte das Element useRessourceBundleHeader mit dem Wert true existieren. Erst dann wird die Änderung in die entsprechende Sprache übernommen, und im Process Monitor wird der sprachbezogene Wert als Wert des Labels angezeigt. Ansonsten wird nur der Wert von title übernommen und nicht übersetzt.

Siehe Mehrsprachigkeit im Process Monitor nutzen

Statusbezeichner und Darstellung der Status im Grid ändern

Im Process Monitor-Grid und in den Dashboards werden die unterschiedlichen Status von Prozessen bzw. Logeinträgen mit verschiedenen Farben, Bezeichnern und Icons dargestellt.

Statusanzeige im Grid

Die Status der Logeinträge werden in Process Monitor-Grids als farbige Icons dargestellt:

process monitor guide 1390 1

Statusanzeige im Dashboard

Im Dashboard werden die verschiedenen Status farbig kodiert:

process monitor guide 1391 0

Default-Status-Anzeige

Der Auslieferungszustand bietet für überwachte Prozesse folgende Status:

  • status error Error

  • status warning Warning

  • status ok OK

  • status processing Processing (Prozess wird ausgeführt)

Default-Status-Konfiguration

Die entsprechende Konfiguration unter LoadInformation/ProcessMonitor/DefaultDashboardOptions/StatusColor sieht folgendermaßen aus:

tasklist xml example

Sie können die Zuordnung von Status zu Farben anpassen, die Bezeichner der Status ändern und die Icons austauschen. Wenn gewünscht, können Logeinträge auch ohne Icon angezeigt werden.

Sie müssen die Bezeichner der Statuswerte immer dann anpassen, wenn Ihre Logeinträge andere Statuswerte als die vordefinierten enthalten, z.B. Fehler statt Error.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Die Statusbezeichner, die Statusfarben für Dashboard und Icons sowie die Grafiken definieren Sie in den Elementen im StatusColor-Element unter LoadInformation/ProcessMonitor/DefaultDashboardOptions/StatusColor:

    tasklist xml example

    Aus dem jeweiligen Elementnamen wird die zu ladende Grafik entnommen, z.B. wird für das Element bzw. den Status Blue die Datei Blue.gif geladen.

    • Icons

      Alle vordefinierten und auswählbaren Status-Icons finden Sie im Repository im Verzeichnis Process Monitor > Icons > status. Eigene Grafiken müssen Sie als *.gif-Dateien speichern, die Dateinamen müssen dem Muster [farbe].gif entsprechen.

      Icons werden auf Basis des Elementnamens zu Statuswerten zugeordnet.

      Um ein Icon zu ändern, definieren Sie daher den Namen eines Elements so, dass Elementname und Dateinamen des Icons identisch sind.

      Beispiel: Die Datei mit dem Icon ist unter dem Namen down.gif im Repository gespeichert. Die Angaben in der XSLT-Variablen lauten:

      process monitor guide 1392 2

    • Statusbezeichner

      Der Wert des Elements definiert den Namen des Status. Um den Namen eines Status zu ändern, ändern Sie den Wert des entsprechenden Elements.

      Beispiel: Das Element Red, welches den Status mit dem Namen Error definiert, lautet in der XSLT-Variablen:

      process monitor guide 1393 1

    • Statusfarbe im Dashboard

      Das Attribut dashboardColor gibt die Farbe als Hex-Wert für die Darstellung im Dashboard an.

      Ändern Sie den Wert des entsprechenden dashboardColor-Attributs.

      Alle Status-Änderungen müssen Sie einmal global unter LoadInformation/ProcessMonitor/DefaultDashboardOptions/StatusColor vornehmen und dann noch einmal für die einzelnen Grids nachziehen unter LoadInformation/ProcessMonitor/[…]/Grid/Data/Status, damit alle Status sowohl global als auch für die einzelnen Grids verfügbar sind.

  3. Speichern Sie die Änderungen und publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Referenzdateien zu Logeinträgen anzeigen

Zu jedem Logeintrag kann eine Referenzdatei, z.B. eine Nachricht, gespeichert werden. Im Process Monitor-Grid signalisiert das Download-Icon, dass eine Nachricht angezeigt werden kann:

process monitor grid download

Sie können die Nachricht mit einem Klick auf das Download-Icon anzeigen und speichern.

So gehen Sie vor

  1. Aktivieren Sie den Technical Workflow BPC_PM_Show_Reference.

  2. Damit die Nachrichten gespeichert und angezeigt werden, müssen Sie das Logging in Ihren fachlichen Workflows entsprechend konfigurieren. Sie können die Nachrichten entweder in der Datenbank oder im Dateisystem der INUBIT Process Engine speichern:

    Siehe

Nachrichten in Datenbank speichern

Standardmäßig werden die Nachrichten in der Datenbank gespeichert.

Um Nachrichten in die Datenbank zu schreiben, müssen Sie die folgenden XML-Elemente mit Werten belegen:

XML-Element Erläuterung

Reffile

Spalte, in der die Nachricht gespeichert wird. Die Referenzdaten werden in der BLOB-Spalte (Reffile-Element) der Datenbank gespeichert

Reference

Spalte, in welcher der Dateinamen gespeichert wird. Sie definiert den Dateinamen, der dann aus dem Grid geladen wird. Pflichtspalte!

MimeType

Dateityp speichern, z.B. plain/text. MimeType definiert die Dateierweiterung, welche aus dem Grid geladen wird.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Erweitern Sie den XML-Ziel-Elementbaum bis zu LoadInformation/ProcessMonitor/[Group/]Grid/Data.

  3. Falls eines der Elemente Reffile, Reference or MimeType nicht existiert:

    1. Erzeugen Sie das Element.

    2. Löschen Sie die Log-Tabelle.

      Siehe Datenbanktabellen löschen

    3. Legen Sie eine neue Log-Tabelle an.

      Siehe Datenbanktabellen erstellen

  4. Belegen Sie die Werte dieser Elemente gemäß obiger Tabelle.

  5. Publizieren Sie den Workflow.

Mit dieser Standard-Konfiguration werden die Daten bzw. die Nachricht folgendermaßen übergeben: Es wird zuerst geprüft, ob in der logEntry-Struktur ein Wert für das Reffile-Element gesetzt ist, der in die Datenbank geschrieben werden kann. Falls der Wert des Reffile-Elements leer ist, wird die Variable logRefFile ausgelesen, an den INUBIT Process Monitor in Form des Workflow Connectors PM_doFunctionalLogging (im Workflow PM_LogDB_Administration) übergeben und in die Datenbank geschrieben. Die Nachricht wird nach Klick auf das entsprechende Icon im Grid angezeigt.

Die Daten des Reffile-Elements und der logRefFile-Variable müssen base64-kodiert sein.

Referenzdaten komprimieren

Sie können den Inhalt der logRefFile-Variable komprimiert (gezippt) in der Datenbank abspeichern, um dadurch das Datenaufkommen des Process Monitors in der Datenbank zu verringern. Dazu müssen Sie den Wert der zipReference- Variablen auf true setzen.

So gehen Sie vor

  1. Navigieren Sie im Diagrammbaum zum Technical Workflow BPC_PM_LogDB_Administration.

  2. Öffnen Sie das Variablen-Mapping am Workflow Connector BPC_PM_doFunctionalLogging.

  3. Setzen Sie den Wert der zipReference-Variablen im Bereich Quelle auf true.

Damit erreichen Sie, dass die durch die Variable logRefFile übergebenen Referenzdaten vor der Speicherung in der Datenbank gezippt werden.

Nachrichten in neuem Fenster öffnen

Sie können Nachrichten in einem Fenster anzeigen lassen.

Um Nachrichten in einem neuen Fenster anzeigen zu lassen, müssen Sie das folgende XML-Element mit einem Wert belegen:

XML-Element Erläuterung

Reference

Spalte, in der Sie das Attribut blank=true erzeugen müssen. Sie definiert die Information, dass die Nachricht in einem neuen Fenster angezeigt werden soll, die dann aus dem Grid geladen wird. Pflichtspalte!

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Erweitern Sie den XML-Ziel-Elementbaum bis zu LoadInformation/ProcessMonitor/[Group/]Grid/Data.

  3. Falls das Element Reference nicht existiert:

    1. Erzeugen Sie das Element.

    2. Löschen Sie die Log-Tabelle.

      Siehe Datenbanktabellen löschen

    3. Legen Sie eine neue Log-Tabelle an.

      Siehe Datenbanktabellen erstellen

  4. Erzeugen Sie für das Element Reference das Attribut blank mit dem Wert true (siehe obige Tabelle).

  5. Publizieren Sie den Workflow.

Bei einem Klick auf Download-Icon öffnet sich ein neues Fenster.

Beliebige Aktionen zu Logeinträgen anbieten

Sie können im INUBIT Process Monitor für jeden Parent- und Child-Logeintrag beliebige Aktionen anbieten, z.B. Details zu einem Logeintrag einblenden oder einen Prozess erneut starten, wenn dieser den Status Error hat.

Sie können für diese Aktionen folgende Technik nutzen:

Asynchroner Ajax-Request

Die Aktion wird im Process Monitor-Grid mithilfe von Buttons in einer zusätzlichen Spalte ausgelöst. Der Klick auf einen Button sendet einen Ajax-Request an einen HTTP Connector und startet damit den dahinterliegenden Workflow. Der Aufruf ist asynchron, die durch den Aktionsbutton aufgerufene Aktion unterbricht also nicht die Anwendung. Der Process Monitor läuft weiter, während der Server die geladenen Daten verarbeitet und anschließend per Callback eine Antwort an den Browser sendet. Den Workflow können Sie selbst beliebig definieren.

Siehe Aktionen konfigurieren

Aktionen konfigurieren

Sie können pro Parent-Logeintrag eine einzelne oder mehrere Aktionen gleichzeitig anbieten.

Einzelne Aktion anbieten

Eine einzelne Aktion konfigurieren Sie mit einem Element action_ und dem dazugehörigen type-Attribut mit dem Wert action.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Erzeugen Sie unterhalb des Data-Elements in einem Grid-Element ein neues Element für einen Aktions-Button und benennen Sie es, hier z.B. action_test.

  3. Aktion für Parent-Logeintrag anlegen:

    Fügen Sie dem Element ein type-Attribut mit dem Wert action hinzu, hier z.B.:

    process monitor guide 1396 1

    Die Werte aus allen Feldern des Parent-Datensatzes werden mit dem jeweiligen Spaltennamen im Workflow übergeben, z.B. action_test, action_test2, Status, ProcessID.

  4. Um die gewünschten Aktionen für den Action-Button zu konfigurieren, öffnen Sie den Workflow BPC_PM_LogMonitor_Action_AJAX zum Bearbeiten.

  5. Ersetzen Sie das Empty-Modul durch Module, welche die gewünschte Aktion ausführen. Sie können hier die gewünschten Reaktionen auf eine einzelne Aktion oder Mehrfach-Aktionen konfigurieren (zwei Zweige).

  6. Publizieren und aktivieren Sie den Workflow BPC_PM_LogMonitor_Action_AJAX.

Mehrere Aktionen gleichzeitig anbieten

Wenn Sie mehrere Aktionen für einen Logeintrag gleichzeitig anbieten möchten, benötigen Sie für jede Aktion einen eigenen Button.

Aktionen werden in der Spalte Aktionen, im Kontextmenü und im Detailfenster, das sich mit einem Doppelklick auf einen Eintrag öffnet, angezeigt.

process monitor grid

Damit neu erstellte Spalten im Process Monitor angezeigt werden, müssen Sie die Datenbanktabellen löschen und neu erstellen und sich am BPC Portal ab- und wieder anmelden.

Alle Aktionen werden durch Sub-Workflows des Workflows PM_LogMonitor_Action_AJAX realisiert. Um den jeweils passenden Sub-Workflow anzusprechen, muss der Inhalt des Elements action_ ausgewertet werden. Dieses Element signalisiert, welcher Button angeklickt wurde. Das Element hat als Wert immer den Namen der Datenbankspalte, in dem das angeklickte Button-Label gespeichert wurde.

Sie können konfigurieren, wie mehrere Aktions-Buttons angezeigt werden; siehe Mehrere Aktions-Buttons zusammenfassen – MultiAction-Button

Mehrere Aktions-Buttons zusammenfassen – MultiAction-Button

Mehrere Aktionen in der Spalte Aktionen, im Kontextmenü und im Detailfenster angezeigt, siehe Detailfenster

process monitor grid

Zum Anlegen von Aktionen, siehe Aktionen konfigurieren

MultiAction-Button pro Logeintrag anzeigen

Um über eine komfortablere Darstellung von mehreren Aktions-Buttons pro Logeintrag zu verfügen, können Sie alle einzelnen Aktions-Buttons eines Logeintrags zusammengefasst auf einem sog. MultiAction-Button oder Mehrfach-Aktions-Button mit Drop-Down-Funktion anzeigen lassen. Sie können so pro Logeintrag mehrere verschiedene Aktionen zusammengefasst anbieten, z.B.:

process monitor guide 1397 1

Dazu müssen Sie in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration in der Konfiguration des Grids im actions-Element Anpassungen für den MultiAction-Button vornehmen.

MultiAction-Button in der Toolbar anzeigen

Wenn Sie für verschiedene Logeinträge bzw. Prozesse gleichzeitig eine Aktion anbieten bzw. auswählen wollen, können Sie einen eigenen Button Aktionen oben in der Toolbar des Grids anzeigen lassen:

process monitor guide 1397 2

Sie haben so z.B. die Möglichkeit, mehrere Prozesse zu markieren (MultiSelect) und diese gleichzeitig über einen entsprechenden Aktions-Button abzubrechen.

Voraussetzungen

In der logEntry-Struktur wird für alle Aktionen (action_*) der gleiche Wert verwendet.

Status von Parent-Logeinträgen manuell ändern

Sie können den im Grid angezeigten Status eines Parent-Eintrags manuell ändern, um damit z.B. im Rahmen einer Fehleranalyse den Status von Fehler auf Warning zu setzen:

process monitor guide 1398 1

Bei einer manuellen Statusänderung wird automatisch ein neuer Child-Eintrag erzeugt. Diesem kann ein Kommentar hinzugefügt werden und er protokolliert automatisch, welcher Nutzer wann den Status geändert hat.

Es ist auch möglich, gleichzeitig mehrere Prozesse zu markieren und deren Status parallel zu verändern (MultiSelect).

Manuelle Statusänderungen in der XSLT-Variable des Moduls BPC_Assign_hook konfigurieren

Um den Status von Logeinträgen manuell ändern zu können, müssen Sie diese Funktion in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration konfigurieren.

So gehen Sie vor

  1. Um in der Grid-Toolbar den Button Status ändern anzuzeigen, setzen Sie unter LoadInformation/ProcessMonitor/Grid/Options/statusEditor den Wert des Elements statusEditable auf true.

  2. Bei einer Statusänderung wird automatisch ein neuer Child-Eintrag erzeugt und den dafür angezeigte Status können Sie definieren:

    Fügen Sie dafür unter LoadInformation/ProcessMonitor/Grid/Options/statusEditor als Wert des Elements childLogStatus einen beliebigen Wert ein, z.B. Info:

    process monitor guide 1398 2

  3. Beschränken Sie ggf. die für eine Statusänderung auswählbaren Status:

    1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

    2. Fügen Sie unter LoadInformation/ProcessMonitor/Grid/Data/Status für alle Option-Status-Elemente ein selectable-Attribut hinzu und setzen Sie folgende Werte:

      • selectable=true, wenn der Status für manuelle Statusänderungen verfügbar sein soll.

      • selectable=false, wenn der Status nicht für manuelle Statusände-rungen verfügbar sein soll.

        Wenn das selectable-Attribut nicht existiert, wird automatisch der Wert true gesetzt und der Status ist auswählbar.

  4. Speichern Sie die Änderungen und publizieren Sie den Workflow.

  5. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Manuelle Statusänderungen im Grid durchführen

Nachdem die notwendige Konfiguration durchgeführt wurde, können Sie im Process Monitor-Grid eine manuelle Statusänderung durchführen.

Voraussetzungen

Notwendige Konfigurationen in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration sind durchgeführt.

Siehe Manuelle Statusänderungen in der XSLT-Variable des Moduls BPC_Assign_hook konfigurieren

So gehen Sie vor

  1. Wählen Sie eine oder mehrere Prozesse bzw. Logeinträge über das Markieren der entsprechenden Zeilen aus:

    process monitor guide 1399 0

  2. Klicken Sie auf den Button Status ändern. Der Dialog Statusbearbeitung öffnet sich.

  3. Folgen Sie den Anweisungen im Dialog und füllen Sie die Pflichtfelder aus.

  4. Ändern Sie den Status wie gewünscht und wählen Sie aus dem Listenfeld einen neuen Status aus.

  5. Klicken Sie OK. Eine Erfolgsmeldung wird angezeigt.

  6. Klicken Sie OK. Der Status des entsprechenden Parent-Logeintrags wird geändert.

Es wird gleichzeitig automatisch ein neuer Child-Logeintrag erzeugt. In diesem neuen Child-Eintrag wird erfasst, welcher Anwender den Status wann geändert hat und welcher Kommentar bei der Änderung hinzugefügt wurde, z.B.:

process monitor guide 1399 1

Spalten mit Checkboxen anzeigen

Sie können im Process Monitor-Grid Spalten mit Checkboxen anzeigen lassen.

Eine Checkbox wird immer dann als Markiert angezeigt, wenn in der Datenbank ein Wert vorhanden ist. Wenn der Datenbankwert Null ist, wird die Checkbox nicht markiert.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Fügen Sie dem XML-Element Checkbox, über welches die Datenbankspalte konfiguriert wird, ein type-Attribut mit dem Wert boolean hinzu, z.B.:

    process monitor guide 1400 0

  3. Publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Die abgebildete Konfiguration sorgt dafür, dass die Checkboxen in der entsprechenden Spalte des Process Monitor-Grids immer dann markiert sind, wenn in der entsprechenden Datenbankspalte irgendein Wert vorliegt.

Sie können den Namen der Spalte individuell anpassen, siehe Namen der Spalten im Process Monitor-Grid ändern.

Spalten mit Auswahlfiltern anzeigen

Sie können für Spalten im Process Monitor-Grid zwei Typen von Auswahlfiltern anbieten: entweder eine fest definierte Auswahl an verfügbaren Filteroptionen oder einen dynamischen Auswahlfilter zum Festlegen von Filterparametern.

Spalten mit definierten Auswahlfiltern anzeigen

Sie können Spalten so konfigurieren, dass für die Filterung der Spalte eine definierte Auswahlliste zur Verfügung steht, z.B.:

process monitor guide 1400 1

Spaltentypen (z.B. type=status oder type=listFilter) und auswählbare Filteroptionen definieren Sie in der XSLT- Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Navigieren Sie in einem (Single) Grid-Element zum Data-Element.

  3. Navigieren Sie innerhalb des Data-Elements zu dem Element, welches die Datenbank- bzw. Grid-Spalte generiert, für die Sie Auswahlfilter anlegen und anbieten möchten, hier z.B. zum Status-Element, da die Auswahlliste in der Spalte Status angeboten werden soll.

  4. Fügen Sie dem Element ein type-Attribut mit einem der folgenden Werte hinzu, abhängig davon, ob Sie einen regulären Auswahlfilter oder einen Auswahlfilter mit Statusinformationen, die sich auch auf die Darstellung von Icons im Grid auswirken, anbieten wollen:

    process monitor guide 1401 0

    • type=listFilter, um beim Filteraufruf eine fest definierte Auswahlliste von Filteroptionen anzubieten.

    • type=status, um beim Filteraufruf eine definierte Auswahlliste von Filteroptionen mit Statusinformationen anzubieten, die sich bei der Darstellung im Grid auch auf die Anzeige von Status-Icons auswirken.

  5. Fügen Sie für die im Portal anzubietenden Auswahloptionen eine gewünschte Menge an Option-Elementen ein und geben Sie jeweils pro Element einen gewünschten Wert an, der als Beschriftung der Option im Process Monitor-Grid angezeigt wird, hier z.B. OK, Error, Warning.

  6. Sie können die internen Bezeichner der Werte in der Filter-Auswahlliste überschreiben, um sie aussagekräftiger oder für die Darstellung gefälliger zu gestalten. Fügen Sie dazu den Option-Elementen, deren dargestellte Wertebezeichner sie überschreiben möchten, hier z.B. In_Progress, das Attribut label hinzu und geben diesem als Wert den gewünschten Bezeichner In Progress:

    process monitor guide 1401 1

  7. Publizieren Sie den Workflow.

  8. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Icons in Auswahlfiltern anzeigen

Für die Werte der Status-Spalte sind auch Icons definiert. Sie können per Konfiguration festlegen, ob im Auswahlfilter für diese Spalte zusätzlich zu den Auswahloptionen die Icons angezeigt werden.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Setzen Sie im XML-Element DefaultGridOptions den Wert des Elements listFilterIcons auf true (Standardwert), um in Auswahlfiltern zusätzlich zu den Auswahloptionen die zugehörigen Icons anzeigen zu lassen:

    process monitor guide 1402 0

  3. Publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Spalten mit dynamischen Auswahlfiltern anzeigen

Sie können Spalten so konfigurieren, dass dem Nutzer für die Filterung der Spalte ein dynamischer Auswahlfilter zum Festlegen von Filterparametern angezeigt wird. Dabei steht ein Eingabefeld zur Verfügung, in dem nach der Eingabe von mind. 3 Buchstaben bzw. Zeichen der Filter automatisch auf Basis aller Werte der entsprechenden Spalte aktualisiert wird und damit die Filterauswahl dynamisch weiter einschränkt, z.B.:

process monitor guide 1402 1

Den dafür notwendigen Spaltentyp type=dynamicList definieren Sie in der XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Navigieren Sie in einem (Single) Grid-Element zum Data-Element.

  3. Navigieren Sie innerhalb des Data-Elements zu dem Element, welches die Datenbank- bzw. Grid-Spalte generiert, für die Sie den dynamischen Auswahlfilter anlegen und anbieten möchten, hier z.B. zum Text-Element, da der Auswahlfilter im Beispiel in der Spalte Beschreibung angeboten werden soll.

  4. Fügen Sie dem Text-Element ein type-Attribut mit dem Wert dynamicList hinzu:

    process monitor guide 1403 1

    Der dynamische Auswahlfilter unterscheidet NICHT zwischen Groß- und Kleinbuchstaben! Es werden Teile von Zeichenketten gesucht, ohne dass Sie Wildcards angeben.

  5. Publizieren Sie den Workflow.

  6. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Daten in anderen Process Monitoren dynamisch filtern

Sie können mit einem Klick in ein Process Monitor-Grid die Daten in einem anderen Process Monitor-Grid filtern. Damit können Sie z.B. im zweiten Process Monitor-Grid detailliertere Informationen zu einem ausgewählten Logeintrag anzeigen lassen.

Das Filtern wird über den process monitor guide 1403 2-Button in der Spalte Filter ausgelöst. Sie müssen in der XML-Konfiguration die Parameter für die Spalte, von der aus gefiltert wird, für das zu filternde Ziel-Grid und den Namen der zu filternden Spalte definieren.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Fügen Sie zum Element remoteFilterTest unter LoadInformation/ProcessMonitor/[…]/Grid/Data folgende Attribute ein:

    process monitor guide 1403 3

    • title: Beliebiger Name für die Anzeige im Monitor

    • type: Mit remoteFilter wird die Funktionalität der Spalte definiert.

    • icon: search.gif; Grafik-Datei, die als Button dargestellt wird. Die Grafik muss im Repository im Verzeichnis ProcessMonitor > Icons liegen.

    • localField: Name der Spalte, deren Werte zum Filtern genutzt werden sollen. Bezieht sich auf das Grid, in der das Filtern ausgelöst wird.

    • targetGrid: ID des Process Monitor-Grids, das gefiltert werden soll. Diese ID entnehmen Sie dem id-Attribut des zu referenzierenden Grids, z.B.:

      process monitor guide 1404 0

    • targetField: Name der Spalte, deren Werten gefiltert werden sollen.

  3. Speichern und publizieren Sie die geänderten Module und Workflows.

Datumsanzeige im Process Monitor-Grid ändern

Sie können bei Datumsspalten mit dem Typ date die Anzeige des Datums ändern.

So gehen Sie vor

  1. Öffnen Sie die XSLT-Variable des Moduls BPC_Assign_hook im Workflow BPC_299_PM_Configuration zum Bearbeiten.

  2. Fügen Sie die Attribute format und db_format beim Spaltenelement ein:

    • db_format: Datumsformat in der Datenbank. Beispiel: Y-m-d H:i:s.u

    • format: Datumsformat für die Anzeige. Der Formatierungsstring muss als Parameter format der Ext JS-Funktion Ext.util.Format.dateRenderer gültig sein. Beispiel: d.m.Y H:i:s

      process monitor guide 1404 1

  3. Speichern Sie Ihre Änderungen und publizieren Sie den Workflow.

  4. Melden Sie sich vom Portal ab und wieder an, um die Änderungen anzuzeigen.

Press Esc to exit full screen
Modal image placeholder
Press Esc to exit full screen