Attributes

User's Guide

On this page

In this section

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

An attribute is a value that holds information about an object. Attributes can hold text values, numerical values, or object values - which makes it possible to build references that link two objects. This section will show you with how to create, edit, and delete attributes, how to filter their information using IQL, and how to configure their unique values, cardinality, and their inheritance from parent objects.

There are different attribute types. Attributes can hold text, integers, dates, and Jira users or groups. Attributes can also hold a reference to another object - one of the most interesting features in Insight.

TypeType ValuesDescription
DefaultTextSingle line of text
BooleanBoolean data type
IntegerIntegral data type
FloatFloating point
DateDate picker
DateTimeDate & Time picker
EmailEmail address
URLA web address, starts with http:// or https://
TestareaA multi line text area
ObjectObject Type

This attribute type makes it possible to reference objects to each other. You also specify the reference type (name and color of reference). This attribute type unlocks Insight to create sophisticated references and structures of Objects.

Let's say you want to get all your servers into Insight and each server should have have a SLA level specified. This SLA level should be selectable from a predefined list of SLA's. You first need to create an Object Type called SLA Level of Attribute Type Default (Text) and create your SLA Objects (Level 1, Level 2 etc.). You then create an attribute for the server object type called SLA Level and it should be of type Object, it should reference to the SLA Level Object Type. The results will be a drop down list where you can pick the correct SLA level when you create a server.

UserJira groupBy using this type, you will get a drop down list with users belonging to the selected Jira group
GroupJira groupThis drop down list makes it possible to select one or more Jira groups in your Jira instance
StatusOne or more statuses

Statuses can be created on the Object Schema level. These statuses can then be defined in this attribute to generate a drop down list with selectable statuses. Let's say that you have defined the following statuses in your Object Schema to be used by different Status attributes for different Object Types:

  • New
  • In Service
  • Decommissioned
  • Running
  • Incident in Progress
  • Unresponsive
  • In Stock

For this particular Status Attribute, you can chose to only enable Running, Incident in Progress and Unresponsive.


Creating an attribute

You can create an attribute by completing the fields in the Overview > Attributes screen and clicking Add. 

How to create an attribute...

To create an attribute, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. In the listing of attributes, enter a Name, Description, Type and Type Value.
  6. Click Add at bottom-right.

You can delete attributes by clicking on Delete.

How to delete an attribute...

To delete an attribute, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click the cogwheel to the right of the attribute you wish to delete and select Delete.

Inheriting attributes from parent objects

Because Insight object schemas arrange object types in a hierarchy, you can configure an attribute to automatically inherit all attributes of your parent object type.

How to inherit all parent attributes...

Because Insight object schemas arrange object types in a hierarchy, you can automatically inherit all attributes from your parent object type.

You must be logged in as an Object Schema Manager:

  1. Navigate to the attribute that you wish to inherit parent attributes.
  2. Click Add Parent Attributes, at bottom.
  3. Click Add to add all parent object type attributes. If your object type already has attributes with the same name as the parent attributes, they will be ignored.


Configuring attributes

You can access the configuration options for attributes by clicking on the cogwheel and then Configuration.

The General tab allows you modify the settings for an attribute.

How to include child objects in an attribute...

To include child objects in an attribute, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click on the cogweel to the right of the attribute you wish to delete and select Configure.
  6. Under the General tab, click Include Children.

How to verify attribute values to be unique...

Unable to render {include} The included page could not be found.

How to hide attributes from the Insight User role...

There might be situations in which you want an object type to include attributes that aren't visible to Insight Users. You need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click the cogwheel to the right of the attribute you wish to delete and select Configure.
  6. Under the General tab, click How to hide attributes from the Insight User role.

How to show the sum of multiple attributes...

If you have created an attribute of type "Integer" or "Float", you can configure an attribute to show the sum of these attribute values. To do this, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight  in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click on the cogwheel to the right of the attribute and select Configure.
  6. Under the General tab, click Show sum.

How to add a suffix to an attribute...

To add a suffix to an attribute, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click the cogwheel to the right of the attribute and select Configure.
  6. Under the General tab, enter a value under Suffix.

Managing object attributes

You can use cardinality, validation, and filtering to control how objects are added to an object attribute:

  • The Cardinality tab allows you to set the minimum and maximum number of objects that can be values for this attribute.
  • The Validation tab allows you to validate attributes of default type "Text", "Email" & "URL" using regular expressions.
  • The Filter tab allows you to filter a list of objects using Insight Query Language (IQL). You can use this feature to create a dependency between two fields in a way that creates a nested list, or to pass information between two objects.
How to set the cardinality of an attribute...

To delete an attribute, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click the cogwheel to the right of the attribute you wish to delete and select Delete.

How to validate attributes with regular expressions...

You can validate attributes of default type "Text", "Email" & "URL" with regular expressions. This can be handy if you want to set a validation on IP Addresses, domain names, or any type of information that you need to validate. To configure attributes to require validation, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click to the right of the attribute you wish to delete and select Configure.
  6. Under the Validate tab, enter the regular expression used to validate the input.

How to filter attribute values using IQL...

To filter attribute values using IQL, you need to be logged in with an Insight Administrator role or an Insight Schema Manager role:
  1. Click Insight  in the left sidebar.
  2. Under Insight, click Object Schemas and select an object schema.
  3. Select an object type at left.
  4. At right, click Attributes.
  5. Click the cogwheel to the right of the attribute you wish to modify and select Configure.
  6. Under the Filter objects tab, enter an IQL filter.

Last modified on Oct 6, 2021

Was this helpful?

Yes
No
Provide feedback about this article

In this section

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.