Types of Fields and Suggested Use
Text and Text Area fields are free-text so catalogers may enter any type of information. To remove a value from a text or text area, use the delete/backspace keys to delete the value. For text area fields, use the pipe symbol | to create line breaks in the published environment.
Number fields only accept numeric values, and are often limited to dates in the form of years. To apply BCE dates, enter a negative symbol (-) before the date. When filtering by number fields, you may use numeric values along with (>) greater than, (<) less than, or (=) equal to symbols.
Alphanumeric fields support alphabetic and numeric characters, such as accession numbers. When filtering by alphanumeric fields, you can use greater than or equal to ( ≥), less than or equal to (≤), and/or equal to (=) symbols. Please note that filtering in this field will disregard special characters and spaces.
A date field is indicated by the calendar icon. By default, the format of the field is dd/mm/yyyy.
Using the Date field
From within the field, click the calendar icon to display the calendar. Select a day from the calendar, or navigate forward/backward through months using the arrows in the upper left and right of the calendar. Clicking on the button marked “Today” will enter the current date into the field.
In the edit tab, text boxes with a lookup icon can be a List or Linked field. Clicking the icon will open either a consult window for linking authorities, or it will open a list of controlled terms for searching and selecting. If the field has a lookup icon but does not have a text box, this is a list field.
Using the List field
In the edit tab, find a field with a lookup icon but no text box, and click the icon to open the list window. A search bar at the top of the window is available to search for terms. You may search the list of terms using a wildcard, such as an asterisk*, but predictive searching is not available (e.g. when searching for “regal”, typing “reg” will not return results). In the list of results, double-click a term to link it to the record. OR hold shift, control, or command to select multiple terms and click the Link button at the bottom of the window. To remove terms from the field, click the ‘X’ within the term box in the field.
Linked fields can be linked to an internal or external vocabulary source, and are indicated by the lookup icon at the beginning of the text box. Shared Shelf integrates with three Getty vocabularies: Union List of Artist Names (referred to as Shared Shelf Names), Art and Architecture Thesaurus, and Thesaurus of Geographic Names.
Using Linked Fields
- Locate a field with the book icon in the corner, then click the icon to open a consult window. If the field is linked to multiple vocabularies, clicking the icon will show a selection list. Choose a vocabulary from the list to open a consult window where you can search for your desired term.
- Enter your search term then click Enter. For externally linked authorities, you will need to copy/paste or type in your term and identifier from the source, then choose a linking option.
- When selecting a value to populate a linked field, you will have the following options:
- Link Only: The term will appear below the field as a linked item. No terms will appear as display text for that field.
- Link & Append: the term will be added to existing data within the field.
- Link & Overwrite: the term will replace any existing data within the field.
Referred to as Boolean (Checkbox) in the Administrative Tools, this field applies a True, False, or null value (N/A). The field defaults as a null value, which is shown as a blue box. Clicking inside the box will mark the field as False, shown as empty. Click again to mark the field as True, shown as a checkmark.
In every field template, there are four Artstor-specific fields that you are always recommended to include in your project: Earliest Date, Latest Date, Artstor Classification, and Country. These fields have been made available by Artstor to your projects for using the faceted searching and browsing functionality in the Artstor Workspace and Shared Shelf Commons publishing environments as Artstor Workspace. When configuring your publishing target, these fields need to be mapped to specific target fields for the faceting option to be applied.
- Earlist Date -> Earliest Date
- Latest Date -> Latest Date
- Artstor Classifcation -> ArtstorBrowseClass
- Country -> ArtstorBrowseGeography
Note that the fields, as mapped, are set by default to be “Displayable = true,” but they do not display in the Artstor Workspace or Shared Shelf Commons, regardless of this setting. These fields are meant to work entirely behind the scenes to aid the discovery of content. Once your records are cataloged and published, users can access them via the browse by Classification or browse by Geography functionality, or apply filters and facets in the advanced search and results pages.
For more information about these and the other 42 Artstor-supplied lists that are available at your option, please see Shared Shelf Lists at a Glance.
Using Artstor-Specific Fields
Data for these fields must conform to the field properties (either a numeric value or a value chosen from a controlled list).
The two recommended list fields are:
Term used to categorize a work by grouping it together with other works on the basis of similar characteristics, including materials, form, shape, function, etc. The 16 terms accepted by Artstor include:
- Architecture and City Planning
- Decorative Arts, Utilitarian Objects and Interior Design
- Drawings and Watercolors
- Fashion, Costume and Jewelry
- Film, Audio, Video, and Digital Art
- Garden and Landscape
- Graphic Design and Illustration
- Humanities and Social Sciences
- Manuscripts and Manuscript Illuminations
- Maps, Charts and Graphs
- Performing Arts (including Performance Art)
- Science, Technology and Industry
- Sculpture and Installations
A type of “nationality” field, though not in adjectival form; country refers to the modern name of the country, geographic region, or inhabited place from which the artist came. A list of those terms accepted by Artstor can be accessed by downloading the list of terms from Shared Shelf.
To download the list of Artstor Country terms:
- Log into Shared Shelf, and navigate to the “Controlled Lists” tab.
- In the list panel on the left, select the “Artstor Country” list name.
- Click the gear menu in the right corner above the term panel and select Excel > Export all terms.
- The Excel spreadsheet includes such data as the Term ID, Level (“Community” terms are provided by Artstor, “Local” terms have been added by users at your institution), Name of the term, and additional information, such as Source, Data Date, Description, Notes, and Active status.
Since Artstor needs to determine a single date for chronological placement, it calculates the average between earliest and latest date and uses the result as the sorting or searching value. Below, you will find some best practice guidelines from our metadata staff for generating earliest and latest date values.
- Both of these date fields must be completed in order for your Shared Shelf assets to appear in a filtered search in the Artstor Workspace or Shared Shelf Commons.
- In the earliest and latest date fields, use the hyphen or negative sign (“-“) to indicate a BCE date. For example, -1000 results in 1000 BCE.
- For a known work date in a single year, eg. 1963: earliest date 1963, latest date 1963.
- For circa dates in a single year, eg. ca 1963: earliest date 1963, latest date 1963.
- If there is a date range, you should provide both dates, eg. 1963-66: earliest date 1963, latest date
Auto-generated fields contain data that is created by actions performed within the system. These fields appear on the projects page in Shared Shelf. They are automatically created and are non-editable. They are not searchable in the ARTstor Digital Library but can be searched and sorted in your Shared Shelf project:
* SSID: Shared Shelf Identification Number
* Filename: Image filename
* Created by: User who created the record
* Created on: Date the record was created
* Updated on: Date the record was last updated
* Updated by: User who last updated or modified the record
Each time a new record is created, default values can be used to auto-populate certain fields. Fields will be populated with default values when creating new records through:
- using the gear menu in the asset panel
- uploading a new media file
- creating a new record during an Excel import with the SSID entered as NEW and the field left blank
The default behavior for fields are to always be editable. However, administrators can set up read-only fields in the cataloging screen so that different fields or entire screens may be rendered as read-only for different catalogers. Read-only fields appear gray in the cataloging screen and cannot be edited. When a cataloger is uploading Excel spreadsheets to create new or modify existing records, any fields that are read-only in their cataloging screens will not accept new or modified data. It is recommended that at least administrators have access to a full screen of editable fields in order to prevent missing data.
Whether publishing a single record or multiple records in bulk, if data is missing from a required field, the publish request will not be accepted. The system will provide a list of SSIDs for the cataloger to find and edit the records with the appropriate data before publishing. Always be sure to let your catalogers know which fields are required for publishing when establishing workflows. One suggestion is you could add an asterisk * to the field label to indicate a required field when editing a cataloging screen.
Shared Shelf supports the input and display of any character set. However, the search and retrieval of these characters is not yet resolved but will be in a future release.
Special characters to use in cataloging:
Shared Shelf has no limit on the number of characters that can be saved in any field type. However, there are limitations in other programs for importing and exporting data with Excel, and in publishing to the Artstor Workspace and Shared Shelf Commons.