conditionSafe Option

The conditionSafe method option marks a mapping method as having no side effects.

When the mapping method of a virtual property is declared as conditionSafe, updates of the virtual property cannot save the new value, which makes the virtual property completely read‑only.

Virtual properties with conditionSafe mapping methods can be used in RPS mappings. For details about specifying the display of virtual properties in the Relational Population Service wizard, see "Setting Up the RPS Options", in Chapter 15 of the Development Environment User's Guide.

A mapping method marked with the conditionSafe method option has language limitations similar to those of a condition method. When using conditionSafe mapping methods, you:

• Can use only if and return instructions

• Can assign a value only to the second parameter

• Can use only the self system variable (for example, app and global are not allowed)

• Cannot declare and use local option variables

• Cannot use expressions with property de‑references (for example, myCustomer.name is not allowed)

• Cannot reference an element in an array (for example, results[4] or the equivalent results.at(4))

• Cannot reference an object in a dictionary from its key value (for example, customers["Jones"] or the equivalent customers.getAtKey("Jones"))