GeneXus Server has available a Syndication Service for each Knowledge Base hosted in the instance.
Note: the RSS option can be enabled by checking the 'RSS Enabled' property of the Advanced option.
When enabled, the available RSS icon is shown in the Knowledge Base Menu. By clicking on the RSS button, the user will get to the associated feed service.
This service returns all changes done to a Knowledge Base. To subscribe to this feed the user will be able to use his favorite feed reader by just copying the URL displayed in the RSS Icon. The Feed URL is generated as follows:
http://<ServerURL>/SyndicationService.svc/revisions?kb=<kbName>[&version=<versionName>]
Where:
- ServerURL: published URL where the GeneXus Server instance is located.
- kbName: Knowledge Base alias of the published GeneXus Server Knowledge Base.
- versionName: the version name of the of the Knowledge Base for which the user wants to get the feed if omitted the trunk version will be used.
For example, for the TravelAgency URL of the RSS feed service is:
http://172.16.150.64/GeneXusServerToledo/SyndicationService.svc/revisions?kb=TravelAgency
If we open the URL with Internet Explorer the feed formatted will be displayed as follows:
And the actual XML content returned by the service is the following:
<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">
<channel>
<title>
Knowledge Base: 'TravelAgency' Version: 'TravelAgency'
</title>
<description>
Retrieves revisions from the Knowledge Base 'TravelAgency', version 'TravelAgency' hosted by GeneXus Server
</description>
<managingEditor>http://www.genexus.com</managingEditor>
<category>Teamwork</category>
<category>GeneXus Server</category>
<category>TravelAgency</category>
<category>TravelAgency</category>
<item>
<guid isPermaLink="false">be628a6b-ef9c-491f-a032-4b0a209339a1</guid>
<author>Local\admin</author>
<title>CountryName changed.</title>
<description>
CountryName changed.<br/><br/><font color='#616D7E'>Objects changed:</font><ul><li>Attribute CountryInitialsName. Modified on 8/30/2016 12:28:02 PM</li></ul>By Local\admin on Tuesday, August 30, 2016 at 9:28:22 AM
</description>
<pubDate>Tue, 30 Aug 2016 12:28:22 Z</pubDate>
<a10:updated>2016-08-30T12:28:22Z</a10:updated>
</item>
<item>
<guid isPermaLink="false">2e3b3f39-0249-4fd0-b319-65540ddf1c95</guid>
<author>GXTechnical\solerivas</author>
<title>Bug fixes.</title>
<description>
Bug fixes.<br/><br/><font color='#616D7E'>Objects changed:</font><ul><li>Query TicketSale. Modified on 8/4/2016 3:08:06 PM</li><li>DataSelector FindCustomer. Modified on 8/4/2016 3:07:51 PM</li><li>Procedure ChangeAttractionName. Modified on 8/4/2016 3:08:15 PM</li><li>Procedure ChangeCustomerInformation. Modified on 8/3/2016 7:51:01 PM</li></ul>By GXTechnical\solerivas on Thursday, August 4, 2016 at 2:49:10 PM
</description>
<pubDate>Thu, 04 Aug 2016 17:49:10 Z</pubDate>
<a10:updated>2016-08-04T17:49:10Z</a10:updated>
</item>
<item>
<guid isPermaLink="false">20484e11-17ac-46a2-ac5e-04a6ddfb561e</guid>
<author>GXTechnical\solerivas</author>
<title>Change Customer selection mode.</title>
<description>
Change Customer selection mode.<br/><br/><font color='#616D7E'>Objects changed:</font><ul><li>Procedure ChangeCustomerInformation. Modified on 8/3/2016 7:51:01 PM</li></ul>By GXTechnical\solerivas on Wednesday, August 3, 2016 at 5:01:15 PM
</description>
<pubDate>Wed, 03 Aug 2016 20:01:15 Z</pubDate>
<a10:updated>2016-08-03T20:01:15Z</a10:updated>
</item>
<channel>
</rss>
Subordinate to the <rss> element is a single <channel> element, which contains information about the channel (metadata) and all its contents. The subordinate items for <channel> are:
- Title: The name of the channel. It's how the service is referred.
- Description: a sentence describing the channel.
- ManagingEditor: address of responsible for editorial content.
- Category: specifies one or more categories that the channel belongs to.
Where each revision is represented by an item, and each item has the following nodes:
- Guid: A string that uniquely identifies the item. The GUID element has an attribute named "isPermaLink", this value is always false, meaning the GUID may not be assumed to beURL URL.
- Author: the user who made the Commit operation.
- Title: the comment included by the user when the Commit operation was made.
- Description: a complete description of the process, including the comment and all the objects related to the Commit operation, with its dates and user.
- pubDate: the date in which the Commit operation was made.
- a10:updated: the post update date.
This information is also available from the Team Development History dialog of the GeneXus IDE.