Please see the recipe Document per Repeated Item for an introduction to this concept.
Now, following on from the above discussion, suppose we need a separate document for each of the sureties, but only if a particular surety has a net asset value of $100,000 or more. The template itself will remain unchanged except that a SetMultipleDocumentFilter command will be applied to it. Here follows the original example, slightly modified and incorporating with this new command:
I,
<<Surety[$SuretyNumber]/SuretyFirstNames>><<Surety[$SuretyNumber]/SuretySurname>>(Born on<<FormatDate(Surety[$SuretyNumber]/SuretyDOB, “dd MMMM yyyy”)>>) hereby declare blah blah.
blahMy net assets are $
<<FormatNumber(Surety[$SuretyNumber]/NetAssets)>>
<<SetMultipleDocumentFilter(NetAssets >= 100000)>>Signed:
<<Surety[$SuretyNumber]/SuretyFirstNames>><<Surety[$SuretyNumber]/SuretySurname>>
This would result in one document being produced for each surety, but only if that particular surety’s net asset value is greater than $100,000.
This is fine so long as the minimum net asset value is always going to be $100,000. But suppose you want the user (i.e. the person running the template) to be able to set this minimum value from one application to another. You would then have a data element called something like MinimumAssetValue which is captured in the interview outside the scope of the sureties, and the resulting template snippet would look like this:
<<CaptureDataElement(MinimumAssetValue,Decimal)>>I,
<<Surety[$SuretyNumber]/SuretyFirstNames>><<Surety[$SuretyNumber]/SuretySurname>>(Born on<<FormatDate(Surety[$SuretyNumber]/SuretyDOB, “dd MMMM yyyy”)>>) hereby declare blah blah.
blahMy net assets are $
<<FormatNumber(Surety[$SuretyNumber]/NetAssets)>>
<<SetMultipleDocumentFilter(NetAssets >= ../MinimumAssetValue)>>Signed:
<<Surety[$SuretyNumber]/SuretyFirstNames>><<Surety[$SuretyNumber]/SuretySurname>>
You will notice the ../ before MinimumAssetValue. This is because the scope of the data elements in the condition is by default the repeating data element – in this case Surety. In order to reference a data element higher in the XML hierarchy, the ../ notation is used. A fairly comprehensive discussion of this is contained in the recipe Working with repeated elements under the heading Referencing Non-repeating elements within a ForEach block.
