Overview

This structure represents a candidate on a project role. A role may have requested candidates and/or assigned candidates. A specific resource may be both a requested candidate and an assigned candidate, A candidate may be named or unnamed.

Format

PwsProjectRoleCandidate

PwsProjectRoleCandidate
- AllowBookOwnTimeFlag: Boolean
- AllowRequestOwnTimeFlag: Boolean
- AssignedCandidateFlag: Boolean
- RequestedCandidateFlag: Boolean
- RequesterCanRequestHoursFlag: Boolean
- RequesterCanSwitchToThisCandidateFlag: Boolean
- ResourceIdentity: PwsResourceRef
- SchedulerCanBookHoursFlag: Boolean
- SchedulerCanSwitchToThisCandidateFlag: Boolean
- SelectedCandidateFlag: Boolean
- UnnamedCandidateCostCenterIdentity: PwsCostCenterRef
- UnnamedCandidateFlag: Boolean
- UnnamedCandidateLocationIdentity: PwsLocationRef
- UnnamedCandidateResourceTypeIdentity: PwsResourceTypeRef
- UnnamedCandidateTitleIdentity: PwsTitleRef

Elements

Element	Data Type	Description	Sample Data
AllowBookOwnTimeFlag	Boolean	If 'true', the resource has permission to book his/her own time on a role.	false
AllowRequestOwnTimeFlag	Boolean	If 'true', the resource has permission to request his/her own time on a role.	false
AssignedCandidateFlag	Boolean	If 'true', the resource is an assigned candidate on the role.	true
RequestedCandidateFlag	Boolean	If 'true', the resource is a requested candidate on the role.	false
RequesterCanRequestHoursFlag	Boolean	If 'true', caller can request hours against this role.	true
RequesterCanSwitchToThisCandidateFlag	Boolean	If 'true', caller can switch the preferred resource candidate on this role.	false
ResourceIdentity	PwsResourceRef	The resource associated with this candidate, if it is a named candidate,
SchedulerCanBookHoursFlag	Boolean	If 'true', the caller can book hours against this role.	true
SchedulerCanSwitchToThisCandidateFlag	Boolean	If 'true', the caller can switch the assigned resource candidate on this role.	false
SelectedCandidateFlag	Boolean	If 'true', this candidate represents the effective resource on the project role it belongs to.	true
UnnamedCandidateCostCenterIdentity	PwsCostCenterRef	For unnamed candidates, the cost center.
UnnamedCandidateFlag	Boolean	If 'true', this is an unnamed candidate, Unnamed candidates specify a cost center, location, title and resource type but do not identify a specific resource.	false
UnnamedCandidateLocationIdentity	PwsLocationRef	For unnamed candidates, the location.
UnnamedCandidateResourceTypeIdentity	PwsResourceTypeRef	For unnamed candidates, the resource type.
UnnamedCandidateTitleIdentity	PwsTitleRef	For unnamed candidates, the title.

Usage Example(s)

Example 01

                     <b:PwsProjectRoleCandidate>
                        <b:AllowBookOwnTimeFlag>false</b:AllowBookOwnTimeFlag>
                        <b:AllowRequestOwnTimeFlag>false</b:AllowRequestOwnTimeFlag>
                        <b:AssignedCandidateFlag>true</b:AssignedCandidateFlag>
                        <b:RequestedCandidateFlag>false</b:RequestedCandidateFlag>
                        <b:RequesterCanRequestHoursFlag>true</b:RequesterCanRequestHoursFlag>
                        <b:RequesterCanSwitchToThisCandidateFlag>false</b:RequesterCanSwitchToThisCandidateFlag>
                        <b:ResourceIdentity>
                           <b:ResourceDisplayName>Matt</b:ResourceDisplayName>
                           <b:ResourceId i:nil="true"/>
                           <b:ResourceReferenceSystemId>IT (USA) - 01</b:ResourceReferenceSystemId>
                           <b:ResourceUid>1152921504607057128</b:ResourceUid>
                        </b:ResourceIdentity>
                        <b:SchedulerCanBookHoursFlag>true</b:SchedulerCanBookHoursFlag>
                        <b:SchedulerCanSwitchToThisCandidateFlag>false</b:SchedulerCanSwitchToThisCandidateFlag>
                        <b:SelectedCandidateFlag>true</b:SelectedCandidateFlag>
                        <b:UnnamedCandidateCostCenterIdentity i:nil="true"/>
                        <b:UnnamedCandidateFlag>false</b:UnnamedCandidateFlag>
                        <b:UnnamedCandidateLocationIdentity i:nil="true"/>
                        <b:UnnamedCandidateResourceTypeIdentity i:nil="true"/>
                        <b:UnnamedCandidateTitleIdentity i:nil="true"/>
                     </b:PwsProjectRoleCandidate>