sunBow Plug-in

The proposals are listed when the user starts a new tag with the '<' character or types the ':' character in a tag. The shortcut CTRL+Space also opens the list with possible tags.

Tags are generated from XML schema files. These are defined in the preferences of the editor.

Schema files are associated with file extensions. For each schema a namespace prefix can be defined. When the proposals are listed in the editor, this prefix is catenated with the tag names from the schema definition. sunBow comes with schemas for Cocoon sitemaps and for XSLT stylesheets. These are called internal. You can also associate a file from any location.

sunBow also allows to set up special schemas for each file in the project. This association can be edited in the properties of the file resource.

The sunBow plug-in also contributes the possibility to trace the transformation process. To start the tracer select one XML and one XSL file in the resource navigator and call "XSLT Trace" from the context menu. After this a new perspective will be opened.

The perspective shows three views: XSLT stylesheet, XML source file and the output of the transformation. Tracing can be controlled with the action icons in the toolbar from the stylesheet view. The other two view will be updated and synchronized after each step. To interrupt the transformation process you can define breakpoints. The tracer stops when a breakpoint is reached. Now you can continue the transformation step by step or choose Resume. Resume processes the transformation to the next breakpoint or to the end.

These icons in the action bar from the sitemap editor have the following functions:

• insert new element
• delete element
• edit element
• expand all children
• collapse (hide) all children

To insert a new element to the sitemap press either the Insert-Key or click on the insert icon. The following dialog opens:

The new element will be added to the position relative to the currently selected element in the tree. The elements presented in the list are dependant on the selected position. They are determined regarding the XML schema. The defined sequence and the maxOccurence attribute are validated to calculate the set of allowed elements.

In this dialog you can edit the attributes of the selected element. For each attribute that is defined in the XML schema one input field is created. The dialog is opened after a double-click on the element, pressing the Enter-Key or selecting the edit action from the tool bar.

The editor supports the following attribute data types from the XML schema:

• String: text box
• Boolean: check box
• Enumeration: drop down list

Required attributes are marked with an asterisk ('*') after the label of the input field.

Additional to the supported schema types the following special types are offered from the editor:

• File selection: A file selection dialog can be opened. The filename is saved relative to the path of the sitemap file.
• XPath selection: The result of a XPath query will be presented in a drop down list. This is used for example in the type attribute of a transform element. Only the types that are defined in the components section of the sitemap are presented.

The sitemap editor has a built in management of sitemap fragments. You can add any elements of the sitemap to the collection of fragments. For this select the menu Store Fragment from the context menu in the sitemap editor. In the following dialog define the name and the category where the fragment should be stored.

To insert a fragment into your sitemap select Insert Fragment from the context menu. In the following dialog you can browse your stored fragments. The fragment will be added as a child under the currently selected element in the sitemap editor.

The sitemap editor supports Drag and Drop to move or copy elements of the sitemap. If you want to copy an element, hold the SHIFT-Key before dragging the element. Each element can be dropped to three destination positions relative to the destination element. When you move the mousepointer on an element, the element will be highlighted. At this position the dropped element is assigned as a child of the destination element. You can also drop an element before or after a destination element. In that case the dropped element will be assigned as a sibling element. The resulting drop action is described in the status line of the workbench.

The drop operation is validated against the sitemap schema. Only valid positions are allowed as drop destinations. The mouse pointer indicates if the destination position is valid or not.