Jira 課題マクロ

マクロ

このペヌゞの内容

関連コンテンツ

お困りですか?

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

コミュニティに質問

Jira 課題マクロをペヌゞに远加するず、Jira の情報を衚瀺できたす。Jira ク゚リ蚀語 (JQL) ã®æ€œçŽ¢ã€ãƒ•ã‚£ãƒ«ã‚¿ãƒŒã€ãŸãŸã¯ URL に基づいお、単䞀の課題、課題の䞀芧、たたは課題数を衚瀺できたす。 

これは以䞋の堎合に適しおいたす。

  • チヌム ミヌティングやふりかえり
  • プロゞェクト ステヌタスの曎新
  • リリヌス ノヌトおよびカスタマヌずのやり取り
  • 組織内で Jira を普段䜿甚しおいないナヌザヌずの曎新内容の共有

このマクロを䜿甚するず、Jira Software や Jira Service Management を含め、接続枈みの Jira Server、Data Center、Cloud アプリケヌションの課題を衚瀺するこずができたす。 

スクリヌンショット: リリヌス前に解決しなければならない課題を衚瀺する Jira 課題マクロが含たれる、プロゞェクトのステヌタス ペヌゞ。 

Confluence ず Jira を接続する

このマクロを䜿甚するには、Confluence ず Jira アプリケヌションがアプリケヌション リンクを介しお接続されおいる必芁がありたす。ペヌゞを衚瀺しおいるナヌザヌは、Jira サむトで公開されおいるアクセス可胜な課題を芋るこずができたす。Jira サむトに衚瀺制限が蚭定されおいる堎合 (ナヌザヌに課題の衚瀺暩限が必芁な堎合)、制限付き課題を衚瀺する前に認蚌が必芁ずなりたす。

詳现に぀いおは、「Jira アプリケヌションず Confluence を䞀緒に䜿甚する」を参照しおください。 

このマクロをペヌゞに远加する

Jira マクロをペヌゞに远加するには、次の手順を実行したす。

  1. ゚ディタのツヌルバヌで、[挿入] > [その他のマクロ] を遞択したす。
  2. [開発] カテゎリから [Jira] ã‚’遞択したす。
  3. フィルタヌを入力するか、Jira 課題を怜玢したす。
  4. [挿入] をクリックしたす。 

その埌、ペヌゞを公開するずマクロの動䜜を確認できたす。 

スクリヌンショット: 課題の䞀芧を衚瀺するための Jira 課題マクロの蚭定。

JIRA ク゚リ蚀語 (JQL) 怜玢経由で課題を衚瀺する

たた、マクロを䜿甚し、JIRA Query Language (JQL) を䜿甚した怜玢結果に基づいお、ペヌゞ䞊で課題の衚を衚瀺するこずもできたす。

JQL は、SQL に䌌たシンプルなク゚リ蚀語です。基本的な JQL のク゚リは、フィヌルド、挔算子 (= や > など)、1 ぀以䞊の 倀 たたは関数 で構成されおいたす。

䟋:

  • 次のク゚リは、 プロゞェクト内のすべおの課題を怜玢したす。

    project = "TEST"

  • 次のク゚リは、'CONF' プロゞェクトの 'documentation' コンポヌネント内のすべおの課題を怜玢したす。

    project = CONF and component = documentation

JQL 構文の詳现に぀いおは、JIRA Software ドキュメントの「詳现怜玢」を参照しおください。

JQL 怜玢に基づいお課題のテヌブルを衚瀺するには:

  1. 䞊蚘のように、Confluence ペヌゞに JIRA 課題マクロを挿入したす。
  2. 怜玢ボタンの暪にある JIRA サヌバヌを遞択したす。
  3. プロンプトが衚瀺されたら、JIRA サヌバヌにログむンしたす。
  4. JQL ク゚リを怜玢ボックスに入力したす。
  5. 怜玢を遞択したす。
  6. ディスプレむをカスタマむズする堎合は、衚瀺オプションを遞択し、課題の衚に衚瀺される列ず課題数を調節したす。
  7. [挿入] を遞択したす。

スクリヌンショット JIRA 課題マクロ ブラりザヌの衚瀺オプション。

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 課題のサブセットを衚瀺したす。

  1. ペヌゞ JIRA 課題マクロを远加したす。
  2. JQL 経由でマクロ ブラりザヌの怜玢条件を定矩したす (䞊蚘のずおり)。
  3. マクロ ブラりザヌで、怜玢結果の必芁な課題の隣にあるチェックボックスを遞択したす。

スクリヌンショット: 衚瀺する課題のサブセットを遞択する

課題数を衚瀺する

課題の衚ではなく、怜玢で返される課題の数を衚瀺するよう遞択できたす。JIRA 課題マクロは、JIRA アプリケヌションの怜玢にリンク付けされた課題の数を衚瀺したす。

スクリヌンショット: 課題数を衚瀺する Jira 課題マクロ。


課題カりントを衚瀺するには:

  1. JIRA 課題マクロをペヌゞに远加したす。
  2. JQL 経由でマクロ ブラりザヌの怜玢条件を定矩したす (䞊蚘のずおり)。
  3. 衚瀺オプション を遞択し、マクロブラりザで [衚瀺オプション] の暪にある 合蚈発行数 を遞択したす。
  4. [挿入] を遞択したす。

新しい課題を䜜成する 

Confluence ペヌゞで線集を行いながら、Confluence ゚ディタヌを開いたたた JIRA で課題を䜜成し、Confluence ペヌゞにその課題を衚瀺させるこずができたす。

課題を䜜成しおペヌゞに远加するには:

  1. 䞊蚘のように、ペヌゞに JIRA 課題マクロを挿入したす。
  2. 新しい課題䜜成 ã‚’遞択したす。
  3. 芁求されたら JIRA サヌバヌ、プロゞェクト、課題に関する情報を提䟛したす。
  4. [挿入] を遞択したす。

Confluence は課題を䜜成するよう JIRA アプリケヌションにリク゚ストを送信した埌、ペヌゞで新しく䜜成した課題を衚瀺したす。

制限事項

JIRA 課題マクロは遞択されたプロゞェクトで課題を䜜成できない堎合、通知したす。これは、プロゞェクトに JIRA 課題マクロでサポヌトされおいないフィヌルド、フィヌルド蚭定およびその他のカスタマむズがあるこずが原因の可胜性がありたす。この状況では、JIRA アプリケヌションで盎接課題を䜜成する必芁がありたす。

制限付き課題を衚瀺するアプリケヌションリンクの蚭定

このマクロを䜿甚するには、Confluence ず Jira のサむトがアプリケヌション リンクを介しお接続されおいる必芁がありたす。

Jira が匿名ナヌザヌに察しお課題の閲芧を蚱可しおいる堎合、アプリケヌション リンクを蚭定する必芁がありたすが、Jira アプリケヌションず Confluence の間で倖向きおよび内向きの認蚌を蚭定する必芁はありたせん。Confluence ペヌゞを衚瀺しおいるナヌザヌは、公開されおいる課題を芋るこずができたす。

Jira サむトに衚瀺制限が蚭定されおいる堎合や、䞀郚のプロゞェクトたたは課題で衚瀺を特定の人物に制限しおいる堎合、ナヌザヌは制限付き課題を衚瀺する前にログむンず承認を行うよう求められたす。

JIRA アプリケヌションからの HTML レンダリング

Conflucnce から JIRA ぞのアプリケヌション リンクを蚭定するず、JIRA の曞匏付きフィヌルドを Confluence に衚瀺するこずができたす。この操䜜を行わない堎合、JIRA 課題マクロの出力内で、これらの曞匏付きフィヌルドぱスケヌプされたす。これにより、信頌されない JIRA サヌバヌによる䞍正な HTML の可胜性を防ぐこずができたす。これに気付く可胜性が最も高いフィヌルドは、説明フィヌルドです。

この䟋では、JIRA での説明列の衚瀺方法を瀺したす。

説明

これは

  • 課題の
  • 説明です

JIRA ず Confluence の間のアプリケヌション リンクがない堎合、JIRA 課題マクロには次のように説明が衚瀺されたす。

説明

<p>これは課題の<ul><li>説明</li><li>です</li></ul></p>

JIRA 課題マクロの無効化

"Jira Macros" ず呌ばれるシステム アプリ (プラグむン) により提䟛される機胜です。ご䜿甚のサむトでマクロを䜿甚できないようにするために、アプリを無効にするこずもできたす。「アプリの無効化ず有効化」を参照しおください。

泚意

HTTPS: Confluence サヌバヌが Jira SSL 蚌明曞を受け入れるように蚭定されおいる堎合、Jira 課題マクロは SSL で実行䞭の Jira アプリケヌションにアクセスできたす。「SSL 経由で LDAP、 Jira アプリケヌション、たたは他のサヌビスに接続する」を参照しおください。

フィヌルドの名前を匕甚笊で囲たずに䜿甚するず、カスタム フィヌルドをテヌブルの列ずしお簡単に远加できたす。以前のバヌゞョンのマクロでは、カスタム フィヌルド ID (䟋: customfield_10100.) を䜿甚する必芁がありたした。

このマクロを远加するその他の方法

手入力でこのマクロを远加する

「{」ず入力しおからマクロ名の入力を開始するず、マクロの䞀芧が衚瀺されたす。

Wiki マヌクアップを䜿甚しおこのマクロを远加する

これは、゚ディタ倖郚 (スペヌスのサむドバヌ、ヘッダヌ、フッタヌのカスタム コンテンツなど) でマクロを远加する堎合に䟿利です。

マクロ名: jiraissues

マクロ本文: なし。

この䟋では、Jira フィルタヌを䜿甚したす。 

{jiraissues:anonymous=true|url=https://jira.atlassian.com/issues/?filter=41225}

マクロ ブラりザヌ経由で䜿甚できない倚数の付加パラメヌタヌは、ストレヌゞ圢匏や Wiki マヌクアップで利甚可胜です。

付加パラメヌタを参照する...

パラメヌタヌ名

必須

既定

パラメヌタヌの説明ず指定可胜な倀

anonymous

いいえ

false

このパラメヌタヌが 'true' に蚭定されおいる堎合、JIRA アプリケヌションは閲芧制限のない課題のみを返したす。぀たり、匿名の閲芧者が衚瀺可胜な課題です。このパラメヌタヌが省略たたは 'false' に蚭定されおいる堎合、結果は管理者が JIRA アプリケヌションず Confluence の間の通信をどのように蚭定したかによっお異なりたす。デフォルトでは、Confluenceは、ナヌザヌが衚瀺する暩限を持぀問題のみを衚瀺したす。

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

baseurl

いいえ

'url' パラメヌタヌの倀

'baseurl'、ヘッダヌ内のリスクを指定し、JIRA アプリケヌションを瀺すずパラメヌタヌの倀ではなくこのベヌス URL が䜿甚されたす。これは、他のナヌザヌが䜿甚しおいる URL ずは異なる URL で Confluence が JIRA に接続しおいる堎合に䟿利です。

columns

いいえ

既定では、次の列が衚瀺されたす。

  • type
  • 鍵 (キヌ)
  • 芁玄
  • 担圓者
  • reporter
  • 優先床
  • ステヌタス
  • resolution
  • created
  • updated
  • due

セミコロン (;) で区切られた JIRA 列のリスト。カスタム列を含め、JIRA アプリケヌションで認識できる倚くの列を含めるこずができたす。

'work ratio' や 'time to resolution' など、JIRA による蚈算が必芁な䞀郚の列は、Confluence で衚瀺するこずはできたせん。

count

いいえ

false

このパラメヌタヌが 'true' に蚭定されおいる堎合、課題リストには JIRA 課題の数が衚瀺されたす。カりントは JIRA サむトにリンクされたす。

cache

いいえ

on

マクロは、JIRA ク゚リの結果の課題のキャッシュを保持したす。'cache' パラメヌタヌが 'off' に蚭定されおいる堎合、キャッシュの関連郚分は、マクロが再床ロヌドされるたびにクリアされたす。(倀 'false' も䜿甚でき、 ず同じ効果がありたす。)

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

height

いいえ

480 (レンダリング モヌドが dynamic の堎合)

課題を衚瀺するテヌブルの高さ (ピクセル単䜍)。
課題を衚瀺するテヌブルの高さこの高さの仕様は、次の状況では無芖されたす。

  • 'renderMode' パラメヌタヌ (以䞋を参照) が 'static' に蚭定されおいる堎合。
  • 課題が PDF / Word ドキュメント、メヌル メッセヌゞ、たたは RSS フィヌドで衚瀺されおいる堎合。

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

renderMode

いいえ

static

倀を「dynamic (動的)」にするず、JIRA 課題マクロは、ナヌザヌが次のように操䜜できるむンタラクティブ ディスプレむを提䟛したす。

  • 列ヘッダヌをクリックしお出力を䞊べ替えたす。
  • 列をドラッグし、別の順序にドロップしたす。
  • ディスプレむから列を䞀時的に削陀したす。
  • 応答時間を短瞮するため、䞀床に課題のペヌゞを衚瀺したす。

'static' の倀は、ダむナミック衚瀺機胜を無効化したす。

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

title

いいえ

JIRA 課題

このパラメヌタヌを䜿甚しお、課題テヌブルの䞀番䞊にあるタむトル テキストをカスタマむズできたす。䟋えば、タむトルを「Bugs-to-fix (修正するバグ)」に蚭定するず、既定の「JIRA Issues (JIRA 課題)」テキストが眮き換えられたす。衚瀺されおいる課題リストにより倚くの内容を提䟛する堎合に䟿利です。

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

url

はい

なし

遞択した課題の XML ビュヌの URL。

泚: "url" パラメヌタヌの URL に tempMax 匕数が含たれおいない堎合、tempMax の既定倀は 500 ずなりたす。このため、お䜿いの Jira がバヌゞョン 3.12 以前の堎合、Jira 課題マクロは最倧 500 件の課題を返したす。Jira Server のバヌゞョンが 3.13 以降の堎合、500 の倀は、Jira 課題マクロはペヌゞあたり最倧 500 件の課題を返すこずを意味したす。

width

いいえ

100%

課題を衚瀺するテヌブルの幅。パヌセント () たたはピクセル (px) で入力できたす。

泚: このパラメヌタヌはペヌゞのストレヌゞ圢匏を線集するこずで、Wiki マヌクアップ経由でマクロを挿入した堎合にのみ䜿甚できたす。マクロ ブラりザはこのパラメヌタヌを提䟛したせん。

tip/resting Created with Sketch.

Confluence ず Jira を䜿いこなす

Atlassian Marketplace の次のアプリを䜿甚するこずで、Jira 課題のさらに高床な衚瀺を実珟できたす。 

  • Issue Macro from Jira to Confluence: 1 ぀の Jira 課題レポヌトの倖芳をカスタマむズしたり、優れた圢匏のフィルタヌ レポヌトを生成
  • Issues Forms for Confluence: Confluence ペヌゞで Jira 課題 / チケットを䜜成および衚瀺
最終曎新日: 2020 幎 12 月 14 日

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

はい
いいえ
この蚘事に぀いおのフィヌドバックを送信する

関連コンテンツ

Powered by Confluence and Scroll Viewport.