Overview

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 three fields the ResourceDisplayName, ResourceReferenceSystemId and/or ResourceUid. However, if you do specify all three, they must 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.

Format

PwsResourceRef

PwsResourceRef
- ResourceDisplayName: String (30)
- ResourceId: Int32
- ResourceReferenceSystemId: String (20)
- ResourceUid: Int64

Elements

Element	Data Type	Required?	Description	Sample Data
ResourceDisplayName	String (30)	One of ResourceDisplayName, ResourceReferenceSystemID or ResourceUid is required	The resource display name is a unique identifier for a resource	John Smith
ResourceId	Int32	No	The resource Id is a unique identifier for a resource. For internal use only.	177898
ResourceReferenceSystemId	String (20)	See ResourceDisplayName	The resource reference system Id / employee Id is a unique identifier for a resource	Employee 01
ResourceUid	Int64	see ResourceDisplayName	A unique and immutable identifier for a resource	1152921504607024874

Usage Example(s)

Example 01

                           <ResourceIdentityValue>
                              <ResourceDisplayName>John Smith</ResourceDisplayName>
                              <ResourceId>177898</ResourceId>
                              <ResourceReferenceSystemId>Employee 01</ResourceReferenceSystemId>
                              <ResourceUid>1152921504607024874</ResourceUid>
                           </ResourceIdentityValue>