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 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
titlePwsUserRef
  • PwsUserRef
    • UserDisplayName: String (90)
    • UserId: Int32
    • UserReferenceSystemId: String (20)
    • UserUid: Int64

Elements


Element

Data Type

Required?

Default

Description

Sample Data

UserDisplayName

String

 

 

User Display Name

Jack Spratt

(90)

One of UserDisplayName, UserReferenceSystemId or UserUid is required

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

Betty Smith

UserId

Int32

 

 

A

No

The user Id is a unique identifier for a

User

user. For internal use only.


UserReferenceSystemId

String (20)

 

 

User Reference System ID / Employee ID 

E123 

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

Id

identifier for a

User

user.

1152921504607112369
1152921504607011056

Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
                             <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>