Versions Compared

Version Old Version 2 New Version Current
Changes made by

Min Zeng

Luke Wright

Saved on

Key

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

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


Panel
titlePwsGetSkillList 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

neither SkillGroupIdentity nor SkillIdentity is

specified, return all skills

will be included

in the

response

specified group.

 


SkillIdentity

PwsSkillRef

No

see above


If specified, return only the specified 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: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>

...

Code Block
languagexml
titleExample 02 - with 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: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>

...

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 a skilleach of the returned skills. 


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

...

Code Block
languagexml
titleExample 02 - with location identity
collapsetrue
<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>

...