レンダラーの設定

レンダラー設定は、リッチ テキスト フィールドにマークダウンを使用する新しい Jira 課題ビューには影響しません。書式設定オプションとショートカットについては「Jira Cloud でのマークダウン フォーマット」をご参照ください。

レンダラーはフィールドごとに指定されます。特定のフィールドのレンダラーを設定するには「フィールド動作の指定」をご参照ください。プロジェクトと課題が異なる場合は、同じフィールドの設定に異なる設定を行えます。「フィールド動作を課題タイプと関連付ける」をご参照ください。

レンダラーは Jira プラグインとして実装されます。つまり、Jira 内で簡単に追加または削除できます。これには、開発可能な任意のカスタムレンダラーも含まれます。

レンダラーの設定前に、以下の「Jira アプリケーションに関する情報」をお読みください。

レンダラーはフィールドの値のレンダリング (ビュー) に影響を与えます。つまり、課題データに影響を与えずに異なるレンダラーに移行できます。ビューのみが変更されます。つまり、新しいレンダラーを使用した課題の表示方法が気に入らない場合は、課題データに影響を与えずに元に戻すことができます。

始める前に: Jira 管理者グローバル権限を持つユーザーとしてログインする必要があります。

レンダリング可能なフィールド

Jira アプリケーション内のフィールドはレンダリング可能なフィールドとなる可能性があります。ただし、これはテキストベースのフィールド (既定のテキストレンダラーおよび Wiki スタイルレンダラーの場合) や複数選択フィールド (オートコンプリートレンダラーや選択リストレンダラーの場合) の場合にのみ意味を成します。次の図は、標準でレンダリング可能な Jira フィールドを示しています。

フィールド

利用可能なレンダラー

説明

Wiki スタイル レンダラー (初期設定)、 初期設定のテキスト レンダラー

コメント

Wiki スタイル レンダラー (初期設定)、 初期設定のテキスト レンダラー

環境

Wiki スタイル レンダラー (初期設定)、 初期設定のテキスト レンダラー

Component

オートコンプリート レンダラー (初期設定)、 選択リスト レンダラー

影響バージョン

オートコンプリート レンダラー (初期設定)、選択リスト レンダラー

修正バージョン

オートコンプリート レンダラー (初期設定)、選択リスト レンダラー

カスタムのフィールドタイプ「フリーテキストフィールド (無制限のテキスト)」

Wiki スタイル レンダラー (初期設定)、初期設定のテキスト レンダラー

カスタムのフィールドタイプ「テキストフ​​ィールド」

Wiki スタイル レンダラー (初期設定)、初期設定のテキスト レンダラー

カスタムのフィールドタイプ「マルチ選択」

選択リストレンダラー

カスタムのフィールドタイプ「バージョンピッカー」

オートコンプリート レンダラー (初期設定)、選択リスト レンダラー

レンダラーのタイプ

Jira には次のレンダラーが付属しています。

既定のテキストレンダラー

初期設定のテキスト レンダラーは、次のようなその他の自動リンク機能によって、フィールドの内容をプレーン テキストとしてレンダリングします。

コンテンツ

説明

サンプル

Jira 課題

テキストに、Jira 課題キーを解決するテキストが含まれている場合、その課題を示す HTML リンクが生成されます。

Jira 課題へのリンクを表示するテキスト レンダラーの例

Web リンク

テキストに Web サイト上の Web ページを解決するテキストが含まれている場合、その Web リンクを示す HTML リンクが生成されます。

Web リンクを指すテキスト レンダラーの例

既定のテキストレンダラープラグインは、システムが正しく機能するために必要なため、無効化できません。後から無効化するレンダラーを使用するようテキストフィールドを設定した場合、既定のテキストレンダラーを使用するようフィールドが元に戻されます。

Wiki スタイルレンダラー

Wiki スタイルレンダラーを使用すると、ユーザーは Wiki マークアップを入力し、HTML コンテンツを生成できます

このレンダラーは Confluence Wiki レンダラーエンジンを使用しているため、Confluence Wiki 記法を使用します。Confluence 記法は学びやすく、以下が可能です。

  • 斜体、太字、下線付きテキスト

  • 複数レベルの見出しでドキュメントを整理する

  • 箇条書き、番号付け、テーブル、引用

  • 画像、スクリーンショット、絵文字

  • マクロによる強力なアプリケーション
    完全な表記ガイドについては、こちらをご参照ください。

Wiki スタイル レンダラーは JDK 1.4 以上で使用できます。レンダラーは JDK 1.3 では動作しません。

一部のフィールドでは、さらにフィールド動作設定の有効化が必要な場合があります。「フィールド動作の指定」をご参照ください。

Wiki スタイルレンダラーのマクロサポート

Wiki スタイルレンダラーは、Confluence と同じ方法でプラグ可能なマクロをサポートしています。マクロは Wiki マークアップ言語を示す、簡単で強力な拡張子を提供します。Jira には多数のマクロが付属しています

Jira と Confluence でマクロを共有することができますが、Confluence マクロの多くは Confluence アプリケーションに固有なため、Jira 内では動作しません。たとえば、Confluence の「children」マクロは、ページの子どページすべてへのリンクを表示します。Jira には「ページ」の概念がないため、このマクロは Jira では動作しません。

オートコンプリート レンダラーおよび選択リスト レンダラー

オートコンプリートレンダラーと選択リストレンダラーを使用すると、テキストの入力を開始後、オートコンプリートが行われるか、オプションのドロップダウンリストから選択できます。

オートコンプリートまたはドロップダウンのテキスト レンダラーの例

Jira オペレーションに関する情報

Jiraで、同じフィールドに対して異なるプロジェクト/課題課題タイプで異なるレンダラーを設定できるという事実には、一括操作を示しています。また、Wiki スタイルレンダラーは本質的に、最終製品として HTML を作成するため、Jira の Web フロントエンド以外で課題データが表示される際に、これがどのように動作するかを示しています。

一括移動

一括移動操作を実行する際には、課題をフィールドのレンダラーのタイプが同じ環境 (プロジェクト/課題タイプ) またタイプが異なる環境のいずれかに移動できます。

レンダラーのタイプが同じ場合

移動先のレンダラーのタイプが同じ場合、移動後の課題タイプの表示方法に変化はなく、警告メッセージは表示されません。

レンダラーのタイプが異なる場合

移動によって影響を受けるフィールドのイオずれかの定義とレンダラーのタイプが異なる環境 (プロジェクト/課題タイプ) へ課題を一括し、いずれかのフィールドにフィールドと関連付られた空白でない値があった場合、移動操作を行うと警告が表示され、変更を認識できます。警告は移動操作には影響しませんが、移動された課題の影響を受けたフィールドの外観が、新しいプロジェクト/課題タイプで異なる可能性があります。

一括編集

一括編集操作を実行する際、一括編集可能なレンダリング可能フィールドは、テキストフィールドのインスタンスと、フリーテキストフィールド (無制限のテキスト) カスタムフィールドです。一括編集操作では、説明、環境、またはコメントフィールドの一括編集を行うことはできません。

編集対象として選択したすべての課題が同じレンダラータイプを使用している場合にのみ、レンダリング可能なフィールドの一括編集を実行できます。選択した課題のいずれかでレンダリングタイプが異なる場合、エラーメッセージが表示されます。

これは例を使用することでうまく説明されます。「カスタムテキストエリア」と「カスタムテキストフィールド」という 2 つのグローバルカスタムフィールドがあると想定します。それぞれのタイプは名前が示すとおりです。両方のフィールドに Wiki スタイルレンダラーを使用するよう設定されたプロジェクト「A」があるとします。また、「カスタムテキストエリア」フィールドには既定のテキストレンダラー、「カスタムテキストフィールド」には Wiki スタイルレンダラーを使用するプロジェクト「B」があるとします。さらに、各プロジェクトに課題が 1 つあるとします。これらのプロジェクトで 2 つの課題の一括編集操作を実行すると、次のように表示されます。

一括編集テキスト レンダラーの例

メール通知

Jira ではメール通知に関係した拡張設定を利用できるため、HTML とテキストの 2 種類のメールを送信できます。詳細については「通知スキームの作成」と「メール通知の設定」をご確認ください。

HTML メール

アトラシアン Wiki レンダラーを賜与ウする場合、レンダリングされたコンテンツ (例: 「課題の表示」ページで表示される内容) が電子メールに送信されます。これにより、コンテンツによって電子メールをできるだけ豪華にすることができます。Wiki スタイルレンダラーを使用している場合、Wiki マークアップの実際の表現のため、これは電子メールの優先タイプです。

テキストメール

アトラシアン Wiki レンダラーを使用すると、Wiki スタイル レンダラーを使用するテキスト メールのフィールドに実際の Wiki マークアップ (レンダリングされていない) が表示されます。これは明らかに、マークアップのレンダリングされていないバージョンよりも読みやすくなりますが、マークアップの構文は非常にシンプルなため、テキストは読みやすいままとなります。

Excel ビュー

Jira では、課題ナビゲータービューを Excel スプレッドシートにエクスポートできます。Excel にエクスポートされるフィールドのいずれかが Wiki スタイルレンダラーを使用している場合、Excel のセルにエクスポートされる値は元の Wiki マークアップとなります。Excel のセル内で複雑な HTML を表示しようとすると、列と行が追加され、式にデータを使用するのが非常に難しくなります。

レンダリングされたいない Wiki マークアップは、Wiki スタイル レンダラーを使用する Excel セルのフィールドに表示されます。

RSS/XML ビュー

Jira では、課題ナビゲータービューを RSS/XML にエクスポートできます。フィールドが既定のテキストレンダラーを使用している場合、そのフィールドの値は生成された XML 内の CDATA セクションにエクスポートされます。フィールドが Wiki スタイルレンダラーを使用している場合、レンダリングされた値は XML 用にエスケープされ、生成された XML に含まれます。XML ビューが RSS フィードとして使用されている場合、ほとんどの RSS リーダーは生成された HTML をレンダリングします。そのため、RSS リーダー内にリッチコンテンツが表示されます。

このビューで生の値 (レンダリングされていない) のフィードを使用したい場合、追加のパラメーター 'rssMode=raw' を送信できます。元のリンクが次のようになった場合:

1 2 3 4 http://localhost:8080/browse/AAA-1?decorator=none&view=rss

次に、CDATA 内に配置された生データを持たせる URL は次のようになります。

1 2 3 4 http://localhost:8080/browse/AAA-1?decorator=none&view=rss&rssMode=raw

レンダリング可能なカスタムフィールドの既定の値を編集する

レンダリング可能なカスタムフィールドの既定値を編集する場合、Wiki スタイルレンダラーを使用するよう設定されたことがあっても、編集およびプレビューオプションは表示されません。残念ながら、このコンテキスとでは、どちらのレンダラーを編集に使用すべきかを決めることはできません。ただし、Wiki マークアップを使用して既定値を入力する場合、これにより、フィールドが Wiki スタイルレンダラーを使用するよう設定された環境 (プロジェクト/課題タイプ) で正しくレンダリングされます。

レンダラーの設定

フィールドにレンダラーを適用する

特定のフィールドのレンダラーを有効にするには、フィールド設定を編集してフィールドに適切なレンダラーを選択します。詳細については「フィールド動作の指定」をご参照ください。

レンダラープラグインの有効化

Jira 内のレンダラーは Jira プラグインとして実装されます。Wiki スタイル レンダラーが使用するマクロも、Jira プラグインとして実装されます。プラグインの一般的な情報については「Jira プラグイン ガイド」をご確認ください。

プラグインは、インスタンス全体のレベルで設定されます。プロジェクト/課題タイプレベルでプラグインを設定することはできません。

レンダラープラグインの設定

レンダラーおよびそれらの依存コンポーネントは、既定テキストレンダラーを除き、次のように有効化/無効化できます。

  1. > [アプリ] の順に選択します。

  2. 「アドオンを検索」画面に、Atlassian Marketplace で利用可能なアドオンが表示されます。[アドオンを管理] を選択して、Jira インスタンスに現在インストールされているプラグインを表示します。

  3. アドオンの管理」を選択して「レンダラー」を検索し、次のようにシステムアドオンをフィルターします。

この画面には、Jira 内で設定されているすべてのレンダラーが表示されます。

  • [無効化] を選択して、Jira のインスタンス全体のレンダラーを無効にします。

無効化されたレンダラーを使用するよう設定されているフィールドがあれば、既定のテキストレンダラーに戻されます。フィールドを編集し用とすると、利用できないレンダラーを使用するよう設定していることを示す警告メッセージが表示されます。

レンダラーが無効になっていると、フィールドのレンダラーを変更する際にレンダラーを選択できません。レンダラーを有効にするには [有効化] を選択します。レンダラーを有効/無効にしてもフィールド設定のレンダラー設定には影響しないため、データに影響を与えずにレンダラーを無効にしてから再度有効にできます。

Wiki スタイルレンダラーのマクロプラグインを設定する

Wiki スタイルレンダラーによって使用されるマクロは、次のように有効化/無効化できます。

  1. > [アプリ] の順に選択します。

  2. 「アドオンを検索」画面に、Atlassian Marketplace で利用可能なアドオンが表示されます。[アドオンを管理] を選択して、Jira インスタンスに現在インストールされているプラグインを表示します。

  3. アドオンの管理」を選択して「レンダラー」を検索し、システムアドオンをフィルターします。

  4. [Wiki レンダラー マクロ プラグイン] を展開して、次を表示します。

Wiki スタイル レンダラーの例

この画面から、Jira 内で設定されているすべてのマクロを確認できます。マクロが無効な場合、Wiki レンダラーでは利用できません。使用する追加のマクロを展開する場合は、Wiki レンダラーで利用できるようにここで有効にされている必要があります。プラグインの記述に関する詳細については「マクロの記述」のドキュメントをご確認ください。

さらにヘルプが必要ですか?

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