Add_Client_File - DataDictionary

Adds a table to this object's related-child list

Type: Procedure Set

Data Type: Integer

Parameters: Integer iFile

ParameterDescription
iFileNumber of the table to add to this object's related-child list


Syntax
Procedure Set Add_Client_File Integer iFile

Call: Set Add_Client_File to iFile


Description

Set Add_Client_File to Orderdtl.File_Number

A Data Dictionary needs to know about its related-from, child tables. By identifying all child tables the Data Dictionary can determine if Data Dictionary objects have been created for all of these children and if those child DDOs are properly connected to the main DDO. The child DDOs will also have a list child tables and these child DDOs can also make the same check to make sure that their child DDOs exist and are properly connected within the structure. This process occurs down the entire database hierarchy.

By propagating this check down an entire Data Dictionary object structure any DDO can tell if it's entire Data Dictionary structure is complete. If the downward structure is not complete, that DDO may be allowed to delete records, as it would not have the proper child DDOs required to cascade delete related child records.

Child table information is also used by the Studio and various wizards to help you write your applications. Therefore it is important that this information is properly maintained in your Data Dictionary class.

You add tables to the related-child list with the Add_Client_File message. You send this message for each required child table.

Note that this "Set Add_Client_File" version of this message is preferred over the now obsolete "Send Add_Client_File" message. The Set is used by the Visual DataDictionary Modeler.

See Also

Add_Server_File | Add_System_File | Defining Data Dictionary Parent, Child and External Relationships