Field Values Query Parameter Usage
In order to transfer field values to the report, you need to use the fieldValues query parameter.
It represents an encoded JSON string. The process of the formation of this string is divided into three stages.
Form JS object representation of values that should be passed.
Convert JS object to JSON string.
Pass encoded JSON string as a fieldValues query parameter.
Example:
// Form JS object representation of values that should be passed const fieldValues = {"stringField": "testString"}; // Convert JS object to JSON string const fieldValuesJSON = JSON.stringify(fieldValues); // Pass encoded JSON string as a fieldValues query parameter (in address line) ?fieldValues=${encodeURI(fieldValuesJSON)}
List of field values
Input parameter type | Expected format | Data example |
---|---|---|
String | <string> | “testString” |
Number | <number> | 10001 |
Issue Picker | { “label”: <string>, “value”: <string> } | { "label": "KT32-4 Issue A", "value": "KT32-4" } |
Date | YYYY-MM-DD | "2021-08-08" |
Checkbox | <boolean> | true |
Textarea | <string> | “Textarea Text" |
Radio Button | <string> (option value) | “optionValue” |
JQL | <string> | "assignee = currentUser()" |
Project Picker | { “label”: <string>, “value”: <string> } | { "label": "First Project (FP)", "value": "FP" } |
User Picker | { “label”: <string>, “value”: <string> } | { "label": "User Name", "value": "41abdsbfe17eda2b3fdd0565" } |
Data Range Picker | { “start” : YYYY-MM-DD, “end”: YYYY-MM-DD, “definedPeriod”: <periodValue> } | { "start": "2021-08-15", "end": "2021-08-21", "definedPeriod": null } |
Field Picker | { “label”: <string>, “value”: <string> } | { "label": "Created", "value": "created", } |
Issue Type Picker | { “label”: <string>, “value”: <string> } | "issueTypeField": { "label": "Task", "value": "10002" } |
Select List | <string> (option value) | “selectItemValue” |
Example:
{ "stringField": "testString", "numberField": 10001, "issuePickerField": { "label": "KT32-4 Issue A", "value": "KT32-4" }, "dateField": "2021-08-08", "checkboxField": true, "textareaField": "Textarea Text", "radioButtonField": "optionValue", "jqlField": "assignee %3D currentUser() ", "projectField": { "label": "First Project (FP)", "value": "FP" }, "userPickerField": { "label": "User Name", "value": "41abdsbfe17eda2b3fdd0565" }, "rangeField": { "start": "2021-08-15", "end": "2021-08-21", "definedPeriod": null }, "fieldsPicker": { "label": "Created", "value": "created" }, "issueTypeField": { "label": "Task", "value": "10002" }, "selectField": "selectItemValue" }