...
This structure represents all of the unique identifying fields associated with a Useruser. Users represent people who need to log into Projector for any reason, whether it be the Management Portal or Projector Web. Each resource within Projector (a resource is capable of having time and expenses logged on their behalf) is also a User, but each User need not be a resourcea user; however it is possible to create Projector users that are not associated with a resource. Such users can log in and use Projector as their permissions allow, but cannot enter time or expenses.
Users can be identified by UserDisplayName, UserReferenceSystemId (Employee Id) or UserUid. When specifying a PwsUserRef as an input to a web service, you may specify any combination of one or more of these fields. However, if you do specify values for multiple fields, they must all refer to the same user or the user reference will not be considered valid. When a PwsUserRef is returned in the response to a web service, the UserDisplayName, UserReferenceSystemId (Employee Id) and UserUid will be populated, and guaranteed to refer to a single user.
Format
Panel | ||
---|---|---|
| ||
|
Elements
Element | Data Type | Required? |
---|
Description | Sample Data | |
---|---|---|
UserDisplayName | String |
User Display Name
(90) | One of UserDisplayName, UserReferenceSystemId or UserUid is required | The user display name is a unique identifier for a user. | Betty Smith |
UserId | Int32 |
No | The user Id is a unique identifier for a |
user. For internal use only. | |
UserReferenceSystemId | String (20) |
User Reference System ID / Employee ID
See UserDisplayName | The user reference system Id / employee Id is a unique identifier for a user. | Partner - 01 |
UserUid | Int64 |
See UserDisplayName | A unique and immutable |
identifier for a |
user. |
1152921504607011056 |
Usage Example(s)
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<b:LastUpdatedByUserIdentity> <UserDisplayName>Jack<b:UserDisplayName>Betty Spratt<Smith</b:UserDisplayName> <UserId <b:UserId i:nil="true"/> <UserReferenceSystemId>E123</UserReferenceSystemId> <b:UserReferenceSystemId>Partner - 01</b:UserReferenceSystemId> <UserUid>1152921504607112369</UserUid> <b:UserUid>1152921504607011056</b:UserUid> </b:LastUpdatedByUserIdentity> |