Conditions
Conditions are used by features such as data alerting and subscriptions to determine when action should be taken, based on data in a Qlik app.
Endpoints
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Request Body
application/json
The condition create request definition.
only one of compoundCondition or dataCondition should be set
- application/jsonobject
only one of compoundCondition or dataCondition should be set
application/json properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- descriptionstring
Description of the condition
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- descriptionstring
Description of the condition
-
-
-
Responses
201
application/json
Condition created
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
Error code specific to condition manager.
- metaobject
- titlestring
Error title.
- detailstring
Error cause.
-
- conditionobject
only one of compoundCondition or dataCondition should be set
condition properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- ownerIdstring
UserID of the condition owner
- tenantIdstring
The tenant id
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
-
-
-
400
application/json
Bad request body
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"type":"compound","dataCondition":{"headers":["sumnum"],"history":{"enabled":true},"measures":[{"title":"sumnum","qLibraryId":"PgQKNQ","qNumFormat":{"qDec":".","qFmt":"###0","qType":"I","qnDec":0,"qUseThou":1}}],"dimensions":[{"field":"Neighborhood","title":"Neighborhood","qLibraryId":"PgQKNQ"}],"selections":[{"count":2,"field":"SalesTerritoryCountry","selectedSummary":"[ Germany, Australia ]"}],"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"},"conditionData":{}},"compoundCondition":{"data":{"history":{"enabled":true},"conditions":["rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2","qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi","4gnz8E6ZruG0lkSKwkau66P24CtORyLr","ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ"],"expression":"($0 OR $1) AND ($2 OR $3)"},"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"}}}'
const https = require('https') const data = JSON.stringify({"type":"compound","dataCondition":{"headers":["sumnum"],"history":{"enabled":true},"measures":[{"title":"sumnum","qLibraryId":"PgQKNQ","qNumFormat":{"qDec":".","qFmt":"###0","qType":"I","qnDec":0,"qUseThou":1}}],"dimensions":[{"field":"Neighborhood","title":"Neighborhood","qLibraryId":"PgQKNQ"}],"selections":[{"count":2,"field":"SalesTerritoryCountry","selectedSummary":"[ Germany, Australia ]"}],"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"},"conditionData":{}},"compoundCondition":{"data":{"history":{"enabled":true},"conditions":["rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2","qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi","4gnz8E6ZruG0lkSKwkau66P24CtORyLr","ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ"],"expression":"($0 OR $1) AND ($2 OR $3)"},"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"}}}) const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions', 'method': 'POST', 'headers': { 'Content-type': 'application/json', 'Authorization': 'Bearer <access_token>' } } const req = https.request(options) req.write(data)
This API is not included yet in qlik-cli
Request
{ "type": "compound", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "description": "My condition" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "description": "My condition" } }}
Response
{ "errors": [ { "code": "string", "meta": {}, "title": "string", "detail": "string" } ], "condition": { "type": "compound", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" } } }}
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Path Parameters
- idstringRequired
The id of the condition
Responses
200
application/json
The condition
only one of compoundCondition or dataCondition should be set
- application/jsonobject
only one of compoundCondition or dataCondition should be set
application/json properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- ownerIdstring
UserID of the condition owner
- tenantIdstring
The tenant id
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
-
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}" \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}', 'method': 'GET', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Response
{ "type": "compound", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" } }}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- idstringRequired
The id of the condition
Request Body
application/json
A JSON Patch document as defined in https://datatracker.ietf.org/doc/html/rfc6902.
- application/jsonarray of objects
A JSON Patch document as defined in https://datatracker.ietf.org/doc/html/rfc6902.
application/json properties
- opstringRequired
The operation to be performed.
Can be one of: "replace""remove""add"
- pathstringRequired
The path for the given resource field to patch.
- valueobject
The value to be used for this operation.
-
Responses
204
The condition was updated
400
application/json
A path or value was invalid
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/compoundCondition/conditionBase/ownerId","value":"I6mWVd60wRWIbOXZr1ZKV8QTnxhnitbX"},{"op":"replace","path":"/dataCondition/conditionBase/description","value":"My description"},{"op":"remove","path":"/compoundCondition/data/conditions/0"},{"op":"replace","path":"/compoundCondition//data/expression","value":"$0 AND $1"},{"op":"replace","path":"/dataCondition/conditionData/measure","value":"revenue"}]'
const https = require('https') const data = JSON.stringify([{"op":"replace","path":"/compoundCondition/conditionBase/ownerId","value":"I6mWVd60wRWIbOXZr1ZKV8QTnxhnitbX"},{"op":"replace","path":"/dataCondition/conditionBase/description","value":"My description"},{"op":"remove","path":"/compoundCondition/data/conditions/0"},{"op":"replace","path":"/compoundCondition//data/expression","value":"$0 AND $1"},{"op":"replace","path":"/dataCondition/conditionData/measure","value":"revenue"}]) const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}', 'method': 'PATCH', 'headers': { 'Content-type': 'application/json', 'Authorization': 'Bearer <access_token>' } } const req = https.request(options) req.write(data)
This API is not included yet in qlik-cli
Request
[ { "op": "replace", "path": "/compoundCondition/conditionBase/ownerId", "value": "I6mWVd60wRWIbOXZr1ZKV8QTnxhnitbX" }, { "op": "replace", "path": "/dataCondition/conditionBase/description", "value": "My description" }, { "op": "remove", "path": "/compoundCondition/data/conditions/0" }, { "op": "replace", "path": "/compoundCondition//data/expression", "value": "$0 AND $1" }, { "op": "replace", "path": "/dataCondition/conditionData/measure", "value": "revenue" }]
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- idstringRequired
The id of the condition
Responses
204
The record was deleted.
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}" \-X DELETE \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}', 'method': 'DELETE', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- idstringRequired
The id of the condition
Request Body
application/json
- application/jsonobject
application/json properties
- alertIdstring
The id of the alerting task the condition and evaluation is part of
- contextIdstringRequired
Extra context information to carry through to the result if any
- causalEventobjectRequired
causalEvent properties
- dataobject
data properties
- eventIDstring
the event id from eventing service.
- lastReloadTimestring
The time of the last reload
-
- eventIDstring
the event id from eventing
- extensionsobject
extensions properties
- userIDstring
- tenantIDstring
- sessionIDstring
-
- manualTriggerboolean
- manualTriggerIDstring
the manual trigger id from eventing if present
-
-
Responses
201
application/json
Condition evaluation created
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
Error code specific to condition manager.
- metaobject
- titlestring
Error title.
- detailstring
Error cause.
-
- contextIdstring
Extra context information to carry through to the result if any
- evaluationIdstring
Extra context information to carry through to the result if any
-
400
application/json
Bad request body
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
500
application/json
Internal server error.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}/evaluations" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"alertId":"5f64885b2e11d23982c09e03","contextId":"795c75ba-7812-4c8f-9ced-551b6b006183","causalEvent":{"data":{"eventID":"string","lastReloadTime":"2006-01-02T15:04:05Z07:00"},"eventID":"string","extensions":{"userID":"string","tenantID":"string","sessionID":"string"},"manualTrigger":true,"manualTriggerID":"string"}}'
const https = require('https') const data = JSON.stringify({"alertId":"5f64885b2e11d23982c09e03","contextId":"795c75ba-7812-4c8f-9ced-551b6b006183","causalEvent":{"data":{"eventID":"string","lastReloadTime":"2006-01-02T15:04:05Z07:00"},"eventID":"string","extensions":{"userID":"string","tenantID":"string","sessionID":"string"},"manualTrigger":true,"manualTriggerID":"string"}}) const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}/evaluations', 'method': 'POST', 'headers': { 'Content-type': 'application/json', 'Authorization': 'Bearer <access_token>' } } const req = https.request(options) req.write(data)
This API is not included yet in qlik-cli
Request
{ "alertId": "5f64885b2e11d23982c09e03", "contextId": "795c75ba-7812-4c8f-9ced-551b6b006183", "causalEvent": { "data": { "eventID": "string", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "eventID": "string", "extensions": { "userID": "string", "tenantID": "string", "sessionID": "string" }, "manualTrigger": true, "manualTriggerID": "string" }}
Response
{ "errors": [ { "code": "string", "meta": {}, "title": "string", "detail": "string" } ], "contextId": "795c75ba-7812-4c8f-9ced-551b6b006183", "evaluationId": "795c75ba-7812-4c8f-9ced-551b6b006183"}
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Path Parameters
- evaluationIdstringRequired
The id of the evaluation
- idstringRequired
The id of the condition
Responses
200
application/json
The evaluation
Get response returns the evaluation and condition associated
- application/jsonobject
Get response returns the evaluation and condition associated
application/json properties
- conditionobject
only one of compoundCondition or dataCondition should be set
condition properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- ownerIdstring
UserID of the condition owner
- tenantIdstring
The tenant id
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
-
-
- evaluationobject
evaluation properties
- idstring
The unique id for the resource
- errorsarray of objects
errors properties
- codestring
Error code specific to condition smanager.
- metaobject
meta properties
- fatalboolean
defines whether an error is recoverable or not
-
- titlestring
Error title.
- statusany
Error status.
-
- resultboolean
The final result of the evalution
- statusstring
The status of the evaluation execution
Can be one of: "RUNNING""FAILED""FINISHED""DELETING"
- alertIdstring
The id of the alerting task the condition and evaluation is part of
- endTimestring
The time the evaluation ended
- ownerIdstring
userId of user being impersonated to evaluate the condition
- retriesinteger
number of retries sent to DCE
- tenantIdstring
The tenant id
- conditionobject
only one of compoundCondition or dataCondition should be set
condition properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- ownerIdstring
UserID of the condition owner
- tenantIdstring
The tenant id
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
-
-
- contextIdstring
Extra context information to carry through to the result if one was included on when the evaluation was triggered
- startTimestring
The time the evaluation started
- resultDataobject
Condition type specific result, one of dataResult or compoundResult
- causalEventobject
Representation of the event that caused the condition to be evaluated if one was included on when the evaluation was triggered
- conditionIdstring
The unique id of the associated condition
- retryPolicystring
what kind of retry policy this evaluation has
Can be one of: "NONE""TOO_MANY_REQUESTS""GENERIC_ERROR"
- reloadEndTimestring
The time when the reload was completed in Engine
- byokMigrationIdstring
internal identifier used when migrating keys
- removalErrorCountinteger
The number of times we have attempted to remove this evaluation data-file
- dataConditionEvaluatorIdstringDeprecated
The unique id for the resource given from Data Condition Evaluator.
-
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}/evaluations/{evaluationId}" \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}/evaluations/{evaluationId}', 'method': 'GET', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Response
{ "condition": { "type": "compound", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" } } }, "evaluation": { "id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "errors": [ { "code": "string", "meta": { "fatal": true }, "title": "string" } ], "result": true, "status": "RUNNING", "alertId": "5f64885b2e11d23982c09e03", "endTime": "string", "ownerId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "retries": 42, "tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "condition": { "type": "compound", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" } } }, "contextId": "string", "startTime": "string", "resultData": {}, "causalEvent": {}, "conditionId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "retryPolicy": "NONE", "reloadEndTime": "string", "byokMigrationId": "string", "removalErrorCount": 3, "dataConditionEvaluatorId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69" }}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- evaluationIdstringRequired
The id of the evaluation
- idstringRequired
The id of the condition
Responses
204
The evaluation was deleted
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/{id}/evaluations/{evaluationId}" \-X DELETE \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/{id}/evaluations/{evaluationId}', 'method': 'DELETE', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Create condition preview request.
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Request Body
application/json
Create condition preview request
only one of compoundCondition or dataCondition should be set
- application/jsonobject
only one of compoundCondition or dataCondition should be set
application/json properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- descriptionstring
Description of the condition
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- descriptionstring
Description of the condition
-
-
-
Responses
201
application/json
Condition preview request created.
- application/jsonobject
application/json properties
- previewIdstring
When the resource was created
-
400
application/json
Bad request body
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
500
application/json
Internal server error.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/previews" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"type":"compound","dataCondition":{"headers":["sumnum"],"history":{"enabled":true},"measures":[{"title":"sumnum","qLibraryId":"PgQKNQ","qNumFormat":{"qDec":".","qFmt":"###0","qType":"I","qnDec":0,"qUseThou":1}}],"dimensions":[{"field":"Neighborhood","title":"Neighborhood","qLibraryId":"PgQKNQ"}],"selections":[{"count":2,"field":"SalesTerritoryCountry","selectedSummary":"[ Germany, Australia ]"}],"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"},"conditionData":{}},"compoundCondition":{"data":{"history":{"enabled":true},"conditions":["rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2","qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi","4gnz8E6ZruG0lkSKwkau66P24CtORyLr","ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ"],"expression":"($0 OR $1) AND ($2 OR $3)"},"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"}}}'
const https = require('https') const data = JSON.stringify({"type":"compound","dataCondition":{"headers":["sumnum"],"history":{"enabled":true},"measures":[{"title":"sumnum","qLibraryId":"PgQKNQ","qNumFormat":{"qDec":".","qFmt":"###0","qType":"I","qnDec":0,"qUseThou":1}}],"dimensions":[{"field":"Neighborhood","title":"Neighborhood","qLibraryId":"PgQKNQ"}],"selections":[{"count":2,"field":"SalesTerritoryCountry","selectedSummary":"[ Germany, Australia ]"}],"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"},"conditionData":{}},"compoundCondition":{"data":{"history":{"enabled":true},"conditions":["rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2","qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi","4gnz8E6ZruG0lkSKwkau66P24CtORyLr","ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ"],"expression":"($0 OR $1) AND ($2 OR $3)"},"conditionBase":{"type":"compound","appId":"4xQ1chLoHkOikyzUGcHJquteNrAfketW","bookmarkId":"anTjnOABmxlCirVx8IRfhWhLd9IZjENl","description":"My condition"}}}) const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/previews', 'method': 'POST', 'headers': { 'Content-type': 'application/json', 'Authorization': 'Bearer <access_token>' } } const req = https.request(options) req.write(data)
This API is not included yet in qlik-cli
Request
{ "type": "compound", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "description": "My condition" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "description": "My condition" } }}
Response
{ "previewId": "467ea9bc-bbd7-11ea-b3de-0242ac130004"}
Get condition preview response.
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Path Parameters
- idstringRequired
The id of the condition
Responses
200
application/json
The evaluation
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
Error code specific to condition manager.
- metaobject
- titlestring
Error title.
- detailstring
Error cause.
-
- statusstring
Can be one of: "ACCEPTED""FAILED""RUNNING""SUCCESSFUL"
- conditionobject
only one of compoundCondition or dataCondition should be set
condition properties
- typestringRequired
Indicates the condition type
Can be one of: "compound""data"
- ownerIdstring
UserID of the condition owner
- tenantIdstring
The tenant id
- dataConditionobject
A condition based on data within an app
dataCondition properties
- headersarray of strings
List of header labels
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- measuresarray of objects
List of returned measures
measures properties
- titlestring
Measure title
- qLibraryIdstring
Refers to a measure stored in the library
- qNumFormatobject
Format of the field
-
- dimensionsarray of objects
List of returned dimensions
dimensions properties
- fieldstring
Field referred to the dimension where the selection is made. This may be used to generate deep links.
- titlestring
Dimension title
- qLibraryIdstring
Refers to a dimension stored in the library
-
- selectionsarray of objects
List of fields according to the bookmark definition
selections properties
- countnumber
The count
- fieldstring
Field name
- selectedSummaryarray of strings
Array of selected
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
- conditionDataobject
List of parameters specific to data condition are available in DCE and will be passed as is to DCE as per the API docs of data-condition-evaluator
-
- compoundConditionobject
A condition made up of other conditions
compoundCondition properties
- dataobject
Condition data
data properties
- historyobject
History properties
history properties
- enabledboolean
Is history enabled
-
- conditionsarray of strings
Array of condition ids
- expressionstring
Boolean expression made up of variable names defined from the conditions section
-
- conditionBaseobject
A base condition
conditionBase properties
- idstring
The unique id for the resource
- typestring
Indicates the condition type
Can be one of: "compound""data"
- appIdstring
The id of the app the condition is evaluated against
- createdstring
When the resource was created
- ownerIdstring
The id of the user the user which owns the condition
- updatedstring
When the resource was last updated
- tenantIdstring
The tenant id
- bookmarkIdstring
The bookmark corresponding to the selection state to apply to the app at evaluation time
- createdByIdstring
The id of the user which created the condition
- descriptionstring
Description of the condition
- lastReloadTimestring
The time of the last reload, if the scan is triggered by a reload. If exists and value does not match app's last reload time, the evaluation will fail.
-
-
-
- previewIdstring
When the resource was created
- evaluationobject
evaluation properties
- endTimestring
The time the evaluation ended
- ownerIdstring
userId of user being impersonated to evaluate the condition
- tenantIdstring
The tenant id
- resultUrlstring
URL to download the condition results
- startTimestring
The time the evaluation started
-
-
400
application/json
Bad request body
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
500
application/json
Internal server error.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/previews/{id}" \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/previews/{id}', 'method': 'GET', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Response
{ "errors": [ { "code": "string", "meta": {}, "title": "string", "detail": "string" } ], "status": "ACCEPTED", "condition": { "type": "compound", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "dataCondition": { "headers": [ "sumnum" ], "history": { "enabled": true }, "measures": [ { "title": "sumnum", "qLibraryId": "PgQKNQ", "qNumFormat": { "qDec": ".", "qFmt": "###0", "qType": "I", "qnDec": 0, "qUseThou": 1 } } ], "dimensions": [ { "field": "Neighborhood", "title": "Neighborhood", "qLibraryId": "PgQKNQ" } ], "selections": [ { "count": 2, "field": "SalesTerritoryCountry", "selectedSummary": "[ Germany, Australia ]" } ], "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" }, "conditionData": {} }, "compoundCondition": { "data": { "history": { "enabled": true }, "conditions": [ "rDDAcMEI1V0qzauEWepEVY8oSLJ9fvA2", "qFPF1dAtPK4vfPTmKyyuKaqA6iERCwLi", "4gnz8E6ZruG0lkSKwkau66P24CtORyLr", "ATs--Z0b_NGyuHajcbQkxu7RrajgPaEQ" ], "expression": "($0 OR $1) AND ($2 OR $3)" }, "conditionBase": { "id": "5f31c6e8476ae50001030fb6", "type": "compound", "appId": "4xQ1chLoHkOikyzUGcHJquteNrAfketW", "created": "2006-01-02T15:04:05Z07:00", "ownerId": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "updated": "2006-01-02T14:04:05Z07:00", "tenantId": "5GI7yWoJk9lvNtuEc66SXCypXVfhbVeH", "bookmarkId": "anTjnOABmxlCirVx8IRfhWhLd9IZjENl", "createdById": "EIwSIgqjmbHGwQJI0ShQoS3ORdz5nCpA", "description": "My condition", "lastReloadTime": "2006-01-02T15:04:05Z07:00" } } }, "previewId": "467ea9bc-bbd7-11ea-b3de-0242ac130004", "evaluation": { "endTime": "string", "ownerId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69", "resultUrl": "string", "startTime": "string" }}
Lists api settings.
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Responses
200
application/json
The api settings have been successfully returned
- application/jsonobject
application/json properties
- tenantIdstring
These persisted api settings are only available for this tenant. Extracted from request JWT.
- enable-conditionsbooleanRequired
Whether API endpoints for condition manager are enabled
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
500
application/json
Internal server error.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/settings" \-H "Authorization: Bearer <access_token>"
const https = require('https') const data = JSON.stringify("") const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/settings', 'method': 'GET', 'headers': { 'Authorization': 'Bearer <access_token>' } } const req = https.request(options)
This API is not included yet in qlik-cli
Response
{ "tenantId": "cgdsAumGmQ6l0Bi7CUKt9V8P_Y9GL0sC", "enable-conditions": true}
Updates API configuration. Accessible only by tenant admins.
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Header Parameters
- Authorizationstring
The JWT used for authentication. Send the JWT in the AuthRequest header using the Bearer schema.
Request Body
application/json
Request for updating the api settings
- application/jsonobject
application/json properties
- enable-conditionsbooleanRequired
Whether API endpoints for condition manager are enabled
-
Responses
204
api settings have been successfully updated.
400
application/json
Bad request body
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
500
application/json
Internal server error.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
default
application/json
Error response.
- application/jsonobject
application/json properties
- errorsarray of objects
Array of errors
errors properties
- codestring
Error code specific to condition manager.
- metaobject
meta properties for an error.
- titlestring
Error title.
- detailstring
Error cause.
-
- traceIdstring
trace id
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/conditions/settings" \-X PUT \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"enable-conditions":true}'
const https = require('https') const data = JSON.stringify({"enable-conditions":true}) const options = { 'hostname': 'https://your-tenant.us.qlikcloud.com', 'port': 443, 'path': '/api/v1/conditions/settings', 'method': 'PUT', 'headers': { 'Content-type': 'application/json', 'Authorization': 'Bearer <access_token>' } } const req = https.request(options) req.write(data)
This API is not included yet in qlik-cli
Request
{ "enable-conditions": true}