Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

/rest/communardo/metadata/latest/filter/{pagenumber} GET

Search for Confluence content and its metadata. You can search with the Confluence query language (CQL) or Lucene query language or combine them.

Path parameters

Parameter
RequiredDefault value Possible values / type
pagenumberThe page number of the result list.(tick)
INTEGER greater 0

Query parameters

Parameter
RequiredDefault valuePossible values / type
cql

The query which defines the content to be searched given in the Confluence query language (CQL).


(info) Additional help for creating search conditions which include Metadata fields can be found in Searching with Metadata.

(warning) Either the cql parameter or the query parameter has to be provided.

STRING

The CQL query string.

query

DEPRECATED please prefer the cql parameter.

The query which defines the content to be searched given in the Lucene query syntax.


(info) Additional help for creating search conditions which include Metadata fields can be found in Searching with Metadata

(warning) Either the cql parameter or the query parameter has to be provided.

STRING

The Lucene query string.

sortThe column to use for sorting the results.(tick)

STRING

The name of the column. Examples:

  • sort by page title with
    • content-name-untokenized
  • sort by a Metadata field by providing the field key
    • metadatafield.status
sortdirectionThe order in which the result should be sorted.(tick)
  • ASCENDING
  • DESCENDING 
pagesizeThe number of items to return per result page.(tick)
INTEGER greater 0
fieldsNarrow down the list of displayed Metadata fields per result.
All metadata fields of the content results will be contained.

A comma separated list of fields. Example:

metadatafield.status,metadatafield.contactperson

ceoThe ID of a page or a blogpost to define the context of the request. This is especially useful when using CQL with functions like currentSpace().

INTEGER


Example Request with JavaScript


jQuery.get( contextPath + "/rest/communardo/metadata/latest/filter/1" , {
    cql: 'global.metadatafield.contactperson="admin"',
    pagesize: 10,
    sortdirection: "DESCENDING",
    sort: "content-name-untokenized",
	fields: "global.metadatafield.contactperson"
}, function(data) {
    console.log(data);
});

Please note: latest/filter/1 displays the first page of the results. If you have more than 10 results, you can get the next result set by incrementing the pagenumber path parameter.

Example Response


{
	"pageNo": "1",
	"self": "https://wiki.company.de/rest/communardo/metadata/latest/filter",
	"searchResults": [{
		"pageTitle": "Example",
		"pageUrl": "/display/~admin/Example",
		"pageId": 1234567,
		"contentType": "page",
		"values": [{
			"id": 80,
			"key": "global.metadatafield.contactperson",
			"title": "Contact Person",
			"content": "<a class=\"confluence-userlink user-mention current-user-mention\" data-username=\"admin\" href=\"https://wiki.company.de/display/~admin\" data-linked-resource-id=\"25624936\" data-linked-resource-version=\"1\" data-linked-resource-type=\"userinfo\" data-base-url=\"https://wiki.company.de\">Administrator</a>"
		},
		{
			"id": 81,
			"key": "global.metadatafield.pagestatus",
			"title": "Page Status",
			"content": "Approved"
		},
		{
			"id": 82,
			"key": "global.metadatafield.pagestatusmessage",
			"title": "Page Status Message",
			"content": "nothing to do here"
		}]
	}],
	"pager": {
		"currentPage": 1,
		"pageCount": 1,
		"elementsPerPage": 10,
		"totalElementsCount": 1
	}
}
  • No labels