The Function Modules 

The function module GRAPH_STRUCTURAL calls the SAP Structural Graphics program.

The only mandatory parameter is the object table which also contains the links between objects. In addition, a few standard dialog parameters that enable simultaneous control of several graphics and determine the initial layout of the structural graphic are available.

Instead of displaying the graphic on the screen, you can also send it to another user as an SAPoffice object. In the process, a document of the type 'GRA' is generated. As a result, when you select this document in the inbox, the graphic is opened together with the data sent.

The function module is exited when a message is received from the structural graphic (e.g. editing function) or from another graphic that has also been started. Parameters returned contain the handle of the graphic that issued the message and the message type.

The function module GET_STRU_PARAM lets you further evaluate the message received for the structural graphic. This is also available for other graphic types with the function modules GET_xxxx_PARAM.

An exception is triggered when the object table is empty when starting or reloading or if accessing the database structure GSUOBJ has failed. The latter only applies when the toolbox is being used.

The GRAPH_STRUCTURAL Function Module

The function module GRAPH_STRUCTURAL serves as the graphics driver for the SAP Structural Graphics.

The following table contains a list of all possible parameters you can use with this function module.

For a detailed description of parameters and exceptions, see the R/3 system documentation (Tools ® ABAP Workbench, Function library button, or transaction code SE37).

Parameters for GRAPH_STRUCTURAL

Name

Status

Default value

ADDSHAPES

Import

SPACE

EDITABLE

Import

X

EXTACTBAR

Import

SPACE

FOCUS

Import

X

NEWFORMAT

Import

X

PATTERN

Import

SPACE

PWDID **

Import

SPACE

REFRESH **

Import

SPACE

SO_SEND

Import

SPACE

TBOXOPEN

Import

SPACE

TBOXPOSX

Import

SPACE

TBOXPOSY

Import

SPACE

TBOXSIZEX

Import

SPACE

TBOXSIZEY

Import

SPACE

WINPOSX

Import

SPACE

WINPOSXY

Import

SPACE

WINSIZEX

Import

SPACE

WINSIZEY

Import

SPACE

M_TYP **

Export

 

RWNID **

Export

 

OBJECTS

Internal table

 

 

Note: ** denotes a dialog parameter

For GRAPH_STRUCTURAL, only the OBJECTS parameter is required.

 

Additional Function Modules

In addition to GRAPH_STRUCTURAL, there are function modules that control SAP Structural Graphics:

GRAPH_STRU_SET_DISPLAY

This function lets you display any text in a small information window. The function module is useful when, for example, information has to be displayed for objects being selected in a graphic.

GRAPH_STRU_SET_MESSAGE

This function module enables you to send a message to a graphic and to display it in the status line there.

GRAPH_STRU_SET_OPTIONS

Structural Graphics has many options for settings that cannot all be managed by the GRAPH_STRUCTURAL function module. These settings can be defined using this function module before starting the graphic.

GRAPH_STRU_SET_PROFILES

Two design profiles are available in Structural Graphics to set the color and shape of objects and linking lines. One profile is type oriented (depends on the object type or type of linking), the other is status oriented (depends on the status of the objects and links). Before Structural Graphics starts, it is informed of the profiles by this function module.

GRAPH_STRU_SET_TOOLBOX

An important feature of structural graphics enables you to edit the object or the structure. The desired editing functions are provided by a toolbox in an amodal window or an extended menu bar.

Before you start the graphic, you can use this function to define the toolbox.