Aktionsbox
Grundlagen
Die Aktionsbox ist ein Pendant zu Schaltern auf Masken. Aufgaben und Prozesse können dem Anwender strukturiert und unabhängig zum Maskeninhalt in einer Baumstruktur angeboten werden. Zu Beginn ist die Aktionsbox nicht sichtbar und muss über den Balken am rechten Rand aufgeklappt werden. Die Position der Aktionsbox bzw. des rechten verschiebbaren Bereichs wird für den Anwender gespeichert. Per Definition ist die Aktionsbox nicht sichtbar, wenn keine Elemente vorhanden sind oder die aktuelle Ansicht keine Aktionsbox unterstützt (z.B. Prozess-Masken, Taskliste und Cockpit). In diesem Fall kann sie nur durch den Administrator eingeblendet werden.
![](../../../__attachments/10684395/Aktionsbox_auf_Cockpit%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Abbildung: Aktionsbox im EVI Kundencockpit
Benutzerspezifische Konfiguration
In der Aktionsbox können sowohl system-, gruppen- oder benutzerspezifische Aktionen konfiguriert werden. Falls keine übergeordneten Aktionen konfiguriert sind, wird der darunterliegende Bereich für den jeweiligen Anwender geladen. Um die Aktionsbox entsprechend zu bearbeiten, muss über das Kontextmenü (per Rechtsklick) der gewünschte Bereich geladen werden.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Laden%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Wird eine gruppenspezifische Aktionsbox konfiguriert, so wird ein Auswahldialog für die jeweiligen Gruppen angezeigt.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Laden_Gruppenwahl%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Nachdem die Auswahl getroffen wurde, wird die entsprechende Administrationsoberfläche geladen.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Geladen%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Löschen von Aktionen
Löschen Sie Aktionen einfach per Rechtsklick auf eine Aktion - Löschen.
Sie können diese Aktion nicht rückgängig machen!
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Aktion_Loeschen%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Neuanlage einer Aktion
Über einen Rechtsklick auf eine leere Stelle in der Aktionsbox können Sie eine neue Aktion einfügen. Tragen Sie die folgenden Parameter ein:
Bezeichner: Die eindeutige Aktions-ID, über die Sie den Aktionsschalter im Skript referenzieren können.
Name: Der angezeigte Name der Aktion.
Beschreibung: Der Tooltip, der bei Verweilen auf dem Schalter angezeigt wird und die Aktionsbeschreibung ausgibt.
Wenn man in der C1-Schicht modulbezogene Aktionen der Aktionsbox hinzufügen möchte, muss man, nachdem man das Modul geladen hat, zunächst einen Ordner anlegen, in diesen hineingehen und dort dann Aktionen anlegen.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Neu_1%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Abbildung: Neu angelegte Aktion in der Aktionsbox.
Wenn Sie die gewünschten Aktionen erstellt haben, speichern Sie die Aktionsbox über Rechtsklick - Administration - Speichern als xxxspezifischen Bereich als gewünschte Konfiguration. Wählen Sie den gruppenspezifischen Bereich, wenn die Änderung nur für eine bestimmte Nutzergruppe gelten soll. Existiert eine gruppenspezifische Konfiguration für die Benutzergruppe des angemeldeten Anwenders, so wird diese geladen und die systemspezifische ignoriert.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Sichern%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Sichern_Dialog.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Abbildung: Hinweis zur gruppenweiten Aktionsbox-Konfiguration
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Sichern_Ergebnis%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Abbildung: Ergebnis: Die neu angelegte Aktion wird in der Aktionsbox angezeigt.
Verknüpfung mit Maskenskript und BPM-Prozessen
Um mit Ihren angelegten Aktionsschaltern auch Aktionen auslösen zu können, können Sie diese per Maskenskript ansprechen. Sie können Code bei Klick auf Schalter ausführen lassen als auch die Schalternutzbarkeit anwender- oder situationsspezifisch konfigurieren.
In der Callback-Methode detailViewButtonClicked(String nameOfClickedButton) können Sie nun den Button referenzieren und Code ausführen, zum Beispiel einen BPM-Prozess starten. Schreiben Sie den auszuführenden Code in Abfragen der Form:
if(equal(nameOfClickedButton, "<AktionsbuttonName>")){
... //Auszuführenden Code hier
}
![](../../../__attachments/10684395/Aktionsbox_Aktion_Script_2%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Neuanlage einer Prozessaktion
Über einen Rechtsklick auf eine leere Stelle in der Aktionsbox können Sie eine neue Prozessaktion einfügen.
![](../../../__attachments/10684395/screenshot.47.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Im weiteren Schritt können Parameter eingegeben werden.
![](../../../__attachments/10684395/screenshot.49.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Zur Auswahl stehen alle Prozesse mit der Startbedingung Aktionsbox. Zudem können der Name und die Beschreibung hinterlegt werden. Das Symbol der Prozessaktion kann ausgetauscht werden.
Wurde der Prozess zu einem späteren Zeitpunkt deaktiviert oder gelöscht, aber der dazugehörige Aktionsbox-Eintrag nicht entfernt, so wird dies dem Anwender per Hinweismeldung angezeigt.
![](../../../__attachments/10684395/image-20231130-140518.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Organisieren der Aktionsbox
Anlegen einer Ordnerstruktur
Sie können Ihre Aktionen strukturieren, indem Sie eine Ordnerhierarchie anlegen. Klicken Sie rechts in die Aktionsbox und wählen Sie Neuer Ordner. Vergeben Sie anschließend einen eindeutigen Namen.
![](../../../__attachments/10684395/OrgaAxbox.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Sortieren der Aktionen
Neben dem Anlegen von Ordnern können Sie auch die Aktionen automatisch sortieren lassen, um Ihre Aktionsbox zu organisieren. Die Sortieroptionen finden Sie im Kontextmenü per Rechtsklick auf die Aktionsbox.
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Sortieren%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
![](../../../__attachments/10684395/Aktionsbox_Bearbeiten_Ordner_Sortieren_Ergebnis%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Abbildung: Ergebnis: Sortierte Aktionsbox mit Ordnerhierarchie.
Aktive und inaktive Aktionen
Der Status der Aktionsbox-Einträge wird anhand der Selektionsmenge in der Tabelle festgestellt.
Maskenskript-Aktionen sind nur verfügbar, wenn genau ein Satz in der Tabelle selektiert ist.
Die neue Prozessaktion ist verfügbar, wenn mindestens ein Satz in der Tabelle selektiert wurde.
![](../../../__attachments/10684395/CRM-3622_TableSelection.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Über die Callback-Methode void initActionBox(){...} im Maskenskript können Sie bestimmen, was bei Aktionsboxinitialisierung (also beim Laden eines Datensatzes und Hervorbringen der Aktionsbox) mit dieser geschehen soll. Im Methodenrumpf können Sie mit der Funktion ActionBoxUtils.setEnabled(boolean enabled, String name) bestimmen, welche Aktionsschalter verfügbar sein sollen.
![](../../../__attachments/10684395/Aktionsbox_Aktion_Script%5B1%5D.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)