Versions Compared

Key

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

...

This structure represents the unique key fields associated with identifying a resource. Resources can be identified by ResourceDisplayName, ResourceReferenceSystemId or ResourceUid. When specifying a PwsResourceRef as an input to a web service, you may specify one or all any combination of the three fields the ResourceDisplayName, ResourceReferenceSystemId and/or ResourceUid. However, if you do specify all threemore than one, they must all refer to the same resource or the resource reference will not be considered valid. When a PwsResourceRef is returned in the response to a web service, the ResourceDisplayName, ResourceReferenceSystemId or ResourceUid will be populated, and guaranteed to refer to a single resource.

...

Element

Data Type

Required?Default

Description

Sample Data

ResourceDisplayName

String (30)

On Insert: Yes

On Update: Yes (if ResourceReferenceSystemId One of ResourceDisplayName, ResourceReferenceSystemID or ResourceUid is not supplied)required

The resource display name is a unique identifier for a resource.

John Smith

ResourceId

Int32

On Insert: No

On Update: No

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

177898

ResourceReferenceSystemId

String (20)

On Insert: No

On Update: Yes (if ResourceDisplayName or ResourceUid is not supplied)See ResourceDisplayName

The resource reference system Id / employee Id is a unique identifier for a resource.

Employee 01

ResourceUid

Int64

On Insert: No

On Update: Yes (if ResourceDisplayName or ResourceReferenceSystemId is not supplied)see ResourceDisplayName

A unique and immutable identifier for a resource.

1152921504607024874

Usage Example(s)

...