In this tab, you enter the Text content, which is structured
in sections. You can assign the Text to instances of other entities
to document them. You can also reference Data Elements or other Text
instances.
This tab is constituted of the following elements:
- A tree that shows the Text lines. It displays the sections on
the first level, and the lines that constitute each section on the
second level. If you click a line, input field categories automatically
become available. You use them to modify the content of the line.
If you right-click a line, a contextual menu contains items to add
a section, a line, or a reference to an instance.
- Buttons that you can also use to add a section, a line, or a reference
to an instance.
- Input field categories that open when you click a line or request
to add a section, a line, or a reference to an instance from an item
of the contextual menu or from a button.
You must save the Text instance to take into account the modifications.
You
can carry out the following actions:
- You can modify or create a section code. Select a section line
or click Add section. The Sections category
opens. Enter the new section code in the Section code field.
This code must be on 2 characters. It is recommended to use letters
or digits only.
If you click More, you can
see the section content through an interface that is similar to the Pacbase textual interface.
- You can modify the content of a line or create a line that is
part of a section. You can also associate a line with a Data Element.
To carry out these actions, you must first expand the section.
- To modify the content of a line, select the line in the tree.
The Section lines category opens. Modify the
line content in the Line text field.
- To create a line, set the cursor at the insertion point in the
tree and click Add line. The Section
lines category opens.
- Select the Line type. A title line is required
at the beginning of each section. To enter a simple text line, select
the Update by substitution type.
Note: Do
not select a line type I, J, B, E,
or Y. These line types are created when you
add assignment lines or references to a Text.
- Enter the line content in the Line text field.
- You can associate a line with a Data Element because a Text that
describes an application often refers to individual Data Elements.
These Data Elements are not necessarily defined.
- If the Data Element is defined in the current network, click Data
Element in the Section lines category,
then click Change. Select a Data Element and
click OK. The Data Element is displayed as
a link. You can click it to open its editor.
- If the Data Element is not defined in the current network, click Undefined
Data Element in the Section lines category,
then click Change. Enter the Name field.
You can also indicate an Output format. Select Blank
when zero to generate the BLANK WHEN ZERO COBOL
clause for the numeric Data Elements that are retrieved from old versions.
Click OK. The undefined Data Element is displayed
but you cannot open its editor.
The Data Element that is associated with the line is also displayed
on the tree line, between square brackets.
- You can specify assignment lines to assign a Text section or section
part to instances of other entities. To do so, click Add
assignment line. Text assignment starts at the beginning
of the section that contains an I or a B type
line. It ends implicitly at the end of the last section, or explicitly
after a J or E type
line.
You can indicate an assignment line on two types of entity
instances:
- Instances that are defined in the current network by clicking Add
an entity. Select one of the instances that are displayed
in the selection box and click OK. This instance
is displayed as a link. You can click it to open its editor.
- Instances that are not defined in the current network by clicking Add
an undefined instance. In the dialog box that opens, you
must select the entity and enter the name of the instance that is
the target of the assignment. The package name is optional. If the
assignment targets a User Entity, you must indicate the name of its
Meta Entity. Click OK. The undefined instance
is displayed as an unresolved link.
The entity instances that are the targets of the section are
also displayed on the assignment line in the tree.
You can remove
an assignment to a defined or undefined instance. Select it in the Section
referenced text lines and click the Remove button
that is on the same line.
Note: The instances of the Pacbase entities that are
not managed in Rational Programming Patterns are
displayed as unknown references at the end of the Section
referenced text lines. You can select them and remove
them by clicking the Remove button that is
on the same line.
- You can reference another Text or section by clicking Add
reference to a Text. A dialog box opens then:
- You can select a Text that is defined in the current network.
Click Selection and select one of the Texts
in the list. You can also select one of its sections. Click OK.
The Text is displayed as a link in the Assigned Text field.
You can click it to open its editor. The section is displayed in the Section field.
If you click More, you can select another section.
- You can also indicate a Text that is not defined in the current
network. Click Add an undefined instance and
enter the name of a Text. The package name is optional. Click OK.
The Text is displayed in the Assigned Text field
as an unresolved link
The referenced Text is also displayed on the
reference line in the tree.In the Section referenced
text lines, you can click the Change button
to change the reference to another defined Text. You can click Remove to
remove the displayed reference.