Configuring OpenURL Mapping and Destinations

This field has a default value of Default. Currently this is the only value
accepted. If you wanted to have separate mappings available based on the
version of OpenURL being used, you could force that to happen by adding
entries for a specific OpenURL Version. With the flexibility of the
OpenURLFieldValue field below, this functionality isn't used in the default
setup. You should rarely if ever need to change the value for this field from
Default, but an example of the value for OpenURL version 1.0 would be
"Z39.88-2004". The value is one that's passed from the source database
through OpenURL and may vary.

This field has a default value of Default and rarely should need to be
changed. If you wanted to have separate mappings available based on the
source of the OpenURL link, you could choose to set that up here. For
example, if you want the default request that comes in from FirstSearch
without a Genre to be a Book, and you want the default request that comes
in from Ovid without a Genre to be an article, you can set different rfr_id
settings for each one.

Note: If you decide to specify an rfr_id value for a particular source and
AresFieldName, you will also need to specify a corresponding URL_Ver
value. In addition, if you specify one rfr_id value for a particular source
and AresFieldName, you must also specify that same rfr_id for all other
AresFieldNames in the table. This value is one that your OpenURL source
provider can help you find, should you need to make this change. An
example of the value from FirstSearch: info:sid/firstsearch.oclc.org:
WorldCat. This value also gets stored in the CitedIn field in Ares if it is
passed over OpenURL (with the info:sid/ part removed).

Converting a URL to an Ares item

The AresAction field can have 3 values: Replace, Substitute:genre and
Substitute:rft.genre.

• Replace. This field corresponds to the Ares field to store the OpenURL
  information that is sent via the OpenURL link. The Ares field represented
  in the AresFieldName field is replaced with the data from the
  OpenURLFieldValues field. For example, if the AresFieldName is set
  to Edition, the OpenURLFieldValues is set to <#rft.edition>.
• Substitute:genre. The only valid AresFieldName is RequestType. This is
  used to set the RequestType and the request form to use in Ares. The
  OpenURLFieldValues field equates to the genre returned by OpenURL
  (article, book, conference). This field can also have the value of default,
  which matches any genre not specifically listed. The AresValue field has
  two parts separated by colons: RequestType:HTMLRequestPageToUse. 
• Substitute:rft.genre. This tag does the same thing as the prior Substitute:
  genre tag, but is used for OpenURL version 1.0. It is recommended that if
  you add a new genre, you add entries for both Substitute:genre and
  Substitute:rft.genre.

Building a URL from an Ares item

The AresAction field can have 3 values: ReverseSubstitute:genre,
ReverseSubstitute:Format, and ReverseReplace.

• ReverseSubstitute:genre.  This action maps an item's ItemFormat field
  to an OpenURL genre. By default, mapping for the item formats article,
  book and bookchapter are supported. The Submit via OpenURL button
  in the client is enabled only if an item's ItemFormat is one of the values
  in this table.
• ReverseSubstitute:Format. Using the OpenURL genre, Ares then looks
  at the entries in this action to determine which fields from an item should
  be included in the OpenURL request.
• ReverseReplace: Ares uses these entries to map the ReverseSubstitute:
  Format item fields to their OpenURL equivalents.

The Field name that will be populated by the values from the
OpenURLFieldValues field.

For AresAction = Replace. This field has tags that are replaced with
OpenURL information from the OpenURL link. Tags are in the format
<#tagname>. Other text is allowed, so in the case of an Author's Name, you can separate the last name and first name with a comma and a space.
Finally, you can have separate OpenURL values assigned to the same Ares
field. This is useful for handling different OpenURL mappings that end up going to the same Ares fields. You can separate these values with a pipe character (|). When Ares sees the pipe, it interprets everything up to that point in the expression. If if it has no values for the OpenURL fields up to that point in the expression, then it continues and uses the next expression.
If it already has a value, then it ignores everything after the pipe. You can
have as many pipe/field value combinations as you need.

Some examples:

• This example uses Author field name. The FieldValue has 3 parts. If the
  first part, <#rtf.au>, has a value, then that is what is sent back to Ares. If
  not, then Ares looks at the second part: <#rft.aulast>, <#rft.aufirst>
  <#rft.auinitm>. If any part of that has a value, then it is used. If not, then
  Ares uses the last expression: <#aulast>, <#aufirst> <#auinitm>.
• Another example of how Ares handles both the old and new OpenURL
  versions together is PubDate. If Ares sees the new tag, <#rft.date> then it
  uses that, if not, it uses <#rft.date>|<#date>.

In either case, if none of the OpenURL values are returned, then Ares puts
no value into the field.

For AresAction = Substitute:genre or Substitute:rft.genre. The
AresFieldName is equal to the OpenURL genre field (article, book, book
item, etc.). This can also be a value of "default" which will be the default genre.

This actually includes two values, separated by colons and only used with
AresAction = Substitute:genre or Substitute:rft:genre. The first value is
the Ares RequestType: serial or monograph. The second value is the Ares
HTML page for OpenURL to use for that genre (IRFOpenURLArticle.html,
IRFOPenURLBook.html).

The name of the external system.

The OpenURL formatted URL for the external system.

The status queue that the Ares Item request should move to when
the request is sent to the external system.