Versions Compared

Key

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

...

Attribute und Elemente für jeden Typ DataSource

Name

Beschreibung

Beschreiutesbung

Id (Optional, Attribut)

Gibt der DataSource eine eindeutige Id.

ConnectionProviderConnection
(Zwingend, Element)

Definiert den ConnectionProvider für den entsprechenden Datenbank-Typen. Über diesen Provider wird die Verbindung zur Datebank hergestellt.
Übersicht über die ConnectionProvider des .NET Frameworks

ConnectionStringConnctionString
(Zwingend, Element)

Der ConnectionString bietet die nötigen Informationen zum Herstellen der Verbindung auf die Datenbank. Jede Datenbank definiert ihr eigenes Format für den ConnectionString.

Selector
(Zwingend, Element)

Definiert die Datenbankabfrage (Query) und das entsprechende Mapping auf die DataNodes.

...

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.

...

Code Block
languagexml
<Result>
  <CollectionMap Id="MAList" /> 
</Result>

Die ColletionMap CollectionMap braucht nur die Id der entsprechenden Collection auf die die Werte geschrieben werden sollen. Diese Collection ist zwingend in den ViewDataNodes zu definieren. Die Collection wird dann folgendermassen befüllt:

...