Summary

This article defines the instruction rowIterationOnSelectedValues.

Table of Contents

• Instruction rowIterationOnSelectedValues
  • Restriction
  • Overview
  • Question Id
  • Value
  • Input value
  • Output value
  • Examples

Instruction rowIterationOnSelectedValues

Restriction

This instruction is usable for table exports only. Typically this will be a custom export to text, Excel or SAS. This instruction is not available for XML exports.

Overview

Usually there will be one row that is written per configured export type id for each form. This instruction allows writing multiple rows according to the selected values of a question. When no value is selected, then no row is written; the first partially evaluated row is skipped then. See instructions getRowIterationPosition and getRowIterationValue for access to the currently selected values. The instruction is called for every iteration. On the first invoke the iteration is initialized. Every time the current iteration value is returned. So there is no need for an additional call to getRowIterationValue directly underneath this instruction.

Question Id

Required. Specify a multiple selection question here.

Value

Unused.

Input value

Unused.

Output value

The current row iteration is returned.

Examples

An adverse event might reference four concomitant medications. Use this instruction in order to export four rows, one for each selected concomitant medication.

Need more help?

Please visit the Fountayn Contact Information page.