How to contribute to AGRIS?
If your bibliographic references relate to agriculture, forestry, animal husbandry, aquatic sciences & fisheries and human nutrition follow the next steps indicated down below.
Step 1. Check the requirements & the recommendations
To be sure, just check if your collection fits in one of the AGRIS subject categories.
In principle AGRIS accepts all metadata formats. Still highly recommendable are the following formats/standards: PubMed XML - METS XML – DOAJ ARTICLES – MODS - AGRIS AP. Also acceptable are: MARCXML, MARC21, OAI-DC, ENDNOTE XML, SIMPLE_DC.
Completeness of your metadata
In order to improve the accessibility and retrievability of your records make sure you use the elements: title, description, author, date, subject (eg AGROVOC Thesaurus), URI identifier (link to the pdf resource), rights.
It is recommended to send your data in XML by e-mail(a compressed file attachment like .zip or .rar, containing all the XML files).
It is highly recommended to use encoding UTF- 8.
Furthermore, it is needed to pay attention to special characters like &, <, >, “, ‘, because their use can break the xml files. If these characters are not supported by authoring environment, then they will have to be substituted. In any case go through the xml files for special characters and substitute were applicable.
e.g. “”” to “
“&” to &
Another solution is to use <![CDATA[…..]]> for title, abstract and other element with too much textual information.
e.g. <dc:title xml:lang="en"><![CDATA[Peculiarities of the soils in the ”Negrea” catchment basin and their influence on erosion processes]]></dc:title>
It is not mandatory to use a vocabulary, but in order to decide if your records are suitable for AGRIS and to harvest the right sets, AGRIS recommends the use of some form of subject indexing (like AGROVOC thesaurus); it is already sufficient to index the resources with free keywords.
AGRIS highly recommends the use of the Open Archives Initiative - Protocol for Metadata Harvesting (OAI-PMH), a low-barrier mechanism for repository interoperability.
By default OAI-PMH delivers simple DC, but AGRIS recommends developing an additional layer to allow AGRIS to harvest also other metadata formats, like qualified DC or MODS.
It is also recommendable to create a set specification by subject in order for AGRIS to harvest the data related to the AGRIS domain. Please note that it is more useful to have one general subject set in which all topics related to agriculture are gathered together than many specific sets, since each set needs to be harvested separately.
e.g. SetName : Animal production,
SubSet : Animal genetics and breeding
If you comply with these requirements, AGRIS will be able to publish your data.
Otherwise go through the steps indicated down below.
Step 2. Provide the metadata
If your journal is indexed in the Directory of Open Access Journals (DOAJ), it might well be that AGRIS is already indexing your journal. Please check if it appears in the List of DOAJ Journals indexed in AGRIS.
If your journal uses the Open Journal System (OJS), you will be able to export your data directly to AGRIS in different standard formats, such as DOAJ, METS, PubMed XML and other XML formats. For information on exporting from OJS, please visit the Importing and Exporting Data page of the Public Knowledge Project.
If you have a collection of resources which are not described with metadata but still you would like to make them available through AGRIS, you may create them using a tool like AgriMetaMaker (AMM) or Mendeley.
- AGRIMetaMaker is a web form based on the Drupal CMS that allows you to generate metadata as easily as possible since you have asked for an account. You can create new references and enter the information manually in a few minutes. Just fill in as many fields as necessary to describe your document, save the reference and inform the AGRIS processing team to harvest your metadata.
- Mendeley is a free reference manager allowing you to “easily organize your papers, read & annotate your PDFs, collaborate in private or open groups, and securely access your research from everywhere.” At the same time, it can be used to create metadata references for the AGRIS database. Once you export your metadata send them to by an email (a compressed file attachment, containing all the XML files). Here you can download a step by step guide to generate metadata for AGRIS.
If you are not yet using a repository application, but are looking for one, please take note of AgriDrupal and AgriOcean DSpace, two customizations of important open source systems that manage documents (based respectively on Drupal and DSpace). Both systems are OAI-PMH compliant, use AGROVOC for indexing and the AGRIS AP XML format for exporting.
Step 3. Send AGRIS a request
Send a request to firstname.lastname@example.org, by filling the registration form below :
Download the Registration Form.
After the valuation of the new collection in terms of appropriateness of resources and metadata, your request will be forwarded to email@example.com in order to get informed about any doubt or question and to be part also of AGRIS Network via CIARD Ring.
Updates of the metadata
At the end of every month the AGRIS Processing Unit processes and publishes the metadata sent by content providers. In order for the xml files to be indexed at the end of the current month, they must be sent by the 15th of the month.
The harvest of metadata from a OAI-PMH target is done upon notification from the content provider or upon an agreement of monthly, bi –monthly etc harvesting.