News Supplier

1 Overview | 2 Details | 3 Supported Keys | 4 Inherited Keys

Overview

Supplies information about news items (or blog posts) in Confluence.

Key names are case-sensitive. You must supply a key of id rather than ID.

You can also use any key from the Content Supplier using the news: prefix.

For example

you can use news:id, instead of content:id, even though id is not listed explicitly below

Details

Name:	News Supplier
Prefix:	news/blogpost(optional)
Supported Content:	News Items
Provided By:	Reporting for Confluence FROM v3.0.0

Supported Keys

List of keys that this supplier returns a value for.

Key	Content Types	Return Type	Description

Key	Content Types	Return Type	Description
comments	News Items	List of Comments	A list of top-level comments attached to the supplied news item. These are comments that are not replies to other comments.
all comments	News Items	List of Comments	A list of all comments attached to the supplied news item. This includes all replies in comment threads.
is favourite is favorite	News Items	Boolean	Is true if the news item is a favorite of the current user.
space	News Items	Space	The space the news item is in.
posting date	News Items	Date	The date the blog was posted on. Equivalent to 'creation date'. FROM v3.3.0
date path	News Items	Text	The 'date' section of the post's URL path. e.g. '2010/06/30'. FROM v3.3.0
tiny url	News Items	Text	The context-relative path for the short URL for this page. FROM v3.4.0

Inherited Keys

The following keys are inherited from other suppliers, but work using the same prefix (news:/blogpost:) as this supplier.

From Content Supplier

Key	Content Types	Return Type	Description

Key	Content Types	Return Type	Description
id	All	Number	The unique identifier for the content.
title	All	Text	The title of the content.
type	All	Text	The name of the content type. e.g.: "Page" or "News".
url	All	Text	The server-relative URL to view the content.
creator	All	User	The user who created the content.
creation date	All	Date	The date the content was created.
modifier	All	User	The user who most recently modified the content.
modification date	All	Date	The date the content was most recently modified.
icon	All	Text	The server-relative URL of the icon for this content type.
space	All	Space	The space the content exists in.
excerpt	Pages, news items, space descriptions	Text	The excerpt for the content.
body	Pages, news items, space descriptions, comments	Body	The main body text of the content.
labels	Pages, news items, space descriptions	List of Labels	A list of the labels attached to this content.
attachments	Pages, news items	List of Attachments	A list of the attachments on the supplied content.
incoming links	Pages, news items	List of Links	A list of links to content which links to the supplied content.
outgoing links	Pages, news items	List of Links	A list of links to content which the supplied content links to.
summary	Content	Text	Either the excerpt (as above), if it exists, or a short summary of the page content if it does not. FROM V1.3
equals [X]	Content	Boolean	Tests if the current context is equal to that specified by X, where X is a standard link to Confluence content. Examples equals My Page - compares to 'My Page' in the current space equals @self - compares to the current context equals @parent - compares to the parent page of the current context equals ^attachment.ext - compares to the file attached to the current page content:equals KEY:Page - compares to a page in another space
version	Content	Number	The version number for the content.
version comment	Content	Text	The comment about the version, as set by the editor. FROM V2.1.0
version history	Content	List of Content	The list of historical versions for the current content object. FROM V2.1.0
is latest version	Content	Boolean	Checks if the content is the latest version.
latest version	Content	Content	Returns the latest version of the content.
images	Pages, News Items	List of Attachments	The list of attachments which are image files. FROM V3.2.0