Versions Compared

Key

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

...

Panel
titlePwsGetUserList Request
  • PwsGetUserList
    • serviceRequest: PwsGetUserListRq
      • RequestId: Int32
      • SessionTicket: String
      • IncludeInactiveFlag: Boolean
      • LastUpdatedSinceTimestamp: DateTime
      • MaxRowsToReturn: Int32
      • QueryString: String
      • UserIdentity: PwsUserRef

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

Yes 

false 

If set to 'true', inactive users will be included in the results. Otherwise, only active users will be returned. This flag is disregarded if a user is specified in UserIdentity


LastUpdatedSinceTimestamp

DateTime

No

 


If set, only resources that have been updated since this date will be returned. This value is disregarded if a user is specified in UserIdentity


MaxRowsToReturn

Int32

No 

 


The maximum number of users to be retrieved. This value is disregarded if a user is specified in UserIdentity


QueryString

String

No 

 


A search string to narrow down the results. A user will be included in the results if the search string matches the user display name or user reference system id / employee id as well as the other specified criteria. This value is disregarded if a cost center is specified in UserIdentity.


UserIdentity

PwsUserRef

No 

 


The unique keys used to identify a resource to be retrieved


Request Usage Example(s)


Code Block
languagexml
titleExample 01 - without UserIdentity
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:PwsGetUserList>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AaoSuE89vJzjNFnsXZNioA==</req:SessionTicket>
            <req:IncludeInactiveFlag>true</req:IncludeInactiveFlag>
            <req:LastUpdatedSinceTimestamp>2018-10-20</req:LastUpdatedSinceTimestamp>
            <req:MaxRowsToReturn>5</req:MaxRowsToReturn>
         </pws:serviceRequest>
      </pws:PwsGetUserList>
   </soapenv:Body>
</soapenv:Envelope>

...

Panel
titlePwsGetUserList Response

Response Elements


Element

Data Type

Description

Sample Data

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.

Ok  

ServerTimestampUtc

DateTime

Click here for more information.

2018-01-29T19:19:48.2062214Z 
Isers

Users

PwsUserSummaryElement

The user summary records that were fetched by the service


Response Usage Example(s)

...

ErrorNumber

ErrorCode

ErrorText

50024EntityNotFoundEntity PwsUserRef was not found.
50045ViewPermissionDeniedYou do not have permission to view this item.
57813PermissionLimitedToClientUsersUser permission is limited to client users.