Jira の作業項目をリストで表示する
Confluence インスタンスが Jira に接続されている場合は、Jira 作業項目を検索して Confluence ページとリアルタイム文書のリストに表示できます。その後、表示をカスタマイズして、フィールドを追加、削除、並べ替えることができます。
キーワード、フィルター、または JQL (Jira クエリ言語) で検索内容を変更します。
If you’re an Atlassian Marketplace user, you may be looking for help on using the legacy Jira work item macro.
スマート リンク表示オプションを使用して 1 つの Jira 作業項目へのリンクを貼り付けることができます。
Jira 作業項目を挿入する
Confluence ページまたはリアルタイム文書を編集するか、新規に作成します。Jira 作業項目は次の 3 つの方法で挿入できます。
オプション 1
Select from the toolbar and select Jira work items
オプション 2
編集中に /jira
と入力して、[Jira 作業項目] を選択します。
オプション 3
Jira で作業項目を検索し、検索フィルターの URL を Confluence ページに貼り付けることもできます。
作業項目を検索する
Start inserting Jira work items by using filters with basic keyword search or with JQL.
JQL (Jira クエリ言語) を使用して Jira 作業項目を検索する方法についてはこちらをご確認ください。
既定で [ベーシック] が選択されています。このオプションでは、フィルターとキーワードを使用して作業項目を検索できます。
[JQL] を選択した場合は、クエリまたは検索キーワードを入力します。たとえば、
project = 'Starfish'
のようにします。作業項目の数だけを表示したい場合は [件数ビュー] を選択します。
[Insert work items (作業項目を挿入する)] を選択します。
フィールド列を管理する
Jira 作業項目がリストとして表示されたら、列をドラッグして移動できます。列アイコン を選択して、表示したい列を選択します。
作業項目を編集する
検索クエリを変更する必要がある場合は、リストの下部にある鉛筆アイコン を選択します。
リストの幅を変更するには、横にある展開アイコン を選択します。
Marketplace アプリのユーザーを対象とした従来の Jira マクロの使用
Jira のマクロを使用すると、以下のことができます。
JIRA クエリ言語 (JQL) 検索、フィルター、または URL に基づいてページ上に作業項目のリストを表示します。
1 つの作業項目を表示します。
作業項目の数を表示します。
Confluence を離れずに、新しい作業項目を作成し、ページまたは文書に作業項目を表示します。
従来の Jira マクロを使用する
従来の Jira マクロを追加するには、次の手順を実行します。
編集時には、ツールバーから を選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
従来の Jira マクロを編集するには、次の手順を実行します。
マクロのプレースホルダーを選択します。
[編集] アイコン を選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
中央揃え 、幅 、全幅 の各アイコンを使用して、一部のマクロの幅を調整することもできます。マクロを削除するには、ゴミ箱アイコン を選択します。
JIRA クエリ言語 (JQL) 検索経由で作業項目を表示する
マクロを使用し、Jira クエリ言語 (JQL) を使用した検索結果に基づいて、ページ上に作業項目の一覧を表示できます。
JQL は、SQL に似たシンプルなクエリ言語です。基本的な JQL のクエリは、フィールド、演算子 (= や > など)、1 つ以上の 値 または関数 で構成されています。
例:
次のクエリは、プロジェクト内のすべての作業項目を検索します。
project = "TEST"
次のクエリは、「CONF」プロジェクトの「documentation」コンポーネント内のすべての作業項目を検索します。
project = CONF and component = documentation
JQL 構文の詳細は、Jira ドキュメントの「高度な検索」をご参照ください。
JQL 検索に基づいて作業項目の一覧を表示するには、次の手順に従います。
Insert the Jira macro onto your Confluence page or live doc, as described above.
[検索] ボタンの横で、Jira インスタンスを選択します。
プロンプトが表示されたら、Jira インスタンスにログインします。
JQL クエリを検索ボックスに入力します。
[検索] を選択します。
If you want to customize the display, select Display options and adjust the columns and number of work items that will appear in your list of work items.
[挿入] を選択します。
JIRA URL 経由で作業項目を表示する
次の JIRA アプリケーション URL を JIRA 作業項目マクロに貼り付けることができます。Confluence は URL を直ちに JQL 検索へと変換します。
作業項目検索またはフィルターの URL。
1 つの作業項目の URL。
検索の XML ビューの URL。
自動変換: URL を直接 Confluence エディターに貼り付けることができます (マクロ ブラウザーを呼び出さずに)。Confluence は URL を JIRA 作業項目マクロに自動変換します。
1 つの作業項目または選択した作業項目の表示
1 つの JIRA 作業項目を表示するには、次の方法からいずれかを選択します。
Confluence ページに直接作業項目の URL を貼り付けます (マクロ ブラウザーを使用する必要はありません)。Confluence は JIRA 作業項目マクロへのリンクを自動変換します。
または、上記のように Jira 作業項目マクロをページに追加し、[最近の表示履歴] を選択して最近訪問した作業項目を表示します。作業項目を選択し、[挿入] を選択します。
または、上記のように Jira 作業項目マクロをページに追加し、マクロ ブラウザの検索ボックスに作業項目 URL を貼り付けます。
または、Jira 作業項目をページに追加し、上記のように JQL 経由でマクロ ブラウザで検索条件を定義して、マクロ ブラウザ内の検索結果で、作業項目の横にあるチェックボックスを選択します。
作業項目キーのみや、作業項目キーと概要を表示するよう選択できます。マクロ プレースホルダーをクリックして、「概要を表示」または「概要を非表示」を選択します。
検索結果から JIRA 作業項目のサブセットを表示します。
Jira 作業項目マクロをページまたはリアルタイム文書に追加します。
上記のように JQL 経由でマクロ ブラウザの検索条件を定義します。
マクロ ブラウザーで、検索結果の必要な作業項目の隣にあるチェック ボックスを選択します。
作業項目の数の表示
課題の一覧ではなく、検索で返される作業項目の数を表示するように選択できます。Jira 作業項目マクロは、Jira アプリケーション内の検索にリンク付けされた作業項目の数を表示します。
作業項目数を表示する方法。
Jira 作業項目マクロをページまたは文書に追加します。
上記のように JQL 経由でマクロ ブラウザの検索条件を定義します。
[表示オプション] を選択し、マクロ ブラウザで「表示オプション」の横にある [Total work item count (総作業項目数)] を選択します。
[挿入] を選択します。
新しい作業項目作成
Confluence ページまたはリアルタイム文書を編集しているときに、Jira で作業項目を作成し、Confluence エディターを離れることなく表示することができます。
作業項目を作成してページまたはリアルタイム文書に追加するには、次の手順を実行します。
上記のように、ページまたは文書に Jira 作業項目マクロを挿入します。
[Create new work item (新しい作業項目を作成する)] を選択します。
Jira インスタンス、プロジェクト、作業項目に関する情報を要求されるので、提供します。
[挿入] を選択します。
Confluence は作業項目を作成するよう JIRA アプリケーションにリクエストを送信した後、ページで新しく作成した作業項目を表示します。
制限事項
選択されたプロジェクトで作業項目を作成できない場合は、従来の Jira マクロに通知が表示されます。従来の Jira マクロでサポートされていない必須フィールド、フィールド設定またはその他のカスタマイズがプロジェクトにある場合に通知が表示されることがあります。このような場合は Jira アプリケーションで直接作業項目を作成する必要があります。
JIRA アプリケーションからの HTML レンダリング
Confluence から Jira へのアプリケーション リンクを設定すると、Jira の書式付きフィールドを Confluence に表示できます。この操作を行わない場合、従来の Jira マクロの出力内で、これらの書式付きフィールドはエスケープされます。これにより、信頼されない Jira インスタンスによって不正な HTML が提供される可能性を防ぐことができます。これに気付く可能性が最も高いフィールドは、説明フィールドです。
従来の Jira マクロの無効化
Atlassian Cloud ではアプリを無効化することはできません。アプリの利用を停止するには、アプリをアンインストールするか、アプリのサブスクライブを解除する必要があります。
この内容はお役に立ちましたか?