Editing Information in Clusters

Any cluster of answers on a summary page can have an associated Edit link which appears to the right-hand side of the cluster title. This link is created by adding an edit-link element to the cluster as in the example below:

<cluster>
  <title id="DetailsCluster.Title">
    <![CDATA[Person Details]]>
  </title>
  <edit-link start-page="AboutYouPage"/>
  <layout>
    <num-cols>2</num-cols>
  </layout>
  <question id="firstName">
    <label id="FirstName.Label">
      <![CDATA[First Name:]]>
  </label>
</question>

The start-page attribute can be used to specify which page to link to (typically the same page on which they entered the information in the first place), using the id of the appropriate question-page element. This page should be in the same section as the summary page, otherwise a validation error will be thrown.

Once the user clicks on the Edit link from a summary page, the user is taken to the specified start page so that he or she can edit the data on it. Where the user goes from there depends on whether the user actually does anything on the page (i.e., change any answers) and what the implications of these changes might be. The options for what happens when a user clicks the next button are as follows:

• If the user made no changes to the answers previously captured on the page, then he or she will be taken straight back to the summary page for the section (where the user came from)
• If the user does make changes, then the system will check to see whether any of the answers on this page are used as part of a condition or loop expression anywhere in this script:
  • If not, then the user is returned to the summary page as above.
  • If so, then the Next button behaves as it normally would on a page and takes the user through the remaining pages in the section, evaluating conditions and loop expressions as it goes. As described earlier, all enabled sections beyond the section containing the first page in which the changed answers are referenced will be disabled at this point.

The optional show-page-elements attribute can be used to specify a list of clusters that should be displayed on the specified start page. If the attribute is not specified, the clusters on the page are rendered normally. Conditional clusters which are listed in the show-page-elements attribute behave as follows.

• Conditional clusters which are controlled by answers to questions on previous pages are shown if the expression controlling the condition evaluates to true.
• Dynamically conditional clusters where the elements contained in the expression are in potentially visible clusters on the start page are displayed if the expression evaluates to true. These clusters may be dynamically hidden or displayed as questions on the page are answered.
• Dynamically conditional clusters where the elements contained in the expression are not in potentially visible clusters on the start page are displayed if the expression evaluates to true. These clusters will not be dynamically hidden or displayed based on the users input.