Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This structure contains the complete set of information about a project role (less any subordinate entities)rate type. The structure is used both to retrieve detailed project role rate type information and to pass information about a project role rate type back to the server to get updated.

Format

Panel
titlePwsProjectRoleDetailPwsProjectRateTypeDetail

Elements

Element

Data Type

Required?

Default

Description

Sample Data

ExternalSystemIdentifier

String

One of ExternalSystemIdentifier or ProjectRoleUid ProjectRateTypeUid is required


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

#00001

ProjectRoleId

Int32MET-RT-002

ProjectRateTypeId

Int32

On Insert: No

On Update: No


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


ProjectRoleUidProjectRateTypeUid

Int64

See ExternalSystemIdentifier


A unique and immutable identifier for a project role

1152921504608152048

BaseRateOnTitleIdentity

PwsTitleRef

On Insert: No

On Update: No

If a resource is not billed based on their own title, specify the overriding title using this element. 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 cost center in the unnamed candidate search criteria. Click here for more information.

DefaultSchedulingMode

String (1project rate type.

1152921504606847340

ProjectRateTypeName

String (50)

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

PwsLocationRefThe name of the project rate type.

Non-chargeable

BillingAdjustedDiscountPercent

Double

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 location in the unnamed candidate search criteria. Click here for more information. 

NewExternalSystemIdentifier

String

On Insert: No

On Update: No

See ExternalSystemIdentifier above.

#00001-1

ResourceIdentity

PwsResourceRef0

The discount percent that applies to the billing adjusted rate.

0.2

BillingAdjustedHourlyRate

Double

On Insert: No

On Update: No


The preferred 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

billing adjusted hourly rate.

120

ContractDiscountPercent

Double

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 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

0

The discount percent that applies to the contract rate.

0.3

ContractHourlyRate

Double

On Insert: No

On Update: No


The RDC trasnfer contract hourly rate for this role.

35100

RevenueTransferHourlyRateSortOrder

DoubleInt16

On Insert: No

On Update: No


The revenue trasnfer hourly rate for this role.

80

UserDefinedFields

PwsUserDefinedFieldDetailsort order, among all of the rate types defined for the project.

1

StandardRateTypeIdentity

PwsStandardRateTypeRef

On Insert: No

On Update: No


A collection of user defined fields and their values for this roleThe standard rate type for the project rate type. 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

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


Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
             <sch:ProjectRole><b:ProjectRateTypeDetail>
               <com:ExternalSystemIdentifier>R-001</com:ExternalSystemIdentifier>
               <!--com:ProjectRoleUid>?</com:ProjectRoleUid--<b:ExternalSystemIdentifier i:nil="true"/>
               <com:BaseRateOnTitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>Management</com:DepartmentName><b:ProjectRateTypeId i:nil="true"/>
                  </com:DepartmentIdentity>
                  <com:TitleName>Administrator</com:TitleName><b:ProjectRateTypeUid>1152921504606922399</b:ProjectRateTypeUid>
               </com:BaseRateOnTitleIdentity>
               <com:CandidateIdentities>
                  <!--Zero or more repetitions:-->
                  <com:PwsResourceRef>
                     <com:ResourceDisplayName>Max Yang</com:ResourceDisplayName><b:ProjectRateTypeName>Regular</b:ProjectRateTypeName>
                  </com:PwsResourceRef>
               </com:CandidateIdentities>
               <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>
               <com:CostCenterCriteria>
                  <!--Zero or more repetitions:--<b:BillingAdjustedDiscountPercent i:nil="true"/>
                  <com1:PwsCostCenterCriteria>
                     <com1:CascadeFlag>true</com1:CascadeFlag><b:BillingAdjustedHourlyRate>110</b:BillingAdjustedHourlyRate>
                     <com1:CostCenterIdentity>
                        <com:CostCenterName>RevCorp CH</com:CostCenterName><b:ContractDiscountPercent i:nil="true"/>
                     </com1:CostCenterIdentity>
                  </com1:PwsCostCenterCriteria><b:ContractHourlyRate>100</b:ContractHourlyRate>
               </com:CostCenterCriteria>
               <com:CostCenterIdentity>
                  <com:CostCenterName>RevCorp CA</com:CostCenterName><b:SortOrder>1</b:SortOrder>
               </com:CostCenterIdentity><b:StandardRateTypeIdentity>
               <com:DefaultSchedulingMode>W</com:DefaultSchedulingMode><b:StandardRateTypeCode>Reg</b:StandardRateTypeCode>
               <com:Description>Created from PwsSaveProjectRole 1</com:Description>
               <com:Keywords>Executive</com:Keywords><b:StandardRateTypeId i:nil="true"/>
         	  <com<b:LocationAnyFlag>true<StandardRateTypeName>Regular</comb:LocationAnyFlag>StandardRateTypeName>
               <com:LocationIdentities>
                  <!--Zero or more repetitions:-->
                  <com:PwsLocationRef>
                     <com:LocationName>Boston</com:LocationName>
      <b:StandardRateTypeUid>1152921504606847191</b:StandardRateTypeUid>
           </com:PwsLocationRef>
         b:StandardRateTypeIdentity>
     </comb:LocationIdentities>
 			 <com:LocationIdentity>
                  <com:LocationName>Shanghai</com:LocationName>ProjectRateTypeDetail>
Code Block
languagexml
titleExample 02
collapsetrue
   <b:ProjectRateTypeDetail>
               </com:LocationIdentity>
               <com:RoleEndDate>2018-12-31z</com:RoleEndDate><b:ExternalSystemIdentifier i:nil="true"/>
               <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:--<b:ProjectRateTypeId i:nil="true"/>
                  <com:PwsSkillCriteria>
                     <com:SkillIdentity>
                        <com:SkillGroupIdentity>
                           <com:SkillGroupName>Technology</com:SkillGroupName><b:ProjectRateTypeUid>1152921504606922400</b:ProjectRateTypeUid>
                        </com:SkillGroupIdentity>
                        <com:SkillName>HTML</com:SkillName><b:ProjectRateTypeName>Not Chargeable</b:ProjectRateTypeName>
                     </com:SkillIdentity>
                     <com:SkillLevelMask>3</com:SkillLevelMask>
                  </com:PwsSkillCriteria>
               </com:SkillCriteria>
               <com:TitleIdentities>
                  <!--Zero or more repetitions:--<b:BillingAdjustedDiscountPercent i:nil="true"/>
                  <com:PwsTitleRef>
                     <com:DepartmentIdentity>
                        <com:DepartmentName>Technology</com:DepartmentName><b:BillingAdjustedHourlyRate>0</b:BillingAdjustedHourlyRate>
                     </com:DepartmentIdentity>
                     <com:TitleName>Technical Consultant</com:TitleName><b:ContractDiscountPercent i:nil="true"/>
                  </com:PwsTitleRef>
               </com:TitleIdentities><b:ContractHourlyRate>0</b:ContractHourlyRate>
               <com:TitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>Technology</com:DepartmentName><b:SortOrder>2</b:SortOrder>
                  </com:DepartmentIdentity><b:StandardRateTypeIdentity>
                  <com:TitleName>Technical Consultant</com:TitleName><b:StandardRateTypeCode>NC</b:StandardRateTypeCode>
               </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:--<b:StandardRateTypeId i:nil="true"/>
                  <com:PwsProjectRoleRdcException>
                     <com:BeginDate>2018-02-01z</com:BeginDate><b:StandardRateTypeName>Not Chargeable</b:StandardRateTypeName>
                     <com:EndDate>2018-02-08z</com:EndDate>
             <b:StandardRateTypeUid>1152921504606847193</b:StandardRateTypeUid>
       <com:HourlyRate>11</com:HourlyRate>
                     <com:RdcCurrencyIdentity>
                        <com:CurrencyCode>USD</com:CurrencyCode>
                     </com:RdcCurrencyIdentity>
              </b:StandardRateTypeIdentity>
   </com:PwsProjectRoleRdcException>
               </com:RdcExceptions>
            </sch:ProjectRole>b:ProjectRateTypeDetail>