AddFormIDsGroup Method

The AddFormIDsGroup method adds from group/copy instances.

Sample Code

Let's take an example: There's a need to bundle the forms for 3 accounts together but with differing forms. Let's say Acct A gets form IDs 1,2,2; Acct B gets form IDs 1,3; and Acct C get form IDs 2,3. 

The example below will generate 3 group of forms:

QuikFormsEngine qfe = new QuikFormsEngine();

qfe.QuikCustID = "1000123";
qfe.QuikUsername = "myUserName";
qfe.QuikPassword = "myPassword";

qfe.AddFormIDsGroup("1,2,2");
qfe.AddFormIDsGroup("1,3");
qfe.AddFormIDsGroup("2,3");
qfe.Execute();

Technical Details

• For the first group of forms, fields are built normally without the field instance extension. If, within the first group, FormIDs are duplicated (e.g. form group 1 has forms "1,2,2" where form ID 2 is repeated) then the field instance will be "-1".  
  • “1own.FName” for the first instance of FormID 1 in this first group of forms.
  • “1own.FName-1” for the second instance of FormID 2 in this first group of forms.
• For the second group of forms, fields will be built with a field instance extension. The extension number will start at 1000 (e.g. "1own.FName-1000") and grow as duplicate forms are included in the same package (e.g. the second copy of the same form could have a field named "1own.FName-1001"). 
  • “1own.FName-1000” for the first instance
  • “1own.FName-1001” for the second instance
• Subsequent groups of forms will increase the instance number by 1000. For example, the third form group will have a field instance number starting with "2000" and increments by 1 for each copy of the same form within that group (e.g. if the group contains FormIDs "1,1,1,1" then the instance numbers would be "2000", "2001", "2002" and "2003" 
  • “1own.FName-2000”
  • “1own.FName-2001”
  • “1own.FName-2002”
  • “1own.FName-2003”