Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

Overview

This structure contains the complete set of information about a project role. The structure is used both to retrieve detailed project role information and to pass information about a project role back to the server to get updated.

The candidates, resources and criteria represented in this structure will reflect either the requested values, assigned values or effective values, as determined by the mode specified when retrieving the record (see PwsGetProject). This applies to:

  • CandidateIdentities
  • CostCenterAnyFlag
  • CostCenterCriteria
  • CostCenterIdentity
  • Keywords
  • LocationAnyFlag
  • LocationIdentities
  • LocationIdentity
  • ResourceIdentity
  • SkillCriteria
  • TitleIdentities
  • TitleIdentity

Format

PwsProjectRoleDetail

Elements

Element

Data Type

Required?

Default

Description

Sample Data

ExternalSystemIdentifier

String (50)

One of ExternalSystemIdentifier or ProjectRoleUid is required


The external system identifier is a unique identifier for a project role (may be null, but once set can only be updated to a different, non-null value).

#00001

ProjectRoleId

Int32

On Insert: No

On Update: No


The project role id is a unique identifier for a project role. For internal use only.   


ProjectRoleUid

Int64

See ExternalSystemIdentifier


A unique and immutable identifier for a project role.

1152921504608152048

BaseRateOnTitleIdentity

PwsTitleRef

On Insert: No

On Update: No


If the role has a billing title override, this identifies the title to base rates upon. Click here for more information.


CandidateIdentities

PwsResourceRef

On Insert: No

On Update: No


A collection of named resource candidates for the role. Click here for more information.


CostCenterAnyFlag

Boolean

On Insert: No

On Update: No

false

If set to 'true', all cost centers are selected as part of the unnamed candidate search criteria.

false

CostCenterCriteria

PwsCostCenterCriteria

On Insert: No

On Update: No


A collection of cost centers that are selected as part of the unnamed candidate search criteria. Click here for more information.


CostCenterIdentity

PwsCostCenterRef

On Insert: No

On Update: No


The preferred, allocated or effective cost center in the unnamed candidate search criteria. Click here for more information.


DefaultSchedulingMode

String (1)

On Insert: No

On Update: No

Engagement Type's default setting

The scheduling mode for this role:

D: daily

W: weekly


Description

String (255)

On Insert: No

On Update: No


The description for this role.

Business analyst (Web Commerce)_

Keywords

String (255)

On Insert: No

On Update: No


The keywords used in the unnamed candidate search criteria.

HTML

LocationAnyFlag

Boolean

On Insert: No

On Update: No

false

If set to 'true', all locations are selected as part of the unnamed candidate search criteria.

false

LocationIdentities

PwsLocationRef

On Insert: No

On Update: No


A collection of locations that are selected as part of the unnamed candidate search criteria. Click here for more information. 


LocationIdentity

PwsLocationRef

On Insert: No

On Update: No


The preferred, allocated or effective location in the unnamed candidate search criteria. Click here for more information. 


NewExternalSystemIdentifier

String

On Insert: No

On Update: No


See ExternalSystemIdentifier above. Use this to modify the external system identifier for an existing project role.

#00001-1

ResourceIdentity

PwsResourceRef

On Insert: No

On Update: No


The preferred, allocated or effective named candidate for this role. Click here for more information.


RoleEndDate

DateTime

On Insert: No

On Update: No


The end date of this role.

2018-12-31z

RoleName

String (32)

On Insert: Yes

On Update: No


The name of this role.

Business Analyst

RoleStartDate

DateTime

On Insert: No

On Update: No


The start date of this role.

2018-07-01z

ShareCostCenterIdentity

PwsCostCenterRef

On Insert: No

On Update: No


The identity of shared cost center for this role. Click here for more information.


SkillCriteria

PwsSkillCriteria

On Insert: No

On Update: No


The collection of skills that are selected in the unnamed candidate search criteria. Click here for more information.


TitleIdentities

PwsTitleRef

On Insert: No

On Update: No


A collection of Titles that are selected as part of the unnamed candidate search criteria. Click here for more information. 


TitleIdentity

PwsTitleRef

On Insert: No

On Update: No


The preferred, allocated or effective title in the unnamed candidate search criteria. Click here for more information. 


RdcTransferCurrencyIdentity

PwsCurrencyRef

On Insert: No

On Update: No

Resource's cost center currency

The RDC transfer rate currency for this role. Click here for more information.


RdcTransferHourlyRate

Double

On Insert: No

On Update: No


The RDC transfer hourly rate for this role.

35

RevenueTransferHourlyRate

Double

On Insert: No

On Update: No


The revenue transfer hourly rate for this role.

80

UserDefinedFields

PwsUserDefinedFieldDetail

On Insert: No

On Update: No


A collection of user defined fields and their values for this role. Click here for more information.


RateExceptions

PwsProjectRoleRateException

On Insert: No

On Update: No


Overrides to resource's title based rates. Click here for more information.


RdcExceptions

PwsProjectRoleRDCException

On Insert: No

On Update: No


Overrides to resource's RDC rates. Click here for more information.


InheritPurchaseOrderNumberFlag

Boolean

On Insert: No

On Update: No

true

If set to 'true', project inherits the purchase order number from the project.


PurchaseOrderNumber

String

On Insert: No

On Update: No

Project's purchase order number

The purchase order number associated with this project role. Specify only if not inheriting the purchase order number from the project.


Usage Example(s)


Example 01 
             <sch:ProjectRole>
               <com:ExternalSystemIdentifier>R-001</com:ExternalSystemIdentifier>
               <!--com:ProjectRoleUid>?</com:ProjectRoleUid-->
               <com:BaseRateOnTitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>Management</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Administrator</com:TitleName>
               </com:BaseRateOnTitleIdentity>
               <com:CandidateIdentities>
                  <!--Zero or more repetitions:-->
                  <com:PwsResourceRef>
                     <com:ResourceDisplayName>Max Yang</com:ResourceDisplayName>
                  </com:PwsResourceRef>
               </com:CandidateIdentities>
               <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>
               <com:CostCenterCriteria>
                  <!--Zero or more repetitions:-->
                  <com1:PwsCostCenterCriteria>
                     <com1:CascadeFlag>true</com1:CascadeFlag>
                     <com1:CostCenterIdentity>
                        <com:CostCenterName>RevCorp CH</com:CostCenterName>
                     </com1:CostCenterIdentity>
                  </com1:PwsCostCenterCriteria>
               </com:CostCenterCriteria>
               <com:CostCenterIdentity>
                  <com:CostCenterName>RevCorp CA</com:CostCenterName>
               </com:CostCenterIdentity>
               <com:DefaultSchedulingMode>W</com:DefaultSchedulingMode>
               <com:Description>Created from PwsSaveProjectRole 1</com:Description>
               <com:Keywords>Executive</com:Keywords>
         	  <com:LocationAnyFlag>true</com:LocationAnyFlag> 
              <com:LocationIdentities>
                  <!--Zero or more repetitions:-->
                  <com:PwsLocationRef>
                     <com:LocationName>Boston</com:LocationName>
                  </com:PwsLocationRef>
               </com:LocationIdentities>
 			 <com:LocationIdentity>
                  <com:LocationName>Shanghai</com:LocationName>
               </com:LocationIdentity>
               <com:RoleEndDate>2018-12-31z</com:RoleEndDate>
               <com:RoleName>Role-I</com:RoleName>
               <com:RoleStartDate>2018-01-01z</com:RoleStartDate>
               <com:ShareCostCenterIdentity>
                  <com:CostCenterName>Revcorp CH</com:CostCenterName>
               </com:ShareCostCenterIdentity>
               <com:SkillCriteria>
                  <!--Zero or more repetitions:-->
                  <com:PwsSkillCriteria>
                     <com:SkillIdentity>
                        <com:SkillGroupIdentity>
                           <com:SkillGroupName>Technology</com:SkillGroupName>
                        </com:SkillGroupIdentity>
                        <com:SkillName>HTML</com:SkillName>
                     </com:SkillIdentity>
                     <com:SkillLevelMask>3</com:SkillLevelMask>
                  </com:PwsSkillCriteria>
               </com:SkillCriteria>
               <com:TitleIdentities>
                  <!--Zero or more repetitions:-->
                  <com:PwsTitleRef>
                     <com:DepartmentIdentity>
                        <com:DepartmentName>Technology</com:DepartmentName>
                     </com:DepartmentIdentity>
                     <com:TitleName>Technical Consultant</com:TitleName>
                  </com:PwsTitleRef>
               </com:TitleIdentities>
               <com:TitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>Technology</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Technical Consultant</com:TitleName>
               </com:TitleIdentity>
               <com:RdcTransferCurrencyIdentity>
                  <com:CurrencyCode>USD</com:CurrencyCode>
               </com:RdcTransferCurrencyIdentity>
               <com:RdcTransferHourlyRate>7</com:RdcTransferHourlyRate>
               <com:RevenueTransferHourlyRate>14</com:RevenueTransferHourlyRate>
               <com:RdcExceptions>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectRoleRdcException>
                     <com:BeginDate>2018-02-01z</com:BeginDate>
                     <com:EndDate>2018-02-08z</com:EndDate>
                     <com:HourlyRate>11</com:HourlyRate>
                     <com:RdcCurrencyIdentity>
                        <com:CurrencyCode>USD</com:CurrencyCode>
                     </com:RdcCurrencyIdentity>
                  </com:PwsProjectRoleRdcException>
               </com:RdcExceptions>
            </sch:ProjectRole>





  • No labels