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 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?

File Transfer Protocol (FTP) is the standard Internet protocol for transmitting files between computers on the Internet. Publishers send metadata files for inclusion in AGRICOLA using FTP 

FTP login utilizes a username and password for granting access to transfer files.

We will first send you a Logon ID which will be completely lower cased.

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:
<message>if salary < 1000 then</message>. To avoid this
error, replace the "<" character with an entity reference:
<message>if salary &lt; 1000 then </message>

What is the process for submitting metadata?

    1. Publisher emails Chief Collection Development Librarian ( indicating its desire to have one of its journals indexed in AGRICOLA and its willingness to contribute metadata.

    The journal is evaluated to determine if it will be accepted for indexing in AGRICOLA. Journal must meet the following criteria:

                      a) Peer-reviewed

                       b) Subject content in scope for AGRICOLA

                       c) Articles must have English language and abstract

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 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.

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 do I need to get started?

An XML Editor is used to create records.

If you have already have access to an XML editor please use it to create records

If not, there are a variety of open-source XML editors. Two noted below are:

A) Komodo Edit

B)  Microsoft XML Notepad 2007      


Subscribe to RSS - General