Create one or more project resource requests
post
/fscmRestApi/resources/11.13.18.05/projectPlanResourceRequests
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.
-
Upsert-Mode:
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
AssignmentType: string
Title:
Assignment TypeMaximum Length:80Indicates if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
AssignmentTypeCode: string
Title:
Assignment Type CodeMaximum Length:30Code to indicate if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
BillablePercent: integer
Title:
Billable PercentIndicates the percentage of assignment time that is billable for an assignment that is defined as Billable assignment. For a non-billable assignment, the value is ignored. Valid values are positive integer between 0 and 100 -
BillablePercentReason: string
Title:
Billable Percent ReasonMaximum Length:80Indicates the reason that the billable percentage of the project resource assignment is less than 100%. For a non-billable assignment, the value is ignored. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason CodeMaximum Length:30Code that indicates the reason that the billable percentage of the project resource assignment is less than 100%. For a non-billable assignment, the value is ignored. -
FridayHours: number
Title:
Friday HoursHours for Friday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
Location: string
Title:
LocationMaximum Length:240Assignment location for the work specified on the project resource request. -
MondayHours: number
Title:
Monday HoursHours 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 IDIdentifier of the project associated to the resource request. You may enter a value for only this attribute or for Project Name but not both. -
ProjectName: string
Title:
Project NameMaximum Length:240Name of the project associated to the resource request. You may enter a value for only this attribute or for Project ID but not both. -
ProjectNumber: string
Title:
Project NumberMaximum Length:25Number of the project associated to the resource request. -
ProjectPlanResourceRequestDFF: array
Project Plan Resource Request Descriptive Flexfields
Title:
Project Plan Resource Request Descriptive FlexfieldsThe Project Plan Resource Request Descriptive Flexfields resource is used by a project manager to view, create, and update descriptive flexfields associated to a project resource request. -
ProjectPlanResourceRequestLines: array
Project Plan Resource Request Lines
Title:
Project Plan Resource Request LinesThe Project Plan Resource Request Lines resource is used by a project manager to view and update the status of nominated resources associated to the request. -
ProjectPlanResourceRequestQualifications: array
Project Plan Resource Request Qualifications
Title:
Project Plan Resource Request QualificationsThe Project Plan Resource Request Qualifications resource is used by a project manager to view, create, and manage project resource qualifications under a specific request. -
ProjectRoleId: integer
(int64)
Title:
Project Role IDIdentifier of the role that the selected resources will fill on a project. You may enter a value for only this attribute or for Project Role Name but not both. -
ProjectRoleName: string
Title:
Project Role NameMaximum Length:240Name of the role that the selected resources will fill on a project. You may enter a value for only this attribute or for Project Role ID but not both. -
RequestedFinishDate(required): string
(date)
Title:
Requested Finish DateDate until which a resource is requested. -
RequestedHoursperDay: number
Title:
Requested Hours per DayDefault Value:0Period of time measured in hours that establishes the number of requested hours per working day on a project resource request. -
RequestedHoursPerWeek: number
Title:
Requested Hours per WeekHours for every week of the requested duration. Applicable only if Use Weekly Hours Indicator value is true. -
RequestedQuantity: integer
Title:
Requested QuantityDefault Value:1The requested quantity of resources for this project resource request. If this request is for multiple resources, then the quantity must be greater than one. If no value is passed, the default value is set to 1. -
RequestedResourceEmail: string
Title:
Requested Resource EmailMaximum Length:240Email 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 IDIdentifier 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(required): string
(date)
Title:
Requested Start DateDate from which a resource is requested. If no value is passed, the default value is set to the start date of the project. -
RequesterEmail: string
Title:
Requester EmailMaximum Length:240Email of the person who is requesting resources. Usually it is the project manager. You may enter a value for only this attribute or for Requester Resource ID but not both. -
RequesterResourceId: integer
(int64)
Title:
Requester Resource IDIdentifier of the project enterprise resource of the person who is requesting resources. Usually it is the project manager.You may enter a value for only this attribute or for Requester Email but not both. -
RequestName(required): string
Title:
Request NameMaximum Length:240Name of a project resource request. -
RequestStatusCode: string
Title:
Request Status CodeMaximum Length:30Default Value:DRAFTCode of the request status for the resource request. You may pass the value as OPEN or DRAFT when creating the request. The default value will be DRAFT.
You can update the request and change the status from from DRAFT to OPEN. But you cannot change the status from OPEN to DRAFT. -
ResourceRequestId: integer
(int64)
Title:
Request IDIdentifier of the project resource request. -
SaturdayHours: number
Title:
Saturday HoursHours for Saturday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
SpecialInstructions: string
Title:
Special InstructionsMaximum Length:2000Special instructions for the project resource request, such as requester instructions to the resource manager. -
StaffingOwnerEmail: string
Title:
Staffing Owner EmailMaximum Length:240Email of the person who responsible for finding a resource 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 IDIdentifier of the project enterprise resource who is responsible for finding a resource 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 RemarksMaximum Length:2000Staffing remarks captured by the resource manager during staffing. -
SundayHours: number
Title:
Sunday HoursHours for Sunday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TargetBillRate: number
Title:
Target Bill RateBill rate that represents the targeted rate for the resource who will fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Bill Rate Currency CodeMaximum Length:15Code of the currency used to define the bill rate. -
TargetCostRate: number
Title:
Target Cost RateCost rate that represents the targeted rate for the resource who is selected on the request. -
TargetCostRateCurrencyCode: string
Title:
Target Cost Rate Currency CodeMaximum Length:15Code of the currency used to define the cost rate. -
ThursdayHours: number
Title:
Thursday HoursHours for Thursday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TuesdayHours: number
Title:
Tuesday HoursHours 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 IndicatorMaximum Length:1Default Value:trueFlag to indicate if the hours for the assignment is explicitly provided in RequestedHoursperDay or should be derived from the project calendar. Valid values are Y and N. -
UseVariableHoursFlag: boolean
Title:
Use Variable Hours IndicatorIndicates 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 IndicatorIndicates 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 HoursHours for Wednesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true.
Nested Schema : Project Plan Resource Request Descriptive Flexfields
Type:
arrayTitle:
Project Plan Resource Request Descriptive FlexfieldsThe Project Plan Resource Request Descriptive Flexfields resource is used by a project manager to view, create, and update descriptive flexfields associated to a project resource request.
Show Source
Nested Schema : Project Plan Resource Request Lines
Type:
arrayTitle:
Project Plan Resource Request LinesThe Project Plan Resource Request Lines resource is used by a project manager to view and update the status of nominated resources associated to the request.
Show Source
Nested Schema : Project Plan Resource Request Qualifications
Type:
arrayTitle:
Project Plan Resource Request QualificationsThe Project Plan Resource Request Qualifications resource is used by a project manager 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 SegmentMaximum Length:30Context of the descriptive flexfield. -
__FLEX_Context_DisplayValue: string
Title:
Context SegmentContext display value of the descriptive flexfield. -
ResourceRequestId: integer
(int64)
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestLines-item-post-request
Type:
Show Source
object-
AssignmentFinishDate: string
(date)
Title:
Assignment Finish DateAssignment finish date for the resource. -
AssignmentId: integer
Title:
Assignment IDIdentifier 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 DateAssignment start date for the resource. -
AssignmentStatusCode: string
Title:
Assignment Status CodeMaximum Length:30Code of the assignment created for the resource to fulfill the request. -
ProjectRole: string
Title:
Project RoleResource role for the project assignment. -
RejectionReason: string
Maximum Length:
80Reason the nominated resource is rejected for the project resource assignment. -
RejectionReasonCode: string
Title:
Rejection Reason CodeMaximum Length:30Code to indicate the reason the nominated resource is rejected for the project resource assigment. -
RequestLineId: integer
(int64)
Title:
Request Line IDUnique identifier of the request line under the project resource request. -
ResourceEmail: string
Title:
Resource EmailMaximum Length:240Name of the project enterprise resource associated to the project resource request. -
ResourceFulfilledDate: string
(date)
Title:
Request Fulfilled DateThe date the resource on the request line is approved to fulfill the project resource request. -
ResourceId: integer
(int64)
Title:
Resource IDIdentifier of the project enterprise resource associated to the project resource request. -
ResourceProposedDate: string
(date)
Title:
Resource Proposed DateThe date when the resource is proposed or nominated to fulfill the project resource request. -
ResourceStatus: string
Title:
Resource Staffing StatusMaximum Length:80Status of the resource associated to the project resource request. -
ResourceStatusCode: string
Title:
Resource Status CodeMaximum Length:20Default Value:NEW_LINEStatus code for the resource associated to the project resource request.
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestQualifications-item-post-request
Type:
Show Source
object-
CompetencyProficiencyLevel: string
Title:
Competency Proficiency LevelLevel 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 IDIdentifier 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:
KeywordMaximum Length:240Unstructured words or phrases that appear as keywords on a project resource request. -
MandatoryFlag: boolean
Title:
Mandatory QualificationMaximum Length:1Indicates whether the qualification is mandatory or optional. -
QualificationId: integer
(int64)
Title:
Qualification IDIdentifier 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 NameName 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 TypeType of the structured content item to indicate whether the qualification is Competency or Language. -
ReadingLanguageProficiencyLevel: string
Title:
Reading Language Proficiency LevelLevel 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 IDIdentifier 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 IDIdentifier 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 NameMaximum Length:255Content section name for the qualification. -
SpeakingLanguageProficiencyLevel: string
Title:
Speaking Language Proficiency LevelLevel 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 IDIdentifier 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 LevelLevel 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 IDIdentifier 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:
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.
Root Schema : projectPlanResourceRequests-item-response
Type:
Show Source
object-
AssignedQuantity: integer
Title:
Assigned QuantityRead Only:trueThe number of resources assigned for this project resource request. Summing up Remaining Quantity and Assigned Quantity will give you Requested Quantity. -
AssignmentType: string
Title:
Assignment TypeMaximum Length:80Indicates if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
AssignmentTypeCode: string
Title:
Assignment Type CodeMaximum Length:30Code to indicate if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
BillablePercent: integer
Title:
Billable PercentIndicates the percentage of assignment time that is billable for an assignment that is defined as Billable assignment. For a non-billable assignment, the value is ignored. Valid values are positive integer between 0 and 100 -
BillablePercentReason: string
Title:
Billable Percent ReasonMaximum Length:80Indicates the reason that the billable percentage of the project resource assignment is less than 100%. For a non-billable assignment, the value is ignored. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason CodeMaximum Length:30Code that indicates the reason that the billable percentage of the project resource assignment is less than 100%. For a non-billable assignment, the value is ignored. -
FridayHours: number
Title:
Friday HoursHours for Friday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Location: string
Title:
LocationMaximum Length:240Assignment location for the work specified on the project resource request. -
MondayHours: number
Title:
Monday HoursHours 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 IDIdentifier of the project associated to the resource request. You may enter a value for only this attribute or for Project Name but not both. -
ProjectName: string
Title:
Project NameMaximum Length:240Name of the project associated to the resource request. You may enter a value for only this attribute or for Project ID but not both. -
ProjectNumber: string
Title:
Project NumberMaximum Length:25Number of the project associated to the resource request. -
ProjectPlanResourceRequestDFF: array
Project Plan Resource Request Descriptive Flexfields
Title:
Project Plan Resource Request Descriptive FlexfieldsThe Project Plan Resource Request Descriptive Flexfields resource is used by a project manager to view, create, and update descriptive flexfields associated to a project resource request. -
ProjectPlanResourceRequestLines: array
Project Plan Resource Request Lines
Title:
Project Plan Resource Request LinesThe Project Plan Resource Request Lines resource is used by a project manager to view and update the status of nominated resources associated to the request. -
ProjectPlanResourceRequestQualifications: array
Project Plan Resource Request Qualifications
Title:
Project Plan Resource Request QualificationsThe Project Plan Resource Request Qualifications resource is used by a project manager to view, create, and manage project resource qualifications under a specific request. -
ProjectRoleId: integer
(int64)
Title:
Project Role IDIdentifier of the role that the selected resources will fill on a project. You may enter a value for only this attribute or for Project Role Name but not both. -
ProjectRoleName: string
Title:
Project Role NameMaximum Length:240Name of the role that the selected resources will fill on a project. You may enter a value for only this attribute or for Project Role ID but not both. -
ProposedQuantity: integer
Title:
Proposed QuantityRead Only:trueThe number of resources proposed or nominated for this project resource request. -
RemainingQuantity: integer
Title:
Remaining QuantityRead Only:trueDefault Value:1The number of resources remaining to fulfill this project resource request. -
RequestedFinishDate: string
(date)
Title:
Requested Finish DateDate until which a resource is requested. -
RequestedHoursperDay: number
Title:
Requested Hours per DayDefault Value:0Period of time measured in hours that establishes the number of requested hours per working day on a project resource request. -
RequestedHoursPerWeek: number
Title:
Requested Hours per WeekHours for every week of the requested duration. Applicable only if Use Weekly Hours Indicator value is true. -
RequestedQuantity: integer
Title:
Requested QuantityDefault Value:1The requested quantity of resources for this project resource request. If this request is for multiple resources, then the quantity must be greater than one. If no value is passed, the default value is set to 1. -
RequestedResourceEmail: string
Title:
Requested Resource EmailMaximum Length:240Email 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 IDIdentifier 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 NameRead Only:trueMaximum Length:240Name of the project enterprise labor 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 IDRead Only:trueIdentifier of the HCM person who is selected to fulfill the project resource request, if the Requested Quantity is equal to 1. -
RequestedStartDate: string
(date)
Title:
Requested Start DateDate from which a resource is requested. If no value is passed, the default value is set to the start date of the project. -
RequesterEmail: string
Title:
Requester EmailMaximum Length:240Email of the person who is requesting resources. Usually it is the project manager. You may enter a value for only this attribute or for Requester Resource ID but not both. -
RequesterName: string
Title:
Requester NameRead Only:trueMaximum Length:240Name of the project enterprise resource who is requesting resources. -
RequesterPersonId: integer
(int64)
Title:
Requester Person IDRead Only:trueIdentifier of the HCM person who is requesting resources. -
RequesterResourceId: integer
(int64)
Title:
Requester Resource IDIdentifier of the project enterprise resource of the person who is requesting resources. Usually it is the project manager.You may enter a value for only this attribute or for Requester Email but not both. -
RequestFulfilledDate: string
(date)
Title:
Request Fulfilled DateRead Only:trueDate on which the request is fulfilled. -
RequestName: string
Title:
Request NameMaximum Length:240Name of a project resource request. -
RequestStatus: string
Title:
Request StatusRead Only:trueMaximum Length:80Status name of the resource request. -
RequestStatusCode: string
Title:
Request Status CodeMaximum Length:30Default Value:DRAFTCode of the request status for the resource request. You may pass the value as OPEN or DRAFT when creating the request. The default value will be DRAFT.
You can update the request and change the status from from DRAFT to OPEN. But you cannot change the status from OPEN to DRAFT. -
RequestSubmittedDate: string
(date)
Title:
Request Submitted DateRead Only:trueDate on which the request is submitted. -
ResourceRequestId: integer
(int64)
Title:
Request IDIdentifier of the project resource request. -
SaturdayHours: number
Title:
Saturday HoursHours for Saturday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
SpecialInstructions: string
Title:
Special InstructionsMaximum Length:2000Special instructions for the project resource request, such as requester instructions to the resource manager. -
StaffingOwnerEmail: string
Title:
Staffing Owner EmailMaximum Length:240Email of the person who responsible for finding a resource 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 NameRead Only:trueMaximum Length:240Name of the person who is responsible for finding a resource to fulfill the request. -
StaffingOwnerPersonId: integer
(int64)
Title:
Staffing Owner Person IDRead Only:trueIdentifier of the HCM person who is responsible for finding a resource to fulfill the request. -
StaffingOwnerResourceId: integer
(int64)
Title:
Staffing Owner Resource IDIdentifier of the project enterprise resource who is responsible for finding a resource 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 RemarksMaximum Length:2000Staffing remarks captured by the resource manager during staffing. -
SundayHours: number
Title:
Sunday HoursHours for Sunday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TargetBillRate: number
Title:
Target Bill RateBill rate that represents the targeted rate for the resource who will fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Bill Rate Currency CodeMaximum Length:15Code of the currency used to define the bill rate. -
TargetCostRate: number
Title:
Target Cost RateCost rate that represents the targeted rate for the resource who is selected on the request. -
TargetCostRateCurrencyCode: string
Title:
Target Cost Rate Currency CodeMaximum Length:15Code of the currency used to define the cost rate. -
ThursdayHours: number
Title:
Thursday HoursHours for Thursday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true. -
TotalHours: number
Title:
Total Requested HoursRead Only:trueTotal requested hours for the resource for the particular assignment. -
TuesdayHours: number
Title:
Tuesday HoursHours 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 IndicatorMaximum Length:1Default Value:trueFlag to indicate if the hours for the assignment is explicitly provided in RequestedHoursperDay or should be derived from the project calendar. Valid values are Y and N. -
UseVariableHoursFlag: boolean
Title:
Use Variable Hours IndicatorIndicates 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 IndicatorIndicates 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 HoursHours for Wednesday of every week for the requested time period. Applicable only if Use Variable Hours Indicator is true.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Project Plan Resource Request Descriptive Flexfields
Type:
arrayTitle:
Project Plan Resource Request Descriptive FlexfieldsThe Project Plan Resource Request Descriptive Flexfields resource is used by a project manager to view, create, and update descriptive flexfields associated to a project resource request.
Show Source
Nested Schema : Project Plan Resource Request Lines
Type:
arrayTitle:
Project Plan Resource Request LinesThe Project Plan Resource Request Lines resource is used by a project manager to view and update the status of nominated resources associated to the request.
Show Source
Nested Schema : Project Plan Resource Request Qualifications
Type:
arrayTitle:
Project Plan Resource Request QualificationsThe Project Plan Resource Request Qualifications resource is used by a project manager 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 referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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 : projectPlanResourceRequests-ProjectPlanResourceRequestDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context SegmentMaximum Length:30Context of the descriptive flexfield. -
__FLEX_Context_DisplayValue: string
Title:
Context SegmentContext display value of the descriptive flexfield. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ResourceRequestId: integer
(int64)
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestLines-item-response
Type:
Show Source
object-
AssignedHours: number
Title:
Assigned HoursRead Only:trueAssigned hours per day when the specify hours per day is selected for use project calendar flag. -
AssignmentFinishDate: string
(date)
Title:
Assignment Finish DateAssignment finish date for the resource. -
AssignmentId: integer
Title:
Assignment IDIdentifier 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 DateAssignment start date for the resource. -
AssignmentStatus: string
Title:
Resource Staffing StatusRead Only:trueMaximum Length:80Status of the assignment created for the resource to fulfill the request. -
AssignmentStatusCode: string
Title:
Assignment Status CodeMaximum Length:30Code of the assignment created for the resource to fulfill the request. -
CurrentFlag: boolean
Title:
Current IndicatorRead Only:trueMaximum Length:1Indicates whether the project resource request is the most recent request for the assignment. Valid values are Y and N. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ProjectRole: string
Title:
Project RoleResource role for the project assignment. -
RejectionReason: string
Maximum Length:
80Reason the nominated resource is rejected for the project resource assignment. -
RejectionReasonCode: string
Title:
Rejection Reason CodeMaximum Length:30Code to indicate the reason the nominated resource is rejected for the project resource assigment. -
RequestLineId: integer
(int64)
Title:
Request Line IDUnique identifier of the request line under the project resource request. -
ReservationExpirationDate: string
(date)
Title:
Reservation Expiration DateRead Only:trueReservation expiration date for the resource if the assignment status is reserved. -
ReservationReason: string
Title:
Reservation ReasonRead Only:trueReservation reason for the resource if the assignment status is reserved. -
ResourceEmail: string
Title:
Resource EmailMaximum Length:240Name of the project enterprise resource associated to the project resource request. -
ResourceFulfilledDate: string
(date)
Title:
Request Fulfilled DateThe date the resource on the request line is approved to fulfill the project resource request. -
ResourceId: integer
(int64)
Title:
Resource IDIdentifier of the project enterprise resource associated to the project resource request. -
ResourceName: string
Title:
Resource NameRead Only:trueMaximum Length:240Email of the project enterprise resource associated to the project resource request. -
ResourcePersonId: integer
(int64)
Title:
Resource HCM Person IDRead Only:trueHCM person identifier of the project enterprise resource associated to the project resource request. -
ResourceProposedDate: string
(date)
Title:
Resource Proposed DateThe date when the resource is proposed or nominated to fulfill the project resource request. -
ResourceStatus: string
Title:
Resource Staffing StatusMaximum Length:80Status of the resource associated to the project resource request. -
ResourceStatusCode: string
Title:
Resource Status CodeMaximum Length:20Default Value:NEW_LINEStatus code for the resource associated to the project resource request. -
ResourceSystemStatus: string
Title:
Resource System StatusRead Only:trueResource system status based on the seeded values. -
UseProjectCalendarFlag: boolean
Title:
Use Project Calendar IndicatorRead Only:trueIndicates whether to use project calendar hours or specific hours per day.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestQualifications-item-response
Type:
Show Source
object-
CompetencyProficiencyLevel: string
Title:
Competency Proficiency LevelLevel 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 IDIdentifier 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:
KeywordMaximum Length:240Unstructured words or phrases that appear as keywords on a project resource request. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
Mandatory QualificationMaximum Length:1Indicates whether the qualification is mandatory or optional. -
QualificationId: integer
(int64)
Title:
Qualification IDIdentifier 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 NameName 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 TypeType of the structured content item to indicate whether the qualification is Competency or Language. -
ReadingLanguageProficiencyLevel: string
Title:
Reading Language Proficiency LevelLevel 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 IDIdentifier 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 IDRead Only:trueUnique identifier of the resource request qualification associated to the request. -
SectionId: integer
(int64)
Title:
Content Section IDIdentifier 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 NameMaximum Length:255Content section name for the qualification. -
SpeakingLanguageProficiencyLevel: string
Title:
Speaking Language Proficiency LevelLevel 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 IDIdentifier 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 LevelLevel 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 IDIdentifier 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:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ProjectPlanResourceRequestDFF
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Plan Resource Request Descriptive Flexfields resource is used by a project manager to view, create, and update descriptive flexfields associated to a project resource request. - ResourceRequestId:
- ProjectPlanResourceRequestLines
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Plan Resource Request Lines resource is used by a project manager to view and update the status of nominated resources associated to the request. - ResourceRequestId:
- ProjectPlanResourceRequestQualifications
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
The Project Plan Resource Request Qualifications resource is used by a project manager to view, create, and manage project resource qualifications under a specific request. - ResourceRequestId:
- approveRequest
-
Parameters:
- 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
-
Parameters:
- ResourceRequestId:
$request.path.ResourceRequestId
Cancel project resource request via this action. The request must be in Open status to allow this action. - ResourceRequestId:
- rejectRequest
-
Parameters:
- 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 create a project plan resource request by submitting a POST request on the REST resource using cURL.
curl --user ppm_cloud_user -X POST -d @example_request_payload.json --header "Content-Type: application/json" https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectPlanResourceRequests
Example 1 Request Body
The following shows an example of the request body in JSON format.
{
"RequestName": "Advanced Scheduling PayLoads Test 3",
"RequestStatusCode": "OPEN",
"RequestedStartDate": "2019-11-01",
"RequestedFinishDate": "2019-11-02",
"RequestedHoursperDay": 0,
"UseProjectCalendarFlag": null,
"RequestedResourceId": 300100024326749,
"ProjectId": 300100025404077,
"ProjectRoleId": 300100025498091,
"RequesterResourceId": 300100081800169,
"StaffingOwnerResourceId": 300100026245821,
"SundayHours": 0,
"MondayHours": 2,
"TuesdayHours": 3,
"WednesdayHours": 4,
"ThursdayHours": 5,
"FridayHours": 6,
"SaturdayHours": 0,
"UseVariableHoursFlag": true
}
Example 1 Response Body
The following shows an example of the response body in JSON format.
{
"ResourceRequestId": 300100185388400,
"RequestName": "Advanced Scheduling PayLoads Test 3",
"RequestStatusCode": "OPEN",
"RequestStatus": "Open",
"RequestedStartDate": "2019-11-01",
"RequestedFinishDate": "2019-11-02",
"RequestFulfilledDate": null,
"RequestedHoursperDay": null,
"UseProjectCalendarFlag": false,
"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": null,
"RemainingQuantity": 1,
"AssignmentTypeCode": null,
"AssignmentType": null,
"BillablePercent": null,
"BillablePercentReasonCode": null,
"BillablePercentReason": null,
"SundayHours": 0,
"MondayHours": 2,
"TuesdayHours": 3,
"WednesdayHours": 4,
"ThursdayHours": 5,
"FridayHours": 6,
"SaturdayHours": 0,
"UseVariableHoursFlag": true
}
Example 2
The following example shows how to create a project plan resource request by submitting a POST request on the REST resource using cURL.
curl --user ppm_cloud_user -X POST -d @example_request_payload.json --header "Content-Type: application/json" https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectPlanResourceRequests
Example 2 Request Body
The following shows an example of the request body in JSON format.
{
"RequestName": "Test Weekly",
"RequestStatusCode": "OPEN",
"ProjectId": 300100025498095,
"ProjectRoleName": "Oracle DBA",
"RequestedStartDate": "2020-07-29",
"RequestedFinishDate": "2020-08-29",
"AssignmentTypeCode": "BILLABLE",
"BillablePercentReasonCode": "ORA_INVESTMENT",
"BillablePercent": 25,
"UseProjectCalendarFlag": false,
"RequestedHoursperDay": null,
"UseVariableHoursFlag": false,
"UseWeeklyHoursFlag": true,
"RequestedHoursPerWeek": 25
}
Example 2 Response Body
The following shows an example of the response body in JSON format.
{
"ResourceRequestId": 300100186429974,
"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": 300100025498095,
"ProjectName": "QA_PJR_Project1",
"ProjectNumber": "300100025498095",
"ProjectRoleId": 300100025498083,
"ProjectRoleName": "Oracle DBA",
"RequesterResourceId": 300100024326751,
"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": null,
"RemainingQuantity": 1,
"AssignmentTypeCode": "BILLABLE",
"AssignmentType": "Billable",
"BillablePercent": 25,
"BillablePercentReasonCode": "ORA_INVESTMENT",
"BillablePercentReason": "Investment",
"SundayHours": null,
"MondayHours": null,
"TuesdayHours": null,
"WednesdayHours": null,
"ThursdayHours": null,
"FridayHours": null,
"SaturdayHours": null,
"UseVariableHoursFlag": false,
"UseWeeklyHoursFlag": true,
"RequestedHoursPerWeek": 25,
"links": [
{..},{..}...
]
}