Zweck und Einsatz

Über die Datenschnittstelle können Daten verschiedener Types von unterschiedlichen Datenquellen geladen oder auch manuell eingegeben werden. Über ein Schema können die Datentypen beschrieben und als Object oder ObjectCollection für die Dokumentgenerierung bereitgestellt werden.

Objects und ObjectCollections

Ein Object beschreibt ein Objekt, welches durch ein Schema definiert ist. Das Objekt hat neben dem Schema eine Id und ein (übersetzbares) Label. Ein Beispiel für ein Objekt ist z.B. der Empfänger eines Briefes - auf dem Dokument ist genau einen Empfänger genannt und dieser kann über ein solches Objekt beschrieben werden.

Eine ObjectCollection ist hingegen eine Liste von Objekten. Die Liste von Objekten wird ebenfalls über ein Schema definiert und enthält eine Id und ein (übersetzbares) Label. Ein Beispiel für solch eine Liste von Objekten wäre z.B. Rechnungspositionen aus einem CRM. Auf einer Rechnung, mit einem Empfänger, erscheinen mehrere Rechnungspositionen. Die ObjectCollection erlaubt es, dass man mehrere Objekte, desselben Types, abspeichert.

MERKE
Möchten Sie in einer Vorlage einen Empfänger erlauben, benutzen Sie Objects. Möchten Sie mehrere Empfänger erlauben (z.B. in einem Protokoll), benutzen Sie eine ObjectCollection.

Aufbau

<FormsConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Elements>
    <Object Id="MAdaten" Label="Mitarbeiterdressen">
      [...]
    </Object>
    <ObjectCollection Id="Kundendaten" Label="Kundenadressen">
      [...]
    </ObjectCollection>
  </Elements>
</FormsConfiguration>

Schema

Über das Schema wird die Struktur des Datentypes definiert. Dieses Schema kann verschiedene Elemente enthalten, die Informationen sammeln oder anzeigen können. Unterstützt werden hierbei dieselben Typen wie in der https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/57081857 Dokumentfunktion (Text, Date, YesNo, Choice), mit der Ausnahme, dass eine Group nicht unterstützt wird.

Aufbau

<FormsConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Elements>
    <ObjectCollection Id="Kundendaten" Label="Kundenadressen">
      <!-- Defines the ObjectCollection's elements to use in JavaScript -->
      <Schema>
        <Text Id="CompanyName" Label="Firmenname"  />
        <Text Id="Street" Label="Strasse" />
        <Text Id="PostalCode" Label="PLZ" />
        <Text Id="City" Label="Ort" />
        <Text Id="Country" Label="Land" />
      </Schema>
    </ObjectCollection>
  </Elements>
</FormsConfiguration>

Summary

Grundsätzlich werden alle Text- und Choice-Schema-Elemente für die Anzeige eines Objects/ObjectCollection kommasepariert in der Liste der Suchresultate bzw. in der Auswahlliste angezeigt.
Möchte man hingegen nur bestimmte Felder in der Listenansicht anzeigen, kann man über Summary die angezeigten Felder konfigurieren:

<FormsConfiguration>
  <Elements>
    <ObjectCollection Id="Kundendaten" Label="Kundenadressen">
      <!-- Defines what schema fields are shown in the result list -->
      <Summary>
        <Text Id="CompanyName" />
        <Text Id="City" />
      </Summary>
    </ObjectCollection>
  </Elements>
</FormsConfiguration>

Das Field muss hierbei über die Id auf ein Feld des Schema verweisen.

DataProviders

Um Daten von anderen Quellen zu laden, können DataProviders definiert werden. Für jedes Object bzw. ObjectCollection kann einer oder mehrere DataProvider hinterlegt werden.

Jeder DataProvider hat hierbei folgende Konfigurationsmöglichkeiten:

Attribute

Attributname	Beschreibung

Attributname	Beschreibung
`DisplayName`	Dient als Name für den DataProvider.

Inhalte

Elementname	Beschreibung

Elementname	Beschreibung
`SearchParameters`	Eine Suchmaske muss für den entsprechenden DataProvider konfiguriert werden. Als Syntax kommen die selben Elemente wie in der Funktion (`Text`, `Date`, `YesNo`, `Choice`) zum Einsatz.
`Mapping`	Um die empfangenen Daten auf das `Schema` zu mappen, wird der -Syntax genutzt.
	Jeder DataProvider kann noch weitere, spezifische, Konfigurationsmöglichkeiten anbieten.

Liste der DataProviders

Folgende DataProvider stehen zur Verfügung:

Name	Beschreibung	Link

Name	Beschreibung	Link
`CsvDataProvider`	Zugriff auf .csv-Dateien
`ExcelDataProvider`	Zugriff auf Excel-Dateien
`HttpDataProvider`	Zugriff auf HTTP/HTTPs APIs (REST/Web APIs)
`SqlDataProvider`	Zugriff auf SQL-Datenbanken

Beispiel für einen DataProvider

In folgendem Beispiel wird global ein CsvDataProvider konfiguriert:

Umfassendes Beispiel

In folgendem Beispiel wird zur Auswahl der Empfänger in einer Briefvorlage eine ObjectCollection mit zwei Datenschnittstellen konfiguriert: einem und einem .

XML-Konfiguration

Screenshots

Manuell erfasste Objekte

1) Listenansicht: ohne hinzugefügte Objekte

3) Listenansicht mit hinzugefügten Objekten

Die unter Summary definierten Felder werden in der Listenansicht angezeigt.

2) Objekte manuell erfassen

Die unter Schema definierten Daten werden in diesem Dialog erfasst.

Über Datenschnittstelle gesuchte Objekte

1) Listenansicht: ohne hinzugefügte Objekte

4) Listenansicht mit hinzugefügten Objekten

Die unter Summary definierten Felder werden in der Listenansicht angezeigt.

2) Objekte in DataProvider suchen

3) Resultate aus DataProvider hinzufügen

Die unter Schema definierten Daten werden mit den im DataProvider gefundenen Daten ausgefüllt.