Versions Compared

Old Version 24

changes.mady.by.user Luke Wright

Saved on

compared with

New Version Current

changes.mady.by.user Erich Belzer

Saved on

Key

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

Overview

This structure is part of PwsProjectRoleElement, and 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.

...

Panel
titlePwsProjectRoleDetail

Elements

...

Element

...

Data Type

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 [1...100]

PwsResourceRef [1...100]

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 [1...100]

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 [1...100]

PwsLocationRef [1...100]

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 [1...100]

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 [1...100]

PwsTitleRef [1...100]

On Insert: No

On Update: No


A collection of Titles 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 [1...100]

PwsUserDefinedFieldDetail [1...100]

On Insert: No

On Update: No


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


RateExceptions [1...100]

PwsProjectRoleRateException [1...100]

On Insert: No

On Update: No


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


RdcExceptions [1...100]

PwsProjectRoleRDCException [1...100]

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)

...

languagexml
titleExample 01
collapsetrue

...


ResourceTypeAnyFlagBoolean

On Insert: No

On Update: No

falseIf set to 'true', all resource types are selected as part of the unnamed candidate search criteria.true
ResourceTypeIdentitiesPwsResourceTypeRef [1...100]

On Insert: No

On Update: No


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

On Insert: No

On Update: No


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

On Insert: No

On Update: No


The user that shares the scheduling responsibility of this project role. Click here for more information.
TimestampString

On Insert: No

On Update: No


This is an optimistic locking timestamp that, if provided on update request, will cause the request to fail when the timestamp stored in the database does not match the provided value.
AAAAABFEKj4=
RoleTypeIdentityPwsRoleTypeRef

On Insert: No

On Update: No


The role type of the project role. Click here for more information.

Usage Example(s)


Code Block
languagexml
titleExample 01 - unnamed
collapsetrue
                         <b:ProjectRoleDetail>
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectRoleId i:nil="true"/>
                           <b:ProjectRoleUid>1152921504609687954</b:ProjectRoleUid>
                           <b:BaseRateOnTitleIdentity i:nil="true"/>
                           <b:CandidateIdentities/>
                           <b:CostCenterAnyFlag>false</b:CostCenterAnyFlag>
                           <b:CostCenterCriteria xmlns:c="http://projectorpsa.com/CommonServices/">
                              <c:PwsCostCenterCriteria>
                                 <c:CascadeFlag>true</c:CascadeFlag>
                                 <c:CostCenterIdentity>
                                    <b:CostCenterId i:nil="true"/>
                                    <b:CostCenterName>US-Public Sector*</b:CostCenterName>
                                    <b:CostCenterNumber>US1</b:CostCenterNumber>
                                    <b:CostCenterUid>1152921504606856645</b:CostCenterUid>
                                 </c:CostCenterIdentity>
                              </c:PwsCostCenterCriteria>
                           </b:CostCenterCriteria>
                           <b:CostCenterIdentity>
                              <b:CostCenterId i:nil="true"/>
                              <b:CostCenterName>US-Public Sector*</b:CostCenterName>
                              <b:CostCenterNumber>US1</b:CostCenterNumber>
                              <b:CostCenterUid>1152921504606856645</b:CostCenterUid>
                           </b:CostCenterIdentity>
                           <b:DefaultSchedulingMode>W</b:DefaultSchedulingMode>
                           <b:Description i:nil="true"/>
                           <b:Keywords i:nil="true"/>
                           <b:LocationAnyFlag>true</b:LocationAnyFlag>
                           <b:LocationIdentities/>
                           <b:LocationIdentity>
                              <b:LocationId i:nil="true"/>
                              <b:LocationName>Boston</b:LocationName>
                              <b:LocationUid>1152921504606852816</b:LocationUid>
                           </b:LocationIdentity>
                           <b:NewExternalSystemIdentifier i:nil="true"/>
                           <b:ResourceIdentity i:nil="true"/>
                           <b:RoleEndDate i:nil="true"/>
                           <b:RoleName>Project Manager</b:RoleName>
                           <b:RoleStartDate i:nil="true"/>
                           <b:ShareCostCenterIdentity i:nil="true"/>
                           <b:SkillCriteria/>
                           <b:TitleIdentities>
                              <b:PwsTitleRef>
                                 <b:DepartmentIdentity>
                                    <b:DepartmentId i:nil="true"/>
                                    <b:DepartmentName>Technology</b:DepartmentName>
                                    <b:DepartmentUid>1152921504606851320</b:DepartmentUid>
                                 </b:DepartmentIdentity>
                                 <b:TitleId i:nil="true"/>
                                 <b:TitleName>Principal Technical Consultant</b:TitleName>
                                 <b:TitleUid>1152921504606862841</b:TitleUid>
                              </b:PwsTitleRef>
                              <b:PwsTitleRef>
                                 <b:DepartmentIdentity>
                                    <b:DepartmentId i:nil="true"/>
                                    <b:DepartmentName>Technology</b:DepartmentName>
                                    <b:DepartmentUid>1152921504606851320</b:DepartmentUid>
                                 </b:DepartmentIdentity>
                                 <b:TitleId i:nil="true"/>
                                 <b:TitleName>Senior Technical Consultant</b:TitleName>
                                 <b:TitleUid>1152921504606862842</b:TitleUid>
                              </b:PwsTitleRef>
                           </b:TitleIdentities>
                           <b:TitleIdentity>
                              <b:DepartmentIdentity>
                                 <b:DepartmentId i:nil="true"/>
                                 <b:DepartmentName>Technology</b:DepartmentName>
                                 <b:DepartmentUid>1152921504606851320</b:DepartmentUid>
                              </b:DepartmentIdentity>
                              <b:TitleId i:nil="true"/>
                              <b:TitleName>Principal Technical Consultant</b:TitleName>
                              <b:TitleUid>1152921504606862841</b:TitleUid>
                           </b:TitleIdentity>
                           <b:RdcTransferCurrencyIdentity i:nil="true"/>
                           <b:RdcTransferHourlyRate i:nil="true"/>
                           <b:RevenueTransferHourlyRate i:nil="true"/>
                           <b:UserDefinedFields>
                              <b:PwsUserDefinedFieldDetail>
                                 <b:UdfId i:nil="true"/>
                                 <b:UdfName>RUDF_Tlst_3vals</b:UdfName>
                                 <b:UdfUid>1152921504606857067</b:UdfUid>
                                 <b:BooleanValue i:nil="true"/>
                                 <b:DataType>L</b:DataType>
                                 <b:DateValue i:nil="true"/>
                                 <b:IntegerValue i:nil="true"/>
                                 <b:ResourceIdentityValue i:nil="true"/>
                                 <b:TextValue>c. Hycinth (inactive)</b:TextValue>
                                 <b:UdfTreatment>A</b:UdfTreatment>
                                 <b:StoplightValues/>
                                 <b:NumericValue i:nil="true"/>
                                 <b:RelationValue i:nil="true"/>
                              </b:PwsUserDefinedFieldDetail>
                           </b:UserDefinedFields>
                           <b:RateExceptions/>
                           <b:RdcExceptions/>
                           <b:InheritPurchaseOrderNumberFlag>true</b:InheritPurchaseOrderNumberFlag>
                           <b:PurchaseOrderNumber i:nil="true"/>
                           <b:ResourceTypeAnyFlag>false</b:ResourceTypeAnyFlag>
                           <b:ResourceTypeIdentities>
                              <b:PwsResourceTypeRef>
                                 <b:ResourceTypeCode>Sal</b:ResourceTypeCode>
                                 <b:ResourceTypeId i:nil="true"/>
                                 <b:ResourceTypeName>Salaried</b:ResourceTypeName>
                                 <b:ResourceTypeUid>1152921504606847077</b:ResourceTypeUid>
                              </b:PwsResourceTypeRef>
                              <b:PwsResourceTypeRef>
                                 <b:ResourceTypeCode>Sal with OT</b:ResourceTypeCode>
                                 <b:ResourceTypeId i:nil="true"/>
                                 <b:ResourceTypeName>Salaried with Overtime</b:ResourceTypeName>
                                 <b:ResourceTypeUid>1152921504606847078</b:ResourceTypeUid>
                              </b:PwsResourceTypeRef>
                           </b:ResourceTypeIdentities>
                           <b:ResourceTypeIdentity>
                              <b:ResourceTypeCode>Sal</b:ResourceTypeCode>
                              <b:ResourceTypeId i:nil="true"/>
                              <b:ResourceTypeName>Salaried</b:ResourceTypeName>
              <sch:ProjectRole>                <com<b:ExternalSystemIdentifier>R-001<ResourceTypeUid>1152921504606847077</com:ExternalSystemIdentifier>b:ResourceTypeUid>
                           <!--com:ProjectRoleUid>?</com:ProjectRoleUid-->/b:ResourceTypeIdentity>
                           <b:ShareUserIdentity>
                      <com:BaseRateOnTitleIdentity>        <b:UserDisplayName>Chris Evans</b:UserDisplayName>
         <com:DepartmentIdentity>                     <b:UserId <com:DepartmentName>Management</com:DepartmentName>i:nil="true"/>
                   </com:DepartmentIdentity>           <b:UserReferenceSystemId>008</b:UserReferenceSystemId>
       <com:TitleName>Administrator</com:TitleName>                </com:BaseRateOnTitleIdentity>       <b:UserUid>1152921504606944233</b:UserUid>
        <com:CandidateIdentities>                   <!--Zero or more repetitions:-->/b:ShareUserIdentity>
                     <com:PwsResourceRef>      <b:Timestamp>AAAAABFEKj4=</b:Timestamp>
               <com:ResourceDisplayName>Max Yang</com:ResourceDisplayName>        </b:ProjectRoleDetail>


Code Block
languagexml
titleExample 02 - named
collapsetrue
          </com:PwsResourceRef>                </com:CandidateIdentities><b:ProjectRoleDetail>
                   <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>        <b:ExternalSystemIdentifier i:nil="true"/>
      <com:CostCenterCriteria>                   <!--Zero or more<b:ProjectRoleId repetitions:--i:nil="true"/>
                  <com1:PwsCostCenterCriteria>               <b:ProjectRoleUid>1152921504609687526</b:ProjectRoleUid>
      <com1:CascadeFlag>true</com1:CascadeFlag>                     <b:BaseRateOnTitleIdentity <com1:CostCenterIdentity>i:nil="true"/>
                        <com:CostCenterName>RevCorp CH</com:CostCenterName>  <b:CandidateIdentities>
                   </com1:CostCenterIdentity>           <b:PwsResourceRef>
       </com1:PwsCostCenterCriteria>                </com:CostCenterCriteria>          <b:ResourceDisplayName>Barry Allen</b:ResourceDisplayName>
    <com:CostCenterIdentity>                   <com:CostCenterName>RevCorp CA</com:CostCenterName>         <b:ResourceId i:nil="true"/>
     </com:CostCenterIdentity>                <com:DefaultSchedulingMode>W</com:DefaultSchedulingMode>            <b:ResourceReferenceSystemId>barry1</b:ResourceReferenceSystemId>
   <com:Description>Created from PwsSaveProjectRole 1</com:Description>                <com:Keywords>Executive</com:Keywords>          	  <com<b:LocationAnyFlag>true<ResourceUid>1152921504607019493</comb:LocationAnyFlag>ResourceUid>
                 <com:LocationIdentities>             </b:PwsResourceRef>
     <!--Zero or more repetitions:-->                   <com:PwsLocationRef></b:CandidateIdentities>
                           <com<b:LocationName>Boston<CostCenterAnyFlag>false</comb:LocationName>CostCenterAnyFlag>
                   </com:PwsLocationRef>        <b:CostCenterCriteria xmlns:c="http://projectorpsa.com/CommonServices/"/>
       </com:LocationIdentities>  			 <com:LocationIdentity>                  <b:CostCenterIdentity <com:LocationName>Shanghai</com:LocationName>i:nil="true"/>
               </com:LocationIdentity>                <com:RoleEndDate>2018-12-31z</com:RoleEndDate>
<b:DefaultSchedulingMode>W</b:DefaultSchedulingMode>
              <com:RoleName>Role-I</com:RoleName>                <com:RoleStartDate>2018-01-01z</com:RoleStartDate>      <b:Description i:nil="true"/>
        <com:ShareCostCenterIdentity>                   <com<b:CostCenterName>Revcorp CH</com:CostCenterName>Keywords i:nil="true"/>
                 </com:ShareCostCenterIdentity>          <b:LocationAnyFlag>false</b:LocationAnyFlag>
     <com:SkillCriteria>                   <!--Zero or more repetitions<b:--LocationIdentities/>
                  <com:PwsSkillCriteria>           <b:LocationIdentity i:nil="true"/>
          <com:SkillIdentity>                 <b:NewExternalSystemIdentifier i:nil="true"/>
      <com:SkillGroupIdentity>                     <b:ResourceIdentity>
      <com:SkillGroupName>Technology</com:SkillGroupName>                        <b:ResourceDisplayName>Barry <Allen</comb:SkillGroupIdentity>
 ResourceDisplayName>
                      <com:SkillName>HTML</com:SkillName>        <b:ResourceId i:nil="true"/>
            </com:SkillIdentity>                  <b:ResourceReferenceSystemId>barry1</b:ResourceReferenceSystemId>
   <com:SkillLevelMask>3</com:SkillLevelMask>                   </com:PwsSkillCriteria>         <b:ResourceUid>1152921504607019493</b:ResourceUid>
      </com:SkillCriteria>                <com:TitleIdentities>     </b:ResourceIdentity>
             <!--Zero or more repetitions:-->           <b:RoleEndDate i:nil="true"/>
      <com:PwsTitleRef>                      <com:DepartmentIdentity><b:RoleName>Barry Allen</b:RoleName>
                        <com:DepartmentName>Technology</com:DepartmentName>   <b:RoleStartDate i:nil="true"/>
                 </com:DepartmentIdentity>          <b:ShareCostCenterIdentity i:nil="true"/>
          <com:TitleName>Technical Consultant</com:TitleName>                   </com:PwsTitleRef>
 <b:SkillCriteria/>
             </com:TitleIdentities>                <com<b:TitleIdentity>TitleIdentities/>
                  <com:DepartmentIdentity>         <b:TitleIdentity i:nil="true"/>
           <com:DepartmentName>Technology</com:DepartmentName>                   </com<b:DepartmentIdentity>
RdcTransferCurrencyIdentity i:nil="true"/>
                 <com:TitleName>Technical Consultant</com:TitleName>         <b:RdcTransferHourlyRate i:nil="true"/>
     </com:TitleIdentity>                <com:RdcTransferCurrencyIdentity>      <b:RevenueTransferHourlyRate i:nil="true"/>
           <com:CurrencyCode>USD</com:CurrencyCode>                </com:RdcTransferCurrencyIdentity><b:UserDefinedFields/>
                 <com:RdcTransferHourlyRate>7</com:RdcTransferHourlyRate>          <b:RateExceptions/>
     <com:RevenueTransferHourlyRate>14</com:RevenueTransferHourlyRate>                <com:RdcExceptions>      <b:RdcExceptions/>
            <!--Zero or more repetitions:-->            <b:InheritPurchaseOrderNumberFlag>true</b:InheritPurchaseOrderNumberFlag>
      <com:PwsProjectRoleRdcException>                     <b:PurchaseOrderNumber <com:BeginDate>2018-02-01z</com:BeginDate>i:nil="true"/>
                           <com:EndDate>2018-02-08z</com:EndDate><b:ResourceTypeAnyFlag>false</b:ResourceTypeAnyFlag>
                     <com:HourlyRate>11</com:HourlyRate>      <b:ResourceTypeIdentities/>
               <com:RdcCurrencyIdentity>            <b:ResourceTypeIdentity i:nil="true"/>
           <com:CurrencyCode>USD</com:CurrencyCode>                <b:ShareUserIdentity i:nil="true"/>
    </com:RdcCurrencyIdentity>                   </com:PwsProjectRoleRdcException>    <b:Timestamp>AAAAABE+Ank=</b:Timestamp>
           </com:RdcExceptions>             </schb:ProjectRole>ProjectRoleDetail>