Using Compatibility Mode

Specific mapping use cases required to use multiple mappings steps in a document flow, for one document transformation. This was because of the known limitations of XSLT Generator V1.

Keeping those mapping models supported, the Compatibility Mode must be switched on. Advanced mapping with hand-written XSLT code must have Compatibility Mode switched on, if created with XSLT Generator V1. You can regenerate the graphical model from which the XSLT code was extended.

These are the best practices for changing from V1 to V2:

Always test the mapping after changing the Compatibility Mode.
Rework the graphical mapping(s) that used workaround solutions.
Copy your hand-written XSLT code in a XSLT Generator V2 mapping version. Or rewrite the XSLT code that is generated from a XSLT Generator V2.

We recommend that you change all your mappings from V1 to V2. The XSLT Generator V1 eventually becomes completely deprecated with an announcement in the Release Notes.