Progress
ADM 2 Guide


SmartLink Summary

The SmartLink type determines the kind of relationship that is established between two objects. Table 3–1 describes the relationships that these SmartLinks establish and gives examples (in parentheses) of SmartObjects that support each SmartLink type.

Table 3–1: ADM-recognized SmartLink Types
SmartLink Type
Relationship
Container
Links a containing object (SmartContainer) to an object that it contains. One SmartObject contains another if it creates the contained SmartObject, regardless of whether the containing object visually parents the contained object.
The ADM automatically establishes all Container SmartLinks at run time. This is why Container SmartLinks do not appear in the AppBuilder.
Navigation
Links an object that provides a navigation interface (SmartPanel or SmartToolbar) to an object that supplies a query through which to navigate (SmartDataObject).
TableIO
Links an object that provides a record-modification interface (SmartPanel or SmartToolbar) to an object through which to enter changes (SmartDataViewer or SmartDataBrowser).
Page
Links an object that provides a page-selection interface (SmartFolder) to an object that manages the hiding and viewing of pages (SmartContainer).
PageN
Links an object that manages the hiding and viewing of a numbered set of pages (SmartContainer) to the SmartObjects on a specific page (holds the object handle and the page that it is on).

NOTE: Application developers do not normally use this link type.

GroupAssign
Links an object that manages a record (SmartDataViewer, considered the master SmartDataViewer) to an object that manages a related record or another view of the same record (SmartDataViewer), to assure that all fields are updated in a single transaction.

NOTE: This is an advanced task. For details, see the "Using GroupAssign SmartLinks" section in Advanced ADM Topics."

Data
Links an object that manages records (SmartDataObject) to a visualization object (SmartDataViewer or SmartDataBrowser) or to another object that manages records (SmartDataObject).
Update
Links a visualization object (SmartDataBrowser or SmartDataViewer) to a SmartDataObject for the purpose of passing updated data values from the visualization object to the SmartDataObject.
Note that this is a separate link from the Data link. This is because the data source might not be a SmartDataObject, but all updates must be done through a SmartDataObject. Normally, the Update link associates the same two SmartObjects as a Data link, but in the opposite direction; however, this is not the case if the visualization object gets records from itself or from another source.
Commit
Links a Commit SmartPanel to a SmartDataObject for committing changes to sets of database records when it is necessary to perform more than one update in a single transaction.
Filter
Links a SmartFilter to a SmartDataObject.

You are not restricted to using these ADM-recognized SmartLink types. You can also define new SmartLink types and configure SmartObjects to support them.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095