For contributors

How to contribute to AGRIS?

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.

Otherwise go through the steps indicated down below.


Step 1. Check the requirements

Do your bibliographic references relate to agriculture, forestry, animal husbandry, aquatic sciences & fisheries and human nutrition?
To be sure, just check if your collection fits in one of the AGRIS subject categories. If it is not covered by one of these categories, but you do think it suits AGRIS, please write us at agris@fao.org

Can you provide the metadata?
If you have no metadata yet, 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. 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 export it to your computer. The same data, once delivered to AGRIS, is published in the AGRIS database.

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.
 

  • If you comply with these requirements, AGRIS will be able to publish your data.
    In order though to speed up the publication process significantly, please go through Step 2 and read the recommendations.
     

Step 2. Read the recommendations

Metadata
In principle AGRIS accepts all metadata formats. Still highly recommendable are the following formats/standards: PubMed NLM 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, but also CSV and Excel files are acceptable.

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 to develop 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 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 agris@fao.org, specifying, where applicable:

  • The name and place of your Institution.
  • The name and URL of the journal/repository/database you wish to include in AGRIS.
  • The name of the ILMS, CMS or digital repository system that you use to catalog your references.
  • The topics your collection covers.
  • The type of metadata format and, if available, the schema that you use to export data from your system.
  • The OAI-PHM Base URL of your open repository, specifying if you have any sub-sets.

After a brief evaluation of your request, you will receive an e-mail with the confirmation that your data will be processed and ingested by the AGRIS system.

If you have any questions or doubts, please write us at agris@fao.org.