Cart|
|
Home >Online Product Documentation >Table of Contents >Document Pane Document PaneThe document pane displays the input file's layout, including spaces, field separators, and control characters. The input file's appearance in the document pane is determined, in part, by its format. This section covers the following topics: Example - .txt FilesStylus Studio uses slightly different displays for character-separated and fixed-width .txt files. Consider this file, which uses commas as the field separator:
Figure 150 shows how this character-separated input file appears in the Custom XML Conversion Editor's document pane. By default, Stylus Studio aligns columns and fills the empty cells of the shorter rows with a light blue to aid readability:
You can remove these spaces from the display and view the file in its native format by clicking the Align Fields button ( Fixed-width files are displayed in a slightly different fashion. Consider this fixed-width input file: In a fixed-width file, the empty cells represent actual values (spaces) in the input file. In the second row of this input file, for example, there are three spaces between the first and second columns: Display of Delimiting and Control CharactersStylus Studio displays delimiting and control characters in a way that distinguishes them from plain text values.
l Delimiting characters, like the comma used in the example in Figure 150, are displayed with a dark blue background. For files that include sub-fields or arrays (like EDI, for example), the sub-field separator character is shown in a different shade of blue. Sub-sub-fields delimiting characters are shown in a shade of purple.
l Control characters (line feeds and carriage returns, for example) are shown using their abbreviated ASCII value. A carriage return (0x0D) line feed (0x0A) is shown as 
, for example. ASCII abbreviations are aligned vertically, to preserve space, as shown in this representation of the ASCII value for tab (0x09): 
.
Stylus Studio understands all Unicode characters,. When editing Line-Oriented Region and Field Name values in the Properties window, you can enter mnemonic values for the C1 and C0 control characters in the following ranges:
n C0 control characters with a value from >= 0x00 to <= 0x1F
n C1 control characters with a value from >=0x80 to <= 0x9F
For example, you could enter TAB or HT in the Field Separator field in the Properties window, and Stylus Studio would correctly interpret that value. For a list of commonly used control characters, see Specifying Control Characters.
l Characters that are discarded from output (like line terminators such as CR and LF and comment lines) are displayed against a gray background.
You can hide control characters by clicking the Toggle Control Characters button ( Field NamesUser-defined field names - values that Stylus Studio uses to create the element names in converted XML - are displayed in green, as shown here: You can edit these names
l In-place, by double-clicking the field name
l In the Field Element Name field of the Properties window
If the field names are taken from a row within the file itself, Stylus Studio displays a blue arrow in the document pane margin to indicate this. See Naming Fields to learn more about naming fields for XML output by custom XML conversion definitions. Document Pane Display FeaturesIn addition to aligning fields in character-delimited files, the Custom XML Conversion Editor's document pane has several other features that aid readability. RulerYou can display a ruler that identifies each column:
To display the ruler, click the Toggle Ruler button ( 
) on the tool bar, or select CustomXMLConversion > Toggle Ruler from the menu.
Displaying Pattern MatchesYou can define match patterns using regular expressions to control which rows are converted to XML and, optionally, the name to use for these rows. You can highlight rows that match the patterns that you have defined, as shown here:
To highlight matching rows, click the Highlight Matching Rows button ( Matching rows are displayed in light yellow, with a green check in the pane's margin. A red X identifies rows that do not match the current pattern. Gray squares identify rows that match a pattern other than the pattern defined for the row that currently has focus. See Specifying Multiple Match Patterns for more information on this feature. See Pattern Matching to learn more about using regular expressions to define match patterns. Grid LinesThe document pane displays both vertical and horizontal lines by default; you can hide/show them independently. In the example shown in Figure 157, horizontal lines are hidden from the display:
To hide horizontal and vertical grid lines, click the Toggle Horizontal Grid Lines ( FontsBy default, the input document is displayed using the Courier New font in 12pt. You can change the display font to suit your personal preference using the Edit > Change Font and Edit > Font Size menus. Moving Around the DocumentYou can move the cursor around the document using
l The Space bar on your keyboard
l The directional arrows and Page Up, Page Down, Home, and End keys on your keyboard
l Your mouse (click on the character on which you want to place the cursor)
l The Go To dialog box
Using Go ToYou use the Go To dialog box to jump to a specific location in the file you are using to create your custom XML conversion definition. You can use it to move the cursor to a specific
l Position in the file
l Region
l Position or row within a region
l Column within the current row
When you first display the Go To dialog box, values in the Go To fields reflect the cursor's current location within the file. The values in the Maximum fields display the maximum values for each category (file size, number of regions, and so on) for the portion of the file read into the Custom XML Conversion Editor Editor by Stylus Studio.
To display the Go To dialog box, select Edit > Go To from the menu.
|
XML PRODUCTIVITY THROUGH INNOVATION ™
) on the tool bar, or by selecting CustomXMLConversion > Align Fields on the menu. This results in the layout shown in 
) on the tool bar, or by selecting ConvertToXML > Toggle Control Characters from the menu.
) on the tool bar, or select CustomXMLConversion > Highlight Matching Rows from the menu.
) and/or Toggle Vertical Grid Lines (
) buttons on the tool bar, or select ConvertToXML > Toggle Horizontal Grid Lines and/or Toggle Vertical Grid Lines from the menu.
