Skip to content
Arc XP
Product Documentation

Setting Up MRSS Feed with Outbound Feeds

Feed Setup

The MRSS feed is a platform level Arc feed block with configurable and customizable parameters.

Steps to configure the Media RSS feed.

Channel Configuration

1. RSS Title

Value for RSS title.

default: feedTitle environment value

2. RSS Description

Value for RSS description.

default: feedTitle + " News Feed"

3. RSS Language

Value for RSS language using an ISO-639 value. If left blank it will default to the value of feedLanguage set in your blocks.json. The tag can be removed by entering ā€œExcludeā€ in the field.

default: blank (uses feedLanguage)

4. Logo URL

Optional fully qualified URL of an image to use as the logo for the RSS feed.

default: no logo

Item Configuration

1. Title

ANS field(s) to use for the article headline, supports a JMESPath statement.

default: headlines.basic

2. Description

ANS field(s) to use for the article description, supports a JMESPath statement.

default: description.basic

3. Publication Date

ANS date field to display.

Select one: created_date, display_date, first_publish_date, last_updated_date, or publish_date

default: display_date

1. Include promo Images

Yes/No should the promo_items be added to media:content.

default: true

2. Image height and or width

A set of key value pairs where you can set an integer height and or width to resize all images. Zero means no resizing will be performed.

default: height: 0, width: 0

3. ANS image title key

ANS field for the promo_items title.

default: title

4. ANS image caption key

ANS field for the promo_items caption.

default: caption

5. ANS image credits key

ANS field for the promo_items credits.

default: credits.by[].name

Video

1. Select Video Using Key/Value Pairs

Criteria to be used to match a video encoding.

default: { bitrate: 5400, stream_type: ā€˜mp4ā€™ }

Resolver Configuration

Each feed template needs to have a resolver applied. To Create A Resolver, youā€™ll want to configure these fields.

1. Resolver Name

Unique name given to the resolver

2. Resolver Priority

Number to indicate priority order regex will be evaluated in (1 to 100). Lower numbers are evaluated first.

3. Regex Pattern

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

4. URL Parameters

5. Websites

all

6. Content Source

feeds-content-api

There are also two optional content sources available out-of-the-box, details here.

7. Patterns

These positions come from the regex pattern. There are a number of ways to pass a section (or author, keyword or tag) to the content source from the resolver. All of them use a grouping () in the regex.

Section - Pattern 1

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Author - Pattern 2

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Keywords - Pattern 3

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Tags - Text - Pattern 4

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Tags - Slug - Pattern 5

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Include - Terms

    [{"term":{"type":"video"}},{"range":{"publish_date":{"gte":"now-2d","lte":"now"}}}]

We need to modify the default query so it will only return videos. The date you selected to display for Last Updated Date should also be used in the query. More details on custom queries can be found Here.

Exclude - Terms

If you need to exclude terms in your query, i.e. NOT, enter them here as an array formatted the same as the Include-Terms. For example to exclude all content with language ā€œesā€ you would use [{ā€œtermā€:{ā€œlanguageā€: ā€œesā€}}]. More details on custom queries can be found here.

Exclude - Sections

You can enter a comma separated list of sections to exclude. For example /premium,/paid-content.

Feed - Size

Integer 1 to 100. Defaults to 100. If you added a size URL parameter, select the parameter option and select size and enter a default value.

Feed - Offset

Integer. Defaults to 0. If you added a from URL parameter, select the parameter option and select from and enter a default value.

Sort - publish_date:desc

If left blank it will default to publish_date:desc. Which ever date field you selected to display for the Last Modified Date is the date you should enter here. The format is date_field + : + sort order (desc or asc). Valid date fields are created_date, display_date, first_publish_date, last_updated_date, or publish_date.

Source-Exclude - A comma separated list of ANS fields to remove from the default list of ANS fields. See the default list here.

Source-Include - A comma separated list of ANS fields to add to the default list of ANS fields. See the default list here.

Include - Distributor - Name

If you only want content from a single distributor, enter the name here. You may only populate one distributor field.

Exclude - Distributor - Name

If you want to exclude content from a single distributor, enter the name here. You may only populate one distributor field.

Include - Distributor - Category

If you only want content from a single distributor category, enter the name here. You may only populate one distributor field.

Exclude - Distributor - Category

If you want to exclude content from a single distributor category, enter the name here. You may only populate one distributor field.

8. Default Template

Select the template you just created mrss-feed to use with this resolver.

9. Default output type

Select xml.

10. Content Mapped Template

blank

Media RSS URL

To preview your MRSS XML, modify the URL below with your client org and website name.

https://outboundfeeds.CLIENTORG.arcpublishing.com/pf/arc/outboundfeeds/mrss/?_website=CLIENTWEBSITE NAME

Additional Information

Steps to create and manage Outbound Feeds.

Optional Content Sources For OBF.

Using Jmespath To Map To CustomFields ANS Values.

More details on Resolvers.

Regex Debugger.