Legacy configuration
In addition to the current configuration options from the Document Parameter, there are options for configuration that are no longer recommended in this way, but for which backward compatibility still works. The corresponding deprecated configuration possibilities are listed on this page.
Changes at a glance
CustomDataNodes (Fields)
<Configuration>
<CustomContentSection [...]>
<DataNodes>
<!-- ## Text ## -->
<CustomDataNode xsi:type="TextNode" Id="DocParam.BeispielText" [...]>[...]</CustomDataNode>
<!-- NEU ↓ -->
<Text Id="DocParam.BeispielText" [...]>[...]</Text>
<!-- ## CheckBox ## -->
<CustomDataNode xsi:type="CheckBoxNode" Id="DocParam.BeispielCheckBox" IsChecked="true" [...] />
<!-- NEU ↓ -->
<CheckBox Id="DocParam.BeispielCheckBox" [...]>true</CheckBox>
<!-- ## DateTime ## -->
<CustomDataNode xsi:type="DateTimeNode" Id="DocParam.BeispielDateTime" DateFormat="dddd, d. MM. yyyy" IsNowDefault="true" [...]>
<DateTime>2016-07-31</DateTime>
</CustomDataNode>
<!-- NEU ↓ -->
<DateTime Id="DocParam.BeispielDateTime" Format="dddd, d. MM. yyyy" [...]>2018-12-31</DateTime>
<!-- ## ComboBox ## -->
<CustomDataNode xsi:type="ComboBoxNode" Id="DocParam.BeispielComboBox" SelectedValue="aKey" [...]>
<ListItems>
<Item><Key><string>empty</string></Key> <Value><string><![CDATA[ ]]></string></Value></Item>
<Item><Key><string>aKey</string></Key> <Value><string>A-Anzeigetext</string></Value></Item>
<Item><Key><string>aKey</string></Key> <Value><string>A-Anzeigetext</string></Value></Item>
<Item><Key><string>bKey</string></Key> <Value><string>B-Anzeigetext</string></Value></Item>
</ListItems>
</CustomDataNode>
<!-- NEU ↓ -->
<ComboBox Id="DocParam.BeispielComboBox" SelectedValue="empty" [...]>
<Item Value="empty" DisplayText=" " />
<Item Value="aKey" DisplayText="A-Anzeigetext" />
<Item Value="bKey" DisplayText="B-Anzeigetext" />
</ComboBox>
</DataNodes>
</CustomContentSection>
[...]
</Configuration>
With and without views
Without views (legacy)
Configuration
<Configuration>
<CustomContentSection xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Name="Dokument-Parameter" WindowWidth="750" WindowHeight="350">
<DataNodes>
<CustomDataNode xsi:type="LabelNode" Id="DocParam.TitleLabel" Row="0" Column="0" ColumnSpan="4" Label="Example dialog" />
<CustomDataNode xsi:type="TextNode" Id="DocParam.Subject" Row="1" Column="1" ColumnSpan="3" Label="Subject" />
<CustomDataNode xsi:type="DateTimeNode" Id="DocParam.DateOfWriting" DateFormat="d. MMMM yyyy" IsNowDefault="true" Label="Datum" Row="2" Column="1" />
<CustomDataNode xsi:type="CheckBoxNode" Id="DocParam.IsConfidential" Label="Vertraulich" Row="3" Column="1" ColumnSpan="3" />
<CustomDataNode xsi:type="ComboBoxNode" Id="DocParam.ReasonForCongratulation" SelectedValue="employeeanniversary" Label="Gratulationsgrund" Row="4" Column="1">
<ListItems>
<Item><Key><string>birthday</string></Key> <Value><string>Birthday</string></Value></Item>
<Item><Key><string>employeeanniversary</string></Key> <Value><string>Employee anniversary</string></Value></Item>
<Item><Key><string>motherfatherhood</string></Key> <Value><string>Mother-/Fatherhood</string></Value></Item>
</ListItems>
</CustomDataNode>
</DataNodes>
</CustomContentSection>
</Configuration>
Dialog
With views (default)
Configuration
<Configuration>
<CustomContentSection xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Name="Dokument-Parameter" WindowWidth="750" WindowHeight="400">
<DataNodes>
<CustomDataNode xsi:type="TextNode" Id="DocParam.Subject" />
<CustomDataNode xsi:type="DateTimeNode" Id="DocParam.DateOfWriting" DateFormat="d. MMMM yyyy" IsNowDefault="true" />
<CustomDataNode xsi:type="CheckBoxNode" Id="DocParam.IsConfidential" />
<CustomDataNode xsi:type="ComboBoxNode" Id="DocParam.ReasonForCongratulation" SelectedValue="employee anniversary">
<ListItems>
<Item><Key><string>birthday</string></Key> <Value><string>Birthday</string></Value></Item>
<Item><Key><string>employee anniversary</string></Key> <Value><string>Employee anniversary</string></Value></Item>
<Item><Key><string>mother-/fatherhood</string></Key> <Value><string>Mother-/Fatherhood</string></Value></Item>
</ListItems>
</CustomDataNode>
</DataNodes>
</CustomContentSection>
<Views>
<View Id="main" Label="Homepage">
<Row>
<TextBlock Style="h1" ColumnSpan="4">Sample dialog</TextBlock>
</Row>
<Row>
<Separator ColumnSpan="4" />
</Row>
<Row>
<Label Content="Subject" />
<TextBox Id="DocParam.Subject" ColumnSpan="3" />
</Row>
<Row>
<Label Content="Date" />
<DatePicker Id="DocParam.DateOfWriting" />
</Row>
<Row>
<CheckBox Id="DocParam.IsConfidential" Label="Confidential" ColumnOffset="1" ColumnSpan="3" />
</Row>
<Row>
<Label Content="Reason for congratulation" />
<ComboBox Id="DocParam.ReasonForCongratulation" />
</Row>
<Button Type="Submit" Label="OK" IsDefault="true" />
<Button Type="Cancel" Label="Cancel" />
</View>
</Views>
</Configuration>
Dialog
Usage of "CustomDataNode" with "xsi:type"
Basic structure of a CustomDataNode:
These three attributes must be present in any case, regardless of the type, otherwise the CustomDataNode will not work properly.
CustomDataNode basic attributes
These attributes apply to use with and without views.
WARNING
The configurations on this page are deprecated and should no longer be used.
There is a more compact and structured configuration type. See this page.
Name | Description |
---|---|
Type (xsi:type) | TextNode DateTimeNode CheckBoxNode ComboBoxNode RadioButton
Definition of a RadioButton with a ComboBoxNode How the RadioButtons are then defined in the view is described in the corresponding chapter. Without views RadioButtons cannot be defined. LabelNode Heading in document parameter dialog when views are not used, not suitable for use in editor, scripts and extended bindings |
Id | Textual Id, which must be unique. This is displayed in editor mode and then needed for use in editor, scripts or extended bindings. The Id must not contain any spaces. |
DateFormat | Attribute that is only allowed for DateTimeNodes; definition of the date format e. g. "dd MM yyyy" for "02.06.2016". List of date formats There are several date formats stored in the Global Translations base configuration that can be accessed. |
IsNowDefault | Attribute that is only allowed for DateTimeNodes. It sets the initial date to the current date. |
Calendar | Attribute which is only valid for DateTimeNodes. It sets the format of the calendar. Default is "Gregor". It is not mandatory to set this attribute. |
Required | Attribute that is only allowed for TextNodes. It defines whether the field may be left empty (Required="false" or not set) or whether the field must be filled in (Required="true"). As long as the text field is not filled in, the OK button for confirming the input in the document parameter remains grayed out and unclickable. As soon as the required characters are filled in the text field, the OK button can be clicked. |
Regex | Attribute, which is only allowed for TextNodes. It allows to define a regex (.NET syntax) that must find at least one match in the entered text. Attention: if the whole text must match or there must be exactly one 'match', this must be defined by the regex expression. Examples Regex="^[0-9]+$" forces that all characters of the input text must be digits and that at least one digit must be present. (^ matches the beginning of the input text and $ matches the end) |
ValidationMessage | Attribute, which is only allowed for TextNodes. If Required="true" or a validation regex is set, ValidationMessage allows a custom error message if validation fails. It will be displayed when the mouse pointer hovers over the red exclamation mark on the right side of the text field. If ValidationMessage is not set, a default message will be displayed in case of a mismatch. |
Tracked | The primedocs function Quick Check (check content controls) is activated with the 'Tracked' attribute. If the value is set to 'true', the field will be displayed to the user in the separate panel. Provided that the content of the element is empty, the field will be displayed red in the panel and green after editing. |
Label | Label the element in the Quick Check panel in Word. The Tracked attribute is a prerequisite. |
SelectedValue | Attribute that is only allowed for ComboBoxNodes. This attribute determines which option in the list should be selected by default. |
IsChecked | Attribute which is only valid for CheckBoxNodes. This attribute determines whether the CheckBox should be checked or unchecked by default. |
Locked | Has no effect. Was originally intended to prevent the content control from being deleted in Word. |
ReadOnly | Has no effect. Was originally intended to prevent the content control from being edited in Word. |
LCID | The LCID (locale identifiers) define the language culture of the corresponding DataNode. If the LCID is not set, the DataNode will not work. List of LCID codes |
Configurations without "Views"
Basic configuration without using Views:
CustomDataNode additional attributes without views
These attributes are only valid for use without views.
WARNING
The configurations on this page are deprecated and should no longer be used.
There is a more compact and structured configuration type. See this page.
Name | Description |
---|---|
Row | Row in which the element is to be displayed in the document parameter dialog. |
Column | Column in which the element is to be displayed in the document parameter dialog (starting point). There are 4 columns with the Label column. |
ColumnSpan (Length) | Length respectively number of columns the element should span. |
Label | Label of the element in the document parameter dialog; also applies to headings of the type LabelNode. If several elements are displayed in one line, the label of the first element is used. The label always appears in the leftmost column. If Tracked is set to true, the label also acts as the element's caption in the Quick Check panel. |
Visible | If Visible is set to false, the document parameter will not be displayed in the dialog. |
ToolTip (Hint) | Hint that is displayed when the user hovers over it with the mouse. Overridden by ValidationMessage if it is set. |
IsInputEnabled | Attribute only allowed for elements of type CheckBoxNode. If this option is set to true, checkboxes are displayed in the document parameter dialog where the user can edit or freely select the caption. |
MultiLine | Attribute only allowed for elements of type TextNode. Creates multiline text fields if set to true. |
MultilineRows (Number of displayed rows for multiline) | Attribute only allowed for elements of type TextNode (incl. Multiline="true"). Defines the number of displayed rows in multiline text fields (defaults to 3). |
IsSearchEnabled (Enable search for combo boxes) | Attribute only allowed for elements of type ComboBoxNode. This option determines whether keyboard input can be used to search for existing entries in the combo box. |
IsEditable (Allow any input for combo box) | Attribute only allowed for elements of type ComboBoxNode. This option determines whether the user can make any input. If this attribute is not set to true the user can only choose between the existing entries. |
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland