Ares WorldCat Local Addon (WebView2 & Chromium)
- Andrew Morgan
- Brittany de Gail
In Ares 5.0.9+ the addon will use the WebView2 embedded browser, while lower versions will use the Chromium embedded browser.
WorldCat will perform a security check based on your machine's IP address when using this addon to access individual records. You may experience issues accessing these records if your IP address fails the security check.
Name | WorldCat Local |
|---|---|
Version | 1.5.3 |
Author | Atlas Systems, Inc. |
Description | The WorldCat Local Search Addon allows you to search Serials and Monographs using a variety of criteria (title, ISSN, OCLC, etc.) and automatically shows search results. |
This addon is available for developers to modify and extend. Developers are encouraged to submit changes to this addon by forking the git repository from GitHub and creating a pull request.
Download
Release Notes
v1.5.3:
Added support for importing bibliographic information from the WorldCat record into Ares. For more information, see Using this Addon below.
Configuration
Addon settings are configured in the Manage Addons form. WorldCat Local Search performs a WorldCat search using the request title, ISxN or OCLC number.
WorldCat Local Search is Not Active by default. To hide the tab on your Request form, select No and Save Settings.
Name | Default | Type | Description |
|---|---|---|---|
AutoSearch | True | Boolean | Defines whether the search should be automatically performed when the form opens. |
WorldCatURL | String | The URL for WorldCat Local. Do not include a trailing slash. | |
SearchPriority | Title,ISxN,OCLC | String | Defines what order priority should be used when attempting to find a field to search by when using the auto search feature. Allowed fields are title, isxn and oclc. |
Using this Addon
To use the WorldCat Local Search Addon, click the WorldCat Local Search tab on the request form.
If WorldCat Local has been set to search automatically, it will search using the available fields, and open to a list of search results.
Click on the item in WorldCat Local you want to select to bring up that item page.
If the search is not set to start automatically, you will see a blank page instead of a list of WorldCat Local Search results.
Start the search by clicking the Search Title, Search ISxN or Search OCLC button on the WorldCat Local ribbon.
When on a record page, click the Import button to import bibliographic information from WorldCat. The fields this information is imported to are configurable in the DataMapping.lua file.
Use the Back, Forward, Stop and Refresh buttons in the WorldCat Local ribbon to move between pages, refresh pages and stop loading a page.
Data Mappings
Below are the default configurations for the WorldCat Local addon when used with Ares. The mappings within DataMappings.lua are settings that typically do not have to be modified from site to site. However, these data mappings can be changed to customize the fields used to perform the WorldCat search and the fields used to import citation information into Ares from the WorldCat record.
Source Fields for Searching
The SourceFields mappings control the Ares fields that are read by the addon and used to perform the auto search. To modify the Ares field that is read and used for each search type, the field name in the Source Field column should be changed to the database name for the new field.
Default Configuration
Search Type | Source Field |
|---|---|
DataMapping.SourceFields["Title"] | “Title” |
DataMapping.SourceFields["Isxn"] | “ISXN” |
DataMapping.SourceFields["OclcNumber"] | “ESPNumber” |
Bibliographic Import Fields
The ImportFields mappings control the Ares fields into which the WorldCat record information will be imported when the addon is used to perform a citation data import. To modify the Ares field used, the field name in the Import Field column should be changed to the database name for the new field.
Default Configuration
Citation Data | Import Field |
|---|---|
DataMapping.ImportFields["Title"] | “Title” |
DataMapping.ImportFields["Isxn"] | “ISXN” |
DataMapping.ImportFields["Author"] | “Author” |
DataMapping.ImportFields["Publisher"] | “Publisher” |
DataMapping.ImportFields["PublicationPlace"] | “PubPlace” |
DataMapping.ImportFields["PublicationDate"] | “PubDate” |
DataMapping.ImportFields["OclcNumber"] | “ESPNumber” |