Contents

About

We recognize that institutions may need to annotate their resources with information that is specific to their institution and would not apply to all the institutions in the network.  One example of such a description could be an internal billing code to use for a core service. It would not be efficient to include this information in the eagle-i ontology if it only pertains to one institution, and may in fact lead to confusion about the use of the field by other institutions.

To address this need, we are introducing in this release the concept of 'Institution Specific Annotation'.  This feature will allow institutions to do just this by including an owl file in the configuration directory and adding two properties to the eagle-i-apps.properties file.  These additional ontological properties will be incorporated with the eagle-i ontology only within the scope of the institution's deployment.  

This feature, if used, will have the following visibility in the applications:

SWEET - Entering data

• A new section will appear between the end of the standard eagle-i fields and before the comments and curator notes sections. 
  
  
  
• SWEET - Viewing data
  • If institution specific information has been entered for a resource, this will be displayed in its own section just before the Metatdata section.
    
    
    
• SEARCH - Institution
  • If you have installed the institution search application, and the institution specific information has been entered for a resource, this will be displayed at the end
    
    
• DISSEMINATION
  • Any institution specific information that is associated with an institution's resource will be viewable from the resource's dissemination page
    

Institution specific annotations will not be visible in the central search application:

• SEARCH - Central
  • Any institution specific information that is associated with an institution's resource will not be viewable from the central search application
    

Use

To use this feature:

• Generate an owl file.
  • A sample owl file with several datatypes can be found in our examples folder:

    /eagle-i-base/examples/config-files/institution-specific-annotations.owl

  • NB: Only datatype properties are allowed at this time
• Place the owl file in your eagle-i configuration folder.  This is usually

  ~tomcatX/eaglei/conf/

• Edit the eagle-i-apps.properties file and add the following properties:
  • eaglei.model.jena.localSource
    • This is the name of your owl file
  • eaglei.model.jena.localIri
    • This is the IRI for your owl file