Overview
This web service inserts or updates a single skill based on a detailed skill structure (PwsSkillDetail). The service returns the identity (PwsSkillRef) of the skill that has been inserted or updated. The caller can optionally request that the full skill detail (PwsSkillElement) also be included in the response.
Request Format
| Panel | ||
|---|---|---|
| ||
|
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. | ||
FullDetailFlag | Boolean | No | false | If set to "true", the complete skill detail will be included in response. | |
Skill | 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)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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>
|
...
| Panel | ||
|---|---|---|
| ||
|
Response Elements
Element | Data Type | Description |
|---|
Messages | The web service response status and message. Click here for more information | |
Int32 | Click here for more information. | |
RequestStatus | Click here for more information | |
DateTime | Click here for more information. | |
Skill | 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 | 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)
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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> |
...