Skip to main content
MediaBeacon University

Configuring the List Component

This article details preparing the list component for Import/Export Wizard use.

Several areas of MediaBeacon need to be configured in order to use these functions, requiring a Global Administrator account. However, using the configured List component does not require this and may be performed by General User accounts.

  • List Configuration dialog > List View Options:
    • Enable Import, Enable Export, Enable Bulk Select: Each enables the respective button on the List component.
    • Width: Adjust the width available for column headings. See "Adjusting Width" below.
  • Column Headings
    • Configured in the List component itself, when in admin mode.
  • Admin Core > Fields
    • Rarely, some fields may require SQL index to be enabled, but this is not necessary or desirable in most cases.

Configuring Column Headings

The column header order determines the order for imported and exported metadata. For example, a List View component so configured can import or export a data file as shown below.

Global Administrators may configure column headings when in "Admin Mode" by clicking the circle-plus icon to the left of a List component's column heading bar.

  • Select a field: Choose a specific field to add to the "Fields to Display" section.
  • Select a Metaform: Choose a metaform to add all the field in that metaform to the "Fields to Display" section.
  • Fields to Display: This list defines which column headers are shown. The top-down field list corresponds to left-right column arrangement.
    • Rearrange Fields: Click-drag the rearrange handle (= icon) to the desired position
    • Delete Fields: Click the "X" button.

The field options (visible by clicking the name of a field in the "Fields to Display" list), and "Apply Sort Order" settings are not important to adjust for Import/Export wizard configuration.

Choosing a Key Field

When performing Imports (and to a lesser extent, Bulk Selects) with the wizard, it's important to keep in mind what pre-existing metadata in MediaBeacon will be used to associate a given line of data in the import file with a given asset. This is usually done using a single field (although multiples can be used) that contains information that can uniquely identify an asset.

This is referred to as the "key field". When arranging column headers, MediaBeacon assumes that the leftmost column is used for this function.This can be changed on-the-fly during import, but it is considered best practice to assume this to be the case.

Below are some fields that are often used as key fields for metadata Imports:

File Name

Assets that are not in the same directory within MediaBeacon may have the same file name. For this reason, using "File Name" as the Key Field is not recommended, unless all assets in the installation (or set of assets being acted upon) are certain to have unique names.

Record ID

This number (aka Asset ID) is assigned to assets automatically by MediaBeacon and is unique, but is only assigned to assets when ingested. Therefore, a pre-existing metadata source would not have this identifier. This approach to file matching is recommended when metadata is exported from MediaBeacon, altered and then re-imported.

Long Name (File Path)

This is often recommended for initial ingest of metadata to assets that are new to a MediaBeacon installation. Using this field requires that the import file contain file paths of assets on previous storage, and that those file paths for assets have remained minimally changed. In the following example, only the ending part of the file path has changed.

  • Example Original Filesystem Path
    N:\\Asset Store\WIP\2016\Anycorp\Logos\Draft Wunderkind
  • Example MediaBeacon Filesytem Path
    C:\Users\Administrator\MBAssets\WIP\2016\Anycorp\Logos\Draft Wunderkind

This auto-generated field displays the folder path of an asset relative to the current ACL's root directory. This can be seen in the General tab, in the asset view, under "Path". Note that the prefix "Index/" is not included in the Long Name value.

To use this information to identify assets by a partial path, the import file may need to be altered to comply with this formatting.

  1. Remove the unique (first) part of the path, ideally representing the highest-level directory moved into MediaBeacon.
  2. Remove the preceding slash.
  3. Replace backslashes with forward slashes.


  • Example Original Path (HFS)
    Work HD/Users/emmettbrown/Archive/Biological Taxonomy/Domestic_Cat_White.jpg
  • Example Path on MediaBeacon's file store (NTFS)
    C:\Users\Administrator\MBAssets\Archive\Biological Taxonomy\Domestic_Cat_White.jpg
  • Example Path in MediaBeacon's "Long Name" field
    Archive/Biological Taxonomy/Domestic_Cat_White.jpg
  • Modified Path in Import File
    Archive/Biological Taxonomy/Domestic_Cat_White.jpg

Adjusting Width

If a large number of column headers are present, and the interface cannot display them  given the size of the browser window, it may be useful to change the "Width" setting, located in the List Configuration dialog. This sets the List component to a fixed width of pixels, which will scroll horizontally.

  • Was this article helpful?