Actions

Eine Klasse kann verschiedene Aktionen beinhalten welche im Kontext der Entität ausgeführt werden können.

Die Konfiguration ist dabei analog einem normalen Property mit einigen zusätzlichen Möglichkeiten:

• Zuweisen der Aktion die ausgeführt werden soll inklusive Rückgabewert

• Definition wie die Aktion angezeigt werden soll (in Listen, Detail etc.)

Die Builder Methode sieht wie folgt aus:

Builder.Add.Action(...)
ClassBuilder.Add.Action(...)

Um einen Body zuzuweisen stehen folgende Overloads zur Verfügung:

Die generische Methode um eine Aktion direkt mit den MetaActionEventArgs auszuführen steht ebenfalls zur Verfügung. Es wird aber davon abgeraten diese zu verwenden. Die Abkapslung in Services erhöht die Testbarkeit der jeweiligen Aktionen und verhindert das Business-Logik direkt in die Builders geschrieben wird.

Jede Aktion kann definieren welche Änderungen sie vorgenommen hat und drückt diese über den Rückgabetyp aus.

Als optionaler Parameter kann bei allen Methoden folgendes definiert werden:

Soll zusätzlich zur Rückmeldung noch eine Navigation erfolgen so kann die Klasse NavigationLinkActionResult verwendet werden. Der NavigationLinkAspect muss dabei als Parameter zur Verfügung gestellt werden.

Aktionen mit Parameter

Einige Aktionen erfordern eine Eingabe um erfolgreich ausgeführt werden zu können.

Um eine Aktion mit Parametern auszustatten stehen dieselben Methoden wie oben beschrieben zur Verfügung mit der Ergänzung eines zusätzlichen Type-Argument welches den Parameter-Typ identifiziert.

Der Parameter für die Aktion wird im Client über ein Popup abgefragt und danach an die entsprechende Aktion weitergeleitet. Es stehen dieselben Rückgabetypen wie bei einer normalen Aktion zur Verfügung.

Aktionen mit Bestätigung

Aktionen können optional eine Bestätigung des Benutzers einholen. Dies ist hilfreich wenn eine Aktion potentiell schwerwiegende Konsequenzen haben könnte.

Das folgende Snippet fragt nach der Bestätigung des Benutzers bevor die Aktion ausgeführt wird:

builder.Get.Class(nameof(elements.Person)).Add.Action("TestActionWithConfirmation")
        .RequiresConfirmation()
        .Content(German, "Inhalt")
        .Title(German, "Titel")
        .ContinueCaption(German, "Weiter")
        .CancelCaption(German, "Abbrechen");

Die Captions sind optional. Wird nichts angegeben werden die Standard-Übersetzungen verwendet.

Platzierung von Aktionen

Platzierung von Aktionen in einer Listen und Detail Ansicht, es gibt drei Möglichkeiten wie man Aktionen platzieren kann:

1. Selektions Aktion: Buttons die erscheinen, wenn man mehrere elemente in einer Liste angewählt hat.
2. Aktion anzeigen in einer Liste bzw in einer Reihe.
3. Aktion wird in einer Reihe neben dem TrashButton über die drei punkte angezeigt und wird auf einem Klickaufegrufen.

Bei den Listen Ansichten - ListLayout kann man die Aktion über eine Porperty anhängen, die Klasse SetListAction nimmt drei Parameter rein somit kan mann die Aktion steuern wo sie angezeigt wird, die Parameter haben folgenden inhalt:

   [NotNull] this T element, 
    bool showInListSelection = true, 
    bool showInListRow = true, 
    bool isOverflowByDefault = false)

list.Add.Link(metadata.Person.LowerCaseNameListAction)
        .Element.SetListAction(true, true, true);

Bei der Detail ansicht - DetailLayout gib es ebenfalls drei möglichkeit um die Aktion zu plazieren:
1. Als eine Standard Akton in der Sidebar.
2. In den Inhalt der Detail ansicht.
3. Es besteht die möglichkeit ebenfalls die Aktion als Primäre oder Sekundäre Aktion anzuzeigen.

Eine Standard Aktion in der Sidebar zu impelemtieren muss folgendes vorgehen eingehalten werden:
1. Es wir eine Variable als Actions deklariert und wird und die Sidebar Funtkion wird dem Layout angehängt.

var sidebar = elements.Person.Add.Sidebar()

1.1. Anschliessend wir der Sidebar eine Aktion angehängt und über die Add.Action methode die entprechende Aktion aufgerufen.

var actions = sidebar.Add.Actions();
actions.Add.Action(metadata.Person.LowerCaseNameDetailAction);