PwsDeleteSkill

Overview

This web service deletes a specified skill (PwsSkillRef). 

Request Format

PwsDeleteSkill Request

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.


InactivateIfInUseFlag

Boolean

No

fals

If set to "true" and the skill is in use, the skill will be inactivated instead of deleted.  If set to "false" and the skill is in use, the delete request will fail. 


SkillIdentity

PwsSkillRef

Yes


This structure represents the unique key fields associated with identifying the skill to be deleted.


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:PwsDeleteSkill>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AQztUvxG5aNFjPJheSuItw==</req:SessionTicket>
            <req:SkillIdentity>
               <!--Optional:-->
               <com:SkillGroupIdentity>
                  <com:SkillGroupName>Technology</com:SkillGroupName>
               </com:SkillGroupIdentity>
               <com:SkillName>NoLongerInUse</com:SkillName>
            </req:SkillIdentity>
         </pws:serviceRequest>
      </pws:PwsDeleteSkill>
   </soapenv:Body>
</soapenv:Envelope>


Response Format

PwsDeleteSkill Response

Response Elements


Element

Data Type

Description

Sample Data

Messages

PwsMessage[]

The web service response status and message. Click here for more information


ResponseId

Int32

Click here for more information.

0

Status

RequestStatusClick here for more informationOk

ServerTimestampUtc

DateTime

Click here for more information.

2018-03-07T18:49:19.6612047Z

SkillIdentity

PwsSkillRef

This structure represents the unique key fields associated with identifying the skill that was deleted.



Response Usage Example(s)


Example - 01
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsDeleteSkillResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsDeleteSkillResult 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-10T15:18:05.3943518Z</ServerTimestampUtc>
            <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>NoLongerInUse</b:SkillName>
               <b:SkillUid>1152921504606955096</b:SkillUid>
            </a:SkillIdentity>
         </PwsDeleteSkillResult>
      </PwsDeleteSkillResponse>
   </s:Body>
</s:Envelope>

Common Errors and Warnings

ErrorNumberErrorCodeErrorText
57675SkillDeletionFailedSkill could not be deleted because it is in use by at least one Resource Skill.