Versions Compared

Key

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

...

Panel
titlePwsGetClientList Request
  • PwsGetClientListRq
    • RequestId: Int32
    • SessionTicket: String (50)
    • ClientIdentity: PwsClientRef
    • IncludeInactiveFlag: Boolean
    • MaxRowsToReturn: Int32
    • QueryString: String (50)
    • LastUpdatedSinceTimestamp: DateTime


Request Elements


ElementData TypeRequired?DefaultDescriptionSample Data
RequestIdInt32No
Click here for more information.1
SessionTicketString (50)Yes
Click here for more information.
AcjOqKSXoUYG3qLkrxKQYw==
ClientIdentityPwsClientRefNo
For this service, the caller may specify up to 1 client identity. If a client identity is not specified all clients fitting the criteria will be returned.
IncludeInactiveFlagBooleanNofalseValid values for this field include "true" or "false". If set to true, inactive clients will be included in the response.true/false
MaxRowsToReturnInt32NoinfiniteMaximum number of clients to be returned.100
QueryStringString (50)No
Find all clients matching specified string in client name or client number.Acme
LastUpdatedSinceTimestampDateTimeNo
Only clients that have been updated on or after the specified date/time will be retrieved.
2017-12-27

Request Usage Example(s)


Code Block
languagexml
titleExample 01 - Client is not specified
collapsetrue
      <PwsGetClientList>
         <serviceRequest>
            <RequestId>1</RequestId>
            <SessionTicket>AcjOqKSXoUYG3qLkrxKQYw==</SessionTicket>
            <IncludeInactiveFlag>true</IncludeInactiveFlag>
            <MaxRowsToReturn>100</MaxRowsToReturn>
         </serviceRequest>
      </PwsGetClientList>

...

ElementData TypeDescriptionSample Data
MessagesPwsMessageThe web service response status and Message.Click here for more information
ResponseIdInt32Click here for more information.2
StatusStringClick here for more infomration.Ok
ServerTimestampUtcDateTimeClick here for more informaton
2017-12-27T18:23:22.3881313Z
ClientsPwsClientSummaryClient Summary Record(s) retrieved by the service.

Response Usage Example(s)

...

Code Block
languagexml
titleExample 01
collapsetrue
      <PwsGetClientListResponse>
         <PwsGetClientListResult>
            <Messages>
               <PwsMessage>
                  <AdditionalErrorText i:nil="true"/>
                  <ErrorCode <Messages i:nil="true"/>
                  <ErrorNumber i:nil="true"/>
                  <ErrorText i:nil="true"/>
                  <Type i:nil="true"/>
                  <ReferenceId1 i:nil="true"/>
                  <ReferenceId2 i:nil="true"/>
               </PwsMessage>
            </Messages>
            <ResponseId>2</ResponseId>
            <Status>Ok</Status>
            <ServerTimestampUtc>2017-12-27T18:23:22.3881313Z</ServerTimestampUtc>
            <Clients>
               <PwsClientSummary>
                  <ClientId i:nil="true"/>
                  <ClientNumber>Projector PSA</ClientNumber>
                  <ClientUid>1152921504606961482</ClientUid>
                  <ClientName>Projector PSA</ClientName>
                  <InactiveFlag>false</InactiveFlag>
                  <ParentClientIdentity i:nil="true"/>
               </PwsClientSummary>
            </Clients>
         </PwsGetClientListResult>
      </PwsGetClientListResponse>

...