PwsGetSkillList

Owned by Min Zeng
Last updated: Jan 12, 2023 by Luke Wright
21 min read

Overview

This web service retrieves a list of skill summary records (PwsSkillSummaryElement), based on specified search criteria. The following parameters affect the list of skills retrieved:

  • QueryString: Searches within skill group name and skill name. Any skill containing this string in the skill name, or that is part of a skill group whose name contains this string is included.
  • IncludeInactiveFlag: If false, inactive skills are excluded from the results.
  • SkillGroupIdentity: If specified, only skills in the specified skill group are included. Note QueryString and IncludeInactiveFlag are ignored if SkillGroupIdentity is specified.
  • SkillIdentity: If specified, only the specified skill is included. Note QueryString and IncludeInactiveFlag are ignored if SkillIdentity is specified.

If both SkillGroupIdentity and SkillIdentity are specified, the specified skill must belong to the specified skill group, otherwise the request will fail.

Request Format


PwsGetSkillList 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.


IncludeInactiveFlag

Boolean

No

flase

If set to 'true', skills that are set to inactive will be included in the results. Otherwise, only skills that are considered active will be included.

true

MaxRowsToReturn

Int32

No


The maximum number of skills to be retrieved. This value is disregarded if a skill is specified in SkillIdentity.

10

QueryString

String

No


Find all skills matching specified string in skill's name.

Database

SkillGroupIdentity

PwsSkillGroupRef

No


If specified, return all skills in the specified group.


SkillIdentity

PwsSkillRef

No


If specified, return only the specified skill.


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:PwsGetSkillList>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AQztUvxG5aNFjPJheSuItw==</req:SessionTicket>
            <!--Optional:-->
            <req:IncludeInactiveFlag>1</req:IncludeInactiveFlag>
            <!--Optional:-->
            <req:MaxRowsToReturn>50</req:MaxRowsToReturn>
            <req:SkillGroupIdentity>
               <com:SkillGroupName>Vertical Expertise</com:SkillGroupName>
            </req:SkillGroupIdentity>
         </pws:serviceRequest>
      </pws:PwsGetSkillList>
   </soapenv:Body>
</soapenv:Envelope>
Example 02 
<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:PwsGetSkillList>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AQztUvxG5aNFjPJheSuItw==</req:SessionTicket>
            <!--Optional:-->
            <req:IncludeInactiveFlag>1</req:IncludeInactiveFlag>
            <!--Optional:-->
            <req:MaxRowsToReturn>10</req:MaxRowsToReturn>
         </pws:serviceRequest>
      </pws:PwsGetSkillList>
   </soapenv:Body>
</soapenv:Envelope>


Response Format


PwsGetSkillList Response

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.

Skills

PwsSkillSummaryElement[]

This contains the basic set of information about each of the returned skills. 

Response Usage Example(s)


Example 01 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetSkillListResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetSkillListResult 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:49:50.1762787Z</ServerTimestampUtc>
            <a:Skills xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Vertical Expertise</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850401</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>Financial Services</b:SkillName>
                     <b:SkillUid>1152921504606868637</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Vertical Expertise</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850401</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>Government/Military</b:SkillName>
                     <b:SkillUid>1152921504606868638</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Vertical Expertise</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850401</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>High Tech</b:SkillName>
                     <b:SkillUid>1152921504606868639</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Vertical Expertise</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850401</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>Manufacturing</b:SkillName>
                     <b:SkillUid>1152921504606868640</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Vertical Expertise</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850401</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>Retail</b:SkillName>
                     <b:SkillUid>1152921504606868641</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
            </a:Skills>
         </PwsGetSkillListResult>
      </PwsGetSkillListResponse>
   </s:Body>
</s:Envelope>
Example 02 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetSkillListResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetSkillListResult 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 i:nil="true"/>
                  <b:ErrorCode>RowCountExceeded</b:ErrorCode>
                  <b:ErrorNumber>104</b:ErrorNumber>
                  <b:ErrorText>Not all data rows were returned by this request because the specified row count was smaller than the total number of rows available.</b:ErrorText>
                  <b:Type>Warning</b:Type>
                  <b:ReferenceId1 i:nil="true"/>
                  <b:ReferenceId2 i:nil="true"/>
               </b:PwsMessage>
               <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:48:24.8684458Z</ServerTimestampUtc>
            <a:Skills xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>C# Programming</b:SkillName>
                     <b:SkillUid>1152921504606868623</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>Microsoft .NET Design</b:SkillName>
                     <b:SkillUid>1152921504606868632</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>DHTML</b:SkillName>
                     <b:SkillUid>1152921504606868625</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>Flash Programming</b:SkillName>
                     <b:SkillUid>1152921504606868627</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>Database Design</b:SkillName>
                     <b:SkillUid>1152921504606868624</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>Dreamweaver</b:SkillName>
                     <b:SkillUid>1152921504606868626</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>J2EE Design</b:SkillName>
                     <b:SkillUid>1152921504606868629</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <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>Java Programming</b:SkillName>
                     <b:SkillUid>1152921504606868630</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
               <b:PwsSkillSummaryElement>
                  <b:SkillSummary>
                     <b:SkillGroupIdentity>
                        <b:SkillGroupId i:nil="true"/>
                        <b:SkillGroupName>Certification</b:SkillGroupName>
                        <b:SkillGroupUid>1152921504606850615</b:SkillGroupUid>
                     </b:SkillGroupIdentity>
                     <b:SkillId i:nil="true"/>
                     <b:SkillName>MS Network Engineer Certification</b:SkillName>
                     <b:SkillUid>1152921504606870446</b:SkillUid>
                     <b:InactiveFlag>false</b:InactiveFlag>
                  </b:SkillSummary>
               </b:PwsSkillSummaryElement>
            </a:Skills>
         </PwsGetSkillListResult>
      </PwsGetSkillListResponse>
   </s:Body>
</s:Envelope>

Common Errors and Warnings

ErrorNumberErrorCodeErrorText
50024EntityNotFoundSkill Group was not found. Another user may have deleted it.