Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Current »

Overview


This structure represents the unique key fields associated with identifying a resource title. Titles are used when requesting and booking resources during the resource scheduling workflow, in the determination of default billing. A title can be identified either by a unique identifier (UID), or the combination of department identity and name. The department identity or title name alone do not sufficiently identify a single title. When passing a title identity as input to a web service, you need only specify the unique identifier or the department identity and title name. You may specify all three values if you wish, but if you do so, they must all refer to the same title, or the reference will not be considered valid. When this structure is returned as part of the response from a web service, all fields will be specified, and will be guaranteed to refer to a single title.

Format


PwsTitleRef
  • PwsTitleRef
    • DepartmentIdentity: PwsDepartmentRef
    • TitleId: Int32
    • TitleName: String
    • TitleUid: Int64

Elements


Element

Data Type

Required?

Description

Sample Data

DepartmentIdentity

PwsDepartmentRef

No

The department identity and title name together are a unique identifier for a title.


TitleId

Int32

No

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


TitleName

String

No

The department identity and title name together are a unique identifier for a title.

Level 3


TitleUid

Int64

No

A unique and immutable identifier for a resource title.

1152921504606885671


Usage Example(s)


Example 01
                     <com:TitleIdentity>
                        <com:DepartmentIdentity>
                           <com:DepartmentName>Executive Team</com:DepartmentName>
                           <com:DepartmentUid>1152921504606854181</com:DepartmentUid>
                        </com:DepartmentIdentity>
                        <com:TitleName>Level 3</com:TitleName>
                        <com:TitleUid>1152921504606885671</com:TitleUid>
                     </com:TitleIdentity>
  • No labels