Community Integration: Format of RSS and Atom feeds

As a Campus Cloud administrator, you may be asked to troubleshoot integrated community feeds, such as by following the steps in this FAQ:

This article tells you how to format a feed for a community integration. There are specific formats for (1) RSS feeds and (2) ATOM feeds. 

1. RSS

<?​xml version=​"1.0"​ encoding=​"UTF-8"​?>
<​rss​​xmlns:atom​=​"http://www.w3.org/2005/Atom"xmlns:content​=​"http://purl.org/rss/1.0/modules/content/"​​version​=​"2.0"​>
<​channel​>
<​title​>My Integrated RSS feed</​title​>
<​link​>http://example.com/test.atom</​link​>
<​description​>feed description</​description​>
<​atom:link​​href​=​"http://example.com/test.atom"​​rel​=​"self"​ />
<​lastBuildDate​>Tue, 16 Apr 2019 14:45:15 +0000</​lastBuildDate​>
<​item​>
<​title​>Description</​title​>
<​guid​​​>65c96b7f-a410-4494-b840-d5b82a5d2907</​guid​>
<​pubDate​>Tue, 16 Apr 2019 10:45:15 +0000</​pubDate​>
</​item​>
...
</​channel​>
</​rss​>
 
Each <item> tag in the feed must contain the following:
  • <title> string
  • <guid> string | number. Can be replaced by <id>
  • <pubDate> Datetime. Can be replaced by <start_date>, <startDate>, <start>, <startdate>, <pubdate>, <published>

Notes:

  • If more than one datetime tag is present, we use the first and ignore the others. 
  • We do not use the <description> tag within an <item>. We use title, but if there is text in the description field, that text will be ignored. 

2. ATOM

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
<id>2fff5f8a-39b9-4d7b-b102-28d53b28e0a2</id>
<title>My Integrated Atom feed</title>
<updated>2019-04-16T14:45:15.475012+00:00</updated>
<link href="http://example.com" rel="alternate"/>
<link href="http://example.com/test.atom" rel="self"/>
<subtitle>A Sample Description</subtitle>
<entry>
<id>65c96b7f-a410-4494-b840-d5b82a5d2907</id>
<title>A message that will appear in the campus app.</title>
<published>2019-04-16T10:45:15.475106+00:00</published>
</entry>
</feed>

Each ​<​entry​>​ tag in the feed must contain the following:

  • ​<​title​>​ String | Number
  • <​id​>​ String | Number. Can be replaced by <​guid​>
  • <​published​>​ Datetime. Can be replaced by <​start_date​>, <​startDate​>, <​start​>, <startdate>,<​pubdate​> or <​published​>

Notes: 

  • If more than one datetime tag is present, we use the first and ignore the others.
  • We do not use the <description> tag within an <item>. We use title, but if there is text in the description field, that text will be ignored.