Overview

This web service inserts or updates a single skill group based on a detailed skill group structure (PwsSkillGroupDetail). The service returns the identity (Pws SkillGroupRef) of the skill gorup that has been inserted or updated. The caller can optionally request that the full skill group detail (P PwsSkillGroupElement) also be included in the response.

Request Format

PwsSaveSkillGroup Request

PwsSaveSkillGroup
- serviceRequest: PwsSaveSkillGroupRq
  - RequestId: Int32
  - SessionTicket: String
  - FullDetailFlag: Boolean
  - SkillGroup: PwsSkillGroupDetail
  - SkillVersionStamp: Int32

Request Elements

Element	Data Type	Required?	Default	Description
RequestId	Int32	No		Click here for more information.
SessionTicket	String	Yes		Click here for more information.
FullDetailFlag	Boolean	No	false	If set to "true", the complete skill group detail will be included in response.
SkillGroup	PwsSkillGroupDetail	Yes		This structure contains the complete set of information about the skill group being created or updated.
SkillVersionStamp	Int32	No		Version stamp for optimistic locking. Any time a skill or skill group is updated, this version stamp will be changed in the database. The PwsGetSkillGroup service returns this value, and if echoed back here, and it does not match the current version stamp, that indicates that the skill group or skill data has been changed. The request will fail.

Request Usage Example(s)

Example 01

<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/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveSkillGroup>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AUQnUBfR4twqQVdcrh4+jA==</req:SessionTicket>
            <req:SkillGroup>
               <com:SkillGroupName>Technology</com:SkillGroupName>
               <com:NewSkillGroupName>Technology2</com:NewSkillGroupName>
               <!--Optional:-->
               <com:SortOrder>2</com:SortOrder>
            </req:SkillGroup>
         </pws:serviceRequest>
      </pws:PwsSaveSkillGroup>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

PwsSaveSkillGroup Response

PwsSaveSkillGroupResponse
- PwsSaveSkillGroupResult: PwsSaveSkillGroupRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - SkillGroup: PwsSkillGroupElement
  - SkillGroupIdentity: PwsSkillGroupRef
  - SkillVersionStamp: Int32

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.
Status	RequestStatus	Click here for more information
ServerTimestampUtc	DateTime	Click here for more information.
SkillGroup	PwsSkillGroupElement	This structure contains the complete set of information about the skill group that was just created or updated. Included only if FullDetailFlag is set to true in input.
SkillGroupIdentity	PwsSkillGroupRef	This structure represents the unique key fields associated with identifying a skill group. Identifies the newly created or updated skill group.
SkillVersionStamp	Int32	The new skill version stamp.

Response Usage Example(s)

Example 01

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsSaveSkillResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveSkillResult 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/">0</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2023-01-10T16:52:20.8069798Z</ServerTimestampUtc>
            <a:Skill i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            <a:SkillIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:SkillGroupIdentity>
                  <b:SkillGroupId i:nil="true"/>
                  <b:SkillGroupName>Technology</b:SkillGroupName>
                  <b:SkillGroupUid>1152921504606850400</b:SkillGroupUid>
               </b:SkillGroupIdentity>
               <b:SkillId i:nil="true"/>
               <b:SkillName>HTML2</b:SkillName>
               <b:SkillUid>1152921504606868628</b:SkillUid>
            </a:SkillIdentity>
            <a:SkillVersionStamp>12</a:SkillVersionStamp>
         </PwsSaveSkillResult>
      </PwsSaveSkillResponse>
   </s:Body>
</s:Envelope>

Common Errors and Warnings

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

ErrorNumber	ErrorCode	ErrorText
58045	SkillGroupNameAlreadyInUse	Specified skill group name "Technology2" already in use.