Beispiel: BPM-Alerts implementieren

• categoryFilter(String)(List)

Der Service ermittelt anhand dieser Eingabe, welcher Typ von Alertdefinitionen abgerufen werden soll.

• alertDefinitionsStatus(BPMAlertDefinitionStatus)(List)

Die Ausgabevariable enthält die Liste der Alertdefinitionen, die der Service auf der Grundlage des vom Benutzer gewünschten Alerttyps abgerufen hat. Der Typ BPMAlertDefinitionStatus befindet sich im Toolkit für Systemdaten, um BPM-Alerts zu unterstützen.

• Festlegen des Filters, der angewendet werden soll.
• Abrufen der dem Typenfilter entsprechenden Alertdefinitionen zum Anzeigen in einer Liste.
• Abrufen der Informationen dazu, welche Alertdefinitionen einen Alert ausgelöst haben.

var ids = null;

// if categoryFilter is set, use it to get the alert definitions
if(tw.local.categoryFilter != null) {
	var alertDefinitions = tw.system.getAlertDefinitions(tw.local.categoryFilter, true);
	ids = new tw.object.listOf.String();
	for (var i=0; i<alertDefinitions.length; i++) {
		ids.insertIntoList(i, alertDefinitions[i].id);
}}

// get the status of the retrieved alert definitions
if(ids == null || ids.length > 0) {
	var alertStatusResponse = tw.system.getAlertDefinitionsStatus(ids, true);
	tw.local.alertDefinitionsStatus = alertStatusResponse.alertDefinitionStatus;
}

1. Ordnen Sie den im vorherigen Abschnitt erstellten 'Alert Definitions Status Retrieval Service' in den zugehörigen Implementierungseigenschaften entsprechend zu.
2. Orden Sie in der Eingabezuordnung der Datenzuordnungseigenschaften die Variable categoryFilter des Benutzerservice zur Variablen categoryFilter des 'Alert Definitions Status Retrieval Service' zu.
3. Ordnen Sie ebenso in der Ausgabezuordnung die Variable alertDefinitionsStatus des 'Alert Definitions Status Retrieval Service' zur Variablen alertDefinitionsStatus des Benutzerservice zu.

tw.local.alertStatusSummaries = new tw.object.listOf.AlertStatusSummary();
var alerts = tw.local.alertDefinitionsStatus;

// map the status to the alertStatusSummaries
var num = 0;
var numOfAlerts = 0;
if(alerts != null) {
    for(var i=0; i<alerts.listLength; i++) {
        var status = alerts[i];
        
        // map only if the alert status summary is needed
        if(status.conditionMet || tw.local.selectedTriggeredFilter == "true") {
            
            // build the AlertSummary
            var alertSummary = new tw.object.AlertStatusSummary();
            alertSummary.currentValue = status.actualValue;
            alertSummary.displayName = status.definition.displayName;
            alertSummary.thresholdValue = status.definition.thresholdValue;
            
            // find the correct project name
            var project = null;
            var invalid = false;
            if(status.definition.projectId != null) {
                project = tw.system.model.findProcessAppByID(status.definition.projectId);
                if(project != null) {
                    alertSummary.projectDisplayName = project.name;
                } else {
                    alertSummary.projectDisplayName = status.definition.projectId;
                    invalid = true;
                }
            }
            // find the correct snapshot name
            if(status.definition.snapshotId != null && project != null) {
                var snapshot = project.findSnapshotByID(status.definition.snapshotId);
                if(snapshot != null) {
                    alertSummary.snapshotDisplayName = snapshot.name;
                } else {
                    alertSummary.snapshotDisplayName = status.definition.snapshotId;
                    invalid = true;
                }
            }
            
            // concatenate the condition summary
            if(status.definition.thresholdOperator == "GREATER") {
                alertSummary.condition = "More than ";
                alertSummary.thresholdOperator = ">"
            } else if (status.definition.thresholdOperator == "LESS") {
                alertSummary.condition = "Less than ";
                alertSummary.thresholdOperator = "<"
            } else {
                alertSummary.condition = "Exactly ";
                alertSummary.thresholdOperator = "=";
            }
            
            if(!invalid) {
                alertSummary.condition += status.definition.thresholdValue;
                alertSummary.condition += " " + status.definition.category.toLowerCase() + "(s)";
                if(alertSummary.projectDisplayName != null) {
                    alertSummary.condition += " in project '" + alertSummary.projectDisplayName + "'";
                }
                if(alertSummary.snapshotDisplayName != null) {
                    alertSummary.condition += " and snapshot '" + alertSummary.snapshotDisplayName + "'";
                }
            }            
            // if the alert is active or to display non-active alerts, add them to the list
            if(status.conditionMet) {
                alertSummary.status = "Triggered";
                tw.local.alertStatusSummaries.insertIntoList(0, alertSummary);
                num++;
                numOfAlerts++;
            } else if (invalid) {
                alertSummary.condition = "This alert definition targets a process application or snapshot that is no longer available on the system.";
                alertSummary.status = "Invalid";
                tw.local.alertStatusSummaries.insertIntoList(numOfAlerts, alertSummary);
                num++;
                numOfAlerts++;
            } else if (tw.local.selectedTriggeredFilter == "true") {
                tw.local.alertStatusSummaries.insertIntoList(num, alertSummary);
                num++;
            }
        }
    }
}

// if "All" category has been selected
if (tw.local.selectedCategoryFilter == "") {
    tw.local.categoryFilter = null;
    
// if another category has been selected, build the correct categoryFilter
} else {
    tw.local.categoryFilter = new tw.object.listOf.String();
    tw.local.categoryFilter.insertIntoList(0, tw.local.selectedCategoryFilter);

1. Erstellen Sie eine Coachansicht namens Alert Filter für Alertfilter. Der Web-Process Designer wird zwecks Bearbeitung geöffnet.
2. Wählen Sie auf der Übersichtsseite die Option für Kann Grenzereignisse auslösen aus.
3. Wählen Sie auf der Seite für 'Verhalten' den Änderungsereignishandler aus und fügen Sie diesem Handler den folgenden Code hinzu:

   this.context.trigger();

4. Fügen Sie auf der Seite für 'Variablen' die Variable selected(String) als Geschäftsdatend, die Variable selectionList(NameValuePair)(List) als Konfigurationsoption und 'Dashboards' als Lokalisierungsressource hinzu. Das Objekt NameValuePair befindet sich im Toolkit TWSYS, und die Lokalisierungsressource 'Dashboard' befindet sich im Toolkit SYSD. Wenn das Objekt NameValuePair in der Auswahlliste nicht angezeigt wird, wählen Sie im unteren Bereich der Auswahlanzeige die Option Alle Geschäftsobjekte anzeigen aus.
   
5. Ziehen Sie auf der Seite 'Layout' ein Steuerelement 'Kategorieauswahl' von der Palette in den Erstellungsbereich.
6. Binden Sie das Steuerelement 'Kategorieauswahl' an die Geschäftsdaten vom Typ selected.
7. Gehen Sie zurück zum Heritage-Benutzerservice 'My Alerts Dashboard' im Desktop-Process Designer. Öffnen Sie die Seite 'Coaches' und wählen Sie den Coach 'My Alerts Dashboard' aus.
8. Fügen Sie in 'My Alerts Dashboard' einen horizontalen Abschnitt hinzu und ändern Sie dessen Namen in Filter.
9. Fügen Sie im horizontalen Abschnitt zwei Instanzen der Coachansicht 'Alertfilter' hinzu. Fügen Sie zwischen ihnen ein Element für angepassten HTML-Code hinzu.
   
10. Wählen Sie die erste Instanz von 'Alertfilter' aus. Binden Sie die Instanz in den zugehörigen allgemeinen Eigenschaften an die Variable selectedTriggeredFilter. Um zwischen dem Grenzereignisbroadcast der Alertfilterinstanzen zu unterscheiden, hängen Sie an die Kennzeichnung triggeredFilter an.
11. Erweitern Sie in den zugehörigen Konfigurationseigenschaften den Eintrag Auswahlliste. Fügen Sie die folgenden Name/Wert-Paare hinzu:

    Name	Wert
    Triggered Alerts (Ausgelöste Alerts)	false
    All (Alle)	true

    
    Die Namen werden vom Filter zur Laufzeit angezeigt.
12. Wählen Sie die zweite Instanz von 'Alertfilter' aus. Binden Sie die Instanz an die Variable selectedCategoryFilter. Hängen Sie categoryFilter an die Kennzeichnung an. Fügen Sie die folgenden Name/Wert-Paare hinzu:

    Name	Wert
    Process instance alerts (Prozessinstanzalerts)	INSTANCE
    Task alerts (Task-Alerts)	TASK
    All (Alle)

13. Wählen Sie das Element für benutzerdefinierten HTML-Code aus. Fügen Sie den folgenden HTML-Code hinzu:

    <div id="spacer">&nbsp;</div>

    Der Zweck dieses Steuerelements besteht darin, zwischen den beiden Filtern einen gewissen Zwischenraum einzufügen.

1. Öffnen Sie in der Palette den Bereich für 'Variablen'. Ziehen Sie die Variable alertStatusSummaries in das Diagramm. Das Diagramm zeigt eine Tabelle an, die für jeden Parameter der Variablen jeweils eine Spalte enthält.
2. Um die Überschriften in der Dashboardtabelle zu kürzen, ändern Sie die Bezeichnungen für die folgenden Steuerelemente:

   Standardmäßige Bezeichnung des Steuerelements	Neue Bezeichnung
   Anzeigename	Name
   Schwellenwertoperator
   Schwellenwert	Schwellenwert
   Anzeigename des Projekts	Prozessanwendung
   Anzeigename des Snapshots	Snapshot
   Anzeigename einer Geschäftsprozessdefinition (BPD)	Prozess

3. Legen Sie für das Steuerelement 'Schwellenwertoperator' als Sichtbarkeit der Bezeichnung den Wert Ausblenden fest.