Skip to main content

Basic Fields

Basic fields are associated with all items by default. These fields are native to Tonkean and help enable workflow logic, though not all basic fields are used by every item.

Basic fields display in the Basic Fields list, under Item Metadata Fields in the Fields panel. Basic fields can't be edited or deleted.

felds_panel_overview.png

  • Root Item - Indicates whether the item is a root item or an inner item. This is a boolean field where true equals a root item and false equals an inner item.

  • Title - The display name of the item; this is the title of the item as it appears on the related business report. This field is required for all items and is automatically generated when connecting a data source. It can be updated at any time.

  • Description - The description of the item. This field is often populated with a description of a request.

  • Owner - The owner of the item. This field value is displayed in the Owner column of the related business report and can change through a business process as different users are assigned ownership of the given item.

  • Owner Name - The name of the item's owner.

  • Due Date - The date the item is due.

  • Status - The current status of the item.

  • Status Type - The type of the item's current status, such as active, on hold, or done.

  • ETA - The estimated time of arrival (ETA) of the item.

  • Group Id - The unique identifier of the module the item belongs to.

  • Parent Owner Email - The email address of the parent item's owner, where relevant.

  • Parent ID - The unique identifier for the parent item.

  • Environment - The environment the item runs in. Items in the Build environment have a value of Build, and items in the Production environment have a value of Published.

  • Update Text - The reply from action types that require a user response (for example, Ask for Status or Ask for Information actions). This free-text field stores replies to these actions.

  • Last Module Ping - The date and time the module contacted the relevant person using the automatic check-in feature.

  • Modified - The date and time the item was last updated.

  • Tags - User-generated field used for identifying and filtering items. Tags can also be used in a workflow condition, much like other fields.

Some of these are not seen by the end user and are specific to the module itself, while others, such as Owner, Due Date, and Status display in the relevant business report and are visible to the end user. You can pull most of these fields into your triggers or update them using certain actions. Some basic fields are set by Tonkean and can't be updated, including Root Item, Owner Name, Status Type, Group Id, Environment, Last Module Ping, and Modified.

Most of the basic fields are optional and may or may not be relevant for many data sources, but one field, Title, is required for every single item. Most of the time, this will automatically be selected for you when you connect a data source.

In this section: