Joined Scripts

Joined scripts are used when you need to collect a single set data in your main script, associated with multiple sets of related data. 
 
For example, you may wish to collect information on a household, then the names and dates of birth of the occupants.  Because you don't know how many occupants there will be in the household, you would not know how many "Name" and "Date of Birth" fields to include in your script.  To overcome this, you could use one script to collect the information that occurs once in your questions, and a joined script which can run multiple times to collect every subset of data.
 
The following diagram shows a Joined Script collecting multiple name and addresses in a single script run:
 
 
Note that when reporting on joined scripts, you will need to loop through each sub record using a special reporting field.
 
There are two different Controls for embedding Joined scripts within your main script:, however both are configured in the same way.
 

"Linked Script Launch" Control. 

See Linked Script - launch for more information
This control will display a button to create a new sub-record.  When the button is clicked, the agent is taken to the sub script, completes the form, clicks the "XXX" button and is returned to the main script.  Each sub-record is then displayed in a list on the main page.  The agent can click to edit or view depending on the control attributes set by the script writer.
 
 
 
When the create button is clicked, a separate window opens in which the agent can add sub-record details:
 
 
 

"Joined Script" Control. 

This control displays a box with two buttons, New and GoTo.  The box itself is populated with the related sub-script records as they are created.
 
 
The Joined or Sub-script will pop in a new window for the agent to complete/cancel.  Once the Next button is clicked, the agent is taken back to the main script, where they can add or edit further entries:
 
 

Checklist

 

Create your Joined or Sub-Script

  • Mark it as a Joined Script on the Script attributes page:
 
 
  • Your joined script can contain multiple pages.  At the point you wish to return to the parent script, you will hit the end page of your sub-script.  The last page of your script must be marked as Penultimate and End page in the page properties.  You should not include any outcome controls.
 

Create your Main Script

  • Add the desired Joined Script or Linked Script Launch control and link it to your sub-script.
  • Choose the fields you want to display on the main script in order that the agent can see what has been taken already.