FAQ

Frequently Asked Questions v2

FAQ Main / Answer Detail

How do I set mapping on RSS import

Author: Mitra mitra@mitra.biz
Article progress: Early Draft

Related Categories:

General Questions

Slice Administrator

Add Comment

For most feeds you won't need to map them, unless you want the feed to go to Active rather than Hold bin.

To set the mapping, first create the feed in AA->RSS Feeds, then click on the feed and click Map. (or go to it directly from the AA->Mapping page.

If all you want to do is send it to the Active bin, then go to the bottom and change "Status" to "Value" and "1" (hold is "Value" and "2")

You can set quite complex feeding behavior by setting any field to "RSS field or expression" and then entering an RSS field name, or more complex expression.

Fields have a prefix and a value e.g. DC:TITLE, the allowed fields are:

Prefix Allowed Values Where found in RSS

CHANNEL/ title, description, language, timestamp (AA only), link From the corresponding CHANNEL elements at the top of the feed except slice_id is from dc/identifier
ITEM/ title,description,link,id, guid, pubdate From the corresponding ITEM elements except id is from dc/identitifier)
DC/ title,creator,subject,description,date,source,language,relation,coverage From the corresponding DC elements within the ITEM

In addition, the following syntax is supported:

ITEM/DESCRIPTION|ITEM/TITLE Will look for the Description, and if that is not present use the title
DATE(ITEM/pubdate) Converts the specified field to a unix date
NOW Uses the current date and time
CONTENT Hard coded to find the content and determine if its HTML, given that the RSS standard makers keep moving things! Currently it looks in Item/encoded and and Item/items/bag/li/item/value
headline........ Will look for an APC-AA field, this only works if the sending RSS feed is from APC site, in which case Inter-node feeding would be better anyway.

Notes to Developers

It is relatively straightforward to modify RSS import as the standards mutate

The parsing of the mapping syntax is defined in xml_fetch.php3:map1field
The default mapping, used by new feeds, or where mapping has not defined, is in csn_util.php3:default_rss_map
The conversion between XML path and field names is in xml_rssparse.php3:charD, endElement and startElement
The hard coded search for content is in xml_fetch.php3:contentvalue and xml_rssparse.php3/charD

Last Edit: Aug 17 2011

<aafaq id=1659> ~ToDo: 1659 How do I set mapping on RSS import </aafaq>

This FAQ interface was developed by Jason at Commons.ca

ActionApps Home

Documentation

Mailing Lists

FAQ

APC ActionApps is a free software content management system initiated by the Association for Progressive Communications (APC)
APC - Internet and ICTs for social justice and development

Prefix	Allowed Values	Where found in RSS
CHANNEL/	title, description, language, timestamp (AA only), link	From the corresponding CHANNEL elements at the top of the feed except slice_id is from dc/identifier
ITEM/	title,description,link,id, guid, pubdate	From the corresponding ITEM elements except id is from dc/identitifier)
DC/	title,creator,subject,description,date,source,language,relation,coverage	From the corresponding DC elements within the ITEM

ITEM/DESCRIPTION\|ITEM/TITLE	Will look for the Description, and if that is not present use the title
DATE(ITEM/pubdate)	Converts the specified field to a unix date
NOW	Uses the current date and time
CONTENT	Hard coded to find the content and determine if its HTML, given that the RSS standard makers keep moving things! Currently it looks in Item/encoded and and Item/items/bag/li/item/value
headline........	Will look for an APC-AA field, this only works if the sending RSS feed is from APC site, in which case Inter-node feeding would be better anyway.