Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Datenbanktypen und ihre typenspezifische Attribute

Typ

Attribute

SqlDataSource

SafeQuery
Wenn der Wert auf "true" gesetzt ist (Standard), dann werden etwaige Parameter (siehe Selector → Query) in der Query nicht mit den aktuellen Werten ersetzt. Es wird hingegen eine Parameter-Liste mit dem Key-Value-Paar an die Datenbank gesendet. Diese ersetzt dann die Werte in der Query. Dadurch entsteht eine erhöhte Sicherheit betreffend SQL-Injection.

...

Der Selector definiert den Ausführzeitpunkt, die auszuführende Datenbankabfrage und das entsprechende Mapping auf die DataNodes. Eine DataSource kann beliebig viele Selectoren enthalten.

Name

Beschreibung

Id (Optional, Attribut)

Innerhalb einer DataSource eineindeutig

LoadBehavior (Zwingend, Attribut)

Definiert, bei welcher Art von Aufruf des Dokument-Parameters die Abfrage ausgelöst werden soll. Die möglichen LoadBehaviors sind:
OnlyOnce: bei erster Initierung des Dokument-Parameters
Always: immer wenn der Dokument-Parameter-Dialog aufgerufen wird (auch wenn er aus dem generierten Dokument heraus geöffnet wird).

Query

(Zwingend, Element)

Die Abfrage, die auf der Datenbank ausgeführt wird. Mit {} können Platzhalter eingesetzt werden, und so z. B. auf den Wert eines DataNodes verweisen → {DocParam.ValueToInject}. Wenn Platzhalter eingesetzt werden, muss beachtet werden, dass die CustomElements, die angesprochen werden, einen validen Standardwert haben. Sonst kann es sein, dass die Abfrage fehlschlägt. Dies kann dazu führen, dass das Öffnen des Dokument-Parameter-Dialoges fehlschlägt. Wenn in der Query ein < oder ein > verwendet wird, dann muss diese in einem <![CDATA[InsertQueryHere]]>-Tag stehen.

Result

(Zwingend, Element)

Das Result-Element des Selectors enthält die Information, wie die Werte aus der Datenbank auf die CustomElements gemappt werden sollen.
Dabei wird zwischen zwei Typen unterscheiden: CollectionMap und SingleMap. Die genaue Anwendung ist aufgrund der Komplexität unter dieser Tabelle aufgeführt.

...