SYNTAX

<Collection1> = <Collection2>

<Collection> = <Entity>Replaces all elements in <Collection1> with the elements in <Collection2>, provided the association between the two is permitted by the Business Vocabulary. In the second syntax, <Entity> is associated with <Collection>, replacing the <Entity> already associated, when the association between the two is “one-to-one” in the Business Vocabulary. All collections must be expressed as unique aliases.

The Operators row in the table of Summary Table of Vocabulary Usage Restriction does not apply. Special exceptions: replace elements may only be used in Action Rows (section 5 in Sections of Rulesheet that correlate with usage restrictions).

This sample Rulesheet uses the replace element operator to add Entity3 to collection1 if its boolean1 value is true. Note the use of unique alias collection1 to represent the collection of Entity3 elements associated with Entity2. The association between Entity2 and Entity3 has a cardinality of “one-to-one”. If multiple Entity3 are present, only one will be added to collection1.

Three sample tests provide scenarios of two elements which share a one-to-one association. Input and Output panels are illustrated below: