Page Comparison

...

1. Create a new Entities record or open an existing record that you intend to modify. See "Creating a New Entity" on page 162 for  for instructions.
   
   • For this step, complete the top area of the Entities form, add security settings, and add entity fields (except for the embedded link).
   • Keep in mind that the security settings on the embedded entity and the container entity should meet the design requirements that you identified previously.
      
2. Open a new Fields record for the embedded link.
3. Enter a a Name for  for the embedded link.
   
   • Aptify's standard naming convention for linked fields is the name of the linked entity (in its singular form) and the linked entity field. For example, the name of a field linked to the Addresses entity's ID field would

...

1. • be AddressID.
   • The Display Name fills in automatically when you specify a Name.
      
2. Select the embedded entity from the the Linked Entity drop drop-down list.Select
3. Select ID from the  from the Linked Field drop drop-down list.
4. Select Select Embedded from the  from the Link Type drop drop-down list and press the the Tab key key.
   
   • The Mode field appears.
     
   Set
   •  
5. Set Mode to  to Dynamic.
   
   • The Dynamic Sharing tab appears.
      
6. Click the the Dynamic Sharing tab. Dynamic Embedded Link Field Image Removed tab.  
   
   Image Added 
7. In the the Dynamic Flowdown Proc field field, specify the stored procedure that defines the update logic for non-owner links that may share the owner's embedded record.
   
   • This field links to the Database Objects service.
   • You can use the stored procedure linked to the Companies entity's AddressID field or the Organizations entity's AddressID field as samples when writing your own stored procedures.
      
8. Add the non-owner fields referenced in the Dynamic Flowdown Proc procedure to the Dynamic Sharing Relationship sub-type area.
   
   • For each sub-type record, enter the following information:
     • Related Entity:

...

1. • •  Enter the name of the entity that can share this owner's embedded record.
     • Related Entity Field:

...

1. • •  Enter the name of the field in the Related Entity that links to the same embedded entity as the owner.
     • Dynamic Flowdown Filter:

...

1. • •  This field is reserved for future use.
        
   • For example, a company's Addresses record may be shared by the Persons entity's AddressID field.
      
2. Click the the Validation tab  tab and configure the embedded link's Is Required behavior.
   
   • If you want to require a user to specify a value for all of the required fields in the embedded entity, leave

...

1. • the Is Required

...

1. •  box checked under

...

1. • the Validation

...

1. •  tab.
   • If you want to allow users to save the container record without specifying all of the required embedded fields,

...

1. • clear the Is Required

...

1. •  option on

...

1. • the Validation

...

1. •  tab and select the Allow Null

...

1. •  option on

...

1. • the General

...

1. •  tab.
      
2. Click Click OK to  to save and close the Fields record.
   
   • You do not want to enable the field's Show In Find or Default In View options since you want the link to be transparent to users.
   • The Aptify Entity Virtual Fields wizard appears automatically when you close an embedded link's Fields record.
      
3. Use the wizard to create a virtual field for each of fields in the embedded entity that you want to display on the container entity's form.
   

...

1. • Select the Create check box for each field you want to embedded in the container entity. At a minimum, you must create a virtual field for each of the required fields in the embedded entity, except for ID. (Do not create a virtual field for the embedded entity's ID field.)

...

1. •  
     
     Image Added 
   • If you want the field to appear in views of the container entity by default,

...

1. • select the check

...

1. • box in the

...

1. • corresponding Default In View

...

1. •  box.
   • Enter the name of the field in the Virtual Field column. The name cannot contain spaces or dashes. Aptify recommends the following naming convention: [Singular form of embedded entity name]ID_[Field Name]. For example, AddressID_PostalCode.
   • Enter the name that will appear as this field's caption on the container entity's form and in views of the container entity. Typically this will be the field's name with appropriate spacing (such as, Postal Code).
   • Enter

...

1. • a Description

...

1. •  for one or more virtual fields, if desired.
     
   Click
   •  
2. Click OK to  to create the virtual fields.
   
   • Note that if the embedded link is not required, the virtual field's Join Type is Optional. If the embedded link is required, the virtual field's Join Type is Required. If you subsequently change the embedded link's Is Required field, the Join Types for the related virtual fields update automatically when you save the entity. See

...

1. • Join Type

...

1. • .
   • A Virtual Field inherits the SQL Data Type of the Fields record it is linked to.
   • If applicable, a Virtual Field inherits the Values record and Default Value setting of the Fields record it is linked to. (Note that while the values appear in the drop-down list for the embedded field on a top-level form, the Values tab on the Virtual Field remains blank though.)
      
2. If you want one or more of the virtual fields to appear on a tab other than General on the generated form, open the applicable Fields record and enter the tab name in the the Category field field. 
3. Save and close the Entities record.