Versions Compared

Key

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

...

This structure is used to uniquely identify a Clientclient. Clients can be identified by ClientNumber or ClientUid. When specifying a PwsClientRef as an input to a web service, you may specify one or both the ClientNumber and ClientUid and ClientNumber. However, if you do specify both they must both refer to the same Client client or the Client Reference client reference will not be considered valid. When a PwsClientRef is returned in the response to a web service, both the ClientUid and ClientNumber and ClientUid will be populated, and guaranteed to refer to a single Clientclient.

Format


Panel
titlePwsClientRef
  • PwsClientRef
    • ClientId: Int32
    • ClientNumber: String (20)
    • ClientUid: Int64

Elements


Element

Data Type

Required?

Default

 Client Id

Description

Sample Data

ClientId

Int32

 

 

No

The client Id is a unique identifier for a client. For internal use only.


ClientNumber

String

 

 

 The Client Number

(20)

One of ClientNumber or ClientUid is required


The client number is a unique identifier for a

Client

client.

C001001 


C000121

ClientUid

Int64

 

See ClientNumber

 

The

Client

client Uid is a unique and immutable identifier for a

Client

client.

1152921504606989814

Usage Example(s)


Code Block
languagexml
titleExample 01 - Client Number Only
collapsetrue
              <PwsClientRef>
                  <!--ClientId>?</ClientId-->
                  <ClientNumber>C001001</ClientNumber>
                  <!--ClientUid>?</ClientUid-->
               </com:PwsClientRef>
Code Block
languagexml
titleExample 02 - Client Number and Client Uid
collapsetrue
<com:PwsClientRef>
          <PwsClientRef>                <ClientId i:nil="true"/>
               <ClientNumber>C001001</b<com:ClientNumber>C000121</com:ClientNumber>
               <ClientUid>1152921504606989814</b:ClientUid>
            <PwsClientRef></com:PwsClientRef>