Migrate Older Models to Use Relative IRIs

Migrating older models to use relative IRIs improves model refactoring. First, you need to add the macro. Second, you need to execute that macro. Lastly, you need to use that macro to migrate your older model to use relative IRIs.

To add the macro

---

1. In your Concept Modeling Project, click Tools > Macros > Organize Macros... or use shortcut key Ctrl+Alt+M.

   Figure 1: Showing the steps to open the Organize Macros dialog.

2. The Organize Macros dialog opens.

   

    Figure 2: Showing the Organize Macros that  holds the application's macros.

3. Click Add. The Macro Information dialog opens. Fill out the Name, Macro Language, and File containing the macro's description.
   

   Figure 3: Showing the Macro Information dialog where you can insert the macro file.

   Macro Language

   The Macro Language is the macro's file extension. The modeling tool supports BeanShell, Groovy, JRuby, JavaScript, JavaScript Rhino, and Jython.

4. To find the appropriate file, click on the three dots at the end of File field. Your local directory opens. Find the application folder and select data > Concept Modeler > scripts > UpdateIRI.groovy.

   

   Figure 4: Showing the steps to find the .groovy file

5. Now that you have selected the file, click Ok. Now you should see the macro added in the Organize Macros dialog.
6. Click Close.

To execute the macro

---

1. Click on Tools > Macros > Macro Name e.g. UpdateIRIMacro.

   

   Figure 5: Showing the steps to execute the newly added macro.

2. The Notification Window will notify you when the macro was executed.
   

To use the macro for your older model

---

1. Right - click on your model that you would like to update IRIs on as shown in Figure 6. 

   

   Figure 6: Showing the option to make IRI relative to the model package.

2. This prompts for you to select where to save the .csv file generated from this option.

3. After selecting the file, the progress bar shows the progress of the migration.

4. The notification window notifies you when the migration is done and where the results are stored. 

   
5. Find the Update IRI results in your designated location and view the Excel document containing "Element ID", "Old IRI","New IRI", and "Updated".