Aufruf und Darstellung einer Extrapage

 Jeder Workflow kann zusätzlich zu den Workflow-Schritten, bei denen durch ihre Abhängigkeiten untereinander geregelt wird, wann sie bearbeitbar bzw. als 'erledigt' kennzeichenbar sind, sogenannte Extrapages enthalten. Diese haben keinerlei Abhängigkeiten und können zu jeder Zeit im Workflow ausgeführt bzw. angezeigt werden. Anwendung finden sie z.B. bei der Bearbeitung von Stammdaten wie Studenten, Mitarbeitern und Räumen.

Jede solche Extrapage kann dabei wie Workflow-Schritt aus einem oder mehreren Modulen bestehen. Hierbei sind jedoch nur Module vom Typ ``normal'' zugelassen. Die Definition von Extrapages, sowie ihre Module und deren Parameter wird in eigenen Datenbank-Relationen - getrennt von den Daten der Workflow-Schritte - festgelegt (siehe Relationen 'workflow_extrapage', 'workflow_extrapage_modul' und 'workflow_extrapage_modul_param'). Um in einem Modul zwischen einem Aufruf innerhalb eines Workflow-Schrittes und eines Aufrufes innerhalb einer Exrapage zu unterscheiden, wird in $control_args der Parameter 'isextrapage' auf 'true' gesetzt.

Um eine Extrapage aufzurufen wird im Array $param der Parameter 'action' statt ``Workflow'' auf ``Extrapage'' bzw. ``Extrapage-alone'' gesetzt. ``Extrapage-alone'' unterscheidet sich dabei von ``Extrapage'' nur dadurch, dass keine Navigations-Verweise zur Übersichtsseite des Workflows angezeigt werden. Dies ist sinnvoll, falls die Extrapages eines Workflows von außerhalb des Workflows - praktisch unabhängig vom Workflow selbst - aufgerufen werden sollen. Insbesondere könnte ein Dummy-Workflow in der Datenbank angelegt werden, der nur Extrapages zur Verwaltung der Stammdaten und keine echten Workflow-Schritte enthält.

Die Nummer der Extrapage ist im Parameter 'extrapage_nr' im Array $param enthalten (ähnlich wie 'wf_step_nr' bei 'action'=''Workflow''). Ebenso existiert ein Parameter 'extrapage_position', der als mögliche Werte ``Main'' oder ``Modulpage'' hat (ähnlich wie 'wf_step_position' bei 'action'=''Workflow'').

Hat dieser Parameter den Wert ``Main'', so wird ein minimaler HTML-Rahmen vor Aufruf der Extrapage-Module ausgegeben. Dieser enthält z.B. den Namen der Extrapage sowie Verweise zu den anderen Extrapages und ggf. einen Verweis zum top-Schritt des Workflows. Jedes Modul der Extrapage wird dann mit Modulfunktion ``main'' aufgerufen, wobei das Array $control_args folgendes Aussehen hat:

• [isextrapage:]boolsches Flag, hier stets gleich 'true', zeigt an, dass das Modul in einer Extrapage aufgerufen wird
• [step_nr:]Nummer der Extrapage, d.h. der Wert von $param[extrapage_nr]
• [step_name:]Name der Extrapage, d.h. das Attribut 'name' aus der Relation 'workflow_extrapage'

Bei $param[extrapage_position]=``Modulpage'' wird ähnlich wie bei $param[action]=''Workflow'' einer gegebenen Modulfunktion eines bestimmten Moduls der Extrapage ermöglicht die gesamte HTML-Ausgabe zu erzeugen. Die Modulnummer und die Modulfunktion werden hier durch die Parameter 'extrapage_modul_nr' und 'extrapage_module_funktion' aus $param (analog 'wf_module_nr' und 'wf_module_funktion' bei 'action'=''Workflow'') bestimmt. Das einzeln aufgerufene Modul erhält in $control_args die gleichen Parameter wie bei $param[wf_step_position]=''Main'' (siehe oben).