Modul Form

Das Modul Form

Im Modul Form werden die Routinen zur zur Formulargestaltung zusammengefasst.

Tree

Der Tree ist eine Baumansicht, in welcher die einzelnen Einträge hierarchisch gegliedert werden können.

Die Einträge können aus Tabelleninhalten und SQL-Statements gefüllt werden, es können auch einzelne Einträge hinzugefügt werden. Der Baum muss nicht von Anfang an komplett aufgebaut werden, sondern es können Inhalte beim Öffnen eines Eintrags dynamisch nachgeladen werden.

Der gängigste Weg, einen Baum zu füllen, ist #tree_fillsql. Siehe Beispiel dort.

#tree_clear

Macht den Tree leer. Wird üblicherweise eingesetzt, bevor der Baum (neu) gefüllt wird.

Parameter

(keine)

Beispiel

#tree_clear

#tree_add

Für dem Baum einen einzelnen Eintrag hinzu.

Parameter

• c ("caption") - die Beschriftung des Eintrags
• c1, c2 ("caption") - die Feldnamen in der Datenmenge, aus welcher die erste und zweite Beschriftung geladen werden
• ld1, ld2, ls1, ls2 - sind die Feldnamen in der Datenmenge Schlüsselwerte für Nachschlagelisten, so können für die Beschriftung die Klartexte genutzt werden. Dazu muss die Nachschlageliste (ld1, ld2) beziehungsweise das Special (ls1, ls2) angegeben werden.
• k ("key") - das Schlüsselfeld für den Eintrag; wird dieser Parameter nicht gesetzt, dann wird das Schlüsselfeld aus dem Namen der Tabelle abgeleitet.
• ne ("node expand") - der neue Eintrag soll gleich expandiert werden.
• o ("open") - Kommando, das ausgeführt wird, wenn der Eintrag expandiert wird; üblicherweise werden dabei Bauminhalte dynamisch nachgeladen.
• r ("rights") - Rechtedefinition für den Eintrag
• s ("select") - Kommando, das ausgeführt wird, wenn der Eintrag selektiert wird; üblicherweise wird dabei eine neue Seite geladen.
• si ("select item") - der neue Eintrag soll nach Abschluss des Kommandos selektiert werden
• sii ("select item instantly") - der neue Eintrag soll sofort und nicht erst nach Abschluss des Kommandos selektiert werden
• t ("table") - der Tabellenname der für den Eintrag maßgeblichen Tabelle
• u - Übergeordneter Eintrag. Unter diesem Eintrag wird der neue Eintrag eingefügt.
  • exp ("expanded") - der Eintrag, der gerade expandiert wird.
  • last - der zuletzt eingefügte Eintrag
  • lastp ("last parent") - der übergeordnete Eintrag über dem zuletzt eingefügten Eintrag
  • lastpp - der Eintrag zwei Stufen in der Hierarchie über dem zuletzt eingefügten Eintrag
  • lastppp - der Eintrag drei Stufen in der Hierarchie über dem zuletzt eingefügten Eintrag
  • root - der neue Eintrag wird auf der obersten Stufe eingefügt.
  • sel ("selected") - der aktuell selektierte Eintrag
  • selp ("selected parent") - der übergeordnete Eintrag des aktuell selektierten Eintrags
  • selpp - der Eintrag zwei Stufen in der Hierarchie über dem aktuell selektierten Eintrag
  • selppp - der Eintrag drei Stufen in der Hierarchie über dem aktuell selektierten Eintrag

Beispiele

#addtree   u=root   c=$T(change_passwort)   s="#page_fill   d=xsettings_page_password"
#addtree   u=root   c=$T(Set_language)   s="#page_fill   d=xsettings_page_language"

#addtree  u=sel   c=$T(new_list)   t=data_list    s="#page_fill  d=xlookup_page_list"   si=Y    f_category=$FND(category)

#tree_fill

Füllt den Baum aus den Werten einer Datenbanktabelle.

Mit Hilfe der Parameter qw und qo kann das Ergebnis gefiltert und sortiert werden, es ist aber stets nur eine Ebene im Baum. Sollen mehrere Ebenen im Baum gefüllt werden, so ist die Prozedur #tree_fillsql das Mittel der Wahl.

Üblicherweise wird das SQL-Statement aus den Parameters t, qw und qo zusammengesetzt. Dabei sind die Parameter qw und qo optional. Fehlen Sie, lautet das SQL-Statement SELECT * FROM tabllenname.

Alternativ kann auch mit #sql das Statement vorgegeben werden (zum Beispiel, wenn ein JOIN gebraucht wird).

Parameter

• c ("caption") - die Beschriftung des Eintrags
• c1, c2 ("caption") - die Feldnamen in der Datenmenge, aus welcher die erste und zweite Beschriftung geladen werden
• fi ("first item") - Wenn Y, wird nach dem Füllen des Baums der erste Eintrag selektiert. Default N, Funktionen werden ersetzt.
• ld1, ld2, ls1, ls2 - sind die Feldnamen in der Datenmenge Schlüsselwerte für Nachschlagelisten, so können für die Beschriftung die Klartexte genutzt werden. Dazu muss die Nachschlageliste (ld1, ld2) beziehungsweise das Special (ls1, ls2) angegeben werden.
• k ("key") - das Schlüsselfeld für den Eintrag; wird dieser Parameter nicht gesetzt, dann wird das Schlüsselfeld aus dem Namen der Tabelle abgeleitet.
• m ("max") - Maximale Anzahl der Baumeinträge, die erstellt werden
• ne ("node expand") - der neue Eintrag soll gleich expandiert werden.
• o ("open") - Kommando, das ausgeführt wird, wenn der Eintrag expandiert wird; üblicherweise werden dabei Bauminhalte dynamisch nachgeladen.
• qw ("query where") - WHERE-Klausel für das zu erstellende SQL-Statement
• qo ("query order") - ORDER-Klausel für das zu erstellende SQL-Statement
• r ("rights") - Rechtedefinition für den Eintrag
• s ("select") - Kommando, das ausgeführt wird, wenn der Eintrag selektiert wird; üblicherweise wird dabei eine neue Seite geladen.
• si ("select item") - der neue Eintrag soll nach Abschluss des Kommandos selektiert werden
• sii ("select item instantly") - der neue Eintrag soll sofort und nicht erst nach Abschluss des Kommandos selektiert werden
• t ("table") - der Tabellenname der für den Eintrag maßgeblichen Tabelle
• u - Übergeordneter Eintrag. Unter diesem Eintrag wird der neue Eintrag eingefügt.
  • exp ("expanded") - der Eintrag, der gerade expandiert wird.
  • last - der zuletzt eingefügte Eintrag
  • lastp ("last parent") - der übergeordnete Eintrag über dem zuletzt eingefügten Eintrag
  • lastpp - der Eintrag zwei Stufen in der Hierarchie über dem zuletzt eingefügten Eintrag
  • lastppp - der Eintrag drei Stufen in der Hierarchie über dem zuletzt eingefügten Eintrag
  • root - der neue Eintrag wird auf der obersten Stufe eingefügt.
  • sel ("selected") - der aktuell selektierte Eintrag
  • selp ("selected parent") - der übergeordnete Eintrag des aktuell selektierten Eintrags
  • selpp - der Eintrag zwei Stufen in der Hierarchie über dem aktuell selektierten Eintrag
  • selppp - der Eintrag drei Stufen in der Hierarchie über dem aktuell selektierten Eintrag

Beispiel

#filltree  u=exp   t=test_test   c1=zahl  c2=test_1

#tree_sel

Selektiert einen Eintrag.

Bei den Typen rf, sf, rfa und sfa wird im Baum nach einem bestimmten Wert (oder zwei bestimmten Werten) durchsucht. An jedem Eintrag hängt eine Ini-Datei, in der verschiedene Werte gespeichert sind. Es wird dann der erste Eintrag selektiert, in dessen Ini-Feld f der Wert z steht. Die Groß- und Kleinschreibung wird dabei ignoriert.

Neben f und z können auch noch f2 und z2 gesetzt werden. Bei rf und sf sind diese beiden Suchkriterien (f/z und f2/z2 oder-verknüpft). Die Typen rf und sf werden auch bei nur einem Suchkriterium verwendet, da bei einer oder-Verknüpfung das Ergebnis und damit die Existenz eines zweiten Suchkriteriums egal ist. Mit rfa und sfa werden die Suchkriterien und-verknüpft.

Parameter

• cnd ("condition") - nur wenn true, wir die Anweisung ausgeführt. Default true, Funktionen werden ersetzt.
• f, f2 ("field") - der erste und zweite Feldname (nur für die Typen rf, sf, rfa und sfa)
• o ("open") - expandiert den nach der Selektierung selektierten Eintrag
• y - Typ der Prozedur
  • c ("child") - geht zum ersten untergeordneten Eintrag
  • cc ("childchild") - geht zum ersten untergeordneten Eintrag des ersten untergeordneten Eintrags
  • ccc - geht in der Hierarchie drei Stufen nach unten
  • cccc - geht in der Hierarchie vier Stufen nach unten
  • ccccc - geht in der Hierarchie fünf Stufen nach unten
  • p ("parent") - geht zum direkt übergeordneten Eintrag
  • pp ("parentparent") - geht zum übergeordneten Eintrag des übergeordneten Eintrags
  • ppp - geht in der Hierarchie drei Stufen nach oben
  • pppp - geht in der Hierarchie vier Stufen nach oben
  • ppppp - geht in der Hierarchie fünf Stufen nach oben
  • rf ("rootfind") - Sucht im kompletten Baum, die Suchkriterien sind oder-verknüpft
  • rfa ("rootfindand") - Sucht im kompletten Baum, die Suchkriterien sind und-verknüpft
  • sf ("selectedfind") - Sucht unterhalb des selektierten Eintrags, die Suchkriterien sind oder-verknüpft
  • sfa ("selectedfindand") - Sucht unterhalb des selektierten Eintrags, die Suchkriterien sind und-verknüpft
• z, z2 - der erste und zweite Wert (nur für die Typen rf, sf, rfa und sfa)

Beispiel

#btn  c=test  w=120  s="#tree_sel  y=sf   f=data_list_id   z=7B0EC22C-8526-4FDB-8D10-0187ECF793C0   sic=Y"  se=b

#cmdclear
#cmd #tree_sel   y=c   o=Y
#cmd #tree_sel   y=c
#segbuttons  
#segbutton  c=Test  w=150   cmd=1

Im zweiten Beispiel soll in der Hierarchie zwei Stufen nach unten gegangen werden. Eigentlich würde das mit dem Typ cc gehen. Allerdings wird die unterste Ebene hier dynamisch nachgeladen, so dass eine Suche mit dem Typ cc ins Leere laufen würde. Die Lösung ist, zunächst mit dem Typ c eine Stufe nach unten zu gehen, dabei mit o=Y den Node zu expandieren und dabei dynamisch nachzuladen und dann mit dem Typ c eine weitere Stufe nach unten zu gehen.

#tree_back

Geht in die Baum-Historie einen Schritt zurück, also zum davor selektierten Eintrag.

Parameter

(keine)

Beispiel

#btn  y=back   s=#tree_back  se=b
#btn  y=fwd   s=#tree_fwd  se=b

#tree_fwd

Geht in die Baum-Historie einen Schritt weiter. Kann zur aufgerufen werden, wenn zuvor zurück gegangen wurde.

Parameter

(keine)

Beispiel

#btn  y=back   s=#tree_back  se=b
#btn  y=fwd   s=#tree_fwd  se=b