Overview

Save changes to a role type or create a new role type.

Caller must have permission to update the project in order to add or update role types.

Request Format

PwsSaveRoleType Request

PwsSaveRoleType
- serviceRequest: PwsSaveRoleTypeRq
  - RequestId: Int32
  - SessionTicket: String
  - FullDetailFlag: Boolean
  - RoleType: PwsRoleTypeDetail

Request Elements

Element	Data Type	Required?	Default	Description	Sample Data
RequestId	Int32	No		Click here for more information.	1
SessionTicket	String	Yes		Click here for more information.	AS/RAku1pN9F58A3WQh3aw==
FullDetailFlag	Boolean	No	false	If set to true, include full detailed project estimate element PwsRoleTypeElement in response	true
RoleType	PwsRoleTypeDetail	Yes		This structure contains the complete set of information about a role type

Request Usage Example(s)

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:com1="http://projectorpsa.com/CommonServices/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveRoleType>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AS/RAku1pN9F58A3WQh3aw==</req:SessionTicket>
            <req:FullDetailFlag>true</req:FullDetailFlag>
            <req:RoleType>
               <com:RoleTypeName>Developer</com:RoleTypeName>
               <com:Description>Software Developer (US Based)</com:Description>
               <com:InactiveFlag>false</com:InactiveFlag>
               <com:AllocationFraction>100</com:AllocationFraction>
               <com:BaseRatesOnTitleClearFlag>false</com:BaseRatesOnTitleClearFlag>
               <com:BaseRatesOnTitleIdentity>
                  <com:DepartmentIdentity>
                     <com:DepartmentName>IT Team</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Level 1</com:TitleName>
               </com:BaseRatesOnTitleIdentity>
               <com:CostCenterCriteria>
                  <com1:PwsCostCenterCriteria>
                     <com1:CascadeFlag>true</com1:CascadeFlag>
                     <com1:CostCenterIdentity>
                        <com:CostCenterName>IT Team (USA)</com:CostCenterName>
                     </com1:CostCenterIdentity>
                  </com1:PwsCostCenterCriteria>
               </com:CostCenterCriteria>
               <com:CostCenterCriteriaClearFlag>false</com:CostCenterCriteriaClearFlag>
               <com:CostCenterIdentity>
                  <com:CostCenterName>IT Team (Canada)</com:CostCenterName>
               </com:CostCenterIdentity>
               <com:DescriptionClearFlag>false</com:DescriptionClearFlag>
               <com:Keywords>Developer</com:Keywords>
               <com:KeywordsCriteriaClearFlag>false</com:KeywordsCriteriaClearFlag>
               <com:LocationCriteriaClearFlag>false</com:LocationCriteriaClearFlag>
               <com:LocationIdentities>
                  <com:PwsLocationRef>
                     <com:LocationName>USA - California</com:LocationName>
                  </com:PwsLocationRef>
               </com:LocationIdentities>
               <com:LocationIdentity>
                  <com:LocationName>USA - Illinois</com:LocationName>
               </com:LocationIdentity>
               <com:ResourceTypeClearFlag>false</com:ResourceTypeClearFlag>
               <com:ResourceTypeCriteriaClearFlag>false</com:ResourceTypeCriteriaClearFlag>
               <com:ResourceTypeIdentities>
                  <com:PwsResourceTypeRef>
                       <com:ResourceTypeName>Full Time Employee</com:ResourceTypeName>
                  </com:PwsResourceTypeRef>
               </com:ResourceTypeIdentities>
               <com:ResourceTypeIdentity>
                  <com:ResourceTypeName>Subcontractor</com:ResourceTypeName>
               </com:ResourceTypeIdentity>
               <com:SkillCriteria>
                  <com:PwsSkillCriteria>
                     <com:SkillIdentity>
                        <com:SkillGroupIdentity>
                           <com:SkillGroupName>Languages</com:SkillGroupName>
                        </com:SkillGroupIdentity>
                        <com:SkillName>French</com:SkillName>
                     </com:SkillIdentity>
                     <com:SkillLevelMask>2</com:SkillLevelMask>
                  </com:PwsSkillCriteria>
               </com:SkillCriteria>
               <com:SkillCriteriaClearFlag>false</com:SkillCriteriaClearFlag>
               <com:SortOrder>1</com:SortOrder>
               <com:TitleCriteriaClearFlag>true</com:TitleCriteriaClearFlag>
               <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>Management Team</com:DepartmentName>
                  </com:DepartmentIdentity>
                  <com:TitleName>Level 1</com:TitleName>
               </com:TitleIdentity>
            </req:RoleType>
         </pws:serviceRequest>
      </pws:PwsSaveRoleType>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

PwsSaveRoleType Response

PwsSaveRoleTypeResponse
- PwsSaveRoleTypeResult: PwsSaveRoleTypeRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - RoleType: PwsRoleTypeElement
  - RoleTypeIdentity: PwsRoleTypeRef

Response Elements

Element	Data Type	Description
Messages	PwsMessage[]	The web service response status and message. Click here for more information.
ResponseId	Int32	Click here for more information.	1
Status	RequestStatus	Click here for more information.	Ok
ServerTimestampUtc	DateTime	Click here for more information.	2022-10-21T18:47:16.2378555Z
RoleType	PwsRoleTypeElement	The details of the role type that was fetched.
RoleTypeIdentity	PwsRoleTypeRef	This structure represents the unique key fields associated with identifying a role type.

Response Usage Example(s)

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsSaveRoleTypeResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveRoleTypeResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsMessage>
                  <b:AdditionalErrorText>Message 136: This request was executed against the Staging [appst.projectorpsa.com] environment.</b:AdditionalErrorText>
                  <b:ErrorCode>NonProductionEnvironment</b:ErrorCode>
                  <b:ErrorNumber>136</b:ErrorNumber>
                  <b:ErrorText>This web service request was executed against a non-production instance of Projector.</b:ErrorText>
                  <b:Type>Information</b:Type>
                  <b:ReferenceId1 i:nil="true"/>
                  <b:ReferenceId2 i:nil="true"/>
               </b:PwsMessage>
            </Messages>
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2022-10-21T18:47:16.2378555Z</ServerTimestampUtc>
            <a:RoleType xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:RoleTypeDetail>
                  <b:RoleTypeId i:nil="true"/>
                  <b:RoleTypeName>Developer</b:RoleTypeName>
                  <b:RoleTypeUid>1152921504606848578</b:RoleTypeUid>
                  <b:Description>Software Developer (US Based)</b:Description>
                  <b:InactiveFlag>false</b:InactiveFlag>
                  <b:AllocationFraction>100</b:AllocationFraction>
                  <b:BaseRatesOnTitleClearFlag>false</b:BaseRatesOnTitleClearFlag>
                  <b:BaseRatesOnTitleIdentity>
                     <b:DepartmentIdentity>
                        <b:DepartmentId i:nil="true"/>
                        <b:DepartmentName>IT Team</b:DepartmentName>
                        <b:DepartmentUid>1152921504606854184</b:DepartmentUid>
                     </b:DepartmentIdentity>
                     <b:TitleId i:nil="true"/>
                     <b:TitleName>Level 1</b:TitleName>
                     <b:TitleUid>1152921504606875474</b:TitleUid>
                  </b:BaseRatesOnTitleIdentity>
                  <b:CostCenterCriteria xmlns:c="http://projectorpsa.com/CommonServices/">
                     <c:PwsCostCenterCriteria>
                        <c:CascadeFlag>false</c:CascadeFlag>
                        <c:CostCenterIdentity>
                           <b:CostCenterId i:nil="true"/>
                           <b:CostCenterName>IT Team (Canada)</b:CostCenterName>
                           <b:CostCenterNumber>IT Team (Canada)</b:CostCenterNumber>
                           <b:CostCenterUid>1152921504606867373</b:CostCenterUid>
                        </c:CostCenterIdentity>
                     </c:PwsCostCenterCriteria>
                     <c:PwsCostCenterCriteria>
                        <c:CascadeFlag>true</c:CascadeFlag>
                        <c:CostCenterIdentity>
                           <b:CostCenterId i:nil="true"/>
                           <b:CostCenterName>IT Team (USA)</b:CostCenterName>
                           <b:CostCenterNumber>IT Team (USA)</b:CostCenterNumber>
                           <b:CostCenterUid>1152921504606867365</b:CostCenterUid>
                        </c:CostCenterIdentity>
                     </c:PwsCostCenterCriteria>
                  </b:CostCenterCriteria>
                  <b:CostCenterCriteriaClearFlag>false</b:CostCenterCriteriaClearFlag>
                  <b:CostCenterIdentity>
                     <b:CostCenterId i:nil="true"/>
                     <b:CostCenterName>IT Team (Canada)</b:CostCenterName>
                     <b:CostCenterNumber>IT Team (Canada)</b:CostCenterNumber>
                     <b:CostCenterUid>1152921504606867373</b:CostCenterUid>
                  </b:CostCenterIdentity>
                  <b:DescriptionClearFlag>false</b:DescriptionClearFlag>
                  <b:Keywords>Developer</b:Keywords>
                  <b:KeywordsCriteriaClearFlag>false</b:KeywordsCriteriaClearFlag>
                  <b:LocationCriteriaClearFlag>false</b:LocationCriteriaClearFlag>
                  <b:LocationIdentities>
                     <b:PwsLocationRef>
                        <b:LocationId i:nil="true"/>
                        <b:LocationName>USA - California</b:LocationName>
                        <b:LocationUid>1152921504606863500</b:LocationUid>
                     </b:PwsLocationRef>
                     <b:PwsLocationRef>
                        <b:LocationId i:nil="true"/>
                        <b:LocationName>USA - Illinois</b:LocationName>
                        <b:LocationUid>1152921504606863508</b:LocationUid>
                     </b:PwsLocationRef>
                  </b:LocationIdentities>
                  <b:LocationIdentity>
                     <b:LocationId i:nil="true"/>
                     <b:LocationName>USA - Illinois</b:LocationName>
                     <b:LocationUid>1152921504606863508</b:LocationUid>
                  </b:LocationIdentity>
                  <b:NewRoleTypeName i:nil="true"/>
                  <b:ResourceTypeClearFlag>false</b:ResourceTypeClearFlag>
                  <b:ResourceTypeCriteriaClearFlag>false</b:ResourceTypeCriteriaClearFlag>
                  <b:ResourceTypeIdentities>
                     <b:PwsResourceTypeRef>
                        <b:ResourceTypeCode>FTE</b:ResourceTypeCode>
                        <b:ResourceTypeId i:nil="true"/>
                        <b:ResourceTypeName>Full Time Employee</b:ResourceTypeName>
                        <b:ResourceTypeUid>1152921504606847348</b:ResourceTypeUid>
                     </b:PwsResourceTypeRef>
                     <b:PwsResourceTypeRef>
                        <b:ResourceTypeCode>SC</b:ResourceTypeCode>
                        <b:ResourceTypeId i:nil="true"/>
                        <b:ResourceTypeName>Subcontractor</b:ResourceTypeName>
                        <b:ResourceTypeUid>1152921504606847346</b:ResourceTypeUid>
                     </b:PwsResourceTypeRef>
                  </b:ResourceTypeIdentities>
                  <b:ResourceTypeIdentity>
                     <b:ResourceTypeCode>SC</b:ResourceTypeCode>
                     <b:ResourceTypeId i:nil="true"/>
                     <b:ResourceTypeName>Subcontractor</b:ResourceTypeName>
                     <b:ResourceTypeUid>1152921504606847346</b:ResourceTypeUid>
                  </b:ResourceTypeIdentity>
                  <b:SkillCriteria>
                     <b:PwsSkillCriteria>
                        <b:SkillIdentity>
                           <b:SkillGroupIdentity>
                              <b:SkillGroupId i:nil="true"/>
                              <b:SkillGroupName>Languages</b:SkillGroupName>
                              <b:SkillGroupUid>1152921504606854520</b:SkillGroupUid>
                           </b:SkillGroupIdentity>
                           <b:SkillId i:nil="true"/>
                           <b:SkillName>French</b:SkillName>
                           <b:SkillUid>1152921504606918049</b:SkillUid>
                        </b:SkillIdentity>
                        <b:SkillLevelMask>2</b:SkillLevelMask>
                     </b:PwsSkillCriteria>
                  </b:SkillCriteria>
                  <b:SkillCriteriaClearFlag>false</b:SkillCriteriaClearFlag>
                  <b:SortOrder>1</b:SortOrder>
                  <b:Timestamp>AAAAACA3Iqo=</b:Timestamp>
                  <b:TitleCriteriaClearFlag>false</b:TitleCriteriaClearFlag>
                  <b:TitleIdentities/>
                  <b:TitleIdentity>
                     <b:DepartmentIdentity>
                        <b:DepartmentId i:nil="true"/>
                        <b:DepartmentName>Management Team</b:DepartmentName>
                        <b:DepartmentUid>1152921504606854180</b:DepartmentUid>
                     </b:DepartmentIdentity>
                     <b:TitleId i:nil="true"/>
                     <b:TitleName>Level 1</b:TitleName>
                     <b:TitleUid>1152921504606875470</b:TitleUid>
                  </b:TitleIdentity>
               </b:RoleTypeDetail>
            </a:RoleType>
            <a:RoleTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:RoleTypeId i:nil="true"/>
               <b:RoleTypeName>Developer</b:RoleTypeName>
               <b:RoleTypeUid>1152921504606848578</b:RoleTypeUid>
            </a:RoleTypeIdentity>
         </PwsSaveRoleTypeResult>
      </PwsSaveRoleTypeResponse>
   </s:Body>
</s:Envelope>

PwsSaveRoleType - Common Errors and Warnings

For all errors and warnings please refer to the Complete List of Errors and Warnings