User Tools

Site Tools


relationmanager_functional_organization_expected_use.htm
Navigation:  ABC Library Reference > RelationManager > RelationManager Methods >====== RelationManager Functional Organization–Expected Use C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

As an aid to understanding the RelationManager, it is useful to organize its methods into two categories according to their expected use–the primary interface and the virtual methods. This organization reflects what we believe is typical use of the RelationManager methods.

Non-Virtual Methods

The Non-Virtual Methods, which you are likely to call fairly routinely from your program, can be further divided into three categories:

Housekeeping (one-time) Use:

Init initialize the RelationManager object
AddRelation set a file relationship
AddRelationLink set linking fields for a relationship
SetAlias add/set a file alias
Kill shut down the RelationManager object

Mainstream Use:

Open (v) open a file and any related files
Save (v) copy current and designated related records
Update (v) update current record subject to RI constraints
Delete (v) delete current record subject to RI constraints
Close (v) close a file and any related files

(v)These methods are also Virtual.

Occasional Use:

ListLinkingFields map pairs of linked fields
SetQuickScan enable QuickScan across related files

Virtual Methods

We anticipate you will often want to override these methods, and because they are virtual, they are very easy to override. These methods do provide reasonable default behavior in case you do not want to override them.

Open open a file and any related files
CancelAutoInc undo PrimeAutoInc actions
Save copy current and designated related records
Update update current record subject to RI constraints
Delete delete current record subject to RI constraints
Close close a file and any related files
relationmanager_functional_organization_expected_use.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1