Wizards are dialogs that provide a simple way for complex information to be captured. There are several used within the CAM editor.
Top of Page

The wizard is divided into three areas: Item and Action Details
, XPath
and Annotation
. The first area is designed to capture the actual rules, condition and context (if any) for this new rule. The XPath will be used to link the rule to the item, or its children. The annotation is simply a comment section.
- Item and Action Details Fields
- Item
- contains the name of the element or attribute being linked to the rule.
- Context Position
- contains a list of the currently defined contexts. This only needs to be set if the rule is to be defined with in a context.
- Condition
for the rule if any. This is a valid xpath and may refer to parameters using the $parameter notation. If no condition is required leave the value fo the field as None.
- Action
is a set of fields that define the action that is to be associated with this rule. The first field is a list of actions. Once one is selected any parameters for it will be entered using the follwoing fields. Not allo actions have parameters.
- Rule Category
indicates if this rule is to be treated as a defualt rule (usually not associated with a context) or a context rule (associated with a conditional context). Contexts can be used in the default section only if they are testing for the presence of a parent element.
- XPath Fields
- XPath
This contains the XPath that will be associated with the rules. You may edit the XPath directly although most options are easily available using the check boxes.
- Check Boxes
used to help build up an xpath.
- None
sets teh XPath to the value None
- Full
sets the XPath to the full XPath of the item starting at the top of the current structure.
- All
sets the XPath to be defined for all occurrences of the item. This is done by starting teh XPath with a double '//'
- Position
sets the XPath to include position details. This will introduce numbers in brackets such as '[1]'. This is used to precisesly identify an item within a structure, i.e. the second occurence of this item.
- Parent
will prepend the parent's XPath to the items XPath. This is useful if without the parent the item is not uniquely identified.
- Children
will add '/*' to the end of the XPath to associate the rule with the current elements children. This is useful when defining choice elements.
- Annotation Field
- Annotation
allows the first entry in the rules annotations to be set directly from this wizard. More complex annotations can be provided using the Edit Annotation Wizard
.
Top of Page

This wizard has 5 sections:
- Parent Context
- Context Position
if the current context is to be defined within a pre-existing context this can be defined using this drop down list.
- Condition
- Condition
contains the conditions for the context. The basis for the condition may be the XPath for the currently selected Item. If this is the case the Check boxes may be used.
- Condition XPath Check Boxes
used to help build up an xpath.
- None
sets teh XPath to the value None
- Full
sets the XPath to the full XPath of the item starting at the top of the current structure.
- All
sets the XPath to be defined for all occurrences of the item. This is done by starting teh XPath with a double '//'
- Position
sets the XPath to include position details. This will introduce numbers in brackets such as '[1]'. This is used to precisesly identify an item within a structure, i.e. the second occurence of this item.
- Parent
will prepend the parent's XPath to the items XPath. This is useful if without the parent the item is not uniquely identified.
- Children
will add '/*' to the end of the XPath to associate the rule with the current elements children. This is useful when defining choice elements.