Overview

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

Request Format

PwsSaveSkill Request

PwsSaveSkill
- serviceRequest: PwsSaveSkillRq
  - RequestId: Int32
  - SessionTicket: String
  - FullDetailFlag: Boolean
  - Skill: PwsSkillDetail
  - 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 detail will be included in response.
Skill	PwsSkillDetail	Yes		This structure contains the complete set of information about the skill 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 PwsGetSkill 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:PwsSaveSkill>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AQztUvxG5aNFjPJheSuItw==</req:SessionTicket>
            <req:Skill>
               <!--Optional:-->
               <com:SkillGroupIdentity>
                  <com:SkillGroupName>Technology</com:SkillGroupName>
               </com:SkillGroupIdentity>
               <com:SkillName>HTML</com:SkillName>
               <com:InactiveFlag>0</com:InactiveFlag>
               <!--Optional:-->
               <com:NewSkillName>HTML2</com:NewSkillName>
               <!--Optional:-->
               <com:SortOrder>3</com:SortOrder>
            </req:Skill>
         </pws:serviceRequest>
      </pws:PwsSaveSkill>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

PwsSaveSkill Response

PwsSaveSkillResponse
- PwsSaveSkillResult: PwsSaveSkillRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - Skill: PwsSkillElement
  - SkillIdentity: PwsSkillRef
  - 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.
Skill	PwsSkillElement	This structure contains the complete set of information about the skill that was just created or updated. Included only if FullDetailFlag is set to true in input.
SkillIdentity	PwsSkillRef	This structure represents the unique key fields associated with identifying a resource skill. Identifies the newly created or updated skill.
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
58037	SkillNameAlreadyInUse	Specified skill name "HTML2" already in use.