{ "openrpc": "1.0.0", "info": { "title": "QIX", "version": "12.2886.0", "description": "The JSON-RPC API over websocket that enables you to interact with the Qlik Associative Engine." }, "methods": [ { "name": "Field.GetCardinal", "description": "Retrieves the number of distinct values in a field.", "params": [], "result": { "name": "Results for Field.GetCardinal", "schema": { "type": "object", "properties": { "qReturn": { "type": "integer" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Get the number of distinct values of a field](#csh-get-number-distinct-values-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.GetAndMode", "description": "Returns the AND mode status of a field.", "params": [], "result": { "name": "Results for Field.GetAndMode", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[SetAndMode method](#services-Field-SetAndMode)", "[Select values in a field](#csh-select-values-in-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.SelectValues", "description": "Selects some values in a field, by entering the values to select.", "params": [ { "name": "qFieldValues", "description": "List of the values to select.", "required": true, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/FieldValue" } } }, { "name": "qToggleMode", "description": "The default value is false.", "schema": { "type": "boolean" } }, { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } } ], "result": { "name": "Results for Field.SelectValues", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Select values in a field](#csh-select-values-in-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.Select", "description": "Selects field values matching a search string.", "params": [ { "name": "qMatch", "description": "String to search for.\nCan contain wild cards or numeric search criteria.\nThe characters <>\"~()='[] have pre-defined meanings when used at the start of the string.\nTo use them, EnableSpecialCharacterEscapingInSearch needs to be enabled and the delimiter \\ needs to precede the special character.", "required": true, "schema": { "type": "string" } }, { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } }, { "name": "qExcludedValuesMode", "description": "Include excluded values in search.", "schema": { "type": "integer" } } ], "result": { "name": "Results for Field.Select", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-stability": "locked" }, { "name": "Field.ToggleSelect", "description": "Toggle selects field values matching a search string.", "params": [ { "name": "qMatch", "description": "String to search for.\nCan contain wild cards or numeric search criteria.", "required": true, "schema": { "type": "string" } }, { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } }, { "name": "qExcludedValuesMode", "description": "Include excluded values in search.", "schema": { "type": "integer" } } ], "result": { "name": "Results for Field.ToggleSelect", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Toggle select values of a field](#csh-toggle-select-values-of-a-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.ClearAllButThis", "description": "Maintains the selections in the current field while clearing the selections in the other fields.", "params": [ { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } } ], "result": { "name": "Results for Field.ClearAllButThis", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Clear the selections in all fields except the current field](#csh-clear-selections-in-all-fields-except-current-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.SelectPossible", "description": "Selects all possible values in a specific field.", "params": [ { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } } ], "result": { "name": "Results for Field.SelectPossible", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Select all possible values of a field](#csh-select-all-possible-values-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.SelectExcluded", "description": "Inverts the current selections.", "params": [ { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } } ], "result": { "name": "Results for Field.SelectExcluded", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Invert the current selections](#csh-invert-current-selections)" ], "x-qlik-stability": "locked" }, { "name": "Field.SelectAll", "description": "Selects all values of a field. Excluded values are also selected.", "params": [ { "name": "qSoftLock", "description": "Set to true to ignore locks; in that case, locked fields can be selected.\nThe default value is false.", "schema": { "type": "boolean" } } ], "result": { "name": "Results for Field.SelectAll", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-see-also": [ "[Select all values of a field](#csh-select-all-values-field)", "[Create and apply a bookmark](#csh-create-and-apply-bookmark)", "[Clear the selections of a specific field](#csh-clear-selections-specific-field)" ], "x-qlik-stability": "locked" }, { "name": "Field.Lock", "description": "Locks all selected values of a specific field.", "params": [], "result": { "name": "Results for Field.Lock", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-stability": "locked" }, { "name": "Field.Unlock", "description": "Unlocks all selected values of a specific field if the target (or handle ) is a field.", "params": [], "result": { "name": "Results for Field.Unlock", "schema": { "type": "object", "properties": { "qReturn": { "type": "boolean" } } } }, "errors": [ { "$ref": "#/components/errors/GenericErrors" } ], "x-qlik-stability": "locked" }, { "name": "Field.GetNxProperties", "description": "Gets the properties of a field.\n\n
| Name | \nDescription | \nType | \n
|---|---|---|
| qNum | \nMaximum number of points that a cell can contain. | \nString | \n
| qElemNumber | \nIs set to 0. | \nBoolean | \n
| qState | \nThe default value is L. | \nOne of:\n
| \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qText | \nCoordinates of a cell in the measure range. “qText”: “[[<left>, <top>, <right>, <bottom>], [<left>, <top>, <right>, <bottom>], .... [<left>, <top>, <right>, <bottom>]] Where: < left >, < top >, < right > and < bottom > are the coordinates of the cell in the measure range. | \nString | \n
| qNum | \nNumber of points in the cell. | \nDouble precision floating point | \n
| qElemNumber | \nUnique identifier for each cell, calculated by the engine during the construction of the grid. This element number is not stored in the database and can have a positive or a negative value. | \nInteger | \n
| qState | \nThe default value is L. | \nOne of:\n
| \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qText | \nText value of the dimension or the measure. | \nString | \n
| qNum | \nNumerical value of the dimension or the measure. Is set to 0 if the value is only text. | \nDouble precision floating point | \n
| qElemNumber | \nUnique identifier for each cell, calculated by the engine during the construction of the grid. This element number is not stored in the database and can have a positive or a negative value. | \nInteger | \n
| qState | \nThe default value is L. | \nOne of:\n
| \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qText | \nText related to the field value. | \nString | \n
| qIsNumeric | \nIs set to true if the value is a numeric. Default is false. | \nBoolean | \n
| qNumber | \nNumeric value of the field. This parameter is displayed if qIsNumeric is set to true. | \nDouble | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qText | \nText related to the field value. | \nString | \n
| qIsNumeric | \nIs set to true if the value is a numeric. Default is false. | \nBoolean | \n
| qNumber | \nNumeric value of the field. This parameter is displayed if qIsNumeric is set to true. | \nDouble | \n
| Audit activity log | \nSystem service log | \n
|---|---|
| <MachineName>_AuditActivity_Engine.txt in Qlik Sense Enterprise <MachineName>_AuditActivity_Engine.log in Qlik Sense Desktop | \n<MachineName>_Service_Engine.txt in Qlik Sense Enterprise <MachineName>_Service_Engine.log in Qlik Sense Desktop | \n
| Qlik Sense Enterprise | \nQlik Sense Desktop | \n
|---|---|
| %ProgramData%/Qlik/Sense/Log/Engine | \n%UserProfile%/Documents/Qlik/Sense/Log | \n
| Audit activity log | \nSystem service log | \n
|---|---|
| < MachineName>AuditActivityEngine.txt in Qlik Sense Enterprise < MachineName>AuditActivityEngine.log in Qlik Sense Desktop | \n< MachineName>ServiceEngine.txt in Qlik Sense Enterprise < MachineName>ServiceEngine.log in Qlik Sense Desktop | \n
| Qlik Sense Enterprise | \nQlik Sense Desktop | \n
|---|---|
| %ProgramData%/Qlik/Sense/Log/Engine | \n%UserProfile%/Documents/Qlik/Sense/Log | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qMode | \nError handling mode One of: \n
| \nInteger | \n
| qPartial | \nSet to true for partial reload. The default value is false. | \nBoolean | \n
| qDebug | \nSet to true if debug breakpoints are to be honored. The execution of the script will be in debug mode. The default value is false. | \nBoolean | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qSuccess | \nThe operation is successful if qSuccess is set to True. | \nBoolean | \n
| qScriptLogFile | \nPath to the script log file. | \nString | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qErrLen | \nLength of the word where the error is located. | \nInteger | \n
| qTabIx | \nNumber of the faulty section. | \nInteger | \n
| qLineInTab | \nLine number in the section where the error is located. | \nInteger | \n
| qColInLine | \nPosition of the erroneous text from the beginning of the line. | \nInteger | \n
| qTextPos | \nPosition of the erroneous text from the beginning of the script. | \nInteger | \n
| qSecondaryFailure | \nThe default value is false. | \nBoolean | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qSearchMatchCombinations | \nArray of search combinations. | \nArray of SearchMatchCombination | \n
| Audit activity log | \nSystem service log | \n
|---|---|
| <MachineName>_AuditActivity_Engine.txt in Qlik Sense Enterprise <MachineName>_AuditActivity_Engine.log in Qlik Sense Desktop | \n<MachineName>_ServiceEngine.txt in Qlik Sense Enterprise <MachineName>_ServiceEngine.log in Qlik Sense Desktop | \n
| Qlik Sense Enterprise | \nQlik Sense Desktop | \n
|---|---|
| %ProgramData%/Qlik/Sense/Log/Engine | \n%UserProfile%/Documents/Qlik/Sense/Log | \n
| Audit activity log | \nSystem service log | \n
|---|---|
| <MachineName>AuditActivityEngine.txt in Qlik Sense Enterprise <MachineName>AuditActivityEngine.log in Qlik Sense Desktop | \n<MachineName>ServiceEngine.txt in Qlik Sense Enterprise <MachineName>ServiceEngine.log in Qlik Sense Desktop | \n
| Qlik Sense Enterprise | \nQlik Sense Desktop | \n
|---|---|
| %ProgramData%/Qlik/Sense/Log/Engine | \n%UserProfile%/Documents/Qlik/Sense/Log | \n
| Audit activity log | \nSystem service log | \n
|---|---|
| *<MachineName>_AuditActivityEngine.txt* | \n*<MachineName>_ServiceEngine.txt* | \n
| Name | \nDescription | \nType | \n
|---|---|---|
| qDerivedDefinitionName | \nName of the derived definition. | \nString | \n
| qFieldDefs | \nList of the derived fields. | \nArray of NxDerivedField | \n
| qGroupDefs | \nList of the derived groups. | \nArray of NxDerivedGroup | \n
| qTags | \nList of tags on the derived fields. | \nArray of String | \n