Returns the scope item assignment for the specified scope item assignment code.
get
/primeapi/restapi/v16.2/scopeItemAssignment/code/{code}
Request
Path Parameters
- code
-
Type:
stringRequired:trueCode of the Scope Item Assignment to be found.
Response
Supported Media Types
- application/json
200 Response
successful operation
Body
Root Schema : ApiEntityScopeItemAssignment
Type:
object- actualHoursToDate
-
Type:
objectHourRequired:true - actualUnitsToDate
-
Type:
objectQuantityRequired:true - approvedChangedHours
-
Type:
objectHourRequired:true - approvedChangedUnits
-
Type:
objectQuantityRequired:true - atCompletionHours
-
Type:
objectHour - atCompletionUnits
-
Type:
objectQuantity - availableHours
-
Type:
objectHourRequired:true - availableUnits
-
Type:
objectQuantityRequired:true - bacHours
-
Type:
objectHour - bacUnits
-
Type:
objectQuantityRequired:true - baselineFinishDate
-
Type:
string(date-time)The planned finish date for the work package as is set in the current baseline. This field is used to spread baseline data fields. This field is populated with the Revised Finish date at the time that the current baseline is set. If there is an activity link, this field is populated with the activity's Current BL Finish date. - baselineHours
-
Type:
objectHourRequired:true - baselineStartDate
-
Type:
string(date-time)The planned start date for the work package as is set in the current baseline. This field is used to spread baseline data fields. This field is populated with the Revised Start date at the time that the current baseline is set. If there is an activity link, this field is populated with the activity's Current BL Start date. - baselineUnits
-
Type:
objectQuantityRequired:true - code
-
Type:
stringThe unique identifier for the scope assignment. - currentHoursPerUnit
-
Type:
number(double)The number of hours it will take to install or assemble the product or material per unit based on current values. Calculated as Revised Hours divided by Revised Quantity. This value is recalculated if Revised Quantity or Revised Hours are changed. - curve
-
Type:
integer(int64)The curve profile selected for the scope assignment. - description
-
Type:
stringRequired:trueAllowed Values:[ "Length[0-4000]" ]Additional details for the scope assignment. - eacHours
-
Type:
objectHourRequired:true - eacUnits
-
Type:
objectQuantityRequired:true - earnedHours
-
Type:
objectHourRequired:true - earnedPercentComplete
-
Type:
objectPercentRequired:true - earnedUnits
-
Type:
objectQuantityRequired:true - effectiveDate
-
Type:
string(date-time)The latest date of all Actual to Date and Actual Cost to Date values for the scope assignment. This is a read-only field. - etcAdjustedHours
-
Type:
objectHourRequired:true - etcAdjustedUnits
-
Type:
objectQuantityRequired:true - etcHours
-
Type:
objectHourRequired:true - etcUnits
-
Type:
objectQuantityRequired:true - hoursPerUnit
-
Type:
number(double)The number of hours it takes to install or assemble the product or material per unit. Defaults to the scope item's Original Productivity Rate, but can be updated for each scope item assignment. Calculated as Original Hours divided by Original Quantity. If this field is updated, Original Hours is recalculated to equal Original Quantity multiplied by Original Productivity Rate. - installedFinishDate
-
Type:
string(date-time)The date work on the scope assignment completed. The latest date of all Installed Quantity values for the scope assignment when Scope Percent Complete equals 100%. - installedHours
-
Type:
objectHour - installedStartDate
-
Type:
string(date-time)The date work on the scope assignment began. This is the earliest date of all Installed Quantity values for the scope assignment. - installedUnits
-
Type:
objectQuantity - managerId
-
Type:
integer(int64)The manager or person responsible for providing status on the scope assignment. - manualWeight
-
Type:
number(double)Calculated as Scope Percent Complete multiplied by Manual Weight Factor. - manualWeightFactor
-
Type:
number(double)The amount by which the manual weight is calculated when progress needs to be weighed against a factor other than quantity, hours, or cost. - milestoneProgressPercent
-
Type:
objectPercentRequired:true - milestones
-
Type:
arraymilestonesUnique Items Required:trueLists all Scope Item Assignment Milestones for this assignment. - originalFinishDate
-
Type:
string(date-time)The date the work on the scope assignment is scheduled to finish. This field is populated with the work package's Original Finish date, but it can be manually modified until the original baseline is set. If there is no activity link, the field is locked when the original baseline is set. If there is an activity link, the field is populated with the activity's Original BL Finish. If the Data Date is specified after the Original Finish date is set and the Original Start date is before the Data Date, the application sets the Original Finish date to be the same date relative to Original Start before the Data Date was modified when the Modify Dates feature is run. - originalStartDate
-
Type:
string(date-time)The date the work on the scope assignment is scheduled to begin. This field is populated with its work package's Original Start, but can be manually modified until the original baseline is set. If there is no activity link, the field is locked when the original baseline is set. If there is an activity link, the field is populated with the activity's Original BL Start. If the Data Date is specified, the date cannot be set to a date earlier than the Data Date. If the Data Date is specified after the Original Start date is set and the Original Start date is before the Data Date, the Original Start date inherits the Data Date when the Modify Dates feature is run. - pendingChangedHours
-
Type:
objectHourRequired:true - pendingChangedUnits
-
Type:
objectQuantityRequired:true - percentComplete
-
Type:
objectPercentRequired:true - plannedFinishDate
-
Type:
string(date-time)The date the work on the work package is scheduled to finish. This field is used to spread original data fields. If there is no activity link, this field is populated with the Original Finish date until the original baseline is set. It can be manually modified after the original baseline is set. If Data Date is specified after the Planned Finish date is set and the Planned Start date is before the Data Date, the application sets the Planned Finish date to be the same date relative to Planned Start before the Data Date was modified when the Modify Dates feature is run. If there is an activity link, this field is populated with the activity's Planned Finish date. - plannedHours
-
Type:
objectHour - plannedStartDate
-
Type:
string(date-time)The date the work on the work package is scheduled to begin. This field is used to spread original data fields. If there is no activity link, this field is populated with the Original Start date until the original baseline is set. It can be manually updated after the original baseline is set. If the Data Date is specified, the date cannot be set to a date earlier than the Data Date. If the Data Date is specified after the Planned Start date is set, the Planned Start date is before the Data Date, and the work package's Scope Percent Complete is equal to 0%, that is Installed Quantity is zero, then the date inherits the Data Date when the Modify Dates feature is run. If there is an activity link, this field is populated with the activity's Planned Start date. - plannedUnits
-
Type:
objectQuantity - progressStatus
-
Type:
stringAllowed Values:[ "NOT_STARTED", "IN_PROGRESS", "COMPLETED" ]The current status of a scope assignment. Not Started: Work using the scope assignment has not begun. In Progress: The work is in progress. Completed: The work has been completed. - projectId
-
Type:
integer(int64)The ID for the project that the work package belongs to. - rateBy
-
Type:
stringRequired:trueAllowed Values:[ "HOURS", "QUANTITY" ]Determines whether the cost is calculated using the Quantity or Hours. Quantity: Quantity is used to calculate cost. For example, Original Cost is calculated as Original Quantity times Original Cost Rate. Hours: Hours are used to calculate cost. For example, Original Cost is calculated as Original Hours times Original Cost Rate. - remainingEarlyFinishDate
-
Type:
string(date-time)The earliest date the work on the scope assignment is scheduled to finish. If there is no activity link, before the original baseline is set, this field is populated with the Original Finish date. After the original baseline is set, this field is populated with the Revised Finish date. This field is blank when the scope assignment's Scope Percent Complete becomes 100%. If there is any activity linked, this field is populated with the activity's Remaining Early Finish date. This field is used to spread Remaining data fields . - remainingEarlyStartDate
-
Type:
string(date-time)The earliest date the work on the work package is scheduled to begin. If there is no activity link, before the original baseline is set, this field is populated with the Original Start date. After the original baseline is set, this field is populated with the Data Date when the Modify Dates feature is run if the scope assignment's Scope Percent Complete is not equal to 100% This field is blank when the scope assignment's Scope Percent Complete becomes 100%. If there is any activity linked, this field is populated with the activity's Remaining Early Start date. This field is used to spread Remaining data fields. - remainingHours
-
Type:
objectHour - remainingLateFinishDate
-
Type:
string(date-time)The latest possible date work on the scope assignment must finish to not delay the finish date. If there is no activity link, this field is always equal to the Remaining Early Finish date. If there is any activity linked, this field is populated with the activity's Remaining Late Finish date. This field is used to spread Remaining data fields. - remainingLateStartDate
-
Type:
string(date-time)The latest possible date work on the scope assignment must begin without delaying the finish date. - remainingUnits
-
Type:
objectQuantity - revisedFinishDate
-
Type:
string(date-time)The revised finish date for the scope assignment. It is always the latest finish of the scope assignment's Planned Start date and all approved Change Finish dates. - revisedHours
-
Type:
objectHourRequired:true - revisedStartDate
-
Type:
string(date-time)The revised start date for the scope assignment. It is always the earliest start of the scope assignments' Planned Start date and all approved Change Start dates. - revisedUnits
-
Type:
objectQuantityRequired:true - scopeItemAssignmentCodeValue
-
Type:
arrayscopeItemAssignmentCodeValueUnique Items Required:trueLists all Scope Item Assignment code types assigned to the Scope Item Assignment with its corresponding value. - scopeItemAssignmentCost
-
Type:
objectApiEntityScopeItemAssignmentCost - scopeItemAssignmentFlexCost
-
Type:
objectApiEntityScopeItemAssignmentFlexCost - scopeItemAssignmentFlexOther
-
Type:
objectApiEntityScopeItemAssignmentFlexOther - scopeItemAssignmentFlexText
-
Type:
objectApiEntityScopeItemAssignmentFlexText - scopeItemAssignmentId
-
Type:
integer(int64)The unique identifier for the scope item assigned to the work package. - scopeItemId
-
Type:
integer(int64)The unique identifier of the scope item assigned to the work package. - status
-
Type:
stringAllowed Values:[ "PENDING", "APPROVED", "REJECTED" ]ENUM - weightedCost
-
Type:
objectCostRequired:true - weightedCostProject
-
Type:
objectCost - weightedHours
-
Type:
objectHourRequired:true - weightedUnits
-
Type:
objectQuantityRequired:true - workPackageId
-
Type:
integer(int64)The unique identifier for the work package.
Nested Schema : Hour
Type:
object- bigDecimal
-
Type:
number - double
-
Type:
number(double)
Nested Schema : Quantity
Type:
objectNested Schema : Percent
Type:
object- bigDecimal
-
Type:
number - double
-
Type:
number(double)
Nested Schema : milestones
Type:
arrayUnique Items Required:
trueLists all Scope Item Assignment Milestones for this assignment.
-
Type:
objectApiEntityScopeItemAssignmentMilestone
Nested Schema : scopeItemAssignmentCodeValue
Type:
arrayUnique Items Required:
trueLists all Scope Item Assignment code types assigned to the Scope Item Assignment with its corresponding value.
-
Type:
objectApiEntityCodeValueScopeItemAssignment
Nested Schema : ApiEntityScopeItemAssignmentCost
Type:
object- actualCostToDate
-
Type:
objectCostRequired:true - actualCostToDateProject
-
Type:
objectCostRequired:true - adjustedCost
-
Type:
objectCostRequired:true - adjustedCostProject
-
Type:
objectCostRequired:true - approvedChangedCost
-
Type:
objectCostRequired:true - approvedChangedCostProject
-
Type:
objectCostRequired:true - atCompletionCost
-
Type:
objectCostRequired:true - atCompletionCostProject
-
Type:
objectCostRequired:true - bacCost
-
Type:
objectCostRequired:true - bacCostProject
-
Type:
objectCostRequired:true - baselineCost
-
Type:
objectCostRequired:true - baselineCostProject
-
Type:
objectCostRequired:true - currentRate
-
Type:
objectCostRequired:true - currentRateProject
-
Type:
objectCostRequired:true - eacCost
-
Type:
objectCostRequired:true - eacCostProject
-
Type:
objectCostRequired:true - earnedCost
-
Type:
objectCostRequired:true - earnedCostProject
-
Type:
objectCostRequired:true - etcCost
-
Type:
objectCostRequired:true - etcCostProject
-
Type:
objectCostRequired:true - installedCost
-
Type:
objectCostRequired:true - installedCostProject
-
Type:
objectCostRequired:true - pendingChangedCost
-
Type:
objectCostRequired:true - pendingChangedCostProject
-
Type:
objectCostRequired:true - plannedCost
-
Type:
objectCostRequired:true - plannedCostProject
-
Type:
objectCostRequired:true - rate
-
Type:
objectCostRequired:true - rateProject
-
Type:
objectCostRequired:true - remainingCost
-
Type:
objectCostRequired:true - remainingCostProject
-
Type:
objectCostRequired:true - revisedCost
-
Type:
objectCostRequired:true - revisedCostProject
-
Type:
objectCostRequired:true - scopeItemAssignmentId
-
Type:
integer(int64)Required:true
Nested Schema : ApiEntityScopeItemAssignmentFlexCost
Type:
object- flexMap
-
Type:
objectflexMapAdditional Properties Allowed: additionalPropertiesLists all configured cost fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair. - scopeItemAssignment
-
Type:
objectApiEntityScopeItemAssignment - scopeItemAssignmentId
-
Type:
integer(int64)
Nested Schema : ApiEntityScopeItemAssignmentFlexOther
Type:
object- flexMap
-
Type:
objectflexMapAdditional Properties Allowed: additionalPropertiesLists all configured date, number, integer fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair. - scopeItemAssignment
-
Type:
objectApiEntityScopeItemAssignment - scopeItemAssignmentId
-
Type:
integer(int64)
Nested Schema : ApiEntityScopeItemAssignmentFlexText
Type:
object- flexMap
-
Type:
objectflexMapAdditional Properties Allowed: additionalPropertiesLists all configured text fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair. - scopeItemAssignment
-
Type:
objectApiEntityScopeItemAssignment - scopeItemAssignmentId
-
Type:
integer(int64)
Nested Schema : Cost
Type:
objectNested Schema : ApiEntityScopeItemAssignmentMilestone
Type:
object- milestone
-
Type:
objectApiEntityRuleOfCreditMilestone - milestoneProgressPercent
-
Type:
objectPercentRequired:true - percentComplete
-
Type:
objectPercentRequired:true - scopeItemAssignmentMilestoneId
-
Type:
integer(int64)
Nested Schema : ApiEntityRuleOfCreditMilestone
Type:
object- milestoneId
-
Type:
integer(int64) - milestoneName
-
Type:
stringAllowed Values:[ "Length[1-255]" ]The name of the milestone for the rule of credit. - percentComplete
-
Type:
objectPercent
Nested Schema : ApiEntityCodeValueScopeItemAssignment
Type:
object- codeType
-
Type:
objectApiEntityCodeType - codeValue
-
Type:
objectApiEntityCodeValue - codeValueScopeItemId
-
Type:
integer(int64)KEY
Nested Schema : ApiEntityCodeType
Type:
object- assignments
-
Type:
arrayassignmentsUnique Items Required:true - codeTypeCode
-
Type:
stringAllowed Values:[ "Length[1-40]" ]This field displays the name of a code or value. - codeTypeId
-
Type:
integer(int64) - codeTypeName
-
Type:
stringAllowed Values:[ "Length[1-40]" ]STRING - workspace
-
Type:
integer(int64)The ID of the owning workspace.
Nested Schema : ApiEntityCodeValue
Type:
object- codeTypeId
-
Type:
integer(int64)The ID for the code type. - codeValueCode
-
Type:
stringAllowed Values:[ "LENGTH[1-32]" ]The unique identifier for the code value. - codeValueId
-
Type:
integer(int64)The unique identifier for the code value. - codeValueName
-
Type:
stringAllowed Values:[ "LENGTH[1-100]" ]The name of the code value. - parentCodeValue
-
Type:
integer(int64)The parent code value. - sequenceNumber
-
Type:
integer(int32)The number that specifies the position of the code value item within the code type list.
Nested Schema : assignments
Nested Schema : ApiEntityCodeEntityType
Type:
object- codeType
-
Type:
objectApiEntityCodeType - entityType
-
Type:
stringAllowed Values:[ "SCOPE_ITEM", "PROJECT", "SCOPE_ASSIGNMENT", "WBS", "WORK_PACKAGE", "ACTIVITY", "RESOURCE", "PBS", "CONTRACT", "RISK", "COMMITMENT", "REPORT", "TASKS", "PROJECT_FUND", "WORKSPACE_FUND" ] - primaryKey
-
Type:
integer(int64)
Nested Schema : flexMap
Type:
object-
Type:
objectadditionalProperties
Lists all configured cost fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair.
Nested Schema : additionalProperties
Type:
objectNested Schema : flexMap
Type:
object-
Type:
objectadditionalProperties
Lists all configured date, number, integer fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair.
Nested Schema : additionalProperties
Type:
objectNested Schema : flexMap
Type:
object-
Type:
objectadditionalProperties
Lists all configured text fields assigned to the Scope Item Assignment with its corresponding value as a (key,value) pair.
Nested Schema : additionalProperties
Type:
object404 Response
The Scope Item Assignment does not exist or you do not have access to it.