Allgemeines zu Aktionen

Über den Menübaum unter

MENÜ UND AKTIONEN
   --> Aktionen

gelangt man als Administrator zur Aktionsübersicht. Hier hier finden sich alle Basisaktionen, Konfigurationen und Prozessverknüpfungen übersichtlich in einer Tabelle - es besteht die Möglichkeit, alle Elemente über die Volltext-Suche, Dropdown-Listen oder die Sortierungspfeile nach Namen, Aktionsytp oder Anderem zu filtern und zu sortieren. 

Mit Hilfe der Suchfunktion kann man mit Hilfe verschiedener Parameter nach einer Aktion suchen.

• Suche nach Aktionstyp
  Die Suche nach einem Aktionstyp kann unter folgenden Kriterien durchgeführt werden: Aktion, Konfiguration, Prozessreferenz.
• Suche nach Namen
  Suche einer bestimmten Aktion nach ihrem Namen (Bsp. Wf_getMyToDos).
• Suche nach Beschreibung
  Suchkriterium ist eine Beschreibung der Aktion (Bsp. Formular um Feiertage zu verwalten).
• Suche nach Aktionsordner
  Bei der Suche nach Aktionsordner stehen die installierten Module des Webdesk zur Verfügung.

Je nachdem, welche Art von Aktion (Aktion/Konfiguration/Prozessreferenz) ausgewählt wird, lassen sich in der darauffolgenden Maske mehr oder weniger Daten editieren.

Basisaktionen editieren

Bei neuen Aktionen kann es sich lediglich um Konfigurationen einer bereits bestehenden Aktion, oder um Prozessreferenzen handeln.

Soll eine neue Konfiguration erstellt werden, so sucht man zunächst die entsprechende Aktion aus, und klickt von dieser aus auf  "Neue Konfiguration".
Soll eine Prozessreferenz angelegt werden, welche die Integration einer Prozessdefinition im Menübaum erlaubt, so klickt man auf die Schaltfläche "Neue Prozessverknüpfung".

• Abhängig von der oben beschriebenen Vorgangsweise wird als Aktionstyp automatisch Konfiguration bzw. Prozessreferenz vorgegeben
• Name
  Name der neuen Aktion/Konfiguration
• Überschrift
  Überschrift für die neue Aktion/Konfiguration

Nach erfolgter Speicherung erhält man eine Bestätigung des Servers, und erhält eine Übersicht über mögliche Einstellungen, Berechtigungen, Dateien, Textmodule.

Tab "Einstellungen"

Hier finden sich diverse Optionen, welche das Basisverhalten der Aktion betreffen:

Beschreibung	Hier findet sich Platz für eine ausführlichere Beschreibung der Aktion sowie deren Funktion und Verhalten
Aktionsordner	Angabe des Aktionsordners, welchem die Aktion zugeordnet sein soll. Die Aktionsordner sind grob nach den diversen Webdesk-Modulen aufgeteilt (z.B. Aktion gehört zum Modul Project Time -> Aktionsordner "ptm")
Menü-Icon	Auswahl des Menü-Icons, mit welchem die Aktion im Menübaum dargestellt wird.
eigenes Menü-Icon für Classic-Ansicht	Auswahl des Menü-Icons für die Darstellung in der Classic-Ansicht (1. Sammlung auswählen -> 2. Icon auswählen)
bei Softwareupdate Aktions-Metadaten überschreiben	Auswahl Ja/Nein: Sollen Änderungen durch den Benutzer an der Aktion (Titel, Beschreibung, Menü-Icon, Bild classic, Bildsammlung classic, Berechtigung für alle Mandanten) bei einem Software-Update durch die Standard-Einstellungen überschrieben werden?
Berechtigung an folgende Aktion weitervererben	Möglichkeit zur Definition einer Aktion, für welche dieselben Berechtigungen gelten sollen, wie für die aktuelle Aktion
Standardrollen	Auflistung jener Rollen, deren Besitzer automatisch eine Berechtigung für die Aktion besitzen
Nicht unterstützte Ansichtsports	durch setzen eines entsprechenden Hakens kann hier der Zugriff auf die neue konfigurierte Aktion für bestimmte Plattformen (Mobile, Tablet oder Desktop) gesperrt werden
HQL Berechtigungsabfrage
Immer im neuen Fenster öffnen	ist diese Tickbox angehakt, wird die neue Aktion beim Aufrufen stets in einem neuen Browserfenster geöffnet
Ist Experimental	hier kann die neue Konfiguration mit dem Attribut "experimental" markiert werden
Ausführung für geswitchte User verhindern	ist diese Tickbox aktiviert, kann die Aktion nur durch den User selbst und nicht durch Administratoren, welche zu diesem User geswitcht haben, ausgeführt werden
Folgende Vorlage benutzen	diese Option ist entwicklerspezifisch und für den täglichen Gebrauch von Webdesk für den Benutzer/Administrator nicht relevant
Kontroller/Kontroller Pattern	diese Option ist entwicklerspezifisch und für den täglichen Gebrauch von Webdesk für den Benutzer/Administrator nicht relevant
Anzahl User (max. lizenziert)	hier wird angezeigt, wie viele User derzeit berechtigt sind, diese Aktion zu verwenden. Darunter wird ein Limit angezeigt, für wie viele User die entsprechende Webdesk-Lizenz gültig ist

Tab "Berechtigungen"

Hier können Berechtigungen zum  Zugriff auf die Aktion vergeben werden. Dies funktioniert entweder als kollektive Berechtigung über die Checkbox "Berechtigung für alle Mandanten" (siehe unten) oder, um individuelle Zuordnung zu ermöglichen, über verschiedene Berechtigungstypen.

• Checkbox "Berechtigung für alle Mandanten"
  Ist diese Checkbox aktiviert, so erhalten alle Personen aller Mandanten die Berechtigung die Aktion auszuführen. Dies macht besonders bei grundlegenden Aktionen mit vielen (oder allen) Benutzern Sinn, da so die einzelne Zuweisung von Personen-/Gruppen-/Mandantenberechtigungen entfällt.
  Über die Dropdown-Liste wird das Kompetenzziel (Einsichtserlaubnis) für die kollektive Berechtigung definiert.

• spezifische Berechtigung
  Sollen nur einzelne Mandanten/Gruppen/Personen/Rollen die Aktion ausführen können, so kann über den Button "Neue Aktionsberechtigung" eine detaillierte Berechtigung vergeben werden, mehr dazu unter Berechtigungen vergeben und steuern

Tab "IP Restrictions"

Hier kann der Zugriff auf die Aktion für einzelne IP-Adressen innerhalb des Systems gesperrt werden oder diesen der Zugriff erteilt werden. Dabei sind folgende Felder auszufüllen:

Typ	Auswahl des Beschränkungs-Typs: Single: Ausschließen/Berechtigung einer einzelnen IP-Addresse Range: Ausschließen/Berechtigung einer IP-Range (von-bis, Start- und Endadresse) Subnet Mask: Ausschließen/Berechtigung einer Teilnetzmaske
Startadresse	Single: Eingabe der IP-Adresse, auf welche sich die Sperre/Berechtigung bezieht Range: Eingabe der IP-Adresse, mit welcher die Range beginnen soll
Endadresse	Range: Eingabe der IP-Adresse, mit welcher die Range enden soll
Teilnetzmaske	nur bei Typ "Subnet Mask": Eingabe der Teilnetzmaske, auf welche sich die Sperre/Berechtigung bezieht
Zugriff erlauben	Ist diese Checkbox angehakt, so erlangt die angegebene IP-Adresse/Range/Teilnetzmaske eine Berechtigung zum Zugriff auf die Aktion

Tab "Parameter"

Diese Parameter sind für die Entwicklung von Webdesk relevant, können bei der täglichen Arbeit mit Webdesk EWP jedoch ignoriert werden.

Tab "Dateien"

Ist beispielsweise die zu bearbeitende Aktion vom Typ "Konfiguration", so können der Aktion mehrere Dateien zugeordnet sein. Bei jedem Speichern wird die Datei in einer neuen Version in der Datenbank persistiert. Beim Anlegen einer neuen Aktion ist dieser Reiter leer.

Tab "Textmodule"

Zeigt alle vorhandenen Textmodule an. Hier erfolgt die Anlage neuer Textmodule (Textbausteine), bzw. von Übersetzungen. Bei Bedarf kann man von hier aus direkt ein Textmodul bearbeiten, indem man auf die Schaltfläche "Bearbeiten" klickt.

Bei den Übersetzungen empfiehlt es sich, den Textbaustein durch einen technischen Key austauschen: z.B. Datum > wird zu "Kontenauswertung_Datum01". Anschließend wird bei der entsprechenden Sprache die gewünschte Übersetzung eingegeben. So verfährt man mit jedem Textbaustein einer jeder Aktion/Konfiguration, bis alle übersetzt sind. Hierbei empfiehlt es sich, den Flag "Bei Softwareupdate Aktions-Metadaten überschreiben" nicht angehakt zu lassen, da die Textbausteine sonst wieder auf den Standardwert gesetzt werden.

Tab "Konfigurationen"

Hier findet sich eine Übersicht über alle von dieser Aktion abstammenden Konfigurationen sowie die dazugehörigen Details und direkte Links zu den Konfigurationen.

Tab "Hilfetexte"

In diesem Reiter können Sie zu der Aktion passende Hilfetexte integrieren, welche für den Benutzer der Aktion in in der Kopfleiste aufrufbar sind. Auch lässt sich ein URL-Link zu einem externen System, beispielsweise einer Website mit Tutorials oder weiteren Beschreibungen, setzen. Für jede angelegte Sprache existieren eigene Hilfetextfelder.

Tab "Zugriffsrechte"

Diese Option betrifft zukünftige Webdesk-Entwicklungen und ist derzeit für den Benutzer/Administrator nicht relevant.

Überprüfung von zugeordneten Berechtigungen bei bestimmten Aktionen

Möchte man überprüfen, wer bei einer bestimmten Aktion/Konfiguration/Prozessreferenz eine Berechtigung hat, so geht dies entweder über die Aktion selbst, oder über den Menübaum.

Berechtigungs-Überprüfung über den Menübaum

Dies ist der schnellste Weg, um zu überprüfen, wer eine Berechtigung für eine bestimmte Aktion / Konfiguration oder Prozessreferenz hat.
Hier wird der Menüpunkt "Menü & Aktionen" angeklickt > Menüwartung

• Anschließend im Menübaum die gewünschte Aktion anklicken
• Auf der rechten Seite erscheint eine Übersicht über die Berechtigungen:

Berechtigungs-Überprüfung über die Aktion

Die Überprüfung der Berechtigungen kann auch direkt über die Aktion oder Konfiguration (oder Prozessreferenz erfolgen).
Hierzu klickt man im Menüpunkt Menü & Aktionen > Aktionen

• Suche nach der gewünschten Aktion  > Anklicken
• Reiter Berechtigungen

Neue Aktion 

Um eine neue Aktion / Konfiguration im Menübaum einpflegen zu können kann entweder ein neuer Ordner (z.B. Auswertungen, Info, etc.) angelegt werden, in welchen die Aktion oder Konfiguration reinkommt, oder man wählt einen bereits bestehenden Ordner.

Um die Aktion / Konfiguration zu integrieren, wählt man den entsprechenden Ordner im Menübaum aus, klickt mit der rechten Maustaste, und wählt > Aktionslink hinzufügen.

• In der Auswahl-Maske wird nach der gewünschten Aktion / Konfiguration gesucht
  Es können beliebig viele Aktionen / Konfigurationen durch Anklicken gewählt werden.
  In den Suchfeldern "Aktionstyp", "Name", "Überschrift" oder "Beschreibung" können Sie nach den gewünschten Einträgen suchen.
• Durch einmaliges Anklicken wird die Aktion / Konfiguration in den Menübaum integriert.

Klicken Sie mehrmals auf dieselbe Aktion, so wird diese auch mehrmals in den Menübaum übernommen.

Anschließend muss die Auswahlliste geschlossen werden (anklicken des Schließen-Buttons in der rechten oberen Ecke) und der Menü-Cache geleert werden.

Externe Links im Webdesk

Mit der Aktion "po_openExternalWebPage" kann eine externe Webpage (Link) im Webdesk hinzugefügt werden, welche dann beim anklicken in einem neuen Fenster aufgemacht werden kann. Dies erfolgt über einen IFrame. Innerhalb der Aktion können unterschiedliche Konfigurationen für unterschiedliche Links angelegt werden.

Aktion löschen

Um eine Aktion zu löschen sucht man die betreffende Aktion aus der Detailansicht aus (anklicken). In der Titelleiste befindet sich die Schaltfläche "Löschen" -diese anklicken.

Als Sicherheitscheck erscheint ein Popup, mit der Frage, ob man die Aktion tatsächlich löschen möchte. Durch Anklicken des OK-Buttons wird die Aktion aus dem Verzeichnis gelöscht.