Insight 5.4 リリース ノート

Insight リリース ノート

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Enterprise のレベル アップ

新しい Insight カスタム フィールド

スコープを定義するための IQL に依存する新しい Insight カスタム フィールドを実装しました。課題値に依存する「課題スコープ IQL」を追加することもできます (作成/編集モード両方)。「課題スコープ IQL」で、課題フィールド データを適用できるプレースホルダーをサポートします。

例:

Insight で「Customer」というオブジェクト タイプがあるとします。ユーザーが新しいカスタム フィールドで新しいコンピュータを要求できるようにするとします (実際の例では、「コンピュータ」だけではなく、多くのハードウェア タイプが必要な場合があります)。

ユーザーは、指定した組織が所有し、指定した国に所在するコンピュータのみを選択できます。この例では、報告者が通常のテキスト フィールドに書き込める説明があるコンピュータのみを表示したいと思っています。

「スコープ IQL」:

これは、このフィールドの「コア」スコープです。Jira (JQL) での検索は、すべてこの IQL に適用されます。


objectType = "Computer"

これは課題スコープ IQL で、プレースホルダーをサポートする任意の課題フィールド値でフィルタリングできます。「課題スコープ IQL」:

Organisation = ${Organisation} AND Location = ${Country} AND Description like ${Free Text Field}


カスタム フィールドにオブジェクトを自動的に指定し、プレースホルダーをサポートする任意の課題フィールド値でフィルタリングできます。「割り当てスコープ IQL」:


//Assign objects depending on the reporter
Location.Employee = currentReporter()
//Can be specified like this as well due to support for place holders
Location.Employee = ${reporter}


オブジェクト タイプ「Computer」にはいくつかの属性があります。

名前

説明

組織オブジェクト タイプで、オブジェクト タイプ「組織」を参照します。
場所オブジェクト タイプで、オブジェクト タイプ「ロケーション」を参照します。
説明 テキスト タイプ

設定済みのカスタム フィールドは次のとおりです。

名前

説明

コンピューターオブジェクト タイプがコンピュータで、上記で説明した追加の「課題スコープ IQL」が指定されている Insight カスタム フィールド。
組織オブジェクト タイプが組織に指定されている Insight カスタム フィールド。
場所

オブジェクト タイプがロケーションに指定されている Insight カスタム フィールド。

フリー テキスト フィールドJira テキスト フィールド。

課題の作成/編集ビュー:

ビュー フォームの作成または編集に関する問題

フィルターに一致したオブジェクト:

フィルターのオブジェクト例

オブジェクト スキーマ グラフ:

Insight カスタム フィールドの設定全般の改善

カスタム フィールド設定の外観の変更

すべてのタブを削除し、ひとつの画面で設定を把握しやすくなりました。

カスタム フィールドの設定ビュー

カスタム フィールドの 25 程度のオブジェクトの設定

Insight カスタム フィールドで取得可能な最大オブジェクト数について、Insight で設定できるようになりました。これは、Jira 管理の Insight アプリ設定で行えます。

事後操作: Jira 課題からのオブジェクトの作成 

この事後操作は、その名のとおり、選択したオブジェクト属性に課題フィールドをマッピングして、新しいオブジェクトを作成します。また、オプションの Insight カスタム フィールドを選択して、作成したオブジェクトを配置することもできます。

例: 人事部門は、新しい人材が会社に入社したときに、すべての関連情報セットを持つ従業員オブジェクトを自動的に作成したいと考えています。 

この簡単な例では、従業員は名前、ユーザー (Jira)、入社日、およびオブジェクト タイプ (従業員 ID、ロール、マネージャー、オフィス) への参照を持ちます。

事後操作の設定例:

課題の作成後従業員オブジェクトを作成するために事後操作で使用する課題の例:

事後操作の実行後の従業員オブジェクト:

事後操作: 課題からのデータを基にした IQL クエリに基づいてオブジェクトを割り当てる

Jira で何かが起こったときに、バックグラウンドでカスタム フィールドにオブジェクトを割り当てる必要があることがあります。この事後操作では、設定された IQL クエリに応じて、オブジェクトをカスタム フィールドに割り当てることができます。課題値はプレースホルダーとして使用できます。Jira フィールドには共通のフィールド定義を使用します。IQL クエリは Insight のカスタム フィールドが属するスキーマで実行されます。

異なるオブジェクト スキーマのオブジェクトを参照する

とうとう実現しました! 

お客様からの要望が最も多かった機能に対応しました。スキーマ間でオブジェクトを参照可能になりました。つまり、ユーザーを管理しているスキーマとハードウェアを管理しているスキーマとの間で参照できるようになりました。

権限はオブジェクト スキーマの権限に従って遵守されるため、公開されるべきではないオブジェクト情報は公開されません。

オブジェクト ダイアログを開く - ホバー/クリック オプション

追加の要望の多かったもう 1 つの機能が、オブジェクト ダイアログの「ホバー」オプションです。これは Insight アドオン設定で使用可能および設定できるようになりました。

ツリー グラフ

新しいグラフ ビューが導入されます。これで、階層ツリー構造でオブジェクト参照を表示することができます。参照オブジェクトは、識別しやすいようにオブジェクト タイプごとにグループ化されます。これは Confluence の Insight マクロでも利用できるようになります。 

「バージョン」タイプの属性の変更

複数のプロジェクトのバージョンを制限し、プロジェクトの制限を空白のままにすることですべてのプロジェクトを指定できるようになりました。

IQL

一般

これまでは、否定演算子で空の結果を返すことができなかったのが変更されました。 

以下のクエリは、MyAttribute という属性に空の値を持つオブジェクトを返します。つまり、これはそれぞれの演算子の真否定になります。

MyAttribute != Value
MyAttribute NOT IN (Value)
MyAttribute NOT LIKE Value

参照タイプでフィルターが可能

追加された機能

object having inboundReferences(IQL, "done")
object having inboundReferences(IQL, refType in ("installed", "in progress", "done"))
object having inR(IQL, refType NOT IN ("installed"))

廃止予定の JQL 関数

古い廃止予定の JQL 関数は次のリリースで削除され、JQL の IQL 関数が優先されます。Insight 5.4 ではこのままですが、次のリリースでは JQL 関数が削除されます。これらは、JQL-IQL 関数の Insight JQL 関数に置き換えられます。


以降のリリースでは、次の JQL 関数が削除されます。

  • attributeValue(attribute、operator、value)
  • referencedObject(object key or name, reference deep)
  • objectType(name)

API changes

JAVA API

JAVA API の追加

オブジェクトの属性を検証せずにオブジェクトを格納するメソッドを追加しました。これは、オブジェクトの作成時に必要なすべての値がわからない場合に使用できます。

ObjectBean storeObjectBeanIgnoreAttributeValidation(MutableObjectBean objectBean) throws InsightException;
set/getTextValueShort および set/getTextValueShortLower は ObjectAttributeValueBean では廃止されました。代わりに setValue(ObjectTypeAttributeBean, Object) と getValue() を使用してください。 
廃止予定の Java API

ObjectAttributeValueBean.java

@Deprecated public String getTextValueShort()
@Deprecated public String getTextValueShortLower()
@Deprecated public void setTextValueShort(String textValueShort)
@Deprecated public void setTextValueShortLower(String textValueShortLower)
Java API の重大な変更

NotificationUpdateBean.java

public String getAttributeType() is changed to public String getAttributeName() since it's the attribute name that is returned

ObjectFacade.java

// Removed methods, if used (unlikely) you should use IQL Facade to build up your filter.
 
List<ObjectBean> findObjectBeansInUserProfile(String userKey) throws InsightException;
List<ObjectBean> findObjectBeansByJIRAVersion(int versionId) throws InsightException;
 
 
@Deprecated List<ObjectJiraIssueBean> findObjectJiraIssueBeans(int objectId, int offset, int limit) throws InsightException;
 
Recommended to use instead:
List<ObjectJiraIssueBean> findObjectJiraIssueBeans(int objectId) throws InsightException;

iql/objectsREST API

クエリ パラメーター includeExtendedInfo の既定値が true から false に変更されました。

catalog/objecttype/src

これまではカタログ オブジェクト全体が文字列で JSON として解析できましたが、返される各 Insight オブジェクトが JSON オブジェクトになりました。返されるデータは同じです。

UI および API での作成、更新、削除操作の変更

Insight 5.4 では、データ (オブジェクト、オブジェクト タイプ、オブジェクト タイプの属性、オブジェクト スキーマ) を変更するすべての操作は、Insight のインデックス再作成時に HTTP レスポンスコード 403 で拒否されます。 

パブリック Jira の問題を修正

  • 自動化ルールを手動で実行しても機能しない
  • 欠落しているオブジェクトでしきい値がリセットされない
  • REST API rest/Insight/1.0/objecttypeattribute/{objectTypeId}/{id}で OTA のすべてのパラメーターが更新されない
  • カタログ レポートがフリーズする
  • Insight Java API でユーザー フィールドの値がクリアされる
  • Insight カスタム フィールドにカーソルを合わせても、オブジェクトが表示されない
  • オブジェクト タイプをコピーすると GUI のバグがレンダリングされる
  • 条件またはアクションを更新すると、Automation が 2 分間機能しなくなる
  • Insight フィールドを含むJSD 3.8.2 エージェント ビューでの IE11 アイドル状態の CPU パフォーマンス
  • 複数選択の属性がインポートされない
  • 継承内のオブジェクト タイプが同じレベルに移動する
  • 属性タイプ「ユーザー」ですべてのユーザーが表示されない
  • オブジェクト上の古い名前が変更されずに再表示される
  • API または REST 経由でオブジェクトを作成するときに必須設定を無視するオプションが公開される
  • Insight の事後操作が RO フィールドで機能しない/報告者に関連する Insight フィールドが入力されない
  • Insight カスタム フィールドにカーソルを合わせても、オブジェクトが表示されない  
  • マウスのホバー情報が復活
  • Jira ユーザー インポート属性
  • IQL のプレースホルダー
  • 事後操作「オブジェクトの作成」
  • 抽象的な OT をオブジェクトの作成/インポート時にドロップダウンに表示しない
  • 異なるスキーマのオブジェクトへのリンク

Insight 5.4 にアップグレードする前に

Insight 4.x からのアップグレード

Insight 4 から Insight 5 にアップグレードした後、すべてのインポート設定を確認することを強くお勧めします。 

Insight のインストールが Insight Discovery のインポートで設定されている場合は、Insight 5 をインストールした後に以下を実行してください。

  1. Marketplace から Insight Discovery バージョン 2.x をダウンロードしてインストールします
  2. Insight Discovery インポートが設定されているオブジェクト スキーマに移動し、[Migrate Configuration (設定の移行)] を押します
  3. 移行されたインポート設定を確認します

Insight のインストールが Tempo アカウントのインポートで設定されている場合は、Insight 5 をインストールした後に以下を実行してください。

  1. Marketplace から Insight Tempo 統合をダウンロードしてインストールします
  2. Tempo インポートが設定されているオブジェクト スキーマに移動し、[Migrate Configuration (設定の移行)] を押します
  3. 移行されたインポート設定を確認します





最終更新日 2022 年 9 月 23 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.