Jump to

• Request
• Response

View a Program Budget Change

get

/api/restapi/programBudgetChange/{programBudgetChangeId}

This endpoint returns program budget changes that meet the following requirements:

• The object is associated with a program budget change with an ID value that matches the value of the {programBudgetChangeId} path parameter.

Program Budget changes represent modifications or adjustments to program budgets.

Request

Path Parameters

• programBudgetChangeId(required): integer(int64)
  The system-generated identifier of a program budget change.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : ApiEntityProgramBudgetChange

Type: object

Title: ApiEntityProgramBudgetChange

Show Source

• approveByUserId: integer (int64)
  The username of the user that approved the item.
• approveByUserName: string
  Maximum Length: 255

  The name of the user who approved a program budget change.
• approveDate: string (date-time)
  Date the item was approved.
• configuredFields: array configuredFields
  The list of configured fields for a program budget change.
• description: string
  Minimum Length: 0

  Maximum Length: 4000

  Details supporting the change request.
• lastModifiedById: integer (int64)
  The username of the user who last made changes to the item.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• programBudgetChangeCode: string
  Maximum Length: 60

  The unique identifier of the program budget change request.
• programBudgetChangeCost: programBudgetChangeCost
  An object containing the cost fields associated with the program budget change.
• programBudgetChangeId: integer (int64)
  The system-generated identifier of a program budget change.
• programBudgetChangeTransactions: array programBudgetChangeTransactions
  List of all program budget change transactions of a program budget change.
• programBudgetId: integer (int64)
  The system-generated identifier of a program budget.
• programCode: string
  Maximum Length: 60

  The unique identifier for a program set by the user who created the program.
• programId: integer (int64)
  The unique identifier for the program.
• rejectByUserId: integer (int64)
  The username of the user that rejected the item.
• rejectByUserName: string
  Maximum Length: 255

  The name of the user who rejected a program budget change.
• rejectDate: string (date-time)
  Date the item was rejected.
• status: string
  Allowed Values: [ "DRAFT", "PENDING", "REJECTED", "APPROVED" ]

  The state of the program budget change request. Pending: The change request is awaiting a decision. Approved: The change request was approved. Rejected: The change request was not approved.
• submitByUserId: integer (int64)
  The username of the user that submitted the item.
• submitByUserName: string
  Maximum Length: 255

  The name of the user who submitted a program budget change.
• submitDate: string (date-time)
  Date the item was submitted.
• updateDate: string (date-time)
  Date when the record was last updated.
• withdrawApprovalByUserId: integer (int64)
  The username of the user that with withdrew approval of the item.
• withdrawApprovalByUserName: string
  Maximum Length: 255

  The name of the user who withdrew a program budget change.
• withdrawApprovalDate: string (date-time)
  Date the item was withdrawn.
• workspaceCode: string
  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.

{
    "title":"ApiEntityProgramBudgetChange",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "status":{
            "type":"string",
            "description":"The state of the program budget change request. Pending: The change request is awaiting a decision. Approved: The change request was approved. Rejected: The change request was not approved.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "DRAFT",
                "PENDING",
                "REJECTED",
                "APPROVED"
            ]
        },
        "description":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Details supporting the change request.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetChangeCost":{
            "description":"An object containing the cost fields associated with the program budget change.",
            "exampleSetFlag":false,
            "allOf":[
                {
                    "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeCost"
                }
            ]
        },
        "configuredFields":{
            "type":"array",
            "description":"The list of configured fields for a program budget change.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeConfiguredFieldValue",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        },
        "workspaceCode":{
            "maxLength":"60",
            "type":"string",
            "description":"The user-specified identifier of a workspace.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "approveDate":{
            "type":"string",
            "description":"Date the item was approved.",
            "format":"date-time",
            "exampleSetFlag":false
        },
        "workspaceId":{
            "type":"integer",
            "description":"The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programId":{
            "type":"integer",
            "description":"The unique identifier for the program.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programCode":{
            "maxLength":"60",
            "type":"string",
            "description":"The unique identifier for a program set by the user who created the program.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetId":{
            "type":"integer",
            "description":"The system-generated identifier of a program budget.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "approveByUserId":{
            "type":"integer",
            "description":"The username of the user that approved the item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "approveByUserName":{
            "maxLength":"255",
            "type":"string",
            "description":"The name of the user who approved a program budget change.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "lastModifiedById":{
            "type":"integer",
            "description":"The username of the user who last made changes to the item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "rejectByUserId":{
            "type":"integer",
            "description":"The username of the user that rejected the item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "rejectByUserName":{
            "maxLength":"255",
            "type":"string",
            "description":"The name of the user who rejected a program budget change.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "rejectDate":{
            "type":"string",
            "description":"Date the item was rejected.",
            "format":"date-time",
            "exampleSetFlag":false
        },
        "submitByUserId":{
            "type":"integer",
            "description":"The username of the user that submitted the item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "submitByUserName":{
            "maxLength":"255",
            "type":"string",
            "description":"The name of the user who submitted a program budget change.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "submitDate":{
            "type":"string",
            "description":"Date the item was submitted.",
            "format":"date-time",
            "exampleSetFlag":false
        },
        "withdrawApprovalByUserId":{
            "type":"integer",
            "description":"The username of the user that with withdrew approval of the item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "withdrawApprovalByUserName":{
            "maxLength":"255",
            "type":"string",
            "description":"The name of the user who withdrew a program budget change.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "withdrawApprovalDate":{
            "type":"string",
            "description":"Date the item was withdrawn.",
            "format":"date-time",
            "exampleSetFlag":false
        },
        "programBudgetChangeTransactions":{
            "type":"array",
            "description":"List of all program budget change transactions of a program budget change.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeTransaction",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        },
        "programBudgetChangeCode":{
            "maxLength":"60",
            "type":"string",
            "description":"The unique identifier of the program budget change request.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetChangeId":{
            "type":"integer",
            "description":"The system-generated identifier of a program budget change.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : configuredFields

Type: array

The list of configured fields for a program budget change.

Show Source

• Array of: object ApiEntityProgramBudgetChangeConfiguredFieldValue
  Title: ApiEntityProgramBudgetChangeConfiguredFieldValue

{
    "type":"array",
    "description":"The list of configured fields for a program budget change.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeConfiguredFieldValue",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : programBudgetChangeCost

An object containing the cost fields associated with the program budget change.

Match All

Show Source

• object ApiEntityProgramBudgetChangeCost
  Title: ApiEntityProgramBudgetChangeCost

  Read Only: true

  This entity represents a ProgramBudgetChangeCost object, a unique ProgramBudgetChangeCost object can be identified by the following combinations of the fields.

  • programBudgetChangeId

{
    "description":"An object containing the cost fields associated with the program budget change.",
    "exampleSetFlag":false,
    "allOf":[
        {
            "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeCost"
        }
    ]
}

Nested Schema : programBudgetChangeTransactions

Type: array

List of all program budget change transactions of a program budget change.

Show Source

• Array of: object ApiEntityProgramBudgetChangeTransaction
  Title: ApiEntityProgramBudgetChangeTransaction

{
    "type":"array",
    "description":"List of all program budget change transactions of a program budget change.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityProgramBudgetChangeTransaction",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityProgramBudgetChangeConfiguredFieldValue

Type: object

Title: ApiEntityProgramBudgetChangeConfiguredFieldValue

Show Source

• 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.
• costValue: number
  This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.
• costValueWorkspace1: number (double)
  This holds values for Cost type configured fields in the workspace1 currency conversion.
• costValueWorkspace2: number (double)
  This holds values for Cost type configured fields in the workspace2 currency conversion.
• costValueWorkspace3: number (double)
  This holds values for Cost type configured fields in the workspace3 currency conversion.
• dateValue: string (date-time)
  This holds values for Date type configured fields.
• exceptionMessage: string
  Maximum Length: 4000

  Provides the error message for why the formula calculation resulted in an error.
• hasException: boolean
  Determines if formula calculation hit an error calculating a value for this field.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• 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.
• programBudgetChangeConfiguredFieldValueId: integer (int64)
  The system generated identifier of a Program Budget Change Configured Field assigned to a Program Budget Change.
• programBudgetChangeId: integer (int64)
  The system-generated identifier of a Program Budget Change.
• textValue: string
  Maximum Length: 4000

  This holds values for Boolean, List and Text type configured fields.
• updateDate: string (date-time)
  Date when the record was last updated.

{
    "title":"ApiEntityProgramBudgetChangeConfiguredFieldValue",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetChangeId":{
            "type":"integer",
            "description":"The system-generated identifier of a Program Budget Change.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programBudgetChangeConfiguredFieldValueId":{
            "type":"integer",
            "description":"The system generated identifier of a Program Budget Change Configured Field assigned to a Program Budget Change.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "columnName":{
            "maxLength":"100",
            "minLength":"1",
            "type":"string",
            "description":"The user-specified UDF column name.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "numberValue":{
            "type":"number",
            "description":"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.",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "columnLabel":{
            "maxLength":"100",
            "minLength":"1",
            "type":"string",
            "description":"The user-specified UDF column label.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "columnDefinitionId":{
            "type":"integer",
            "description":"Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "textValue":{
            "maxLength":"4000",
            "type":"string",
            "description":"This holds values for Boolean, List and Text type configured fields.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "dateValue":{
            "type":"string",
            "description":"This holds values for Date type configured fields.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "costValue":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "hasException":{
            "type":"boolean",
            "description":"Determines if formula calculation hit an error calculating a value for this field.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "exceptionMessage":{
            "maxLength":"4000",
            "type":"string",
            "description":"Provides the error message for why the formula calculation resulted in an error.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "costValueWorkspace1":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace1 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "costValueWorkspace2":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace2 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "costValueWorkspace3":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace3 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "action":{
            "type":"string",
            "description":"Provide value for this field during object update to delete the assigned configured field value.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "DELETE"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : ApiEntityProgramBudgetChangeCost

Type: object

Title: ApiEntityProgramBudgetChangeCost

Read Only: true

This entity represents a ProgramBudgetChangeCost object, a unique ProgramBudgetChangeCost object can be identified by the following combinations of the fields.

• programBudgetChangeId

Show Source

• link: string (url)
  Read Only: true

  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• programBudgetChangeId: integer (int64)
  The system-generated identifier of a program budget change.
• totalCost: number (double)
  The cost to be added or subtracted from the program budget.
• totalCostWorkspace1: number (double)
  The cost to be added or subtracted from the program budget, based on the workspace1 currency.
• totalCostWorkspace2: number (double)
  The cost to be added or subtracted from the program budget, based on the workspace2 currency.
• totalCostWorkspace3: number (double)
  The cost to be added or subtracted from the program budget, based on the workspace3 currency.
• updateDate: string (date-time)
  Read Only: true

  Date when the record was last updated.

{
    "title":"ApiEntityProgramBudgetChangeCost",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "readOnly":true,
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "totalCost":{
            "type":"number",
            "description":"The cost to be added or subtracted from the program budget.",
            "format":"double",
            "exampleSetFlag":false
        },
        "totalCostWorkspace1":{
            "type":"number",
            "description":"The cost to be added or subtracted from the program budget, based on the workspace1 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "programBudgetChangeId":{
            "type":"integer",
            "description":"The system-generated identifier of a program budget change.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "totalCostWorkspace2":{
            "type":"number",
            "description":"The cost to be added or subtracted from the program budget, based on the workspace2 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "totalCostWorkspace3":{
            "type":"number",
            "description":"The cost to be added or subtracted from the program budget, based on the workspace3 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "readOnly":true,
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "description":"This entity represents a ProgramBudgetChangeCost object, a unique ProgramBudgetChangeCost object can be identified by the following combinations of the fields.<ul><li>programBudgetChangeId</li>",
    "readOnly":true,
    "exampleSetFlag":false
}

Nested Schema : ApiEntityProgramBudgetChangeTransaction

Type: object

Title: ApiEntityProgramBudgetChangeTransaction

Show Source

• action: string
  Allowed Values: [ "DELETE" ]

  Deprecated. As of 23.4.
  Provide value for this field during object update to delete the assigned configured field value.
• approveDate: string (date-time)
  The date the transaction was approved.
• budgetCbsTemplateCodeId: integer (int64)
  The name of the CBS Code associated with the budget line item.
• budgetCostCategoryId: integer (int64)
  The type of cost associated with the budget line item.
• budgetHours: number (double)
  The number of hours needed to complete the budget details line item. Calculated as Production Rate multiplied by Quantity.
• changeMode: string
  Allowed Values: [ "AUTO", "MANUAL", "CHANGE" ]

  specifies the mode of the program budget change transaction.
• configuredFields: array configuredFields
  The list of configured fields for a program budget change transaction.
• desiredCode: string
  Minimum Length: 0

  Maximum Length: 60

  The user-specified identifier of a program budget item to be provided while adding a new program budget item through a program budget change.
• productionRate: number (double)
  Minimum Value: 0.000010

  The number of hours per unit of measure needed to complete the budget line item.
• programBudgetChangeId: integer (int64)
  The system-generated identifier of a program budget change.
• programBudgetItemId: integer (int64)
  A unique identifier for the budget item (Change Budget Line).
• programBudgetItemName: string
  Maximum Length: 255

  The name of the budget item.
• programBudgetTransactionCode: string
  Maximum Length: 60

  The unique identifier for the budget line item.
• programBudgetTransactionCost: programBudgetTransactionCost
  The cost data of a program budget transaction.
• programBudgetTransactionId: integer (int64)
  The system-generated identifier for a transaction.
• quantity: number (double)
  The number of each budget line item needed to complete the work.
• status: string
  Allowed Values: [ "DRAFT", "PENDING", "REJECTED", "APPROVED" ]

  The status of the transaction. Indicates whether the transaction is approved, pending, draft, or rejected.
• transactionType: string
  Allowed Values: [ "ORIGINAL", "CHANGE", "TRANSFER" ]

  Specifies whether the budget row is an original, change, or transfer value.
• unitOfMeasureId: integer (int64)
  The Unit of Measure used for the budget line item detail.

{
    "title":"ApiEntityProgramBudgetChangeTransaction",
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"The status of the transaction. Indicates whether the transaction is approved, pending, draft, or rejected.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "DRAFT",
                "PENDING",
                "REJECTED",
                "APPROVED"
            ]
        },
        "action":{
            "type":"string",
            "description":"<b>Deprecated.</b> As of <i>23.4</i>.</br>Provide value for this field during object update to delete the assigned configured field value.",
            "deprecated":true,
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "DELETE"
            ]
        },
        "configuredFields":{
            "type":"array",
            "description":"The list of configured fields for a program budget change transaction.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/ApiEntityProgramBudgetTransactionConfiguredFieldValue",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        },
        "transactionType":{
            "type":"string",
            "description":"Specifies whether the budget row is an original, change, or transfer value.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "ORIGINAL",
                "CHANGE",
                "TRANSFER"
            ]
        },
        "unitOfMeasureId":{
            "type":"integer",
            "description":"The Unit of Measure used for the budget line item detail.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "quantity":{
            "type":"number",
            "description":"The number of each budget line item needed to complete the work.",
            "format":"double",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "productionRate":{
            "minimum":"0.000010",
            "type":"number",
            "description":"The number of hours per unit of measure needed to complete the budget line item.",
            "format":"double",
            "exampleSetFlag":false
        },
        "budgetHours":{
            "type":"number",
            "description":"The number of hours needed to complete the budget details line item. Calculated as Production Rate multiplied by Quantity.",
            "format":"double",
            "exampleSetFlag":false
        },
        "budgetCostCategoryId":{
            "type":"integer",
            "description":"The type of cost associated with the budget line item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "approveDate":{
            "type":"string",
            "description":"The date the transaction was approved.",
            "format":"date-time",
            "exampleSetFlag":false
        },
        "budgetCbsTemplateCodeId":{
            "type":"integer",
            "description":"The name of the CBS Code associated with the budget line item.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programBudgetItemId":{
            "type":"integer",
            "description":"A unique identifier for the budget item (Change Budget Line).",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programBudgetItemName":{
            "maxLength":"255",
            "type":"string",
            "description":"The name of the budget item.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetTransactionCode":{
            "maxLength":"60",
            "type":"string",
            "description":"The unique identifier for the budget line item.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetTransactionId":{
            "type":"integer",
            "description":"The system-generated identifier for a transaction.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programBudgetChangeId":{
            "type":"integer",
            "description":"The system-generated identifier of a program budget change.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "changeMode":{
            "type":"string",
            "description":"specifies the mode of the program budget change transaction.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "AUTO",
                "MANUAL",
                "CHANGE"
            ]
        },
        "desiredCode":{
            "maxLength":"60",
            "minLength":"0",
            "type":"string",
            "description":"The user-specified identifier of a program budget item to be provided while adding a new program budget item through a program budget change.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetTransactionCost":{
            "description":"The cost data of a program budget transaction.",
            "exampleSetFlag":false,
            "allOf":[
                {
                    "$ref":"#/components/schemas/ApiEntityProgramBudgetTransactionCost"
                }
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : configuredFields

Type: array

The list of configured fields for a program budget change transaction.

Show Source

• Array of: object ApiEntityProgramBudgetTransactionConfiguredFieldValue
  Title: ApiEntityProgramBudgetTransactionConfiguredFieldValue

{
    "type":"array",
    "description":"The list of configured fields for a program budget change transaction.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityProgramBudgetTransactionConfiguredFieldValue",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : programBudgetTransactionCost

The cost data of a program budget transaction.

Match All

Show Source

• object ApiEntityProgramBudgetTransactionCost
  Title: ApiEntityProgramBudgetTransactionCost

{
    "description":"The cost data of a program budget transaction.",
    "exampleSetFlag":false,
    "allOf":[
        {
            "$ref":"#/components/schemas/ApiEntityProgramBudgetTransactionCost"
        }
    ]
}

Nested Schema : ApiEntityProgramBudgetTransactionConfiguredFieldValue

Type: object

Title: ApiEntityProgramBudgetTransactionConfiguredFieldValue

Show Source

• 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.
• costValue: number
  This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.
• costValueWorkspace1: number (double)
  This holds values for Cost type configured fields in the workspace1 currency conversion.
• costValueWorkspace2: number (double)
  This holds values for Cost type configured fields in the workspace2 currency conversion.
• costValueWorkspace3: number (double)
  This holds values for Cost type configured fields in the workspace3 currency conversion.
• dateValue: string (date-time)
  This holds values for Date type configured fields.
• exceptionMessage: string
  Maximum Length: 4000

  Provides the error message for why the formula calculation resulted in an error.
• hasException: boolean
  Determines if formula calculation hit an error calculating a value for this field.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• 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.
• programBudgetTransactionConfiguredFieldValueId: integer (int64)
  The system generated identifier of a Program Budget Transaction Configured Field assigned to a Program Budget Transaction.
• programBudgetTransactionId: integer (int64)
  The system-generated identifier of a Program Budget Transaction.
• textValue: string
  Maximum Length: 4000

  This holds values for Boolean, List and Text type configured fields.
• updateDate: string (date-time)
  Date when the record was last updated.

{
    "title":"ApiEntityProgramBudgetTransactionConfiguredFieldValue",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "programBudgetTransactionId":{
            "type":"integer",
            "description":"The system-generated identifier of a Program Budget Transaction.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "programBudgetTransactionConfiguredFieldValueId":{
            "type":"integer",
            "description":"The system generated identifier of a Program Budget Transaction Configured Field assigned to a Program Budget Transaction.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "columnName":{
            "maxLength":"100",
            "minLength":"1",
            "type":"string",
            "description":"The user-specified UDF column name.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "numberValue":{
            "type":"number",
            "description":"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.",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "columnLabel":{
            "maxLength":"100",
            "minLength":"1",
            "type":"string",
            "description":"The user-specified UDF column label.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "columnDefinitionId":{
            "type":"integer",
            "description":"Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "textValue":{
            "maxLength":"4000",
            "type":"string",
            "description":"This holds values for Boolean, List and Text type configured fields.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "dateValue":{
            "type":"string",
            "description":"This holds values for Date type configured fields.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "costValue":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.",
            "exampleSetFlag":false,
            "types":[
                "number"
            ]
        },
        "hasException":{
            "type":"boolean",
            "description":"Determines if formula calculation hit an error calculating a value for this field.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "exceptionMessage":{
            "maxLength":"4000",
            "type":"string",
            "description":"Provides the error message for why the formula calculation resulted in an error.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "costValueWorkspace1":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace1 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "costValueWorkspace2":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace2 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "costValueWorkspace3":{
            "type":"number",
            "description":"This holds values for Cost type configured fields in the workspace3 currency conversion.",
            "format":"double",
            "exampleSetFlag":false
        },
        "action":{
            "type":"string",
            "description":"Provide value for this field during object update to delete the assigned configured field value.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "DELETE"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : ApiEntityProgramBudgetTransactionCost

Type: object

Title: ApiEntityProgramBudgetTransactionCost

Show Source

• amountCost: number (double)
  The amount that the budget row has changed as the result of transactions.
• amountCostWorkspace1: number (double)
  The amount that the budget row has changed as the result of transactions, based on the workspace1 currency.
• amountCostWorkspace2: number (double)
  The amount that the budget row has changed as the result of transactions, based on the workspace2 currency.
• amountCostWorkspace3: number (double)
  The amount that the budget row has changed as the result of transactions, based on the workspace3 currency.
• currentCost: number (double)
  The current cost of the associated budget line item.
• currentCostWorkspace1: number (double)
  The total cost of the program budget, including all transfers and changes, based on the workspace1 currency.
• currentCostWorkspace2: number (double)
  The total cost of the program budget, including all transfers and changes, based on the workspace2 currency.
• currentCostWorkspace3: number (double)
  The total cost of the program budget, including all transfers and changes, based on the workspace3 currency.
• laborRate: number (double)
  The cost per labor hour of the budget line item detail.
• laborRateWorkspace1: number (double)
  The cost per labor hour of the budget line item based on the workspace1 currency.
• laborRateWorkspace2: number (double)
  The cost per labor hour of the budget line item based on the workspace2 currency.
• laborRateWorkspace3: number (double)
  The cost per labor hour of the budget line item based on the workspace3 currency.
• link: string (url)
  The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
• programBudgetTransactionId: integer (int64)
  The system-generated identifier for a transaction.
• unitRate: number (double)
  The cost per Unit of Measure for the budget line item detail.
• unitRateWorkspace1: number (double)
  The cost per Unit of Measure for the budget line item based on the workspace1 currency.
• unitRateWorkspace2: number (double)
  The cost per Unit of Measure for the budget line item based on the workspace3 currency.
• unitRateWorkspace3: number (double)
  The cost per Unit of Measure for the budget line item based on the workspace2 currency.
• updateDate: string (date-time)
  Date when the record was last updated.

{
    "title":"ApiEntityProgramBudgetTransactionCost",
    "type":"object",
    "properties":{
        "link":{
            "type":"string",
            "description":"The self-link to the object. This field is populated only in the responses generated by the <i>batch create</i> APIs.",
            "format":"url",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "currentCost":{
            "type":"number",
            "description":"The current cost of the associated budget line item.",
            "format":"double",
            "exampleSetFlag":false
        },
        "unitRate":{
            "type":"number",
            "description":"The cost per Unit of Measure for the budget line item detail.",
            "format":"double",
            "exampleSetFlag":false
        },
        "unitRateWorkspace1":{
            "type":"number",
            "description":"The cost per Unit of Measure for the budget line item based on the workspace1 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "unitRateWorkspace2":{
            "type":"number",
            "description":"The cost per Unit of Measure for the budget line item based on the workspace3 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "unitRateWorkspace3":{
            "type":"number",
            "description":"The cost per Unit of Measure for the budget line item based on the workspace2 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "laborRate":{
            "type":"number",
            "description":"The cost per labor hour of the budget line item detail.",
            "format":"double",
            "exampleSetFlag":false
        },
        "laborRateWorkspace1":{
            "type":"number",
            "description":"The cost per labor hour of the budget line item based on the workspace1 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "laborRateWorkspace2":{
            "type":"number",
            "description":"The cost per labor hour of the budget line item based on the workspace2 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "laborRateWorkspace3":{
            "type":"number",
            "description":"The cost per labor hour of the budget line item based on the workspace3 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "currentCostWorkspace1":{
            "type":"number",
            "description":"The total cost of the program budget, including all transfers and changes, based on the workspace1 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "currentCostWorkspace2":{
            "type":"number",
            "description":"The total cost of the program budget, including all transfers and changes, based on the workspace2 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "currentCostWorkspace3":{
            "type":"number",
            "description":"The total cost of the program budget, including all transfers and changes, based on the workspace3 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "amountCost":{
            "type":"number",
            "description":"The amount that the budget row has changed as the result of transactions.",
            "format":"double",
            "exampleSetFlag":false
        },
        "amountCostWorkspace1":{
            "type":"number",
            "description":"The amount that the budget row has changed as the result of transactions, based on the workspace1 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "amountCostWorkspace2":{
            "type":"number",
            "description":"The amount that the budget row has changed as the result of transactions, based on the workspace2 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "amountCostWorkspace3":{
            "type":"number",
            "description":"The amount that the budget row has changed as the result of transactions, based on the workspace3 currency.",
            "format":"double",
            "exampleSetFlag":false
        },
        "programBudgetTransactionId":{
            "type":"integer",
            "description":"The system-generated identifier for a transaction.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "updateDate":{
            "type":"string",
            "description":"Date when the record was last updated.",
            "format":"date-time",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

404 Response

The requested program budget change does not exist, or you do not have access to it.

Back to Top