OverviewOverview

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

title	PwsGetSkillList Request

PwsGetSkillList
- serviceRequest: PwsGetSkillListRq
  - RequestId: Int32
  - SessionTicket: String
  - IncludeInactiveFlag: BooleanMaxRowsToReturn: Int32
  - QueryString: String
  - SkillGroupIdentity: PwsSkillGroupRef
  - SkillIdentity: PwsSkillRef

Request Elements

...

Element

...

Data Type

...

Required?

...

Default

...

Description

...

RequestId

...

Int32

...

No

...

Click here for more information.

...

SessionTicket

...

String

...

Yes

...

Click here for more information.

...

IncludeInactiveFlag

- - Boolean
  - MaxRowsToReturn

...

- - : Int32
  - QueryString

...

- - : String
  - SkillGroupIdentity

...

- - : PwsSkillGroupRef
  - SkillIdentity: PwsSkillRef

...

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.

ARNkL4C1bp7KLtsSXQW6/g==


IncludeInactiveFlag	Boolean	No

false

flase

If set to 'true',

both inactive and active locations

skills that are set to inactive will be

returned

included in the

response

results. Otherwise, only

active locations are returned. Locations explicitly marked inactive, as well as locations that are not active for the specified list type (see ListType parameter) are considered to be inactive.

false

ListType

String (1)

Yes

The type of locations to retrieve:

C: enabled for cost

T: enabled for time

T

LocationIdentity

PwsLocationRef

No

A set of unique key fields of a location. Specify a value here to retrieve a specific location. Click here for more information.

MaximumRows

Int32

No

If not set, the complete list of locations that fit the search criteria will be returned in the response.

10

SearchString

String (255)

No

A search string to narrow down the results. A location will be included in the results if the search string matches the location name

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)

Code Block

language	xml
title	Example 01 - without location identity
collapse	true

<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

language	xml
title	Example 02 - with location identity
collapse	true

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

...

Panel

title	PwsGetSkillList Response

PwsGetSkillListResponse
- PwsGetSkillListResult: PwsGetSkillListRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - Skills: PwsSkillSummaryElement[]

Response Elements

Element	Data Type

Required?

Default

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)

...

Code Block

language	xml
title	Example 01 - without location identity
collapse	true

<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

language	xml
title	Example 02 - with location identity
collapse	true

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

...

Version	Old Version 1	New Version Current
Changes made by	Min Zeng	Luke Wright
Saved on	Jan 11, 2023	Jan 12, 2023

Versions Compared

Key

OverviewOverview

Request Format

Request Elements

Request Elements

Request Usage Example(s)

Response Elements

Page Comparison

Versions Compared

Key

Request Format

Request Elements

Request Elements

Request Usage Example(s)

Response Elements