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 Type
Maximum Length:80
Indicates if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
AssignmentTypeCode: string
Title:
Assignment Type Code
Maximum Length:30
Code 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 Percent
Indicates 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 Reason
Maximum Length:80
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. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason Code
Maximum Length:30
Code 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 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
Assignment location for the work specified on the project 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
Identifier 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 Name
Maximum Length:240
Name 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 Number
Maximum Length:25
Number of the project associated to the resource request. -
ProjectPlanResourceRequestDFF: array
Project Plan Resource Request Descriptive Flexfields
Title:
Project Plan Resource Request Descriptive Flexfields
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. -
ProjectPlanResourceRequestLines: array
Project Plan Resource Request Lines
Title:
Project Plan Resource Request Lines
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. -
ProjectPlanResourceRequestQualifications: array
Project Plan Resource Request Qualifications
Title:
Project Plan Resource Request Qualifications
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. -
ProjectRoleId: integer
(int64)
Title:
Project Role ID
Identifier 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 Name
Maximum Length:240
Name 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 Date
Date until which a resource is requested. -
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. -
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 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 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(required): string
(date)
Title:
Requested Start Date
Date 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 Email
Maximum Length:240
Email 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 ID
Identifier 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 Name
Maximum Length:240
Name of a project resource request. -
RequestStatusCode: string
Title:
Request Status Code
Maximum Length:30
Default Value:DRAFT
Code 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 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 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 ID
Identifier 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 Remarks
Maximum Length:2000
Staffing remarks captured 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 resource who will fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Bill 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 resource who is 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 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 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 Plan Resource Request Descriptive Flexfields
Type:
array
Title:
Project Plan Resource Request Descriptive Flexfields
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.
Show Source
Nested Schema : Project Plan Resource Request Lines
Type:
array
Title:
Project Plan Resource Request Lines
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.
Show Source
Nested Schema : Project Plan Resource Request Qualifications
Type:
array
Title:
Project Plan Resource Request Qualifications
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.
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. -
ResourceRequestId: integer
(int64)
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestLines-item-post-request
Type:
Show Source
object
-
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. -
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. -
RequestLineId: integer
(int64)
Title:
Request Line ID
Unique identifier of the request line under the project resource request. -
ResourceEmail: string
Title:
Resource Email
Maximum Length:240
Name 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. -
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.
Nested Schema : projectPlanResourceRequests-ProjectPlanResourceRequestQualifications-item-post-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. -
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. -
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 : projectPlanResourceRequests-item-response
Type:
Show Source
object
-
AssignedQuantity: integer
Title:
Assigned Quantity
Read Only:true
The 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 Type
Maximum Length:80
Indicates if a request is for a billable or a nonbillable assignment. Examples are BILLABLE, NON-BILLABLE, or leave blank. -
AssignmentTypeCode: string
Title:
Assignment Type Code
Maximum Length:30
Code 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 Percent
Indicates 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 Reason
Maximum Length:80
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. -
BillablePercentReasonCode: string
Title:
Billable Percent Reason Code
Maximum Length:30
Code 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 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
Assignment location for the work specified on the project 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
Identifier 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 Name
Maximum Length:240
Name 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 Number
Maximum Length:25
Number of the project associated to the resource request. -
ProjectPlanResourceRequestDFF: array
Project Plan Resource Request Descriptive Flexfields
Title:
Project Plan Resource Request Descriptive Flexfields
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. -
ProjectPlanResourceRequestLines: array
Project Plan Resource Request Lines
Title:
Project Plan Resource Request Lines
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. -
ProjectPlanResourceRequestQualifications: array
Project Plan Resource Request Qualifications
Title:
Project Plan Resource Request Qualifications
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. -
ProjectRoleId: integer
(int64)
Title:
Project Role ID
Identifier 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 Name
Maximum Length:240
Name 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 Quantity
Read Only:true
The number of resources proposed or nominated for this project resource request. -
RemainingQuantity: integer
Title:
Remaining Quantity
Read Only:true
Default Value:1
The number of resources remaining to fulfill this project resource request. -
RequestedFinishDate: string
(date)
Title:
Requested Finish Date
Date until which a resource is requested. -
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. -
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 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 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 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 ID
Read Only:true
Identifier 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 Date
Date 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 Email
Maximum Length:240
Email 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 Name
Read Only:true
Maximum Length:240
Name of the project enterprise resource who is requesting resources. -
RequesterPersonId: integer
(int64)
Title:
Requester Person ID
Read Only:true
Identifier of the HCM person who is requesting resources. -
RequesterResourceId: integer
(int64)
Title:
Requester Resource ID
Identifier 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 Date
Read Only:true
Date on which the request is fulfilled. -
RequestName: string
Title:
Request Name
Maximum Length:240
Name of a project resource request. -
RequestStatus: string
Title:
Request Status
Read Only:true
Maximum Length:80
Status name of the resource request. -
RequestStatusCode: string
Title:
Request Status Code
Maximum Length:30
Default Value:DRAFT
Code 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 Date
Read Only:true
Date on which the 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 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 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 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 Remarks
Maximum Length:2000
Staffing remarks captured 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 resource who will fulfill the request. -
TargetBillRateCurrencyCode: string
Title:
Target Bill 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 resource who is 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 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 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 Plan Resource Request Descriptive Flexfields
Type:
array
Title:
Project Plan Resource Request Descriptive Flexfields
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.
Show Source
Nested Schema : Project Plan Resource Request Lines
Type:
array
Title:
Project Plan Resource Request Lines
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.
Show Source
Nested Schema : Project Plan Resource Request Qualifications
Type:
array
Title:
Project Plan Resource Request Qualifications
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.
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 : projectPlanResourceRequests-ProjectPlanResourceRequestDFF-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 : projectPlanResourceRequests-ProjectPlanResourceRequestLines-item-response
Type:
Show Source
object
-
AssignedHours: number
Title:
Assigned Hours
Read Only:true
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
Read Only:true
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. Valid values are Y and N. -
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
Read Only:true
Reservation expiration date for the resource if the assignment status is reserved. -
ReservationReason: string
Title:
Reservation Reason
Read Only:true
Reservation reason for the resource if the assignment status is reserved. -
ResourceEmail: string
Title:
Resource Email
Maximum Length:240
Name 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
Email 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
Read Only:true
Indicates 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 : projectPlanResourceRequests-ProjectPlanResourceRequestQualifications-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
- 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": [ {..},{..}... ] }