Prior to importing collection items, a crucial step will be to map the fields within your Stacks site with the column(s) of data in the .csv file you will be importing. Before we explain how to complete this mapping, lets quickly review the different types of fields that are used:
- Regular Fields
- These are intended to be used for values that describe the item itself and can include Generic fields as described in the Creating a Collection article; some of these fields are also unique
- For example: each item should have a unique title
- These are intended to be used for values that describe the item itself and can include Generic fields as described in the Creating a Collection article; some of these fields are also unique
- Filter Vocabulary Fields
- Filter Vocabulary fields are intended to be used for values that describe a group of items, these fields are often repeatable
- For example, a column that contains different material types could be mapped as a Filter Vocabulary, and many items could be included such as a value like 'White Paper' or 'Poster Board'
- Filter Vocabulary fields are intended to be used for values that describe a group of items, these fields are often repeatable
Manage Import Field Mapping
To complete the field mapping:
- From the Dashboard, click Collections
- Find the collection by
- Browsing the list; or
- Searching the list by collection name
- Once found, under the Operations column, click the drop-down arrow, then click Import
- Click the Import menu tab near the top of the screen, then the Settings tab just below
- Click the menu options on the left to configure the import
- Regular Fields
- Use the drop-down menu and select the corresponding column letter on the .csv file
- Filter Vocabulary Fields
- Use the drop-down menu and select the corresponding column letter on the .csv file
- Note: for any unused fields, leave the drop-down selected as -None
- Use the drop-down menu and select the corresponding column letter on the .csv file
- Link & Button Fields
- Use the drop-down menu and select the corresponding column letter to map the Link & Field buttons
- Note: If you use both links and buttons, adjust the delimiters in Extra settings
- Use the drop-down menu and select the corresponding column letter to map the Link & Field buttons
- File Fields
- Use the drop-down menu and select the corresponding column letter on the .csv file
- Note: these columns should contain only the name of a file that has been previously uploaded to the Stacks site
- Use the drop-down menu and select the corresponding column letter on the .csv file
- Extra Settings
- Configure the delimiters that are used in the .csv file so imported files correctly identify when there are multiple links and terms.
- Delimiters may differ based on the language or region settings of the device used to create the .csv file; Stacks allows you to configure the delimiter of your choice to identify when a filter vocabulary has multiple terms or if there are multiple links or buttons
- Note: You will configure the standard delimiter when importing the .csv file
- Configure the delimiters that are used in the .csv file so imported files correctly identify when there are multiple links and terms.
- Regular Fields
- Click Save Configuration