Defining and Joining Regions

An input file can contain any number of regions; fixed-width and line-oriented regions can exist in the same file. The Custom XML Conversion Editor provides tools that allow you to define new regions and join existing ones.

This section covers the following topics:

Defining a Region

When you define a region in an input file, Stylus Studio splits the region at the current cursor location. The new region starts with the character on which the cursor resided when the region was defined, but it can be of either type - fixed-width or line-oriented - regardless of the type of the original region.

Consider the following input file:

# Bike Inventory Overview 2004-10-01 09:00:07EDT 
Moto Guzzi,LeMans,2001,12393 

By default, Stylus Studio reads this as a file with a single region. You might decide you want your XML to distinguish headers from actual records and treat the two accordingly (not generating headers as XML, for example).

When you define a new region, the Custom XML Conversion Editor renumbers all the rows, using a region:row number format. In addition, each region is displayed with its own field name row, which is displayed in light green with the default field element name, field, as shown in Figure 170.

Field and row values are independent across regions. For example, the <row> element might be <reg1>, <reg2>, and so on for each of the regions in an input file.

To define a region:
1. Place the cursor in the document pane on the character with which you want to start the new region.
2. Click the Start New Region Here ( ) button, or select CustomXMLConversion > Start New Region Here from the Stylus Studio menu.

Stylus Studio displays the Start New Region dialog box.

4. Choose where you want the new region to start (at the current row, or at a specific number of bytes from the start of the file).

Joining Regions

You can join regions that you define as well as regions that Stylus Studio interpreted when it first read the input file. You can join the current region to either adjacent region - the previous region, or the next region.

The region type after the join operation depends on whether you are joining with the previous region or the next region.The region you are joining assumes the type of the region to which it is being joined.

To join a region:
1. Place the cursor anywhere in the region you want to join with another region.
2. Click the Join with Previous Region ( ) or Join with Next Region ( ) button. These actions are also accessible from the CustomXMLConversion menu and the shortcut menu in the Custom XML Conversion Editor.

Stylus Studio joins the region you specified in step 1with the adjacent region.

Free Stylus Studio XML Training:
W3C Member