Batch Update Project Actuals

put

/api/restapi/projectActuals/batch

Send a request to this endpoint to update one or more project actuals. For each JSON object provided in the request body, an application object with a matching ID value will be updated to reflect the JSON contents.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json ()
Root Schema : List<ApiEntityProjectActualsInput>
Type: array
Title: List<ApiEntityProjectActualsInput>
Show Source
  • ApiEntityProjectActualsInput
    Title: ApiEntityProjectActualsInput
    This entity represents a ProjectActuals object, a unique ProjectActuals object can be identified by the following combinations of the fields.
    • projectActualsId
    • projectActualsCode,projectId
    • projectActualsCode,projectCode,workspaceCode
Nested Schema : ApiEntityProjectActualsInput
Type: object
Title: ApiEntityProjectActualsInput
This entity represents a ProjectActuals object, a unique ProjectActuals object can be identified by the following combinations of the fields.
  • projectActualsId
  • projectActualsCode,projectId
  • projectActualsCode,projectCode,workspaceCode
Show Source
Nested Schema : configuredFields
Type: array
The list of configured fields for a project actuals.
Show Source
  • ApiEntityProjectActualsConfiguredFieldValueInput
    Title: ApiEntityProjectActualsConfiguredFieldValueInput
    This entity represents a ProjectActualsConfiguredFieldValue object, a unique ProjectActualsConfiguredFieldValue object can be identified by the following combinations of the fields.
    • projectActualsConfiguredFieldValueId
    • columnDefinitionId
    • columnName
    • columnLabel
Nested Schema : projectActualsCost
An object containing cost fields in the form of key-value pairs.
Match All
Show Source
Nested Schema : ApiEntityProjectActualsConfiguredFieldValueInput
Type: object
Title: ApiEntityProjectActualsConfiguredFieldValueInput
This entity represents a ProjectActualsConfiguredFieldValue object, a unique ProjectActualsConfiguredFieldValue object can be identified by the following combinations of the fields.
  • projectActualsConfiguredFieldValueId
  • columnDefinitionId
  • columnName
  • columnLabel
Show Source
  • Allowed Values: [ "DELETE" ]
    Provide value for this field during object update to delete the assigned configured field value.
  • Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
  • Minimum Length: 1
    Maximum Length: 100
    The user-specified UDF column label.
  • Minimum Length: 1
    Maximum Length: 100
    The user-specified UDF column name.
  • Read Only: true
    Deprecated. As of 23.10.
    This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.
  • Deprecated. As of 23.11.
    This holds value of Cost type configured fields in the project level currency conversion. Input should be provided in numberValue field, in project actuals record level currency.
  • Read Only: true
    Deprecated. As of 23.10.
    This holds values for Cost type configured fields in the workspace1 currency conversion.
  • Read Only: true
    Deprecated. As of 23.10.
    This holds values for Cost type configured fields in the workspace2 currency conversion.
  • Read Only: true
    Deprecated. As of 23.10.
    This holds values for Cost type configured fields in the workspace3 currency conversion.
  • This holds values for Date type configured fields.
  • Read Only: true
    Maximum Length: 4000
    Deprecated. As of 23.10.
    Provides the error message for why the formula calculation resulted in an error.
  • Read Only: true
    Deprecated. As of 23.10.
    Determines if formula calculation hit an error calculating a value for this field.
  • 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.
  • The unique identifier for the Project Actuals Configured Field.
  • The system-generated identifier for an Actual.
  • Maximum Length: 4000
    This holds values for Boolean, List and Text type configured fields.
  • Read Only: true
    Deprecated. As of 23.10.
    Date when the record was last updated.
Nested Schema : ApiEntityProjectActualsCostInput
Type: object
Title: ApiEntityProjectActualsCostInput
Show Source
  • projectActuals
    The supporting details for the project actuals.
  • The unique identifier of project actual data.
  • Read Only: true
    Deprecated. As of 23.11.
    Total Amount is calculated as the sum of the Amount of each actual line item. The value can be positive or negative. This field is in base currency and is calculated from totalAmountProject field based on the specified exchange rate.
  • Read Only: true
    Deprecated. As of 23.11.
    The total amount value for a project. Calculated as the sum of the amount of each actual line item. This value is based on the project currency.
  • Read Only: true
    Deprecated. As of 23.11.
    The total amount value for a project. Calculated as the sum of the amount of each actual line item. This value is based on the record level currency.
  • Read Only: true
    Deprecated. As of 23.11.
    The total amount value for a workspace. Calculated as the sum of the amount of each actual line item. This value is based on the workspace1 currency.
  • Read Only: true
    Deprecated. As of 23.11.
    The total amount value for a workspace. Calculated as the sum of the amount of each actual line item. This value is based on the workspace2 currency.
  • Read Only: true
    Deprecated. As of 23.11.
    The total amount value for a workspace. Calculated as the sum of the amount of each actual line item. This value is based on the workspace3 currency.
  • Read Only: true
    Deprecated. As of 23.10.
    Date when the record was last updated.
Nested Schema : projectActuals
The supporting details for the project actuals.
Match All
Show Source
  • ApiEntityProjectActualsInput
    Title: ApiEntityProjectActualsInput
    This entity represents a ProjectActuals object, a unique ProjectActuals object can be identified by the following combinations of the fields.
    • projectActualsId
    • projectActualsCode,projectId
    • projectActualsCode,projectCode,workspaceCode
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

Project Actuals with the specified ID does not exist or has been deleted.
Back to Top