Migrator
The Migrator requires the YouDesign Admin (
x_inpi_yd.admin) role.
The Migrator brings existing diagrams into YouDesign Models as boards. It reads diagrams made in Designer and files exported from other tools, maps their shapes to your shape libraries, and creates boards in the Migrated Diagrams folder. A readiness check tells you what will map cleanly before anything is created.
Supported Sources
Designer diagrams
Nothing to upload. Requires a Designer Analyzer run in the instance.
Bulk migration of the Designer diagrams already stored in ServiceNow.
Designer XML upload
Designer diagram XML files from your computer.
For diagrams exported from another instance.
BPMN XML upload
BPMN 2.0 XML files exported from other tools.
Pools, lanes, sub-processes, boundary events and data associations are recognised, and shape, text and connector colours are kept. Several diagrams in one file become several frames.
Visio upload
Microsoft Visio drawings (.vsdx).
Colours, connectors, containers, pools and lanes are preserved. Each Visio page becomes a frame.
ArchiMate upload
ArchiMate Open Exchange Format XML (2.1 and 3.x) or a native Archi .archimate file.
Elements, relationships and views are mapped to the ArchiMate library.
Opening the Migrator
In the ServiceNow navigator, open YouDesign Models > Configuration > Migrator. The Migrator opens as its own page.
The Wizard
The Migrator walks through five steps: Source, Select, Configure, Readiness and Results. Back returns to the previous step and Start over resets the wizard.
1. Source
Choose one of the source cards.
2. Select
For an upload source, drag files onto the drop zone or click it to pick files. The files are listed with their size; the bin icon removes one, Clear all removes them all. For a Designer source, the diagrams found in the instance are listed and you tick the ones to migrate.
3. Configure
The settings apply to every diagram in the run. Which groups you see depends on the source.
Designer
Relationship fields table
The table used to resolve relationship fields. Designer sources only.
Designer
Folder structure
First folder as Teamspace turns the top Designer folder into the teamspace, New Teamspace creates one. Designer sources only.
Shapes
Migrate container fill colors
Keep the fill colour of pools, lanes and other containers from the source. Off by default, so containers stay transparent.
Shapes
Use the target shape table
Each migrated shape takes the table defined on the Models shape it is mapped to, for example Business Application gives cmdb_ci_business_app. Shapes already linked to a record keep their own table.
Board
Add timestamp to board title
Append the migration time to each board name, so migrating the same file again does not produce boards with identical names. Upload sources only.
The Migrator remembers these settings in your browser, so they are still set after Start over or a change of source.
4. Readiness
Every selected diagram is analysed. The summary line tells you how many diagrams can be migrated and how many carry errors or warnings. Findings are reported but do not block the migration; a shape without a mapping simply arrives as a plain shape with its label.
The step has three tabs:
Diagrams — one row per diagram with its readiness and its error and warning counts. Expand a row for the details.
Findings — one row per problem: diagram, severity, category (for example "Shapes without mapping"), the shape's text and its source key. Each row has a Create mapping button.
Manage mappings — the full mapping table for the source application, with search.
Creating a mapping
Create mapping opens a dialog pre-filled with the source key of the finding:
Application
The source tool the mapping belongs to (BPMN, Visio, Designer, ArchiMate).
Type
Shape to map to a Models shape, or Text to map to a fixed text value.
Source key
The shape type as the source tool names it, for example subProcess. Tick Source from Shapes to pick from known keys instead of typing.
Target shape
The Models shape to use. Tick Target from Shapes to search all active shapes by name or library folder, for example BPMN › Activity › Sub Process. A preview of the chosen shape appears under the field.
Active
Inactive mappings are kept but ignored.
Provisional mapping
Marks a mapping you want to revisit; it migrates like any other and is flagged in the mapping table.
When several findings are open, Previous and Next step through them without closing the dialog. After saving, click Re-run check; the finding disappears once the mapping covers it. Mappings are saved in the instance and reused by every later migration.
Click Migrate (n) to create the boards.
5. Results
Each diagram is listed with its readiness and migration badges and an open board icon that opens the new board in the editor. The download icon exports the results table. Migrate more starts a new run with the same source.
The Designer Workbench
Choosing Designer diagrams opens the workbench instead of the step-by-step wizard. It keeps the diagram list, findings and results in one persistent view for large migrations.
Settings at the top hold the same options as the Configure step, plus Content to migrate when every analysed diagram has its Designer image: Image and elements rebuilds the diagram, Image only places the picture. Click the header to collapse the settings to a one-line summary of the current values and give the diagram list more room.
Tick diagrams and click Check selected to run the readiness check, then Migrate / update to create or refresh their boards.
Findings shows the problems of the selected diagrams only, so you can work through one folder at a time. Repair mappings steps through the mappings the findings point at; All mappings opens the mapping manager.
Open board opens the migrated board, Compare shows the Designer diagram and its board side by side, and the download icon exports the results summary.
Good to Know
Migrated boards are ordinary boards in the Migrated Diagrams folder. Move them to their teamspace afterwards; versioning, sharing and export work as usual.
Run the readiness check on a handful of diagrams first to build the mapping table before migrating a whole folder.
Related
Shape Administration — the shape libraries mappings point at
Moving Boards Between Teamspaces — relocating boards after migration
BPMN Shapes & Swimlanes — what imported BPMN diagrams look like
Last updated