Versions Compared

Key

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

Overview

 This web service allows users to set the skill sort order of a skill within a skill group by moving a skill . The sort order can be set absolutely, or the skill group can be moved up or down the on in the skill list.

Request Format

Panel
titlePwsSetSkillSortOrder Request
  • PwsSetSkillSortOrder
    • serviceRequest: PwsSetSkillSortOrderRq

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.


SessionTicket

String

Yes


Click here for more information.


Direction

Int16

Either "Direction" OR "SortOrder" must be specified


The direction and slots in which the Role Type should be moved (i.e. +1 = 1 up, -1 = 1 down)If negative, skill is moved up one position; if positive, down one position. Omit to specify sort position absolutely.


SkillIdentity

PwsSkillRef

Yes


This structure represents the unique key fields associated with identifying a resource skill.identifies the skill to be moved,


SkillVersionStamp

Int32

No??????


Version stamp for optimistic locking. Any time a skill or skill group is updated, this version stamp will be changed in the database. The PwsGetSkill service returns this value, and if echoed back here, and it does not match the current version stamp, that indicates that the skill group or skill data has been changed. The request will fail.


SkipInactiveFlag

Boolean

No


If set to "true", the request will skip the inactive skill in a skill group. Applies when using Direction to move the skill up or down.  true

SortOrder

Int16

Either "Direction" OR "SortOrder" must be specified


The order of a skill within a skill group. The base order number is 1. 

3

...

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.

SkillIdentitySkillVersionStamp

PwsSkillRef

This structure represents the unique key fields associated with identifying a resource skillThe new skill version stamp.



Response Usage Example(s)

...