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.