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:

Methode	Beschreibung
`Body<Person, PersonService>((person, service) => service.Execute(person))`	Der `PersonService` wird über den IoC ausgelöst und die Aktion `Execute` mit der aktuellen Person ausgeführt.
`Body<PersonService>((personService) => personService.Execute)`	Direkte Zuweisung eines Delegate. Die Signatur der Methode muss dabei einen Parameter vom Typ `IDataObject` oder einer Ableitung davon zur Verfügung stellen.
`Body<Person, PersonService>()`	Der `PersonService` muss das Interface `IActionAware<in IDataObject>` implementieren. Der `PersonService` selbst wird über den IoC aufgelöst.

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.

Rückgabetyp	Beschreibung
`MetaActionResult.None()`	Keine Änderungen. Die Daten im Client werden nicht neu geladen.
`MetaActionResult.CallingObjectChanged()`	Das aufgerufene Objekt muss neu geladen werden.
`MetaActionResult.MultipleObjectsChanged()`	Das aufgerufene und alle verlinkten Objekte müssen neu geladen werden.

Als optionaler Parameter kann bei allen Methoden folgendes definiert werden:

Parameter

Beschreibung

FeedbackType

Kann definieren ob die Aktion erfolgreich war:

None (keine Meldung wird angezeigt)
Success
Warning
Error

DynamicString

Meldung die dem Benutzer angezeigt wird.

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.

Methode	Beschreibung
`Body<Person, Contact, PersonService>((person, contact, service) => service.Execute(person, contact))`	Der `PersonService` wird über den IoC ausgelöst und die Aktion `Execute` mit der aktuellen Person ausgeführt.
`Body<PersonService>((personService) => personService.Execute)`	Direkte Zuweisung eines Delegate. Die Signatur der Methode muss dabei einen Parameter vom Typ `IDataObject` und des entsprechenden Parameter enthalten oder einer Ableitung davon zur Verfügung stellen.
`Body<Person, Contact, PersonService>()`	Der `PersonService` muss das Interface `IActionAware<in TDataObject, TParameter>` implementieren. Der `PersonService` selbst wird über den IoC aufgelöst.

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);