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:

  • Please make sure that the GUID key is unique for each event. The GUID key is a combination of the event host, feed URL, and GUID.
  • 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. 
  • The feeds sync once an hour.
  • The content of the message is truncated at 1,024 characters (this includes mark-up for links, which will display as clickable URL's if they fall within this limit).