Data Definition Group

To create a Content Wizard with Data Definitions you have to configure this at the project level on the tab Data. Refer to topic Data in the Project Configuration Help for more information on configuring a project for Data Definitions. Refer to the section Data Definitions in the general Manual of the ITP/MDK Repository for more information on the concepts of a Data Definition.

To create a Content Wizard that is associated with a Data Definition you have to create a Content Wizard folder first. On this folder you can configure which Data Definition you want to use for the Content Wizards in this folder. Although you can create any number of Content Wizards in a folder, they will only be associated with one Data Definition. Refer to the topic Content Wizard folder Data Definitions for more information on configuring a Content Wizard folder for Data Definitions.

If you open a Content Wizard in a correctly configured folder you will see a Data Definition pane on the right side of the Content Wizard Editor. If this pane is not visible when opening the Content Wizard Editor, you can enable it in the View menu. If the option cannot be enabled, you should check if you are authorized for working with Data Definitions.

This pane presents the Data Definition structure as created in the Data Definition document. You can compare the structure in the Content Wizard Editor with the structure of the Data Definition object by opening it in the Data Definition Viewer. The main difference is that the Data Definition Viewer also presents an overview of the available Fieldsets. You can activate this viewer with the option View in the context menu of the Data Definition object.

You can add Data Definition Groups to other Data Definition Groups, to Sections or to the Content Wizard node. The Data Definition Groups have a structured relationship that is visible in the Data Definition pane. When moved to the editor pane it is possible to switch the order of the Data Definition Groups of the same level. However, it is not possible to switch the level order of Data Definition Groups if this does not match the structure of the Data Definition.

Data Definition Groups will not appear as text in the result document. Data Definition Groups do control, however, which texts will appear in the result document.

When selecting an element in the editor pane, an arrow indicates to what part of the Data Definition it refers. Bold items in the Data Definition pane indicate which Data Definition members can be added on that level.

arrow_DS:

Presents the relation between a Data Definition element in the editor and the related part of the Data Definition

Example Data Definition order:

Customer
  +--Partner
  |    +--PartnerProducts
  |    +--PartnerChildren
  +--Products
  +--Children

In the structure as presented in the example above, you can add Data Definition Groups based on Partner, Products, and Children in any order to the Content Wizard. However, it is not allowed to add a Data Definition Group based on PartnerProduct to the Content Wizard directly. Data Definition Groups based on PartnerProducts or PartnerChildren can only be added to the Data Definition Group based on Partner. It is also not allowed to add Data Definition Groups based on Products or Children to a Data Definition Group based on Partner, since this would violate the structure of the Data Definition.

Sections and Selection Groups do not affect this order. You can freely mix Data Definition Groups with these elements and add Data Definition Groups to sections as long as this does not violate the structure of the Data Definition.

The element Data Definition Group is based on a node of a Data Definition in this Content Wizard. Data Definition nodes can have the following types:

When selecting a member you can recognize the type in by the icon.

Shows when <Data Definition data> is present

Contents of the Data Definition Group will only be shown if the related Data is present for the associated Data Definition. If you add a Data Definition Group based on Partner to the Content Wizard, then any Content Wizard element and other Data Definition Groups will only be shown to the end user and applied if a Partner is present in the Data for that Data Definition.

If Text Blocks use Fields that are available in the Data Structure Partner, these Fields will have the values that are assigned to the Fieldsets in the member Partner.

Repeats for every <Data Definition data>

This is a part of the Data Definition that will be repeated for each occurence in the Data of that Data Definition part. Each repetition has its own data. For instance, a customer has a number of products. Then this could be expressed in a Data Definition Customer that contains a node Products, which, in this context, repeats for every occurrence of Data for products. This means that if you add a Data Definition Group based on Products to the Content Wizard, then any Content Wizard element will be repeated for each available "product" in Products.

If Text Blocks use Fields available in Data Definition Group Products, these Fields will have the values that are assigned to the Fieldsets in Products for that particular repetition.

Details

If you double-click one of the Data Definition nodes or select details in the context menu you will get details for that data definition node.

The details will show which Fieldsets are available in a specific node of the Data Definition. It will also show the sub nodes and the Fieldsets available for these sub nodes. If you add this Data Definition node, you have access to the data contained in the Fieldsets that are available for that node. If you wish to use the Fieldsets in one of the sub nodes you have to add that sub node next.