属性をオブジェクト タイプに追加する
属性は、オブジェクトに重要な情報を追加するためのフィールドです。本当に必要なものなら何でもかまいません。オブジェクト タイプの属性を指定すると、その属性がすべての子オブジェクトに渡されます。ユーザーはその属性を入力する必要があります。オブジェクト タイプには既定の属性セットが用意されています。
属性をオブジェクトに追加するには、次の手順に従います。
- オブジェクト タイプを選択します。
- [属性] を選択して右側のビューに切り替えます。
- 名前、タイプ、値を入力して属性を追加します。詳細については次をお読みください。
属性タイプ
属性タイプを選択できます。この設定によって、属性値の管理方法 (そして許可されるかどうか) が決まります。
| 属性タイプ | typeValue | さらなるメリット | 説明 |
|---|---|---|---|
| 既定 | Text | - | テキスト表現のデータ タイプ。通常のテキストを表示するためによく使用されます。最大 450 文字です。 |
| ブーリアン | - | true または false の 2 つのみ取り得るデータ タイプ。 | |
| 整数 | - | 一般に "整数" と言われる、分数なしで書ける数字です。たとえば 21、4、−2048 は整数です。 この属性は長整数をサポートしており、-2,147,483,648 ～ +2,147,483,647 までの数字を利用できます。 | |
| Float | - | 小数を含む数値を表すデータ タイプ。 | |
| 日付 | - | 日付フィールドを表すデータ タイプ。 | |
| 日付と時刻 | - | 日時フィールドを表すデータ タイプ。 | |
| URL | - | URL フィールドを表すデータ タイプ。サーバー側から 5 分ごとにアドレスに ping する URL Ping サービスに使用できます。オブジェクトをウォッチして、URL Ping Up/Down のメール通知を取得します。 | |
| メール | - | メール フィールドを表すデータ タイプ。 | |
| Textarea | - | テキスト表現のデータ タイプ。大量のテキストを表示するためによく使用されます。Insight リッチ エディターによってコンテンツをカスタマイズします。テキスト属性と比較して文字数は無制限です。 開発者向け: 属性 bean がありません ここでは、Java API によってこの属性の bean を取得しようとしている開発者向けの情報をいくつか紹介します。 | |
| Select | - | オプションとして事前定義された、テキスト値を表すデータ タイプ。 | |
| IP アドレス | - | IPアドレス (IPv4) を表すデータ タイプ | |
| オブジェクト | Insight オブジェクト | ReferenceType | このタイプは別のオブジェクトに参照できます。 |
| ユーザー | Jira group | プロファイルに表示 | このタイプでは、ユーザーを選択した Jira グループから選択してオブジェクトをユーザーに接続できます。 |
| Confluence | Confluence インスタンス | Confluence ページ | このタイプは Confluence ページへのリンクを有効にします。 |
| グループ | - | プロファイルに表示 | このタイプでは、Jira グループを選択してオブジェクトを指定されたグループのユーザーと接続できます。 |
| バージョン | Jira プロジェクト | - | このタイプでは、特定の Jira プロジェクトから Jira バージョンをオブジェクトに参照できます。 |
| プロジェクト | なし | - | このタイプでは、Jira プロジェクトをオブジェクトに参照できます。 |
| ステータス | 許可されているステータス | - | このタイプは、オブジェクトのステータスを設定するために使用されます。許可するステータスを定義します。空欄にするとすべてのステータスが許可されます。 |
属性設定
一部の属性タイプに用意されている追加の設定によって、既定のサフィックスまたはオプション、カーディナリティ、フィルタリングを指定できます。これらの設定オプションは、追加した属性のタイプによって異なります。
- 属性を設定するには、その横にある歯車アイコンを選択します。
- 必要に応じて構成を調整します。次に、各構成オプションの詳細を示します。
一般
| オプション | 説明 |
|---|---|
| suffix | 既定のタイプの "Integer" と "Float" では、属性のサフィックスを設定できます。たとえば "Salary" という属性の "$" などです。 |
| 非表示 | "insight-users" ロールのユーザーに対して属性を非表示にします。 |
| includeChildren | 子オブジェクト タイプからのオブジェクトを含めます。 |
| 一意 | 属性値がオブジェクト タイプ内で一意であることを検証します。 |
| 合計を表示 | 既定のタイプの "Integer" と "Float" では、値を追加して属性値の合計を表示するように選択できます。 |
| インデックス化 | これはチェックボックスで、この属性にインデックスを付けるかどうかを指定できます。 基本検索、または任意の場所 (事後操作、インポート、カスタム フィールドなど) で IQL による詳細検索を行う際に、各属性に対するインデックス作成機能は検索結果をより速く取得するのに役立ちます。したがって、これらの複数の場所で使用されるすべての IQL クエリにおいて、属性にインデックスを作成することをお勧めします。 属性にインデックスを作成すると、Insight は毎回データベースから結果を取得するのではなくインデックス/キャッシュから結果を取得するため、より迅速に結果が得られます。ただし、これにはメモリ消費量が増えるという代償が伴います。 インデックス化されていない属性の場合、メモリ消費量は少なくなります。 属性にインデックスを付けると、属性の「名前」の前に小さなアイコン さらに、ラベル属性では、インデックス付きアイコンがラベルのアイコンの横に表示されます (以下参照)。
初期設定では Insight はオブジェクト タイプのすべての属性にインデックスを付けますが「Textarea」属性はこのルールの例外です。 キー、ラベル、作成、更新の各属性には、参照タイプの属性と同様、常にインデックスが付けられます。 |
カーディナリティ
属性に関連付けられる属性値の最小数/最大数を指定できます。属性を複数選択または必要/必須に設定する必要がある場合に一般的に使用されます。
「既定」タイプの属性では、最大カーディナリティを 1 にのみ設定できます。ただし「URL」と「メール」では、複数の値を区切るためにスペースを追加できます。
検証
既定のタイプ「テキスト」、「メール」、「URL」の属性を正規表現で検証できます。IP アドレス、ドメイン名、電話番号など、検証が必要な特定の情報を検証する場合に役立ちます。
オプション
ここに複数のオプションを追加することで、それらのオプションを「選択」タイプの属性に追加できます。
オブジェクトをフィルタリングする
「オブジェクト」タイプの属性では、IQL によって選択されるオブジェクトを絞り込めます。このフィルターによって、オブジェクトの作成/編集時に他のフィールドへの依存関係を作成できます。
次の例は、ノートパソコンを参照するオブジェクト タイプ Employee のオブジェクト参照属性を設定する方法を示しています。[製造元] テキストボックスに値を入力すると、対応するベンダーのノートパソコンのみが選択可能になります。IQL にある複数のフィールドを組み合わせて、複数の依存関係を取得できます。
| 説明の例 | スクリーンショットの例 |
|---|---|
| 従業員はラップトップへのアウトバウンド参照を持っています。また「コンピュータ製造元」という属性もあります。 |
|
属性「ノートパソコン」の IQL の構成は |
|
ラップトップには「ベンダー」という属性があります。 |
|
次のステップ
次のページをご参照ください。