Versions Compared

Version Old Version 2 New Version 3
Changes made by

Min Zeng

Min Zeng

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 (PwsSkillSummary), based on specified search criteria. The following parameters affect the list of

...

lists retrieved:

  • QueryString: 
  • IncludeInactiveFlag: 

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, all skills will be included in the response. 


SkillIdentity

PwsSkillRef

No


see above



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


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>

...