External Content

Ways to include, summarise or refer to content from other servers.

Notation Comment
{rss:url=http://host.com/rss.xml}

{rss:url=http://host.com/rss.xml|max=5}

{rss:url=http://host.com/rss.xml|showTitlesOnly=true}

Display the contents of a remote RSS feed within the page. Note: feeds are cached for 60 minutes before being retrieved again.

The max parameter can be used to limit the number of entries displayed.

Example:
Sample RSS Feed (RSS 2.0)
(Feed description here...)
My Item ( Dec 30, 2003 06:53)
And part of the item content here...
Another Item ( Dec 30, 2003 06:53)
And part of the item content here...

You can specify showTitlesOnly=true to show only the RSS feed titles. This parameter defaults to false.

You can specify titleBar=false to hide the feeds titlebar. This parameter defaults to true.

{jiraissues:url=http://jira.rss.url}

{jiraissues:url=http://jira.rss.url|
columns=type;key;summary}

{jiraissues:url=http://jira.rss.url|
count=true}

{jiraissues:url=http://jira.rss.url|
cache=off}

{jiraissues:url=http://jira.rss.url?
os_username=johnsmith&os_password=secret}
Imports and displays JIRA issue list RSS as inline content for the page. You can easily customize the list and order of the columns being displayed, by specifying columns parameter.

Not specifying columns will lead into the default column list and order.

Allowed columns are: key, summary, type, created, updated, assignee, reporter, priority, status, resolution.

Specifying count=true will cause the macro to just print out how many issues were in the list, without printing the list.

Using count=true will cause the macro to just print out how many issues were in the list, without printing the list.

Using cache=off will force the macro to refresh its internal cache of Jira issues.

Note: Certain filters may require a logged-in user in order to work. Hence you may need to append:
&os_username=yourJiraUsername&os_password=yourJiraPassword
to the end of your jira issues url.

Example:
Atlassian JIRA (This file is an XML representation of some issues)
Key Summary Assignee Status Res Updated
TEST-100 Add JIRA support John Gordon Open UNRESOLVED 01/Jan/04
TEST-103 Add JUnit Support Robert Matson In Progress UNRESOLVED 25/Dec/03
TEST-108 Add RSS Support Bill Watson In Progress UNRESOLVED 23/Dec/03
TEST-109 Add Search Support Fred Morit Closed FIXED 03/Jan/04

{jiraportlet:url=http://jira.portlet.url} Imports and displays JIRA 3 portlet into a Confluence page.

You can get the URL for the portlet by configuring the portlet into your JIRA dashboard. While in configuration mode, you can copy the portlet URL from the top of the portlet display.

Note: Certain filters may require a logged-in user in order to work. Hence you may need to append:
&os_username=yourJiraUsername&os_password=yourJiraPassword
to the end of your portlet url.

{junitreport:directory=file:///c:/test-reports}
(currently only picks up result files in XML format. Set ant formatter to "xml")

{junitreport:url=file:///test-reports/TestRep.xml}
Displays the results of a series (or single) JUnit test.

Success Rate Tests Failures Time(s) Time(s)
93%
14 1 0 1.531

{aim:myscreenname}
{aim:myscreenname|showid=false}

Displays a graphic indication of whether an AIM user is online. You must supply a valid AIM screen name as the default argument.

Specifying showid=false will cause the macro to only output the image, not the user's AIM screen name in text format.

{yahoo:myyahooid}
{yahoo:myyahooid|showid=false}

Displays a graphic indication of whether a Yahoo! Instant Messenger user is online. You must supply a valid Yahoo! ID as the default argument.

Specifying showid=false will cause the macro to only output the image, not the user's Yahoo! ID in text format.

{icq:12344563}
{icq:12344563|showid=false}
{icq:12344563|image=5}

Displays a graphic indication of whether an ICQ user is online. You must supply a valid ICQ UIN as the default argument.

Specifying showid=false will cause the macro to only output the image, not the user's ICQ UIN in text format.

Specifying image=X will cause the macro to use ICQ image set X. Examples of image sets can be found here. The default image set is 5.