Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Checkout or update SVN.
  2. If the changes require some ontology content, for example:
  3. if a new technique was added to the ISF by someone else, and
  4. eagle-i would like to override the ISF label with a custom preferred application label
  5. then before the application label can be added to the new class, the new class has to be visible when opening the application file.
  6. For this to happen, the eagle-i module(s) will have to be generated or regenerated using the module scripts so that the generated module files will contain the newly added class. Alternatively, in the application file, a new class can be created with same IRI as in the ISF and then application specific annotations can be added on this new class. This would avoid the need for a local generation to see this class. However, doing this with the generation scripts will guarantee that things are working as expected and to make sure that the Bamboo build will work as expected.
  7. At this point, the new preferred label can be added, or other application specific changes can be made.
  8. Review changes in your SVN tool and then commit.
  9. This will trigger a Bamboo build.
Info
iconfalse

This workflow will:

  1. Not affect the ISF files
  2. Does not require local module builds unless the latest modules are needed to be able to apply the application configuration changes.
  3. The details for how to configure the application are based on specific application annotations, where they are made in the application files, etc. See other documentation sections for details.

...

To change the “eagle-i ontology” you will need to change the appropriate “module configuration” in order to affect the generated ontology modules. Or change the ISF content that is being used by the current “module configurations”.

Changing the ISF

For example, if you need to add a new technique term, this change needs to be done in the ISF unless it is considered to be a technique that is too specific to eagle-i and it should not be made in the ISF. The top class “technique” is already configured to be included in the eagle-i build (with all its subclasses) so the only change needed is to add it to the ISF. To do this:

    1. Checkout or update the eagle-i SVN.
    2. This will also checkout in the latest ISF in the ISF folder described above.
      1. If eagle-i pins the ISF external to a specific version, it will not be possible to do the steps described here.
    3. Open the isf-dev.owl file from the ISF folder and then change to the appropriate ISF file and add the term. (To determine the appropriate ISF file, see which file is currently used for the parent class and use the same file.)
    4. Review changes (in Protege and / or in your SVN tool) to make sure they are correct.
    5. Now you need to commit the change to the ISF
      1. Most SVN tools will require that the commit is done from inside the external folder.
      2. If you are using a command line tool, change to the root ISF folder and do a “commit”
      3. If you are using a GUI, right click on the root ISF folder and do the commit.
    6. The Bamboo build should be triggered and the new technique should be included in the generated files.

 

Changing module configuration

The other type of change involves changing the module configuration without changing the ISF. For example, there might be a new hierarchy in the ISF that wasn’t used in eagle-i but should be used now. The steps would be:

...

    1. Decide which eagle-i module configuration should be adjusted. For example, if the ero.owl file is the one that needs the new hierarchy, the “eagle-i” module configuration needs to be changed.
    2. Open the configuration file for the specified module and make any necessary configuration changes. The details are in the tools documentation.
    3. Before committing to SVN, generate the ontology files locally to verify that the configuration changes will give you the desired results.
    4. When the configuration is correct, commit the changes to SVN. This will trigger the Bamboo build and the result should match the results of the generated ontology.