Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
typeflat
separatorpipe
printablefalse

Overview

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

Info

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 version 3

Status
colourBlue
titleFROM v3.0.0

Supported Keys

The following are the list List of keys which that this supplier will return returns a value for.

Key

Content Types

Return Type

Description

comments

News Items

List of Comments

A list of top-level comments attached to the supplied news item.

Info

These are comments

which

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.

Info

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

(Since 3.3.0) The

The date the blog was posted on. Equivalent to 'creation date'.

Status
colourBlue
titleFROM v3.3.0

date path

News Items

Text

(Since 3.3.0) The

The 'date' section of the post's URL path. e.g. '2010/06/30'.

Status
colourBlue
titleFROM v3.3.0

tiny url

News Items

Text

(Since 3.4.0) The

The context-relative path for the short URL for this page.

Status
colourBlue
titleFROM v3.4.0

Inherited Keys

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

From Content Supplier

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.

Info

If the content is itself a space, the space is returned.

excerpt

Pages, news items, space descriptions

Text

The excerpt for the content.

(

Inheritance is not valid with Attachment Supplier.

)

body

Pages, news items, space descriptions, comments

Body

The main body text of the content.

 (

Inheritance is not valid with Attachment Supplier.

)

labels

Pages, news items, space descriptions

List of Labels

A list of the labels attached to this content.

 (

Inheritance is not valid

with 
)

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.

 (

Inheritance is not valid with Attachment Supplier.

)

outgoing links

Pages, news items

List of Links

A list of links to content which the supplied content links to.

 (

Inheritance is not valid with Attachment Supplier.

)

summary

Content

Text

Either the excerpt (as above), if it exists, or a short summary of the page content if it does not.

(Since 1

Status
colourBlue
titleFROM V1.3

)

(

Inheritance is not valid

with 
)

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 
  • Page - compares to 'My Page' in the current space

.
  • equals

@self 
  • @self - compares to the current context

.
  • equals

@parent 
  • @parent - compares to the parent page of the current context

.
  • equals ^attachment.

ext 
  • ext - compares to the file attached to the current page

.
  • content:equals KEY:

Page 
  • Page - compares to a page in another space

.
Info

The

'

content:

'

prefix is required for tests on pages in other spaces, due to the ':' character in the value.

version

Content

Number

The version number for the content.

version comment

Content

Text

The comment about the version, as set by the editor.

(Since 2

Status
colourBlue
titleFROM V2.1.0

)

(

Inheritance is not valid

with 
)

version history

Content

List of Content

The list of historical versions for the current content object.

Status
colourBlue
titleFROM V2.1.0

Info

The most recent version will be listed first

. (Since 2.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.

Info

May be the same content if this is the latest version.

images

Pages, News Items

List of Attachments

(Since 3.2.0) The

The list of attachments which are image files.

Status
colourBlue
titleFROM V3.2.0