CAATS Benutzerhandbuch

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
===== Formular mit Bestätigungsdialog =====

Um unter bestimmten Bedingungen beim Speichern eines ausgefüllten Assessments/Formulars eine Bestätigungsabfrage im Sinne einer 
"Sind Sie sicher?"-Frage anzuzeigen, sind folgende Arbeiten erforderlich:
  - Definieren Sie Kriterien, bei deren Eintreffen die Bestätigung angefordert werden soll
  - Definieren Sie Antwortmöglichkeiten
  - Schreiben Sie ein Plugin des Typs "Erweiterung", in dem Sie die ''OnBeforeUpdate()'' Funktion überschreiben
  - Prüfen Sie den Eintritt der Kriterien aus (1) und rufen Sie dann die Funktion ''ResponseMsg.PromptForConfirmation()'' auf [[:extensibility:assessments:confirmation:example | (Beispielcode!)]] um den Dialog anzeigen zu lassen
  - Prüfen Sie außerdem mittels einer Fallunterscheidung, ob der ''OnBeforeUpdate()''-Aufruf bereits ein Folgeversuch des Anwenders ist, wo er/sie schon eine Option zur Bestätigung gewählt hat, indem Sie ''IsConfirmationPromptAnswered()'' aufrufen und den von der Funktion ''ConfirmationPromptAnswer()'' zurückgelieferten Wert interpretieren.

[[:extensibility:assessments:confirmation:example | Beispielcode für das Plugin ]]

Der oben angeführte Beispielcode für das Plugin erzeugt den folgenden Bestätigungsdialog: 

|{{ :extensibility:assessments:confirmation_dialog.png?nolink&400 |}}|

Im Prompt-Text wird HTML unterstützt, dadurch kann ein Dialog gestaltet und ganz einfach angepasst werden. Auch die Anzahl und Bedeutung der Antwortmöglichkeiten (hier in Form von Buttons) ist konfigurierbar: 

|{{ :extensibility:assessments:confirmation_dialog_fix.png?nolink&400 |}}|

Zusätzlich können einfache Grafiken in Form von base64-codierten Bildern eingebettet werden
|{{ :extensibility:assessments:confirmation_dialog_with_img.png?nolink&400 |}}|