To use a Multi-Instance Keyword Type Group (allowing multiple Keyword Type values for the same Keyword Type, creating multiple Keyword Type Group instances), an instance of the Keyword Type when configuring the form field must be specified. Each Keyword Type Group instance should be associated with a specific occurrence number. For example, a Multi-Instance Keyword Type group containing Name, Address, and Phone Number Keyword Types must have two sets of data to be entered in the form, the fields must be mapped with the following text:
<p><input type="text" name="OBKey_Name_1" size="20"><input type="text" name="OBKey_Address_1" size="20"><input type="text" name="OBKey_Phone_Number_1" size="20"></p> <p><input type="text" name="OBKey_Name_2" size="20"><input type="text" name="OBKey_Address_2" size="20"><input type="text" name="OBKey_Phone_Number_2" size="20"></p>
In this example, information for two different people could successfully be entered and saved in an E-Form.
The following limitations apply when using Multi-Instance Keyword Type Groups in E-Forms:
-
There cannot be multiple values for the same Keyword Type within the same Keyword Type Group instance. Configuring more than one field for the same instance creates a new instance with only the "orphaned" value in the Keyword Type Group. Additionally, configuring more than one field using the same occurrence number clears the second field from the form. The value will be viewable in the Add/Modify Keywords dialog box.
-
When configuring a form to use a Multi-Instance Keyword Type Group, all Keyword Types that are in the group must be displayed on the form. Creating a form that does not contain all values of the keyword group can lead to unintentional deletion of Keyword values by an end-user.