entity object in the root level is the Business Object (also referred to as an Entity) that is passed to the template for processing. This object can be a User Story, Bug, Task, Feature, or any other Entity type in Targetprocess. An entity may contain references to other entities.
user object in the root level is always the user who is the recipient of the email. Objects of
User class may be referenced in fields and collections such as
A field is a member variable that belongs to an object.
These properties are common among all entities.
|.ID||Integer||The entity’s numeric ID.|
These properties are common among assignable entities (for example, User Stories, Bugs, Features, and Tasks).
|.Name||String||The name of the entity.|
|.Description||String||The entity’s description text. Formatting is HTML. Should be processed properly.|
|The name of the entity type. For instance it can be |
|.Priority||Object (Priority)||The current priority (business value) of the entity.|
|The current release / iteration (sprint) the entity is assigned to.|
|.TeamsCollection||Array of Objects (Assignment)||This array contains Assignments of Users to an entity. Details on responsible Roles are included as well.|
|.Owner||Object (User)||The user who is Owner of an entity.|
|.LastEditor||Object (User)||The user who performed most recent modification of an item. Example: Last Editor|
The current priority (business value) of the entity.
|.Name||String||The name of the business value.|
The current release / iteration (sprint) the entity is assigned to. The object inherits all properties of Entity: Assignable object and has some additional ones.
|.StartDate||Date||The start date of the release / iteration (sprint).|
|.EndDate||Date||The end date of the release / iteration (sprint).|
The object represent assignment of a user to an entity. Details on responsible Role are included as well. Array of
Assignments is retrieved from the Assignable entity via the following method:
The role of the assignment.
|.Name||String||The name of the role.|
An (Assignable) entity has linked Comments collection.
|.Description||String||The text of the comment. Formatting is HTML. Should be processed properly.|
|.General||Object (Assignable)||The entity to which the comment is submitted to.|
|.Owner||Object (User)||The user who submitted the comment.|
|.IsPrivate||Boolean||Private comments are hidden for Requesters in Service Desk. Requesters are external users who don't have Targetprocess license.|
|.FullName||String||The user’s full name.|
|.FirstName||String||The user’s first name.|
|.LastName||String||The user’s last name.|
|String||The user’s email address.|
|.Login||String||The user’s login within Targetprocess.|
You can find more detailed documentation on the Business Objects and their respective properties here: https://md5.tpondemand.com/api/v1/index/meta
Updated over 4 years ago