On this page:
Managing Field Mappings
The mapping of fields will vary by project and by publishing target type. Regardless of the target type, in order for your project fields to display in the user end-environment, they'll need to be mapped to either a default target field or a custom field. Any fields that aren't mapped won't appear in the end-user environment.
JSTOR Target
To map your project fields:
- In your project, click the Project Settings button.
- Under the Targets tab, select the target collection name, then select Map Project Fields.
- Using the drop-down menus for each project field in the first column, select a project field to map to the target fields in the second column. You can map multiple project fields to the same target field.
- Certain fields have available attributes that can be applied to control the field display label. For example, the "Contributor" target field with the attribute "photographer" applied will display as "Photographer" when published. See JSTOR Target Field List for available attributes and display labels.
- Configure any required fields as needed.
- Repeat until all desired fields are mapped for publishing.
- Select Save to save changes to your project's field mappings.
Customizing display labels in JSTOR
Though project field labels within Forum can be customized, it's not currently possible to customize the display labels of default fields in JSTOR when published.
You can, however, apply available attributes to certain fields (see above) or map fields to Custom Fields.
Artstor Target
To map your project fields:
- In your project, click the Project Settings button.
- Under the Targets tab, select the target collection name, then select Map Project Fields.
- Using the drop-down menus for each project field in the first column, select a project field to map to the target fields in the second column. You can map multiple project fields to the same target field and reorder mapped fields by dragging and dropping them using the handle to the left of the project field name.
- Target fields can be configured to include freeform prefixes before the value when published. For example, you might add the prefix "Photographer:" to the "Creator" field.
- Configure any displayable, searchable, and/or required fields as needed.
- Repeat until all desired fields are mapped for publishing.
- Select Save to save changes to your project's field mappings.
Customizing display labels in Artstor
Though project field labels within Forum can be customized, it's not currently possible to customize the display labels of default fields in Artstor when published.
You can, however, add freeform prefix text to the field value (see above) or map fields to the Custom Field Display option.
Custom Fields
JSTOR Target
Project fields that don't have an appropriate JSTOR target field but should be displayed on the item page can be mapped to the Custom Fields option.
Custom Fields are searchable and the display label when published will use the field's label in Forum.
Artstor Target
If you'd like your fields to display in a specific order in Artstor, you can elect to map your project fields to the Custom Field Display option.
Project fields mapped to this option will display in Artstor in the order they're mapped. Keep in mind that by mapping to these fields, users may not be able to use advanced searching on specific fields in Artstor.
Suggested Field Mappings
After your publishing target is created, you'll need to map your project fields to target fields so users can see your item metadata. To assist in this process, Forum will create suggested mappings that you can save.
JSTOR Target
See the resources below for suggested field mappings when publishing to JSTOR.
- Suggested Mappings for the Visual Resources Template
- Suggested Mappings for the JSTOR Template
- Field-specific Mapping Recommendations
Artstor Target
There are a multitude of ways that fields can map, but Artstor uses 29 standard fields for institutional, public, and personal collection targets. Of those 29 fields, 4 are also used for advanced searching and filtering in these end-user environments, boosting your collection’s discovery among users.
The following tables show the Visual Resources template and Archivision template fields with the suggested mappings for display in Artstor.
Visual Resources Default Fields | Artstor Display Fields |
---|---|
Creator | Map to Creator |
Culture | Map to Culture |
Title | Map to Title |
Image View Description | Map to second line in Title |
Image View Type | Map to third line in Title |
Date | Map to Date |
Artstor Earliest Date1 | Map to Date.Earliest (Does not display in Artstor - used for advanced searching and filtering only) |
Artstor Latest Date | Map to Date.Latest (Does not display in Artstor - used for advanced searching and filtering only) |
Style/Period | Map to Style_Period |
Materials/Techniques | Map to Material |
Measurements | Map to Measurement |
Artstor Classification | Map to ArtstorBrowseClass (Does not display in Artstor - used for sorting and searching only) |
Work Type | Map to Type |
Repository | Map to Location.Current_Repository |
Repository Accession Number | Map to ID_Number.Current_Repository |
Location | Map to Location |
Creation/Discovery Site | Map to Location prefix with "Creation Site:" |
Latitude | Map to Location prefix with"Latitude: " |
Longitude | Map to Location prefix with"Longitude: " |
Elevation | Map to Location prefix with "Alt:" |
Artstor Country | Map to Artstor Browse Geography (Does not display in Artstor - used for advanced searching and filtering only) |
Description | Map to Description |
Subject | Map to Subject |
Relationships | Map to Related item |
Source | Map to Source |
Image Date | Map to second line of Date prefix with "Image: " |
ID Number | Map to ID_Number |
Rights | Map to Rights |
Archivision Default Fields | Artstor Display Fields |
---|---|
Agent_Display | Map to Creator |
Work_Culture | Map to Culture |
Work_PrefTitle | Map to first line in Title |
Work_AltTitle | Map to second line in Title |
Image_Title | Map to third line in Title |
Work_Classification | Map to first line in Type |
Work_WorktypeDisplay | Map to second line in Type |
Artstor Classification | Map to ArtstorBrowseClass (Does not display in Artstor - used for sorting and searching only) |
Work_StylePeriodDisplay | Map to Style_Period |
Work_DateDisplay | Map to Date |
Image_Date | Map to second line in Date prefix with "Image: " |
Work_EarliestDate1 | Map to Date.Earliest (Does not display in Artstor - used for advanced searching and filtering only) |
Work_LatestDate1 | Map to Date.Latest (Does not display in Artstor - used for advanced searching and filtering only) |
Artstor Country | Map to Artstor Browse Geography (Does not display in Artstor - used for advanced searching and filtering only) |
Work_LocationDisplay | Map to first line in Location |
Work_LocationType | Map to second line in Location |
Work_LocationNotes | Map to third line in Location |
GPS | Map to fourth line in Location |
Work_MaterialDisplay | Map to first line in Material |
Work_Technique | Map to second line in Material |
Work_MeasurementDisplay | Map to Measurement |
Work_Description | Map to first line in Description |
Work_InscriptionDisplay | Map to second line in Description |
Image_Description | Map to third line in Description |
Work_SubjectDisplay | Map to Subject |
Image_SubjectDisplay | Map to second line in Subject |
Image_Rights | Map to Rights |
Work_DescriptionSource | Map to Source |
Image_Source | Map to second line in Source |
Image_OriginalVendorID | ID_Number |
Work_RelatedWork1 | Map to Relation |
RelationType1 | Map to second line in Relation |
Work_RelatedWork2 | Map to third line in Relation |
RelationType2 | Map to fourth line in Relation |
Image_Filename | Map to Custom Field |
LocalCollection | Map to Custom Field |
Artstor Facets
Of the 29 target fields available in the map, 4 of those fields are used in the advanced search and filtering options in Artstor. It is important that the Artstor Classification, Country, Earliest Date, and Latest Date fields are mapped to the correct target fields to enable these functionalities.
If you do not have these fields enabled for your project, follow the instructions to add or fields to your project and use the below configuration for these fields.
Project Field | Configuration | Publishing Target Mapping |
---|---|---|
Artstor Country | List field connected to the Artstor Country community list. | Mapped to ARTstorBrowseGeography |
Artstor Classification | List field connected to Artstor Classification community list. | Mapped to ARTstorBrowseClass |
Artstor Earliest Date | Number field (with YYYY values or YYYYMMDD values) | Mapped to Date.Earliest |
Artstor Latest Date | Number field (with YYYY values or YYYYMMDD values) | Mapped to Date.Latest |