Page History

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.This can be done using the Macro Engine. The modeling tool comes with the macro file installed in the tool's directory. Instructions on how to find the file are described in step #4 of how to add the macro. 

To add the macro

...

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

   Image Modified

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

3. The Organize Macros

dialog

4.  dialog opens. Click Add.

   Image Modified

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

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

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

   Info

   title	Macro Language

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

    
   Image Added

6. To find the appropriate file, click on the three dots at the end

of

7. of File

field

8.  field. Your local directory opens. Find the application folder, and

select

9. select data

>

10.  > Concept Modeler

>

11.  > scripts

>

12.  > UpdateIRI.groovy.

    Image ModifiedFigure 4: Showing the steps to find

the

13. the .groovy

file

14.  file

15. Now that you have selected the file, click click Ok. Now you You should now see the macro added in the Organize Macros dialog.
16. Click Close.

To execute the macro

...

1. Click

on

2. on Tools

>

3.  > Macros

>

4.  > Macro Name e.g. UpdateIRIMacro.

   Image Modified

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

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

To use the macro for your older modelexisting project

...

1. Right-click on

your

2. the model

that

3. on which you would like to update IRIs

on as shown in Figure 6

4. .

 

5. Image Modified

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

This prompts for you to select

7. A dialog will open asking you where to save the results in .csv

file generated from this option

8.  format.

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

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

    Image Modified
11. Find the Update IRI results in your designated location, and view the
Excel document containing
12. CSV file showing which elements were looked at and updated. The CSV file describes the "Element ID", "Old IRI","New IRI", and "Updated".