2025-05-02: Migration V3

Migration V3 is a new version of Cadmus data migration components where export has been refactored to a higher abstraction level. This allows for a more generalized approach, covers both Cadmus and GVE for their export processes, and makes the export more powerful by introducing text trees rather than just a list of text blocks in the rendering pipeline.

New major versions are:

  • backend (migration): 7.
  • backend (API): 12.
  • frontend (API and preview): 13.

Once upgraded backend to migration V3 (backend version 7), you need to apply these changes:

  1. in your backend, update libraries and adjust the preview configuration preview-profile.json according to the breaking changes:
    • rename section RendererFilters into TextFilters.
    • use : instead of | for type ID + role ID separator, e.g. it.vedph.token-text-layer:fr.it.vedph.apparatus rather than it.vedph.token-text-layer|fr.it.vedph.apparatus.
    • update component tags where required.
  2. in your frontend, update libraries.