Versions Compared

Key

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

Overview

Request Format

Panel
titlePwsGetSkillList Request

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

...

Overview

This web service retrieves a list of skill summary records (PwsSkillSummary), based on specified search criteria. The following parameters affect the list of projects 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.

ARNkL4C1bp7KLtsSXQW6/g==

IncludeInactiveFlag

Boolean

No

false


If set to 'true',

both inactive and active locations

skills that are set to inactive will be

returned

included in the

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

results. Otherwise, only skills that are considered active will be included.

MaxRowsToReturn

Int32

No



QueryString

String

No


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

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>

...

Panel
titlePwsGetSkillList Response


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


Response Usage Example(s)

...