Batch Update Thresholds
put
/api/restapi/threshold/batch
Send a request to this endpoint to update one or more thresholds.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : List<ApiEntityThresholdInput>
Type:
array
Title:
Show Source
List<ApiEntityThresholdInput>
-
Array of:
object ApiEntityThresholdInput
Title:
ApiEntityThresholdInput
This entity represents a Threshold object, a unique Threshold object can be identified by the following combinations of the fields.- thresholdId
Nested Schema : ApiEntityThresholdInput
Type:
object
Title:
ApiEntityThresholdInput
This entity represents a Threshold object, a unique Threshold object can be identified by the following combinations of the fields.
Show Source
- thresholdId
-
color: string
Maximum Length:
60
The bubble color is shown in the monitoring charts when the threshold criterion is met. -
columnId: integer
(int64)
The unique identifier of a column.
-
columnUpperId: integer
(int64)
The unique identifier of an upper column.
-
costValue: number
(double)
The value which other thresholds are measured against.
-
costValueUpper: number
(double)
The cost measured by the threshold.
Use threshold operators to compare this value to the values in projects and portfolios. -
icon: string
Allowed Values:
[ "THREE_D", "CHECK", "CIRCLE", "CONTENT", "CORRECT", "DIAMOND", "ERROR", "EXCLAMATION", "FLAG", "HAPPY", "OK", "POP_UP", "SAD", "SQUARE", "STAR", "TARGET", "TRIANGLE", "WARNING", "X" ]
The visual indicator associated with the threshold.
The selected icon will display when threshold criteria is met. -
integerValue: integer
(int32)
The numeric value measured by the threshold.
Use threshold operators to compare this value to the values in projects and portfolios. -
integerValueUpper: integer
(int32)
The High Value is only editable if Value is selected and the threshold operator is set to "within range" or "not within range".
High Value allows you to set a maximum value other threshold values can be measured against. -
link: string(url)Read Only:true
Deprecated. As of 23.10.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
numberValue: number
(double)
The maximum value other threshold values are measured against.
-
numberValueUpper: number
(double)
The High Value is only editable if Value is selected and the threshold operator is set to "within range" or "not within range".
High Value allows you to set a maximum value other threshold values can be measured against. -
operator(required): string
Allowed Values:
[ "EQUALS", "GREATER_THAN", "GREATER_THAN_EQUALS", "LESS_THAN_EQUALS", "NOT_EQUALS", "LESS_THAN", "BETWEEN", "NOT_BETWEEN" ]
The logical operator for the threshold.
Values are measured against this logic.
For example, a threshold with an operator of Equals will only display an indicator if the budget plan or project value it measures equals the value set in the threshold. -
sequenceNumber: integer
(int32)
Determines the order of a threshold in a list.
-
stringValue: string
Maximum Length:
30
The value of a threshold string. -
thresholdId: integer
(int64)
The unique identifier of a threshold.
-
type: string
Allowed Values:
[ "FIELD", "VALUE" ]
The type of a threshold. Thresholds of the value type use logical operators to measure fields against a set numeric value. Thresholds of the field type measure the value of one field against the value of another field. -
typeUpper: string
Allowed Values:
[ "FIELD", "VALUE" ]
Thresholds can have a type of Value or Field.
Value: Uses the threshold logical operator to measure fields against a set numeric value.
Field: Checks specified fields against a second field. For example, a threshold measuring Annual Discount Rate with an operator of Equals and a type of Field set to Forecast, will indicate if a project's Annual Discount Rate equals its Forecast. -
updateDate: string(date-time)Read Only:true
Deprecated. As of 23.10.Date when the record was last updated.
Examples
Back to Top
Response
200 Response
A collection of object IDs mapped to a canonical link of the object. For example - {"links":{"1":"https://[host]:[port]/api/restapi/[object]/1","2":"https://[host]:[port]/api/restapi/[object]/2"}}
400 Response
Invalid input for the Threshold service.