This series of steps guides you through some of the features
and capabilities of the BMS Map Editor. For detailed information about
procedures and configuration, see the specific topics in the BMS Map
Editor helps.
Note: You should regularly save any modifications to a map set.
In Rational® Developer,
the BMS Map Editor is associated with .bms map set files and is available
in any perspective. The editor uses the following views:
- Project Explorer
- Outline
- Palette
- Properties
You can import map set files in certain perspectives, such as Enterprise
Service Tools.
You can export maps to a JavaServer Faces Web page and its components.
See Generating a JSF Web page for
detailed instructions.
Creating a new project
Map sets can only be
created in an existing project. Complete the following steps to create
a new project:
- From the main menu, select.
- In the New Project wizard that opens, expand . Click Next.
- Type Test project as the project name.
Click Finish to close the wizard and create
the new project.
Test project is displayed in the Project
Explorer view. Open this view by selecting from the main menu, Window > Show
View > Other and entering Project
Explorer as the filter text.
Creating a new map set
To create a new map
set within a project, complete the following steps:
- From the main menu, select.
- In the New wizard that opens, enter Map
Set as the filter text, and select from the list of file
wizards.
- Click Next.
- Select Test project as the parent folder.
- Type NEWMAPSET as the file name. The .bms
extension will be automatically added.
- Click Finish to accept the default configuration.
The map set file NEWMAPSET.BMS is displayed
in theTest project project in the Project Explorer
view.
Adding maps to the map set
To add and modify
maps and fields within the map set, complete the following steps:
- Open the map in the editor by double clicking on NEWMAPSET.BMS if
it is not already open
- Start by tagging and dragging the mouse down to and to the right
in the Design canvas. Notice the size and position of the map are
displayed in the popup box.
- In the Palette view, select Map under the Basic drawer.
- Move the cursor to the Design canvas, and click to place the map.
You can use the Select tool under the Default drawer
to move and resize the map.
Viewing and modifying map properties
Select
a map in the
Design canvas. Note that the map
properties are displayed in the
Properties view.
The selected map is also highlighted in the
Outline view.
To
modify map properties from the Design canvas,
complete the following steps:
- In the Outline view, right-click MAP2.
Note that the map is highlighted in the Design canvas.
- Click the Toggle Black and White Mode button,
, located
in the upper right of the Design canvas to view the selected map more
easily.
- Right-click the highlighted map in the Design canvas,
and select Map Properties from the context
menu to modify the settings.
To modify map properties under the Source tab,
complete the following steps:
- Click the Source tab below the Design canvas.
- Locate the Map1 label.
- Place the cursor in the source code and change the map size parameters
to SIZE=(14,60). This changes the height of the map
to 14 columns and the width to 60 columns. Note that the change is
shown in the Properties view.
Adding and modifying fields
To add and modify
a label field, complete the following steps:
- In the Palette, select the Label button
in the Constant Fields drawer.
- Click in the Design canvas to place the
field. If the location is not valid (for example, outside the boundaries
of an existing map), you will not be able to place the field.
- If the label field is not displayed with the map in the Outline view,
select the Show Unnamed Fields button,
,
to display the label field.
- Left-click the field in the Design canvas
once, and type a new label value.
- Double-click the field in the Design canvas.
- Add a name for the label field, and click Apply.
Click Show Unnamed Fields again; the field
is now displayed with its name, in the Outline view.
- Right-click the field in the Outline view.
Select Cut to remove the field from its current
map.
- Select a different map in the Outline view.
Press Ctrl+V to place the field into that map.
To add and modify a password field, complete the following
steps:
- Click the Password field button in the Variable
Fields drawer.
- Place the pointer in the Design canvas.
A drop box is added to the simple pointer.
- Click and hold the left mouse button at the location that you
want.
- Draw the field to a width of 5 characters and release the mouse
button.
Note: The height in the pop-up box cannot be greater than 2
characters; the drawn box can be only 0 or 1 character high.
Align the fields by completing the following steps:
- In the Outline view, select multiple fields
by holding the Ctrl key and clicking the field icons.
- Right-click one of the highlighted fields in the Design canvas,
and select . The
fields are aligned to the top of the map.
Use the Shift key with the Select tool to grab and move
multiple items in the Design canvas. View the maps and fields with
the other display options, to see how they can assist you in modifying
maps and fields.
Filtering and previewing maps
Use the
Filters feature
to view, prioritize, or hide specific maps within a set:
- Click the Filters button above the Design
canvas. Note that the name of the current filter is displayed below
the selection button.
- Click New to add a new filter.
- Move maps up or down the filter list, or deselect maps.
Note
the changes in the Preview pane. Filters display the enabled maps
in order, as you look at the Preview pane or Design canvas (the second
map is placed behind the first, the third is placed behind the second,
and so on).
- Click OK to complete the filter modification.
- Click the drop-down list beside the Filters button
and select the newly added filter from the list of available filters.
Note that the filtered maps are not displayed in the Design canvas
or the Outline view.
- Click the Preview tab. In Normal mode,
the filtered maps are not displayed.
The Preview page displays maps and fields in Web and Normal mode.
Normal mode provides a terminal-like preview, with full filtering
capability. The Web mode shows all maps in a set.