Create selection by type

LOCKED.

This API is extremely reliable and will not be broken unless absolutely necessary.

Method

POST

Path

/qrs/selection/[type]?filter={filter}

Description

Create a selection set that is pre-populated with selection items referring to entities of a specific [type]. Optionally, include an empty GUID in the API call. Optionally, filter the entities.

When using the standard GET method on the selection set, selection items are returned, not the actual entities. To get the actual entities in the selection set, use the paths described in Get all as condensed by selection and Get all as full by selection.

Body

Return value

Selection:

{
   "items":
      [
         {
            "type": "typename of entity",
            "objectid": "id of entity",
            "objectname": "..."
         },
         { ... }
      ]
}

Optional parameters

{filter}: See Filtering.

Example: Create selection

This example shows how to create a selection that contains two engine services, one repository service, and one tag.

POST https://SELUN-USER.qlik.com:4242/qrs/selection?Xrfkey=abcdefghijklmnop HTTP/1.1
Accept-Encoding: gzip,deflate
X-Qlik-User: UserDirectory=INTERNAL; UserId=sa_repository
Accept-Charset: utf-8; q=0.9, us-ascii;q=0.1, iso-8859-1
Accept: text/xml; q=0.1, application/json; q=0.2
X-Qlik-Xrfkey: abcdefghijklmnop
Content-Type: application/json
Content-Length: 756
Host: SELUN-USER.qlik.com:4242
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

{ "ID": "00000000-0000-0000-0000-000000000000", "ModifiedDate": "/Date(1335786687815+0200)/", "items": [ { "type": "EngineService", "objectID": "16159b26-25dd-4c67-a2d9-cbff9a126f50", "id": "00000000-0000-0000-0000-000000000000" }, { "type": "EngineService", "objectID": "5dd73971-d441-44ba-8b7a-8d289967149d", "id": "00000000-0000-0000-0000-000000000000" }, { "type": "RepositoryService", "objectID": "b2f00e9b-2385-4178-9710-35fdcc590e8a", "id": "00000000-0000-0000-0000-000000000000" }, { "type": "Tag", "objectID": "338db591-21a6-473d-90bd-092043d90ae0", "id": "00000000-0000-0000-0000-000000000000" }] }

{ "items": [ { "type": "EngineService", "objectID": "16159b26-25dd-4c67-a2d9-cbff9a126f50", "objectName": "", "id": "76f5104d-2d14-4617-9fe8-3718696f0673", "createdDate": "1753-01-01T00:00:00.000Z", "modifiedDate": "1753-01-01T00:00:00.000Z", "modifiedByUserName": "", "schemaPath": "Selection.Item" }, { "type": "EngineService", "objectID": "5dd73971-d441-44ba-8b7a-8d289967149d", "objectName": "", "id": "c9d2a265-9109-40d8-b16c-dbfca07e54cc", "createdDate": "1753-01-01T00:00:00.000Z", "modifiedDate": "1753-01-01T00:00:00.000Z", "modifiedByUserName": "", "schemaPath": "Selection.Item" }, { "type": "RepositoryService", "objectID": "b2f00e9b-2385-4178-9710-35fdcc590e8a", "objectName": "", "id": "91c53ba9-f652-4153-a9ca-0b042bcc1c2f", "createdDate": "1753-01-01T00:00:00.000Z", "modifiedDate": "1753-01-01T00:00:00.000Z", "modifiedByUserName": "", "schemaPath": "Selection.Item" }, { "type": "Tag", "objectID": "338db591-21a6-473d-90bd-092043d90ae0", "objectName": "", "id": "84461a0e-f451-47bd-89b7-2a8850f3722c", "createdDate": "1753-01-01T00:00:00.000Z", "modifiedDate": "1753-01-01T00:00:00.000Z", "modifiedByUserName": "", "schemaPath": "Selection.Item" } ], "privileges": null, "id": "e0524ee6-f4ca-43a0-aef1-ac6b39eefea8", "createdDate": "1753-01-01T00:00:00.000Z", "modifiedDate": "2013-10-25T12:55:03.847Z", "modifiedByUserName": "INTERNAL\\sa_repository", "schemaPath": "Selection" }

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!

Leave your feedback here