Changing Forms during suspension

KCM ComposerUI Server supports changes to Forms while the model runs using the suspended Forms. The same applies to KCM Master Templates. Answers to the Questions of Forms are validated by KCM Core when a Master Template run is resumed. This validation checks all previous answers against the current definition of each Form that was already filled in before suspending the Master Template run. If the validation check fails for one or more Forms, the Master Template run will start at the first Form in the Master Template that fails the validation.

The validation consists of checks if the Form ID is changed, if any Questions are changed, and if all answers comply with the restrictions defined in their corresponding Question. When the validation fails, the Form is presented again with appropriate error messages about the Questions that no longer accept the previous answers. Most of the Questions retain their previous input, or in case of a new Question, their default answers. After changing the KCM Master Template its developer should consider forcing some of the Forms to be presented again. We recommend that you change the Form IDs or Question IDs when resuming a model run.

Forms are only considered unchanged when their IDs are specified and unchanged. Otherwise, the Form fails the validation and is presented again. The order of the Forms in the Master Template is not important, they are matched to their ID and the number of times that it was presented during the Master Template run.

For more information on Form IDs, refer to the KCM Core Developer's Guide, chapter Form and question IDs.

Questions are considered unchanged, when:

Their IDs are identical
The type of the Questions is not changed
The answer is still valid for that Question.

The order of Questions is not important because they are matched to their ID. New Questions with a new ID added to the Form are considered as changed. Removed questions are considered as unchanged. Changing a Question from a single-select to a multi-select or vice versa also constitutes a change of the Question type. For more information on Forms and Question definitions, see Template scripting language Help keyword FORM.

Answer is valid if it respects the maximum length and specified format in the definition of the Question. If the Question specifies a list of possible answers, the answer must occur in that list. A Text Block selection must also be a member of the specified View, in order to be a valid answer. For more information on Question definitions, see Template scripting language Help keyword FORM.