Individuelle Workflowfilter von der Startseite aus aufrufen

Von der Startseite aus ist es möglich, die Workflowfilter individuell aufzurufen. Das ist vorteilhaft, da Ihre Anwender so nicht die Standard-Oberfläche des agorum core workflow 3.0 öffnen müssen und nur das zu sehen bekommen, was benötigt wird.

Ziel: individuelle Workflowfilter von der Startseite aus aufrufen

Filter für das agorum core information center anlegen

Die Oberfläche des agorum core workflow 3.0 kann von Ihren Anwendern über die Startseite und dort über ein eigenes Modul aufgerufen werden. Es fehlt also noch die Konfiguration des Workflowfilters, der direkt ausgewählt wird, wenn das Modul vom Anwender angeklickt wird.

Um das zu realisieren, legen Sie nun einen neuen Filter für das agorum core information center per agorum core template manager an.

Öffnen Sie auf der Startseite von agorum core den Smart Assistant.
Rufen Sie Ihren Projektorder auf.
Klicken Sie mit der rechten Maustaste auf eine beliebige leere Stelle.
Wählen Sie im Kontextmenü agorum core template manager > Funktionen hinzufügen > Neuen Filter für das information center hinzufügen.
Vergeben Sie einen Namen für den neuen Filter.
Bestätigen Sie mit OK.

Ergebnis: Im Hintergrund legt das System nun automatisch einen neuen Unterordner namens "acic" im Order "js" an.
Ignorieren Sie vorerst das erscheinende Pop-up namens Register Name, indem Sie es zur Seite schieben.
Rufen Sie den Ordner acic im Ordner js auf.
Doppelklicken Sie dort befindliche JavaScript-Datei an.

Löschen Sie den Inhalt der JavaScript-Datei und ersetzen Sie ihn z. B. mit folgendem Inhalt (passen Sie die Zeilen an Ihre eigene Konfiguration an):

//Filter des Rechnungseingangs Dashboard
let wf = require('/agorum/roi/customers/acworkflow/js/acic/workflow');

exports.settings = user => {
  // Original Workflow acic Konfiguration laden und die Konfiguration "acworkflow.tasks" suchen
  let orgTaskAcic = wf.settings(user).find(item => item.name === 'acworkflow.tasks');
 
  // Überschreiben der Standard Konfiguration mit eigenen Parametern, passen Sie diesen Parameter an Ihre eigene Konfiguration an
  orgTaskAcic.name = 'meine.workflow.beispiele.workflows.filter';
  // Wenn es zur Verfügung steht, gerne auf den internen Namen einer eigenen smart assistant Liste verweisen
  // orgTaskAcic.listConfig = '<interner Name>';
  // Name des Filters
  orgTaskAcic.text = 'Rechnungseingang';
  // Anpassung der query, um sich nur bestimmte Workflows anzeigen zu lassen
  // orgTaskAcic.baseQuery += ' sys_acw_processdisplayname_ci:"Rechnungseingang"';
 
  return [ orgTaskAcic ];
};

Speichern Sie das Skript.

Einstellungen in der MetaDb vornehmen

Damit das Modul "Workflowfilter" (Name dient als Beispiel) auf der Startseite erscheint, nehmen Sie folgende Einstellungen in der MetaDb vor.

Property-Group anlegen

Öffnen Sie auf der Startseite von agorum core die Administration.
Klicken Sie auf links im Menü auf MetaDb.

Öffnen Sie folgenden Pfad:

MAIN_MODULE_MANAGEMENT/home/control/Apps

Legen Sie über eine neue Property-Group an.
Vergeben Sie einen Namen für die Konfiguration. Dieser kann entweder nach dem Kundenprojekt oder nach dem Thema der Konfiguration benannt sein, z. B.:
```
[ agorum Software GmbH ]
```
```
[ Posteingangskonfiguration ]
```

Property-Bundle anlegen

Rufen Sie die neue Property-Group mit einem Doppelklick auf.
Legen Sie über ein neues Property-Bundle an.
Vergeben Sie den Namen wie folgt (Beispiel):
```
Workflowfilter
```

Property-Entrys anlegen

Rufen Sie das neue Property-Bundle mit einem Doppelklick auf.
Legen Sie über folgendes neue Property-Entry an:

Name
Title

Wert (String)
Workflowfilter
Speichern Sie den neuen Property-Entry.
Legen Sie über folgendes neue Property-Entry an und geben Sie dort als Wert den Filter aus dem noch offenen Pop-up an, das sie vorhin zur Seite geschoben haben:

Name
URL

Wert (String)
/roiwebui/aguila_module/?type=agorum.workflow.view&settingName=meine.workflow.beispiele.workflows.filter
Speichern Sie den neuen Property-Entry.
Klicken Sie im noch offenen Pop-up Register Name auf OK, um den Filter im System zu registrieren.
Legen Sie über folgendes neue Property-Entry an:

Name
Icon

Wert (String)
/roiwebui/acworkflow_module/icons/workflow-icon-3-0.svg (Beispiel)
Hinweis: Die Icons zu den Modulen finden Sie unter folgendem Pfad:
```
MAIN_MODULE_MANAGEMENT/home/control/Apps/<Modulname>

Beispiel:
MAIN_MODULE_MANAGEMENT/home/control/Apps/acworkfloweditor
```
Speichern Sie den neuen Property-Entry.

Hinweis: Damit Ihr neues Modul in einer bestimmten Kategorie angezeigt wird, z. B. unter "Konfiguration", legen Sie ein weiteres Property-Entry mit dem Title "Category" und dem String "Config" an. Sollten Sie keine Kategorie angeben, wird das neue Modul unter "Allgemein" angezeigt.
Tipp: Um eigene Kategorien zu erstellen, legen Sie eine neue Kategorie in folgendem Pfad an:
```
MAIN_MODULE_MANAGEMENT/home/control/Categories
```

Sobald die obigen Schritte abgeschlossen sind, erscheint der Filter oben in jedem Browsertab bereits zur Auswahl. Ruft nun ein Anwender das Modul "Workflowfilter" über die Startseite aus, ist der Filter "Workflow Posteingang ABC" bereits vorausgefüllt:

Vorausgewählte Workflowfilter