Update Project Funds
put
/api/restapi/funds/project/batch
Send a request to this endpoint to update one or more project funds.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : List<ApiEntityFundInput>
Type:
array
Title:
Show Source
List<ApiEntityFundInput>
-
Array of:
object ApiEntityFundInput
Title:
ApiEntityFundInput
Nested Schema : ApiEntityFundInput
Type:
object
Title:
Show Source
ApiEntityFundInput
-
appropriationType: string
Allowed Values:
[ "NONE", "MANUAL", "FROM_ALLOCATION" ]
The type of appropriation. -
capitalPortfolioId: integer
(int64)
The unique identifier for the portfolio.The portfolio object can also be identified by its unique criteria.
-
codeValuesFund: array
codeValuesFund
The list of code values for a fund. 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 fund.
-
consumptionType: string
Allowed Values:
[ "NONE", "MANUAL", "FROM_ALLOCATION", "FROM_ACTUAL" ]
The type of consumption. -
distributionType: string
Allowed Values:
[ "YEARLY", "QUARTERLY", "MONTHLY", "LUMP_SUM" ]
Specifies how money is distributed for the fund. -
endDate(required): string
(date-time)
The date when money in the fund will no longer be available.
-
fromAllocation: boolean
Specifies whether the fund has allocations.
-
fundCode(required): string
Minimum Length:
1
Maximum Length:60
The unique identification code of the fund. -
fundCost:
fundCost
Defines the fund cost of a fund.
-
fundId: integer
(int64)
The system generated identifier of a fund.
-
fundName(required): string
Minimum Length:
1
Maximum Length:255
The name of the fund. -
fundStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
Either Active or Inactive. Inactive funds cannot be allocated or appropriated. They can only be consumed for projects or programs. -
hasAllocations: boolean
Specifies whether the fund has allocations.
-
parentFundCode: string
Minimum Length:
1
Maximum Length:60
The unique identification code of the fund. -
parentFundId: integer
(int64)
The unique identification code of the parent fund.
-
parentWorkspaceCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of a workspace. -
parentWorkspaceId: integer
(int64)
The user-specified identifier of a workspace.
-
portfolioCode: string
Minimum Length:
1
Maximum Length:255
The name of the portfolio. -
programCode: string
Maximum Length:
60
The user-specified unique identifier of a program. -
programId: integer
(int64)
The system-generated unique identifier of a program.
-
projectCode: string
Minimum Length:
1
Maximum Length:60
The unique identifier for a project set by the user who created the project. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
spreadRows: array
spreadRows
Defines the spread rows for a fund.
-
startDate(required): string
(date-time)
The date when money in the fund will start being available.
-
type: string
Allowed Values:
[ "WORKSPACE_FUND", "PROJECT_FUND", "PORTFOLIO_FUND", "PROGRAM_FUND" ]
The kind of object with which the fund is associated. This can either be Project, Program or Workspace. -
workspaceCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.
Nested Schema : codeValuesFund
Type:
array
The list of code values for a fund. This entity can only be used to assign codeValues or create codeValues on the fly.
Show Source
-
Array of:
object ApiEntityCodeValueFundInput
Title:
ApiEntityCodeValueFundInput
This entity represents a CodeValueFund object, a unique CodeValueFund object can be identified by the following combinations of the fields.- codeValueFundId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
Nested Schema : configuredFields
Type:
array
The list of configured fields for a fund.
Show Source
-
Array of:
object ApiEntityFundConfiguredFieldValueInput
Title:
ApiEntityFundConfiguredFieldValueInput
This entity represents a FundConfiguredFieldValue object, a unique FundConfiguredFieldValue object can be identified by the following combinations of the fields.- fundConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
Nested Schema : fundCost
Defines the fund cost of a fund.
Match All
Defines the fund cost of a fund.
Show Source
-
object
ApiEntityFundCostInput
Title:
ApiEntityFundCostInput
Nested Schema : spreadRows
Type:
array
Defines the spread rows for a fund.
Show Source
-
Array of:
object ApiEntityFundSpreadRowInput
Title:
ApiEntityFundSpreadRowInput
Nested Schema : ApiEntityCodeValueFundInput
Type:
object
Title:
ApiEntityCodeValueFundInput
This entity represents a CodeValueFund object, a unique CodeValueFund object can be identified by the following combinations of the fields.
Show Source
- codeValueFundId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
-
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. -
codeValueFundId: integer
(int64)
The unique identifier for the fund.
-
codeValueId: integer
(int64)
The unique identifier for the code value.
-
codeValueName: string
Minimum Length:
1
Maximum Length:255
The name of the code value. -
fundId: integer
(int64)
The unique identification code of the fund.
-
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.
Nested Schema : ApiEntityFundConfiguredFieldValueInput
Type:
object
Title:
ApiEntityFundConfiguredFieldValueInput
This entity represents a FundConfiguredFieldValue object, a unique FundConfiguredFieldValue object can be identified by the following combinations of the fields.
Show Source
- fundConfiguredFieldValueId
- 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.
-
fundConfiguredFieldValueId: integer
(int64)
The unique identifier for funds configured field
-
fundId: integer
(int64)
The system-generated identifier for funds
-
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.
-
textValue: string
Maximum Length:
4000
This holds values for Boolean, List and Text type configured fields.
Nested Schema : ApiEntityFundCostInput
Type:
object
Title:
Show Source
ApiEntityFundCostInput
-
allocatedCOR: number
(double)
The portion of the fund that has been committed to work on a project. This is an input field, will not be a part of response.
-
allocatedProject: number
(double)
The portion of the fund that has been committed to work on a project. This value is based on the project currency.
-
appropriatedCOR: number
(double)
Minimum Value:
0
The portion of the fund that has been committed to work on a project. This is an input field, will not be a part of response. -
appropriatedProject: number
(double)
Minimum Value:
0
The portion of the fund that has been committed to work on a project. This value is based on the project currency. -
consumedCOR: number
(double)
The portion of the fund that has been spent to complete work on a project. This is an input field, will not be a part of response.
-
consumedProject: number
(double)
The portion of the fund that has been spent to complete work on a project. The portion of the fund that has been spent to complete work on a project. This value is based on the project currency.
-
distributedTotalCOR: number
(double)
The amount of money that has been distributed for the fund. This is an input field, will not be a part of response.
-
distributedTotalProject: number
(double)
The amount of money that has been distributed for the fund. This value is based on the project currency.
-
fundId: integer
(int64)
The system generated identifier of a fund.
-
remainingCOR: number
(double)
The portion of the fund that has not been consumed. This is an input field, will not be a part of response.
-
remainingProject: number
(double)
The portion of the fund that has not been consumed. This value is based on the project currency.
-
totalCOR: number
(double)
Minimum Value:
0
The amount of money granted for the fund. This is an input field, will not be a part of response. -
totalProject: number
(double)
Minimum Value:
0
The amount of money granted for the fund. This value is based on the project currency. -
unallocatedCOR: number
(double)
The portion of the fund that has not been reserved for work on projects or in other workspaces. This is an input field, will not be a part of response.
-
unallocatedProject: number
(double)
The portion of the fund that has not been reserved for work on projects or in other workspaces. This value is based on the project currency.
-
unappropriatedCOR: number
(double)
The portion of the fund that has not yet been committed to actual work. This is an input field, will not be a part of response.
-
unappropriatedProject: number
(double)
The portion of the fund that has not yet been committed to actual work. This value is based on the project currency.
-
undistributedTotalCOR: number
(double)
The amount of money that has not been distributed for the fund. This is an input field, will not be a part of response.
-
undistributedTotalProject: number
(double)
The amount of money that has not been distributed for the fund. This value is based on the project currency.
Nested Schema : ApiEntityFundSpreadRowInput
Type:
object
Title:
Show Source
ApiEntityFundSpreadRowInput
-
fundAllocationSpreadRows: array
fundAllocationSpreadRows
Defines the spread rows for a fund allocation.
-
fundId: integer
(int64)
The system generated identifier of a fund.
-
fundSpreadRowCost:
fundSpreadRowCost
Defines the cost associated with the spread rows of the fund.
-
fundSpreadRowId: integer
(int64)
The unique identification code of the spread row.
-
month: string
(date-time)
The time period during which funding takes place in months.
Nested Schema : fundAllocationSpreadRows
Type:
array
Defines the spread rows for a fund allocation.
Show Source
-
Array of:
object ApiEntityFundAllocationSpreadRowInput
Title:
ApiEntityFundAllocationSpreadRowInput
Nested Schema : fundSpreadRowCost
Defines the cost associated with the spread rows of the fund.
Match All
Defines the cost associated with the spread rows of the fund.
Show Source
-
object
ApiEntityFundCostSpreadRowInput
Title:
ApiEntityFundCostSpreadRowInput
Nested Schema : ApiEntityFundAllocationSpreadRowInput
Type:
object
Title:
Show Source
ApiEntityFundAllocationSpreadRowInput
-
fundAllocationSpreadRowCost:
fundAllocationSpreadRowCost
Defines the cost associated with the spread rows of the workspace total item.
-
fundAllocationSpreadRowId: integer
(int64)
The unique identification code of the allocation row.
-
fundId: integer
(int64)
The unique identification code of the fund.
-
fundSpreadRowId: integer
(int64)
The unique identification code of the spread row.
Nested Schema : fundAllocationSpreadRowCost
Defines the cost associated with the spread rows of the workspace total item.
Match All
Defines the cost associated with the spread rows of the workspace total item.
Show Source
-
object
ApiEntityFundAllocationSpreadRowCostInput
Title:
ApiEntityFundAllocationSpreadRowCostInput
Nested Schema : ApiEntityFundAllocationSpreadRowCostInput
Type:
object
Title:
Show Source
ApiEntityFundAllocationSpreadRowCostInput
-
allocatedCOR: number
(double)
The portion of the fund that has been committed to work on a project. This is an input field, will not be a part of response.
-
allocatedProject: number
(double)
The portion of the fund that has been committed to work on a project. This value is based on the project currency.
-
fundAllocationSpreadRowId: integer
(int64)
The unique identification code of the allocation row.
Nested Schema : ApiEntityFundCostSpreadRowInput
Type:
object
Title:
Show Source
ApiEntityFundCostSpreadRowInput
-
allocatedCOR: number
(double)
The portion of the fund that has been committed to work on a project. This is an input field, will not be a part of response.
-
allocatedProject: number
(double)
The portion of the fund that has been committed to work on a project. This value is based on the project currency.
-
appropriatedCOR: number
(double)
The portion of the fund that has not yet been committed to actual work. This is an input field, will not be a part of response.
-
appropriatedProject: number
(double)
The portion of the fund that has not yet been committed to actual work. This value is based on the project currency.
-
consumedCOR: number
(double)
The portion of the fund that has been spent to complete work on project. This is an input field, will not be a part of response.
-
consumedProject: number
(double)
The portion of the fund that has been spent to complete work on project. This value is based on the project currency.
-
fundSpreadRowId: integer
(int64)
The unique identification code of the spread row.
-
remainingCOR: number
(double)
The portion of the fund that has not been consumed. This is an input field, will not be a part of response.
-
remainingProject: number
(double)
The portion of the fund that has not been consumed. This value is based on the project currency.
-
totalCOR: number
(double)
The amount of money granted for the fund. This is an input field, will not be a part of response.
-
totalProject: number
(double)
The amount of money granted for the fund. This value is based on the project currency.
-
unallocatedCOR: number
(double)
The portion of the fund that has not been reserved for work on projects or in other workspaces. This is an input field, will not be a part of response.
-
unallocatedProject: number
(double)
The portion of the fund that has not been reserved for work on projects or in other workspaces. This value is based on the project currency.
-
unappropriatedCOR: number
(double)
The portion of the fund that has not yet been committed to actual work. This is an input field, will not be a part of response.
-
unappropriatedProject: number
(double)
The portion of the fund that has not yet been committed to actual work. This value is based on the project currency.
Examples
Back to Top
Response
200 Response
A collection of object IDs mapped to a canonical link of the object with corresponding warning messages if any warnings were generated while processing the update request. For example - {"links":{"1":"https://[host]:[port]/api/restapi/[object]/1","2":"https://[host]:[port]/api/restapi/[object]/2"},"warnings":[{"primaryKeyName":"objectIdFieldName","uniqueFieldName":"object_code_01","uniqueFieldValue":"objectCodeFieldName","primaryKeyValue":1,"warningMessages":["warning_message_1","warning_message_2"]}]}
400 Response
Invalid Input.