Data Definitions
Digest
A data definition is a collection of XML data that has been authored by hand or by use of the data definition builder (/common/data definition builder), and it describes how a certain set of data is structured. Data definitions are used by Cascade Server to generate forms-based input fields for the creation and editing of page content, as well as to generate XML data from the input provided by users in input fields.
Concept
Data definitions provide structured authoring capabilities, which allow non-technical users to enter content in a series of form fields to create structured pages without the need for additional formatting. These fields are automatically styled using an XSL stylesheet.
Cascade’s ability to provide full design control for custom pages, in addition to custom fields, including text, WYSIWYG, drop-down menus, check boxes, and radial buttons, contributes to a faster and more efficient content creation process.
An example of how a data definition may be used follows:
An article in an online magazine might be described as follows:
When applied to a page, a series of form input fields would be present: two text fields ('Headline' and 'Location'), a text field with a calendar chooser (‘Date’), a file chooser ('Image'), and a multi-line WYSIWYG text field ('Main Content'). When this form is completed, the CMS uses the data definition to make the data available as XML, like so:
This XML data can then be transformed by an XSLT stylesheet for the purposes of presentation or multi-purposing of content. Data definitions allow for definition of structure, which all data of a specific type should exhibit, and make automation of presentation and repurposing possible.
Technical
Data Definitions Overview
There are five basic conceptual steps in creating and implementing a data definition:
- Use the visual data definition builder (/common/data definition builder/), or write a data definition by hand in XML.
- Assign the data definition to a page via the page system settings.
- Edit the page, and fill in the form capture fields from the data definition.
- View the XML as outputted from the data definition, and write a corresponding XSL stylesheet to transform it to the desired output.
- Apply the stylesheet to the page’s DEFAULT region to transform the content (do not supply a block for the DEFAULT region, as the data definition XML is automatically placed there).
See below for step-by-step instruction in creating data definitions, attaching data definitions, and applying stylesheets to data definitions.
Creating a Data Definition
Structured authoring is a way to allow non-technical users to enter content into a series of fields without the need for additional formatting via the WYSIWYG. Instead, pages using structured authoring allow users to type plain text into various fields or select various options. These structured fields are automatically styled using an XSL stylesheet. The resulting page is automatically formatted to fit preset requirements. In Cascade Server, structured authoring is accomplished using a Data Definition.
To create a Data Definition:
- In the Administration area, select ‘Data Definitions’ from the left navigation pane.
- Navigate to the container in which the new data definition will be stored, or create a new container.
- Click ‘New Data Definition’.
- Complete the following fields in the ‘General’ pane.
- Name – A descriptive name for your definition.
- Parent Container – This value will be set to the current container, but can be changed if desired by clicking on the chooser icon.
- XML – Enter XML content.
- File Upload – As an alternative to entering content in the XML field, data definition XML content may be entered here.
- Click ‘Submit’ to save data definition.
Attaching a Data Definition to a Page
To attach a Data Definition to a page:
- In the Home area, navigate to the desired page, and click on the ‘Edit’ tab.
- In the System pane, check the box marked ‘Use Data Definition’.
- Click on the Data Definition chooser icon, and select the desired data definition.
- Click Submit to save the data definition on the page. If necessary, click on the ‘Edit’ tab and enter content into the page using the data definition.
Applying a Stylesheet to a Data Definition
-
Click the ‘Edit’ tab, and select the ‘Configurations’ pane to display available configurations.
-
The default configuration (HTML) will be shown. Click the browse icon located next to Stylesheet in the DEFAULT region row.
-
Select a stylesheet, and click ‘Confirm’ in the browse icon window.
-
Click the Submit button to record the change.
The page will be visible, except the XML data from the data definition has been transformed into standard HTML and output in the default region. This will include formatting such as spacing, bold, and hyperlinks.
Data Definitions References
FAQs
- Does Cascade Server offer Structured Authoring?
Cascade Server’s granular structure allows content types to be created and reused across multiple sites without compromising security. Predefined content types, called Data Definitions can be easily replicated across sites, using a different style for each.
Different departments, therefore, can post “news” to their own sites, each using the same structured format. These “news” items are automatically formatted in a style appropriate for that department.
Data Definitions can be edited to set certain fields as required. Required fields are marked with an asterisk (*). If a user attempts to edit a Data Definition-based asset without filling in the required fields, an error message is generated specifying which field data is missing.
Cascade Server comes with a number of useful Data Definitions ‘out-of-the-box.’ These are fully editable by an administrator, including which fields are required. In addition, administrators may specify required formatting for a field, such as ten digits in a ‘phone’ field. Data Definitions may also be configured to auto-format such fields to ensure consistency.