...
This structure represents the unique key fields associated with a resource candidate for 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
| Panel | ||
|---|---|---|
| ||
|
...
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 to candidate on the role. | true | |||
RequestedCandidateFlag | Boolean | If 'true', the resource is a requested for candidate on the role role. | false | |||
RequesterCanRequestHoursFlag | Boolean | If 'true', the requester caller can request hours against this role. | true | |||
RequesterCanSwitchToThisCandidateFlag | Boolean | If 'true', the requester caller can switch the preferred resource candidate on this role. | false | |||
ResourceIdentity | PwsResourceRefThis | structure represents the unique key fields associated with identifying a resource. Resources can be identified by ResourceDisplayName, ResourceReferenceSystemId or ResourceUid. When specifying a PwsResourceRef as an input to a web service, you may specify any combination of the three fields. However, if you do specify more than one, they must all refer to the same resource or the resource reference will not be considered valid. When a PwsResourceRef is returned in the response to a web service, the ResourceDisplayName, ResourceReferenceSystemId or ResourceUid will be populated, and guaranteed to refer to a single resource.The resource associated with this candidate, if it is a named candidate, | ||||
SchedulerCanBookHoursFlag | Boolean | If 'true', the scheduler caller can book hours against this role. | true | |||
SchedulerCanSwitchToThisCandidateFlag | Boolean | If 'true', the scheduler caller can switch the assigned resource candidate on this role. | false | |||
SelectedCandidateFlag | Boolean | If 'true', a preferred candidate has been selectedthis candidate represents the effective resource on the project role it belongs to. | true | |||
UnnamedCandidateCostCenterIdentity | This structure is used to uniquely identify a cost center. Cost Centers can be identified by CostCenterName, CostCenterNumber, and/or CostCenterUid. When specifying a PwsCostCenterRef as an input to a web service, you may specify any combination of these fields. However, if you specify multiple fields, they must all refer to the same cost center or the cost center reference will not be considered valid. When a CostCenterRef is returned in the response to a web service, the CostCenterName, CostCenterNumber and CostCenterUid will all be populated, and guaranteed to refer to a single cost centerFor unnamed candidates, the cost center. | |||||
UnnamedCandidateFlag | Boolean | If 'true', the role this is assigned to an unnamed candidate, Unnamed candidates specify a cost center, location, title and resource type but do not identify a specific resource. | false | |||
UnnamedCandidateLocationIdentity | This structure contains the unique key fields associated with a location. Locations can be identified by LocationName or LocationUid. When specifying a PwsLocationRef as an input to a web service, you may specify one or both of LocationName and LocationUid. However, if you do specify both, they must both refer to the same location or the location reference will not be considered valid. When a PwsLocationRef is returned in the response to a web service, both the LocationName or LocationUid will be populated, and guaranteed to refer to a single location. | UnnamedCandidateResourceTypeIdentity | This structure represents the unique key fields associated with identifying a resource type. Resources types enable an organization to easily set up and classify resources. Resource types can be identified by ResourceTypeCode, ResourceTypeName or ResourceTypeUid. When specifying a PwsResourceTypeRef as an input to a web service, you may specify one, two, or all three identifiers. However, if you do specify multiple identifiers, they must all refer to the same resource type or the resource type reference will not be considered valid. When a PwsResourceTypeRef is returned in the response to a web service, the ResourceTypeCode, ResourceTypeName and ResourceTypeUidwill be populated, and guaranteed to refer to a single For unnamed candidates, the location. | |||
UnnamedCandidateResourceTypeIdentity | For unnamed candidates, the resource type. | |||||
UnnamedCandidateTitleIdentity | This structure represents the unique key fields associated with identifying a resource title. Titles are used when requesting and booking resources during the resource scheduling workflow, in the determination of default billing. A title can be identified either by a unique identifier (UID), or the combination of department identity and name. The department identity or title name alone do not sufficiently identify a single title. When passing a title identity as input to a web service, you need only specify the unique identifier or the department identity and title name. You may specify all three values if you wish, but if you do so, they must all refer to the same title, or the reference will not be considered valid. When this structure is returned as part of the response from a web service, all fields will be specified, and will be guaranteed to refer to a single For unnamed candidates, the title. |
Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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> |
...