About the Dataflow Diagrammer

Related Topics

The Dataflow Diagrammer allows you to create and maintain business functions, datastores, dataflows and externals that are stored in the repository.

Dataflow diagramming involves the creation of diagrams to show how data flows through your organization. Dataflow diagrams are drawn to represent data dependencies, system components or even the context of a project.

Each Dataflow Diagram represents a single business function for an application system. This function may be a mission statement for an entire organization, or a small series of activities for an isolated part of the organization's business.

The Oracle Designer Dataflow Diagrammer provides:

•	a diagramming tool for creating Dataflow Diagrams

•	access to the multi-user repository for creating and maintaining definitions of functions, dataflows, datastores and externals

•	access to the Application Design Transformer to derive a potential database design and customize this to achieve consistent and manageable applications

•	autolayout facilities for automating the improvement of the diagram layout

•	access to other related Oracle Designer tools, including the Repository Reports tool, which provides reports for validating Entity Relationship Diagrams, and the Matrix Diagrammer, which can be used for cross-referencing repository elements to verify your design


Modeling dataflows: a quick guide

Related Topics

Before functions can be related to information in an application system, the activities carried out within a business must be identified. This can be performed using either Process Diagrams or Function Hierarchy Diagrams.

The information model for a business describes the entities and attributes about which the business needs to store information.

The function hierarchy and information models can be cross-checked by relating functions to information. This operation shows whether the business functions are carried out by the entities and attributes that are defined in the information model.

There are two main ways in which functions can be related to information:

•	matrices that cross-reference business functions to entities and attributes

•	Dataflow Diagrams that document the information contained in dataflows that is read and written by business functions

Relating functions to information involves the following stages:

Analyzing how functions use entities and attributes

Modeling data flows

Describing the content of dataflows

Performing quality checks

The Dataflow Diagram that results from the above operations can be translated into an application design during the design stage of your systems development. The Application Design Transformer, which can be accessed from the Dataflow Diagrammer, determines how modules use tables in the application system.


Analyzing how functions use entities and attributes

Related Topics

The elementary business functions in your function hierarchy should be identified, and the data usage of the elementary functions should be described, before analyzing how the functions use entities. When the analysis is completed of how elementary business functions in the function hierarchy use entities in the information model, you can analyze the way that elementary business functions in the function hierarchy use the attributes of entities in the information model.

An information model showing the entities and attributes in the application system is needed before the way in which functions use data is analyzed.

Which tools to use

The Matrix Diagrammer, Dataflow Diagrammer, Function Hierarchy Diagrammer or Repository Object Navigator can be used to enter function to entity usages and function to attribute usages.

The Function/Attribute Matrix utility in the Dataflow Diagrammer can be used to create usages for all attributes of the entities that your business functions use.

Both the Matrix Diagrammer and the Repository Object Navigator can be used to display either all the entities that are used by a function, or all the functions that use an entity.

What you do

The function descriptions and function logic rules may have been defined to refer to data elements in the entity relationship model, making it easier to cross-reference functions and data.

The information that each function will need, create or change must be considered. This can be done by discussing the information with the users or showing them a prototype of the system. Entities and attributes may need to be added to the entity relationship model as a result of this operation.

This operation may be performed more than once. The first time would be to find the entities that are used by a function. The second time would be to define explicitly whether a function can:

•	create an instance of an entity

•	retrieve, or read, an instance of an entity

•	update or delete an instance of an entity

•	archive and remove an instance of an entity

You may also want to find all the attributes of each entity that are used by a function. It should be defined whether a function can:

•	insert a value into an optional attribute

•	read the value of an attribute

•	update the value of an attribute

•	set the value of an optional attribute to null

These data usages should be documented as a 'CRUD' (create, retrieve, update, delete) matrix. Additional information, such as how many instances of an entity the function uses, should also be noted.

The resulting matrices can be viewed using the Matrix Diagrammer. The matrices will show whether any entities or attributes are not used by business functions. This may be because there are functions missing from your function hierarchy or the entity or attribute may not be needed in the information model.

If a function does not use an entity, it is possible that there are entities missing from the information model, or the function includes manual procedures that do not read or write data.

The Application Design Transformer uses the function to entity usages to determine how modules use tables in the application system.


Modeling data flows

Related Topics

A Dataflow Diagram can be based on business functions in a function hierarchy, or new business functions can be created on it.

Which tools to use

The Dataflow Diagrammer should be used to create a Dataflow Diagram, although the elements on the Dataflow Diagram can be created in the repository using the Repository Object Navigator.

What you do

Dataflow diagramming is a technique for modeling systems by showing the flow of information between functions.

Dataflow diagrams can be used in a number of ways:

•	to show the scope and boundaries of an application system

•	to model the relationships between functions

•	to build up a detailed picture of the data that functions use

The highest-level Dataflow Diagram will be for the root function of a function hierarchy, and will contain the first level of function decomposition. High-level diagrams can be used for scoping your system and defining the boundaries and interfaces between application systems. Lower-level diagrams show the flow of information between elementary business functions.


Describing the content of dataflows

Related Topics

To describe the content of the dataflows and datastores, Dataflow Diagrams should be sufficiently decomposed to show elementary business functions, and dataflows between datastores and elementary business functions.

Which tools to use

The Dataflow Diagrammer or the Repository Object Navigator can be used to describe the content of the dataflows.

What you do

The data that makes up each dataflow flowing into or out of the elementary business functions in an application system must be described. The data consists of entities and their attributes. A model can be created to display which elements the functions read and write.


Performing quality checks

Related Topics

All the analysis models should be complete before performing the quality checks. The models are:

•	an information model

•	a function hierarchy

•	a cross-reference that shows how business functions use entities and attributes

The information and function models should have been reviewed for completeness.

Which tools to use

The Matrix Diagrammer can be used to check how functions use data.

What you do

When performing quality checks, you may want to check the following in the information model. The reports will usually suggest some changes to your model. You should make these changes before starting your systems design.

For each entity:

•	Is there a business function that creates instances of this entity?

•	Is there a global business function in another container that creates instances of this entity?

•	Is there a business function that retrieves instances of this entity?

•	Is there a business function that deletes instances of this entity?

•	Is there a business function that archives instances of this entity?

For each elementary business function:

•	Does it use any data at all?

•	If it does not use any data, is it really a manual procedure?

•	Is there at least one flow in and one flow out?

•	Is there any data that it reads but does not write out again?

•	Is there any data that it writes out, but never reads in?

•	Is there any data that the logic requires, but the function never reads?

For each data item:

•	Should you add an attribute to an existing entity?

•	Should you add a new entity?

•	Should the function use an existing attribute instead of the data item?

For each datastore:

•	Does it contain any data at all?

•	Is there any data that is never read by a function?

•	Is there any data that is never written by a function?

When you have completed these quality checks, and made any necessary adjustments to your business model, you have a full set of business models.

You are now ready to start your systems design. The function to entity and function to attribute usages are an important input to the Application Design Transformer.


Autolayout on Dataflow Diagrams

Related Topics

Autolayout is a utility that allows you to change the layout of the elements on a diagram without having to move them manually.

The way Autolayout works

All the elements on a diagram do not have to be automatically laid out each time the utility is run. If elements are selected on a diagram, only those elements are automatically laid out.

Each time the utility is run on a whole diagram or on selected elements on a diagram by selecting Layout→Autolayout, a different layout of elements is displayed. The process can be repeated as many times as you require.

You can review several layouts consecutively using the AutoLayout utility, and then redisplay your preferred layout by selecting Layout →Previous Layout until the required layout is restored on the diagram.

Both the Autolayout and Previous Layout utilities are also available on the standard toolbar.

 Autolayout

 Previous Layout

Note:	Previous layouts cannot be restored using Edit→Undo.

When to use Autolayout

The Autolayout utility allows you to rearrange diagram elements into a more suitable layout with the minimum of effort.

For example:

A number of elements are included from the container.

AutoLayout is used to rearrange the elements.


Dataflow Diagrammer toolbar

The buttons on the standard toolbar provide shortcuts to some of the options available from the menus. The tooltips and status bar messages indicate the function of the buttons.


Dataflow Diagrammer Tool Palette

The drawing toolbar is a row of buttons representing various actions for the Dataflow Diagram; namely selecting elements, creating elements and changing certain characteristics of elements. Each button is identified by an icon that indicates the associated action. The tooltips and status bar messages indicate the function of the buttons.


Dataflow Diagram elements and notation

Related Topics

The following information can be represented on Dataflow Diagrams:

Common functions

Dataflows

Datastores

Externals

Frame functions

Local and global functions

The appearance of elements on a diagram can be altered by changing the graphical preferences, either for selected elements, or for all elements of a specified element type. You can also define whether you want to show or hide the properties of elements on a diagram.


Dataflow Diagram elements and notation - frame functions

Related Topics

Frame function is the term used to describe the function on which a Dataflow Diagram is based. Functions inside the frame function are local functions and functions that are outside the frame function are global functions.

Note:	A business function that has no parent function is called a root function.

Example of a Dataflow Diagram frame function:


Dataflow Diagram elements and notation - local and global functions

Related Topics

Local functions

Functions inside a Dataflow Diagram frame function are referred to as local functions. Local functions are child functions of the frame function.

Example of a Dataflow Diagram local function:

Global functions

Functions outside a Dataflow Diagram frame function are referred to as global functions. A global function can be any function on a Dataflow Diagram that is not a child function of the current frame function.

Example of a Dataflow Diagram global function:


Dataflow Diagram elements and notation - common functions

Related Topics

Common functions are used when the same function appears in more than one place in a function hierarchy.  About

Each common function is based on a master function, and inherits its properties from that master function. On Dataflow Diagrams, the label of the master function is displayed at the top right corner of the common function.

Example of how a common function is displayed on a Dataflow Diagram:


About dataflows

Related Topics

A dataflow is a named flow of data between functions and datastores, or between externals and other functions.

At least one end of a dataflow must be connected to a function.

Dog-legs

On a Dataflow Diagram, an angled joint in a dataflow is known as a dog-leg. Dog-legs are often found on large diagrams where a dataflow must be routed around other items.

Resolved flows

Resolved flows represent flows of data between functions at a lower level in the function hierarchy than the current frame function. Resolved flows cannot be created on a Dataflow Diagram; they can only be included from the container.

Resolved flows are displayed as dashed dataflows on the diagram.

The name is displayed above the resolved flow and is made up of the names of the dataflows that it contains. If there is more than one dataflow in a resolved flow, then the name of the resolved flow is the first dataflow name followed by a comma and an ellipsis (...).

Global flows

Global flows represent the flow of information between global functions and other elements that are outside the frame function on a Dataflow Diagram, such as other global functions, datastores or externals.


About datastores

Related Topics

A datastore is a temporary or permanent storage for a collection of attributes from one or more elements, as used by specified functions or processes.

Example of how a datastore is displayed on a Dataflow Diagram:

A datastore can also contain data items, which may be subsequently converted into attributes.


About externals

Related Topics

An external is a thing of significance that is outside the scope of the hierarchy in the container and that acts as a source or recipient of dataflows into or out of the hierarchy.

Example of how an external is displayed on a Dataflow Diagram:

An external can be a person, a business unit, another container or any other thing that might provide or receive information from a function within the container.


File - New
   New (File Menu)

Related Topics

Creates a new, untitled Dataflow Diagram based either on a function present in the repository or on a new function.

Choose Container dialog box

Allows you to choose the container in which the new Dataflow Diagram will be created. Note, that a Dataflow Diagram and the function on which it is based are always stored in a single container.

The dropdown list shows a record of the containers you have most recently used. If this list is empty, click the button to the right of the dropdown list to choose a container. Alternatively, create a new container.  How

When you have chosen a container, click OK to display the New Diagram dialog box.

New Diagram dialog box options

List box

Displays the names of the functions on which the new diagram can be based. Note, only the functions visible to the container you specified in the Choose Container dialog box can be used.

Create Function

Displays the Create Function dialog box, enabling you to create a new function on which to base the new diagram.

OK

Selects the chosen function, creates the diagram and closes the dialog box.

Cancel

Cancels the dialog box without selecting the chosen function or creating a diagram.

Help

Displays help information about the dialog box.


File - Open Up
Open Up (File Menu)

Related Topics

Opens a diagram displaying the parent of the current frame function as a frame function. If a diagram does not currently exist for the parent of the frame function, the parent function is displayed in a new untitled diagram.


File - Open Down
Open Down (File Menu)

Related Topics

Opens a diagram displaying the selected function as the frame function of that diagram.


Edit - Include Function
Include→Function (Edit Menu)

Related Topics

Includes child functions, and optionally the dataflows between them, that exist in the repository but which are not currently shown on the diagram.

Dialog box options

List box

Displays the names of all the functions that can be included on the diagram.

With Dataflows

Determines whether or not dataflows are included with the functions.

Select All

Selects all the functions in the list box.


Edit - Include Dataflow
Include→Dataflow (Edit Menu)

Related Topics

Includes dataflows that flow between elements, that exist in the repository but which are not currently shown on the diagram.

Dialog box options

Element; Container; Flow Name

Displays the details of all the flows that can be included between elements on the diagram.

Select All

Selects all the dataflows in the list box.


Include - Datastore
Include→Datastore (Edit Menu)

Related Topics

Includes on the diagram any datastores, and optionally the dataflows between them, that exist in the container which can be included on the diagram.

Dialog box options

List box

Displays the names of all the datastores that can be included on the diagram.

With Dataflows

Determines whether or not dataflows are included with the datastores.

Select All

Selects all the datastores in the list box.


Edit - Include Global function
Include→Global Function (Edit Menu)

Related Topics

Includes on the diagram any global functions, and optionally the dataflows between them, that exist in the container which can be included on the diagram.

Dialog box options

List box

Displays the names of all the global functions that can be included on the diagram.

With Dataflows

Determines whether or not dataflows are included with the global functions.

Select All

Selects all the global functions in the list box.


Include→External (Edit Menu)

Related Topics

Includes on the diagram any externals, and optionally the dataflows between them, that exist in the container which can be included on the diagram.

Dialog box options

List box

Displays the names of all the externals that can be included on the diagram.

With Dataflows

Determines whether or not dataflows are included with the externals.

Select All button

Selects all the externals in the list box.


Edit - Include - Resolved Flow
Include→Resolved Flow (Edit Menu)

Related Topics

Includes resolved flows that flow between elements displayed on the diagram.

Dialog box options

List box

Displays the names of all the resolved flows that can be included between elements on the diagram.

Select All

Selects all the resolved flows in the list box.


Edit - Include - Global Flow
Include→Global Flow (Edit Menu)

Related Topics

Includes global flows that flow between elements displayed on the diagram.

Dialog box options

List box

Displays the names of all the global flows that can be included between elements on the diagram.

Select All

Selects all the global flows in the list box.


Customize Dialog Box

Related Topics

Enables you to change options in the Dataflow Diagrammer.

Elements group

This group of fields defines how elements are displayed on the diagram.

Type

Type of diagram item to which these details apply.

If no items are already selected when you display this dialog box, any changes you make here apply to all future items of the specified type.

If one or more diagram items are already selected when you display this dialog box, this field shows "Selected Objects". In this case, any changes you make apply only to the selected items, which can be of different types.

Font

The font used to display text on elements. Selecting this field displays the Font dialog box to specify the font details.

Color Fill

The fill color. Selecting this field displays the Color dialog box to specify a fill color.

Color Line

The line color. Selecting this field displays the Color dialog box to specify a line color.

Line Width

The line thickness of elements. You can either specify a number from 1 (thinnest) to 10 (thickest) in the first field, or select the second field to display the Line Width dialog box, displaying a choice of ten different line widths.

Requery On Open

Defines whether or not the elements on the diagram are automatically consolidated with those in the repository when the diagram is opened.

View group

This group of fields controls the display of elements on the diagram.

Function Sequence

Defines whether or not function sequence numbers are displayed on the diagram.

Function Master

Defines whether or not master function are displayed on the diagram.

Function Definition

Defines whether or not function definitions are displayed on the diagram.

Datastore Identifier

Defines whether or not datastore identifiers are displayed on the diagram.

Global Dataflows

Defines whether or not global flows are displayed on the diagram.

Resolved Dataflows

Defines whether or not resolved flows are displayed on the diagram.

Container Display

Specifies the level of detail to which container names are displayed on Dataflow Diagram elements. The available options are:

None	Container names are not displayed on diagram elements.
Name	Displays the name of the container in which the element exists next to the element name.
Path	Displays the name of the container in which the element exists, and any owning containers next to the element name. This option is useful if your designs contain nested containers.
Autolayout

This group of fields controls the size of the elements on the diagram.

Minimum Element Width (cells)

Defines, in grid cells, the default width for new elements, and the minimum width to which an AutoLayout operation will resize elements of the selected element type.

Minimum Element Height (cells)

Defines, in grid cells, the default height for new elements, and the minimum height to which an AutoLayout operation will resize elements of the selected element type.

Grid

This group of fields controls the display and definition of the grid.

Cell Size

Defines the size of the grid cells on the diagram.

The value that is specified in this field (in the range of 10 to 100) changes both the height and the width of the grid cells. One unit is equal to 0.01 inches on a diagram displayed at its original size.

Snap

Defines whether or not elements are snapped to the lines of the grid.

Display

Defines whether or not the grid is displayed on the diagram.

OK button

If items are selected on the diagram, this button applies the changes in the dialog box to those items and closes the dialog box.

Note:	This button does not save the changes with the diagrammer. If you subsequently create a new diagram in a different invocation of the diagrammer, these changes do not apply; the system uses the last set of values to be saved. Changes can be saved using the Save button.

This button allows you to try out the effect of changes on a diagram without making those changes permanent.

Cancel button

Discards any changes you make in the dialog box and returns you to the active diagram.

Reset button

Changes all the settings in the dialog box back to the last set of saved values. These values are stored in the Registry.

Save button

Saves any changes you make in the dialog box and returns you to the active diagram.

Help button

Displays help information about the dialog box.


Utilities - Resequence
   Resequence (Utilities Menu)

Related Topics

Changes the order of child functions below their parent function in the function hierarchy.

This option does not change the appearance of the functions on the active Dataflow Diagram. The change in the sequence of functions will be displayed when those functions are displayed on the corresponding Function Hierarchy Diagram.

Dialog box options

List

A list of all the functions that have the same parent as the selected function on the active diagram.

 Resequence Up

Moves the selected functions one position up the list of functions.

 Resequence Down

Moves the selected functions one position down the list of functions.


New Parent Dialog Box

Related Topics

Enables you to specify the parent of a function.

List

Displays a list of all the functions that can become the parent of the selected function on the active diagram.

Make top level

Changes the selected function into a root function.


Utilities - Split Dataflow
   Split Dataflow (Utilities Menu)

Related Topics

Inserts a datastore in a dataflow between a global function and a local function.

Datastores are inserted into dataflows to show the storage mechanism used in the dataflows.

This option automatically creates datastores using data items and attributes that are already defined as the contents of the selected dataflow.

Note:	Datastores cannot be inserted into resolved flows displayed on a diagram.


Utilities - Divide Dataflow
   Divide Dataflow (Utilities Menu)

Related Topics

Divides the contents of a dataflow into two or more dataflows.

If a dataflow contains more than one attribute or data item, the dataflow can be divided into individual dataflows for each attribute or data item. This enables you to change the source and destination elements of the dataflow on the diagram.

Note:	The contents of resolved flows displayed on a diagram cannot be divided into more than one dataflow.

Dialog box options

Base Dataflow

The name of the base dataflow suffixed by the number 1. If the name is not acceptable, this entry can be overtyped.

Below this field is a list of the dataflow contents of the base dataflow.

 Move Up

Moves the selected dataflow contents from the base dataflow contents list box to the derived dataflow contents list box.

 Move Down

Moves the selected dataflow contents from the derived dataflow contents list box to the base dataflow contents list box.

Derived Dataflow

The name of the derived dataflow suffixed by the number 1. If the name is not acceptable, this entry can be overtyped.

Below this field is a list of the dataflow contents of the derived dataflow.


Dataflows in Resolved Flow Dialog Box

Related Topics

Enables you to view the dataflows that compose a resolved flow.

List box

Displays a list of all the dataflows that are in the selected resolved flow.


   Function button

Related Topics

Creates a new function on a diagram. This button displays the Create Function dialog box.

The new function is created as a child of the current frame function.

The details for a function can be changed in the Edit Function dialog box, which is displayed either by double-clicking on the required function, or by selecting the function and then selecting Edit→Properties.


   Dataflow button

Related Topics

Creates a dataflow between two elements on a diagram. This button displays the Create Dataflow dialog box.

Note:	One end of a dataflow must be connected to a either a global or a local function. For example, a dataflow cannot be created between an external and a datastore.

Several dog-legs can be inserted into a dataflow.

The details for a dataflow can be changed in the Edit Dataflow dialog box, which is displayed either by double-clicking on the required dataflow, or by selecting the dataflow and then selecting Edit→Properties.


   Datastore button

Related Topics

Creates a new datastore on a diagram. This button displays the Create Datastore dialog box.

Datastores can be created both inside and outside the frame function.

The details for a datastore can be changed in the Edit Datastore dialog box, which is displayed either by double-clicking on the required datastore, or by selecting the datastore and then selecting Edit→Properties.


   External button

Related Topics

Creates a new external on a diagram. This button displays the Create External dialog box.

Externals can be created only outside the frame function.

The details for an external can be changed in the Edit External dialog box, which is displayed either by double-clicking on the required external, or by selecting the external and then selecting Edit→Properties.


Create Function Dialog Box

Related Topics

Enables you to define the name and details of a new function to be created in the current container.

Label

The name of the new function. The name of a function is displayed at the top of the function on the diagram.

Short Definition

The text description of the new function. The definition of a function is displayed under the label at the top of the function on the diagram.


Create Dataflow Dialog Box

Related Topics

Enables you to define the name of a new dataflow to be created in the current container.

Name

The name of the new dataflow. The name of a dataflow is displayed next to the dataflow on the diagram.


Create Datastore Dialog Box

Related Topics

Enables you to define the identifier and name of a new datastore to be created in the current container.

Identifier

The identifier of the new datastore. The identifier of a datastore is displayed to the left of the datastore on the diagram.

Name

The name of the new datastore. The name of a datastore is displayed to the right of the datastore on the diagram.


Create External Dialog Box

Related Topics

Enables you to define the name and details of a new external to be created in the current container.

Name

The name of the new external.

Short Identifier

A short text string for the new external. The short identifier of an external is displayed at the top of the external on the diagram.


Edit Dataflow Dialog Box

Related Topics

Enables you to modify the details of a dataflow.

Definition

Contents

Text


Edit Dataflow - Definition

Related Topics

Enables you to specify the mandatory and most frequently used details of the dataflow.

Name

Mandatory, 40 characters
The name of the dataflow.

Classification

Optional, 20 characters
Your own classification for the dataflow. Dataflows are sometimes classified as REPORT, SCREEN, LETTER, etc.

Definition

Optional, 70 characters
A description of the dataflow and any notes or comments about it.

Source

Identifies the diagram element that is the source of the dataflow. You cannot change the contents of these fields here. They are updated if you move the dataflow source end to a different element on the diagram.

Type

Display only
The source type of the dataflow: datastore, external or function.

Name

Display only
The name of the dataflow source; that is, the name of the external or datastore, or the label of the function.

Destination

This group of fields identifies the diagram element that is the destination of the dataflow. You cannot change the contents of these fields here. They are updated if you move the dataflow destination end to a different element on the diagram.

Type

Display only
The destination type of the dataflow: datastore, external or function.

Name

Display only
The name of the dataflow destination; that is, the name of the external or datastore, or the label of the function.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Dataflow - Contents

Related Topics

Enables you to specify the items of information that make up the contents of the dataflow. These items can be either the attributes of entities, or data items.

Entity list box

Optional, 40 characters
A list of existing entities in the current container whose attributes you can include. If you select the name of an entity from this list, the Attributes list box is populated with a list of the attributes for that entity.

Attributes list box

Display only
A list of the attributes for the current entity, if one has been selected in the Entity field. One or more of these attributes can be included in the dataflow by moving them to the Dataflow contents list.

Data Items list box

Display only
A list of the existing data items. One or more of these data items can be included in the dataflow by moving them to the Dataflow contents list.

 Remove

Removes selected attributes or data items from the dataflow. The attribute or data item names are then moved back to their appropriate lists.

 Include

Includes selected attributes or data items in the current dataflow.

Dataflow

The current contents of the dataflow.

Note: If ****** is displayed, the contents of the dataflow are not visible to this workarea.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Dataflow - Text

Related Topics

Enables you to enter free-format multi-line text for the text types associated with the current dataflow.

Text Type

Defines which text type you want to enter multi-line text for, and enter the text. A list of currently defined text types is available. Additional text types can be defined using user extensibility.

Text Editor

Invokes a text editor for you to enter text.

HTML Editor

Invokes an HTML editor for you to enter text.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Datastore Dialog Box

Related Topics

Enables you to modify the details of a datastore.

Definition

Contents

Text


Edit Datastore - Definition

Related Topics

Enables you to specify the mandatory and most frequently used details of the datastore.

Identifier

10 characters
A short reference name to identify the datastore. This name must be unique within the container.

Type

Optional, 10 characters
The datastore type: COMPUTER, MANUAL or TRANSIENT.

Name

40 characters
The name of the datastore. This name must be unique within the container.

Remark

Optional, 240 characters
Notes or comments about the datastore.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Datastore - Contents

Related Topics

Enables you to specify the items of information that make up the contents of the datastore. These items can be either the attributes of entities, or data items.

Entity list box

Optional, 40 characters
A list of existing entities in the current container whose attributes you can include. If you select the name of an entity from this list, the Attributes list box is populated with a list of the attributes for that entity.

Attributes list box

Display only
A list of the attributes for the current entity, if one has been selected in the Entity field. One or more of these attributes can be included in the datastore by moving them to the Datastore contents list.

Data Items list box

Display only
A list of the existing data items. One or more of these data items can be included in the datastore by moving them to the Datastore contents list.

 Remove

Removes selected attributes or data items from the datastore. The attribute or data item names are then moved back to their appropriate lists.

 Include

Includes selected attributes or data items in the current datastore.

Datastore

The current contents of the datastore.

Note: If ****** is displayed, the contents of the datastore are not visible to the workarea.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Datastore - Text

Related Topics

Enables you to enter free-format multi-line text for the text types associated with the current datastore.

Text Type

Defines which text type you want to enter multi-line text for, and enter the text. A list of currently defined text types is available. Additional text types can be defined using user extensibility.

Text Editor

Invokes a text editor for you to enter text.

HTML Editor

Invokes an HTML editor for you to enter text.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit External Dialog Box

Related Topics

Enables you to modify the details of an external.

Definition

Text


Edit External - Definition

Related Topics

Enables you to specify the mandatory and most frequently used details of the external.

Short Name

20 characters
An abbreviation for the name of the external. If a short name is not defined when the external is created, the system generates one.

Note:	You can enter up to 10 characters in this field, but it is advisable to keep the name as short as possible. A maximum of 7 characters is recommended.

Name

40 characters
The full name of the external. This name is defined when the external is created. Any characters, including spaces, can be used to construct a meaningful name.

Remark

Optional, 70 characters
A description of the external and any notes or comments about it.

Representation group

This group of fields defines the details of the element represented by the external.

Business Unit

The name of the business unit that the external represents. You can enter an existing name or select one from the drop-down list.

Note: If ****** is displayed, the business unit is not visible to this workarea.

Entity

The name of the entity that the external represents. You can enter an existing name or select one from the drop-down list.

Note: If ****** is displayed, the entity is not visible to this workarea.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit External - Text

Related Topics

Enables you to enter free-format multi-line text for the text types associated with the current external.

Text Type

Defines which text type you want to enter multi-line text for, and enter the text. A list of currently defined text types is available. Additional text types can be defined using user extensibility.

Text Editor

Invokes a text editor for you to enter text.

HTML Editor

Invokes an HTML editor for you to enter text.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function Dialog Box

Related Topics

Enables you to modify the details of a function.

You can also use this dialog box to identify the master function from which the details of a common function are derived.

Definition

Common

Triggers

Entity Usages

Attribute Usages

Text


Edit Function - Definition

Related Topics

Enables you to define the mandatory and most frequently used details of the function.

Label

Mandatory, 30 characters
A unique label for the function.

Elementary

Indicates whether or not the function is an elementary business function.  About

Atomic checkbox

Display only
When checked, indicates that the function is a atomic, i.e., that the function does not have any child functions. This field is for information purposes only, and therefore you cannot edit it directly. If child functions are created for the function, this field becomes automatically unchecked.

Short Definition

Mandatory, 240 characters
A short definition of the function, entered when the function was created. You can change the definition here.

Note:	A function definition cannot be entered for common functions, but is mandatory for all other functions.

To be automated

Indicates whether the function is to be an automated (rather than manual) function. This property is for information purposes only.

Parent

This group of fields displays details of the parent of the function.

Label

Display only
The label of the parent of the function.

Elementary

Display only
Indicates whether or not the parent function is an elementary business function.

Short Definition

Display only
A short definition of the parent function. A definition is not displayed if the parent is a common function.

Frequency

This group of fields specifies details of the frequency with which the function is carried out.

Times

Optional, 6 integers
The number of times that the function is carried out. The unit of time is entered in the next field.

Unit

Optional, 10 characters
The unit of time for the Times field. The unit is usually selected from the list, e.g. Day. Alternatively specify your own frequency unit, e.g., Half-Day.

Response

Optional, 12 characters
Specifies whether the implementation of the function should be IMMEDIATE or OVERNIGHT.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function - Common

Related Topics

Enables you to change a function into a common function.

Application System

The name of the container that owns the master function. The current container is displayed if it owns the master function.

Master Function

The label of the master function from which the common function is copied.

The list shows all the available functions that can be copied.

If you enter a master function label, the current or copy function assumes all the details of the master function and no further details can be entered.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function - Triggers

Related Topics

Enables you to specify which functions are triggered by completion of the current function.

Functions which trigger this function

Display only
The functions in the current container that trigger this function.

Functions not triggered

The functions in the current container that are not triggered by this function.

 Move Up

Moves the selected functions from the Functions triggered list box to the Functions not triggered list box.

 Move Down

Moves the selected functions from the Functions not triggered list box to the Functions triggered list box.

Functions triggered

The functions in the current container that are triggered by this function.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function - Entity Usages

Related Topics

Enables you to specify which entities are used by a function and the way in which they are used.

Entity

The name of an existing entity or its synonym within the container.

Create, Retrieve, Update, Delete, Archive and Other

The way in which the entity is used by the function. The Other checkbox refers to a user-defined usage type.

Comments

Optional, 240 characters
A comment about the way the entity is used by the function, if required.

Insert

Inserts a new blank row in the spreadtable. If a row is currently selected, the new row is inserted just before the current row. If no row is currently selected, the new row is inserted at the end of the spreadtable.

Delete

Deletes any currently selected rows from the spreadtable.

Tip:	Holding down the CTRL key and then pressing either the UP ARROW or DOWN ARROW key moves the cursor up or down a row in the spreadtable.

Pressing the TAB key moves the cursor across the fields in a row in the spreadtable.

Select All

Selects all the entities in the Entity dropdown list.

Reset Default

Resets the appearance of the spreadtable, e.g. column widths, to the default. For example, you may have increased the width of the Comment column (by placing the cursor on the line between two spreadtable headings and then dragging) to enter comments more easily. This button allows you to quickly return the column to its default width.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function - Attribute Usages

Related Topics

Enables you to define information about the attributes of an entity used by the function.

Entity

The name of the entity used by the function.

Attribute

The name of an existing attribute of the entity that is used by the function.

Insert, Retrieve, Update, Nullify, Archive and Other

The way in which the attribute is used by the function. The Other checkbox refers to a user-defined usage type.

Comments

Optional, 240 characters
A comment about the way in which the attribute is used by the function, if required.

Insert

Inserts a new blank row in the spreadtable. If a row is currently selected, the new row is inserted just before the current row. If no row is currently selected, the new row is inserted at the end of the spreadtable.

Delete

Deletes any currently selected rows from the spreadtable.

Tip:	Holding down the CTRL key and then pressing either the UP ARROW or DOWN ARROW key moves the cursor up or down a row in the spreadtable.

Pressing the TAB key moves the cursor across the fields in a row in the spreadtable.

Select All

Selects all the attributes in the Attribute dropdown list.

Reset Default

Resets the appearance of the spreadtable, e.g. column widths, to the default. For example, you may have increased the width of the Comment column (by placing the cursor on the line between two spreadtable headings and then dragging) to enter comments more easily. This button allows you to quickly return the column to its default width.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Edit Function - Text

Related Topics

Enables you to enter free-format multi-line text for the text types associated with the current function.

Text Type

Defines which text type you want to enter multi-line text for, and to enter the text. A list of currently defined text types is available. Additional text types can be defined using user extensibility.

Text Editor

Invokes a text editor for you to enter text.

HTML Editor

Invokes an HTML editor for you to enter text.

OK button

Saves any changes you may have made and closes the dialog box.

Cancel button

Cancels the dialog box without saving any changes you may have made.

Apply button

Saves any changes you may have made without closing the dialog box.

Help button

Displays help information about the current tab in the dialog box.


Creating a hierarchy of functions on a Dataflow Diagram

Related Topics

This task assumes that you have analyzed the business requirements and user needs and have identified the functions that you want to put into the Dataflow Diagram. You may have already drawn a draft function hierarchy.

To create a hierarchy of functions:

1.	If required, change the database connection.  How

2.	If required, change the workarea.  How

3.	Create a new diagram.  How

4.	(Optional)  Include any existing functions on the Dataflow Diagram.  How

5.	Create new functions.  How

6.	(Optional)  Change the sequence or parent of functions on the diagram. You can:

•	Reparent functions.  How

•	Resequence functions with the same parent.  How

•	Change a function into a root function.  How

•	Change a function into a common function.  How

7.	(Optional)  Display a different level of functions in the hierarchy. You can:

•	Open the parent function of a frame function.  How

•	Open a child function of a frame function.  How

8.	(Optional)  Tidy up the diagram using the Autolayout option.  How


Adding dataflows and other elements to a function hierarchy

Related Topics

After you have created a function hierarchy using the Dataflow Diagrammer, you can add dataflows and other elements to the diagram, or change the appearance of the diagram.

To add dataflows and other elements to a function hierarchy:

1.	Open a Dataflow Diagram.

2.	Create any additional elements required on the diagram. You can:

•	Create additional functions.  How

•	Create additional dataflows.  How

•	Create additional datastores.  How

•	Create additional externals.  How

3.	Include existing elements from the container.  How

4.	Delete any unwanted elements on the diagram. You can:

•	Delete elements from both the repository and the diagram, using Edit→Delete from Repository.

•	Cut elements from just the diagram and not the container, using Edit→Cut.

5.	Choose Options→Customize to change display characteristics on the diagram.


Refining the flow of data between elements

Related Topics

After you have created a Dataflow Diagram, you can refine it by changing the flow of data between elements on the diagram, changing the properties of elements, or changing the appearance of the diagram.

To refine the flow of data between elements:

1.	Open a Dataflow Diagram.

2.	Add detail to dataflows on the diagram. You can:

•	Split dataflows on the diagram.  How

•	Divide dataflows on the diagram. How

3.	Change the properties of elements.  How

4.	Choose Options→Customize to change display characteristics on the diagram.


Laying out Dataflow Diagrams automatically
Laying out a Dataflow Diagram automatically

Related Topics

A Dataflow Diagram can be automatically laid out a number of times, providing you with several alternative layouts. Any of these layouts can be retrieved if no other operation is performed between the autolayout operations.

Note:	After automatically laying out a diagram, the utility also minimizes the number of pages that the diagram covers. To improve the printed appearance of a diagram, you can move the elements on a diagram so that they cover the minimum number of pages.

To use the AutoLayout utility more effectively:

•	Increase the default element height and width in the Customize dialog box.

•	Reduce the size of the diagram, where possible.

•	Select all of the elements on the diagram before running the AutoLayout utility again. This gives the utility the maximum flexibility when rearranging elements on a diagram.

To reposition all elements automatically on the active diagram:

1.	Ensure that no elements are selected on the active diagram.

2.	Choose Layout→AutoLayout.

To reposition selected elements automatically on the active diagram:

1.	Select the elements to be automatically laid out.

2.	Choose Layout→AutoLayout.

Note:	The elements automatically laid out on the diagram are snapped to the grid lines defined for that diagram. The size of the grid cells is defined in the Customize dialog box.


Creating Dataflow Diagrams

Related Topics

You can create a Dataflow Diagram based either on an existing function or on a new function.

To create a diagram based on an existing function in the current container:

1.	Choose File→New.

2.	Select the container in which the function exists.

3.	Click OK.

4.	Select the function on which you want to base the new diagram.

The new untitled diagram is created with the selected function as the frame function; the diagram has no name assigned to it other than "DFD# (container_name)".

To create a diagram based on a new function:

1.	Choose File→New.

2.	Select the container for the new function and Dataflow Diagram from the Choose Container dialog box.

3.	Click OK.

4.	Click the Create Function button.

5.	Create a new function on which to base the new diagram.

The new untitled diagram is created with the new function as the frame function; the diagram has no name assigned to it other than "DFD# (container_name)".


Opening the parent function of a frame function

Related Topics

To open a diagram displaying the parent function of a selected frame function:

•	Choose File→Open Up.

This option displays a diagram for the parent function of the frame function.

If no diagram currently exists for the parent function ,Open up creates a new untitled diagram with the parent of the current frame function as a frame function. If the parent function is the frame function in more than one diagram, the Open Diagram dialog box is displayed listing all the diagrams with the parent function as the frame function.

Note:	You can see whether a function has a parent function, from the Definition tab of the Edit Function dialog box. Double click on a function diagram element to display this dialog box.


Opening a child function of a frame function

Related Topics

To open a diagram displaying a child function of a frame function as a frame function:

1.	Select the child function in the frame function for which you want to display a diagram.

2.	Choose File→Open Down.

Open down creates a new untitled diagram if no diagram currently exists with the selected child function as a frame function. If more than one diagram already exists for a selected function, this option displays the Open Diagram dialog box, displaying a list of diagrams based on the frame function.


If a function on the diagram is the parent of another function in the function hierarchy, an ellipsis (...) is displayed above the top right corner of the function.

If a local function that is the parent of other functions in the function hierarchy is selected, a new diagram is created with the selected function as the frame function. Local functions can be included into that frame function from the container.

If a new diagram is created by this option for a selected function that is connected to other elements on the diagram:

the elements are shown connected to the frame function on the new diagram:


Displaying the names of dataflows in a resolved flow

To display the names of the dataflows in a resolved flow:

•	From a Dataflow Diagram double-click on the name of the resolved flow

Note:	The Dataflows in Resolved Flow dialog box is displayed only if there is more than one dataflow in the resolved flow.


Splitting dataflows on Dataflow Diagrams
Splitting dataflows on a Dataflow Diagram

Related Topics

To split a dataflow on a Dataflow Diagram:

1.	Select the dataflow that you want to split.

2.	(Optional) Choose the datastore that you want to insert into the dataflow.

If you select a datastore it will be inserted into the dataflow.

If you do not select a datastore, a datastore will be automatically created (with a default name derived from the name of the dataflow) and inserted into the dataflow.

3.	Choose Utilities→Split Dataflow.


Dividing dataflows on Dataflow Diagrams
Dividing dataflows on a Dataflow Diagram

Related Topics

To divide a dataflow on a Dataflow Diagram:

1.	Select the dataflow that you want to divide.

2.	Choose Utilities→Divide Dataflow.

3.	Choose, from the list displayed in the dialog box, the details of the original dataflow that you want to allocate to the new dataflow.

The new dataflow is created between the same elements as the original dataflow, and is given the same name as the original function with a unique number at the end of the name.


Including elements on a Dataflow Diagram

When you include functions, global functions, datastores or externals on a diagram, you can choose to include all dataflows between those functions at the same time. Alternatively, you can include the dataflows separately by choosing Edit→Include→Dataflow.

Dataflows can also be included at the same time as you include other elements by checking the With Dataflows check box in the relevant include element dialog box displayed when you include elements on the diagram.

Resolved flows and global flows can be included at any time for elements already on the diagram.

To include elements on a Dataflow Diagram:

1.	Choose Edit→Include→<element type>.

2.	Select from the list box one or more elements that you want to include.

3.	(Optional)  To include any dataflows between included functions, global functions, datastores or externals, check the With Dataflows check box.

4.	To include the chosen elements on the diagram, click OK.


Defining the default size of elements on Dataflow Diagrams

Related Topics

The default size of any new elements created on a Dataflow Diagram can be defined in the Customize dialog box. The default size is also the minimum size to which an autolayout operation will resize elements.

To define the default height or width of elements of a specified type:

1.	Choose Options→Customize.

2.	From the Type field, select the element type whose height or width you want to define.

3.	Enter the height or width (in grid cells) for elements of the selected element type in the Minimum Element Width (cells) field.

4.	To define the element height or width on the active diagram only, click OK.

To define the element height or width on the active diagram and on any diagrams subsequently opened in the current and future invocations of the diagrammer, click Save.


Showing or hiding items and properties on Dataflow Diagrams

Related Topics

You can choose to show or hide the following items and properties on a Dataflow Diagram:

•	function sequence

•	function master

•	function definition

•	datastore identifier

•	global dataflows

•	resolved dataflows

To show or hide items and properties on a Datafloe Diagram:

1.	Choose Options→Customize.

2.	To show an item or property, check the appropriate check box.

To hide an item or property, uncheck the appropriate check box.

3.	To show or hide the specified items and properties on the active diagram only, click OK.

To show or hide the specified items and properties on the active diagram and on any diagrams subsequently opened in the current and future invocations of the diagrammer, click Save.


Creating business functions on Dataflow Diagrams

Related Topics

The steps below describe how to create a function on a Dataflow Diagram.

To create a new function:

1.	Open a Dataflow Diagram.

2.	Click [image].

3.	Move the cursor to the area of the diagram in which you want to position your function.

Note:	The new function must not overlap another element.

To create the new function at the default size, click the mouse button.

To create the new function larger or smaller than the default size, drag the rubber-band box to the desired size for the function, and release the mouse button.

4.	Enter the details for the function.


Changing a function into a root function on Dataflow Diagrams

Related Topics

To change a function on a diagram into a root function:

1.	In a Dataflow Diagram, drag a local function outside the frame function and release the mouse button.

2.	Confirm that you want to reparent the function.

3.	Check the Make Top Level check box.


Reparenting functions on Dataflow Diagrams

Related Topics

To reparent a function that is within the frame function on the diagram:

1.	Press and hold down the mouse button on the local function that you want to reparent.

2.	Drag the cursor outside the frame function and release the mouse button.

3.	Select the function in the list that you want to become the parent of the selected function.


Resequencing functions with the same parent on Dataflow Diagrams

Related Topics

To resequence functions with the same parent:

1.	On a Dataflow Diagram, select the function that you want to resequence.

2.	Choose Utilities→Resequence.

The position of the functions in the list represents the sequence of those functions in the hierarchy below the parent function.

3.	Select the function in the list that you want to resequence, then click the directional buttons to move the function up or down the list.


Creating dataflows on Dataflow Diagrams

Related Topics

To create a dataflow between two elements on a Datafloe Diagram:

1.	Click [image].

2.	Click on the element that you want to be at the parent end of the dataflow.

Note:	To insert a dog-leg in the dataflow, click the mouse button in the free space on the diagram where you want to create the dog-leg.

3.	Click on the element that you want to be at the child end of the dataflow.

Note:	At least one end of a dataflow must be connected to either a global function or a local function.

4.	Enter the details for the dataflow.


Creating datastores on Dataflow Diagrams

Related Topics

To create a datastore on a Dataflow Diagram:

1.	Click [image].

2.	Move the cursor to the area of the diagram in which you want to position your datastore.

Note:	The new datastore must not overlap another element.

To create the new datastore at the default size, click the mouse button.

To create the new datastore larger or smaller than the default size, drag the rubber-band box to the desired size for the datastore, and release the mouse button.

3.	Enter the details for the datastore.


Creating externals on Dataflow Diagrams

Related Topics

To create an external on a Datafloe Diagram:

1.	Click [image].

2.	Move the cursor to the area of the diagram in which you want to position your external.

Note:	The new external must not overlap another element.

To create the new external at the default size, click the mouse button.

To create the new external larger or smaller than the default size, drag the rubber-band box to the desired size for the external, and release the mouse button.

3.	Enter the details for the external.


   Select button

Related Topics

Puts the active diagram in Select mode. In Select mode, any element or association on the diagram can be selected or deselected by clicking on it. Selected items are displayed with grab bars. When an item has been selected, you can move it, resize it or set the preferences (e.g., fill color, line color, line width or font settings) for it.


Line width button
   Line Width

Changes the line width of the selected elements and associations on the active diagram.


Line color button
   Line Color

Changes the line color of the selected elements and associations on the active diagram.


Fill color button
   Fill Color

Changes the fill color of the selected elements and associations on the active diagram.


Font button
   Font

Changes the font used by the selected elements and associations on the active diagram.


File - Save Diagram
   Save Diagram (File Menu)

Related Topics

Saves the active diagram under its current name. If the diagram is untitled a dialog box is displayed for you to enter a name.


File - Save Diagram As
Save Diagram As (File Menu)

Related Topics

Names and saves the active diagram under a new name.

Dialog box options

Diagram name

The name under which you want to save the active diagram. This field can be populated by selecting one of the diagrams in the list or by entering the diagram name using alphanumeric characters. The default for this field is the name of the active diagram.

Diagrams for container

A list of the existing named diagrams in the container.


File - Delete Diagram
Delete Diagram (File Menu)

Related Topics

Deletes an existing diagram from a chosen container. This option deletes a diagram, but not any of the elements stored in the repository that are represented on the diagram.

Dialog box options

Diagrams for workarea

Lists the existing diagrams, grouped by container, that are visible to your workarea. Choose the diagram you want to delete by expanding the appropriate container node and selecting the diagram name.


File - Close
Close (File Menu)

Closes the active window without quitting the tool. To quit the tool use File→Exit.


File - Summary Information
Summary Information (File Menu)

Related Topics

Displays information about the active window and enables you to record additional information about the window.

The database connection and the current workarea cannot be changed using this menu option, but can be changed using File→Change Connection and File→Change Workarea.

Dialog box options

When the active window is a diagram, the dialog box has the following tabs:

Summary Details

Text

Otherwise, the Summary Information (without tabs) dialog box is displayed.


Summary Information - Summary Details

The Show checkbox adjacent to each field determines whether or not the information in the field is displayed in the print legend on the active window.

Note:	Summary information cannot be saved against a diagram unless that diagram has already been saved in the repository.

When a diagram is copied, i.e., you open a read-only copy of a currently open diagram, the summary information about that diagram does not get copied.

Diagram

The name of the active diagram.

Title

The title of the active window. The title can be used for displaying additional information on the window.

Created

The date and time on which the contents of the active window was created.

Last Modified

The date and time on which the contents of the active window was last modified.

Author

The author of the contents of the window.

Container

The name of the container that you are currently using.

Username

The username for the Oracle database that you are currently using.

Connect String

The connect string for the Oracle database that you are currently using.

Workarea

The name of the workarea that you are currently using.


Summary Information - Text

Related Topics

Used to enter free format multi-line text for the text types associated with the active diagram, such as notes and description.

Note:	Multi-line text can be entered only for named diagrams.

Text Type field

Defines which text type you want to enter multi-line text for. A list of currently defined text is available.

Text Editor button

Opens the ASCII editor, which enables you to attach ASCII text to the selected multi-line text property.

HTML Editor button

Opens the HTML editor, which enables you to attach HTML text to the selected multi-line text property.


Summary Information dialog box

Related Topics

Displays information about the Navigator. The checkbox adjacent to each field determines whether or not the information in the field is displayed in the print legend.

Workarea

The name of the workarea that you are currently using.

Username

The username for the Oracle database that you are currently using.

Connect String

The connect string for the Oracle database that you are currently using.


File - Change Connection
Change Connection (File Menu)

Related Topics

Changes the Oracle database to which the current tool is connected.

Connect dialog box


Connect dialog box

Specifies or changes the Oracle database to which the current tool is connected.

Username

The name of the user that must be specified to gain access to the database account.

You can specify the full connect string in this field, in the format:

username/password@database_alias

For example, to connect to a database with the alias HQ8 using the username and password scott, you would enter:

scott/scott@HQ8

Note:	If you specify the full connect string here, you do not need to complete the Password and Connect fields.

Password

The password for the given username. The password is displayed as asterisks.

Connect String

The database alias required to access the database account. You must ensure that the database alias is specified in the TNSNAMES.ORA file in your Oracle home directory, usually d:\oracle_home\NET80\ADMIN.


File - Change Workarea
Change Workarea (File Menu)

Related Topics

Changes the workarea for the current tool and provides access to the Workarea Wizard which allows you to create new workareas.

Note, you must have the repository management privilege before you can create workareas.

Workarea dialog box


Workarea dialog box

Specifies or changes the workarea for the current tool, and enables you to create a new workarea.

Workarea list box

Lists the workareas that you can choose, together with various details about them. You can choose a workarea by selecting it and clicking OK.

Workarea

The names of the workareas that have been defined in the repository.

Owner

The username of the repository user who created the workarea.

Type

Indicates whether this is a private or shared workarea. Private workareas can be accessed only by the user who created them. Shared workareas can be accessed by any user to whom the owner grants access.

Check In Branch

(Versioned repositories only) The default branch, if any, to which versioned objects are checked in if they are updated via this workarea.

New

Enables you to create a new workarea. Clicking this button starts the Create Workarea Wizard, a predefined set of screen forms that takes you step by step through the process of creating a workarea.


Create Workarea Wizard: Options

The Create Workarea Wizard: Options screen provides the following four options for creating a workarea:

Option	Description
Create a default workarea	Simplest option - just enter the workarea name
Copy a workarea	Copies an existing workarea, but allows you to modify workarea details in the copy
Create a workarea based on a file-stored workarea specification	Uses rules and configurations stored in a file to create the workarea; you can modify these and other details
Create a custom workarea	Provides greatest choice - you can manually define all the details of the workarea
Note:	To edit an existing workarea, select the workarea and choose Edit→Edit Workarea.

Additional fields are displayed from each of the four available options. These allow you to name the workarea, provide a suitable description for the new workarea and, where appropriate, name a workarea to copy from.

Once you have made your selection, the wizard takes you step by step through the process of creating the workarea.

When you create a workarea, it is initially a private workarea, meaning that only you can access it. Subsequently you can, if you wish, grant one or more other users access to it, thus making it a shared workarea. If you later revoke access to the workarea from all other users, the workarea becomes private again.

For all except a default workarea, you can specify a default checkin branch if the automatic branching policy is enabled. You can also change the rules and configurations that make up the workarea specification.

A basic workarea specification, consisting merely of the rule LATEST (MAIN), is applied to all new workareas by default. This rule specifies that each time the workarea is refreshed it will display details of the latest version of all objects to which you have access on the MAIN branch. It is not necessary for a workarea to have any other rules or any configurations specified for it, but if you want to refine the workarea specification, you can do so using the wizard.


Application System dialog box

Specifies or changes the application system for the current tool.

Application System entry box

Identifies the name of the application system you want to use. If an application system is selected in the list box, then the name of that application system is displayed in this field.

Application System list box

Lists the names and owners of all the application system that you may use. If you select an application system from this list, its name is displayed in the application system entry box.


File - Print
   Print (File Menu)

Related Topics

Prints the contents of the active window. This option enables you to specify the range of pages to be printed, the print quality, the number of copies, the destination printer and other printing options.

Dialog box options

Printer

The name of the current printer. The current printer can be changed using the Setup button. If the current printer is the system (that is, the default) printer it is stated in this field.

Print Range

All

Prints all pages. All is the default print range value.

Pages

Prints a range of pages specified by the From and To fields. For example, entering 2 in the From field and 6 in the To field prints pages 2 to 6 inclusive.

Print Quality

Specifies the print density. The higher the print density, the better the print quality, but higher-quality copies may take longer to print.

Copies

The number of copies of the print job that you want to print.

Print to File

Determines whether or not the print job is printed to a specified file instead of being sent to the printer. When checked, the Print to File dialog box is displayed.

Page Numbers

Determines whether or not page numbers are printed at the bottom of each page of the print job.

Print to ASCII

Prints the textual content of the Navigator window to a text file. If this box is checked, a dialog box is displayed for you to specify the name and location of the text file. Note this option is available from the Repository Object Navigator only.

Page Title

Determines whether or not the title is printed at the top of each page of the print job.

Page Boundaries

Determines whether or not indicators are displayed showing the outermost edges of the printable area of the page.

Scale to Pages

X:

Determines the number of pages in the horizontal axis on which the data will be printed.

Y:

Determines the number of pages in the vertical axis on which the data will be printed.

Fit to Page

Determines whether or not the data is printed so that it fits onto one sheet of the currently selected paper size.

Setup button

Allows you to view or change the configuration of the current printer, or to choose a different printer if more than one is available. Selecting this button displays the Print Setup dialog box.


File - Print Preview
Print Preview (File Menu)

Related Topics

Displays the contents of the active window as it will appear when printed, and provides options for navigating through, and for changing the magnification of, the pages within the Print Preview window. The contents of the active window can also be printed directly from this preview window.

Print preview buttons

Print button

Displays the Print dialog box, allowing you to specify how and where the data is printed, and to initiate the print job. Selecting this button cancels the Print Preview window.

Next Page button

Shows how the next page of the data will appear when printed.

Prev Page button

Shows how the previous page of the data will appear when printed.

One Page/Two Page button

Specifies whether one or two pages are previewed at a time.

Zoom In button

Enlarges part of the page preview display.

Zoom Out button

Reduces the magnification of the page preview display.


File - Print Setup
Print Setup (File Menu)

Related Topics

Configures printer settings such as the destination printer, the paper size and the paper orientation. Advanced document properties set within an application can also be set. These settings will override the default settings made in Windows.

Dialog box options

Printer

Determines whether you want to use the default printer or one of the other currently connected printers. A dropdown list of currently connected printers is available. The default printer can be changed, and other printers connected, from the Settings option on the Windows Start menu.

Orientation

Determines whether the printout will appear in portrait or landscape format. Selecting the appropriate option button changes the image of the page accordingly in this field.

Size

Determines the paper size for the printer.

Source

Determines the source of the paper for the printer.

Options button

Displays the Options dialog box for the currently selected printer, allowing you to set some of the more advanced document printing options. Third party printer help is available for the Options dialog box.


File - Recent File
Recent file (File Menu)

Opens any of the four most recently opened files (diagrams or logic text) in the current workarea. Diagrams or logic files in other workareas which have been opened recently may also be listed, but cannot be opened using this option.


File - Exit
Exit (File Menu)

Exits from the tool.


Browse dialog box

Directories

The directory where the file that you want to embed or link to is located.

Drives

The drive where the file that you want to embed or link to is located.

Network... button

Locates a file on the network. For more information, select the Help button on the Connect Network Drive dialog box.


Print to File dialog box (Description not used by Designer in 2.1)

Related Topics

Allows you to specify the name of the file to which a print job is to be saved.

File Name

Specifies the name of the file (maximum of eight characters, plus a three-letter extension), including its path, to which you want to print the diagram.

Attention:	The filename must be different from the original filename, or the diagram must be saved to a different drive or directory.

Note:	If no file of this name currently exists, one will be created.

All the files of the specified type in the specified directory are listed below the File Name field.

Save File as Type

Specifies the file extension for the file. It also filters the File Name list so that only files of the specified type are listed.

Drives

Select the drive on which you want to store the file.

Directories

Select the directory where you want to store the file.

Network button

Opens the Connect Network Drive dialog box so that you can make a connection to a network drive. For more information, choose the Help button in that dialog box.


Edit - Undo/Redo
Undo/Redo (Edit Menu)

Related Topics

Undoes the last action performed on the active window. Only certain actions can be undone. If the last action was performed using Edit→Undo, and the action can be redone, the menu option changes to Edit→Redo.


Edit - Cut
Cut (Edit Menu)

Related Topics

Removes the selection and places it on the Clipboard. Any text and graphics that you place on the Clipboard remains there until you replace it with a new item. The contents of the Clipboard can be pasted back using Edit→Paste. This option does not remove data from the repository.

Note:	When working in the Property Palette, the changes you make are not immediately stored in the repository. The changes will only be committed to the repository when you change the focus (by making another window active in the application) or by saving recent property changes.


Edit - Copy
Copy (Edit Menu)

Related Topics

Copies the selection onto the Clipboard. Text or graphics that you copy to the Clipboard replaces the previous contents. The contents of the Clipboard can be pasted back using Edit→Paste.


Edit - Paste
Paste (Edit Menu)

Related Topics

Inserts the contents of the Clipboard at the insertion point, replacing any selection if the selected text or graphic can be replaced. To place items on the Clipboard use Edit→Copy or Edit→Cut.


Edit - Edit Workarea
Edit Workarea (Edit Menu)

Related Topics

This option enables you to perform various workarea operations. About

Note:	In the Repository Object Navigator, this option is available when you select the name of the workarea in the Navigator window, or when you select an object visible in that workarea.

You can:

•	edit the workarea properties (name, description)

•	edit the workarea specification (the rules and configurations that determine which objects appear in the workarea)

•	specify a default checkin branch for versioned objects in a particular workarea

In either case, the menu option starts the workarea wizard at the appropriate point.


Edit - Refresh Workarea
Refresh Workarea (Edit Menu)

Related Topics

Enables you to reapply the workarea specification rules, updating the display of the workarea contents as a result.

This option displays a dialog box from where you can:

•	synchronize the repository with a file system

•	preview the changes that will be made before refreshing

Refreshing re-evaluates the workarea contents according to the workarea rules specified. For example, if a rule specifies that the workarea is to include the latest object versions on a particular branch and a user has updated an object on that branch, refreshing the workarea will show the new version of the object.

Dialog box options

Synchronize

Synchronize mapped folders/files after refresh

Synchronizes the repository with a file system to which a container in the workarea is mapped. Selecting this box performs the synchronization when the workarea is refreshed.

Include (create) files new to the repository

If synchronization would normally result in the creation of new files in the repository, selecting this box causes this to happen. Clearing the box prevents creation of new repository files (i.e., only files that have been changed will be refreshed). This box is activated only if you select the previous one.

Preview

Preview changes before refreshing

Select this box if you want to see the effect on the workarea of the refresh operation before it is performed, otherwise leave the box clear. The preview lists which objects will be added to, updated in, and removed from, the workarea when it is refreshed.


Preview Changes in Workarea Before Refreshing dialog box

Related Topics

Dialog box options

Changes in repository

If you chose on the previous screen to preview changes in both the repository and the file system, you can choose between the two options here.

New

Lists the objects that will be added to the workarea when it is refreshed.

Changed

Lists the objects that will be updated in the workarea when it is refreshed.

Removed

Lists the objects that will be removed from the workarea when it is refreshed.


Edit - Requery All
   Requery All (Edit Menu)

Related Topics

Compares all the elements displayed in the active window with their repository elements and, if there are differences, makes the display consistent with the repository.


Edit - Requery Selection
   Requery Selection (Edit Menu)

Related Topics

Compares one or more selected elements in the active window with their repository elements and, if there are differences, makes the diagram consistent with the repository. This option is dimmed if no elements are selected in the active window.


Edit Workarea Wizard: Properties

Enables you to rename a workarea and change the workarea description.

The workarea you are currently working in is the one selected for editing.

Note: 	You cannot select an alternative workarea to edit using this window.

If you choose to rename your workarea, the new name must be unique in the repository.

Dialog box options

Name

The name of the workarea selected to edit. You can enter a new unique name to rename the workarea.

Description

The description of the workarea selected to edit. You can enter a new description.


Create / Edit Workarea Wizard: Rules Specification

Displays the rules, configurations or both that make up the current workarea specification.

Using this dialog you can:

•	load an existing workarea specification from a template file in your file system

•	edit the workarea specification

•	save the workarea specification to a file

If you are creating a new workarea by using a specification file or by copying an existing workarea, any included rules and configurations are displayed.

If you are creating a custom workarea and have not specified any other workarea or specification file as its basis, the default rule LATEST(MAIN) is displayed.

If you are editing an existing workarea, any rules and configurations associated with the workarea are displayed.

Dialog box options

Load from file

(Edit Workarea Wizard only) Enables you to load an existing specification from a file. Specification files are given the .CWS extension by default.

Edit

Displays the Edit Specification dialog box for you to edit the current specification by:

•	adding new rules and/or configurations to the specification

•	deleting rules and/or configurations from the specification

•	rearranging rules and/or configurations within the specification

Save to file

Allows you to save the specification to a template file in your file system. The file is assigned the .CWS extension unless you choose otherwise.


Edit Specification dialog box

A workarea specification or a configuration can be built from objects from a variety of sources. For example, you may base a configuration on the contents of a workarea and then include an existing configuration together with additional rules and specific versions of individual objects.

The Edit Specification dialog box allows you to do the following to the selected workarea specification or configuration:

•	add or remove rules

•	add or remove configurations

•	reorder the list of included rules and configurations

•	include or exclude specific objects

Dialog box options

For

Displays the name of the workarea or configuration whose specification you are editing

Rules tab

Enables you to select a rule to include in the list of member rules and configurations.

The fields displayed on the Rules tab depend on the selected rule. About

Configurations tab

Latest version

When checked, displays only the latest version of the configurations to which you have access. When clear, displays all versions of all configurations.

Configurations

Displays all configurations under version control that you have access rights to.

Filter

Allows you to enter search criteria to locate specific configurations. You can use wildcard characters, for example "%" to specify "any character".

	moves selected rule or configuration into the Member rules and configurations list
	moves selected rule or configuration out of the Member rules and configurations list
Member rules and configurations

Lists the rules and configurations currently associated with the workarea or configuration.

	moves the selected rule or configuration up one position in the member rules and configurations list
	moves the selected rule or configuration down one position in the member rules and configurations list
	includes objects in the workarea or configuration
	excludes objects from the workarea or configuration


Create / Edit Workarea Wizard: Default Checkin Branch

Displays all branches available to you, and enables you to set the default checkin branch.

The value <None> causes objects to be checked in by default on the branch from which they were checked out. In some cases, described below, the wizard sets this value automatically and you cannot change it.

If you want to use a branch other than those listed, create a new branch. How

If you are creating a default workarea or a workarea based on a specification file, the wizard selects the value <None>.

If you are creating a workarea based on an existing workarea, the default checkin branch for the workarea you are copying is selected.

If you are editing a selected workarea, the current default checkin branch for that workarea is selected.

Before setting the default checkin branch, the wizard checks the repository automatic branching policy. If the automatic branching policy is not enabled, the wizard selects the value <None>.

Dialog box options

Select the workarea default checkin branch

All available checkin branches for the repository are listed. Select the one you want to use as the default.

Remind me to merge objects to the new checkin branch

(Displayed for Edit Workarea only) Invokes the Merge Wizard at the end of an edit workarea operation. If you are changing the default checkin branch, you can use the wizard to merge changes from object versions on the old branch with versions on the branch to which you are changing.


Edit - Requery
Requery (Edit Menu)

Refreshes the version tree for the object currently displayed in the Version History Viewer, enabling you to see any recent changes that have been made.


Edit - Select All
Select All (Edit Menu)

Related Topics

Selects all items on the active diagram. All items are selected whether or not they were already selected.


Edit - Select Same Type
Select Same Type (Edit Menu)

Related Topics

Selects all items that are of the same element type as the current selection in the active diagram. This option is available only if you have selected a single diagram item.


Edit - Insert New Object
Insert New Object (Edit Menu)

Related Topics

Inserts an embedded object into the current diagram or creates a link between the current diagram and another file.

Dialog box options

The information displayed and requested in the dialog box will depend on you selecting one of the following options:

•	Create New

•	Create from File

Create New

Enables you to embed a new OLE object onto the diagram.

Object Type list box

Select the type of information you want to insert onto the diagram. The contents of the list box depend on which applications are installed on your computer support object linking and embedding.

Create from File

Enables you to embed or link to an existing OLE object onto the diagram.

File text box

The name of an existing file you want to insert as an embedded object onto the diagram. If you check the Link checkbox a link to this file will be created rather than embedding it.

Browse... button

Opens the Browse dialog box so that you can search for a particular source document.

Link checkbox

Indicates that a link to the specified file is to be created rather than embedding it.

Display As Icon checkbox

Indicates that the embedded object is displayed as an icon on the diagram.

Change Icon button

Changes the icon that represents an embedded object or linked information on a diagram. This button is only displayed when you check the Display As Icon checkbox. For more information, select the Help button on the Change Icon dialog box.

Result text box

Describes the result of the selected option.


Edit - Object
Object (Edit Menu)

Related Topics

This option is available only if an object has been created by selecting Edit→Insert New Object. The OLE menu options available from the Edit Menu is dependent on the type of object (embedded or linked) and the OLE capabilities of the application you used to create the object. The following menu options may be available:

Edit→<Object Name> Object→Edit

Edit→<Object Name> Object→Open

Edit→<Object Name> Object→Convert

Note: 	If you have used the Object Packager to embed a packaged object the options displayed on this menu will be different. For more information about OLE packages, see the Help documentation for Object Packager.


Edit - Object Edit/Open
Object Edit/Open (Edit Menu)

Related Topics

Edit

Opens the object in the current application window (the toolbars and menus will change). The <object name> Open menu option changes depending on the selected object. For example, the Designer application displays the Edit→Document Object→Edit menu option if the selected embedded object is a Microsoft Word document.

This menu option is available only if an embedded or linked object is selected.

Note:	If a package is selected on the active diagram, the Edit menu option changes to Package Object. Select Edit→Package Object→Edit Package to invoke the Object Packager application. The Object Packager can be used to edit the embedded or linked object.

Open

Opens the embedded or linked object in its own application window. The <object name> Open menu option changes depending on the object you select. For example, the Designer application displays the Edit→Bitmap Image Object→Open menu option if the selected embedded object is a Microsoft Paint image.

This option is available only if an embedded or linked object is selected.

Note:	If a package is selected on the active diagram, the Edit menu option changes to Package Object. Select Edit→Package Object→Activate Contents to view the contents of the package.


Edit - Object Convert
Object Convert (Edit Menu)

Related Topics

Converts an embedded object to a different file format or changes the display of an embedded or linked object.

The <object name> Convert menu option changes depending on the object you select. For example, the Designer application displays the Edit→Document Object→Convert menu option if the selected embedded object is a Microsoft Word document.

This menu option is available only if an embedded or linked object is selected.

Note:	If a package is selected on the active diagram, the menu option changes to Edit→Package Object→Convert.

Dialog box options

Current Type

Displays the type of object that you are converting or activating. For example, Microsoft Word.

Object Type list

Select the type of object to which you want to convert. The contents of the list box depend on which applications are installed on your computer support object linking and embedding.

Convert to

Converts the selected object to the type of information selected in the Object Type list box.

Activate As

Opens the selected object in the type of information selected in the Object Type list box, but after editing, returns the object to the type displayed in Current Type.

Display As Icon

Indicates that the embedded object is displayed as an icon on the diagram.

Change Icon... button

Changes the icon that represents an embedded object. This button is only displayed when you check the Display As Icon checkbox. For more information, select the Help button on the Change Icon dialog box.

Result

Describes the result of the selected option.


Edit - Links
Links (Edit Menu)

Related Topics

Displays and modifies existing links on the diagram. This option is dimmed if no links exist on the diagram.

Dialog box options

Links Box

Displays details for all links on the diagram, including the filename, the type and whether the tool updates the links automatically or manually.

Source

Displays the name and the location of the source file.

Type

Displays the application or type of application in which the linked object was created.

Update

Indicates how the information in the linked object is to be updated.

Automatic

Indicates that existing data will be updated every time new data becomes available.

Manual

Indicates that the data will only be updated when you select the Update Now button.

Update Now button

Updates all selected links in the Links box.

Open Source button

Opens the selected file in the source application ready for editing.

Change Source... button

Specifies a different source file for a selected link so that the link receives data from the new source file. For more information, use the context-sensitive help facility in the Change Source dialog box.

Break Link button

Breaks the link between the source file and the current diagram for all selected links.


Edit - Paste Link
Paste Link (Edit Menu)

Related Topics

Inserts a linked object from the Clipboard. The linked object is displayed on the diagram but is defined and stored in the source document.


Layout - Autolayout
   Autolayout (Layout Menu)

Related Topics

Repositions the selected elements on the active diagram so that they are presented in a different syntactically correct layout. This process can be repeated until the preferred layout of elements is achieved. If no elements are selected on the active diagram, this option will reposition all the elements on the active diagram.


Layout - Autolayout to New Area
Autolayout to New Area (Layout Menu)

Related Topics

Repositions the selected elements within a newly defined autolayout area on the active diagram so that they are presented in a syntactically correct layout. This process can be repeated until the preferred layout of elements is achieved on the active diagram.

If the newly defined autolayout area is not large enough to contain the selected elements at their current sizes, the selected elements will not be automatically laid out.


Layout - Autolayout to Same Area
Autolayout To Same Area (Layout Menu)

Related Topics

Repositions the selected elements within the previously defined autolayout area on the active diagram so that they are displayed in a syntactically correct layout. This process can be repeated until the preferred layout of elements is displayed on the active diagram.

The previously defined autolayout area must be large enough to contain the selected elements at their current sizes.


Layout - Previous Layout
   Previous Layout (Layout Menu)

Related Topics

Undoes the previous autolayout operation performed on the active diagram. This option is available only if:

•	elements on the diagram have been automatically repositioned two or more times in succession, and no other subsequent actions have been performed

•	there are still previous autolayout operations to be restored.


Layout - Minimize Number of Pages
Minimize Number of Pages (Layout Menu)

Related Topics

Minimizes the number of pages used for the active diagram. Since deleting or moving the last diagram item on a page does not also automatically delete the page, a diagram may include redundant blank pages outside the outermost points of any items on the diagram. This option fits the area of the diagram within its outermost points into as few pages as possible, by shifting the diagram to the top left corner and removing any redundant blank pages.


View - Normal Size
Normal Size (View Menu)

Related Topics

Resets the magnification of the diagram in the active window to the magnification it was displayed when opened or created.


View - Zoom In
   Zoom In (View Menu)

Related Topics

Increases the magnification of the diagram in the active window. The new view of the diagram is centered around the same position as the view on which the magnification is based.


View - Zoom Out
   Zoom Out (View Menu)

Related Topics

Decreases the magnification of the diagram in the active window. The new view of the diagram is centered around the same position as the view on which the reduced magnification is based.


View - Fit to Area
   Fit to Area (View Menu)

Related Topics

Increases the magnification of a selected area of the diagram so that it fits the active window.


View - Fit to Selection
   Fit to Selection (View Menu)

Related Topics

Adjusts the magnification of items selected on the diagram in the active window so that they are displayed at the maximum size that can fit into that diagram window.

This option is available only if one or more items are selected on the diagram.


View - Fit to Diagram
   Fit to Diagram (View Menu)

Related Topics

Adjusts the magnification of the whole diagram in the active window so that it is displayed at the maximum size that can fit into that window.


View - Toolbar
Toolbar (View Menu)

Related Topics

Shows or hides the standard toolbar below the menu bar.


View - Tool Palette
Tool Palette (View Menu)

Related Topics

Shows or hides the tool palette.


View - Status Bar
Status Bar (View Menu)

Related Topics

Shows or hides the status bar at the bottom of the application window.


View - Spreadtable View
      Spreadtable View/Default View (View Menu)

Related Topics

The Property Palette can display properties in one of two views: spreadtable view, and default view.

Spreadtable View   [image]    In spreadtable view,  you can list more than one set of properties in the spreadtable. For example, you can select two or more tables from the Navigator and compare their property values on the spreadtable.

Default View  [image]    In default view, the Property Palette is displayed as a two-column grid, with the property names listed vertically and their values listed alongside.


View - Intersection View
      Union View/Intersection View (View Menu)

Related Topics

The Property Palette can show a set of properties in one of two views: union (the default) and intersection. The union/intersection view applies to conflicts of property types (e.g., Name, Length) and not to conflicts of property values (e.g., HEADQUARTERS, 10). Thus the setting of this button is not relevant when the selected repository objects are of the same type because in this case they have the same set of property types.

If there is a property type that has been given different values for different repository objects, then that property value is displayed in the Property Palette as a set of hashes (#####) regardless of the Union/Intersection button.

Union View    [image]   In Union View, the Property Palette lists the combined property types, i.e., all the property types of the selected object types.

Intersection View   [image]   In Intersection View, the Property Palette lists only the common property types, i.e., the property types that appear in all of the selected types.


View - Grid
Grid (View Menu)

Related Topics

Shows or hides the grid in the active window.


Options - Customize Property Palette
Customize Property Palette (Options Menu)

Customizes which properties are displayed on the Property Palette.

Dialog box options

Show

Show Owning Folder

Displays or hides the name of the owning container for an element.

Show Version Label

Displays or hides the version label property in the Property Palette.

Show Audit Properties

Displays the audit properties (date created, date changed etc.) in the Property Palette.

Property Clipboard

Include Multi Line Text Properties

Includes or excludes multi-line text properties in the Properties Clipboard, used when copying properties.

Automatically switch to spreadtable mode on multi insert

If active, automatically switches the Property Palette to spreadtable view when creating more than one element in a single operation.


Options - Text Editor Options
Text Editor Options (Options Menu)

Related Topics

Defines Text Editor options. This enables you to specify which text editor to use for the values of repository definition properties that are stored in ASCII or HTML format.

Default text editors are set up for ASCII text and HTML text based on the settings in the Windows Registry. You can specify alternative editors for either or both of these kinds of text.

Dialog box options

Text Editor

Select command to run the ASCII editor

The command that runs the ASCII text editor. Ensure that the filename is followed by the characters <SPACE>%1 in order for the command to function correctly.

Browse button

Locates the .EXE file for the ASCII text editor. Selecting this button displays the Browse dialog box.

HTML Editor

Select command to run the HTML editor

The command that runs the HTML editor. If you specify Netscape Navigator as the editor, ensure that the filename is followed by the characters <SPACE>"%1" for the command to function correctly.

Browse Button

Locates the .EXE file for the HTML editor. Selecting this button displays the Browse dialog box.


Options - Broadcast Options
Broadcast Options (Options Menu)

Related Topics

Defines broadcast options.

Dialog box options

Broadcast Notifications

Disabled

Turns off the broadcasting mechanism, i.e., the user does not receive (or send) notification messages.

Desktop only

Broadcasts all changes made in the current tool to all tools running on this machine.

Network

Broadcasts all changes made in the current tool to all users participating in the network broadcasting mechanism.


Options - Diagnostics
Diagnostics (Options Menu)

Allows you to set diagnostic file and trace settings. This feature should not be used unless requested to do so by your Oracle customer support representative. If you inadvertently set any of the diagnostic options you may find that the tool's performance is affected. If you do find any degradation in performance, click the Disable Option button to switch off the diagnostics facility.


Font dialog box

Allows you to specify the details of the font to be used for a text item.

Dialog box options

Font

Specifies the font to be used. You can choose a font from the list.

Font Style

Specifies the style for the selected font. You can choose a style from the list. Available styles are: regular, italic, bold and bold italic.

Size

Specifies the size in points of the font for this text item. A point is 1/72nd of an inch.

Sample

Shows an example of how this text item will appear with the current font options.

Script

Specifies the character set to be used for the selected text item.


Tools - Navigator
Navigator (Tools Menu)

Related Topics

Opens a new Navigator if none is open, or makes the Navigator window the active window if the Property Palette is active.

Navigator windows use a tree structure to represent the repository definitions that are recorded  in the repository, and the associations between those definitions.


Tools - Property Palette
Property Palette (Tools Menu)

Related Topics

Opens a new Property Palette if none is open or if the present palette is pinned, or makes the latest Property Palette the active window if the Navigator window is active.

Property Palettes display the properties of definitions, e.g. table definitions, that are recorded in the repository.


Edit - TextPad
   TextPad (Edit Menu)

Related Topics

Opens the TextPad, which enables you to attach textual information to the selected text property.


Edit - ASCII Editor
   ASCII Editor (Edit Menu)

Related Topics

Opens the ASCII editor, which enables you to attach ASCII text to the selected multi-line text property.


Edit - HTML Editor
   HTML Editor (Edit Menu)

Related Topics

Opens the HTML editor, which enables you to attach HTML text to the selected multi-line text property.


Tools - Process Modeler
Process Modeler (Tools Menu)

Related Topics

Invokes the Process Modeler with the same database connection and workarea as the current tool.


Tools - Dataflow Diagrammer
Dataflow Diagrammer (Tools Menu)

Related Topics

Invokes the Dataflow Diagrammer with the same database connection and workarea as the current tool.


Tools - Repository Reports
Repository Reports (Tools Menu)

Invokes the Repository Reports tool, which enables you to run reports about the contents of the repository.


Tools - Entity Relationship Diagrammer
Entity Relationship Diagrammer (Tools Menu)

Related Topics

Invokes the Entity Relationship Diagrammer with the same database connection and workarea as the current tool.


Tools - Function Hierarchy Diagrammer
Function Hierarchy Diagrammer (Tools Menu)

Related Topics

Invokes the Function Hierarchy Diagrammer with the same database connection and workarea as the current tool.


Tools - SQL Plus
SQL*Plus (Tools Menu)

Opens a SQL*Plus window.


Tools - Repository Object Navigator
Repository Object Navigator (Tools Menu)

Invokes the Repository Object Navigator with the same database connection as the current tool.


Tools - Dependency Manager
Dependency Manager (Tools Menu)

Related Topics

Invokes the Dependency Manager, from which you can examine dependency information stored in the repository. You can also use the Dependency Manager to edit some repository information.


Tools - Matrix Diagrammer
Matrix Diagrammer (Tools Menu)

Invokes the Matrix Diagrammer with the same database connection and workarea as the current tool.


Tools - Design Editor
Design Editor (Tools Menu)

Related Topics

Invokes the Design Editor with the same database connection and workarea as the current tool.


Window - New Window
New Window (Window Menu)

Creates a new diagram window containing the active diagram. You can use this new window to display a different part of the active diagram.


Window - Cascade
Cascade (Window Menu)

Arranges all your open windows so that they overlap and each window's title bar is visible.


Window - Tile Horizontally
Tile Horizontally (Window Menu)

Arranges all your open windows so that they fit horizontally in the main window. The title bar and a portion of the tool remain visible for each window. The windows are displayed at the largest possible size that will fit into the tool window without overlapping each other or the icons of minimized tool windows.


Window - Tile Vertically
Tile Vertically (Window Menu)

Arranges all your open windows so that they fit vertically in the main window. The title bar and a portion of the tool remain visible for each window.


Window - Arrange Icons
Arrange Icons (Window Menu)

Arranges your window icons so that they line up neatly and do not overlap.


Window - Window Name
1, 2, 3... Command (Window Menu)

Switches to the window and makes it active. A check mark is displayed next to the name of the active window.


Window - Arrange Windows
Arrange Windows (Window Menu)

Displays all open windows so that they do not overlap.


Help - Help Topics
Help Topics (Help Menu)

Related Topics

Displays a list of the main subject areas in the online documentation system.


Help - Show Keys
Show Keys (Help Menu)

Displays the shortcut keys for the current tool.


Help - How to use Help
How to Use Help (Help Menu)

Related Topics

Displays general information on how to use the Microsoft Windows help.


Help - About
About (Help Menu)

Displays copyright and version number information about this application. You might need to know the version number for product support purposes.


Help - Customer Support
Customer Support (Help Menu)

Displays an Oracle Support Problem Report (displayed in your default ASCII text editor) that you are requested to complete before contacting Oracle Support for assistance. The report asks for details about you, your environment setup and details about the problem, including any steps to reproduce the problem. By completing this form prior to contacting Oracle Support, you will aid the processing and response to your request.

A default text editor is set up for ASCII text based on the settings in the Windows Registry. You can specify an alternative editor by using Options→Text Editor Options.


Context-Sensitive Help button
   Context-Sensitive Help

Related Topics

Provides access to context-sensitive help information about the menu options, standard toolbar and drawing toolbar buttons.

Selecting this button, or pressing SHIFT+F1, and then selecting a menu option, standard toolbar button or palette button, displays help information for the chosen item.


Utilities - Resequence
Resequence (Utilities Menu)

Related Topics

Allows you to change the order in which some types of selected elements are ordered in the Navigator. For example, you can resequence columns in a table definition.

Elements that can be resequenced are indicated in the Navigator window by [image].

Dialog box options

List box

Lists the repository definitions that you can resequence. This list box allows single selection only. Use the resequence buttons to move a selected definition up or down the list box.

Resequence buttons

Specifies the order in which the definitions are to be displayed on the Navigator window and diagrams.

Tip:	Instead of using the Resequence buttons you can hold down the CTRL key and press the Up and Down arrows.


Utilities - Select in Other Tools
Select in Other Tools (Utilities Menu)

Related Topics

Selects the same repository objects, as currently selected on the active tool, in other tools (providing that the other tools are open in the same context).


Utilities - Update Columns in a Domain
Update Columns in a Domain (Utilities Menu)

Related Topics

Updates all the appropriate columns/Oracle object type attributes with the property details of the selected domain. You might use this, for example, when you make a change to a domain and want to propagate these changes to all the columns/type attributes that use that domain.

This utility overwrites any properties in a column/attribute that conflict with the same property in the column's/attribute's domain. Null values in the domain replace any non-null values. The exception to this is the Default Values property, which is overwritten only if the corresponding column/attribute property has a null value.


Utilities - Force Delete
Force Delete (Utilities Menu)

Related Topics

Invokes the Force Delete or Force Purge wizard. These wizards remove selected repository objects or secondary access controlled (SAC) elements, regardless of any delete constraints that may have been defined for the corresponding object type. About

Each wizard is a predefined set of screen forms that takes you step by step through the force delete or force purge process.

Note:	It is possible to undo a force delete operation. Objects removed in this way are placed in the workarea wastebasket, from where they can be recovered. However, it is not possible to recover references or child elements of force-deleted objects.

It is not possible to undo a force purge operation.

The Force Delete Wizard is invoked if the selection is a non-versioned object or a SAC element of any kind of object. In this case the selection is removed to the workarea wastebasket. If the selection is a checked-out versioned object, Force Delete has no effect. You can use the Force Delete Wizard only if you have the FORCE system privilege, and DELETE access rights to the workarea and the owning container.

The Force Purge Wizard is invoked if the selection is a checked-in versioned object. The version visible in your workarea is completely removed from the repository and cannot be recovered. You can use this wizard only if you have the FORCE or PURGE system privileges, and DELETE access rights to the owning container.


Force Delete/Force Purge: Objects Selected

Lists the objects that you have selected for the force delete or force purge operation.

If the list is incorrect, click Cancel and reselect the objects, otherwise click Next.

Path

The hierarchical path of the object in your workarea.

Element Type

The repository element type for this object.


Force Delete/Force Purge: Purged Objects
Force Purge: Purged Objects

Lists the objects that will be purged (that is, have all object versions removed).

Status

A value of OK indicates that the purge operation can continue for this object. If an object is checked in, this is indicated; you will need to select the object and check it out before the operation can continue.

An example of when an object in the list might be checked in would be when purging a domain that is referenced by a column. In this case the column will be cascade deleted. However, if the table to which the column belongs is checked in, it must be checked out before the column can be deleted and the operation can continue.

Path

The hierarchical path of the object in your workarea.

Element Type

The repository element type for this object.

Check Out

Checks out a selected item in the list that is marked as checked in, so that the operation can continue.


Force Delete/Force Purge: Deleted Objects

Lists the objects that will be deleted.

Status

A value of OK indicates that the delete operation can continue for this object. If an object is checked in, this is indicated; you will need to select the object and check it out before the operation can continue.

An example of when an object in the list might be checked in would be when deleting a domain that is referenced by a column. In this case the column will be cascade deleted. However, if the table to which the column belongs is checked in, it must be checked out before the column can be deleted and the operation can continue.

Path

The hierarchical path of the object in your workarea.

Element Type

The repository element type for this object.

Check Out

Checks out a selected item in the list that is marked as checked in, so that the operation can continue.


Force Delete/Force Purge: References

Lists reference properties for the objects that you are deleting or purging. These references will be nullified. Note that, although deleted objects (but not purged objects) can be restored from the wastebasket, the references cannot.

Status

A value of OK indicates that the operation can continue. If an object is checked in, this is indicated; you will need to select the object and check it out before the operation can continue.

Property

The element type of the reference property.

Referencing Element/Element Type

The element (and its type) that references the object selected for delete or purge. For example, if you are deleting a domain that is referenced by a column, this field shows the column name and its path in the repository.

Referenced Element/Element Type

The element (and its type) that is referenced by the element in the previous pair of fields. For example, if you are deleting a domain that is referenced by a column, this field shows the domain name and its path in the repository.

Check Out

Checks out a selected item in the list that is marked as checked in, so that the operation can continue.


Utilities - External References
External References (Utilities Menu and Configuration Wizard)

Related Topics!Alink(COM_Listing_external_references, , , )

Enables you to check whether repository objects in a selected workarea, container or configuration make reference to objects outside that workarea, container or configuration. You can then include any of these externally referenced objects in the workarea, container or configuration.

Dialog box options

For

The name and (if under version control) the version label for this workarea, container or configuration.

List Mandatory Only

When this check box is selected, clicking the List button causes the display to show only the mandatory external references for this workarea, container or configuration.

Recurse Sub Folders

When this check box is selected, clicking the List button causes the display to also show external references for child objects of this workarea, container or configuration (for example, sub-folders of a folder).

Name

The name of an object for which an external reference exists.

Type

The type of object listed.

Reason

The reason why the reference to this object is classed as an external reference:

Lost + Found	The object resides in the Lost+Found area, i.e. it has no owning container
No Access Rights	You do not have access to the container that owns this object
Not in Folder	This object is not in the selected container
Not in Workarea	This object is not in the selected workarea
Not in Repository	This object is not in the repository; this message indicates a problem that requires resolution, e.g. by creating the required object
Wrong Version	The referenced version of this object has no record of the reference; you can use Change Version to choose a different version
Status

Indicates whether the object is checked in, checked out or not under version control. If an object is not checked in, you cannot include it in a workarea.

Mandatory

Indicates whether this is a mandatory reference.

Version

The version label for this object (if it is under version control).

Include Iteratively

When this check box is selected, selecting objects from the list and clicking the Include button causes these objects to be iteratively included in the selected workarea, container or configuration. This means that any objects referenced by the externally referenced objects are also included, as well as any objects referenced by those extra objects, and so on until all referenced objects are included. Example

Show Latest on Branch

Appears only if workarea or configuration selected. For objects under version control, this enables you to list objects from a checkin branch other than the default.

List

Redisplays the list based on the status of the List Mandatory Only and Recurse Sub Folders check boxes.

Select All

Selects all the objects in the list of references. Used in conjunction with the Include button.

Include

For objects selected in the list, includes these objects in the container identified by the For: field.

Change Version

If the For field shows a workarea or configuration name, then for a selected object in the list, this allows you to list a different version of that object (if the object is under version control).

List References

For a selected object in the list, shows the objects that reference it and the kind of reference they make to it.


Include iteratively - example
Iterative inclusion - example

Assume that a container called Folder1 has an entity, ENT_A, which has a relationship to ENT_B in a different container, Folder2. ENT_B, in turn, has references to ENT_X, ENT_Y and ENT_Z in other containers. You select Folder1 and list its external references. You see only ENT_B in the list. You want to include ENT_B in Folder1, so you select ENT_B in the list.

If you clicked Include at this point, you would include only ENT_B in Folder1. However, you want to include not only ENT_B but any other objects that it references, and any other objects that they reference, and so on. To do so, you select the Include Iteratively check box and click Include.


Utilities - Extended Copy
Extended Copy (Utilities Menu)

Related Topics

Copies one or more selected PAC elements within a workarea, enabling you to specify what to do about references to other objects. The copies are renamed with a system-generated or a user-defined name.

This option invokes the Extended Copy Wizard, a series of screens that takes you step by step through the copy process.


Extended Copy Wizard:  Copy List

Specifies the complete set of objects to be copied.

Target Container

(Mandatory)  The container to which the objects are to be copied.

Objects to Copy

Lists the set of objects that are to be copied.

Path

The complete repository path specification of an object to be copied.

Element Type

The element type for this object.

Add

Enables you to include further objects in the set to be copied.

Remove

Removes selected objects from the copy list.

Copy Dependencies

When checked, copies any dependency information created for the objects by the Dependency Manager tool. When cleared, no dependency information is copied.


Extended Copy Wizard:  References

Lists all objects referenced by those in the copy set. You can choose to copy the referenced objects, leave them as they are, nullify the reference properties or remap the references to different objects.

Type

Type of object identified by Name.

Name

The name of a referenced object.

In Target ?

Indicates whether the referenced object is owned by the target container.

Copy

Copies the referenced object as well as the referencing object, and updates the reference properties to point to the new copy of the object.

Leave

Specifies that the referenced object is not copied, nor are the reference properties updated. This applies only to those objects that are known as "shareable" (that is, they can be referenced from a container other than their own). The exceptions are listed here.

Null

For optional references only, sets the reference properties to null in the new copy of the object. Does not apply to mandatory references.

Remap

Enables you to change the reference properties to point to a different object. Checking this box displays a screen from which you can choose a different object.

Remap to

If Remap is checked, this field identifies a likely candidate for the remap (an object with the same name and type) in the target container, if such an object exists. If you choose a different object, it is shown here.

Details

For a selected object in the referenced objects list, indicates which objects reference it.

Set Remap

Changes the reference properties to point to the object indicated in the Remap To field.


Extended Copy Wizard:  Reference Details

For a selected object in the referenced objects list, indicates which objects reference it.

Type

The type of object that references the object shown at the top of the screen.

Name

The name of an object that references the object shown.

Property

The property through which the object is referenced.

Mandatory

Indicates whether this is a mandatory reference.


Extended Copy Wizard:  Name Change

Enables you to specify a new name for a copied object. Lists all the objects to be copied.

Original Path

The repository path and name of the object being copied.

Copy Name

The name you want the copy to have. By default the name of the copy is name_1, where name is the name of the original object. You can specify a different name for the copy here.


Utilities - Publish Diagrams
Publish Diagrams (Utilities Menu)

Related Topics

Publishes diagrams to a file or to the Repository Object Browser (ROB).

This option opens the Publish Diagrams dialog.


Publish Diagrams dialog

Enables you to publish Designer diagrams to the Repository Object Browser (ROB) or to save them as files to a file system directory.

Available Diagrams pane

Shows the diagrams within the current workarea.  If you want to publish a subset of these diagrams, click the diagram or diagrams that you want to publish.

Single right arrow

Click to move the diagrams highlighted in the Available Diagrams pane to the Selected Diagrams pane.

Single left arrow

Click to move diagrams highlighted in the Selected Diagrams pane to the Available Diagrams pane.

Double right arrow

Click to move all diagrams in the Available Diagrams pane into the Selected Diagrams pane.

Double left arrow

Click to move all diagrams in the Selected Diagrams pane to the Available Diagrams pane.

Selected Diagrams pane

Diagrams listed in this pane will be published when you click the OK button.  If a diagram was active in the Design Editor when you opened the Publish Diagrams dialog, it will automatically be listed in this pane.

File Name text box

This is enabled only if the "Publish to File" option is chosen (see below). This text box displays the target file name for the diagram currently highlighted in the Selected Diagrams pane. By default the target file name is the same as the diagram name in the repository.  You can change the target file name by overtyping the text in this box.

Destination group

Use the options in this group to specify the destination for publishing.

Publish to Repository Object Browser option

Choose this option to publish the diagrams to the Repository Object Browser.

Publish to File option

Choose this option to publish the diagrams to files.

Directory text box

This text box shows the file system directory to which the files containing the diagrams will be written.  A directory will be suggested, which will be one of the following:

-	the mapped directory of the application system, if the selected diagrams belong to one application system

-	the directory chosen during the previous publish operation

-	the system temporary directory.

You can change the suggested directory by overtyping the text in this box, or by using the Browse button.

Browse button

Click to open a browse dialog, though which you can choose an existing directory.

Publish Format text box

Choose a format for the published diagrams from the drop-down list.  You can choose from PNG, GIF, TIFF, JPEG and BMP.


Version - Check In
   Check In (Version Menu)

Related Topics

Checks in all the selected objects. You can specify checkin options and enter notes that you want to associate with the objects.

This option is valid only if the objects selected are either checked out or are not yet under version control. Checking in an object that is not yet under version control adds this object to version control.

Choosing this option displays the Check In dialog box.  About


Check In dialog box

Related Topics

Checks in all the selected objects. You can choose the branch to which you want to check in the objects as well as specifying checkout options and entering notes that you want to associate with the objects.  How

Objects selected for check in

Lists all objects selected for check in. These can include objects not under version control, objects mapped to a repository container but not uploaded to the repository, and checked-out objects.

Note:	All objects listed here, whether they are highlighted or not, will be checked in when you click OK.

(Not applicable when using the Version History Viewer as this tool operates within the context of only one object.)

Options for object_name

Current checkin branch

(Display only)  The name of the current checkin branch for this object. You can change the checkin branch in the Use branch field.

Use branch

For existing objects, enables you to check in this object to a branch other than the one from which you checked out the object. If the object was checked out locked by another user from a branch, you cannot check in your object version to that same branch.

For new objects, lists the branch to which the object will be checked in:

•	If no default checkin branch is set, the object is checked in to the MAIN branch.

•	If a default checkin branch is set, the object is checked in to the default checkin branch in addition to the MAIN branch.

(Not applicable when using the Version History Viewer as this tool operates within the context of only one object.)

Version label

The version label attached to each object when checked in. Depending on the repository policy, this version label can be generated automatically by the system, or defined by the user.  About

Use checkout notes

Determines whether you want to use the same notes for checkin that you specified for checkout.

Check out after checkin

Determines whether you want to check out the objects again immediately after checkin. This enables you to continue working on the object after ensuring that the latest version is available to other users.

If the objects were initially checked out with a lock, they will be checked out again with locks.

Check in even if unchanged

Determines whether the objects are checked in even if they have not changed since they were checked out.

Checkin notes

Any notes you enter here will apply to all the selected objects in the Objects selected for check in list.


Version - Check Out
   Check Out (Version Menu)

Related Topics

Checks out all the selected object versions. You can specify checkout options and enter notes that you want to associate with the objects.

This option is valid only if the selected object versions are checked in.

Choosing this option displays the Check Out dialog box.  About


Check Out dialog box

Related Topics

Checks out all the selected object versions. You can specify checkout options and enter notes that you want to associate with the objects.  How

Objects selected for check out

Lists the objects you have chosen to check out.

(Not applicable when using the Version History Viewer as this tool operates within the context of only one object.)

Options for object_name

Lock

Determines whether the object is locked when it is checked out. Locking the object prevents anyone else from checking in another version onto the same branch until the lock is removed.

If a strict locking policy is in force, you cannot change this option as the strict locking policy ensures that every checkout is automatically set to locked.

Check out latest

Determines whether the latest version of the object is to be checked out, regardless of the version that is selected. This option is dimmed if the latest version is already selected.

(Not applicable when using the Version History Viewer as this tool operates within the context of only one object.)

Version dependencies

Determines whether the dependency links to any objects referenced by this object are to be versioned as well (but not the referenced objects themselves).

Checkout notes

Any notes you enter here will apply to all the selected objects in the Objects selected for check out list.


Version - Check Out Contents
Check Out Contents (Version Menu)

Related Topics

Checks out all the object versions within a specified context (checks out the 'contents' of the context element).

Depending on the type of sub-context you can specify various options, including whether to recurse subcontainers, and whether to check out the context element itself. Examples of context elements are workareas and containers.

Selecting the Recurse subcontainer option checks out all subcontainers and their contents as well as the top level contents of the context element. Selecting the Check out sub-context itself option checks out the selected context element itself, as well as its contents.

For

Workarea

The name of the selected workarea. Use the Browse button to select an alternative workarea.

Sub-context

Enables you to select one of the following sub-context types:

•	Entire Workarea

•	Container

•	Configuration

•	Diagram

•	User-Defined Set

Enter the name of the selected sub-context in the adjacent field, for example, the name of the container for which you want to check out its contents. Use the Browse button to locate and select the sub-context element.

Recurse subcontainers

Determines whether all subcontainers for a selected container, together with their contents, are checked out.

This option is not applicable for workareas; if checking out the contents of a workarea, all objects within that workarea, regardless of which container they are in, are always checked out.

Preview checkout list

Determines whether the Preview Checkout dialog box is displayed before the checkout operation. This dialog box enables you to refine the selection of objects for check out by specifying which of the objects within a group of objects (sub-context) you want to check out.  About

Check out sub-context itself

Determines whether the sub-context element itself is checked out in addition to its contents.

This option is not applicable for workareas.

Check out system folder

Only applicable for workareas, this option determines whether the system folder is also checked out.


Version - Compare Previous Version
   Compare Previous Version (Version Menu)

Related Topics

Compares a version of an object with its immediately previous version, and displays the results of the compare operation in the Compare window.

The version of the object currently in the workarea view is indicated by an arrow in the Version History Viewer display area, if this tool is active for the object.


List Checkouts dialog box

Related Topics

Lists all the repository objects in a selected context that are checked out, are not under version control or are new file system files. Other details are also displayed where applicable, for example, object type, checkout and checkin dates and other version details. The selection of objects displayed is determined by the selection criteria you chose previously in the List Checkouts: Criteria dialog box.  About

From this dialog box you can also:

•	check in all or selected objects

•	undo a checkout

•	add new objects to version control (by checking in the objects)

•	compare an object version with its previous version

For

(Display only) The name of the selected workarea and sub-context (entire workarea, container type, configuration, diagram or user-defined set), and the default checkin branch (if any).

Object details

The following object details are displayed:

Name	The name of the object.
Predecessor Version	For objects already in version control, the details of the version from which the checkout was performed.
Version Label	The version label attached to the object version. Depending on the workarea rules, this version label may have been generated automatically by the system, or defined by the user.
Status	The object status: this can be Checked Out, Not Versioned or New File System File.
Type	The type of the object.
Date Checked Out	The date when the object was last checked out.
Checked Out By	The name of the user who last checked out the object.
New Query

Redisplays the List Checkouts: Criteria dialog box, enabling you to change the criteria determining which objects are displayed in the List Checkouts dialog box.

Check in

Checks in any objects selected in the list.

Undo Checkout

Undoes the checkout of any checked-out objects selected in the list.

Compare

Compares, with its previous version, a checked-out object selected in the list.

Select All

Selects all objects in the list.


Version - List Checkouts
List Checkouts (Version Menu)

Related Topics

Displays the List Checkouts: Criteria dialog box, enabling you to determine which of the objects within a selected context will have their details displayed in the List Checkouts dialog box.  About

For

Workarea

The name of the selected workarea. Use the Browse button to select an alternative workarea.

Sub-context

Enables you to select one of the following sub-context types:

•	Entire Workarea

•	Container

•	Configuration

•	Diagram

•	User-Defined Set

Enter the name of the selected sub-context in the adjacent field, for example, the name of the container for which you want to list checkouts. Use the Browse button to locate and select the sub-context element.

Show

Checked-out objects

Determines whether all checked-out objects for the selected workarea and sub-context are displayed in the List Checkouts dialog box.

Non versioned objects

Determines whether repository objects that have not been added yet to version control are displayed in the List Checkouts dialog box.

Non repository files

Determines whether objects mapped to a repository container but not uploaded to the repository are displayed in the List Checkouts dialog box.

Recurse subcontainers

Determines whether all subcontainers and their contents are displayed in the List Checkouts dialog box, in addition to the top level contents of the context element.

Checked out / Created

By me

Determines whether only those objects that are checked out by you, or created by you (but not added yet to version control), are displayed in the List Checkouts dialog box.

By anybody

Determines whether all those objects that are checked out by anybody, or created by anybody (but not added yet to version control), are displayed in the List Checkouts dialog box.


Preview Checkout dialog box

Related Topics

Displayed if you selected the Preview checkout list option on the Check Out Contents dialog box, this dialog box enables you to refine the selection of objects for check out by specifying which of the objects within a group of objects (sub-context) you want to check out.

For

(Display only) The name of the selected workarea and sub-context (entire workarea, container, configuration, diagram or user-defined set), and the default checkin branch (if any).

Object details

The following object details are displayed:

Name	The object name and path in the repository.
Version	The branch and version number for the object.
Version Label	The version label attached to the object version. Depending on the workarea rules, this version label may have been generated automatically by the system, or defined by the user.
Latest On Branch	Indicates whether the object version is the latest on the branch.
Type	The type of the object.
Check Out

Checks out any objects selected in the list.

Select All

Selects all objects in the list.


Version - Undo Checkout
   Undo Checkout (Version Menu)

Related Topics

Abandons (undoes) the checkout of all selected object versions. This reverts the object to the state it was in prior to being checked out.  About

List

The selected object versions for which you want to undo the checkouts.

(Not applicable when using the Version History Viewer as this tool operates within the context of only one object.)

Save filesystem changes (saved to <filename>.KEEP)

Displayed only if the selected object is a mapped file, this option saves any changes made since the object was checked out. By default, when you undo a checkout, any changes made since the object was checked out are lost. However, if a selected object is a mapped file, this option allows you to preserve the changes in a separate file. The file is called <filename>.KEEP, where <filename> is the name of the original file.


Version - View Version Events
View Version Events (Version Menu)

Related Topics

Displays the Version Event Viewer in which you can view event details of an object and its versions.  How

For each event you can view information including:

•	the type of event (checkin, checkout, locked, branched or merged)

•	the version label

•	the name of the object

•	the branch on which the version resides

•	the date the event occurred

•	the user who initiated the event

•	notes about the event


Version Event Viewer window

Related Topics

The Version Event Viewer displays details of all events that have occurred for an object.

You can re-sequence the information displayed and choose to display only selected information.  How

Note:	Any refinements of the details displayed are not reflected in the Event Viewer window until you click the Rescan button.

Event History for

The name of the object for which the events are displayed.

Start date field

The start date for any events displayed in the window. To activate this field, enable the Start date checkbox.

End date field

The end date for any events displayed in the window. To activate this field, enable the End date checkbox.

Start date checkbox

Activates the start date field, enabling you to specify a start date for any events displayed in the window.

End date checkbox

Activates the end date field, enabling you to specify an end date for any events displayed in the window.

Exclude Checkouts

Excludes any checkout event details. Checkout details are overwritten each time the object is checked in, so checkout details are only shown if the object currently has a checked-out version.

Report Key panel

Enables you to rearrange the report display and to include or exclude selected information from the display.

Display list

Displays a list of the details currently displayed in the report, including the order in which they are displayed and whether they appear in the left or right columns.

To add any additional details to the report, select the chosen detail from the drop-down list and click Add.

To remove or reorder any details, select the detail from this display list and click the appropriate button.

Drop-down list

A list of all possible event details that can be displayed in the report.

To add any additional details to the report, select the chosen detail from the drop-down list and click Add.

Add

Adds the detail selected from the drop-down list to the report.

Remove

Removes the detail selected in the display list from the report.

Higher

Moves the detail selected in the display list one position higher up in the order of details in the same column.

Lower

Moves the detail selected in the display list one position lower down in the order of details in the same column.

move Left

Moves the detail selected in the display list to the end of the left column.

move Right

Moves the detail selected in the display list to the end of the right column.

Rescan

Refreshes the display with the specified details.

Tabular list of events

Displays the specified details for each event in a tabular form.


Version - View Version History
  View Version History (Version Menu)

Related Topics

Displays the Version History Viewer in which you can view the version history of an object displayed in a graphical representation.  How

As well as viewing the full version history of an object, you can also:

•	check in object versions from, and check out object versions to, the context workarea

•	compare object versions

•	merge object versions

•	change the visible version of an object in the workarea


Version History Viewer window

Related Topics

The Version History Viewer displays the version history of an object in a graphical representation.  About

The Version History Viewer window contains the following:

Display Area	Displays a diagram made up of a number of nodes that correspond to each object version.
Status Panel	Shows information about the selected node.
Toolbar	Used to customize the display and provides shortcuts to the functionality available from the menus.


Generic Select dialog box

Displayed from the Browse button or automatically displayed when additional information is required for the current activity.

The title of the dialog box will depend on the context in which it is displayed.

Some features of the dialog box are displayed only if they are required in the particular context. For example the Select All button is displayed only if more than one object can be selected in one operation.

Look In

Displays the label for the area you are currently viewing and, where appropriate, enables you to move to another location in the hierarchy.

  Up One Level

Selects the level above the current level in the repository hierarchy.

  List View

Displays only the names of the repository objects in a multi-column list.

  General Details View

Displays the following general details about the objects in the list:

Name

The name of the object.

Type

The type of the object.

Attributes

The attributes (properties) of the object:

CI	checked-in
CO	checked-out
R	read-only
Modified

The date when the object was last modified.

Modified By

The username of the repository user who last modified the object.

  Version Details View

Displays the following version details about the objects in the list:

Name

The name of the object.

Type

The type of the object.

Attributes

The attributes (properties) of the object:

CI	checked-in
CO	checked-out
R	read-only
Version

The checkin branch and version number of the object, for example, MAIN:1.

Version Label

The version label of the object, for example, 1.3.

  Hierarchical View

Displays all the repository objects below the selected level. Objects are displayed with their path in the repository indicated.

  Flat View

Displays only the repository objects at the selected level in the repository hierarchy. In this view, double-clicking the name of a workarea or container displays the objects at that level.

Find elements that match these criteria

Available on some variants of this dialog box, these options enable you to move to a selected object. You can filter the list of objects displayed by name, type and version.

Name

The name of the selected object.

Type

The object type.

Version

The version of the selected object.


Set Context Workarea dialog box

Displayed when a checkout operation is performed from the Version History Viewer but the repository cannot determine the context workarea, this dialog box enables you to select a context workarea to which the object will be checked out.

All the workareas to which you have access are listed.

Select workarea

Enables you to select a workarea to make that workarea the context workarea.


Which configurations include this version dialog box

Related Topics

Available from the Version History Viewer,  [image]  displays the Which configurations include this version dialog box, listing all the configurations that include the selected object version.

Configurations

A list of all the configurations that include the selected object version.

Show version labels

Determines whether you want to display the version label for each configuration in the list.

When this option is not selected, the branch label is displayed for each configuration in the list.


Which workareas include this version dialog box

Related Topics

Available from the Version History Viewer,  [image] displays the Which workareas include this version dialog box, listing all the workareas that include the selected object version.

Workareas

A list of all workareas that include the selected object version.


Version History Viewer toolbar

Related Topics

The following toolbar buttons are available from the Version History Viewer:

Button	Description
	Updates the display area with any new information.
	Opens a dialog box displaying the version properties of the selected object version.
	Opens a dialog box displaying a summary list of configurations containing the selected version.
	Opens a dialog box displaying a summary list of workareas containing the selected version.
	Checks out the selected object version.
	Checks in the selected checkout.
	Undoes a checkout.
	Hides or shows the insignificant versions of the object. Insignificant versions include those that are not root or tip versions, are not branch parent versions, are not target or source versions in a merge operation, are not common ancestor versions, or are not the source of a checkout.
	Shows or hides the status panel at the bottom of the screen to allow more space for the version tree.
	Displays all notes associated with the version history diagram including branch labels and checkin notes.
	Displays all notes associated with major nodes in the version history diagram including branch labels and checkin notes.
	Hides all checkin notes and branch labels.
	Allows you to select the types of node to highlight in the version diagram and change the node colors to suit your personal preferences.
	Changes the size of the nodes and consequently the size of the entire diagram.


Version Properties dialog box

Related Topics

 opens the Version Properties dialog box for the selected version in the Version History Viewer.

Version name

The object name, branch name and position of the version on the branch.

Date created

The date and time the object version was created.

Created by

The username of the person who created the object version.

Status

The current status of the object version: checked in or checked out.

Notes

Notes that were added when the object version was checked in.


Checkout Properties dialog box

Related Topics

Displays the properties of the checkout selected in the Version History Viewer.

Original name

The object name, branch name and position on the branch of the original object version from which the selected version was checked out.

Date

The date and time when the object version was checked out.

Created by

The name of the user who created the object version

Notes

Any notes that were added when the version was checked out.


Version History Viewer display area

Related Topics

The Version History Viewer display area shows the version tree, a graphical representation of an object.  About

The version tree is made up of a number of nodes, each representing a single object version. Nodes are connected to other nodes by lines (or edges). The version tree includes all versions of the object and any branches and merges that may have taken place during development.

Notes entered at checkin or checkout are displayed beneath the node. They can be toggled on and off from the toolbar.

Depending on the version labeling policy, the name or the label assigned to each version is displayed inside the node. About

Version tree node colors

The following diagram illustrates the default node colors in the Version History Viewer. These colors can be customized to suit your personal preferences.  How

	Blue nodes represent the checked-out versions of this object. Red nodes are the leaf (or tip) nodes and are at the tip of each branch. They represent the latest version for that branch. Yellow nodes are major nodes. A major node is a node that corresponds with either the root of the branch, the parent node of a branch, or is a merge result node. The selected node is indicated by the blue cornered highlight selector. The node that is selected by this user’s workarea is marked with an arrow. The red triangle on the top left hand corner of node 1.3 indicates a marked node. Nodes are marked when they are being used in a compare or merge operation.  How


Version History Viewer Status panel

Related Topics

The Version History Viewer status panel at the bottom of the Version History Viewer window displays information associated with the selected node.

The status panel can be hidden from the display using the [image] button, so that more space is available for the display area.

Branch

The name of the branch to which the selected node belongs.  About

Version Label

The version label, which can be automatically generated or defined by the user.  How

Notes

These are optionally added to an object version when a checkout or checkin operation is performed. The note is a text string of a maximum 2000 characters. Full details of the note are available from the Version Properties dialog box.  How

Date Created

The date the object version was checked in to the repository.

Status

The three recognized states of a node are Checked in, Checked out, and Locked.


Compare window

Related Topics

The Compare window displays the results of a compare operation.

A compare operation involves a base object version and a contributor object version. The base object version is the version with which the contributor object version is compared.

The compare window consists of two panes separated by a resizing splitter. The left pane displays the contents of the base object version; the right pane displays the contents of the contributor object version.

Expanding or collapsing branches on the right pane will cause the corresponding branch on the left to expand or collapse.

You can scroll the screen vertically and horizontally using the scroll bars. Scrolling is synchronized so that corresponding items can be examined side by side.

Identifying differences between object versions

The compare display provides three ways in which differences between object versions can be identified:

•	Different text colors to represent additions, deletions and modifications.

•	Vertical bars to the left of each section of the object version to highlight what is being compared. The color of the block marker corresponds with the text color.

•	Icons to indicate the nature of the difference that exists between object versions:

Icon	Difference
	Added - An item has been added to the contributor version but not to the base version with which it is being compared.
	Deleted - An item has been deleted from the contributor version but not from the base version with which it is being compared.
	Update - An item is included in both the contributor and the base versions but the item is different in each version.


Merge window

Related Topics

The Merge window displays the results of a merge operation. A merge operation takes two contributor object versions (target and source), compares them to a common ancestor version, and uses internal rules to create a result based on changes found in all three versions.  About

The Merge window displays the differences and conflicts encountered by the merge algorithm. It also shows selections made by the algorithm, and lets you override those selections before the result is produced.

The Merge window appears in the following circumstances:

•	You attempt to do an automatic merge, and the merge algorithm encounters conflicts.

•	You explicitly ask for the Merge window to be displayed.

Difference blocks

The Merge window displays any differences in a series of difference blocks. A difference block shows the form that an item of data has in the contributor versions (source and target) and the common ancestor version, and indicates whether the item has been added, removed, or modified in one or both of the contributors with respect to the common ancestor. The difference might be:

•	A simple difference: a difference that the algorithm has been able to resolve using its own rules. In this case, the version containing the form of the item that the merge has selected to go forward to the result has its box selected. You can override the selection made by the algorithm by choosing an alternative form.

•	A conflict: a difference that the algorithm has been unable to resolve using its own rules. In this case, no contributor has its box selected. You must resolve the conflict by choosing the form of the item that you want to go forward to the result. If the conflict is for a file or for multi-line text, you can select more than one form of the comparison to go forward to the result; if the conflict is for structured repository object types, you can select only one.

Use the following menus to perform merge tasks:
File
View
Navigate
Merge
Help

The arrow toolbar buttons enable you to navigate through the lists of differences and conflicts.


Object Visibility dialog box

Related Topics

Displayed when you create an object in a checked-out container and check in the object for the first time, this dialog box warns you that the object being checked in may not be visible to other users until you check in the owning container.

To ensure that other users will be able to see the new object in their workareas (provided that the workarea specifications allow this), click OK and then check in the container.

Do not show this message again

Enables you to prevent the dialog box from being displayed every time you create and check in an object for the first time. Note that selecting this option hides the dialog box not only in the current working session, but also in all future working sessions.


Select Paths for Inherited Classes dialog box

Related Topics

Displayed when comparing or merging Oracle Forms (files with the .fmb, .olb or .mmb extension) that use subclassing or referenced objects, this dialog box enables you to define:

•	the scope: the workarea or configuration in which the Form versions participate

•	the path: the Forms path for the Form you want to compare or merge

Note that when comparing or merging Oracle Forms that use subclassing or referenced objects, you must ensure that:

•	each of the Form versions you are comparing or merging is in a different workarea or configuration

•	the Forms path exists in every workarea or configuration used for the comparing or merging operation

•	the files on the paths are uploaded into the repository  How

The options displayed in the dialog box differ according to whether you are comparing or merging Oracle Forms.

• Comparing Oracle Forms	The options enable you to enter the scope and path for the contributor and base object versions.
• Merging Oracle Forms	The options enable you enter the scope and path for the target, source and ancestor object versions.
Options displayed when comparing Oracle Forms

For

The name of the Form for which you are defining additional information.

Contributor Form

Information about the contributor Form version for this compare operation.

Workarea

Indicates whether or not the scope of the compare operation is for a workarea in which the contributor Form version participates.

Configuration

Indicates whether or not the scope of the compare operation is for a configuration in which the contributor Form version participates.

Name

The name of the workarea or configuration in which the contributor Form version participates. Select the name of the workarea or configuration from the list of those in which the contributor Form version participates.

Path

The Forms path for the contributor Form version. The path defaults to one previously used by the Form, but can be changed by the user. Paths should be defined relative to the root. Specify the path without any version information, and use a semicolon for separating multiple paths.

Base Form

Information about the base Form version for this compare operation.

Workarea

Indicates whether or not the scope of the compare operation is for the workarea in which the base Form version participates.

Configuration

Indicates whether or not the scope of the compare operation is for the configuration in which the base Form version participates.

Name

The name of the workarea or configuration in which the base Form version participates. Select the name of the workarea or configuration from the list of those in which the base Form version participates.

Path

The Forms path for the base Form version. The path defaults to one previously used by the Form, but can be changed by the user. Paths should be defined relative to the root. Specify the path without any version information, and use a semicolon for separating multiple paths.

Options displayed when merging Oracle Forms

For

The name of the Form for which you are defining additional information.

Target Form

Information about the target Form version for this merge operation.

Workarea

Indicates whether or not the scope of the merge operation is for the workarea in which the target Form version participates.

Configuration

Indicates whether or not the scope of the merge operation is for the configuration in which the target Form version participates.

Name

The name of the workarea or configuration in which the target Form version participates. Select the name of the workarea or configuration from the list of those in which the target Form version participates.

Path

The Forms path for the target Form version. The path defaults to one previously used by the Form, but can be changed by the user. Paths should be defined relative to the root. Specify the path without any version information, and use a semicolon for separating multiple paths.

Source Form

Information about the source Form version for this merge operation.

Workarea

Indicates whether or not the scope of the merge operation is for a workarea in which the source Form version participates.

Configuration

Indicates whether or not the scope of the merge operation is for a configuration in which the source Form version participates.

Name

The name of the workarea or configuration in which the source Form version participates. Select the name of the workarea or configuration from the list of those in which the source Form version participates.

Path

The Forms path for the source Form version. The path defaults to one previously used by the Form, but can be changed by the user. Paths should be defined relative to the root. Specify the path without any version information, and use a semicolon for separating multiple paths.

Common Ancestor Form

Information about the common ancestor Form version for this merge operation.

Workarea

Indicates whether or not the scope of the merge operation is for the workarea in which the ancestor Form version participates.

Configuration

Indicates whether or not the scope of the merge operation is for the configuration in which the ancestor Form version participates.

Name

The name of the workarea or configuration in which the ancestor Form version participates. Select the name of the workarea or configuration from the list of those in which the ancestor Form version participates.

Path

The Forms path for the ancestor Form version. The path defaults to one previously used by the Form, but can be changed by the user. Paths should be defined relative to the root. Specify the path without any version information, and use a semicolon for separating multiple paths.


Merge Confirmation dialog box

Related Topics

Lists the source and target for the merge operation, and enables you to choose whether you want to preview the merge results in the Merge window, or perform an automatic merge if there are no conflicts.

If merging binary files other than Oracle Forms, the merge operation does not compare the source and target versions but instead copies the contents of the source over the contents of the target. When merging binary files, this dialog box does not therefore display the Use Merge window and Perform automatic merge options but instead displays a message informing you that the merge will copy the source file over the target file.

Source

The source object version for the merge operation: the version which is merged with the target.

Target

The target object version for the merge operation: the version into which changes made in the source are to be merged.

Use Merge window

Displays the Merge window listing the differences and conflicts encountered by the merge algorithm and the selections made by the algorithm, and letting you override those selections before the result is produced.

Perform automatic merge

Performs an automatic merge if there are no conflicts. The Merge window is displayed only if there are conflicts between object versions, so enabling you to resolve the differences; otherwise the Merge window is not displayed.


File Menu

Save

Merges the selected data into an updated form of the target and saves the result.

Exit

Exits from the tool.


View Menu

Toolbar

Shows or hides the standard toolbar below the menu bar.


Navigate Menu

Previous Difference

Navigates to the previous difference in the window.

Next Difference

Navigates to the next difference in the window.

Previous Conflict

Navigates to the previous conflict in the window.

Next Conflict

Navigates to the next conflict in the window.


Merge Menu

Select Source

Selects the source from the difference block currently in focus.

This menu option will be only be available when a difference block is currently in focus in the Merge Window.

Select Target

Selects the target from the difference block currently in focus.

This menu option will be only be available when a difference block is currently in focus in the Merge Window.

Select Common Ancestor

Selects the common ancestor from the difference block currently in focus.

This menu option will be only be available when a difference block is currently in focus in the Merge Window.


Help Menu

Help Topics

Displays a list of the main subject areas in the online documentation system.

About

Displays copyright and version number information about this application. You might need to know the version number for product support purposes.


File - Open
   Open (File Menu)

Opens an existing diagram.

If the diagram you select is already open this option brings that diagram to the front. If the selected diagram is minimized it will be restored to its previous state.

If the diagram you are opening contains elements that do not match those held in the repository and you have set the Requery on Open option in the Customize dialog box, the mismatched elements are requeried automatically before you open the diagram. If you have not set the Requery on Open option, the diagram is opened exactly as it was when last closed, but cannot be edited.

Dialog box options

Diagrams for workarea

Lists the existing diagrams, grouped by container, that are visible to your workarea. Choose the diagram you want to open by expanding the appropriate container node and selecting the diagram name.


Edit - Delete From Repository
Delete from Repository (Edit Menu)

Deletes one or more selected elements from the diagram and places in them in the repository Wastebasket.

You must have delete privileges to a workarea and container before you can remove elements or their associations from it. If an element is "shared", i.e. directly owned by another application system, it can be deleted from the owning application system only.

•	Deleting an element from the current diagram window deletes the element node from the current window and from any copies of the same diagram that are also open.

•	Deleting from a diagram an element that is also included on other closed diagrams removes the element node from the current diagram only. Any diagrams containing the deleted element become temporarily out of date until you requery the repository.

Dialog box options

List box

Displays the names of all the diagram elements that are selected on the active diagram. By default, all elements are selected for deletion. Each diagram element is qualified by a container name.

Select All

Selects for deletion all the elements shown in the list box.


Edit - Select <Element Type>
Select→Element Type (Edit Menu)

Related Topics

Selects named elements of the specified element type on the active diagram.

Dialog box options

List box

Displays the names of elements of the type you want to select on the diagram.

Select All

Selects all the elements shown in the list box.


Edit - Navigate to - Element Type
Navigate to→Element Type (Edit Menu)

Related Topics

Searches for a specified element on the active diagram and redisplays the diagram to show that element and its surrounding items.

Dialog box options

List box

Displays the elements to which you can navigate on the active diagram.


Edit - Requery - Element type
Requery→<Element Type> (Edit Menu)

Requeries your choice of any out-of-date elements on the diagram of the specified type.

After requerying, any changes that have been made to the properties of the elements you requery are reflected on the diagram. Any elements you requery that have been deleted from the repository are removed from the diagram.

Dialog box options

List box

Displays the names of all the out-of-date entities on the diagram with an explanation of why each is out of date.

Select All

Selects all the entities shown in the list box.


Edit - Properties
Properties (Edit Menu)

Maintains the properties of an element on the active diagram.

Tip:	You can also open an element dialog box by double-clicking on the element on the diagram.


Version - Check In / Check Out <container>
 Check In / Check Out <container> (Version Menu)

Checks in or checks out a container, depending on whether it is currently checked-in or checked-out. The text for this option is one of the following:

Menu text	Meaning
No Current Container	There are no diagrams open and no container is in use.
Check In <container>	The current container is checked out and can be checked in using this option.
Check Out <container>	The current container is checked in and can be checked out using this option.


Utilities - Database Design Transformer
Database Design Transformer (Utilities Menu)

Creates and maintains database designs based upon entity models recorded in the repository. It creates tables to record instances of each entity, columns to store attributes, and constraints to implement the relationships between entities.

Like the entity model, the database design that is generated is stored in the repository. This model can subsequently be used by other Oracle Designer utilities to generate the SQL statements required to create the database itself.


Container List (Main toolbar)

The Container List identifies the container in which new diagram elements will be created in the repository.

In the Process Modeler, Function Hierarchy Diagrammer and the Dataflow Diagrammer, diagram elements are always created in the same container as the diagram, therefore this field is display only and simply identifies the container in which the active diagram exists.

In the Entity Relationship Diagrammer, where diagrams can contain elements from multiple containers, you use this field to specify the container in which diagram elements will be created. If the container that you want to use is not shown in the dropdown list, click the list button to the right of the dropdown list to see other containers that are visible to your workarea.

Note: The Container List does not display a container name if a diagram is not open.


Utilities - Function/AttributeMatrix
Function/Attribute Matrix (Utilities Menu)

Related Topics

Helps you to define a function/attribute matrix, by presenting functions visible to the workarea and allowing you to specify the functions for which you want to define a function/attribute matrix.

This utility creates a function/attribute matrix by generating a default function attribute usage for each attribute that qualifies an entity used by the function. A new function attribute usage is not created for any existing function attribute usages.

Dialog box options

List box

Lists the functions visible to the workarea. Note, although all functions are listed in the dialog box, attribute usages can only be created for functions that have entity usages.

Select All button

Selects all the functions shown in the list box.


Options - Customize
Customize (Options Menu)

Changes the diagrammer display options.

This option displays the Customize dialog box which allows you to change:

•	colors

•	line widths

•	fonts

•	grid settings

•	size of elements

and to determine:

•	which properties and items are displayed

•	whether a diagram is requeried on opening


Layout - Rescale Diagram
Rescale Diagram (Layout Menu)

Related Topics

Rescales all the elements on the diagram so that the diagram is displayed to fit into a specified number of pages. When a diagram is rescaled using this utility, nodes, dog-legs, arcs, recursive relationships (pig's ears) and fonts are resized to be in proportion to the rescaled diagram.

Dialog box options

New Number of Pages

Horizontal

Defines the number of pages in the horizontal axis to which the diagram will be rescaled.

Vertical

Defines the number of pages in the vertical axis to which the diagram will be rescaled.

Current Number of Pages

Horizontal

Display only
Indicates the number of pages in the horizontal axis on which the diagram is currently displayed.

Vertical

Display only
Indicates the number of pages in the vertical axis on which the diagram is currently displayed.

Scale Fonts checkbox

Defines whether or not the fonts on the rescaled diagram are resized to be in proportion to the size of the diagram.

Maintain Aspect Ratio checkbox

Defines whether or not the number of pages defined in the Horizontal and Vertical fields (in the New Number of Pages group) retain their aspect ratio. If this box is checked, the Horizontal and Vertical fields in the New Number of Pages group will change dynamically whenever a change is made to either of them.


Application Design Transformer (Utilities Menu)

Related Topics

Creates a first-cut application design by generating candidate modules and candidate menu modules networks, from analysis data stored in the repository, i.e. from business function models created using the Function Hierarchy, or Dataflow Diagrammer from the Systems Modeler toolset.

You can specify whether you want to generate modules or menu modules and set runtime parameters for each module type.


Application Design Transformer dialog box

Related Topics

Generates a first-cut application design by generating candidate modules and candidate menu modules networks, from analysis data stored in the repository, i.e. from business function models created using the Function Hierarchy, or Dataflow Diagrammer from the Systems Modeler toolset.

Use this dialog to specify whether you want to generate modules or menu modules, and set runtime parameters for each module type.

Generate Options

Modules

To create candidate application modules from the function hierarchy defined in the ‘Start Function’ field, click Modules.

Menus

To create a candidate menu module network from the function hierarchy defined in the ‘Start Function’ field, click Menus.

Common Parameters

Use these fields to specify the run-set (i.e. the function hierarchy to be processed) and the names of generated modules.

Start Function

The name of the function to be used as the root of the function hierarchy. Only those functions in the hierarchy below the root function will be converted into modules.  To process all business functions in the current application system, leave this field blank. If you have created references to business functions in other application systems within the current workarea, these functions can also be processed.

The function description is displayed in the field below the function name.

Module Prefix

To specify a prefix for the Short Name of all generated modules, enter the Module Prefix, e.g. ADT

If you do not enter a prefix, it defaults to the first six characters of the application system name for modules, and to the full application system name for menu modules.

Start Number

To specify a number to be appended to the Module Prefix of the first module generated from this run-set, enter the Start Number. The number appended to each subsequent module is incremented by 10.

For example, if the Module Prefix is ADT and the Start Number is 10, the first three generated modules will have the Short Names, ADT10, ADT20 and ADT30 respectively.

Find Highest

To set the Start Number to be 10 above the highest number allocated to modules with the current module prefix, click Find Highest.

Description

A description to be appended to each module created by the Application Design Transformer.

Module Options

These options are available if ‘Modules’ is selected as the Generate Option. About

Language

To specify the languages of modules created by the Application Design Transformer, choose the appropriate module language for each language type, i.e.  Screen, Report and Utility.

Merge Granularity

Functions considered for transformation are merged into a single module if they have similar data usages. To set the level of data match required for merging modules, choose the criteria matching your requirements:

Identical Entities	-	Merge if the functions access the same set of entities.
Identical Entities and Usages	-	Merge if the functions access the same set of entities and have the same CRUD usages.
Identical Attributes	-	Merge if the functions access the same set of attributes.
Menu Options

These options are available if ‘Menus’ is selected as the Generate Option. About

Menu Language

To specify the language of menu modules created by the Application Design Transformer, choose the appropriate language from the list.

Max Options on Menu

Mandatory, 2 digits
To limit the number of menu options that can appear on a menu, enter the maximum number of menu options required.  If the grouping of generated menu modules exceeds this number, the menu will be split. The default for this option is 10.

Include Manual Options

To specify that manual modules (modules that have no data usages) are to be included in the menu structure, check Include Manual Options.

Manual modules may be used to display text as online documentation for processes which are not computerized.

Generate button

Generates candidate modules or menu module networks from the function hierarchy defined in the ‘Start Function’ field.

Show Results button

Displays the messages issued by the Application Design Transformer during generation (smadw.txt).