Versions Compared

Key

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

...

This structure represents all of the unique identifying fields associated with a user. 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 resource; 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 all three fields the  UserDisplayName, UserReferenceSystemId (Employee Id) and/or UserUidmore of these fields. However, if you do specify all threevalues 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 /or UserUid will UserUid will be populated, and guaranteed to refer to a single user.

...

Element

Data Type

Required?Default

Description

Sample Data

UserDisplayName

String (90)

On Insert: Yes

On Update: Yes (if the One of UserDisplayName, UserReferenceSystemId or UserUid is not supplied)required

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

Jack Spratt
Betty Smith

UserId

Int32On Insert: No

On Update: No

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


UserReferenceSystemId

String (20)

On Insert: Yes

On Update: Yes (if the UserDisplayName or UserUid is not supplied)See UserDisplayName

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

E123
Partner - 01

UserUid

Int64

On Insert: Yes

On Update: Yes (if the UserDisplayName or UserReferenceSystemId is not supplied)

The user Uid is a See UserDisplayName


A unique and immutable identifier for a user.

11529215046071123691152921504607011056

Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
                             <b:LastUpdatedByUserIdentity>
                              <UserDisplayName>Jack Spratt</UserDisplayName>   <b:UserDisplayName>Betty Smith</b:UserDisplayName>
                              <UserId   <b:UserId i:nil="true"/>
                                 <b:UserReferenceSystemId>Partner - <UserReferenceSystemId>E123<01</b:UserReferenceSystemId>
                                <UserUid>1152921504607112369</UserUid> <b:UserUid>1152921504607011056</b:UserUid>
                              </b:LastUpdatedByUserIdentity>