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.
      
5. Set Set Mode to  to Static.
6. 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 (assuming that the user does not complete a field that would initiate a shared embedded flow-down), leave

...

1. • the Is Required

...

1. •  option selected 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 (again, assuming that the user does not complete a field that would initiate a shared embedded flow-down),

...

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. Make additional modifications to any of these virtual fields as necessary after you have used the wizard to create them.
4. If not already in place, add the entity object plug-in to the entity's Plug-Ins tab.
   
   • The initial embedded link flow-down to this non-owner record (such as the address flow-down from a company to a person) is controlled by logic that needs to be added to the non-owner entity's entity object.
   • A developer writes code that specifies this flow-down logic (either adding it to an existing entity object or creating one for the entity if one does not already exist) and then adds the object to the Aptify Object Repository.
   • See

...

1. • Adding Plug-Ins to an Entity

...

1. •  for more information.
      
2. Save and close the Entities record.
3. Close and reopen the Aptify Desktop client.
4. Test your shared embedded object implementation.
   
   • When a record in this entity is linked to a shared embedded object, the system should lock the embedded record automatically (by setting the Locked field to 1).