Progress
Open Client
Developer’s Guide
Defining an AppObject Or SubAppObject
You must define one AppObject for a proxy. You can also define one or more SubAppObjects depending on how you choose to organize the available AppServer functionality. As you specify AppObject and SubAppObject names and select 4GL procedures to define the proxy, ProxyGen applies a set of rules to convert and validate the various object and method names that you specify. For more information on these naming rules, see the "Object Naming In ProxyGen" section.
The following sections provide information about:
Creating AppObject and SubAppObject Entries
To create a new AppObject definition, choose File
New from the ProxyGen menu bar or the New button from the ProxyGen toolbar. ProxyGen closes any open project, and creates a project for the new proxy, adding an unnamed AppObject entry at the root of the navigation tree control. ProxyGen also displays the tab folders for this AppObject with the entry selected in the tree control.
To create a SubAppObject, choose SubAppObject
New from the menu bar. ProxyGen adds an unnamed SubAppObject entry to the navigation tree control and selects it, displaying the tab folders to define the SubAppObject.
The tab folders for defining both the AppObject and any SubAppObjects are identical. However, the definitions that you enter apply only to the entry currently selected in the tree control. Also, as you select an entry in the tree control, the field values in the AppObject and Procedures tab folders change to the current settings for the selected AppObject or SubAppObject.
Specifying AppObject and SubAppObject Definitions
As part of defining an AppObject or SubAppObject, you must specify the following information in the AppObject tab folder:
- The proxy object name (Name field)
- The PROPATH (Propath Components list box), set to the locations of AppServer procedures for this proxy object. (See the "Specifying 4GL Procedures and User-defined Functions" section.)
You can optionally specify:
- Proxy object descriptive information (Description edit box)
- If generating an ActiveX proxy, the name of the Automation object (COM Object field, used for example in Visual Basic’s Project References dialog box)
NOTE: If you are using the proxy to access a remote Progress SmartDataObject, you must allow 4GL unknown values for the entire proxy object. Check this box and make sure that the boxes in all ProcObject and method definitions remain checked.- Whether to allow access to the 4GL unknown value (?) in parameters and return values (Allow Unknown field). The check box here applies to the entire proxy object. Other dialog boxes can be used to allow access to the 4GL unknown value for individual procedures and parameters.
You must also specify any AppServer procedure files you want to include, and whether they are non-persistent or persistent procedures (ProcObjects), using the Procedure menu on the menu bar. These procedures are listed on the Procedures tab folder. For more information on specifying the PROPATH setting and AppServer procedure files, see the "Specifying 4GL Procedures and User-defined Functions" section.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |