Liste der Attribute
Zu jedem Attribut ist die Liste der Elemente aufgeführt, in welchen dieses Attribut erlaubt ist. Da manche Attribute bei verschiedenen Elementen unterschiedliche Bedeutung haben, ist immer die Beschreibung beim Element maßgeblich. Falls ein Attribut ein Pflichtattribut ist, so wird es beim Element mit * markiert. Die hiesige Liste dient im wesentlichen als Querverweis.- sd:additional-columnsBeschreibung: Kann eine semikolongetrennte Liste von zusätzlichen Spalten enthalten. Ist nutzbar bei Spalten mit Relationen. Diese müssen per additional_Columns zusätzliche Spalten zurückliefern. Werden diese in diesem Attribut benannt, werden die Werte den options-Elementen als Attribute beigefügt. <option value='ZeilenId' Spaltenname='Spaltenwert'>Standardwert</option>
- sd:allow-first-disallow-editBeschreibung: Wenn dieses Attribut zwei durch '|' getrennte CSS-Klassen enthält, dann wird das Eingabefeld im Editiermodus zum Bearbeiten ausgegeben, falls die Spalte noch keinen Wert enthält. Zur Formatierung wird die erste CSS-Klasse genutzt. Enthält die Spalte (etwa bei einem späteren Aufruf) bereits einen Wert, dann ist die Bearbeitung gesperrt, die zweite CSS-Klasse wird zur Formatierung genutzt. Korrespondierend sollte ein sd:ro-value - Element der Form <sd:ro-value sd:for='Objekt' sd:col='Spalte' sd:std-value='^Spalte'/> in der Seite notiert werden. Das dem Spaltennamen vorgestellte '^' ermöglicht im Editiermodus diese Funktion und stellt sicher, daß auch bei einer manipulierten Rücksendung und einem bereits vorhandenen Altwert dieser beibehalten wird.
- sd:allow-multipleBeschreibung: Kann mit dem Wert 'true' belegt werden. Dann können bei AutoFiltern auch mehrere Ausdrücke per STRG-Taste zusammen ausgewählt werden. Der Wert 'true' setzt voraus, daß die Tabelle als 'allow-multiple' gekennzeichnet ist. In diesem Fall müssen gesonderte Zugriffsprozeduren generiert werden.
- sd:alternate-colBeschreibung: Ist dieses Attribut mit einem alternativen Spaltennamen belegt und liefert die -Spalte eine leere Zeichenfolge zurück, dann wird stattdessen der Wert der hier benannten Spalte ausgegeben. Dies ermöglicht eine Art -Ausgabe innerhalb von Ausgabeseiten. Das Attribut ist bsp. nützlich, wenn in einem Forum als neue ID die parent-ID des aktuellen Datensatzes übergeben werden soll. Fehlt diese - was nur für den ersten Threadeintrag der Fall ist -, so kann stattdessen die Zeilen-Id übergeben werden.
- sd:anchor-suffixBeschreibung: Dem Ankerelement kann zusätzlich ein zeilenabhängiger Wert, bsp. die Zeilennummer oder die ZeilenId (ROW_NUMBER bzw. ROW_ID) angehängt werden. Dieser Wert wird direkt an den Eintrag @sd:anchor angefügt. Nützlich bsp. in Unterformularen, falls die Auswahlliste mit sd:with-postback definiert ist und der Browser die aktuelle Zeile sofort anzeigen soll.
- sd:as-inputBeschreibung: Falls 'true', wird die Spalte nicht als Wert, sondern als Eingabefeld ausgegeben. Dies stellt die Umkehrung des sd:as-value-Attributes beim - Element dar und ist nützlich, falls in einer Ausgabetabelle einzelne Werte direkt bearbeitet und über einen Update-Button direkt gespeichert werden sollen.
- sd:as-pfilterBeschreibung: Kann mit dem Namen eines -Elements belegt werden. Ist das übergeordnete -Element als Autofilter markiert, dann wird dieses Eingabefeld als Pulldownliste ausgegeben. Nach dem Auswählen eines Elements wird der Befehl ausgeführt, der dem Klick auf das -Element entspricht. Damit lassen sich manuelle Suchen (bsp. eine Volltextsuche) mit Autofilter-Suchtechniken kombinieren.
- sd:as-radioBeschreibung: Falls für die aktuelle Spalte eine Relation definiert ist und dieses Attribut den Wert 'true' hat, werden die einzelnen Werte der Relation als ein Feld von Radio-Buttons eingefügt. Aus diesen wird zur Laufzeit ein Wert ausgewählt. Gegenüber Relationen sind hier alle Werte sofort sichtbar. Allerdings läßt sich so nur eine gewisse Zahl von Elementen übersichtlich ausgeben, ferner steht kein Blättern / Suchen zur Verfügung.
- sd:asterisk-optionsBeschreibung: Ermöglicht die Steuerung der Anzeige von Text- und Pflichtfeldhinweis (* = Asterisk). Der Standardwert ist 'both' - Text und Asterisk werden angezeigt. Die anderen Werte sind 'label', 'asterisk' und 'none'. Das Attribut ist nützlich, falls das Feld ein Pflichtfeld ist und das Asterisk beim Bearbeiten von Daten angezeigt werden soll, das eigentliche sd:label-Feld aber keine zusätzliche Beschriftung generieren soll.
- sd:cache-nameBeschreibung: Erwartet eine Zeichenfolge als Wert. Wenn der Wert mit einem '$' beginnt und wenn es einen gleichnamigen, unter diesem Namen gecachten Wert gibt, dann muß das -Attribut einen Spaltennamen enthalten. Falls der Wert dieser Spalte gleich dem gecachten Wert ist, wird das -Element ausgeführt.
- sd:cache-name-simpleBeschreibung: Erwartet eine Zeichenfolge als Wert. Wenn der Wert mit einem '$' beginnt und wenn es einen gleichnamigen, unter diesem Namen gecachten Wert gibt, dann muß das -Attribut einen einfachen Wert enthalten. Falls dieser Wert gleich dem gecachten Wert ist, wird das -Element ausgeführt.
- sd:cache-name-smallBeschreibung: Der Wert dieses Attributes wird ebenso als Cachename verwendet wie der Wert des -Attributes. Der Unterschied zwischen beiden Attributen besteht darin, daß die small-Version bei jedem Reset gelöscht wird. Die 'große Version' wird dagegen nur überschrieben, verschwindet am Ende einer Session oder kann mit einer Url der Form Parametername=explizit gelöscht werden.
- sd:checkBeschreibung: Dieses Attribut kann derzeit mit einem -Element derselben Seite belegt werden. Dann wird vor dem Speichern des Datensatzes in einer Transaktion geprüft, ob die Datenzeile einen freien Termin im Sinne dieses Kalenderelements nutzt oder ob dieser Termin bereits belegt ist. Die Kapselung in einer Transaktion stellt sicher, daß nur ein Nutzer diesen Termin speichern kann, auch wenn zwei verschiedene Nutzer dasselbe Kalenderelement aufrufen, sehen, daß der gewünschte Termin noch frei ist und praktisch gleichzeitig speichern.
- sd:check-cacheBeschreibung: Wenn dieses Attribut mit einem Namen belegt ist, unter dem es zur Laufzeit einen als ID interpretierbaren gecachten Wert gibt, wenn zusätzlich das sd:relation-Attribut mit dem Namen einer Relation bzw. einer durch '|' getrennten Liste von Relationen belegt ist und wenn schließlich auf der Ausgabeseite diese Relation ausgegeben werden, dann wird beim Aufruf geprüft, ob der gecachte Wert in der Pulldownliste mit angezeigt wird. Falls nein, wird die zur ID gehörende Datenzeile zusätzlich geladen und der Pulldown-Liste hinzugefügt. Ist das Eingabefeld mit der Relation nun durch ein sd:new-if-exists - Attribut mit dem Namen des Cache-Elements belegt, dann wird dieser Wert beim Neuerstellen eines Datensatzes zugewiesen. Dies entspricht der Nutzung des sd:new-if-exists - Attributes für Relationen. Falls diese bsp. alphabetisch ausgegeben wird und mehrere hundert Zeilen umfaßt, dann würde der Wert eines sd:new-if-exists - Attributes für eine Zeile fehlen, die mit 'Z' beginnt. Damit läßt sich auch auf großen Datenbeständen einfach ein Detaildatensatz erzeugen, indem auf den Grundseiten die Einträge gemerkt und auf der Detailseite nur 'Neu' geklickt wird. In diesem Fall wurde die Detailzeile nachgeladen und wird ausgewählt angezeigt.
- sd:check-col-outside-rowBeschreibung: Falls das sd:choose - Element im Kontext eines sd:rs mit sd:cols-as-rows='true' notiert ist und selbst außerhalb des <tr> - Elements, kann ein Wert 'true' in Kombination mit Spaltennamen beim sd:test - Attribut dazu genutzt werden, um verschiedene Ausgaben für verschiedene Spalten zu erzeugen.
- sd:check-for-saveBeschreibung: Kann mit 'true' belegt werden. Dann werden beim Klick auf den Button die Formulareingaben so überprüft, wie dies beim Speichern eines Datensatzes der Fall ist. Allerdings wird nichts gespeichert. Nützlich, wenn die Daten geprüft, aber anschließend dem Nutzer nochmals schreibgeschützt zur endgültigen Bestätigung angezeigt werden sollen.
- sd:check-http-statusBeschreibung: Falls dieses Attribut mit 'true' belegt ist, werden bei den sd:test - Attributen Http-Statuscodes erwartet. Der Statuscode wird beim Aufruf der Seite festgelegt, ist normalerweise 200, kann aber bsp. bei einem fehlerhaften SoftCheck als 404 festgelegt sein. Für so einen Fall kann eine gesonderte Meldung ausgegeben werden, bsp. mit einem Link zur korrekten Seite.
- sd:err-handler , sd:ro-value , sd:label , sd:input-text , sd:sort , sd:rel-steps , sd:cell-value , sd:col-name , sd:choose , sd:with-param , sd:value
- sd:cookie-getBeschreibung: Derzeit nicht genutzt. Es genügt, das ein Name mit einem Doppelpunkt (:exTID) beginnt, damit als Wert der entsprechende Cookie-Wert ausgelesen wird. Beispiel: <sd:param sd:name='eTID' sd:std-value=':exTID' sd:cache-name='eTID'/> Das ordnet dem Parameternamen eTID und damit dem gecachten Wert $eTID den Wert des Cookies exTID zu.
- sd:cultureBeschreibung: Normalerweise werden Datums- und Zahlausgaben gemäß den aktuellen Ländereinstellungen des Clientbrowsers formatiert. Ein Browser, der die Kennung 'en-US' sendet, erhält eine andere Ausgabe als ein Browser mit 'de-DE'. Falls dieses Verhalten nicht gewünscht ist, kann mit dem sd:culture - Attribut eine Kultur für die Ausgabe dieser Zelle fixiert und die Browsereinstellung hierdurch überschrieben werden. Näheres hierzu ist unter zu finden.
- sd:culture-calendarBeschreibung: Normalerweise werden Datums- und Zahlausgaben gemäß den aktuellen Ländereinstellungen des Clientbrowsers formatiert. Ein Browser, der die Kennung 'en-US' sendet, erhält eine andere Ausgabe als ein Browser mit 'de-DE'. Dabei kann der Kalender eine Rolle spielen, der dieser Kultur zugeordnet ist. Unterscheidet sich der Kalender des Clientbrowsers vom gewünschten Kalender des Eingabeformulars (etwa bei Vertragsangaben), kann mit diesem Attribut ein Kalender für die Verarbeitung dieses Wertes festgelegt werden.
- sd:datatypeBeschreibung: Legt den Datentyp fest, nach welchem der Wert von oder der vom Nutzer eingegebene Wert interpretiert und an die Datenbank weitergegeben wird. Fehlt dieser Wert, so wird als Standard-Datentyp String/nvarchar verwendet. Ist dieser Wert gesetzt und kann der vom Benutzer eingegebene Wert nicht konvertiert werden, so wird eine Fehlermeldung von der Laufzeitumgebung erzeugt. Fehlt dieser Wert, so wird der vom Benutzer eingegebene Wert an die Datenbank weitergegeben und eine eventuelle Fehlermeldung vom Sql-Server erzeugt.
- sd:datetime-formatBeschreibung: Legt das Datums- und Zeitformat für diese Zell-Ausgabe fest. Entweder werden Standardmuster verwendet oder es wird mit einer Kombination von Formatmustern ein eigenes Muster definiert (näheres siehe ). Die Einträge werden relativ zur Spracheinstellung des Clientbrowsers ausgewertet. Dieses Verhalten kann mithilfe des -Attributes verändert werden, so daß an alle Clients dieselbe Darstellung ausgegeben wird.
- sd:day-param-nameBeschreibung: Falls verwendet, muß der Wert dieses Attributes gleich dem Namen eines -Elements sein. Ist zur Ausführungszeit der Wert dieses -Elements gleich einem angezeigten Datum, so wird dieses Datum mit der durch das -Element mit dem -Attribut '...-active' vorgegebenen Formatierung ausgegeben. Dies kann bsp. ein schwarzer Rahmen zur Hervorhebung sein.
- sd:delay-saveBeschreibung: Falls der Button zum Speichern verwendet wird, kann hier eine Verzögerungszeit in Millisekunden angegeben werden. Dies ist nützlich, falls sich beim Betrieb herausstellt, daß das Formular für Spam genutzt wird. Ein Wert > 2 Sekunden stoppt in der Regel Spambots, welche die Seite zweimal innerhalb einer Sekunde aufrufen: Zunächst holt sich der Bot die Feldnamen, anschließend schickt er das Formular ausgefüllt zurück.
- sd:delimiterBeschreibung: definiert den Trenner, der zwischen zwei Zellen eingefügt wird. Dieses Attribut kann nützlich sein, falls die Daten nicht in Form einer Tabelle, sondern bsp. in Form einer kommagetrennten Liste ausgegeben werden. Würde das Komma innerhalb des sd:normal- oder sd:alternate-Elements eingefügt werden, so würde es auch nach der letzten Spalte ausgegeben werden. Der Wert des -Attributes wird dagegen nur zwischen den Spalten erzeugt und für die letzte Spalte unterdrückt.
- sd:del-only-cachedBeschreibung: Falls dieses Attribut mit dem Wert einer sd:cached-id - Variablen 'myId' belegt ist, wird eine Löschanforderung der Form Dateiname.html?action=objektname-d-myId' nur ausgeführt, falls der übergebene Name gleich diesem Attributwert ist. Die ID der zu löschenden Zeile wird in diesem Fall aus dem Laufzeitcache des ausführenden Nutzers ausgelesen. Dies verhindert Löschversuche durch die Übergabe einer Zahl, falls anonyme Nutzer Datensätze hinzufügen und löschen dürfen. Falls nur authentifizierte Nutzer Daten bearbeiten dürfen, ist diese Technik nicht notwendig, da nun der Datenbankserver die Berechtigung für den aktuellen Benutzer überprüft.
- sd:detail-main-column-listBeschreibung: Das Attribut kann - bei gesetztem sd:detail - Attribut - entweder fehlen oder mit einer pipe-getrennten Liste der Parent-Spalten belegt werden. Die Standardvariante geht davon aus, daß die Detailtabelle eine Spalte HaupttabelleId hat, die genutzt wird, um die ID des Hauptdatensatzes zu speichern. Ist dieser Name bereits belegt oder unpassend, so kann der Hauptspaltenname beliebig genannt und über dieses Attribut übergeben werden.
- sd:detail-sort-listBeschreibung: Wenn die Detailzeilen in einer speziellen Sortierung ausgegeben werden sollen, dann kann diese Sortierung hier festgelegt werden. Format: Wie in dem Sortierungsparameter für DataTable.Select bzw. in einer OrderBy-Klausel: Eine kommagetrennte Liste von Spaltennamen, optional DESC.
- sd:detail-source-outputBeschreibung: Kann den Namen einer Spalte enthalten. Falls im Kontext eines sd:input-text mit einem sd:detail definiert, muß der Name von der Form Objektname.Spaltenname sein. Dann bezeichnet das die Ausgabe einer Abfrage, so daß Detailwerte zum Anhaken ausgegeben werden (anstelle der Standardfunktionalität über ein Unterformular).
- sd:disable-output-escapingBeschreibung: Liefert den Text der Zelle unmaskiert aus. Enthält die Zelle die Html-Spitzklammern < und > bzw. das kaufmännische &, so werden diese unmaskiert ausgegeben. Das Attribut ist nützlich, falls die Spalte vom Typ bbcode ist. In diesem Fall existiert eine zusätzliche Spalte mit vorgestelltem '_', welche die Ausdrücke in eckigen Klammern durch ihr Html-Äquivalente ersetzt.
- sd:edit-disabledBeschreibung: Wenn dieses Attribut mit 'true' belegt ist, dann wird das Feld beim Editieren als 'disabled' dargestellt. Für den Nutzer ist eine solche Darstellung hilfreich, falls die Werte nicht mehr editierbar sein sollen. Dies verhindert nicht, daß jemand manuell eine Ausgabeseite konstruiert und von diesem Formular her Daten zurückschickt, die Änderungen in dieser Spalte enthalten. Zum tatsächlichen Schutz vor Änderungen ist deshalb das -Element mit belegtem -Attribut (Attributwert = Spaltenname) notwendig.
- sd:edit-filterBeschreibung: Es kann Fälle geben, in welchen die Tabellenberechtigungen nicht genügen, um Lesezugriff auf Datenzeilen zu verhindern. Bsp.: Interne Mitarbeiter können alle Datensätze bearbeiten. Externe Firmennutzer bilden eine eigene Gruppe, so daß mehrere externe Mitarbeiter dieselbe Menge an Daten bearbeiten kann. Zusätzlich sollen regionsbezogene Mitarbeiter nur die Datensätze ihrer Region lesen können. Hier ist die Gruppenspalte _Group bereits belegt, ein regionsbezogener Mitarbeiter soll Datensätze verschiedenster Gruppen seiner Region lesen können. Ein Eintrag 'RegionenSpalte|$RID' überprüft, ob der Datensatz-Wert für 'Regionenspalte' gleich dem für diesen Nutzer gecachten Wert $RID ist und läßt nur bei Übereinstimmung die Anzeige zu. Ein Eintrag 'RegionenSpalte|^$RID' läßt die Anzeige zu, falls $RID leer oder gleich dem Wert der Regionenspalte ist. Bei internen Mitarbeitern bleibt $RID leer, damit können diese sämtliche Datensätze lesen. Für regionsbezogene Mitarbeiter wird hier die RegionenId gecacht - sie sehen nur die Datensätze ihrer Region.
- sd:element-typeBeschreibung: Legt den Typ des -Elements fest. Gültige Typen sind (nur der Text, die Zahl bezeichnet das interne Flag): free (1) partial (2) full (4) too-small (8) at-end (16) too-small-or-at-end (24) other (0) blocked (-1) free-active partial-active full-active too-small-active at-end-active too-small-or-at-end-active iso-week-number Beim einfachen Kalender (absolute-table) werden nur die Flags 1, 0 und -1 berücksichtigt. Hier mag die Bezeichnung 'free' mißverständlich sein. Beim week-table-Kalender steht partial/2 für einen Tag, der mindestens einen freien Termin hat. 'full' / 4 markiert vollständig belegte Tage. Bei 'too-small' fallen theoretisch freie Termine durchgehend in Zeiträume, die zu nah an anderen Terminen liegen. Falls ein kürzeres Zeitintervall gewählt wird (halbstündige anstelle einer zweistündigen Untersuchung) kann sich ein solcher Tag in einen 'partial'-Tag verändern. Das 'at-end' - Flag wiederholt dieses Muster. Hier enthält der Tag nur noch freie Zeitpunkte, die zu dicht am Ende des Zeitraums (bsp. der Sprechstunde) liegen. 'too-small-or-at-end' wird ausgeführt, falls beide Versionen gemischt sind. Die 'other'-Tage sind nicht belegt (Wochenende, außerhalb der Sprechzeiten), die 'blocked'-Tage sind durch die Sperrtabelle (Urlaub, Fortbildung) explizit blockiert. Falls ein als free / partial / full / too-small / at-end / too-small-or-at-end ermittelter Tag markiert wird und falls entsprechende active-Elemente deklariert sind, werden diese ausgeführt. Die Formatierung kann bsp. um einen Rahmen ergänzt werden.
- sd:end-colBeschreibung: Dieses Attribut muß mit dem Namen der zweiten Datumsspalte belegt werden. Bsp.: 'Urlaubsende'. Fehlt dieses Attribut, so werden nur die Werte aus der mit sd:begin-col bezeichneten Spalte gesondert formatiert ausgegeben. In diesem Fall findet keine Berechnung von Bereichen statt.
- sd:execute-after-searchBeschreibung: Normalerweise werden zusätzliche Abfragen nach dem Verarbeiten von Speicher- oder anderer Sonderanforderungen und vor einem möglichen Redirect sowie dem Vorbereiten der Seitenobjekte ausgeführt. Es kann Fälle geben, in welchen es nützlich ist, diese Abfragen nach der Hauptsuche durchzuführen, um IDs der Suchergebnisse als Parameter übergeben zu können. Dies wird durch den Wert 'true' für dieses Attribut erzwungen.
- sd:execute-before-processing-postBeschreibung: Markiert per "true" einen Parameter, dessen zusätzliche Abfragen noch vor der Verarbeitung der POST-Anforderung ausgeführt werden. Kann bsp. nützlich sein, wenn ein Ausdruck per split-on-last-dot zerlegt wird und über eine Abfrage geprüft wird. Liefert die Abfrage gecachte Werte, die zum Speichern benötigt werden, würde ein mehr als eine Stunde offenes Formular die Session löschen - und ohne diesen Wert speichern.
- sd:external-filterBeschreibung: -Elemente können inzwischen geschachtelt werden. Wird dieses Attribut mit einer '|' - getrennten Kombination zweier Spalten belegt, dann zeigt dieses - innere - -Element pro Zeile nur jene Einträge an, bei welchen der Wert der eigenen, zweiten Spalte gleich dem Wert der äußeren, ersten Spalte ist.
- sd:filter-colBeschreibung: Falls dieses Attribut belegt ist, muß der Wert gleich dem Spaltennamen in der zugeordneten Tabelle sein. Diese Spalte muß vom Typ Integer sein. Es wird nun nicht die gesamte Tabelle, sondern nur die Zeilen verarbeitet, welche in der 'sd:filter-col'-Spalte den Wert haben, welcher durch das -Element übergeben wurde. Falls eine solche sd:filter-col-Spalte definiert wurde, jedoch kein Wert übergeben wurde, so wird keine Zeile der Kalendertabelle verarbeitet. Der Kalender bleibt ohne Hervorhebungen.
- sd:functionBeschreibung: Ermöglicht die Deklaration einer Funktion, die verwendet wird, um den ermittelten Wert zu transferieren. Gültige Werte sind derzeit:dateadd|days|1: Wenn der ermittelte Wert ein Datum ist, dann zählt dieser Funktionsaufruf einen Tag hinzu. Dies ist bsp. nützlich, falls eine Seite eine Tagesliste enthält, das Datum über ein sd:param-Element übergeben wird und ein Link für die Anzeige des nächsten Tages benötigt wird. Für die mittlere Position sind Werte minutes, hours, days, weeks, months und years zulässig. Die letzte Position enthält eine Ganzzahl - negative Zahlen erzeugen ältere Datumsangaben.get-extension: Der ermittelte Wert wird als Text betrachtet und an diese Funktion übergeben. Sie betrachtet den Input als Dateinamen und gibt die Endung einschließlich '.' zurück.get-filename-without-extension: Der ermittelte Wert wird als Text betrachtet und an diese Funktion übergeben. Zurückgegeben wird der Dateiname ohne Endung und ohne Punkt am Ende.
- sd:groupsBeschreibung: Falls das sd:system-interaction - Element eine Maske für die Neuanmeldung (new-anonym oder new-nick) bereitstellt, dann kann dieses Attribut eine Liste von benutzerdefinierten, durch Leerzeichen getrennten Gruppen enthalten. Beim Speichern wird der neue Nutzer zum Mitglied dieser Gruppen gemacht.
- sd:ignore-empty-rowBeschreibung: In einigen Fällen (viele Felder sind für einen externen Nutzer schreibgeschützt, die schreibbaren Felder bleiben leer) kann es wünschenswert sein, beim Speichern nicht die Meldung 'Eine Datenzeile muß mindestens einen Wert enthalten' auszugeben, sondern stattdessen einfach nichts zu machen (weder die schreibgeschützten Felder zu speichern noch eine Meldung auszugeben). Für diesen Fall kann dieses Attribute mit 'true' belegt werden.
- sd:ignore-formBeschreibung: Kann mit einem der beiden Werte true/false belegt werden. 'True' bedeutet, daß der Wert für diesen Parameter nicht aus einem Formularfeld ermittelt wird bzw. die entsprechende Zuweisung übersprungen wird. Dies ist nützlich, falls dieselbe Ausgabeseite von verschiedenen Seiten her aufgerufen wird und - mittels -Elementen Felder aus- und einblendet. Damit wird verhindert, daß Werte eines Datensatzes nach dem Speichern womöglich Filtereffekte erzeugen.
- sd:ignore-typeBeschreibung: search edit new m1 0 p1Das Attribut kann eine durch Leerzeichen getrennte Liste dieser Werte enthalten. Beim Erstaufruf und einem Reset ist einer Seite der Wert 0 zugeordnet, bei positiv abgeschlossenen Aktionen 1 (hier als p1 - plus 1 - abgekürzt), gescheiterte Aktionen werden mit -1 (hier als m1 - minus 1) bewertet. Ferner kann die Seite im Status 'Suchen', 'Editieren' (Datensatz-Id > 0) und 'Neu' (Erstellen eines neuen Datensatzes) sein.
- sd:infoBeschreibung: Freifeld für einen zusätzlichen Text, welcher den Content des Elements ergänzt, jedoch unabhängig von diesem ist. Falls das übergeordnete -Element im Kontext eines -Elements notiert ist, wird der - sprachabhängige - Wert dieses Attributes als Mail - Subject genutzt. Damit erhalten Nutzer nicht nur einen Mailbody, sondern auch ein Mailsubject in ihrer Sprache.
- sd:input-typeBeschreibung: Gültige Werte für dieses Attribut sind:mailMailadressenickNickbothMail oder Nickpwdaktuelles Passwortpwd_ineues Passwortpwd_iiWiederholung neues PasswortrecipientEmpfänger von tell-a-friendown_nameeigener Name für tell-a-friendown_maileigene Mail für tell-a-friendidentifierZufallsschlüssel für die Double-Opt-In-Bestätigung des Newsletters oder zum Abmelden Das übergeordnete -Element kann mehrere -Elemente enthalten, die sich nach ihrem Typ unterscheiden. So wird zur Neuregistrierung eines anonymen Nutzers ohne Nick nur ein -Element mit sd:input-type='mail' benötigt. Der Eintrag vom Typ 'identifier' für die Newsletter-Bestätigung wird beim Eintragen einer Mailadresse in eine Ausgabeseite mit der newsletter-subscribe - Funktionalität erzeugt. Dieser Zufallstext wird dem Nutzer mit der in dieser Ausgabeseite definierten Mail zugesandt und muß in eine Seite mit der 'newsletter-confirm' - Funktionalität kopiert werden. Derselbe Schlüssel kann zum Abmelden auf einer 'newsletter-unsubscribe' - Seite genutzt werden.
- sd:instead-nullBeschreibung: Falls ein Datensatz neu angelegt wird und bsp. ein -Element namens 'time' über einen Link mit dem Wert '12:00' belegt wurde, so kann dieses Attribut mit dem Wert '$time' belegt werden. Das Eingabefeld wird mit diesem Wert vorbelegt. Dies liefert eine Funktionalität, welche durch die Definition eines Standardwertes nicht erreicht werden kann. Damit ist es bsp. möglich, ein kleines Formular innerhalb eines Tageskalenders mit verschiedenen Uhrzeiten anzusteuern, so daß die gewählte Uhrzeit als Vorbelegung dient.
- sd:interaction-typeBeschreibung: Gültige Werte für dieses Attribut sind: new-anonym new-nick new-pwd change-pwd change-mail login tell-a-friend newsletter-subscribe newsletter-confirm newsletter-unsubscribe Die beiden ersten Werte ermöglichen die Neuregistrierung eines anonymen Nutzers (nur Mail) oder eines neuen Nutzers mit Mail und Nick-Namen. Der dritte Wert (new-pwd) sendet an die einzugebende Mailadresse bzw. an die dem Nick zugeordnete Mailadresse ein neues Passwort und stellt eine 'Forgot-Password' - Funktionalität bereit. 'change-pwd' interpretiert die Eingaben als Aufforderung, das Passwort zu ändern, 'login' interpretiert die Daten als Login. 'tell-a-friend' ermöglicht das Versenden einer Mail, welche eine per Url übergebene Adresse an den gewünschten Empfänger verschickt. Die drei Newsletter-Werte stellen die Elemente für die Selbstanmeldung eines Nutzers, den Eintrag des Bestätigungsschlüssels als Double-Opt-In-Verfahren und eine Möglichkeit zur Abmeldung bereit. Für diese Werte muß zusätzlich das sd:newsletter-table - Attribut angegeben werden, um den Namen der Tabelle vom Sondertyp Newsletter-Mail festzulegen. Wenn der Wert 'newsletter-subscribe' gewählt ist, also eine Maske zum Eintragen der Mailadresse ausgegeben wird, muß zusätzlich ein -Element erstellt und das -Attribut mit dessen Namen belegt werden. Diese Mail wird nach dem erfolgreichen Speichern der Mailadresse dem Nutzer zugesandt und sollte das Kürzel '{4}' sowie einen Link auf eine Seite mit der 'newsletter-confirm' - Funktionalität enthalten. Das Kürzel '{4}' kennzeichnet die vierte Spalte und wird mit dem Bestätigungsschlüssel gefüllt. Erst die Bestätigung mit diesem Schlüssel (Double Opt-In)schaltet die Mail für den Newsletter frei und vermeidet damit den Mißbrauch fremder Mailadressen.
- sd:label-listBeschreibung: Falls dieses Attribut mit einer pipe-getrennten Liste ('|') von Beschriftungen belegt ist, das -Attribut analog Werte enthält und die Spalte als Pulldown-Liste ausgegeben wird, werden die zugeordneten Kombinationen am Ende der Pulldown-Liste hinzugefügt. Dies ermöglicht es auf einfache Weise, bsp. Randwerte aus mehreren Tabellen zusammen auszugeben und sie als Eingabefilter für Kalenderelemente zu nutzen.
- sd:library-nameBeschreibung: Legt den Namen der sd:library (= sd:Bibliothek) fest. Falls die Vorlage in der aktuellen Ausgabeseite definiert ist, muß dieses Attribut einen Punkt ('.') als Wert erhalten. Ist die Vorlage in einer Ausgabeseite vom Typ 'Library' definiert, so ist der vollständige Name der Datei einzusetzen.
- sd:mail-address-tableBeschreibung: Wenn dieses -Element mit sd:source-type='table' und sd:source-name='_dT_mails' als vordefiniertem Ausdruck deklariert ist, dann dient dieses Element zum Lesen empfangener Mails. Das sd:mail-address-table - Attribut benennt die Tabelle, welche vordefinierte / bekannte Mails enthält. Die Mails werden diesen Versendern zugeordnet und können bsp. automatisch weiterverarbeitet werden.
- sd:mail-includes-disclaimerBeschreibung: Falls mit dem Wert 'true' belegt, ist der Disclaimer bereits im Mailcontent enthalten. Der Standard-Disclaimer der Datenbank wird nicht angehängt. Das ist bsp. nützlich, falls mehrere Domains über eine Datenbank verwaltet werden und verschiedene Newsletter mit unterschiedlichen Disclaimern verschickt werden sollen.
- sd:min-rowsBeschreibung: Ist dieser Wert gesetzt, dann wird das -Element nur ausgegeben, falls das zugeordnete -Element mindestens die hier festgelegte Zahl von Zeilen enthält. Dies ist bsp. nützlich, falls Listen zum Blättern nur möglichst selten ausgegeben werden. In diesem Fall genügt es, diesen Wert bsp. auf '50' zu setzen.
- sd:missing-valueBeschreibung: Der Wert dieses Attributes wird für die Spalte verwendet, falls alle bisherigen Prüfungen noch keinen Wert bereitgestellt haben. Falls bsp. ein sd:std-value - Wert mit '%' und dem Namens eines Parameters definiert wurde, der Parameter jedoch nicht belegt ist, ergibt sich ein nicht definierter Wert. Stattdessen wird der Wert von 'sd:missing-value' eingetragen.
- sd:nameBeschreibung: Legt den Namen dieser Url-Verzweigung fest. Dieser Name ist später der links vom Gleichheitszeichen verwendete Ausdruck, der in der Url verwendet wird: Seitenname.html?<Name>=Wert.sd:calendar , sd:choose-action , sd:system-interaction , sd:form , sd:input-table , sd:button , sd:result-steps , sd:protocol , sd:chart , sd:swf , sd:rs , sd:mail , sd:choose , sd:choose-url , sd:call-template , sd:library , sd:template , sd:param
- sd:newsletter-tableBeschreibung: Falls sich das sd:system-interaction auf eine Newsletter-Aktivität bezieht, muß dieses Attribut vorhanden und mit dem Wert der zugrundeliegenden Mailtabelle belegt sein. Dies ist eine Tabelle vom Typ 'Newsletter-Mails' mit fest vorgegebenen Spalten. Ihr Inhalt läßt sich nur über Ausgabeseiten mit dem sd:system-interaction - Element bearbeiten, nicht über die internen Masken.
- sd:number-decimal-separatorBeschreibung: Ist dieses Attribut mit dem Wert 'true' belegt, dann wird das Dezimaltrennzeichen der aktuellen Seite ausgegeben. Dies kann nützlich sein, falls die Seite zusätzliche JavaScript-Anweisungen enthält, mit denen Textfelder in Zahlen umgewandelt und mit diesen gerechnet werden soll. Je nach Kultur der Ausgabeseite kann das Dezimaltrennzeichen ein Punkt oder ein Komma sein. Für die korrekten JavaScript-Operationen muß bei den Werten zunächst das verwendete Dezimaltrennzeichen (ermittelbar durch dieses Attribut) durch einen Punkt und - bei der Ausgabe - der Punkt wieder durch das Dezimaltrennzeichen ersetzt werden.
- sd:one-value-requiredBeschreibung: Ermöglicht die Deklaration einer Pflichtliste, die sowohl Spaltennamen des zugeordneten -Elements als auch -Elemente enthalten kann. Letzteren wird ein '%' vorgestellt. Dies ist bsp. nützlich bei der Umkreissuche, falls mindestens ein Wert ausgefüllt und das Anzeigen der Gesamtliste unterbunden werden soll.
- sd:only-image-remove-checkboxBeschreibung: Bei Bildern / Dateien wird standardmäßig eine Checkbox zum Löschen dieser Zelle (unabhängig vom Löschen der Datenzeile) ausgegeben. Soll diese Checkbox eigenständig postiert / formatiert werden, kann ein -Element mit diesem Attribut und dem Wert 'true' genutzt werden.
- sd:output-labelBeschreibung: Wenn das -Element im Kontext eines mit einem sd:delimiter-Attribut definierten -Elements notiert ist, dann sollte das -Element eine Doppelliste von Werten und Beschriftungen (semikolongetrennt) zurückgeben. Für jede Kombination wird einmal der Content des -Elements aufgerufen. Der Wert 'true' für dieses Attribut zeigt die Beschriftung an.
- sd:output-valueBeschreibung: Wenn das -Element im Kontext eines mit einem sd:delimiter-Attribut definierten -Elements notiert ist, dann sollte das -Element eine Doppelliste von Werten und Beschriftungen (semikolongetrennt) zurückgeben. Für jede Kombination wird einmal der Content des -Elements aufgerufen. Der Wert 'true' für dieses Attribut zeigt den eigentlichen Wert an, so daß dieser bsp. über ein -Element als Attributwert für einen Link genutzt werden kann.
- sd:page-number-styleBeschreibung: Bestimmt, wie die Ausgaben der - und -Elemente umgerechnet werden. Ein Ausgabelink entspricht einer Menge von Zeilen in der Datenbank mit Positionen (1-10, 11-20, 21-30). Drei Optionen sind zulässig: absolute (1-10, 11-20, 21-30) absolute-start (1, 11, 21) relative (1, 2, 3)'absolute' wird als Standardwert verwendet.
- sd:parent-valueBeschreibung: In einer Eingabemaske mit einer Pulldown-Liste kann es wünschenswert sein, daß die Pulldown-Liste nur gefilterte Werte enthält - nicht alle. Dann kann dem sd:relation - Attribut der Name einer Verknüpfung und zusätzlich dem sd:parent-value - Attribut ein Cache-Name (mit '$' beginnend) und - zusätzlich durch ein Leerzeichen getrennt - ein Standardwert zugewiesen werden. Existiert der Cache-Name, so wird dieser genutzt. Ansonsten wird der Standardwert verwendet, um die Ausgabeliste vorzufiltern.
- sd:pfilter-elementsBeschreibung: Erwartet entweder den Namen eines einzelnen Views, der als Ziel für diese Autofilter-Logik genutzt wird. Oder es werden - semikolongetrennt - pipegetrennte Kombinationen aus Eingabetabelle und View notiert. Die letztere Variante ist notwendig, falls die Eingabetabelle für Url-Überschreibungen genutzt wird, so daß verschiedene Tabellen vom gleichen Element ausgegeben werden können.
- sd:preserve-rangeBeschreibung: Wenn dieses Attribut mit dem Wert 'true' belegt ist, dann wird die normalerweise durchgeführte Entfernung des /range/ - Abschnittes aus der Url unterdrückt. Dies kann in jenen Fällen sinnvoll sein, in welchen die Zielurl gecacht wird, um nach einer erfolgreichen Bezahlung (per PayPal, Sofortüberweisung) wieder auf exakt diesen Datensatz weitergeleitet zu werden.
- sd:query-argument-listBeschreibung: Wenn dem sd:param - Element ein -Attribut zugewiesen ist, so daß eine Abfrage ausgeführt wird, dann kann dieses Attribut eine semikolongetrennte Liste von Sql-Parametern für diese Abfrage enthalten. Jeder Abschnitt enthält drei pipegetrennte Werte: Sql-Parameter, Datentyp, Cache- oder sonstiger Wert. Beispiel: "@PID|int|$PID;@SID|int|§oS.StellengesucheId;@eTYPE|nvarchar|Mitarbeiter" @PID/@SID/@eTYPE sind die in der Abfrage definierten Sql-Parameter. int/nvarchar sind die Datentypen. $PID liest den Wert aus dem Cache. §oS.StellengesucheId sucht im Objekt 'oS' nach der ersten Zeile und liest dort den Wert 'StellengesucheId' aus. 'Mitarbeiter' ist eine Konstante. Andere Seiten übergeben andere Konstanten, dementsprechend liefert die Abfrage andere Ergebnisse zurück.
- sd:query-nameBeschreibung: Wird dieses Attribut mit dem Namen einer Abfrage belegt, dann wird die Abfrage beim Aufruf der Ausgabeseite ausgeführt. Falls dem -Element ein Cachename zugewiesen wird, können die Spalten der Ergebniszeile einzeln für diesen Nutzer gecacht werden. Dies ermöglicht es bsp., daß zum aktuellen Nutzer und dessen USER_ID die zugeordnete MitarbeiterId aus der Tabelle der Mitarbeiter geholt und für Vorbelegungen gecacht wird.
- sd:radio-resetBeschreibung: Wenn das aktuelle -Element eine Bitspalte (oder eine Integerspalte mit nur zwei Werten ja / nein) ausgibt und diese als Radiobuttons formatiert, dann läßt sich nach dem Anklicken eines Eintrages nur noch der andere Wert auswählen. Es ist - aufgrund der Eigenschaften von Radio-Buttons - nicht mehr möglich, beide Optionen auszugeben, ohne daß eine Option gewählt wird. In Fällen, in welchen ein explizites Zurücksetzen gewünscht ist, kann dieses Attribut mit einer Beschriftung belegt werden. Dann wird ein dritter Radiobutton mit dieser Beschriftung ausgegeben. Die Wahl von diesem schickt einen Leerstring, so daß beim nächsten Aufruf alle drei Optionen frei sind.
- sd:range-conditionBeschreibung: Ermöglicht es, den vordefinierten sd:range-Wert durch eine Bedingung zu verändern. Ist hilfreich, wenn bsp. in einem Blog normalerweise 20 Einträge ausgegeben werden sollen. Die Monatsansicht soll aber 50 Einträge, damit den gesamten Monat anzeigen. Eine solche range-Condidition ist besser als ein zweites - Element. Logik: $Parametername|Parameterwert1|NeuerWert1|Parameterwert2|NeuerWert2
- sd:refresh-pulldownsBeschreibung: Falls mit einer kommagetrennten Liste von Spalten-IDs belegt, werden die zugehörigen Pulldown-Daten neu geladen, falls per sd:with-postback='true' ein Post beim Ändern von Daten erzwungen wird. Das ist nützlich, falls Relationen mit zusätzlichen Parametern, aber ohne direkte Detailspaltenfilter deklariert sind, um das Neuladen der Relation und die Berücksichtigung der geänderten Parameter zu erzwingen.
- sd:relationBeschreibung: Ist dieses Attribut mit dem Namen einer Relation belegt und wird dem sd:param-Element ein Eingabefeld () zugeordnet, so wird das Eingabefeld wie bei einer üblich definierten Relation als Pulldown-Liste mit den Werten und der Darstellung aus der Relationen-Grundtabelle angezeigt. Damit kann der Nutzer einen Wert wählen und das sd:param-Element mit diesem Wert vorbelegen. Ein Beispiel zu dieser Nutzung ist unter mehrere Zimmer zugänglich.
- sd:rel-formatBeschreibung: Legt fest, wie bei Relationen dieser Tabelle das Suchfeld und die Buttons zum Durchblättern der Relationen erzeugt werden. Mögliche Werte sind: search button auto manualDie Werte 'search' und 'button' erzeugen automatisiert ein Suchfeld und die beiden Buttons zum Vorwärts- und Zurückblättern, 'auto' erstellt sämtliche Objekte automatisch, 'manual' verzichtet auf jede manuelle Erstellung. Jede automatisierte Erstellung belegt Platz unmittelbar hinter dem Eingabefeld. Zusätzlich zur manuellen Erstellung können -Container für jede Spalte mit Relationen genutzt werden. Bei komplexeren Designs dürfte 'manual' sowie die manuelle Erstellung dieser Objekte die richtige Wahl sein.
- sd:remove-ctrlBeschreibung: Es kann Fälle geben, in welchen das auszugebende Feld Returns enthalten kann, der Inhalt aber bsp. an eine JavaScript-Funktion übergeben werden soll und die eingebetteten Returns Fehler erzeugen. In solchen Fällen liefert dieses Attribut, mit 'true' belegt, einen Output, der um alle Zeilenumbrüche bereinigt ist.
- sd:remove-objectBeschreibung: Kann auf true gesetzt werden. Falls gesetzt, wird in der Url der Objektname, auf den sich diese Blätterliste bezieht, nicht mit ausgegeben. Das ist nütlich, wenn man bei einem Folder Blätterlinks der reduzierten Form /range/1-20 nutzen möchte. Die Standardausgabe wäre etwas wie oB/range/1-20.
- sd:remove-when-posted-and-not-foundBeschreibung: Löscht den Parameterwert, falls er nicht explizit neu beim Aufruf übergeben worden ist. Dies ist dann wichtig, falls über ein Formular Bitset-Werte zum Anhaken addiert werden, die als Filter wirken. Beim Aushaken wird von Browsern nichts geschickt, also bleibt der Cachewert normalerweise erhalten und filtert weiterhin. Das Setzen dieses Attributes auf 'true' sorgt für ein explizites Löschen.
- sd:remove-when-savedBeschreibung: Falls dieses Attribut mit 'true' belegt und irgendeine Zeile in der Seite gespeichert wird, dann wird das übergeordnete Ergebnis gelöscht und anschließend neu von der Datenbank geladen. Das ist nützlich, falls es Abhängigkeiten zwischen Eingaben und Ausgaben gibt, die sich nicht über andere Möglichkeiten deklarieren lassen. Fehlt das Attribut und existieren solche Abhängigkeiten, so kann es zu Fehlanzeigen kommen. Das System nutzt - absichtlich - umfangreiche Caching-Techniken, so daß Kalender- und Ausgabetabellen nur neu geladen werden, falls innerhalb der Ausgabeseite ein Grund dafür vorliegt (geändertes Datum, Klick auf den Such-Button).
- sd:ro-value-listBeschreibung: In Kombination mit dem sd:save-multiple - Attribut kann dieses Attribut genutzt werden, um für alle Spalten aller zu speichernden Zeilen Standardwerte festzulegen. Das Format ist: Spaltenname|Wert;Spaltenname|Wert Als Wert kann bei Datumsspalten auch getdate() eingesetzt werden. Dann wird das aktuelle Datum gesetzt.
- sd:row-aggregatorBeschreibung: Ermöglicht das Angeben einer Spalte. Falls dieser Wert existiert, wird der Content des sd:rs - Elements nicht einmal pro Zeile, sondern nur einmal pro verschiedenem Wert in dieser Spalte (aufsteigend sortiert) aufgerufen. Dies ermöglicht es, im Content sd:with-row-search - Attribute zu nutzen, die ihrerseits die passenden Zeilen für die Ausgabe zusammensuchen.
- sd:rowsBeschreibung: Wenn dieses Attribut mit einem Wert > 0 belegt und der Stil 'as-cols' gewählt ist, dann enthält die einzufügende Spalte soviele Zeilen, wie dieser Attributwert vorschreibt. Beim Überschreiten dieser Zahl wird eine neue Spalte eingefügt. Damit ist der Platzbedarf nach unten hin begrenzt und nach rechts (Zahl der Spalten) flottierend. Diese Variante wird derzeit beim Beispiel Termine online reservieren genutzt.
- sd:save-columnsBeschreibung: Wenn ein View mit Detailspalten zum Anhaken angezeigt wird, dann kann die Detailtabelle zusätzliche Spalten enthalten, deren Auswahl ebenfalls gespeichert werden soll. Gibt es bsp. Tabellen 'Rechtsgebiete', 'Anwälte', eine Verknüpfungstabelle vk_Rechtsgebiete_Anwälte und einen View v_Rechtsgebiete mit Detailspalten, so kann die Verknüpfungstabelle eine zusätzliche Spalte 'ist_Fachanwalt' enthalten, deren Wert ebenfalls gespeichert werden soll. Die Deklaration sd:save-columns='cb_ist_Fachanwalt' leistet das Gewünschte. Sie stellt sicher, daß der Wert der Zusatzspalte ebenfalls gespeichert wird.
- sd:save-only-visibleBeschreibung: Gültige Werte sind true falseFalls 'true', so wird ein Speichern- oder Löschbefehl nur dann ausgeführt, wenn der zu bearbeitende Datensatz im Laufzeitcache des aktuellen Nutzers existiert, also auch angezeigt wird. Dieses Attribut verhindert das Speichern / Löschen beliebiger Datensätze über die Id und sollte in jenen Fällen verwendet werden, in welchen anonyme Nutzer im Rahmen einer Bestellung ihre Bestelldetails angezeigt bekommen und einzelne Bestelldetails speichern / löschen dürfen. Da nur die Bestelldetails angezeigt werden, die zur Haupt-Id gehören und da die Haupt-Id aus dem Servercache geholt wird, kann auf diese Weise kein fremder Detaildatensatz gespeichert oder gelöscht werden.
- sd:save-typeBeschreibung: Gültige Werte sind 1 2 8und Bitkombinationen (= Summen) dieser. Ist das 1-Bit gesetzt, so wird beim Speichern immer ein neuer Datensatz erzeugt. Ein Wert 2 zeigt an, daß mit der Eingabemaske ausschließlich ein vorhandener Datensatz editiert werden kann. 3 (= 1 | 2) läßt sowohl die Neuerstellung als auch das Editieren zu und wird als Standardeinstellung genutzt, falls das Attribut fehlt. Interessant ist das 8-Bit in Kombination mit 1 (= 9) bzw. 1|2 (= 11). Damit wird gefordert, daß beim Neuerstellen eines Datensatzes noch kein Datensatz existiert, der diesem Owner gehört. Dies ist praktisch, falls eine Maske angeboten wird, die mittels des -Elements ermittelt, ob es von diesem Nutzer bereits einen Datensatz gibt und den Speichern-Button entweder zum Erstellen eines neuen Datensatzes oder zum Speichern des bearbeiteten Datensatzes ausgibt. In diesem Fall kann ein böswilliger Nutzer die Eingabemaske durch eine passende Url auch erneut aufrufen. Das Speichern des so generierten zweiten Datensatzes wird durch das 8-Bit jedoch abgeblockt. Dieses Attribut ist bsp. nützlich, falls ein Datensatz zum Editieren angeboten wird, dessen ID bei einem früheren Aufruf erzeugt und gecacht worden ist. Das Attribut verhindert, daß die Seite isoliert aufgerufen und anstelle einer Bearbeitung ein neuer Datensatz erzeugt wird.
- sd:scBeschreibung: Bezieht sich das sd:rs-Element auf eine Tabelle oder eine Sicht, so muß der Wert dieses Attributes (SortColumn) gleich dem Namen einer Spalte der zugrundeliegenden Tabelle sein. Nach dieser Spalte wird der erste Aufruf sortiert. Bezieht sich das sd:rs-Element auf eine Abfrage, so wird dieser Wert ignoriert.
- sd:skip-boolean-andBeschreibung: Bei bitSet-Spalten wird inzwischen eine Zusatzmöglichkeit zum Anhaken ausgegeben: 'Kombisuche'. Ist diese angehakt, dann werden bei mehreren angehakten Optionen nur jene Zeilen ausgegeben, die alle Optionen erfüllen. Wenn diese Option 'Kombisuche' nicht ausgegeben werden soll, dann kann dieses Attribut auf 'true' gesetzt werden.
- sd:skip-col-listBeschreibung: Wenn ein -Element mit dem Attribut sd:cols-as-rows='true' genutzt wird, so daß die Tabelle gekippt ist und wenn es ein -Element zum Durchlaufen aller Zeilen enthält, dann werden zunächst die ursprünglichen Spaltennamen in einer ersten Spalte links ausgegeben. Ein Wert 'true' für dieses Attribut unterdrückt diese Spalte.
- sd:skip-prefixBeschreibung: Wenn der Wert true ist, dann wird bei einem per sd:dT-input angegebenen Eingabefeld dessen Name ohne Präfix (bsp. iP.) übergeben. Das ist dann nützlich, falls im Kontext einer Eingabetabelle ein zusätzliches, an einen Parameter gebundenes Datumseingabefeld genutzt wird, das ohne Präfix adressiert werden soll.
- sd:skip-wiki-helpBeschreibung: Wenn das Feld als Wiki-Code deklariert ist, dann wird eine zusätzliche Leiste mit Buttons ausgegeben. Hat die Tabelle mehrere Wiki-Code - Spalten, dann kann das störend sein. Dieses Attribut mit dem Wert 'true' belegt sorgt dafür, daß die Button-Leiste nicht eingebaut wird.
- sd:soft-checkBeschreibung: Ermöglicht einen schwachen / soft - Test einer Eingabe. Wird bsp. die Seite anzeige.folder definiert, um Adressen der Form http://datenbank-name.server-daten.de/anzeige/Max.Mustermann/195 zu verwenden, so kann getestet werden, ob der Datensatz mit der ID tatsächlich den Vornamen 'Max' und den Nachnamen 'Mustermann' enthält. Beispiel für eine Belegung: 1|404|Vorname|Nachname Zunächst wird die Position des zu überprüfenden Wertes in der Url angegeben (hier Position 1), dann der stattdessen zu generierende Html-Statuswert (hier: 404, nicht gefunden), damit fehlerhaft verlinkte Seiten nicht in den Suchmaschinen erscheinen. Schließlich folgt die Liste der Spalten, die - zusammengesetzt - den Wert ergeben sollen. Dies gelingt auch, falls die Tabelleneinträge Umlaute, die Urls dagegen ae/oe/ue enthalten.
- sd:soft-check-with-redirectBeschreibung: Dieses Attribut ist sehr mächtig, falls die Seite als Folder definiert ist, von verschiedenen Domains her verlinkt wird und falls den verlinkenden Seiten eindeutige Provisionszahlungen zugeordnet werden sollen. Beispiel: <sd:param sd:name="extern" sd:std-value="_path-1" sd:cache-name="eFiNa|eFID" sd:function="split-on-last-dot" /> <sd:param sd:name="rFiNa" sd:query-name="get_FiNa" sd:cache-name="rFiNa;has_logo;rFiNa-soft" sd:query-argument-list="@FID|int|$eFID" sd:soft-check-with-redirect="1|$eFiNa|$rFiNa-soft|301|404|/|$rFiNa-soft|.|$eFID" /> Das erste sd:param-Element wird mit dem ersten Path-Ausdruck in der Url belegt. Dieser wird am letzten Punkt gesplittet, die Werte werden den Variablen $eFiNa und $eFID zugewiesen (Firmenname und FirmenId). Das zweite sd:param - Element führt die Abfrage get_FiNa aus und cacht die drei Ergebnisse unter $rFiNa, $has_logo und $rFiNa-soft. Es übergibt dabei die ID, die unter $eFID gecacht ist. Das sd:soft-check-with-redirect - Attribut sorgt anschließend dafür, daß: fehlende Werte erlaubt sind - dies macht die 1. 0 an erster Position unterbindet fehlende Werte.die beiden folgenden Werte $eFiNa und $rFiNa-soft werden soft miteinander verglichen. Groß/Kleinschreibung spielt keine Rolle, '-' werden entfernt. Sind beide Ausdrücke identisch, passiert nichts. Sind sie 'soft - gleich', aber verschieden, dann wird per Http-Status 301 auf die Kombination '/' + $rFiNa-soft + '.' + $eFID weitergeleitet. Sind sie unvergleichbar, wird ein Http-Status 404 erzeugt. Damit kann sichergestellt werden, daß nur die Aufrufe korrekt verarbeitet werden, bei welchen die Klartextdarstellung des Firmennamens in der Url und die ID zueinander passen. Die 'fast passenden' Kombinationen werden auf die korrekte Variante weitergeleitet. Alle anderen Fälle, die praktisch auf 'böswilliger Verlinkung' beruhen, werden mit einem 404 quittiert.
- sd:source-tableBeschreibung: Falls aus einer Abfrage heraus gelöscht werden soll, muß diesem Attribut der Name der Tabelle zugeordnet werden, aus welcher die zu löschende ID stammt. Da eine Abfrage mehrere Tabellen miteinander verknüpfen kann, wäre der Löschbefehl ohne dieses Attribut nicht eindeutig. Für Tabellen und Views wird dieser Wert ignoriert.
- sd:sql-paramBeschreibung: Legt den Namen des Sql-Parameters für die übergeordnete Abfrage fest, dem das -Element einen Wert zuweisen soll. Die Abfrage muß mit einer Variablendeklaration (DECLARE <@Variablenname Datentyp> [, weitere Variablen/Datentypen]) beginnen. Werden keine Variablen benötigt, so muß das erste Wort einer Abfrage SELECT sein.
- sd:start-dateBeschreibung: Legt das Startdatum für den Kalender fest. Das Datum wird einmalig beim Speichern der Seite ausgelesen und gesondert in der Datenbank im Datumsformat gespeichert. Wird für das Startdatum '2006-01-01' und für das Enddatum '2006-03-31' angegeben, so werden die drei Monate Januar / Februar / März 2006 verarbeitet.
- sd:subtypeBeschreibung: Wenn dieses Attribut mit einem String 'Eingabeobjekt-saved' belegt ist, dann wird das -Element nur dann ausgeführt, falls über diese Eingabemaske gespeichert wurde. Ansonsten wird weiterhin das -Element ausgegeben. Dies ist bsp. dann nützlich, falls in einer Seite mehrere Formulare definiert sind und eine Bestätigung nur passend zum aktuellen Formular angezeigt werden soll.
- sd:supress-pathinfoBeschreibung: Falls 'true', werden für das übergeordnete sd:rs- bzw. sd:input-table - Objekt keine PathInfo - Ausgaben generiert. Das kann nützlich sein für Elemente, durch die bsp. ohnehin nie geblättert wird (sd:rs auf einer Startseite als Linkliste oder mit einer einzigen Zeile als Ausgabe).
- sd:supress-range-resetBeschreibung: Falls dieses Attribut mit 'true' belegt ist, dann wird der Bereich des Suchergebnisses (1 - 10, 11 - 20) nicht auf 1-10 bzw. den Standardbeginn zurückgesetzt, falls Suchparameter geändert wurden. Normalerweise wird dieses Zurücksetzen erwartet: Sieht man die dritte Seite der Suchergebnisse und ändert man die Sortierung, dann sollen Ergebnis 1-10 in bezug auf die neue Sortierung angezeigt werden. Dieses Verhalten ist jedoch störend, wenn die Maske nur einen Datensatz ausgibt, um ein direktes Blättern durch Detailergebnisse zu ermöglichen. Der Wert 'true' ermöglicht in diesem Fall ein Unterdrücken des Sprungs auf die erste Seite.
- sd:testBeschreibung: Das Attribut enthält als Wert eine Testbedingung (mit Vergleichsoperatoren), der Ausdruck muß True oder False zurückliefern. Befindet sich das -Element im Kontext eines -Elements, so können die Spaltennamen für Vergleiche genutzt werden. A_Preis < 100 vergleicht den Wert der Zelle A_Preis gegen die Konstante 100. Ansonsten gelten die Regeln für Vergleiche in Xslt. Wird nur ein Spaltenname angegeben (A_Preis), so ist die Bedingung wahr, falls die Zelle nicht leer ist. Direkt notierte Ausdrücke beschreiben Spaltennamen, Textkonstanten müssen in Anführungszeichen eingeschlossen werden <sd:when sd:test="A_Name = 'Oberhemd'"> prüft die Zelle A_Name auf Übereinstimmung mit der Textkonstanten "Oberhemd".
- sd:urlBeschreibung: Dient zur Festlegung der Stammadresse für die 'tell-a-friend' - Funktionalität. Hier muß eine komplette Url einschließlich 'http://' angegeben werden. Dieses Attribut ist für den 'tell-a-friend'-Typ Pflicht. Bei der Verarbeitung der vom Nutzer eingegebenen Werte wird geprüft, ob die zu empfohlene Adresse zu der Url gehört, welche durch die Stammadresse festgelegt worden ist. Falls ja, wird die Mail versandt, falls nicht, wird die Verarbeitung abgebrochen. Ansonsten könnte die Ausgabeseite mit jeder beliebigen Url aufgerufen und eine empfehlende Mail versandt werden.
- sd:value-requiredBeschreibung: Wenn man bsp. eine Checkliste hat, dann kann es wünschenswert sein, daß bestimmte Zellen zunächst mit 0 = "nein" angezeigt werden. Der Nutzer muß aber die Zelle explizit auf 1 = "ja" setzen. Ein solcher benötigter Wert, der durch Nutzereingaben generiert wird, kann mit diesem Attribut festgelegt werden.
- sd:view-only-visibleBeschreibung: Die Aufruflogik für Datensätze läßt es zunächst zu, daß man Datensätze 'errät', indem eine Url der Form http://datenbank-name.server-daten.de/ausgabe.html?action=sample-output-153 aufgerufen wird. Dies ist unproblematisch, falls Aufrufer ohnehin die Berechtigung zum Lesen des gesamten Datensatzes haben. Falls allerdings ein Dienstleister-Katalog mit einfachen und mit Premium-Mitgliedern verwendet wird, so kann ein Mitglied seine Premium-Einträge bereits eintragen, ohne daß diese schon freigeschaltet sind. Diese Daten wären für andere durch ein Erraten abrufbar. Ist das sd:view-only-visible-Attribut mit 'true' belegt, so wird genau dies verhindert. Nur die Daten, die im -Element aktuell angezeigt werden und sich bsp. nach der USER_ID auf den aktuellen Nutzer einschränken lassen, können mit Details ausgegeben werden.
- sd:week-dayBeschreibung: Bezeichnet eine Spalte innerhalb der durch festgelegten Tabelle, welche die Information zum Wochentag bereitstellt. Diese Spalte muß als 'int'-Spalte mit den Werten 2;Montag;3;Dienstag;4;Mittwoch;5;Donnerstag;6;Freitag;7;Samstag;1;Sonntag deklariert sein. Die Kombination 1;Sonntag kann auch an den Anfang der Liste gestellt werden.
- sd:with-postbackBeschreibung: Falls das Attribut mit 'true' belegt ist, wird der Link nicht als gewöhnlicher Link, sondern per JavaScript erzeugt und mit einem POST-Befehl ergänzt. Dies kann nützlich sein, falls beim Klick auf den Link Formulareingaben gepostet werden sollen, die zu einer anderen Tabelle gehören, jedoch unbedingt erhalten bleiben sollen.
- sd:with-row-searchBeschreibung: Ermöglicht die Festlegung einer Spalte, die für eine Zeilenfilterung genutzt wird. Wenn bsp. das von der Datenbank gelieferte DataSet für ein Kalenderelement mehrere Zeilen zum gleichen Stundenwert hat, dann ermöglicht es dieses Element in einer Tabellenzelle, daß in dieser Tabellenzelle alle zur Zelle (Zeilen- plus Spaltenfilter) gehörenden Zeilen als Einzeleinträge ausgegeben und bsp. auf jeweils unterschiedliche Ziele verlinkt werden.
- sd:with-sortBeschreibung: Dieses Attribut kann die beiden Werte true/false annehmen. Falls 'true', so wird der Spaltenname als Sortierlink ausgegeben. Sind keine -, - und -Attribute belegt, so werden interne Standardgrafiken (, und ) genutzt. Dies sind drei gleich große Grafiken. Sie werden - vom Spaltennamen durch ein Leerzeichen getrennt - ausgegeben, falls nach der aktuellen Spalte aufsteigend, absteigend oder nicht sortiert wird. Im letzten Fall wird ebenfalls eine Grafik eingebunden, um die Gesamtzeichenlänge konstant zu halten und ein Flackern der Anzeige (bei einer Zentrierung) zu vermeiden.
- sd:with-tid-stateBeschreibung: Kann mit 'true' belegt werden. Dann wird an das form.action - Attribut ein Ausdruck __tID=Zufallszeichenfolge angehängt. Die Zufallszeichenfolge wechselt bei jedem Aufruf. Das kann nützlich sein, falls bei iFrame-Einbindungen die Seite nicht aktualisiert wird, weil der Browser der Meinung ist, diese nicht neu senden zu müssen.
Link zur hiesigen Seite als QR-Code
© 2003-2025 Jürgen Auer, Berlin.
Mit dem Klick auf den Button stimmen Sie zu, daß Cookies in Ihrem Browser gespeichert werden.
Informationen zu den gespeicherten Cookies finden Sie unter Datenschutz#Cookies.Bei Fragen zur Technik wenden Sie sich bitte an Server-Daten - Web-Datenbank-Lösungen
Informationen zu den gespeicherten Cookies finden Sie unter Datenschutz#Cookies.Bei Fragen zur Technik wenden Sie sich bitte an Server-Daten - Web-Datenbank-Lösungen