Overview
This web service inserts or updates a single skill group based on a detailed skill group structure (PwsSkillDetailPwsSkillGroupDetail). The service returns the identity (PwsSkillRefSkillGroupRef) of the skill gorup that has been inserted or updated. The caller can optionally request that the full skill group detail (PwsSkillElementPwsSkillGroupElement) also be included in the response.
| Info | ||
|---|---|---|
| ||
In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior. |
Request Format
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
Int32 | No | Click here for more information. | |||
String | Yes | Click here for more information. | AUQnUBfR4twqQVdcrh4+jA== | ||
FullDetailFlag | Boolean | No | false | If set to "true", the complete |
skill group detail will be included in response. |
SkillGroup |
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)
| 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:-->PwsSaveSkillGroup>
<pws:serviceRequest>
<req:SessionTicket>AQztUvxG5aNFjPJheSuItwSessionTicket>AUQnUBfR4twqQVdcrh4+jA==</req:SessionTicket>
<req:Skill>
<!--Optional:-->
<com:SkillGroupIdentity>
SkillGroup>
<com:SkillGroupName>Technology</com:SkillGroupName>
</com:SkillGroupIdentity>
<com:SkillName>HTML<NewSkillGroupName>Technology2</com:SkillName>NewSkillGroupName>
<com:InactiveFlag>0<SortOrder>2</com:InactiveFlag>
<!--Optional:-->
<com:NewSkillName>HTML2</com:NewSkillName>
<!--Optional:-->
<com:SortOrder>3</com:SortOrder>
</req:Skill>SkillGroup>
</pws:serviceRequest>
</pws:PwsSaveSkill>PwsSaveSkillGroup>
</soapenv:Body>
</soapenv:Envelope>
|
Response Format
| Panel | ||
|---|---|---|
| ||
|
Response Elements
Element | Data Type | Description | Sample Data |
|---|---|---|---|
Messages | The web service response status and message. Click here for more information | ||
Int32 | Click here for more information. | 0 | |
Status | Click here for more information | Ok | |
DateTime | Click here for more information. |
Skill
| 2023-01-10T16:52:20.8069798Z | ||
SkillGroup | 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 |
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. | 12 |
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> |
PwsSaveSkillGroup - Common Errors and Warnings
- For all errors and warnings please refer to the Complete List of Errors and Warnings
| ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 5803758045 | SkillNameAlreadyInUseSkillGroupNameAlreadyInUse | Specified skill group name "HTML2Technology2" already in use. |