Skip to main content
MediaBeacon University

Feeds

RSS_Manager.png

Configuration

  • Feeds Subpanel: This area lists all current feeds, and has controls at the bottom of the list.
  • Add: Add a new feed.
  • Delete: Delete the currently-selected feed.
  • Add feed as widget: this button automatically adds a pre-configured Syndication widget to the current layout, that displays the contents of the selected feed.
  • Clear: This button will reset the contents of the currently-selected field, deleting all previous entries.

Feed Options Subpanel:

Feed URL

This is an auto-generated feed URL that appears once the feed has been successfully saved.

Feed Basics

  • Feed name: This string is the name of the feed that will be displayed in all RSS aggregators.
  • Feed active: This option controls whether a feed is active or not. When inactive, no new queries or additions to the feed are made.

Source

The source defines the set of assets that the RSS watches for Events.

  • Directory: Choose a directory in your current ACL.
  • Selection: Choose a Saved Selection.

Metadata Filters

Further filters assets within either of the above source choices by one or more metadata value criteria.

Events

Events drive the RSS system in MediaBeacon. The system detects when changes occur to a Source asset in any of four categories. The RSS feed needs to watch for one or more of the following events.

  • Metadata: Any change to a metadata value.
  • File Changes: An asset is changed in the file system.
  • Comments: Changes made to an asset's Discussion metadata.
  • New File: An asset is added to the Source.
  • Download File: An asset is downloaded.

Custom title

  • A metadata field may be chosen to provide a custom per-asset title for a given feed entry.

Data to include

Included with the feed, these blocks of data may be added to each feed entry.

  • All data: All of the below are shown.
  • Logging: When checked, this option will show the before and after state of any value changed.
  • Show link: This option generates a "Go to asset" link.
  • Show event: This block shows the before and after states of metadata values for a given feed entry.
  • Comments: Adds comment information to the feed entry.
  • Show preview: This block adds a small preview icon of the asset to the feed entry.

Metadata Fields to display

One or more metadata fields may be displayed with the feed entry.

Asset Feed

  • Allow Full Access: This checkbox will allow an RSS feed to be used as an asset feed on a remote MediaBeacon server. For more information, see the next section.

Asset Feed Configuration

Asset feeds are a powerful way of sharing and searching assets between different MediaBeacon servers using RSS. If a group of assets on one MediaBeacon server needs to be available on another MediaBeacon server (or more than one), an administrator can simply create an RSS feed with the desired assets and attach it to a folder on the second MediaBeacon server. This creates a group of mirrored, searchable assets on the second server which can be either placeholders or originals depending on the use case.

Configure Asset Feed RSS

Asset feeds require at least two separate MediaBeacon servers, each with its own license.

  1. Start on the server that hosts the assets that will be shared. Create an RSS feed with these assets (see previous section on "Manage RSS Feeds").
  2. Be sure that "Allow Full Access" is checked. This allows an RSS feed to be used as an asset feed.

    Asset_Feed_0.2.PNG

  3. Switch to a second MediaBeacon server that will accept the incoming asset feed. Choose a directory to store the remote assets and pick "Attach Asset Feed" from the Directory Browser's contextual menu.

    Asset_Feed_1.png

  4. Enter the address of the MediaBeacon server from Step 1 and login as a user with RSS privileges. Click "Connect."

    Asset_Feed_2.png

  5. When login is successful, MediaBeacon will display options for choosing and configuring the asset feed.

    Asset_Feed_3.png

    Choose Source Feed Options

    • Select Source Feed: Choose the feed from Step 1 in this menu.
    • Incoming Feed Name: Enter a name for the asset feed.
    • Feed Sync Type: Choose how to display assets from the host server. "Preserve Remote Paths" will replicate the folder structure that contains the original assets.
    • Remote Only: Assets will appear as .xmprf proxy files. These proxies have the same metadata and thumbnails as the original assets. However, downloads will always pull down the original asset.
    • Local On Demand: Assets will appear as .xmprf proxy files, but with the additional option of fetching the original asset from the host server. This option appears as a badge when the asset is highlighted.
    • Local: Assets will be copies of the originals on the host server.
    • Preserve Remote Paths: Assets will retain the folder structure of the host server.
    • Use Feed Name in Path: This option will include the feed name as part of the path.
    • Retain assets after they have been deleted from source: By default, assets will be deleted from the feed when they're deleted from the host server. This option retains assets, even when the originals have been deleted.
    • Destination Directory: Click "Choose" to pick a different directory for the remote assets if desired.
  6. Click "Connect" to establish the asset feed. The remote assets from the host system will now display on the second MediaBeacon system with fully-searchable metadata. If metadata changes are made to the assets on the host system, they will propagate through the asset feed in approximately two minutes.
  7. For a "Local On Demand" asset feed, a copy of the original asset can be retrieved by highlighting a placeholder asset and clicking "Fetch Asset."

    Asset_Feed_4.png

  8. To go back to the placeholder version, highlight the retrieved asset and click "Purge Asset."

Asset_Feed_5.png

Editing/Removing Asset Feeds

  • To edit an asset feed, choose "Feeds" from the "Manage" menu on the secondary MediaBeacon system. Here administrators can edit the feed name, the host address, the destination directory, and the feed type.

Asset_Feed_6.png

  • Feed Status: This displays the last time MediaBeacon attempted to sync metadata with the feed's host system and whether or not it was successful.
  • Purge Retrieved Assets: If the feed is "Local On Demand," this button will purge all retrieved copies of original assets and replace them with .xmprf placeholders. The original assets on the host server will not be affected.
  • To delete an asset feed, simply select it in the RSS Manager and click "Delete" in the lower left-hand corner of the window.
  • Was this article helpful?