DOCLimbasForms

Aus Limbas Wiki

Wechseln zu: Navigation, Suche

Admin->Formulare → zurück zu LIMBAS Admin

Inhaltsverzeichnis

Einführung

LIMBAS Formulare stellen die zuvor angelegten Tabellen grafisch dar und erlauben die Tabellenfelder zu füllen oder zu ändern. In LIMBAS gibt es Standardformulare und benutzerdefinierte Formulare. Beide Arten haben gewisse Vor- und Nachteile je nach Anwendungszweck.

Standardformulare

Für jede angelegte Tabelle existiert ein Standardformular, das von LIMBAS dynamisch generiert wird. Damit ist es ohne Erstellung eines individuellen Formulars möglich, mit den Tabelleninhalten zu arbeiten. Ein großer Vorteil des Standardformulars ist, dass ein neu erstelltes Tabellenfeld sofort im Formular verfügbar ist.

Grundsätzlich werden alle Felder untereinander angezeigt. Felder können sortiert und gruppiert werden, wobei Gruppierungen durch Reiter oder Überschriften dargestellt werden. Zusätzlich hat man die Möglichkeit Felder nebeneinander oder in Untergruppen zu legen. Alle diese Einstellungen werden direkt bei der Tabellendefinition, wo auch die Felder hinzugefügt werden, vorgenommen. Weitergehende Gestaltungsmöglichkeiten sind nur über das LIMBAS-Layout möglich.

Benutzerdefinierte Formulare

Eine zweite Möglichkeit bietet LIMBAS über seinen Formulareditor. Dieser ermöglicht es sehr komfortabel, eigene individuelle Formulare zu erstellen. Es können beliebig viele Formulare für eine Tabelle erzeugt werden. Änderungen bei der Tabellendefinition müssen allerdings selbst in die Formulare eingepflegt werden. Das bedeutet, dass neue Felder von den Formularen nicht automatisch übernommen werden, sondern je nach Wunsch einzeln hinzugefügt werden müssen.

Formulareditor

Beim Aufruf des Formulareditors erscheint eine nach Tabellen sortierte Auflistung der vorhandenen Formulare mit der Möglichkeit weitere Formulare hinzuzufügen.

  • ID: Eindeutige Identifikation für das Formular. Beim Hinzufügen eines neuen Formulars wird diese ID von LIMBAS selbst gesetzt.
  • Durch Mausklick auf das Editier-Symbol läßt sich das entsprechende Formular bearbeiten, vorausgesetzt es ist nicht in PHP als Erweiterung implementiert.
  • löschen: Durch Mausklick auf das Papierkorb-Symbol wird das entsprechende Formular nach Rückfrage gelöscht.
  • Formular: Name des Formulars
  • erstellt von: Name des Benutzers, der das Formular erstellt hat.
  • für Tabelle: Tabelle, die mit dem Formular bearbeitet werden kann.
  • Erweiterung: Name der Datei, in welcher das Formular implementiert ist (nur wenn das Formular als PHP-Datei erstellt ist).

Formular hinzufügen

  • Name: siehe oben "Formular"
  • Tabelle: siehe oben "für Tabelle"
  • kopieren: Name eines bereits vorhandenen Formulars, dessen Formularelemente im neuen Formular übernommen werden.
  • Vorwahl: Diese Beschreibung berücksichtigt vorerst nur die Einstellung "Entwurf einspaltig". Bei "Entwurf Liste" gibt es Abweichungen bei der Werkzeugleiste des Formulareditors als auch bei den Formularelement-Typen.
  • Erweiterung: Name einer PHP-Datei ./dependent/EXTENSIONS/*.ext, in welcher das neue Formular implementiert ist

Bei Mausklick auf den Button "neues Formular" wird das neue Formular in die Auflistung der Formulare mit aufgenommen und kann bearbeitet werden.

Formular bearbeiten

Auf der linken Seite des Formulareditors befindet sich die jeweils aktuelle Formularansicht. Ein gerade neu angelegtes Formular ist hier noch leer.

Auf der rechten Seite des Formulareditors befindet sich die Werkzeugleiste mit folgender Unterteilung:

  • Name des Formulars und der Tabelle, die mit dem Formular bearbeitet werden soll
  • Koordinaten, Breite und Höhe des selektierten Formularelements
  • Globale Formulareinstellungen:
    • Class: Ist eine CSS-Stylesheets-Datei (aus dem Pfad ./dependent/EXTENSIONS/css) ausgewählt, so wird diese im Formular mit eingebunden und kann für die Formatierung der Formularelemente herangezogen werden (siehe Class).
    • Zeichensatz: Der hier eingestellte Zeichensatz und die hier eingestellte Zeichengröße werden als Voreinstellung für Formularelemente, die Text beinhalten und dem Formular neu hinzugefügt werden, verwendet.
    • Proportionen erhalten: Ist diese Eigenschaft gesetzt, so können Höhe und Breite des selektierten Formularelements nur so geändert werden, dass dabei die Proportionen erhalten bleiben. Ansonsten können Höhe und Breite des selektierten Formularelements auch unabhängig voneinander geändert werden.
    • Z-Index berücksichtigen: siehe zIndex
    • Z-Index erneuern: siehe zIndex
  • Buttons zum Hinzufügen von Formularelementen: Wird der Mauszeiger für kurze Zeit auf einem Button belassen, so wird die Funktionalität des Formularelements eingeblendet.
  • Button "übernehmen" zum Speichern des Formulars
  • Tabelle mit Auflistung der verwendeten Formularelementen: Die Tabelle zeigt für jedes im Formular verwendete Formularelement
    • den zIndex-Wert (siehe zIndex)
    • den Typ des Formularelements
    • einen Hinweis auf den Inhalt des Formularelements

Hinzufügen eines Formularelements

Bei Mausklick auf einen Button zum Hinzufügen eines Formularelements wird ein entsprechendes Element in der Ansicht in der oberen linken Ecke hinzugefügt, und zwar mit den für das jeweilige Element gültigen Default-Eigenschaften. Die Eigenschaften eines Formularelements sind Typ-abhängig und lassen sich wie unten (Einstellen/Ändern der Eigenschaften eines Formularelements) beschrieben ändern.

Soll sich ein Element innerhalb eines anderen Elements befinden (z.B. ein Text-Eingabefeld innerhalb eines Tabulators), so muß zuerst das äußere Formularelement angelegt werden. Vor dem Hinzufügen des inneren Formularelements muß das äußere Formularelement selektiert sein. Das innere Formularelement wird dann in der oberen linken Ecke des äußeren Elements plaziert.

Die folgenden Elemente werden vom LIMBAS Formulareditor zur Platzierung auf einem benutzerdefinierten Formular angeboten:

  • Textblock
freier Text
  • Dateninhalte
Bei Mausklick auf den Button für "Dateninhalte" wird in der Werkzeugleiste unterhalb der Buttons ein Baum der Tabellenfelder eingeblendet. Erst bei Mausklick auf eines dieser Tabellenfelder wird das Formularelement in der Formularansicht hinzugefügt. Verknüpfte Tabellen können aufgeklappt und deren Felder ebenfalls ausgewählt werden. Zu beachten ist das Verknüpfte Felder nur dann Sinn machen wenn sie nicht mehr als 1 Datensatz beinhalten. Eine Datensatzliste für mehrere verknüpfte Datensätze kann über das Verknüpfungsfeld selbst hinzugefügt werden. Dadurch wird eine Tabelle im vorgegeben Rahmen dargestellt.
  • Datenbezeichnung
Bei Mausklick auf den Button für "Datenbezeichnung" wird in der Werkzeugleiste unterhalb der Buttons ein Baum der Tabellenfelder eingeblendet. Erst bei Mausklick auf eines dieser Tabellenfelder wird das Formularelement in der Formularansicht hinzugefügt.
  • Graphik
Bei Mausklick auf den Button für "Graphik" wird in der Werkzeugleiste unterhalb der Buttons ein Feld zur Eingabe einer Datei mit Pfad eingeblendet. Ist ein gültige Grafik-Datei eingetragen, so wird diese bei Mausklick auf "übernehmen" in der Formularansicht hinzugefügt.
  • Unterformular
Bei Mausklick auf den Button für "Unterformular" wird in der Werkzeugleiste unterhalb der Buttons eine Formularauswahl eingeblendet. Bei Mausklick auf "Übernehmen" wird das gewählte Unterformular in der Formularansicht hinzugefügt.
  • Tabelle
Mit diesem Element kann eine html-Tabelle hinzugefügt werden. Spalten und Zeilen können frei definiert werden. Elemente werden durch Klick auf die gewünschte Zelle und dann auf das Element in die Tabelle eingefügt. Hinzugefügt oder gelöscht werden Zeilen immer nach der aktuell selektierten Zeile.
  • Datum
aktuelles Datum
  • Rechteck
Rechteck zur Layoutgestaltung
  • Menü-Leiste Gruppiert
Mit Hilfe dieses Rahmens können Elemente Gruppiert werden. Sparten werden automatisch als Reiter angelegt.
  • Tabulator-Rahmen
Mit Hilfe dieses Rahmens können ebenfalls Elemente Gruppiert werden. Tabulatoren können aber individuell definiert werden. Tabulatoren können links oder oben positioniert werden
  • Gruppierungs-Rahmen
Einfachster Gruppierungsramen ohne Tabulatoren. Dient zur schnellen Gruppierung von Elementen.
  • Submit-Button
sendet das Formular
  • Scroll-Leiste zum Blättern der Datensätze
Einzelne Fußleiste zum Weiterblättern
  • Text-Eingabefeld
eigenes Formularelement.
  • Textarea-Eingabefeld
eigenes Formularelement.
  • Select-Auswahlfeld
eigenes Formularelement.
  • Checkbox-Element
eigenes Formularelement.
  • Radio-Element
eigenes Formularelement.
  • hidden
eigenes Formularelement.
  • Java-Script
freies Javascript für eigenen Erweiterungen.
  • PHP-Script
freies PHP für eigenen Erweiterungen. Auch include() oder Funktionsaufrufe möglich.

Selektieren eines Formularelements

Es kann immer nur ein Formularelement selektiert sein. Dieses erkennt man daran, dass es

  • in der Tabelle mit den aktuell verwendeten Formularelementen farblich hervorgehoben ist
  • in der Formularansicht an der unteren rechten Ecke ein Symbol zum auf/zusammenziehen hat

Das Selektieren eines Formularelements ist somit möglich durch

  • Mausklick auf den enstprechenden Eintrag in der Tabelle mit den aktuell verwendeten Formularelementen
  • Mausklick auf das entsprechende Element in der Formularansicht

Einstellen/Ändern der Eigenschaften eines Formularelements

Voraussetzung für das Einstellen/Ändern der Eigenschaften eines Formularelements ist, dass dieses selektiert ist.

  • Die Position läßt sich per Drag&Drop in der Formularansicht oder durch Eingabe der Koordinaten in der Werkzeugleiste ändern. Dabei entspricht X=0, Y=0 der oberen linken Ecke des Formulars. Handelt es sich um ein inneres Formularelement, so entspricht X=0, Y=0 der oberen linken Ecke des äußeren Formularelements.
  • Die Höhe und Breite läßt sich durch auf/zusammenziehen in der Formularansicht oder durch Eingabe entsprechender Werte (in Pixel) in der Werkzeugleiste ändern.


Beim Selektieren des Formularelements öffnet sich ein Kontext-Menü, welches die Einstellung weiterer Eigenschaften ermöglicht:

Folgende Menüpunkte/Anzeigen befinden sich bei allen Formularelementen im Kontext-Menü:

  • Die Element-Nr. ist eine eindeutige Identifikation (positive ganze Zahl) für das Formularelement. Beim Hinzufügen eines neuen Formularelements wird diese nicht änderbare ID von LIMBAS selbst gesetzt.
  • Der zIndex-Wert
    • bestimmt bei sich überlappenden Formularelementen, welches Element im Vorder- bzw. Hintergrund dargestellt wird: Dabei gilt, dass ein Element mit höherem zIndex-Wert sich vor einem Element mit niedrigeren zIndex-Wert befindet. Bei identischen Werten ist es dem Zufall überlassen, welches Element im Vorder- bzw Hintergrund gezeigt wird.
    • wird durch die Menüpunkte in den Vordergrund bzw. in den Hintergrund entsprechend verändert.
    • bestimmt, in welcher Reihenfolge Eingabefelder bei Benutzung des Formulars durch die Tabulator-Taste selektiert werden.
    • wird bei gesetzter globaler Formulareinstellung Z-Index berücksichtigen beim Selektieren eines Formularelements auf den im Formular aktuell höchsten Wert gesetzt: Hiermit läßt sich schnell die Reihenfolge, in der Eingabefelder bei Benutzung des Formulars durch die Tabulator-Taste selektiert werden, festlegen.
    • wird durch Z-Index erneuern allen Formularelementen neu zugewiesen, und zwar so dass es keine Lücken bei den zIndex-Werten gibt. Die bisherige Reihenfolge wird beibehalten.
  • Bei löschen wird das Formularelement ohne weitere Rückfrage gelöscht.

Folgende Menüpunkte/Anzeigen/Einstellmöglichkeiten befinden sich abhängig vom Typ des Formularelements im Kontext-Menü:

  • Bei kopieren wird das Formularelement mit den eingestellten Eigenschaften kopiert.
  • Bei einigen Formularelementen kann auf die Ereignisse "OnClick", "OnDblClick", "OnChange", "OnMouseOver" und "OnMouseOut" mit mittels JavaScript definierten Aktionen reagiert werden.
  • Bei Formularelementen mit Text läßt sich der Font, die Größe, die Darstellung, die Fontfarbe und die Hintergrundfarbe des Textes einstellen.
  • Bei Formularelementen mit Rahmen läßt sich neben der Rahmenfarbe, der Art und der Dicke auch einstellen, welche Kanten (links, rechts, oben, unten) gerahmt werden.
    • Bei Formularelementen, die innerhalb des Rahmens Text oder Grafik zeigen, wird durch Form festgelegt, ob diese Informationen ggf. abgeschnitten werden, falls sie nicht genügend Platz haben, ob sie ggf. über den Rahmen hinaus sichtbar sein sollen, ob ein Scrollbar fest oder automatisch eingeblendet werden soll. Weiter gibt es eine Einstellung für den Mindest-Abstand vom Rahmen zum Text.
    • Bei Tabellen läßt sich mit Rand einstellen, ob der Rahmen der Tabelle ggf. mit dem Rahmen einzelner Tabellenelemente zusammen oder getrennt gezeigt werden soll.
  • Wenn bei den globalen Formulareinstellungen ein CSS-Datei ausgewählt ist, erscheint bei einigen Formularelementen ein zusätzlicher Menüpunkt Class. Wird hier eine CSS-Klasse ausgewählt, so werden für das Formularelement die Formatierungen dieser Klasse verwendet, es sei denn diese werden durch eine andere hier vorgenommene Einstellung überschrieben.
  • Bei Tabellen läßt sich die Anzahl der Spalten und Zeilen einstellen.
  • Das Tabulator-Element kann per neuer Tabulator mit zusätzlichen Tabulatoren erweitert werden.
  • Bei einigen Formularelementen läßt sich per Transp. ein Durchscheinen von anderen im Hintergrund liegenden Formularelementen einstellen.
  • Bei Formularelementen zur Eingabe von Text kann mittels maxlen die maximal zulässige Zeichenzahl eingestellt werden.
  • Beim Unterformular läßt sich in der Ansicht einstellen, ob im Unterformular Eingaben zulässig sind (bearbeiten) oder nicht (detail).
  • Parameter (Unterformular) (???)
  • Bei Menü-Leiste Gruppiert kann über den Parameter eingestellt werden, ob Verknüpfungsreiter, Menüleiste, Symbolleiste und/oder Fußleiste angezeigt/ausgeblendet werden sollen.
  • Auswahl (nur Tabellen) (???)
  • Bei Dateninhalt kann eingestellt werden, ob nur lesen oder auch ändern des Dateninhalts erlaubt ist.
  • Wird bei Dateninhalt das Häkchen für ersetzen gesetzt und sofort danach ein neues Dateninhalt-Formularelement, das mit einem anderen Tabellenelement verknüpft ist, erstellt, so wird das ursprüngliche Formularelement gelöscht und dem neuen werden die Eigenschaften des ursprünglichen zugewiesen. Diese Funktionalität kann zusammen mit der Kopier-Funktion das Plazieren mehrerer Dateninhalt-Formularelemente auf dem Formular erleichtern. Das Häkchen wird automatisch nach der folgenden Aktion gelöscht.
Von „http://www.limbas.org/Wiki/DOCLimbasForms“
Persönliche Werkzeuge
Werkzeuge
LANGUAGES