Ever wanted to create an RSS reader that is targeted to
specific users, contains specific feeds and has a customizable appearance? Ever wanted to integrate all of that
functionality into your complex portal environment, but were afraid to take on
such a huge integration project?
…Well one simple answer is LocationRSS.
What is LocationRSS? – LocationRSS.aspx is pre-packaged
code that uses the NewsGator API to create a portable and extensible reader.
How much does it cost? - Its FREE!! (kinda). LocationRSS is included in the NewsGator
Enterprise Server (NGES).
How do I use it? For starters, check the “integration” link in the on-line help file on
the NGES server (re-printed below if you are not lucky enough to have a NGES
server yet). That should get you
started, but if you need more help or have questions, feel free to comment here
or contact the NewsGator professional services group at ps@newsgator.com
Help : Location RSS Feed
RSS Endpoint
/ngws/svc/LocationRSS.aspx
What is the
Location RSS Feed?
Location RSS is used to serve an aggregated RSS feed for a named
location. By default, LocationRSS will serve a feed for the default location
(NewsGator Enterprise Web Edition) for the user that is requesting the feed.
For more information on NewsGator Locations, please see the Location
help.
The Location RSS feed is a core integration point for the NewsGator
Enterprise SharePoint Components, in which a portal site will own a named
location and share it among the site members. For more information, please see
the NewsGator Enterprise SharePoint Components release notes.
Simple
intranet integration with the Location RSS Feed
For intranets or portals not based on SharePoint, LocationsRSS.aspx
is a simple RSS Xml endpoint that allows extremely simple integration. If your
users are authenticating on the network via Windows Active Directory and you
have installed NGES in Active Directory mode, you can simply create an iframe
on an existing portal page and add /ngws/svc/LocationRSS.aspx as the source.
XSLT
Transforms and the Location RSS Feed
We provide a default XSLT transform to render the RSS returned by
this call as html in the users browser, but you can include a specific XSLT
transform for your company by just putting the file in the ngws/svc/xslt/
folder on the NGES web server and including it as a query string parameter,
such as /ngws/svc/LocationRSS.aspx?transform=rss.xsl.
You can ignore the included XSLT file if you are applying XSLT programmatically
from the client.
Specifying a
Location for the Location RSS Feed
If no location is specified, the default Web location will be
served. If you specify a location, it’s that location name that is served:
http://[yourNGESserverURL]/ngws/svc/LocationRSS.aspx?transform=rss.xsl&location=portalhome
Specifying
numbers returned for the Location RSS Feed
You can limit the results by specifying the Count param:
http://[yourNGESserverURL]/ngws/svc/LocationRSS.aspx?transform=rss.xsl&count=3
If no Count param is specified, a default of 50 results are
returned.
Specifying
read or unread items for the Location RSS Feed
You can also specify read items:
http://[yourNGESserverURL]/ngws/svc/LocationRSS.aspx?transform=rss.xsl&UnreadOnly=false
If unreadOnly is not specified, only unread items are returned.
Specifying a
specific user's location for the Location RSS Feed
The results for these will always be based upon the requesting user
(the person viewing the portal page) unless an owner of a location is specified
in the URL (and that location is marked as public). Example:
http://[yourNGESserverURL]/ngws/svc/LocationRSS.aspx?owner=corp\postalservice&location=portalhome
This will allow an aggregation publisher to specify a certain
location for an intranet data source.
Specifying a
Category Filter for the Location RSS Feed
You can apply a Category Filter to the Location feed by specifying
a Category parameter. The Category is applied to each item of an RSS feed
according to the RSS
Specification. Example:
http://[yourNGESserverURL]/ngws/svc/LocationRSS.aspx?category=newsgator
This will allow you to retrieve a feed of posts with a specific
category applied across multiple feed sources.
For
additional help please contact your administrator.
NewsGator
Enterprise Server 2.0.0.952
©
2003-2007 NewsGator Technologies, Inc. All rights reserved.