This section describes the Object-Browse code generator. The following topics are covered:
The Object-Browse code generator creates the browse subprogram for an object, as well as three parameter data areas:
Data Area | Description |
---|---|
Object PDA | Defines the returned row data. |
Object key PDA | Defines the search key values. |
Restricted PDA | Contains private data used internally by the browse object to maintain context. |
To generate an object-browse subprogram and data areas
Open the context menu in the Navigator view for the NaturalONE project into which you want to generate the modules.
Or:
Open the context menu in the Navigator
view for the library into which you want to generate the modules.
Select
.The Define Object Browse Details panel is displayed. For example:
Type the location of the Natural library in which to generate the subprogram and associated modules in Library.
The library must currently exist.
Or:
Select to display a window
listing the existing libraries for selection.
Note:
The libraries listed for selection are based on the
current project.
Type the name of the object-browse subprogram in Name.
Select the DDM for the object-browse subprogram in DDM.
Tip:
The DDMs are typically located in the SYSTEM
library.
Using this panel, you can:
Task | Procedure |
---|---|
Select another NaturalONE project in which to generate the object-browse modules. | Type the name of the project in Project or select to display a window listing the existing projects for selection. The project must currently exist. |
Select a folder in which to generate the object-browse modules. | Type the name of the folder in
Folder or select to display
a window listing the existing folders for selection. The folder must currently
exist within the selected NaturalONE project.
Note: |
Change or provide a description of the object-browse subprogram. | Type a brief description in Description. |
Select
.The Change Defaults panel is displayed. For example:
This panel displays the default specification values for the subprogram to be generated. Using this panel, you can:
Task | Procedure |
---|---|
Provide a description of the subprogram to be generated. | Type the description in Object description. |
Change the name of the object PDA. | Type the name in Object PDA. |
Change the name of the object key PDA. | Type the name in Object key PDA. |
Change the name of the restricted PDA. | Type the name in Restricted PDA. |
Define the primary key field used for browse operations. | Select the field in
Primary key.
Note: |
Select
.When generation is complete, the available user exits are displayed in the Outline view (see User Exits for the Object-Browse Subprogram) and the generated modules are displayed in the Navigator view. For example:
These modules are:
Module | Description |
---|---|
MYOBDA1.NSA | Object PDA |
MYOBJB.NSN | Object-browse subprogram |
MYOBKA1.NSA | Object key PDA |
MYOBPA1.NSA | Restricted PDA |
The subprogram is displayed in the editor view. For example:
Save the subprogram and associated modules.
At this point, you can:
Define user exits for the subprogram. For information, see Defining User Exits.
Use the NaturalONE Testing option to test the subprogram. For information, see Test a Subprogram Directly in Application Testing.
Use NaturalONE functionality to upload the generated subprogram to the server.
The Outline view for the object-browse subprogram displays the available user exits. For example:
You can use these exits to define additional processing.
Notes: