クラりド
Data Center 6.4
バヌゞョン

Jira 課題マクロ

マクロ

このペヌゞの内容

関連コンテンツ

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

お困りですか?

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

コミュニティに質問

Confluence サむトが JIRA アプリケヌションに接続されおいる堎合、Confluence ペヌゞ䞊のグラフずしお JIRA 課題を衚瀺できたす。Confluence を、JIRA Software や JIRA Service Desk などの JIRA アプリケヌションぞ接続できたす。 

このマクロを䜿甚するには、Confluence および JIRA アプリケヌションがアプリケヌション リンクを介しお接続されおいる必芁がありたす。ペヌゞを衚瀺しおいるナヌザヌは、JIRA サむトの公開されおいる課題を芋るこずができたす。JIRA サむトに衚瀺制限が蚭定されおいる堎合 (したがっお、ナヌザヌには課題を衚瀺する暩限が必芁)、制限付き課題を衚瀺する前に認蚌が必芁です。制限付き JIRA 課題に関する詳现は、䞋蚘をご芧ください。

JIRA 課題マクロでできるこず

JIRA の課題マクロでできるこず :

  • JIRA ク゚リ蚀語 (JQL) 怜玢、フィルタヌ、たたは URL に基づいおペヌゞ䞊に課題のリストを衚瀺したす。
  • 1 ぀の課題を衚瀺したす。
  • 課題数を衚瀺したす。
  • Confluence を終了せずにペヌゞ䞊で新しい課題を䜜成し、課題を衚瀺したす。

JIRA 課題マクロの远加ず曎新 - 抂芁

Confluence ペヌゞ䞊のマクロを䜿甚するためのクむックガむド:

  1. From the editor toolbar, choose (Insert) > Other Macros
  2. 察象のマクロを芋぀けお、遞択したす。

Speed it up with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.

既存のマクロを線集する方法: マクロのプレヌスホルダをクリックしお、[線集] を遞択したす。これによりマクロの詳现を開き、マクロのパラメヌタヌを線集できたす。

 

スクリヌンショット: Confluence ペヌゞでの 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 アプリケヌションの怜玢にリンク付けされた課題の数を衚瀺したす。

スクリヌンショット: Confluence ペヌゞで課題数を衚瀺する 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 課題マクロの無効化

The functionality is provided by an add-on (plugin) called 'JIRA Macros'. To make the macro unavailable on your site, you can disable the add-on. See Disabling and enabling apps.

泚意

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

Custom fields can be added as columns to the table simply by using the name of the field with no quotes. Earlier versions of the macro required you to use the custom field id, e.g. 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。

Note: If the URL in the 'url' parameter does not contain a tempMax argument, then the value of tempMax will default to 500. If your JIRA server is version 3.12 or earlier, this means that the JIRA Issues macro will return a maximum of 500 issues. If your JIRA server is version 3.13 or later, a value of 500 means that the JIRA Issues macro will return a maximum of 500 issues per page.

width

いいえ

100%

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

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

最終曎新日 2017 幎 9 月 5 日

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

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

関連コンテンツ

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