View a Project Aggregate by Reference ID and Rollup Type
get
/primeapi/restapi/projectsAggregate/reference/{refId}/rollupType/{rollupType}
This endpoint returns project aggregates that meet the following requirements:
- The object has a reference to another object with an ID value that matches the value of the {id} path parameter.
- The object has a rollup with an ID value that matches the value of the {rollupId} path parameter.
Request
Path Parameters
-
refId: integer(int64)
Reference ID and rollup type for the projects aggregates to be found.
-
rollupType: string
The rollup type of a project aggregate.Allowed Values:
[ "PROJECT_2_CAPITAL_PLAN", "PROJECT_PORTFOLIO" ]
Response
Supported Media Types
- application/json
200 Response
successful operation
Nested Schema : ApiEntityProjectsAggregate
Type:
Show Source
object
-
actualDuration(optional):
object Duration
-
actualFinishDate(optional):
string(date-time)
The date on which a project is considered complete.
-
actualStartDate(optional):
string(date-time)
Indicates the date work on the project began.
-
aggregateId:
integer(int64)
The unique identifier of a rollup.
-
finishDate(optional):
string(date-time)
The date on which work on the project ends.
-
finishDateVariance(optional):
object Duration
-
forecastFinishDate(optional):
string(date-time)
The planned finish date of a project's remaining forecast cost.
-
forecastStartDate(optional):
string(date-time)
The planned start date of a project's remaining forecast cost.
-
link(optional):
string(url)
Read Only:
true
-
percentComplete(optional):
object Percent
-
planEndDate(optional):
string(date-time)
The finish date for the time phased planned budget of the project. Planned budget cost spread will adjust when this date is changed.
-
plannedDuration(optional):
object Duration
-
planStartDate(optional):
string(date-time)
The start date for the time phased planned budget of the project. Planned budget cost spread will adjust when this date is changed. The project planned start also represents the earliest date that activities can occur within a project schedule.
-
projectAggregateFinancial(optional):
object ApiEntityProjectsAggregateFinancial
-
projectsAggregateConfiguredFields(optional):
object ApiEntityProjectsAggregateConfiguredFields
-
recordCount(optional):
integer(int32)
The number of comments on a project.
-
referenceObjectId:
integer(int64)
The unique identifier of a project cost reference.
-
remainingDuration(optional):
object Duration
-
rollupType(optional):
string
Allowed Values:
[ "PROJECT_2_CAPITAL_PLAN", "PROJECT_PORTFOLIO" ]
The type of rollup. -
spendEffectiveDate(optional):
string(date-time)
The month in which an actuals value was last added to the project.
-
startDate(optional):
string(date-time)
The date on which work on the project begins.
-
startDateVariance(optional):
object Duration
-
uniqueName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityProjectsAggregateFinancial
Type:
Show Source
object
-
actualCost(optional):
object Cost
-
aggregateId:
integer(int64)
The unique identifier of a rollup.
-
annualDiscountRate(optional):
object Percent
-
atCompletionCost(optional):
object Cost
-
costPerfIndex(optional):
number(double)
The measure of a project's cost efficiency.
-
costVariance(optional):
object Cost
-
currApprSpendVar(optional):
object Cost
-
currentApprovedBudget(optional):
object Cost
-
currentApprovedBudgetDistributed(optional):
object Cost
-
currentApprovedBudgetUndistributed(optional):
object Cost
-
earnedValueCost(optional):
object Cost
-
estAtCompleteCost(optional):
object Cost
-
estToCompleteCost(optional):
object Cost
-
forecastCost(optional):
object Cost
-
forecastCostDistributed(optional):
object Cost
-
forecastCostUndistributed(optional):
object Cost
-
forecastCurrApprVar(optional):
object Cost
-
internalRateOfReturn(optional):
object Percent
-
link(optional):
string(url)
Read Only:
true
-
netPresentValue(optional):
object Cost
-
paybackPeriod(optional):
number(double)
The estimate of the length of time that will transpire before net profits recover the initial and periodic costs of an investment to carry out the selected project.
-
plannedBudget(optional):
object Cost
-
plannedBudgetDistributed(optional):
object Cost
-
plannedBudgetUndistributed(optional):
object Cost
-
plannedValueCost(optional):
object Cost
-
profitabilityIndex(optional):
number(double)
The index based on the value of a project's present values divided by initial project investments.
-
proposedBudgetBase(optional):
object Cost
-
proposedBudgetBaseDistributed(optional):
object Cost
-
proposedBudgetBaseUndistributed(optional):
object Cost
-
proposedForecastVar(optional):
object Cost
-
proposedPlannedVar(optional):
object Cost
-
referenceObjectId:
integer(int64)
The unique identifier of a project cost reference.
-
remainingCost(optional):
object Cost
-
returnOnInvestment(optional):
object Percent
-
rollupType(optional):
string
Allowed Values:
[ "PROJECT_2_CAPITAL_PLAN", "PROJECT_PORTFOLIO" ]
The type of rollup. -
schedPerfIndex(optional):
number(double)
The measure of work accomplished as a percentage of the work scheduled on a project.
-
scheduleVariance(optional):
object Cost
-
spendCost(optional):
object Cost
-
spendForecastVar(optional):
object Cost
-
spendPlannedVar(optional):
object Cost
-
uniqueName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
yearEndForecastCost(optional):
object Cost
-
ytdSpendCost(optional):
object Cost
Nested Schema : ApiEntityProjectsAggregateConfiguredFields
Type:
Show Source
object
-
aggregateId:
integer(int64)
The unique identifier of a rollup.
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalProperties
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalProperties
-
referenceObjectId:
integer(int64)
The unique identifier of a project cost reference.
-
rollupType:
string
Allowed Values:
[ "PROJECT_2_CAPITAL_PLAN", "PROJECT_PORTFOLIO" ]
The type of rollup. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : Cost
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
204 Response
Successful operation with no content.
404 Response
The requested projects aggregate does not exist, or you do have access to it.