Overview

This structure represents the unique key fields associated with identifying a location. Locations can be identified by LocationName or LocationUid. When specifying a PwsLocationRef as an input to a web service, you may specify one or both the LocationName and/or LocationUid. However, if you do specify both, they must both refer to the same location or the location reference will not be considered valid. When a PwsLocationRef is returned in the response to a web service, both the LocationName or LocationUid will be populated, and guaranteed to refer to a single location.

Format

PwsLocationRef

PwsLocationRef
- LocationId: Int32
- LocationName: String (50)
- LocationUid: Int64

Elements

Element

Data Type

Required? (Luke, please check this column.)

Default

Description

Sample Data

LocationId

Int32

On Insert: No

On Update: No

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

LocationName

String (50)

On Insert: Yes (if LocationUid is not supplied)

On Update: Yes (if LocationUid is not supplied)

The name of the location is a unique identifier for a location.

Springfield

LocationUid

Int64

On Insert: Yes (if LocationName is not supplied)

On Update: Yes (if LocationName is not supplied)

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

1152921504606850978

Usage Example(s)

Example 01

   <b:LocationIdentity>
                        <b:LocationId i:nil="true"/>
                        <b:LocationName>Springfield</b:LocationName>
                        <b:LocationUid>1152921504606850978</b:LocationUid>
                     </b:LocationIdentity>