Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


This web service retrieves detailed information of about a skill (PwsSkillElement), based upon a unique skill identifiers identifier (PwsSkillRef). 

Request Format

Panel
titlePwsGetSkill 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.


SkillIdentity

PwsSkillRef

Yes


This structure represents the unique key fields associated with identifying a

resource

skill. 


Request Usage Example(s)


Code Block
languagexml
titleExample 01 - without location identity
collapsetrue
<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:PwsGetSkill>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AQztUvxG5aNFjPJheSuItw==</req:SessionTicket>
            <req:SkillIdentity>
               <!--Optional:-->
               <com:SkillGroupIdentity>
                  <com:SkillGroupName>Technology</com:SkillGroupName>
               </com:SkillGroupIdentity>
               <com:SkillName>HTML</com:SkillName>
            </req:SkillIdentity>
         </pws:serviceRequest>
      </pws:PwsGetSkill>
   </soapenv:Body>
</soapenv:Envelope>

...

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 a skill.

SkillVersionStamp

Int32??????

The version stamp for the skill group and skill data stored in Projector. This value is automatically updated each time any skill groups and/or skills are updated, and can be used in conjunction with PwsSaveSkill for optimistic locking.


Response Usage Example(s)

...

Code Block
languagexml
titleExample 01 - without location identity
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetSkillResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetSkillResult 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-10T14:28:04.1044726Z</ServerTimestampUtc>
            <a:Skill xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:SkillDetail>
                  <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>HTML</b:SkillName>
                  <b:SkillUid>1152921504606868628</b:SkillUid>
                  <b:InactiveFlag>false</b:InactiveFlag>
                  <b:NewSkillName i:nil="true"/>
                  <b:SortOrder>7</b:SortOrder>
               </b:SkillDetail>
            </a:Skill>
            <a:SkillVersionStamp>4</a:SkillVersionStamp>
         </PwsGetSkillResult>
      </PwsGetSkillResponse>
   </s:Body>
</s:Envelope>

...