What are AGRICOLA’s metadata requirements?

All metadata must be “well-formed” and “validated” against an XML schema or DTD (Document Type Definition).

Well formed XML has all metadata tags opened and closed in the proper order and has a declaration (DTD or XML schema) at the top of the file of records, with the proper attributes.

The purpose of a DTD (Document Type Declaration) or XML Schema is to define the building blocks of an XML document with a list of elements and attributes.

How do I send metadata to NAL?

Metadata files are sent to NAL using a File Transfer Protocol (FTP).

FTP is a standard Internet protocol for transmitting files between computers on the Internet. Like the Hypertext Transfer Protocol (HTTP), which transfers displayable Web pages and related files, and the Simple Mail Transfer Protocol (SMTP), which transfers e-mail, FTP is an application protocol that uses the Internet's TCP/IP protocols. FTP is commonly used to transfer files from your computer to other servers.

How are entity references coded (symbols that need to be converted to codes)?

Some characters have a special meaning in XML.

If a “less than”( "<" ) character is placed inside an XML element, it will generate an error because the metadata parser interprets it as the start of a new element. 

 It will generate an XML error:
<abstract> if salary < 1000 then </abstract>.

To avoid this error, replace the "<" character with an entity reference:

<abstract> if salary &lt; 1000 then </abstract>

There are 5 predefined symbols that need to be converted to codes:

What are the XML Schema or DTD declarations for each format?

A schema or DTD (Document Type Definition) describes the structure of an XML record as well as the
relationship of the elements to the application. It must appear at the
beginning of the first record of a file of records, or at the beginning of each record if a file contains only
one record. Records without a schema or DTD will be rejected.

Below are the schema and DTDs for the three metadata formats that can be employed on AGRICOLA metadata records.  

What is the process for journal review and metadata submission?

    1. Publisher emails Chief Collection Development Librarian (  requesting to have its journal indexed in AGRICOLA.  Publisher also indicates in email a willingness to contribute metadata as described in this FAQ.

    2. Journal is evaluated for indexing acceptance in AGRICOLA.  Evaluation criteria includes subject scope of the journal’s content and overall quality of the journal.  All journals must be peer-reviewed, and contain English language titles and abstracts..

What metadata formats will be accepted?

Publishers have the option of submitting metadata in one of the three formats noted below. The “preferred” format is MODS, unless the publisher has already created records in JATS or NLM DTD.  MODS records require the least amount of preprocessing by NAL staff and will be available in AGRICOLA more rapidly than those in either or JATS or the NLM DTD.   Templates and sample records are provided in attachments below.

What is metadata?

Metadata is usually defined as “data about data”.

In terms of AGRICOLA, metadata is structured data that contains basic citation information about each article (e.g. author(s), article title, abstract, journal title, volume/issue number and date). The structured nature of metadata allows it to be  ingested, processed and displayed in AGRICOLA in a consistent manner.


Subscribe to RSS - General