Object type attributes enable important data to be added to objects. The attributes are type specific and all objects of that particular type can be defined by using the type attributes. Setting up type attributes requires Schema Manager's permission.
Attribute types are used to determine the attribute field's behavior. There are a few configuration items to consider for each attribute.
ラベル
Each Object must have a label and is the attribute that representing the object in Insight. You are allowed to change the label to any TEXT attribute. The default label is "Name" but can be changed from a system perspective in the Insight global app configuration in JIRA Administration add-on section.
説明
You can give the attribute a description to help your users to know what value to add in the attribute field.
Types of attributes
属性タイプを選択できます。この設定によって、属性値の管理方法 (そして許可されるかどうか) が決まります。
| Attribute Type | Type Value | Additional Value | 説明 |
|---|---|---|---|
| 既定 | Text | なし | Data type with text representation, often used when showing normal text. Maximum 450 characters. |
| 既定 | ブーリアン | なし | Data type with only two possible values: true or false. |
| 既定 | 整数 | なし | Commonly known as a "whole number", is a number that can be written without a fractional component. For example, 21, 4, and −2048 are integers. This Attributes supports the Long Integer and will allow numbers that range from -2,147,483,648 to +2,147,483,647 |
| 既定 | Float | なし | 小数を含む数値を表すデータ タイプ。 |
| 既定 | 日付 | なし | 日付フィールドを表すデータ タイプ。 |
| 既定 | 日付と時刻 | なし | 日時フィールドを表すデータ タイプ。 |
| 既定 | URL | なし | URL フィールドを表すデータ タイプ。サーバー側から 5 分ごとにアドレスに ping する URL Ping サービスに使用できます。オブジェクトをウォッチして、URL Ping Up/Down のメール通知を取得します。 |
| 既定 | メール | なし | メール フィールドを表すデータ タイプ。 |
| 既定 | Textarea | なし | Data type with text representation, often used when showing large text. Use Insight rich editor to customize the content. Unlimited characters in comparison to the Text attribute. |
| 既定 | Select | なし | オプションとして事前定義された、テキスト値を表すデータ タイプ。 |
| 既定 | IP アドレス | なし | IPアドレス (IPv4) を表すデータ タイプ |
| オブジェクト | Insight オブジェクト | ReferenceType | This type enables a reference to another Insight object. |
| ユーザー | Jira group | プロファイルに表示 | This type makes it possible to select a user from the selected Jira group and connect object/s with users. |
| Confluence | Confluence インスタンス | Confluence ページ | このタイプは Confluence ページへのリンクを有効にします。 |
| グループ | なし | プロファイルに表示 | このタイプでは、Jira グループを選択してオブジェクトを指定されたグループのユーザーと接続できます。 |
| バージョン | Jira プロジェクト | なし | This type makes it possible to reference a Jira Version from a specific Jira Project to your object(s). |
| プロジェクト | なし | なし | This type makes it possible to reference a Jira Project to your object(s). |
| ステータス | 許可されているステータス | なし | このタイプは、オブジェクトのステータスを設定するために使用されます。許可するステータスを定義します。空欄にするとすべてのステータスが許可されます。 |
In order for the Confluence attribute type to work, you must have an application link setup (Trusted Connection) between Jira and Confluence. Insight caches pages for 30 minutes, so any changes or page names will not be shown in Insight after 30 minutes. Your Confluence version needs to be 5.5 or above.
Additional configuration
Choose Configure to set additional configuration. Depending on the attribute type, you have different configuration options as shown below. "Location" is a Reference object type while "Price" is an Integer type.
一般
| suffix | 既定のタイプの "Integer" と "Float" では、属性のサフィックスを設定できます。たとえば "Salary" という属性の "$" などです。 |
| 非表示 | "insight-users" ロールのユーザーに対して属性を非表示にします。 |
| includeChildren | 子オブジェクト タイプからのオブジェクトを含めます。 |
| 一意 | 属性値がオブジェクト タイプ内で一意であることを検証します。 |
| 合計を表示 | 既定のタイプの "Integer" と "Float" では、値を追加して属性値の合計を表示するように選択できます。 |
| インデックス化 | これはチェックボックスで、この属性にインデックスを付けるかどうかを指定できます。 The Indexed feature on every attribute essentially helps you to retrieve your search results faster when you do a basic search or an advanced search using IQL anywhere (e.g, post functions, imports, custom fields etc). So the recommended practice is that for all IQL queries used at these multiple places, you should index your attributes. 属性にインデックスを作成すると、Insight は毎回データベースから結果を取得するのではなくインデックス/キャッシュから結果を取得するため、より迅速に結果が得られます。ただし、これにはメモリ消費量が増えるという代償が伴います。 インデックス化されていない属性の場合、メモリ消費量は少なくなります。 If you index an attribute, a small icon Additionally, for the label attribute, the indexed icon will appear adjacent to the icon for the label as shown below.
初期設定では Insight はオブジェクト タイプのすべての属性にインデックスを付けますが「Textarea」属性はこのルールの例外です。 The Key, Label, Created, and Updated attributes will always be indexed, as will any attributes of the type Reference. |
カーディナリティ
属性に関連付けられる属性値の最小数/最大数を指定できます。属性を複数選択または必要/必須に設定する必要がある場合に一般的に使用されます。
「既定」タイプの属性では、最大カーディナリティを 1 にのみ設定できます。ただし「URL」と「メール」では、複数の値を区切るためにスペースを追加できます。
検証
既定のタイプ「テキスト」、「メール」、「URL」の属性を正規表現で検証できます。IP アドレス、ドメイン名、電話番号など、検証が必要な特定の情報を検証する場合に役立ちます。
オプション
ここに複数のオプションを追加することで、それらのオプションを「選択」タイプの属性に追加できます。
オブジェクトをフィルタリングする
「オブジェクト」タイプの属性では、IQL によって選択されるオブジェクトを絞り込めます。このフィルターによって、オブジェクトの作成/編集時に他のフィールドへの依存関係を作成できます。
The following examples shows how to configure an object reference attribute on the object type Employee to reference a Laptop. If a value is entered in the Manufacturer textbox only Laptops with the corresponding Vendor will be chosable. It is possible to combine multiple fields in the IQL to get multiple dependencies. Read more about the placeholders in order to figure out how to utilse them for your usecase.
| The employee has an outbound reference to Laptop. The employee also has an attribute called Computer Manufacturer | The IQL for attribute Laptop is configured with Vendor = ${Computer Manufacturer}
| The laptop has an attribute called Vendor |
|
|
|
