Overview

This web service inserts or updates a single project role based on a detailed project role structure (PwsProjectRoleDetail). The service returns the identity (PwsProjectRoleRef) of the project role that has been inserted or updated.

Request Format

Panel

title	PwsSaveProjectRole Request

PwsSaveProjectRole
- serviceRequest: PwsSaveProjectRoleRq
  - RequestId: Int32
  - SessionTicket: String
  - BaseRatesOnTitleClearFlag: Boolean
  - CandidatesClearFlag: Boolean
  - CostCenterClearFlag: Boolean
  - CostCenterCriteriaClearFlag: Boolean
  - DescriptionClearFlag: Boolean
  - EngagementTimestamp: String
  - KeywordsClearFlag: Boolean
  - LocationClearFlag: Boolean
  - LocationCriteriaClearFlag: Boolean
  - Mode: String (1)
  - ProjectIdentity: PwsProjectRef
  - ProjectRole: PwsProjectRoleDetail
  - ResourceClearFlag: Boolean
  - RoleEndDateClearFlag: Boolean
  - RoleStartDateClearFlag: Boolean
  - ShareCostCenterClearFlag: Boolean
  - SkillCriteriaClearFlag: Boolean
  - StealLockFlag: Boolean
  - TitleClearFlag: Boolean
  - TitleCriteriaClearFlag: Boolean
  - RdcTransferHourlyRateClearFlag: Boolean
  - RevenueTransferHourlyRateClearFlag: Boolean
  - RateExceptionsClearFlag: Boolean
  - RdcExceptionsClearFlag: Boolean
  - WarnOnPermissionErrorFlag: Boolean

Request Elements

...

Element

...

Data Type

...

Required?

...

Default

...

Description

...

Sample Data

...

RequestId

...

Int32

...

No

...

Click here for more information.

...

SessionTicket

...

String

...

Yes

...

Click here for more information.

...

Ae9v30fDNwFMx833f5Hesg==

...

BaseRatesOnTitleClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

false

...

CandidatesClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

false

...

CostCenterClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', preferred cost center for unnamed candidate is cleared (preferred cost center identity defined in PwsProjectRoleDetail is ignored).

...

false

...

CostCenterCriteriaClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', cost center criteria for unnamed candidate is cleared (cost center criteria defined in PwsProjectRoleDetail is ignored).

...

false

...

DescriptionClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', the existing description will be cleared.

...

false

...

EngagementTimestamp

...

String

...

No

...

This is a Base64 encoded timestamp utilized for engagement locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned by PwsGetProject or a prior call to PwsSaveProjectRole. This will cause the request to fail if any change has been made between invocations of PwsGetProject and PwsSaveProjectRole.

...

KeywordsClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', existing keywords for unnamed candidate is cleared.

...

false

...

LocationClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', preferred location for unnamed candidate is cleared. Please note, if System Settings' Scheduling is set to "Show Location Criteria", then this flag cannot be set to 'true' because location criteria is required.

...

false

...

LocationCriteriaClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', location criteria for unnamed candidate is cleared and location criteria (LocationIdentities) defined in PwsProjectRoleDetail is ignored; If set to 'false', location criteria (LocationIdentities) will be updated if provided in PwsProjectRoleDetail.

...

false

...

Mode

...

String (1)

...

On Insert: Yes

On Update: Yes

...

Determine whether specified criteria applies to booked or requested criteria settings.

A: booked data for roles

R: requested data for roles

...

A

...

ProjectIdentity

...

PwsProjectRef

...

On Insert: Yes

On Update: Yes

...

The identity of the project that contains the project role. Click here for more information.

...

ProjectRole

...

PwsProjectRoleDetail

...

On Insert: Yes

On Update: Yes

...

Structure that contains the complete information of the project role. Please click here for more information.. If it refers to an existing project role, this request updates this project role; otherwise, this request creates a new project role.

...

ResourceClearFlag

...

Boolean

...

On Insert: No

On Update: No

...

false

...

If set to 'true', existing named resource is cleared.

...

false

...

Overview

This web service inserts or updates a single project role based on a detailed project role structure (PwsProjectRoleDetail). The service returns the identity (PwsProjectRoleRef) of the project role that has been inserted or updated.

Request Format

Panel

title	PwsSaveProjectRole Request

PwsSaveProjectRole
- serviceRequest: PwsSaveProjectRoleRq
  - RequestId: Int32
  - SessionTicket: String
  - BaseRatesOnTitleClearFlag: Boolean
  - CandidatesClearFlag: Boolean
  - CostCenterClearFlag: Boolean
  - CostCenterCriteriaClearFlag: Boolean
  - DescriptionClearFlag: Boolean
  - EngagementTimestamp: String **deprecated**
  - InitialAllocation: PwsProjectRoleHoursPattern
  - KeywordsClearFlag: Boolean
  - LocationClearFlag: Boolean
  - LocationCriteriaClearFlag: Boolean
  - Mode: String (1)
  - ProjectIdentity: PwsProjectRef
  - ProjectRole: PwsProjectRoleDetail
  - ResourceClearFlag: Boolean
  - RoleEndDateClearFlag: Boolean
  - RoleStartDateClearFlag: Boolean
  - ShareCostCenterClearFlag: Boolean
  - SkillCriteriaClearFlag: Boolean
  - StealLockFlag: Boolean **deprecated**
  - TitleClearFlag: Boolean
  - TitleCriteriaClearFlag: Boolean
  - RdcTransferHourlyRateClearFlag: Boolean
  - RevenueTransferHourlyRateClearFlag: Boolean
  - RateExceptionsClearFlag: Boolean
  - RdcExceptionsClearFlag: Boolean
  - ResourceTypeCriteriaClearFlag: Boolean
  - FullDetailFlag: Boolean
  - LocksToSteal: PwsEntityLockSummary[1.100]
  - MakeRoleNameUniqueFlag: Boolean
  - NameRoleFlag: Boolean
  - ProjectorLockSetId: Int32
  - ResourceTypeClearFlag: Boolean
  - ShareUserClearFlag: Boolean
  - WarnOnPermissionErrorFlag: Boolean
  - ExcludeReadNotesFlag: Boolean
  - PurchaseOrderNumberClearFlag: Boolean
  - ReplaceAllocatedCriteriaWithRequestedFlag: Boolean
  - RetrievalMode: String
  - RevalueAction: String
  - RoleTypeClearFlag: Boolean

Request Elements

WarnOnPermissionErrorFlag request will result in warnings instead of errors if user has no permission (on insert only):

- Attempt to set sharing (by user or cost center) without permission to share scheduling.
- Attempt to set billing title override without permission to maintain rates
- Attempt to set revenue transfer hourly rate without permission to maintain rates
- Attempt to set RDC transfer hourly rate without permission to maintain rates
- Attempt to set rate or RDC exceptions without permission to maintain rates

Element	Data Type	Required?	Default	Description	Sample Data
RequestId	Int32	No		Click here for more information.
SessionTicket	String	Yes		Click here for more information.	Ae9v30fDNwFMx833f5Hesg==
BaseRatesOnTitleClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', existing role end date is clearedbase-rate-on-title setting will be cleared (rates will be based on resource's title).	false
RoleStartDateClearFlagCandidatesClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', existing role start date is clearednamed candidates will be cleared (candidate identities defined inPwsProjectRoleDetail are ignored).	false
ShareCostCenterClearFlagCostCenterClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', role's shared preferred cost center for unnamed candidate is cleared (preferred cost center identity defined in PwsProjectRoleDetail is ignored).	false
SkillCriteriaClearFlagCostCenterCriteriaClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', skill cost center criteria for unnamed candidate is cleared (skill cost center criteria defined in PwsProjectRoleDetail is ignored).	false
StealLockFlagDescriptionClearFlag	Boolean	On Insert: No On Update: No	false	True to steal lock if it is currently locked (otherwise, service will fail if engagement is locked).	false	TitleClearFlagIf set to 'true', the existing description will be cleared.	false
EngagementTimestamp	String	deprecated
InitialAllocation	PwsProjectRoleHoursPattern	On Insert: No On Update: No		The allocation set up for the project role upon creation.
KeywordsClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', preferred title existing keywords for unnamed candidate is cleared.	false
TitleCriteriaClearFlagLocationClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', title criteria preferred location for unnamed candidate is cleared (title criteria (TitleIdentities) defined in PwsProjectRoleDetail is ignored). Please note, if System Settings' Scheduling is set to "Show Location Criteria", then this flag cannot be set to 'true' because location criteria is required.	false
RdcTransferHourlyRateClearFlagLocationCriteriaClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', RDC transfer hourly rate location criteria for unnamed candidate is cleared and location criteria (RdcTransferHourlyRate LocationIdentities) defined in PwsProjectRoleDetail is ignored; If set to 'false', location criteria (LocationIdentities) will be updated if provided in PwsProjectRoleDetail.	false	RevenueTransferHourlyRateClearFlag
BooleanMode	String (1)	On Insert: NoYes On Update: No	false	If set to 'true', revenue transfer hourly rate is cleared (RevenueTransferHourlyRate defined in PwsProjectRoleDetail is ignored).	false	RateExceptionsClearFlag	BooleanYes	Determine whether specified criteria applies to booked or requested criteria settings. A: booked data for roles R: requested data for roles	A
ProjectIdentity	PwsProjectRef	On Insert: NoYes On Update: No	false	If set to 'true', overriding rate is cleared (RateExceptions defined in PwsProjectRoleDetail is ignored).	false	RdcExceptionsClearFlag	Yes	The identity of the project that contains the project role. Click here for more information.
ProjectRole	PwsProjectRoleDetail	On Insert: Yes On Update: Yes		Structure that contains the complete information of the project role. Please click here for more information.. If it refers to an existing project role, this request updates this project role; otherwise, this request creates a new project role.
ResourceClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', overriding RDC rate is cleared (RdcExceptions defined in PwsProjectRoleDetail is ignored)existing named resource is cleared.	false
RoleEndDateClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', existing role end date is cleared.	false
RoleStartDateClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true',	false

Request Usage Example(s)

...

language	xml
title	Example 01 - create/update
collapse	true

...

existing role start date is cleared.	false
ShareCostCenterClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', role's shared cost center is cleared.	false
SkillCriteriaClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', skill criteria for unnamed candidate is cleared (skill criteria defined in PwsProjectRoleDetail is ignored).	false
StealLockFlag	Boolean	deprecated
TitleClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', preferred title for unnamed candidate is cleared.	false
TitleCriteriaClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', title criteria for unnamed candidate is cleared (title criteria (TitleIdentities) defined in PwsProjectRoleDetail is ignored).	false
RdcTransferHourlyRateClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', RDC transfer hourly rate is cleared (RdcTransferHourlyRate defined in PwsProjectRoleDetail is ignored).	false
RevenueTransferHourlyRateClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', revenue transfer hourly rate is cleared (RevenueTransferHourlyRate defined in PwsProjectRoleDetail is ignored).	false
RateExceptionsClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', overriding rate is cleared (RateExceptions defined in PwsProjectRoleDetail is ignored).	false
RdcExceptionsClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', overriding RDC rate is cleared (RdcExceptions defined in PwsProjectRoleDetail is ignored).	false
ResourceTypeCriteriaClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', the resource type criteria will be cleared. Note this will not clear the preferred or allocated resource type. Empty resource type criteria means that any resource type is acceptable.
FullDetailFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', the complete project role element structure will be included in the response.
LocksToSteal	PwsEntityLockSummary[1.100]	On Insert: No On Update: No		The detailed information of the locks that are to be stolen. If not specified, the request will fail if any requested locks are already held. If specified, the information supplied must exactly match the current state of existing locks or the attempt to steal the existing locks will fail. Typically, this service is invoked with LocksToSteal empty or null. If there are existing locks, they will be returned in the LockHolders member of PwsFault. This data can then be sent, as is, back to the server in a second invocation of this service, as LocksToSteal, if the caller desires to steal the locks.
MakeRoleNameUniqueFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', and the specified role name is already in use, the service will append a number onto the end of the role name in order to make it unique. Otherwise, the service will fail if the specified role name is in use.
NameRoleFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', and no role name is specified, the service will use the resource display name to generate a role name if the role has assigned resource. Either role name or resource has to be specified. If set to 'false' (the default value), then a role name must be supplied.
ProjectorLockSetId	Int32	On Insert: No On Update: No		A projector lock set id is an identifier for a group of one or more locks held as a unit.
ResourceTypeClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', the preferred or allocated resource type is cleared.
ShareUserClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', the shared to user is cleared for the role.
WarnOnPermissionErrorFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', request will result in warnings instead of errors if user has no permission (on insert only): - Attempt to set sharing (by user or cost center) without permission to share scheduling. - Attempt to set billing title override without permission to maintain rates - Attempt to set revenue transfer hourly rate without permission to maintain rates - Attempt to set RDC transfer hourly rate without permission to maintain rates - Attempt to set rate or RDC exceptions without permission to maintain rates	false
ExcludeReadNotesFlag	Boolean	On Insert: No On Update: No	false	If true, notes that have been marked as read by the current user are excluded from the data returned. Applies only when FullDetailFlag is true.
PurchaseOrderNumberClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true', the purchase order number for the role is cleared.
ReplaceAllocatedCriteriaWithRequestedFlag	Boolean	On Insert: No On Update: No	false	When in scheduling mode (Mode = 'A') and updating an existing role that has incomplete booked criteria, if this flag is set, any existing booked criteria is overwritten with requested criteria. Note any criteria values specified in this request will overwrite what is copied from the requested criteria.
RetrievalMode	String	On Insert: No On Update: No		Required if FullDetailFlag is set, Designate whether assigned (A), requested (R) or effective (E) criteria is returned for the role.
RevalueAction	String	On Insert: No On Update: No	N	This indicates how the service should respond if there are time cards that would become in need of revalue as a result of the changes. The valid values are: N (No Revalue): Time cards are left as is and the save is completed. R (Revalue): Time cards that can be revalued are revalued and the save is completed. C (Check): The save operation will only proceed if there are no time cards that would be in need of revalue. RevalueReport in the response will provide details about the affected time cards.
RoleTypeClearFlag	Boolean	On Insert: No On Update: No	false	If set to 'true' the role type for the role will be cleared.

Request Usage Example(s)

Code Block

language	xml
title	Example 01 - create/update
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProjectRole>
         <pws:serviceRequest>
            <req:SessionTicket>Ae9v30fDNwFMx833f5Hesg==</req:SessionTicket>
            <sch:CandidatesClearFlag>true</sch:CandidatesClearFlag>
            <sch:CostCenterCriteriaClearFlag>true</sch:CostCenterCriteriaClearFlag>
            <sch:LocationCriteriaClearFlag>true</sch:LocationCriteriaClearFlag>
            <sch:Mode>A</sch:Mode>
            <sch:ProjectIdentity>
               <com:ProjectCode>P001053-WS2</com:ProjectCode>
            </sch:ProjectIdentity>
            <sch:ProjectRole>
               <com:ExternalSystemIdentifier>Role 001</com:ExternalSystemIdentifier>
               <com:BaseRateOnTitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>Management</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Administrator</com:TitleName>
               </com:BaseRateOnTitleIdentity>
               <com:CandidateIdentities>
                  <com:PwsResourceRef>
                     <com:ResourceDisplayName>Max Yang</com:ResourceDisplayName>
                  </com:PwsResourceRef>
               </com:CandidateIdentities>
               <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>
               <com:CostCenterCriteria>
                  <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 #2</com:Description>
               <com:Keywords>Executive</com:Keywords>
               <com:LocationAnyFlag>true</com:LocationAnyFlag>
               <com:LocationIdentities>
                  <com:PwsLocationRef>
                     <com:LocationName>Boston</com:LocationName>
                  </com:PwsLocationRef>
               </com:LocationIdentities>
               <com:LocationIdentity>
                  <com:LocationName>Shanghai</com:LocationName>
               </com:LocationIdentity>
               <com:ResourceIdentity>
                  <com:ResourceDisplayName>Oscar Cox</com:ResourceDisplayName>
               </com:ResourceIdentity>
               <com:RoleName>Role WS-001</com:RoleName>
               <com:RoleStartDate>2018-01-01z</com:RoleStartDate>
               <com:ShareCostCenterIdentity>
               </com:ShareCostCenterIdentity>
               <com:SkillCriteria>
                  <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>
                  <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:RdcTransferCurrencyIdentity>
               <com:RevenueTransferHourlyRate>12</com:RevenueTransferHourlyRate>
            </sch:ProjectRole>
            <sch:ShareCostCenterClearFlag>true</sch:ShareCostCenterClearFlag>
            <sch:SkillCriteriaClearFlag>true</sch:SkillCriteriaClearFlag>
            <sch:StealLockFlag>true</sch:StealLockFlag>
            <sch:TitleCriteriaClearFlag>true</sch:TitleCriteriaClearFlag>
            <sch:RdcTransferHourlyRateClearFlag>false</sch:RdcTransferHourlyRateClearFlag>
            <sch:RevenueTransferHourlyRateClearFlag>true</sch:RevenueTransferHourlyRateClearFlag>
         </pws:serviceRequest>
      </pws:PwsSaveProjectRole>
   </soapenv:Body>
</soapenv:Envelope>

Code Block

language	xml
title	Example 02
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProjectRole>
         <pws:serviceRequest>
            <req:SessionTicket>Af6PogAbIuL3jTtirBShRg==</req:SessionTicket>
            <sch:Mode>R</sch:Mode>
            <sch:ProjectIdentity>
               <com:ProjectCode>P001508-001</com:ProjectCode>
            </sch:ProjectIdentity>
            <sch:ProjectRole>
               <com:BaseRateOnTitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>IT Team</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Level 1</com:TitleName>
               </com:BaseRateOnTitleIdentity>
               <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>
               <com:CostCenterCriteria>
                  <com1:PwsCostCenterCriteria>
                     <com1:CascadeFlag>false</com1:CascadeFlag>
                     <com1:CostCenterIdentity>
                        <com:CostCenterName>IT Team (USA)</com:CostCenterName>
                     </com1:CostCenterIdentity>
                  </com1:PwsCostCenterCriteria>
               </com:CostCenterCriteria>
               <com:CostCenterIdentity>
                  <com:CostCenterNumber>IT Team (USA)</com:CostCenterNumber>
               </com:CostCenterIdentity>
               <com:LocationAnyFlag>false</com:LocationAnyFlag>
               <com:LocationIdentities>
                  <com:PwsLocationRef>
                     <com:LocationName>USA</com:LocationName>
                  </com:PwsLocationRef>
               </com:LocationIdentities>
               <com:LocationIdentity>
                  <com:LocationName>USA</com:LocationName>
               </com:LocationIdentity>
               <com:RoleName>Consultant</com:RoleName>
               <com:TitleIdentities>
                  <com:PwsTitleRef>
                     <com:DepartmentIdentity>
                        <com:DepartmentName>IT Team</com:DepartmentName>
                     </com:DepartmentIdentity>
                     <com:TitleName>Level 1</com:TitleName>
                  </com:PwsTitleRef>
               </com:TitleIdentities>
               <com:TitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>IT Team</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Level 1</com:TitleName>
               </com:TitleIdentity>
               <com:ResourceTypeAnyFlag>true</com:ResourceTypeAnyFlag>
            </sch:ProjectRole>
         </pws:serviceRequest>
      </pws:PwsSaveProjectRole>
   </soapenv:Body>
</soapenv:Envelope>

Code Block

language	xml
title	Example 03 with Initial Allocation
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProjectRole>
         <pws:serviceRequest>
            <req:SessionTicket>AaGStCnFFiJ1l+XNAlIgag==</req:SessionTicket>
            <!--sch:BaseRatesOnTitleClearFlag>false</sch:BaseRatesOnTitleClearFlag-->
            <sch:CandidatesClearFlag>true</sch:CandidatesClearFlag>
            <sch:CostCenterClearFlag>false</sch:CostCenterClearFlag>
            <sch:CostCenterCriteriaClearFlag>true</sch:CostCenterCriteriaClearFlag>
            <sch:DescriptionClearFlag>false</sch:DescriptionClearFlag>
            <sch:InitialAllocation>
               <!--Optional:-->
               <com:HoursAllocationPercentage>0.6</com:HoursAllocationPercentage>
               <!--Optional:-->
               <com:HoursBucketCount>5</com:HoursBucketCount>
               <!--Optional:-->
               <com:HoursSchedulingMode>W</com:HoursSchedulingMode>
               <!--Optional:-->
               <com:HoursStartDate>2019-02-01z</com:HoursStartDate>
               <!--Optional:-->
               <com:ConstraintType>N</com:ConstraintType>
               <!--Optional:-->
               <!--com:MinutesPerBucket>500</com:MinutesPerBucket-->
            </sch:InitialAllocation>            
            <sch:KeywordsClearFlag>false</sch:KeywordsClearFlag>
            <sch:LocationClearFlag>false</sch:LocationClearFlag>
            <sch:LocationCriteriaClearFlag>true</sch:LocationCriteriaClearFlag>
            <sch:Mode>A</sch:Mode>
            <sch:ProjectIdentity>
               <com:ProjectCode>P001053-WS2</com:ProjectCode>
            </sch:ProjectIdentity>
            <sch:ProjectRole>
                <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: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:ResourceIdentity>
                  <!--Optional:-->
                  <com:ResourceDisplayName>Larry Krakauer</com:ResourceDisplayName>
               </com:ResourceIdentity>
               <com:RoleEndDate>2019-12-31z</com:RoleEndDate>
               <com:RoleName>Role #2</com:RoleName>
               <com:RoleStartDate>2019-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>2019-02-01z</com:BeginDate>
                     <com:EndDate>2019-02-08z</com:EndDate>
                     <com:HourlyRate>11</com:HourlyRate>
                     <com:RdcCurrencyIdentity>
                        <com:CurrencyCode>USD</com:CurrencyCode>
                     </com:RdcCurrencyIdentity>
                  <req:SessionTicket>Ae9v30fDNwFMx833f5Hesg==</req:SessionTicket>com:PwsProjectRoleRdcException>
               <sch:CandidatesClearFlag>true<</schcom:CandidatesClearFlag>RdcExceptions>
            <sch:CostCenterCriteriaClearFlag>true<</sch:CostCenterCriteriaClearFlag>ProjectRole>
            <sch:LocationCriteriaClearFlag>true<ResourceClearFlag>false</sch:LocationCriteriaClearFlag>ResourceClearFlag>
            <sch:Mode>A<RoleEndDateClearFlag>true</sch:Mode>RoleEndDateClearFlag>
            <sch:ProjectIdentity>RoleStartDateClearFlag>true</sch:RoleStartDateClearFlag>
               <com:ProjectCode>P001053-WS2</com:ProjectCode><sch:ShareCostCenterClearFlag>true</sch:ShareCostCenterClearFlag>
            <<sch:SkillCriteriaClearFlag>true</sch:ProjectIdentity>SkillCriteriaClearFlag>
            <sch:ProjectRole>TitleClearFlag>true</sch:TitleClearFlag>
            <sch:TitleCriteriaClearFlag>true</sch:TitleCriteriaClearFlag>
  <com:ExternalSystemIdentifier>Role 001</com:ExternalSystemIdentifier>         <sch:RdcTransferHourlyRateClearFlag>true</sch:RdcTransferHourlyRateClearFlag>
      <com:BaseRateOnTitleIdentity>      <sch:RevenueTransferHourlyRateClearFlag>true</sch:RevenueTransferHourlyRateClearFlag>
            <com:DepartmentIdentity><sch:RateExceptionsClearFlag>true</sch:RateExceptionsClearFlag>
            <sch:RdcExceptionsClearFlag>true</sch:RdcExceptionsClearFlag>
        <com:DepartmentName>Management</com:DepartmentName> </pws:serviceRequest>
      </pws:PwsSaveProjectRole>
   </soapenv:Body>
       </com:DepartmentIdentity>
                  <com:TitleName>Administrator</com:TitleName>
               </com:BaseRateOnTitleIdentity>
               <com:CandidateIdentities>
                  <com:PwsResourceRef>
                     <com:ResourceDisplayName>Max Yang</com:ResourceDisplayName>
   </soapenv:Envelope>

Code Block

language	xml
title	Example 04 with unassigned/unnamed resource
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProjectRole>
       </com:PwsResourceRef>   <pws:serviceRequest>
            <req:SessionTicket>AatU6Z3wNjEL/nIADBLl4w==</comreq:CandidateIdentities>SessionTicket>
               <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag><!--sch:BaseRatesOnTitleClearFlag>false</sch:BaseRatesOnTitleClearFlag-->
               <com:CostCenterCriteria><sch:CandidatesClearFlag>true</sch:CandidatesClearFlag>
            <sch:CostCenterClearFlag>false</sch:CostCenterClearFlag>
     <com1:PwsCostCenterCriteria>       <sch:CostCenterCriteriaClearFlag>true</sch:CostCenterCriteriaClearFlag>
              <com1<sch:CascadeFlag>true<DescriptionClearFlag>false</com1sch:CascadeFlag>DescriptionClearFlag>
            <sch:InitialAllocation>
        <com1:CostCenterIdentity>         <!--Optional:-->
               <com:CostCenterName>RevCorp CH<HoursAllocationPercentage>0.6</com:CostCenterName>HoursAllocationPercentage>
               <!--Optional:-->
            </com1:CostCenterIdentity>   <com:HoursBucketCount>5</com:HoursBucketCount>
               </com1:PwsCostCenterCriteria>!--Optional:-->
               <<com:HoursSchedulingMode>W</com:CostCenterCriteria>HoursSchedulingMode>
               <com:CostCenterIdentity>
  <!--Optional:-->
               <com:CostCenterName>RevCorp CA<HoursStartDate>2019-02-01z</com:CostCenterName>HoursStartDate>
               </com:CostCenterIdentity>!--Optional:-->
               <com:DefaultSchedulingMode>W<ConstraintType>N</com:DefaultSchedulingMode>ConstraintType>
               <com:Description>Created from PwsSaveProjectRole #2</com:Description><!--Optional:-->
                  <com:Keywords>Executive<<!--com:MinutesPerBucket>500</com:Keywords>MinutesPerBucket-->
            </sch:InitialAllocation>   <com:LocationAnyFlag>true</com:LocationAnyFlag>         
      <com:LocationIdentities>      <sch:KeywordsClearFlag>false</sch:KeywordsClearFlag>
            <com:PwsLocationRef><sch:LocationClearFlag>false</sch:LocationClearFlag>
            <sch:LocationCriteriaClearFlag>true</sch:LocationCriteriaClearFlag>
        <com:LocationName>Boston</com:LocationName>    <sch:Mode>A</sch:Mode>
              </com:PwsLocationRef><sch:ProjectIdentity>
               <<com:ProjectCode>P001053-WS2</com:LocationIdentities>ProjectCode>
               <com:LocationIdentity></sch:ProjectIdentity>
            <sch:ProjectRole>
     <com:LocationName>Shanghai</com:LocationName>             <com:BaseRateOnTitleIdentity>
  </com:LocationIdentity>                 <com:ResourceIdentity>DepartmentIdentity>
                     <com:ResourceDisplayName>Oscar Cox<DepartmentName>Management</com:ResourceDisplayName>DepartmentName>
                  </com:ResourceIdentity>DepartmentIdentity>
                  <com:RoleName>Role WS-001<TitleName>Administrator</com:RoleName>TitleName>
               <com:RoleStartDate>2018-01-01z<</com:RoleStartDate>BaseRateOnTitleIdentity>
               <com:ShareCostCenterIdentity>CandidateIdentities>
               </com:ShareCostCenterIdentity>   <!--Zero or            <com:SkillCriteria>more repetitions:-->
                  <com:PwsSkillCriteria>PwsResourceRef>
                     <com:SkillIdentity>ResourceDisplayName>Max Yang</com:ResourceDisplayName>
                  </com:PwsResourceRef>
    <com:SkillGroupIdentity>           </com:CandidateIdentities>
                <com:SkillGroupName>Technology<CostCenterAnyFlag>false</com:SkillGroupName>:CostCenterAnyFlag>
               <com:CostCenterCriteria>
              </com:SkillGroupIdentity>    <!--Zero or more repetitions:-->
                  <com:SkillName>HTML</com:SkillName><com1:PwsCostCenterCriteria>
                     <<com1:CascadeFlag>true</comcom1:SkillIdentity>CascadeFlag>
                     <com:SkillLevelMask>3</com:SkillLevelMask><com1:CostCenterIdentity>
                   </com:PwsSkillCriteria>     <com:CostCenterName>RevCorp CH</com:CostCenterName>
         </com:SkillCriteria>            </com1:CostCenterIdentity>
   <com:TitleIdentities>               </com1:PwsCostCenterCriteria>
   <com:PwsTitleRef>            </com:CostCenterCriteria>
         <com:DepartmentIdentity>      <com:CostCenterIdentity>
                  <com:DepartmentName>Technology<CostCenterName>RevCorp CA</com:DepartmentName>
     CostCenterName>
               </com:DepartmentIdentity>CostCenterIdentity>
                     <com:TitleName>Technical Consultant<DefaultSchedulingMode>W</com:TitleName>DefaultSchedulingMode>
               <com:Description>Created from PwsSaveProjectRole <1</com:PwsTitleRef>Description>
               <<com:Keywords>Executive</com:TitleIdentities>Keywords>
               <com:TitleIdentity>LocationIdentities>
                  <com:DepartmentIdentity>
  <!--Zero or more repetitions:-->
                  <com:DepartmentName>Technology</com:DepartmentName>PwsLocationRef>
                     <<com:LocationName>Boston</com:DepartmentIdentity>LocationName>
                  <com:TitleName>Technical Consultant<</com:TitleName>PwsLocationRef>
               </com:TitleIdentity>LocationIdentities>
 			 <com:LocationIdentity>
                  <com:RdcTransferCurrencyIdentity>LocationName>Shanghai</com:LocationName>
               </com:RdcTransferCurrencyIdentity>LocationIdentity>
                <com:ResourceIdentity>
     <com:RevenueTransferHourlyRate>12</com:RevenueTransferHourlyRate>             </sch:ProjectRole>!--Optional:-->
                  <sch:ShareCostCenterClearFlag>true</sch:ShareCostCenterClearFlag><!--com:ResourceDisplayName>Larry Krakauer</com:ResourceDisplayName-->
               <sch:SkillCriteriaClearFlag>true<</sch:SkillCriteriaClearFlag>com:ResourceIdentity>
               <sch:StealLockFlag>true</sch:StealLockFlag><com:RoleEndDate>2019-12-31z</com:RoleEndDate>
               <sch<com:TitleCriteriaClearFlag>true<RoleName>Role #3</sch:TitleCriteriaClearFlag>com:RoleName>
               <sch:RdcTransferHourlyRateClearFlag>false</sch:RdcTransferHourlyRateClearFlag>
    <com:RoleStartDate>2019-01-01z</com:RoleStartDate>
       <sch:RevenueTransferHourlyRateClearFlag>true</sch:RevenueTransferHourlyRateClearFlag>        <com:ShareCostCenterIdentity>
 </pws:serviceRequest>       </pws:PwsSaveProjectRole>    </soapenv:Body> </soapenv:Envelope>

Code Block

language	xml
title	Example 02
collapse	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>   <com:CostCenterName>RevCorp CH</com:CostCenterName>
               </com:ShareCostCenterIdentity>
               <com:SkillCriteria>
                  <!--Zero or more repetitions:-->
                  <com:PwsSkillCriteria>
                     <com:SkillIdentity>
                        <pws:PwsSaveProjectRole><com:SkillGroupIdentity>
                      <pws:serviceRequest>     <com:SkillGroupName>Technology</com:SkillGroupName>
       <req:SessionTicket>Af6PogAbIuL3jTtirBShRg==</req:SessionTicket>             <sch:Mode>R</sch:Mode>    </com:SkillGroupIdentity>
        <sch:ProjectIdentity>                <com:ProjectCode>P001508-001<SkillName>HTML</com:ProjectCode>SkillName>
              </sch:ProjectIdentity>       </com:SkillIdentity>
     <sch:ProjectRole>                <com:BaseRateOnTitleIdentity>SkillLevelMask>3</com:SkillLevelMask>
                  <com</com:DepartmentIdentity>PwsSkillCriteria>
               </com:SkillCriteria>
       <com:DepartmentName>IT Team</com:DepartmentName>        <com:TitleIdentities>
            </com:DepartmentIdentity>      <!--Zero or more repetitions:-->
         <com:TitleName>Level 1</com:TitleName>        <com:PwsTitleRef>
       </com:BaseRateOnTitleIdentity>                <com:CostCenterAnyFlag>false</com:CostCenterAnyFlag>DepartmentIdentity>
               <com:CostCenterCriteria>         <com:DepartmentName>Technology</com:DepartmentName>
         <com1:PwsCostCenterCriteria>             </com:DepartmentIdentity>
        <com1:CascadeFlag>false</com1:CascadeFlag>             <com:TitleName>Technical Consultant</com:TitleName>
       <com1:CostCenterIdentity>           </com:PwsTitleRef>
             <com:CostCenterName>IT Team (USA)</com:CostCenterName>TitleIdentities>
               <com:TitleIdentity>
     </com1:CostCenterIdentity>             <com:DepartmentIdentity>
     </com1:PwsCostCenterCriteria>                <<com:DepartmentName>Technology</com:CostCenterCriteria>DepartmentName>
                  <com</com:CostCenterIdentity>DepartmentIdentity>
                  <com:CostCenterNumber>IT Team (USA)<TitleName>Technical Consultant</com:CostCenterNumber>TitleName>
               </com:CostCenterIdentity>TitleIdentity>
               <com:LocationAnyFlag>false</com:LocationAnyFlag>RdcTransferCurrencyIdentity>
                  <com:LocationIdentities><!--com:CurrencyCode>USD</com:CurrencyCode-->
               </com:RdcTransferCurrencyIdentity>
         <com:PwsLocationRef>      <!--com:RdcTransferHourlyRate>7</com:RdcTransferHourlyRate-->
               <com:LocationName>USA<RevenueTransferHourlyRate>14</com:LocationName>RevenueTransferHourlyRate>
               <com:RdcExceptions>
    </com:PwsLocationRef>              <!--Zero or more repetitions:-->
  </com:LocationIdentities>                <com:LocationIdentity>PwsProjectRoleRdcException>
                     <com:LocationName>USA<BeginDate>2019-02-01z</com:LocationName>BeginDate>
                     <<com:EndDate>2019-02-08z</com:LocationIdentity>EndDate>
                     <com:RoleName>Consultant<HourlyRate>11</com:RoleName>
HourlyRate>
              <com:TitleIdentities>       <com:RdcCurrencyIdentity>
           <com:PwsTitleRef>             <com:CurrencyCode>USD</com:CurrencyCode>
        <com:DepartmentIdentity>             </com:RdcCurrencyIdentity>
           <com:DepartmentName>IT Team</com:DepartmentName>      </com:PwsProjectRoleRdcException>
               </com:DepartmentIdentity>RdcExceptions>
            </sch:ProjectRole>
         <com:TitleName>Level 1</com:TitleName>   <sch:ResourceClearFlag>false</sch:ResourceClearFlag>
            <sch:RoleEndDateClearFlag>true</sch:RoleEndDateClearFlag>
     </com:PwsTitleRef>       <sch:RoleStartDateClearFlag>true</sch:RoleStartDateClearFlag>
        </com:TitleIdentities>    <sch:ShareCostCenterClearFlag>true</sch:ShareCostCenterClearFlag>
           <com:TitleIdentity> <sch:SkillCriteriaClearFlag>true</sch:SkillCriteriaClearFlag>
             <sch:TitleClearFlag>false</sch:TitleClearFlag>
    <com:DepartmentIdentity>         <sch:TitleCriteriaClearFlag>true</sch:TitleCriteriaClearFlag>
            <com<sch:DepartmentName>IT Team<RdcTransferHourlyRateClearFlag>true</comsch:DepartmentName>RdcTransferHourlyRateClearFlag>
            <sch:RevenueTransferHourlyRateClearFlag>true</sch:RevenueTransferHourlyRateClearFlag>
     </com:DepartmentIdentity>       <sch:RateExceptionsClearFlag>true</sch:RateExceptionsClearFlag>
           <com:TitleName>Level 1</com:TitleName>
  <sch:RdcExceptionsClearFlag>true</sch:RdcExceptionsClearFlag>
             </com:TitleIdentity><sch:NameRoleFlag>false</sch:NameRoleFlag>
               <com:ResourceTypeAnyFlag>true</com:ResourceTypeAnyFlag></pws:serviceRequest>
      </pws:PwsSaveProjectRole>
   </soapenv:Body>
 </sch:ProjectRole>
         </pws:serviceRequest>
      </pws:PwsSaveProjectRole>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

Panel

title	PwsSaveProjectRole Response

PwsSaveProjectRoleResponse
- PwsSaveProjectRoleResult: PwsSaveProjectRoleRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - ProjectRoleIdentity: PwsProjectRoleRef
  - EngagementTimestamp: String
  - LockStolenFromUserIdentity: PwsUserRef

Response Elements

...

Element

...

Data Type

...

Description

...

Sample Data

...

Messages

...

The web service response status and message. Click here for more information.

...

ResponseId

...

Int32

...

Click here for more information.

...

0

...

Status

...

RequestStatus

...

Click here for more information.

...

Ok

...

ServerTimestampUtc

...

DateTime

...

Click here for more information.

...

2018-02-14T15:34:53.8497124Z

...

ProjectRoleIdentity

...

PwsProjectRoleRef

...

The identity of the project role just created/updated. Click here for more information.

...

EngagementTimestamp

...

String

...

This is a Base64 encoded timestamp utilized for engagement locking. See Request Elements above for more details.

...

AAAAAA+d7G0=

...

LockStolenFromUserIdentity

...

PwsUserRef

...

</soapenv:Envelope>

Response Format

Panel

title	PwsSaveProjectRole Response

PwsSaveProjectRoleResponse
- PwsSaveProjectRoleResult: PwsSaveProjectRoleRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - ProjectRoleIdentity: PwsProjectRoleRef
  - EngagementTimestamp: String **deprecated**
  - LockStolenFromUserIdentity: PwsUserRef **deprecated**
  - ProjectRole:
  - ProjectRoleTimestamp: String
  - StolenLocks: PwsEntityLockSummary
  - ResourcePartiallyInactiveFlag: Boolean
  - RevalueReport: PwsRevalueReport
  - TotalApprovedOrFinalizedMinutes: Double
  - TotalRequestedOrScheduledMinutes: Double

Response Elements

Element	Data Type	Description	Sample Data
Messages	PwsMessage[]	The web service response status and message. Click here for more information.
ResponseId	Int32	Click here for more information.	0
Status	RequestStatus	Click here for more information.	Ok
ServerTimestampUtc	DateTime	Click here for more information.	2018-02-14T15:34:53.8497124Z
ProjectRoleIdentity	PwsProjectRoleRef	The identity of the project role just created/updated. Click here for more information.
EngagementTimestamp	String	deprecated
LockStolenFromUserIdentity	PwsUserRef	deprecated
ProjectRole	PwsProjectRoleElement	The full element structure for the role that was saved. This will be populated only if FullDetailFlag is set to 'true' in the request.
ProjectRoleTimestamp	String	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.
StolenLocks	PwsEntityLockSummary	This structure contains information about the locks that were stolen in order to complete this request, Will be included only when LocksToSteal is specified in the request.
ResourcePartiallyInactiveFlag	Boolean	If an initial allocation is specified in the input, this will be true if the role is a named role, and the resource was inactive for at least one day during the period of time over which there are requested or booked minutes.
RevalueReport	PwsRevalueReport	Information about time cards on the project role that were affected by the change. Populated only when RevalueAction is R (Revalue) or C (Check). If RevalueAction is R, the values included in this structure reflect what was done. If RevalueAction is C, the values reflect what would be done if the service were invoked again with RevalueAction set to R.
TotalRequestedOrScheduledMinutes	Double	If an initial allocation is specified in the input, this will be the total number of minutes that were requested or booked (depending on Mode) for the role.

Response Usage Example(s)

...

ErrorNumber	ErrorCode	ErrorText
14009	RoleResourceMayNotBeSpecifiedWhenClearFlagSet	Resource may not be specified when resouce clear flag is set.
14010	RoleCostCenterMayNotBeSpecifiedWhenClearFlagSet	Cost center may not be specified when cost center clear flag is set.
14011	RoleLocationMayNotBeSpecifiedWhenClearFlagSet	Location may not be specified when location clear flag is set.
14012	RoleTitleMayNotBeSpecifiedWhenClearFlagSet	Title may not be specified when title clear flag is set.
14013	RoleKeywordsMayNotBeSpecifiedWhenClearFlagSet	Keywords may not be specified when keywords clear flag is set.
14014	ShareCostCenterMayNotBeSpecifiedWhenClearFlagSet	Share cost center may not be specified when share cost center clear flag is set.
14015	BaseRatesOnTitleMayNotBeSpecifiedWhenClearFlagSet	Base rates on title may not be specified when base rates on title clear flag is set.
14016	RoleStartDateMayNotBeSpecifiedWhenClearFlagSet	Role start date may not be specified when role start date clear flag is set.
14017	RoleEndDateMayNotBeSpecifiedWhenClearFlagSet	Role end date may not be specified when role end date clear flag is set.
14018	RoleDescriptionMayNotBeSpecifiedWhenClearFlagSet	Role description may not be set when role description clear flag is set.
14025	RdcTransferRateIncomplete	RDC transfer hourly rate specified without RDC transfer currency, or vice versa.
50021	RefStructureMismatch	Resource (PwsResourceRef) contains mismatched elements.
50024	EntityNotFound	Entity PwsProjectRef was not found.
54199	RdcTransferDataIncomplete	RDC transfer hourly rate specified without RDC transfer currency, or vice versa.
54204	NoPermissionToChangeRdcTransferRate	You do not have permission to change the RDC transfer rate.
54583	InvalidValueForMode	The value specified for mode is invalid. Valid values are R for Request, A for Allocate and E for Effective (for retrieval operations only).
54733	NoPermissionToCreateBookedRole	You do not have appropriate permission to create this booked role.
54738	ShareCostCenterInactive	The specified share cost center is inactive.
54740	InvalidResourceOrCriteriaOnInsert	Either a resource or a valid set of criteria are required to create a role.
54741	RoleNameNotSpecified	Role name is required for new roles.
54743	RoleNameAlreadyInUse	Specified role name is already in use.
54750	CannotUpdateDeletedProjectRole	This project role is deleted and cannot be updated.
54753	CannotMoveRoleToDifferentProject	Existing roles may not be moved to a different project.
54776	MissingPreferredAllocatedCostCenter	Missing preferred or allocated cost center.
54777	MissingPreferredAllocatedLocation	Missing preferred or allocated location.
54875	MissingValueForCostCenterOrLocationAnyFlags	Resource type, cost center and location any flags are required for new roles.
55003	NoPermissionToChangeRatesOrRdcExceptions	You do not have permission to change rates or RDC exceptions.
55227	ShareInfoIgnoredNoPermission	WARNING: You do not have permission to share scheduling. Specified share information was ignored
55228	TitleOverideIgnoredNoPermission	WARNING: You do not have permission to set billing title override. Specified override was ignored
55229	RevenueTransferRateIgnoredNoPermission	WARNING: You do not have permission to set revenue transfer hourly rate. Specified rate was ignored
55230	RdcTransferRateIgnoredNoPermission	WARNING: You do not have permission to set RDC transfer hourly rate. Specified rate was ignored
57535	TitleNotFound	The specified title does not exist.

...

Version	Old Version 53	New Version Current
Changes made by	Bettina Borces	Luke Wright
Saved on	Nov 12, 2018	Oct 11, 2019

Page Comparison

Versions Compared

Key

Overview

Request Format

Request Elements

Request Format

Request Elements

Request Usage Example(s)

Request Usage Example(s)

Response Format

Response Elements

Response Format

Response Elements

Response Usage Example(s)