Update a project resource request
patch
/fscmRestApi/resources/11.13.18.05/projectResourceRequests/{ResourceRequestId}
Request
Path Parameters
-
ResourceRequestId(required): integer(int64)
Identifier of the project resource request.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
AssignmentType: string
Title:
Assignment Type
Maximum Length:80
Indicates if the request is for a billable or a nonbillable assignment. -
AssignmentTypeCode: string
Title:
Assignment Type Code
Maximum Length:30
Code to indicate if the request is for a billable or a nonbillable assignment. Examples are BILLABLE, NONBILLABLE, or leave blank. -
BillablePercent: integer
Title:
Billable Percent
The percentage of assignment time that will be billable, if the request is for a billable assignment. Valid values are positive integer between 0 and 100. For a nonbillable assignment, the value is ignored. -
BillablePercentReason: string
Title:
Billable Percent Reason
Maximum Length:80
Reason the billable percent is less than 100, if the request is for a billable assignment and the billable percent is less than 100. If the request is for nonbillable assignment, the value will be ignored. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason Code
Maximum Length:30
Code to indicate the reason the billable percent is less than 100, if the request is for a billable assignment and the billable percent is less than 100. If the request is for nonbillable assignment, the value will be ignored. -
FridayHours: number
Title:
Friday Hours
Hours for Friday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
Location: string
Title:
Location
Maximum Length:240
Resource assignment location specificed on the resource request. -
MondayHours: number
Title:
Monday Hours
Hours for Monday of every week for the requested time period. Applicable only if Use Variable Hours Indicator value is true. -
ProjectId: integer
(int64)
Title:
Project ID
Unique identifier of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project Number attribute, or the Project Name attribute. Project is mandatory when creating an OPEN request. -
ProjectName: string
Title:
Project Name
Maximum Length:240
Name of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project ID attribute, or the Project Name attribute. -
ProjectNumber: string
Title:
Project Number
Maximum Length:25
Unique number of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project ID attribute, or the Project Name attribute. -
ProjectResourceRequestDFF: array
Project Resource Request Descriptive Flexfields
Title:
Project Resource Request Descriptive Flexfields
The Project Resource Request Descriptive Flexfields resource is used to view, create, and update descriptive flexfields associated to a project resource request. -
ProjectResourceRequestLines: array
Project Resource Request Lines
Title:
Project Resource Request Lines
The Project Resource Request Lines resource is used to view the status and details of all proposed or nominated resources associated to the request. -
ProjectResourceRequestQualifications: array
Project Resource Request Qualifications
Title:
Project Resource Request Qualifications
The Project Resource Request Qualifications resource is used to view, create, and manage project resource qualifications under a specific request. -
ProjectRoleId: integer
(int64)
Title:
Project Role ID
Unique identifier of the role that the selected resources will be assigned to on the project. You may enter a value only for this attribute or for Project Role Name but not both. -
ProjectRoleName: string
Title:
Project Role
Maximum Length:240
Role that the selected resources will be assigned to on the project. You may enter a value only for this attribute or for Project Role ID but not both. -
RequestedFinishDate: string
(date)
Title:
Requested Finish Date
Date until which a resource is requested. If no value is provided, the value is set to the project end date. You must provide a value if the project does not have an end date. -
RequestedHoursperDay: number
Title:
Requested Hours per Day
Default Value:0
Period of time measured in hours that establishes the number of requested hours per working day on a project resource request. You must provide a value if you have set the Use Project Calendar Indicator attribute value to N. -
RequestedHoursPerWeek: number
Title:
Requested Hours per Week
Hours for every week of the requested duration. Applicable only if Use Weekly Hours Indicator value is true. -
RequestedQuantity: integer
Title:
Requested Quantity
Default Value:1
The quantity of resources requested for the project resource request. If no value is provided, the value is set to 1. -
RequestedResourceEmail: string
Title:
Requested Resource Email
Maximum Length:240
Email of the resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. You may enter a value for only this attribute or for Requested Resource ID but not both. -
RequestedResourceId: integer
(int64)
Title:
Requested Resource ID
Identifier of the resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. You may enter a value for only this attribute or for Requested Resource Email but not both. -
RequestedStartDate: string
(date)
Title:
Requested Start Date
Date from which a resource is requested. If no value is provided, the value is set to the current date for projects with start date in the past, and to the project start date for projects with start date in the future. -
RequesterEmail: string
Title:
Requester Email
Maximum Length:240
Email of the project enterprise resource who requests the resources, mostly the project manager. You may enter a value only for this attribute or for Requester Resource ID but not both. -
RequesterResourceId: integer
(int64)
Title:
Requester Resource ID
Unique identifier of the project enterprise resource who requests the resources, mostly the project manager. You may enter a value only for this attribute or for Requester Email but not both. -
RequestName: string
Title:
Request Name
Maximum Length:240
Name of the project resource request. -
RequestSource: string
Maximum Length:
30
Default Value:RM
The requester's role specificed on the resource request. -
RequestStatusCode: string
Title:
Request Status Code
Maximum Length:30
Default Value:DRAFT
Code of the resource request status. The valid values are OPEN or DRAFT when creating the request. The default value is DRAFT. You can only update the request status from DRAFT to OPEN. -
SaturdayHours: number
Title:
Saturday Hours
Hours for Saturday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
SpecialInstructions: string
Title:
Special Instructions
Maximum Length:2000
Special instructions for the project resource request, such as requester instructions to the resource manager. -
StaffingOwnerEmail: string
Title:
Staffing Owner Email
Maximum Length:240
Email of the person who is responsible for finding resources to fulfill the request. You may enter a value for only this attribute or Staffing Owner ID but not both. -
StaffingOwnerResourceId: integer
(int64)
Title:
Staffing Owner Resource ID
Identifier of the project enterprise resource who is responsible for finding resources to fulfill the request. You may enter a value for only this attribute or for Staffing Owner Email but not both. -
StaffingRemarks: string
Title:
Staffing Remarks
Maximum Length:2000
Remarks added by the resource manager during staffing. -
SundayHours: number
Title:
Sunday Hours
Hours for Sunday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TargetBillRate: number
Title:
Target Bill Rate
Bill rate that represents the targeted rate for the resources who fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Cost Rate Currency Code
Maximum Length:15
Code of the currency used to define the bill rate. -
TargetCostRate: number
Title:
Target Cost Rate
Cost rate that represents the targeted rate for the resources who are selected on the request. -
TargetCostRateCurrencyCode: string
Title:
Target Cost Rate Currency Code
Maximum Length:15
Code of the currency used to define the cost rate. -
ThursdayHours: number
Title:
Thursday Hours
Hours for Thursday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TuesdayHours: number
Title:
Tuesday Hours
Hours for Tuesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
UseProjectCalendarFlag: boolean
Title:
Use Project Calendar Indicator
Maximum Length:1
Default Value:true
Flag that indicates if the hours for the assignment is provided in Requested Hours per Day attribute or should be derived from the project calendar. The valid values are Y and N. If the value is Y, the request hours is derived from the project calendar. -
UseVariableHoursFlag: boolean
Title:
Use Variable Hours Indicator
Indicates if the hours for the request are variable for every day of the week or not. Valid values are True and False. If the value is True, the requested hours are derived from the attributes Monday Hours through Sunday Hours. -
UseWeeklyHoursFlag: boolean
Title:
Use Weekly Hours Indicator
Indicates if the hours for the request are for every week or not. Valid values are True and False. If the value is True, the requested hours are derived from the attributes RequestedHoursPerWeek. -
WednesdayHours: number
Title:
Wednesday Hours
Hours for Wednesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true.
Nested Schema : Project Resource Request Descriptive Flexfields
Type:
array
Title:
Project Resource Request Descriptive Flexfields
The Project Resource Request Descriptive Flexfields resource is used to view, create, and update descriptive flexfields associated to a project resource request.
Show Source
Nested Schema : Project Resource Request Lines
Type:
array
Title:
Project Resource Request Lines
The Project Resource Request Lines resource is used to view the status and details of all proposed or nominated resources associated to the request.
Show Source
Nested Schema : Project Resource Request Qualifications
Type:
array
Title:
Project Resource Request Qualifications
The Project Resource Request Qualifications resource is used to view, create, and manage project resource qualifications under a specific request.
Show Source
Nested Schema : schema
Type:
Show Source
object
-
__FLEX_Context: string
Title:
Context Segment
Maximum Length:30
Context of the descriptive flexfield. -
__FLEX_Context_DisplayValue: string
Title:
Context Segment
Context display value of the descriptive flexfield.
Nested Schema : schema
Type:
Show Source
object
-
AssignedHours: number
Title:
Assigned Hours
Assigned hours per day when the specify hours per day is selected for use project calendar flag. -
AssignmentFinishDate: string
(date)
Title:
Assignment Finish Date
Assignment finish date for the resource. -
AssignmentStartDate: string
(date)
Title:
Assignment Start Date
Assignment start date for the resource. -
AssignmentStatus: string
Title:
Resource Staffing Status
Maximum Length:80
Status of the assignment created for the resource to fulfill the request. -
AssignmentStatusCode: string
Title:
Assignment Status Code
Maximum Length:30
Code of the assignment created for the resource to fulfill the request. -
ProjectRole: string
Title:
Project Role
Resource role for the project assignment. -
RejectionReason: string
Maximum Length:
80
Reason the nominated resource is rejected for the project resource assignment. -
RejectionReasonCode: string
Title:
Rejection Reason Code
Maximum Length:30
Code to indicate the reason the nominated resource is rejected for the project resource assigment. -
ReservationExpirationDate: string
(date)
Title:
Reservation Expiration Date
Select reservation expiration date for the resource if the assignment status is reserved. -
ReservationReason: string
Title:
Reservation Reason
Select reservation reason for the resource if the assignment status is reserved. -
ResourceStatus: string
Title:
Resource Staffing Status
Maximum Length:80
Status of the resource associated to the project resource request. -
ResourceStatusCode: string
Title:
Resource Status Code
Maximum Length:20
Default Value:NEW_LINE
Status code for the resource associated to the project resource request. -
UseProjectCalendarFlag: boolean
Title:
Use Project Calendar Indicator
Maximum Length:255
Select whether to use project calendar hours or specific hours per day.
Nested Schema : projectResourceRequests-ProjectResourceRequestQualifications-item-patch-request
Type:
Show Source
object
-
CompetencyProficiencyLevel: string
Title:
Competency Proficiency Level
Level of expertise or ability to perform a competency. You may enter a value for only this attribute or for Competency Proficiency Level ID but not both. -
CompetencyProficiencyLevelId: integer
(int64)
Title:
Competency Proficiency Level ID
Identifier of the level of expertise or ability to perform a competency. You may enter a value for only this attribute or for Competency Proficiency Level but not both. Competency Proficiency level applies only if the Qualification Type value is Competency. -
Keyword: string
Title:
Keyword
Maximum Length:240
Unstructured words or phrases that appear as keywords on a project resource request. -
MandatoryFlag: boolean
Title:
Mandatory Qualification
Maximum Length:1
Indicates whether the qualification is mandatory or optional. -
QualificationId: integer
(int64)
Title:
Qualification ID
Identifier of a structured content item such as a competency or language. The structured content items are defined in HCM Talent Profile. You may enter a value for only this attribute or for Qualification Name but not both. -
QualificationName: string
Title:
Qualification Name
Name of a structured content item such as a competency or language. The structured content items are defined in HCM Talent Profile. You may enter a value for only this attribute or for Qualification ID but not both. -
ReadingLanguageProficiencyLevel: string
Title:
Reading Language Proficiency Level
Level of ability to read text in a specific language. You may enter a value for only this attribute or for Reading Language Proficiency Level ID but not both. -
ReadingLanguageProficiencyLevelId: integer
(int64)
Title:
Reading Language Proficiency Level ID
Identifier of the level of ability to read text in a specific language. You may enter a value for only this attribute or for Reading Language Proficiency Level Name but not both. Reading Language Proficiency level applies only if the Qualification Type value is Language. -
SectionId: integer
(int64)
Title:
Content Section ID
Identifier of the qualification content section. You may enter a value for only this attribute or for Content Section Name but not both. -
SectionName: string
Title:
Content Section Name
Maximum Length:255
Content section name for the qualification. -
SpeakingLanguageProficiencyLevel: string
Title:
Speaking Language Proficiency Level
Level of ability to speak a specific language. You may enter a value for only this attribute or for Speaking Language Proficiency Level ID but not both. -
SpeakingLanguageProficiencyLevelId: integer
(int64)
Title:
Speaking Language Proficiency Level ID
Identifier of the level of ability to speak a specific language. You may enter a value for only this attribute or for Speaking Language Proficiency Level Name but not both. Speaking Language Proficiency level applies only if the Qualification Type value is Language. -
WritingLanguageProficiencyLevel: string
Title:
Writing Language Proficiency Level
Level of ability to write text in a specific language. You may enter a value for only this attribute or for Writing Language Proficiency Level ID but not both. -
WritingLanguageProficiencyLevelId: integer
(int64)
Title:
Writing Language Proficiency Level ID
Identifier of the level of ability to write text in a specific language. You may enter a value for only this attribute or for Write Language Proficiency Level Name but not both. Writing Language Proficiency level applies only if the Qualification Type value is Language.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context(required):
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version(required):
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : projectResourceRequests-item-response
Type:
Show Source
object
-
AssignedQuantity: integer
Title:
Assigned Quantity
Read Only:true
The number of resources assigned to the project for the resource request. -
AssignmentType: string
Title:
Assignment Type
Maximum Length:80
Indicates if the request is for a billable or a nonbillable assignment. -
AssignmentTypeCode: string
Title:
Assignment Type Code
Maximum Length:30
Code to indicate if the request is for a billable or a nonbillable assignment. Examples are BILLABLE, NONBILLABLE, or leave blank. -
BillablePercent: integer
Title:
Billable Percent
The percentage of assignment time that will be billable, if the request is for a billable assignment. Valid values are positive integer between 0 and 100. For a nonbillable assignment, the value is ignored. -
BillablePercentReason: string
Title:
Billable Percent Reason
Maximum Length:80
Reason the billable percent is less than 100, if the request is for a billable assignment and the billable percent is less than 100. If the request is for nonbillable assignment, the value will be ignored. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason Code
Maximum Length:30
Code to indicate the reason the billable percent is less than 100, if the request is for a billable assignment and the billable percent is less than 100. If the request is for nonbillable assignment, the value will be ignored. -
FridayHours: number
Title:
Friday Hours
Hours for Friday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Location: string
Title:
Location
Maximum Length:240
Resource assignment location specificed on the resource request. -
MondayHours: number
Title:
Monday Hours
Hours for Monday of every week for the requested time period. Applicable only if Use Variable Hours Indicator value is true. -
ProjectId: integer
(int64)
Title:
Project ID
Unique identifier of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project Number attribute, or the Project Name attribute. Project is mandatory when creating an OPEN request. -
ProjectName: string
Title:
Project Name
Maximum Length:240
Name of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project ID attribute, or the Project Name attribute. -
ProjectNumber: string
Title:
Project Number
Maximum Length:25
Unique number of the project associated to the resource request. To identify the project, you may provide a value only for this attribute, the Project ID attribute, or the Project Name attribute. -
ProjectResourceRequestDFF: array
Project Resource Request Descriptive Flexfields
Title:
Project Resource Request Descriptive Flexfields
The Project Resource Request Descriptive Flexfields resource is used to view, create, and update descriptive flexfields associated to a project resource request. -
ProjectResourceRequestLines: array
Project Resource Request Lines
Title:
Project Resource Request Lines
The Project Resource Request Lines resource is used to view the status and details of all proposed or nominated resources associated to the request. -
ProjectResourceRequestQualifications: array
Project Resource Request Qualifications
Title:
Project Resource Request Qualifications
The Project Resource Request Qualifications resource is used to view, create, and manage project resource qualifications under a specific request. -
ProjectRoleId: integer
(int64)
Title:
Project Role ID
Unique identifier of the role that the selected resources will be assigned to on the project. You may enter a value only for this attribute or for Project Role Name but not both. -
ProjectRoleName: string
Title:
Project Role
Maximum Length:240
Role that the selected resources will be assigned to on the project. You may enter a value only for this attribute or for Project Role ID but not both. -
ProposedQuantity: integer
Title:
Proposed Quantity
Read Only:true
The number of resources proposed or nominated for the project resource request. -
RemainingQuantity: integer
Title:
Remaining Quantity
Read Only:true
Default Value:1
The number of resources remaining to fulfill the project resource request. -
RequestedFinishDate: string
(date)
Title:
Requested Finish Date
Date until which a resource is requested. If no value is provided, the value is set to the project end date. You must provide a value if the project does not have an end date. -
RequestedHoursperDay: number
Title:
Requested Hours per Day
Default Value:0
Period of time measured in hours that establishes the number of requested hours per working day on a project resource request. You must provide a value if you have set the Use Project Calendar Indicator attribute value to N. -
RequestedHoursPerWeek: number
Title:
Requested Hours per Week
Hours for every week of the requested duration. Applicable only if Use Weekly Hours Indicator value is true. -
RequestedQuantity: integer
Title:
Requested Quantity
Default Value:1
The quantity of resources requested for the project resource request. If no value is provided, the value is set to 1. -
RequestedResourceEmail: string
Title:
Requested Resource Email
Maximum Length:240
Email of the resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. You may enter a value for only this attribute or for Requested Resource ID but not both. -
RequestedResourceId: integer
(int64)
Title:
Requested Resource ID
Identifier of the resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. You may enter a value for only this attribute or for Requested Resource Email but not both. -
RequestedResourceName: string
Title:
Requested Resource Name
Read Only:true
Maximum Length:240
Name of the project enterprise resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. -
RequestedResourcePersonId: integer
(int64)
Title:
Requested Resource Person ID
Read Only:true
HCM person identifier for the project enterprise resource who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. -
RequestedStartDate: string
(date)
Title:
Requested Start Date
Date from which a resource is requested. If no value is provided, the value is set to the current date for projects with start date in the past, and to the project start date for projects with start date in the future. -
RequesterEmail: string
Title:
Requester Email
Maximum Length:240
Email of the project enterprise resource who requests the resources, mostly the project manager. You may enter a value only for this attribute or for Requester Resource ID but not both. -
RequesterName: string
Title:
Requester Name
Read Only:true
Maximum Length:240
Name of the project enterprise resource who requests the resources. -
RequesterPersonId: integer
(int64)
Title:
Requester Person ID
Read Only:true
Identifier of the HCM person who requests the resources. -
RequesterResourceId: integer
(int64)
Title:
Requester Resource ID
Unique identifier of the project enterprise resource who requests the resources, mostly the project manager. You may enter a value only for this attribute or for Requester Email but not both. -
RequestFulfilledDate: string
(date)
Title:
Request Fulfilled Date
Read Only:true
Date on which the project resource request is fulfilled. -
RequestName: string
Title:
Request Name
Maximum Length:240
Name of the project resource request. -
RequestSource: string
Maximum Length:
30
Default Value:RM
The requester's role specificed on the resource request. -
RequestStatus: string
Title:
Request Status
Read Only:true
Maximum Length:80
Status of the project resource request. -
RequestStatusCode: string
Title:
Request Status Code
Maximum Length:30
Default Value:DRAFT
Code of the resource request status. The valid values are OPEN or DRAFT when creating the request. The default value is DRAFT. You can only update the request status from DRAFT to OPEN. -
RequestSubmittedDate: string
(date)
Title:
Request Submitted Date
Read Only:true
Date on which the project resource request is submitted. -
ResourceRequestId: integer
(int64)
Title:
Request ID
Identifier of the project resource request. -
SaturdayHours: number
Title:
Saturday Hours
Hours for Saturday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
SpecialInstructions: string
Title:
Special Instructions
Maximum Length:2000
Special instructions for the project resource request, such as requester instructions to the resource manager. -
StaffingOwnerEmail: string
Title:
Staffing Owner Email
Maximum Length:240
Email of the person who is responsible for finding resources to fulfill the request. You may enter a value for only this attribute or Staffing Owner ID but not both. -
StaffingOwnerName: string
Title:
Staffing Owner Name
Read Only:true
Maximum Length:240
Name of the person who is responsible for finding a resource to fulfill the request. -
StaffingOwnerPersonId: integer
(int64)
Title:
Staffing Owner Person ID
Read Only:true
Identifier of the HCM person who is responsible for finding a resource to fulfill the request. -
StaffingOwnerResourceId: integer
(int64)
Title:
Staffing Owner Resource ID
Identifier of the project enterprise resource who is responsible for finding resources to fulfill the request. You may enter a value for only this attribute or for Staffing Owner Email but not both. -
StaffingRemarks: string
Title:
Staffing Remarks
Maximum Length:2000
Remarks added by the resource manager during staffing. -
SundayHours: number
Title:
Sunday Hours
Hours for Sunday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TargetBillRate: number
Title:
Target Bill Rate
Bill rate that represents the targeted rate for the resources who fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Cost Rate Currency Code
Maximum Length:15
Code of the currency used to define the bill rate. -
TargetCostRate: number
Title:
Target Cost Rate
Cost rate that represents the targeted rate for the resources who are selected on the request. -
TargetCostRateCurrencyCode: string
Title:
Target Cost Rate Currency Code
Maximum Length:15
Code of the currency used to define the cost rate. -
ThursdayHours: number
Title:
Thursday Hours
Hours for Thursday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TotalHours: number
Title:
Total Requested Hours
Read Only:true
Total requested hours for the resource for the particular assignment. -
TuesdayHours: number
Title:
Tuesday Hours
Hours for Tuesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
UseProjectCalendarFlag: boolean
Title:
Use Project Calendar Indicator
Maximum Length:1
Default Value:true
Flag that indicates if the hours for the assignment is provided in Requested Hours per Day attribute or should be derived from the project calendar. The valid values are Y and N. If the value is Y, the request hours is derived from the project calendar. -
UseVariableHoursFlag: boolean
Title:
Use Variable Hours Indicator
Indicates if the hours for the request are variable for every day of the week or not. Valid values are True and False. If the value is True, the requested hours are derived from the attributes Monday Hours through Sunday Hours. -
UseWeeklyHoursFlag: boolean
Title:
Use Weekly Hours Indicator
Indicates if the hours for the request are for every week or not. Valid values are True and False. If the value is True, the requested hours are derived from the attributes RequestedHoursPerWeek. -
WednesdayHours: number
Title:
Wednesday Hours
Hours for Wednesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Project Resource Request Descriptive Flexfields
Type:
array
Title:
Project Resource Request Descriptive Flexfields
The Project Resource Request Descriptive Flexfields resource is used to view, create, and update descriptive flexfields associated to a project resource request.
Show Source
Nested Schema : Project Resource Request Lines
Type:
array
Title:
Project Resource Request Lines
The Project Resource Request Lines resource is used to view the status and details of all proposed or nominated resources associated to the request.
Show Source
Nested Schema : Project Resource Request Qualifications
Type:
array
Title:
Project Resource Request Qualifications
The Project Resource Request Qualifications resource is used to view, create, and manage project resource qualifications under a specific request.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : projectResourceRequests-ProjectResourceRequestDFF-item-response
Type:
Show Source
object
-
__FLEX_Context: string
Title:
Context Segment
Maximum Length:30
Context of the descriptive flexfield. -
__FLEX_Context_DisplayValue: string
Title:
Context Segment
Context display value of the descriptive flexfield. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ResourceRequestId: integer
(int64)
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : projectResourceRequests-ProjectResourceRequestLines-item-response
Type:
Show Source
object
-
AssignedHours: number
Title:
Assigned Hours
Assigned hours per day when the specify hours per day is selected for use project calendar flag. -
AssignmentFinishDate: string
(date)
Title:
Assignment Finish Date
Assignment finish date for the resource. -
AssignmentId: integer
Title:
Assignment ID
Identifier of the assignment created for the resource, if an assignment is created for the resource on the request line. -
AssignmentStartDate: string
(date)
Title:
Assignment Start Date
Assignment start date for the resource. -
AssignmentStatus: string
Title:
Resource Staffing Status
Maximum Length:80
Status of the assignment created for the resource to fulfill the request. -
AssignmentStatusCode: string
Title:
Assignment Status Code
Maximum Length:30
Code of the assignment created for the resource to fulfill the request. -
CurrentFlag: boolean
Title:
Current Indicator
Read Only:true
Maximum Length:1
Indicates whether the project resource request is the most recent request for the assignment. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ProjectRole: string
Title:
Project Role
Resource role for the project assignment. -
RejectionReason: string
Maximum Length:
80
Reason the nominated resource is rejected for the project resource assignment. -
RejectionReasonCode: string
Title:
Rejection Reason Code
Maximum Length:30
Code to indicate the reason the nominated resource is rejected for the project resource assigment. -
RequestLineId: integer
(int64)
Title:
Request Line ID
Unique identifier of the request line under the project resource request. -
ReservationExpirationDate: string
(date)
Title:
Reservation Expiration Date
Select reservation expiration date for the resource if the assignment status is reserved. -
ReservationReason: string
Title:
Reservation Reason
Select reservation reason for the resource if the assignment status is reserved. -
ResourceEmail: string
Title:
Resource Email
Maximum Length:240
Email of the project enterprise resource associated to the project resource request. -
ResourceFulfilledDate: string
(date)
Title:
Request Fulfilled Date
The date the resource on the request line is approved to fulfill the project resource request. -
ResourceId: integer
(int64)
Title:
Resource ID
Identifier of the project enterprise resource associated to the project resource request. -
ResourceName: string
Title:
Resource Name
Read Only:true
Maximum Length:240
Name of the project enterprise resource associated to the project resource request. -
ResourcePersonId: integer
(int64)
Title:
Resource HCM Person ID
Read Only:true
HCM person identifier of the project enterprise resource associated to the project resource request. -
ResourceProposedDate: string
(date)
Title:
Resource Proposed Date
The date when the resource is proposed or nominated to fulfill the project resource request. -
ResourceStatus: string
Title:
Resource Staffing Status
Maximum Length:80
Status of the resource associated to the project resource request. -
ResourceStatusCode: string
Title:
Resource Status Code
Maximum Length:20
Default Value:NEW_LINE
Status code for the resource associated to the project resource request. -
ResourceSystemStatus: string
Title:
Resource System Status
Read Only:true
Resource system status based on the seeded values. -
UseProjectCalendarFlag: boolean
Title:
Use Project Calendar Indicator
Maximum Length:255
Select whether to use project calendar hours or specific hours per day.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : projectResourceRequests-ProjectResourceRequestQualifications-item-response
Type:
Show Source
object
-
CompetencyProficiencyLevel: string
Title:
Competency Proficiency Level
Level of expertise or ability to perform a competency. You may enter a value for only this attribute or for Competency Proficiency Level ID but not both. -
CompetencyProficiencyLevelId: integer
(int64)
Title:
Competency Proficiency Level ID
Identifier of the level of expertise or ability to perform a competency. You may enter a value for only this attribute or for Competency Proficiency Level but not both. Competency Proficiency level applies only if the Qualification Type value is Competency. -
Keyword: string
Title:
Keyword
Maximum Length:240
Unstructured words or phrases that appear as keywords on a project resource request. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
Mandatory Qualification
Maximum Length:1
Indicates whether the qualification is mandatory or optional. -
QualificationId: integer
(int64)
Title:
Qualification ID
Identifier of a structured content item such as a competency or language. The structured content items are defined in HCM Talent Profile. You may enter a value for only this attribute or for Qualification Name but not both. -
QualificationName: string
Title:
Qualification Name
Name of a structured content item such as a competency or language. The structured content items are defined in HCM Talent Profile. You may enter a value for only this attribute or for Qualification ID but not both. -
QualificationType: string
Title:
Qualification Type
Type of the structured content item to indicate whether the qualification is Competency or Language. -
ReadingLanguageProficiencyLevel: string
Title:
Reading Language Proficiency Level
Level of ability to read text in a specific language. You may enter a value for only this attribute or for Reading Language Proficiency Level ID but not both. -
ReadingLanguageProficiencyLevelId: integer
(int64)
Title:
Reading Language Proficiency Level ID
Identifier of the level of ability to read text in a specific language. You may enter a value for only this attribute or for Reading Language Proficiency Level Name but not both. Reading Language Proficiency level applies only if the Qualification Type value is Language. -
ResourceRequestDetailId: integer
(int64)
Title:
Resource Request Detail ID
Read Only:true
Unique identifier of the resource request qualification associated to the request. -
SectionId: integer
(int64)
Title:
Content Section ID
Identifier of the qualification content section. You may enter a value for only this attribute or for Content Section Name but not both. -
SectionName: string
Title:
Content Section Name
Maximum Length:255
Content section name for the qualification. -
SpeakingLanguageProficiencyLevel: string
Title:
Speaking Language Proficiency Level
Level of ability to speak a specific language. You may enter a value for only this attribute or for Speaking Language Proficiency Level ID but not both. -
SpeakingLanguageProficiencyLevelId: integer
(int64)
Title:
Speaking Language Proficiency Level ID
Identifier of the level of ability to speak a specific language. You may enter a value for only this attribute or for Speaking Language Proficiency Level Name but not both. Speaking Language Proficiency level applies only if the Qualification Type value is Language. -
WritingLanguageProficiencyLevel: string
Title:
Writing Language Proficiency Level
Level of ability to write text in a specific language. You may enter a value for only this attribute or for Writing Language Proficiency Level ID but not both. -
WritingLanguageProficiencyLevelId: integer
(int64)
Title:
Writing Language Proficiency Level ID
Identifier of the level of ability to write text in a specific language. You may enter a value for only this attribute or for Write Language Proficiency Level Name but not both. Writing Language Proficiency level applies only if the Qualification Type value is Language.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- ProjectResourceRequestDFF
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Resource Request Descriptive Flexfields resource is used to view, create, and update descriptive flexfields associated to a project resource request. - ResourceRequestId:
- ProjectResourceRequestLines
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Resource Request Lines resource is used to view the status and details of all proposed or nominated resources associated to the request. - ResourceRequestId:
- ProjectResourceRequestQualifications
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Resource Request Qualifications resource is used to view, create, and manage project resource qualifications under a specific request. - ResourceRequestId:
- approveRequest
-
Operation: /fscmRestApi/resources/11.13.18.05/projectResourceRequests/{ResourceRequestId}/action/approveRequestParameters:
- ResourceRequestId:
$request.path.ResourceRequestId
Approve project resource request via this action. The request must be in Pending Adjustment status to allow this action. - ResourceRequestId:
- cancelRequest
-
Operation: /fscmRestApi/resources/11.13.18.05/projectResourceRequests/{ResourceRequestId}/action/cancelRequestParameters:
- ResourceRequestId:
$request.path.ResourceRequestId
Cancel project resource request via this action. The request must be in Open status to allow this action. - ResourceRequestId:
- rejectRequest
-
Operation: /fscmRestApi/resources/11.13.18.05/projectResourceRequests/{ResourceRequestId}/action/rejectRequestParameters:
- ResourceRequestId:
$request.path.ResourceRequestId
Reject project resource request via this action. The request must be in Pending Adjustment status to allow this action. - ResourceRequestId:
Examples
Example 1
The following example shows how to update a project resource request by submitting a PATCH request on the REST resource using cURL.
curl --user ppm_cloud_user -X PATCH -d @example_request_payload.json --header "Content-Type: application/json" https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectResourceRequests/300100169517431
Example 1 Request Body
The following shows an example of the request body in JSON format.
{ "RequestedHoursperDay": 0, "UseProjectCalendarFlag": true, "UseVariableHoursFlag": false }
Example 1 Response Body
The following shows an example of the response body in JSON format.
{ "ResourceRequestId": 300100185388392, "RequestName": "Advanced Scheduling PayLoads Test", "RequestStatusCode": "OPEN", "RequestStatus": "Open", "RequestedStartDate": "2019-11-01", "RequestedFinishDate": "2019-11-02", "RequestFulfilledDate": null, "RequestedHoursperDay": null, "UseProjectCalendarFlag": true, "Location": null, "RequestedResourceId": 300100024326749, "RequestedResourceName": "Ravi Patel", "RequestedResourceEmail": "prj_ravi_patel_grp@oracle.com", "RequestedResourcePersonId": 11459, "ProjectId": 300100025404077, "ProjectName": "zBIQA_Rel8_RM8", "ProjectNumber": "300100025404077", "ProjectRoleId": 300100025498091, "ProjectRoleName": "QA Tester", "RequesterResourceId": 300100081800169, "RequesterName": "Martin Sims", "RequesterEmail": "martin.sims_dummy@oracle.com", "RequesterPersonId": 100010032551052, "SpecialInstructions": null, "StaffingOwnerResourceId": 300100026245821, "StaffingOwnerName": "Asha Preetam", "StaffingOwnerEmail": "Asha.Preetam@Oracle.com", "StaffingOwnerPersonId": 300100007668401, "StaffingRemarks": null, "RequestSubmittedDate": "2019-12-07", "TargetBillRate": null, "TargetBillRateCurrencyCode": null, "TargetCostRate": null, "TargetCostRateCurrencyCode": null, "RequestedQuantity": 1, "AssignedQuantity": 0, "ProposedQuantity": 0, "RemainingQuantity": 1, "AssignmentTypeCode": null, "AssignmentType": null, "BillablePercentReasonCode": null, "BillablePercentReason": null, "BillablePercent": null, "SundayHours": null, "MondayHours": null, "TuesdayHours": null, "WednesdayHours": null, "ThursdayHours": null, "FridayHours": null, "SaturdayHours": null, "UseVariableHoursFlag": false }
Example 2
The following example shows how to update a project resource request by submitting a PATCH request on the REST resource using cURL.
curl --user ppm_cloud_user -X PATCH -d @example_request_payload.json --header "Content-Type: application/json" https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectResourceRequests/300100169517431
Example 2 Request Body
The following shows an example of the request body in JSON format.
{ "UseProjectCalendarFlag": false, "RequestedHoursperDay": 0, "UseWeeklyHoursFlag": true, "RequestedHoursPerWeek": 25 }
Example 2 Response Body
The following shows an example of the response body in JSON format.
{ "ResourceRequestId": 300100186429915, "RequestName": "Test Weekly", "RequestStatusCode": "OPEN", "RequestStatus": "Open", "RequestedStartDate": "2020-07-29", "RequestedFinishDate": "2020-08-29", "RequestFulfilledDate": null, "RequestedHoursperDay": null, "UseProjectCalendarFlag": false, "Location": null, "RequestedResourceId": null, "RequestedResourceName": null, "RequestedResourceEmail": null, "RequestedResourcePersonId": null, "ProjectId": 300100027033812, "ProjectName": "Test Project", "ProjectNumber": "Test Project", "ProjectRoleId": 300100025498083, "ProjectRoleName": "Oracle DBA", "RequesterResourceId": null, "RequesterName": null, "RequesterEmail": null, "RequesterPersonId": null, "SpecialInstructions": null, "StaffingOwnerResourceId": null, "StaffingOwnerName": null, "StaffingOwnerEmail": null, "StaffingOwnerPersonId": null, "StaffingRemarks": null, "RequestSubmittedDate": "2020-08-31", "TargetBillRate": null, "TargetBillRateCurrencyCode": null, "TargetCostRate": null, "TargetCostRateCurrencyCode": null, "RequestedQuantity": 1, "AssignedQuantity": 0, "ProposedQuantity": 0, "RemainingQuantity": 1, "AssignmentTypeCode": "BILLABLE", "AssignmentType": "Billable", "BillablePercentReasonCode": "ORA_INVESTMENT", "BillablePercentReason": "Investment", "BillablePercent": 25, "UseVariableHoursFlag": false, "SundayHours": null, "MondayHours": null, "TuesdayHours": null, "WednesdayHours": null, "ThursdayHours": null, "FridayHours": null, "SaturdayHours": null, "UseWeeklyHoursFlag": true, "RequestedHoursPerWeek": 25, "links": [ {..},{..}... ] }