Versions Compared

Key

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

Overview


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 Client.client.

Format


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

Elements


Default (on insert/update)Client IdC001001

Element

Data Type

Description

Required?

Description

Sample Data

ClientId

Int32

No

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


ClientNumber

String (20)

One of ClientNumber or ClientUid is required


The client number is a unique identifier for a client.


C000121

ClientUid

Int64

See ClientNumber

The client Uid is a unique and immutable identifier for a client.

1152921504606989814

Usage Example(s)


Code Block
languagexml
titleExample 01 - Client Number Only
collapsetrue
              <PwsClientRef>
                  <!--ClientId>?</ClientId-->
                  <ClientNumber>C000117</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>