Batch Update Strategies
put
/api/restapi/strategy/batch
Send a request to this endpoint to update one or more strategy configured fields.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : List<ApiEntityStrategyInput>
Type:
array
Title:
Show Source
List<ApiEntityStrategyInput>
-
Array of:
object ApiEntityStrategyInput
Title:
ApiEntityStrategyInput
This entity represents a Strategy object, a unique Strategy object can be identified by the following combinations of the fields.- strategyId
- strategyName,workspaceId
- strategyName,workspaceCode
Nested Schema : ApiEntityStrategyInput
Type:
object
Title:
ApiEntityStrategyInput
This entity represents a Strategy object, a unique Strategy object can be identified by the following combinations of the fields.
Show Source
- strategyId
- strategyName,workspaceId
- strategyName,workspaceCode
-
codeValuesStrategy: array
codeValuesStrategy
The list of code values for a strategy. This entity can only be used to assign codeValues or create codeValues on the fly.
-
configuredFields: array
configuredFields
The list of configured fields for a strategy.
-
description: string
Maximum Length:
4000
A detailed description of a strategy. -
ownerId(required): integer
(int64)
The system-generated identifier of the user responsible for executing the strategy.
-
parentStrategyId: integer
(int64)
The system-generated identifier of the parent strategy of the strategy.
-
seqNum: integer
(int64)
The sequence number of the strategy.
-
status(required): string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
The status of the strategy. -
strategyId: integer
(int64)
The system-generated identifier of the strategy.
-
strategyName(required): string
Maximum Length:
255
The name of a strategy. -
strategyTypeId(required): integer
(int64)
The system-generated identifier of the level of the strategy.
-
weight: number
(double)
The relative weight of the sibling strategy node to indicate the contribution of a given node to its parent strategy node.
-
weightPct(required): number
(double)
The weight or relative rank of the strategy node compared to its siblings. The value indicates the percentage that the strategy node is contributing to the parent strategy. The weight percentage for all sibling strategy nodes totals 100.
-
workspaceCode: string
Maximum Length:
60
The user-specified identifier of a workspace. -
workspaceId(required): integer
(int64)
The system-generated identifier of a workspace.
Nested Schema : codeValuesStrategy
Type:
array
The list of code values for a strategy. This entity can only be used to assign codeValues or create codeValues on the fly.
Show Source
-
Array of:
object ApiEntityCodeValueStrategyInput
Title:
ApiEntityCodeValueStrategyInput
This entity represents a CodeValueStrategy object, a unique CodeValueStrategy object can be identified by the following combinations of the fields.- codeValueStrategyId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeValueId
- codeTypeCode,codeValueCode,parentId
- codeValueCode,codeTypeId,parentId
Nested Schema : configuredFields
Type:
array
The list of configured fields for a strategy.
Show Source
-
Array of:
object ApiEntityStrategyConfiguredFieldValueInput
Title:
ApiEntityStrategyConfiguredFieldValueInput
This entity represents a StrategyConfiguredFieldValue object, a unique StrategyConfiguredFieldValue object can be identified by the following combinations of the fields.- columnDefinitionId
- columnName
- columnLabel
Nested Schema : ApiEntityCodeValueStrategyInput
Type:
object
Title:
ApiEntityCodeValueStrategyInput
This entity represents a CodeValueStrategy object, a unique CodeValueStrategy object can be identified by the following combinations of the fields.
Show Source
- codeValueStrategyId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeValueId
- codeTypeCode,codeValueCode,parentId
- codeValueCode,codeTypeId,parentId
-
action: string
Allowed Values:
[ "DELETE" ]
Provide a value for this field during object update to delete code value assigned to the object. -
codeTypeCode: string
Minimum Length:
0
Maximum Length:60
This field displays the name of a code or value. -
codeTypeId(required): integer
(int64)
The unique identifier for the code type.The code type object can also be identified by its unique criteria.
-
codeValueCode(required): string
Minimum Length:
1
Maximum Length:60
The unique identifier for the code value. -
codeValueId: integer
(int64)
The unique identifier for the code value.
-
codeValueName: string
Minimum Length:
1
Maximum Length:255
The name of the code value. -
codeValueStrategyId: integer
(int64)
The system-generated identifier of a strategy.
-
parentId: integer
(int64)
The unique identifier of a parent code value.
-
projectCode: string
Minimum Length:
1
Maximum Length:60
The code of a Project of a Project CodeType. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
strategyId: integer
(int64)
The system-generated identifier of the strategy.
Nested Schema : ApiEntityStrategyConfiguredFieldValueInput
Type:
object
Title:
ApiEntityStrategyConfiguredFieldValueInput
This entity represents a StrategyConfiguredFieldValue object, a unique StrategyConfiguredFieldValue object can be identified by the following combinations of the fields.
Show Source
- columnDefinitionId
- columnName
- columnLabel
-
action: string
Allowed Values:
[ "DELETE" ]
Provide value for this field during object update to delete the assigned configured field value. -
columnDefinitionId: integer
(int64)
Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
-
columnLabel: string
Minimum Length:
1
Maximum Length:100
The user-specified UDF column label. -
columnName: string
Minimum Length:
1
Maximum Length:100
The user-specified UDF column name. -
dateValue: string
(date-time)
This holds values for Date type configured fields.
-
numberValue: number
This holds values for Number, Integer and Cost type configured fields. Input for the cost configured field should be provided in the currency of record. For example project level currency in case of Activity, base currency for Company, workspace currency for Funds and record level currency for Project Actuals etc. configured fields.
-
strategyId: integer
(int64)
The system-generated identifier of the strategy.
-
textValue: string
Maximum Length:
4000
This holds values for Boolean, List and Text type configured fields.
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 Strategy service.