Versions Compared

Key

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

Overview

This web service retrieves a list of client summary records (PwsClientSummary), based on specified search criteria (PwsClientRef). 

Request Format


Panel
titlePwsGetClientListRq
  • PwsGetClientListRq
    • PwsClientRef
    • IncludeInactiveFlag: Boolean
    • MaxRowsToReturn: Int32
    • QueryString: String
    • LastUpdatedSinceTimestamp: dateTime

Request Elements


ElementData TypeRequired?DefaultDescription
PwsClientRefPwsClientRef [1]no

IncludeInactiveFlagBooleannofalseValid values for this field include "true" or "false". If set to true, inactive clients will be included in the response.
MaxRowsToReturnInt32noinfiniteMaximum number of clients to be returned
QueryStringStringno
Find all clients matching specified string in client name or client number

Usage Example(s)


Code Block
languagexml
titleExample 01 - Client is not specified
collapsetrue
      <PwsGetClientList>
         <serviceRequest>
            <RequestId>1</RequestId>
            <SessionTicket>AcjOqKSXoUYG3qLkrxKQYw==</SessionTicket>
            <ClientIdentity>
               <!--ClientId>?</ClientId-->
               <!--ClientNumber>?</ClientNumber-->
               <!--ClientUid>?</ClientUid-->
            </ClientIdentity>
            <IncludeInactiveFlag>true</IncludeInactiveFlag>
            <!--MaxRowsToReturn>?</MaxRowsToReturn-->
            <!--QueryString>?</QueryString-->
            <!--LastUpdatedSinceTimestamp>?</LastUpdatedSinceTimestamp-->
         </serviceRequest>
      </PwsGetClientList>
Code Block
languagexml
titleExample 02 - Client is specified
collapsetrue
      <PwsGetClientList>
         <serviceRequest>
            <RequestId>1</RequestId>
            <SessionTicket>AcjOqKSXoUYG3qLkrxKQYw==</SessionTicket>
            <ClientIdentity>
               <!--ClientId>?</ClientId-->
               <ClientNumber>Projector PSA</ClientNumber>
               <!--ClientUid>?</ClientUid-->
            </ClientIdentity>
            <IncludeInactiveFlag>true</IncludeInactiveFlag>
            <!--MaxRowsToReturn>?</MaxRowsToReturn-->
            <!--QueryString>?</QueryString-->
            <!--LastUpdatedSinceTimestamp>?</LastUpdatedSinceTimestamp-->
         </serviceRequest>
      </PwsGetClientList>

Response Format


Panel
titlePwsClientRs

Response Elements


ElementData TypeDescription
Common OutputCommon Output Elements
ClientsPwsClientSummaryClient Summary Record(s) retrieved by the service