For contributors

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

Topics covered

To be sure, just check if your collection fits in one of the AGRIS subject categories.

Metadata

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.

XML
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 like the character “&” to “&amp;”. Another solution is to use <![CDATA[…..]]> for title, abstract and other element with too much textual information.

Vocabulary
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; it is already sufficient to index the resources with free keywords.

Please also take note of AgroTagger, a tool that indexes your articles automatically using the AGROVOC thesaurus.

OAI-PMH
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 put then many specific sets, since each set needs to be harvested separately.

You can register as a data provider at Open Archives. The Open Archives Forum Online Tutorial describes in detail the necessary steps to implement the protocols in an Institutional Repository.

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 use 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 agris@fao.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 agris@agroknow.gr in order to get informed about any doubt or question and to be part also of AGRIS Network via CIARD Ring.