This feature is available in version 2.0-MS1.11 and later. |
In order to avoid unnecessary duplication of data across institutions, increase standardization, and ease as much of the burden of data entry on users as possible, we have introduced a new concept known as Centrally Curated Resources. This feature alleviates the need for duplication of common resources in each institutional node: rather than linking a record to a locally-created instance of a very common resource, users may now link to an instance in a centrally-curated collection that resides in a dedicated 'global' repository. This eliminates the need for locally-created copies of common resources such as major manufacturers and government agencies.
This concept has been internally referenced as 'globals' and this is reflected in the choice of configuration property names. These resources will reside in a central repository that is maintained by the eagle-i team, although all institutions will have read-access to it. We strongly encourage users to select from Centrally Curated Resources wherever appropriate when entering data in SWEET.
As of the 2.0-MS1.11 release, only resources that link to the following resource types are affected by the implementation of the Centrally Curated Resources:
Once the SWEET application has been configured to use Centrally Curated Resources, the application will periodically query the Centrally Curated Resources data repository for a minimal set (label and URI) of information from the published data. SWEET will then place a local copy of this minimal set of information in its own data repository, in a specialized graph (NG_GlobalProxy
). Subsequent uses of SWEET will present selections for the user from this specialized graph, as well as the default and published graphs.
In fields that have one of the above mentioned types as a range, users will now see a new group of listings at the top:
Resources that are not Centrally Curated Resources will be listed at the bottom:
From the perspective of the other eagle-i applications (such as search or dissemination pages), there is no visible effect. The triples containing the Centrally Curated Resources will contain an object value that will be resolved by the 'global' repository.
|
To start using this feature in your institution's installation, please follow these steps:
NG_GlobalProxy
graph in the institution's data repository. See creating repository users for details on how to create a new user. Automated Agent
. In this example, the username for the new user is GlobalUser
and the password is GlobalPw
. We will be referring to this new user in other parts of this section. ${EAGLE_I_HOME
}, in the conf
directory and in the .config
directory. eagle-i-apps-credentials.properties
To let the SWEET application know the credentials for this new user, a new set of properties needs to be added to the credentials property file. This file is located in the .config
directory of the ${EAGLE_I_HOME
} directory, e.g. /opt/eaglei/.config/eagle-i-apps-credentials.properties
.
Add the following lines to the eagle-i-apps-credentials.properties
file:
# GLOBAL SERVICE eaglei.datatools.globals.user=GlobalUser eaglei.datatools.globals.password=GlobalPw |
Please substitute the username and password that you have created for the example ones.
eagle-i-apps.properties
To let SWEET know how often it should update its NG_GlobalProxy
with data from Centrally Curated Resources repository, add the following lines to the eagle-i-apps.properties
file:
# the frequency to perform the polling for global information eaglei.datatools.globalPolling.frequency=12 # the time unit for the frequency, *must* be one of java.util.concurrent.TimeUnit # [DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS, MICROSECONDS, NANOSECONDS] eaglei.datatools.globalPolling.unit=HOURS ## -- END GLOBALS -- |
You can tweak the frequency as you see fit, however we recommend 12 hours as the polling frequency.
local-node.xml
Insert the following snippet at the beginning of your local-node.xml
file, after the <local>
tag:
<global URL="http://global.eagle-i.net"> <institutionList> <institution URI="http://purl.org/eagle-i/app-ext/#ERO_0000065_29" graphURI="test29"> <namespace>global.eagle-i.net</namespace> <logoSrc>images/logo_global.png</logoSrc> </institution> </institutionList> </global> |
Here is an example of a complete local-node.xml
file with the new information about the Centrally Curated Resources:
<?xml version="1.0" encoding="UTF-8"?> <local> <global URL="http://global.eagle-i.net"> <institutionList> <institution URI="http://purl.org/eagle-i/app-ext/#ERO_0000065_29"> <namespace>global.eagle-i.net</namespace> <logoSrc>images/logo_global.png</logoSrc> </institution> </institutionList> </global> <node url="http://foo.bar.edu"> <institutionList> <institution URI="http://purl.org/eagle-i/app-ext/#ERO_0000065_3" graphURI="test3"> <namespace>foo.bar.edu</namespace> <label>Furry Object Orientation University</label> <logoSrc>images/logo_foo.png</logoSrc> </institution> </institutionList> </node> </local> |
At this time, if there is not a Centrally Curated Resources that corresponds to your needs, you may still create locally instances of private companies and government agencies. We will periodically update the Centrally Curated Resources and provide updated data migration files to reflect this.
If your institution is not one of the eagle-i network institutions (i.e. connected to central search prior to April 1, 2013), please contact us for assistance to migrate your data. |
To completely integrate the Centrally Curated Resources within the institution's data repository, the existing data in the repository needs to be migrated.
From the command line, navigate to the command line tools folder in the repository home directory (see repository installation and administration guide. For example
cd /opt/eaglei/repo/etc |
Run the globals-migration.sh
script. You will need to know the administrative credentials for the repository. In the following example, we assume the username for the administrative user is adminUser
and the password is adminPw
. We also assume that the url for the repository is http://foo.bar.edu
bash globals-migration.sh adminUser adminPw http://foo.bar.edu |
To verify that you have configured Centrally Curated Resources correctly for SWEET, try to enter a new Instrument. When selecting a Manufacturer, you should see a group of manufacturers under the heading of Centrally Curated Resources
(see image in SWEET - Entering Data).
If you have installed institution search and you have successfully migrated your data, you will not notice a difference in the resource's instance page. However, when you click through to a Centrally Curated Resource, you will notice that the logo is no longer your institution's logo, but the logo for the Centrally Curated Resources data repository.
You will not notice a difference in the resource's instance page. However, when you click through to a Centrally Curated Resource, you will notice that the logo is no longer your institution's logo, but the logo for the Centrally Curated Resources data repository.