Formulare (Forms)


Zweck und Einsatz

Über diese Dokumentfunktion können Eigenschaften über ein Formular abgefragt werden, indem man Textboxen, Checkboxen, Dropdowns etc., sogenannte Elemente, konfiguriert.

Diese Funktion steht in “classic” Vorlagen nicht in vollem Funktionsumfang zur Verfügung.
Weitere Informationen zu den verschiedenen Vorlagen Versionen finden Sie hier.

Grundaufbau

<FormsConfiguration> <Elements> <!-- Formularelemente und Gruppen hier einfügen --> </Elements> </FormsConfiguration>

Designer

Öffnet man Forms im Vorlageneditor, landet man automatisch auf der einfachen Ansicht. Via Klick auf die Vorschau, gelangt man in den Forms-Designer. Der Designer ermöglicht einem das Formular im Handumdrehen in einer Benutzeroberfläche zusammenzustellen.

Forms-SimpleEditor-20240112-173437.png

Ein Formular besteht aus verschiedenen Elementen: Strukturelementen, die zur Übersichtlichkeit des Formulars beitragen, sowie Formularelementen, deren vom Benutzer eingegebenen Werte schlussendlich im Dokument landen.

Forms-SimpleEditor-Options-20240112-173854.png

Hinter der Benutzeroberfläche des Designer steht eine XML-Konfiguration für jedes Element. Diese findet man über den Button “Erweiterte Ansicht”. Alle Elemente werden nun im folgenden Kapitel beschrieben.

Beispiel

<FormsConfiguration> <Elements> <Text Id="Subject" translate-Label="Forms.Subject" /> <Date Id="Date" translate-Label="Forms.Date" RelativeDate="Today" translate-Format="Configuration.DateFormat.WrittenOut" /> <AdditionalProfile Id="MainSigner" Label="Hauptunterzeichnende*r" PreselectByIndex="1" /> <AdditionalProfile Id="CoSigner" Label="Mitunterzeichnende*r" /> <Group Title="Weitere Einstellungen"> <YesNo Id="ShowContact" Label="Kontakt anzeigen" Value="true"> <ElementsIfYes> <Choice Id="ContactFormOption" Label="Anzeigeart" SelectedValue="0"> <Option Value="0" Label="Unpersönlicher Kontakt" /> <Option Value="1" Label="Persönlicher Kontakt" /> </Choice> </ElementsIfYes> </YesNo> </Group> <GlobalElements Key="Forms.Attachments" /> </Elements> </FormsConfiguration>

Übersicht

Folgende Forms-Elemente sind möglich:

Strukturelemente

  • Group

  • Info

Formularelemente

  • Text

  • Date

  • YesNo (Checkbox)

  • Choice (Dropdown)

  • AdditionalProfile

  • Object oder ObjectCollection

  • GlobalSchemaAndSummary (globale abgelegte Schema/Summary-Konfiguration)

  • GlobalDataProviders (global abgelegter DataProvider)

  • GlobalElements (global abgelegte Forms-Konfiguration)

Weitere Profile in Vorlage integrieren

Die Profilfelder des Benutzers, der ein Dokument generiert, werden automatisch während der Dokumenterstellung bereitgestellt und beinhalten z. B. die Organisationsdaten wie Logos oder Postanschriften sowie die persönlichen Benutzerdaten. Mittels Profilwechsel im primedocs-Ribbon werden in einem Dokument, das Profilfelder enthält, die Daten des ausgewählten Profils angezeigt.

Mittels AdditionalProfile können noch zusätzliche Profile in das Dokument integriert werden. Diese Profilauswahl zeigt die Profile des eigenen Benutzers oder ihm freigegebene Fremdprofile an.
Somit sind AdditionalProfiles für Anwendungsfälle gedacht, in denen andere Personen aus der Firma im Dokument auftauchen sollen. Die Anwendung von AdditionalProfile ist zum Beispiel sinnvoll…

  • bei zusätzlichen Unterschriften in einer Vorlage.

  • bei der Zusammenarbeit mit weiteren Mitarbeitenden oder Abteilungen in einer Vorlage. z. B. in einer Vorlage soll neben der Fachbereichsleiterin auch die Kostenstellenverantwortliche erwähnt werden.

  • in weitaus mehr Anwendungsfällen.

In der Vorlage müssen folglich auch die entsprechenden Forms-Felder des AdditionalProfile eingefügt sein.

Adaptive Dateneingabemaske

Forms ermöglicht das Anzeigen von Feldern aufgrund eines bedingten Wertes. In den Formularelementen YesNo und Choice kann man dadurch aufgrund eines Wertes das Erscheinen von weiteren Formularelementen steuern. Die möglichen Formularelemente, die erscheinen können, sind: Text, Date, Choice, YesNo und Info.
Beispiel: ein Info-Element soll nur angezeigt werden, wenn das YesNo-Feld aktiviert (= true) ist:

Die Elemente für die adaptive Dateneingabemaske heissen ElementsIfYes / ElementsIfNo bei YesNo-Elementen (für true und false) und ElementsIfValue bei Choice-Elementen (für einen spezifischen Wert). Beispiele für die XML-Konfiguration und die Dokumentation der ElementsIf-Elemente finden Sie unter Choice und YesNo.

<YesNo Name="ShowThing" Label="Muss unterzeichnet werden"> <ElementsIfYes> <Info>Bitte sicherstellen, dass ein Signaturbild hinterlegt ist.<Info> </ElementsIfYes> </YesNo>

Elemente

Gruppen

Gruppen sind Strukturelemente und gruppieren Formularelemente mit <Group>...</Group> für die visuelle Darstellung.

Beispiel in XML

Gruppen dürfen nicht weitere Gruppen enthalten (es gibt keine Verschachtelung).

Attribute für Group

Attributname

Beschreibung

Attributname

Beschreibung

Title
(optional)

Titel, der auf der Eingabeoberfläche angezeigt wird.


Info

Dieses Element erlaubt die Anzeige von Informationstext im Forms-Dialog. Der anzuzeigende Text wird als Inhalt des Info-Elements angegeben.

Beispiel in XML


Text

Das Text-Element bietet dem Benutzer die Möglichkeit, in Forms einen Text einzugeben. Es wird entsprechend typischerweise als Textfeld angezeigt. In der Vorlage wird ein Nur-Text-Inhaltssteuerelement (Plain Text Content Control) eingefügt.

Beispiele in XML mit Vorschau

Simpel:

Erweitert:

Attribute für Text

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus Subject wird z. B. Forms.Subject).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

Value
(optional)

Vordefinierter Text, den der Benutzer bearbeiten kann.

MultiLine
(optional)

Wenn true: Möglichkeit in der Eingabeoberfläche, Zeilenumbrüche einzufügen.

Required
(optional)

Wenn true: Der Benutzer muss eine Eingabe tätigen, der Text darf nicht leer sein und nicht nur aus Leerzeichen bestehen. Empfohlen: Zusätzlich eine spezifische ValidationMessage konfigurieren.

OnlyVisibleDuringGeneration
(optional)

Wenn true: Das Feld wird nur beim erstmaligen Generieren des Dokuments angezeigt. Öffnet der Benutzer den Forms-Dialog erneut im primedocs Ribbon im offenen Dokument, wird es nicht mehr angezeigt.

Inhalte für Text

Elementname

Beschreibung

Elementname

Beschreibung

Description
(optional)

Zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche als Tooltip angezeigt.

ValidationMessage
(optional)

Text, der dem Benutzer angezeigt wird, wenn dieses Textfeld ungültig ausgefüllt wurde.

 


Date

Das Date-Element bietet dem Benutzer die Möglichkeit, in Forms ein Datum auszuwählen. Es wird entsprechend typischerweise als Date picker angezeigt. In der Vorlage wird ein Datumsauswahl-Inhaltssteuerelement (Date Picker Content Control) eingefügt.

Beispiele im XML mit Vorschau

Simpel:

 

Erweitert: mit Value und Required:

 

Erweitert: mit RelativeDate:

Gerechnet ab Datum: 12.01.2024

Attribute für Date

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus CreationDate wird z. B. Forms.CreationDate).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

Format
(erforderlich)

Definition des Datumformates, z. B. dd.MM.yyyy für "31.12.2020" oder d. MMMM yyyy für "31. Dezember 2020". Siehe Liste mit Datumsformaten.
In der Basiskonfiguration befinden sich in den globalen Übersetzungen mehrere Datumsformate, auf die zugegriffen werden kann.

Required
(optional)

Wenn true: Der Benutzer muss ein Datum auswählen, das Datum darf nicht leer sein.
Empfohlen: Zusätzlich eine spezifische ValidationMessage konfigurieren.

Value
(optional)

Vorausgewähltes fixes Datum, das der Benutzer bearbeiten kann.
Format: yyyy-MM-dd, z. B. 2020-12-31
Kann nicht in Kombination mit RelativeDate verwendet werden.

RelativeDate
(optional)

Vorausgewähltes Datum, das der Benutzer bearbeiten kann und das relativ zum Zeitpunkt der Dokumenterstellung ist.

  • Wenn Today: Datum der Dokumenterstellung

  • Wenn FirstDayOfMonth: Erster Tag des Monats der Dokumenterstellung

  • Wenn FirstDayOfYear: Erster Tag des Jahres der Dokumenterstellung

Die Attribute OffsetMonths und OffsetDays können verwendet werden, um das relative Datum weiter anzupassen. Beispiele:

  • Aktueller Tag: RelativeDateOption="Today"

  • Erster Tag des aktuellen Monats: RelativeDateOption="FirstDayOfMonth"

  • Letzter Tag des vorherigen Monats: RelativeDateOption="FirstDayOfMonth" OffsetDays="-1"

  • Letzter Tag des aktuellen Monats: RelativeDateOption="FirstDayOfMonth" OffsetMonths="1" OffsetDays="-1"

  • Letzter Tag des vorherigen Jahres: RelativeDateOption="FirstDayOfYear" OffsetDays="-1"

  • Letzter Tag des aktuellen Jahres: RelativeDateOption="FirstDayOfYear" OffsetMonths="12" OffsetDays="-1"

OffsetMonths
(optional)

Anzahl Monate, die zum relativen Datum dazu addiert werden (positive und negative Zahlen erlaubt). Siehe RelativeDateOption.

OffsetDays
(optional)

Anzahl Tage, die zum relativen Datum dazuaddiert werden (positive und negative Zahlen erlaubt). Siehe RelativeDateOption.

OnlyVisibleDuringGeneration
(optional)

Wenn true: Das Feld wird nur beim erstmaligen Generieren des Dokuments angezeigt. Öffnet der Benutzer den Forms-Dialog erneut im primedocs Ribbon im offenen Dokument, wird es nicht mehr angezeigt.

Inhalte für Date

Elementname

Beschreibung

Elementname

Beschreibung

Description
(optional)

Zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche als Tooltip angezeigt.

ValidationMessage
(optional)

Text, der dem Benutzer angezeigt wird, wenn dieses Datumsfeld ungültig ausgefüllt wurde.


YesNo

Das YesNo-Element bietet dem Benutzer die Möglichkeit, in Forms eine Option zu aktivieren ("Ja") oder zu deaktivieren ("Nein"). Es wird entsprechend typischerweise als Checkbox angezeigt. In der Vorlage wird ein Kontrollkästchensteuerelement (Check Box Content Control) eingefügt.

Beispiele in XML mit Vorschau

Simpel:

 

Erweitert mit adaptiver Dateneingabe

Attribute für YesNo

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus MustBeSigned wird z. B. Forms.MustBeSigned).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

Value
(optional)

Wenn true: Die YesNo-Option ist zu Beginn aktiviert.

RequiredValue
(optional)

Wenn true: Der Benutzer muss die YesNo-Option aktivieren.
Wenn false: Der Benutzer muss die YesNo-Option deaktivieren.
Empfohlen: Zusätzlich eine spezifische ValidationMessage konfigurieren.

OnlyVisibleDuringGeneration
(optional)

Wenn true: Das Feld wird nur beim erstmaligen Generieren des Dokuments angezeigt. Öffnet der Benutzer den Forms-Dialog erneut im primedocs Ribbon im offenen Dokument, wird es nicht mehr angezeigt.

Inhalte für YesNo

Elementname

Beschreibung

Elementname

Beschreibung

ElementsIfYes
(optional)

Adaptive Dateneingabe: ist der Wert true, werden alle Forms-Elemente angezeigt, die zwischen <ElementsIfYes> und </ElementsIfYes> eingegeben sind.

ElementsIfNo
(optional)

Adaptive Dateneingabe: ist der Wert false, werden alle Forms-Elemente angezeigt, die zwischen <ElementsIfNo> und </ElementsIfNo> eingegeben sind.

Description
(optional)

Zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche als Tooltip angezeigt.

ValidationMessage
(optional)

Text, der dem Benutzer angezeigt wird, wenn diese YesNo-Option ungültig ausgefüllt wurde.


Choice

Das Choice-Element bietet dem Benutzer die Möglichkeit, in Forms zwischen mehreren Optionen auszuwählen. Es wird entsprechend typischerweise als Dropdown angezeigt. In der Vorlage wird ein Datumsauswahl-Kombinationsfeld-Inhaltssteuerelement (Combo Box Content Control) eingefügt.

Beispiele im XML mit Vorschau

Simpel:

Erweitert mit adaptiver Dateneingabe:

Attribute für Choice

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus Classification wird z. B. Forms.Classification).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

Required
(optional)

Wenn true: Der Benutzer muss eine Option auswählen.
Empfohlen: Zusätzlich eine spezifische ValidationMessage konfigurieren.

SelectedValue
(optional)

Vorausgewählte Option: Hier muss der Wert, der bei der gewünschten Option im Value-Attribut steht, angegeben werden.

EmptyOptionLabel
(optional)

Beschriftung der Option, die "nichts ausgewählt" symbolisiert.

OnlyVisibleDuringGeneration
(optional)

Wenn true: Das Feld wird nur beim erstmaligen Generieren des Dokuments angezeigt. Öffnet der Benutzer den Forms-Dialog erneut im primedocs Ribbon im offenen Dokument, wird es nicht mehr angezeigt.

Inhalte für Choice

Elementname

Beschreibung

Elementname

Beschreibung

Option
(erforderlich,
mehrere möglich)

Mögliche Auswahl. Es muss mindestens eine mögliche Auswahl konfiguriert werden.
Attribute:

  • Value: Entspricht Value von ComboBox-DataNode beim Dokument-Parameter.

  • Label: Entspricht DisplayText von ComboBox-DataNode beim Dokument-Parameter.

Description
(optional)

Zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche als Tooltip angezeigt.

ValidationMessage
(optional)

Text, der dem Benutzer angezeigt wird, wenn diese Auswahl ungültig ausgefüllt wurde.


AdditionalProfile

Das AdditionalProfile-Element ermöglicht dem Benutzer das Auswählen eines zusätzlichen Profils. Die vom Benutzer erstellten Profile sowie die dem Benutzer freigegebenen Fremdprofile werden im Forms in einem Dropdown angezeigt und können ausgewählt werden.

Da ein Profil auf dem Benutzer basiert und ein Benutzer verschiedene Benutzerfelder hat (z.B. Vorname, Telefonnummer, Funktion, Signaturbild etc.), werden in der Vorlage alle Benutzerfelder eines Benutzers zum Einfügen angeboten. Da ein Benutzerfeld entweder ein Text, eine Checkbox oder ein Bild ist, kann in der Vorlage das dementsprechende Inhaltssteuerelement eingefügt werden.

Beispiel

Der meistverwendete Fall in dem ein AdditionalProfile eingesetzt wird, ist die Unterzeichnung eines Dokuments. Zum Beispiel möchte man dem Benutzer für einen Brief zwei AdditionalProfiles anbieten: das erste mit einer Vorselektion des eigenen Profils und das zweite zur freien Auswahl einer mitunterzeichnenden Person.

Attribute für AdditionalProfile

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus Classification wird z. B. Forms.Classification).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

PreselectByIndex
(optional)

Erfordert die Eingabe einer ganzen Zahl (1, 2, 3, …, n).
Wenn 1: Das im Unterschriftsprofil erste hinterlegte Profil wird vorselektiert.
Wenn n: Wenn eines hinterlegt ist, wird das im Unterschriftsprofil nte Profil vorselektiert.

Inhalte für AdditionalProfile

Elementname

Beschreibung

Elementname

Beschreibung

Description
(optional)

Zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche als Tooltip angezeigt.


Objects und ObjectCollections

Object bzw. ObjectCollection s können definiert werden, um Objekte, wie z. B. einen Empfänger, Rechnungspositionen oder beliebige andere Datenobjekte in der Vorlage abzubilden.

Ein Object bzw. eine ObjectCollection wird in Forms folgendermassen angezeigt:

Attribute für Object bzw. ObjectCollection

Attributname

Beschreibung

Attributname

Beschreibung

Id
(erforderlich)

Wird zur Identifikation benötigt (Einfügen in der Vorlage, Verwendung in Feldern). Darf keine Leerzeichen enthalten und muss eindeutig sein. Forms fügt automatisch den Präfix Forms. hinzu (aus Classification wird z. B. Forms.Classification).

Label
(erforderlich)

Beschreibung des Elements in der Eingabeoberfläche

Inhalte für Object bzw. ObjectCollection

Elementname

Beschreibung

Elementname

Beschreibung

Schema

Definiert alle benötigten Daten, die schlussendlich in einer Vorlage verwendet können sollen.

Summary

Definiert, welche Felder in der Listenansicht angezeigt werden sollen.

DataProviders
(optional)

Definiert Datenquellen, um Objekte z.B. von einem CRM, einer Web-API oder anderen Quellen zu laden.

Wie jedes Element, können auch Objects oder ObjectCollections in einer Forms-Konfiguration beliebig oft definiert werden. Mehr Informationen sind auf der Seite Datenschnittstelle nachzulesen.

Beispiel Anwendungsfall Vorlage “Protokoll“

Das folgende Beispiel zeigt den Grundaufbau einer ObjectCollection. Sie besteht aus Schema, Summary sowie DataProviders.

XML-Konfiguration

Screenshots

1) Listenansicht: ohne hinzugefügte Objekte

 

3) Listenansicht mit hinzugefügten Objekten

In der Listenansicht werden FirstName, LastName und Alias angezeigt (in Summary definiert).

2) Forms: Objekte erfassen

In der Protokoll-Vorlage werden die Daten für die Eingaben von FirstName, LastName, Alias sowie den YesNo-Werten von IsLead und IsProtocol verwendet (in Schema definiert).

 


Zugriff auf global abgelegte Einträge

Es gibt die folgenden Typen von globalen Einträgen, die in einer Forms-Konfiguration referenziert werden können:

  • GlobalSchemaAndSummary → eine global abgelegte Konfiguration mit den Elementen Schema und Summary.

  • GlobalDataProviders → eine global abgelegte Konfiguration mit den Elementen CsvDataProvider, ExcelDataProvider, GlobalDataProviders, HttpDataProvider oder SqlDataProvider.

  • GlobalElements → alle anderen Elemente (z.B. Text oder YesNo) exklusive Group.

Mehr Informationen zu den Globalen Konfigurationen sind hier zu finden: Globale Konfigurationen | Umgang mit typisierten Feldern.

Attribute für GlobalElements, GlobalSchemaAndSummary und GlobalDataProviders

Die Referenz auf einen globalen Eintrag passiert bei allen Typen mittels dem Key-Attribut. Wählt man dieses aus, wird einem automatisch, abhängig vom gewählten Typ, eine Liste mit allen zur Verfügung stehenden globalen Einträgen angezeigt.

Attributname

Beschreibung

Attributname

Beschreibung

Key
(erforderlich)

Die ID des globalen Eintrags, der referenziert werden soll.

Beispiel

Ein konkretes Beispiel zum Erkennen des Zusammenhangs zwischen dem globalen Eintrag und der Referenz auf einen globalen Eintrag gibt es hier: Globale Konfigurationen | Globale Einträge in den Vorlagen referenzieren.

GlobalSchemaAndSummary

Dieses Element holt einen Eintrag aus den Globalen Konfigurationen vom Typ FormsGlobalSchemaAndSummary, um ein Object oder eine ObjectCollection zu konfigurieren.

GlobalDataProviders

Dieses Element holt einen Eintrag aus den Globalen Konfigurationen vom Typ FormsGlobalDataProviders, um ein Object oder eine ObjectCollection zu konfigurieren.

GlobalElements

Dieses Element holt einen Eintrag aus den Globalen Konfigurationen vom Typ FormsGlobalElements.


Übersetzungen

Alle obengenannten Elemente können mit Übersetzung angezeigt werden. Wird ein Attribut mit dem Präfix translate- verwendet, muss das entsprechende Attribut nicht auch konfiguriert werden. Stattdessen wird die jeweilige ID eines Übersetzungseintrags von den Globalen Übersetzungen angegeben.

Attribute

Attributname

Beschreibung

Attributname

Beschreibung

translate-Label

(optional)

Übersetzte Beschreibung des Elements in der Eingabeoberfläche.

translate-Description

(optional)

Übersetzte zusätzliche Informationen für den Benutzer, der das Formular ausfüllt. Wird in der Eingabeoberfläche angezeigt.

translate-ValidationMessage
(optional)

Übersetzter Text, der dem Benutzer angezeigt wird, wenn diese Auswahl ungültig ausgefüllt wurde.

translate-Value
(optional)

Übersetzter, vordefinierter Wert (je nach Elementart), den der Benutzer bearbeiten kann.

Anwendungsbeispiel mit translate- Attributen

Erklärung des Anwendungsbeispiels

  • Alle Formularelemente haben eine übersetzte Beschreibung (Label), z.B. das Textfeld Subject.

  • Das Textfeld Title hat einen fix hinterlegten Wert.

  • Die CheckBox ShowSalutation hat eine zusätzliche übersetzte Information.

  • Das Textfeld CopyTo muss zwingend ausgefüllt werden und hat eine übersetzte Validierungsnachricht.

  • Das Datumsfeld Date hat ein Datumsformat, das in einem globalen Übersetzungseintrag ist, weil es sprachabhängig ist (z.B. im Fall von 05.08.2024 (Deutsch) und 08/05/2024 (Englisch)).


Glossar

Deutsch

Englisch

Beschreibung

Deutsch

Englisch

Beschreibung

Forms

Forms

Name der neuen Dokumentfunktion, Gegenstück in classic-Vorlagen: "Dokument-Parameter"

Forms-Dialog

Forms dialog

Bezeichnung für den neuen Dialog, Gegenstück in classic-Vorlagen: "Dokument-Parameter-Dialog"

Formularelement

Form element

Ein Input-Element im Forms-Dialog, z. B. vom Typ "Text" oder "Choice"

Strukturelement

Structural element

Elemente, die im Forms-Dialog angezeigt werden, die aber keinen Input anfordern und daher nicht im Document Part landen

Feld

Field

Alle Formularelemente, welche schlussendlich im Document Part landen

Nur-Text-Inhaltssteuerelement

Plain Text Content Control

Word-Content Control, das nur Text enthalten kann (offizielle Bezeichnung im Word-GUI)

Datumsauswahl-Inhaltssteuerelement

Date Picker Content Control

Word-Content Control, bei dem ein Datum ausgewählt werden kann (offizielle Bezeichnung im Word-GUI)

Kontrollkästchensteuerelement

Check Box Content Control

Word-Content Control mit CheckBox-Symbol, das aktiviert und deaktiviert werden kann (offizielle Bezeichnung im Word-GUI)

Dropdownlisten-Inhaltssteuerelement

Drop-Down List Content Control

Word-Content Control, beidem aus vorgegebenen Optionen ausgewählt werden kann (offizielle Bezeichnung im Word-GUI)

Kombinationsfeld-Inhaltssteuerelement

Combo Box Content Control

Word-Content Control, beidem aus vorgegebenen Optionen ausgewählt und auch irgendein gewünschter Text eingegeben werden kann (offizielle Bezeichnung im Word-GUI)

Objekt

Object

Ein Objekt wird über ein Schema definiert. Objekte lassen sich manuell oder über DataProvider abfüllen.

Objektliste

ObjectCollection

Eine Ansammlung von Objekten. Der Unterschied zum Objekt liegt darin, dass die Liste mehre Objekte des gleichen Types speichern kann.

DataProvider

DataProvider

Definiert eine Quelle für Objekte.

Ausführliches Beispiel

Code

Forms

Felder

Screenshot

 

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland