Zusammensetzung des Parameter-Array $modul_param

 Den Funktionen 'modul_tabelle' bzw. 'modul_tabelle_list'' werden alle notwendigen Informationen im Array $modul_param übergeben. Die Bestandteile des Array sind in Tabelle aufgeführt. Die meisten Bestandteile sind selbst wieder Arrays:

 

english Schlüssel german english Beschreibung german

english tabellenid german english ID des Submoduls (mandatory) german

english leittabelle german english Name der DB-Relation, auf die zugegriffen werden soll (mandatory) german

english required_attribs german english Array mit Attribut-Werte-Paaren, nach denen bei allen Anfragen selektiert werden soll. german

english anzeige german english Array mit Parametern für die Haupttabelle german

english aendern german english Array mit Parametern für die Ändern-Tabelle german

english loeschen german english Array mit Parametern für die Löschen-Tabelle german

english neues_tupel german english Array mit Parametern für das Formular zum Erstellen eines neuen Tupels german

english reihenfolge german english Array, in dem die Ausgabereihenfolge der Haupttabelle, der Ändern-Tabelle, der Löschen-Tabelle und dem Formular für das neue Tupel verändert werden kann. german

• required_attribs: Dieses Array ist nach den Attributnamen indiziert. Es bietet sich beispielsweise an die Vorlesungsnummer auf diese Weise fest vorzugeben. Für eine Vorlesung mit der Nummer 10 könnte man folgende Vorgabe machen: required_attribs = array (vorlesungnummer => 10). Somit ist sichergestellt, dass sich alle DB-Anfragen auf die richtige Vorlesung beziehen. In Zusammenhang mit dem Eintrag 'anzeige [appearance] [nur_bei_link_aktion]]' (siehe ) kann als Wert für ein Attribut auch folgendes Konstrukt verwendet werden: required_attribs = array (eigenesfeld => 'LINK:tabellenid.fremdfeld'). Auf diese Weise hat man die Möglichkeit auf den Wert (des Feldes <fremdfeld>) eines anderen DB-Table-Submoduls (durch tabellenid referenziert) zuzugreifen. Dies ist aber nur möglich, wenn der Benutzer in jenem Submodul die Aktion 'aendern' oder 'loeschen' (siehe ) ausgelöst hat.
• anzeige, aendern, loeschen, neues_tupel: Die Parameter von anzeige beziehen sich auf die Haupttabelle. Änderungen und Löschungen können direkt in der Haupttabelle durchgeführt werden. Es ist jedoch auch möglich für diese Aktionen zunächst eine zusätzliche Tabelle aufzubauen. In dieser Zwischentabelle können weitere Attribute angezeigt werden, die in der Haupttabelle aus Gründen der Übersichtlichkeit ausgeblendet wurden. Beim Ändern eines Datentupels könnten in der Zwischentabelle zusätzliche Attribute zum Ändern angeboten werden. Beim Löschen kann die Zwischentabelle als Sicherheitsabfrage verstanden werden. Für das Erzeugen eines neuen Tupels wird ein Formular aufgebaut, in das die neuen Daten eingegeben werden können. Die vier Arrays benutzen im Wesentlichen alle die selben Parameter.
• reihenfolge: Standardmäßig werden die Zwischentabellen für das Ändern und Löschen bzw. das Formular zum Erzeugen eines neuen Tupels vor der Haupttabelle ausgegeben. Mit Hilfe dieses Arrays kann die Reihenfolge beeinflusst werden. Beispielsweise würde $reihenfolge = array (neues_tupel, anzeige, aendern, loeschen) bewirken, dass nur das Formular für ein neues Tupel vor der Haupttabelle (anzeige) ausgegeben wird. Die Zwischentabellen zum Ändern und Löschen werden hingegen nach der Haupttabelle ausgegeben.

Schon alleine mit den Einträgen für tabellenid und leittabelle lässt sich ein Aufruf der Funktion 'modul_tabelle' durchführen. Da sich ein Workflow in der Regel auf nur eine Veranstaltung bezieht, ist es empfehlenswert mit dem Eintrag required_attribs eine entsprechende Einschränkung vorzunehmen. Das folgende Beispiel erzeugt eine Tabelle mit allen Übungsgruppen zur Vorlesung mit der Vorlesungsnummer 10:

• []$modul_param = array (

    tabellenid => ``uebungsgruppe'',

    leittabelle => ``uebungsgruppe'',

    required_attribs => array(

      vorlesungnummer => 10

    )

  ); 
  

  modul_tabelle_list($modul_param);