WBS Gantt-Chart for Jira Cloud (以後、WBS Gantt-Chart) は、デフォルトでは開始日、終了日、親子関係や依存関係のリンクなどのデータはアプリ独自のフィールドに保管していましたが、2021年4月から、Jira のフィールドを利用するオプションが追加されました。

また、既に WBS Gantt-Chart を利用中の場合には、アプリ独自のデータを Jira のデータに変換することができます。変換後は通常の Jira のフィールドと同じように、対象のフィールドの値を REST API で取得したり、 JQL を利用して検索することができます。

こちらのドキュメントでは、Jira のフィールドを利用する方法と変換手順についてご案内します。

1 Jira の課題リンクを WBS Gantt-Chart で利用する
2 Jira のフィールドを WBS Gantt-Chart で利用する
3 WBS Gantt-Chart のデータを Jira のデータに変換する
- 3.1 データ変換に関する注意

Jira の課題リンクを WBS Gantt-Chart で利用する

WBS Gantt-Chart をインストールした時点で、新しい課題リンクが Jira 上に追加されます。

課題リンクは、歯車マーク > 課題 > 課題リンクで確認します。

（以下、インストール前とインストール後の比較）

インストール後

インストール前

作成される課題リンクの一覧

名前	Jira で作成される課題リンク名	外向きリンクの説明	内向きリンクの説明

名前	Jira で作成される課題リンク名	外向きリンクの説明	内向きリンクの説明
Hierarchy link	Hierarchy link (WBSGantt)	contains	is contained in
Start-Start	Start-to-Start link (WBSGantt)	Linked issue can start after this issue starts.	Cannot start until linked issue starts.
Start-Finish	Start-to-Finish link (WBSGantt)	Linked issue cannot finish until this issue starts.	Cannot finish until linked issue starts.
Finish-Start	Finish-to-Start link (WBSGantt)	Linked issue cannot start until this issue finishes.	Cannot start until linked issue finishes.
Finish-Finish	Finish-to-Finish link (WBSGantt)	Linked issue cannot finish until this issue finishes.	Cannot finish until linked issue is finished.

WBSガントチャートの課題リンクの設定変更は以下の手順で実施します。

Jira の課題リンク/フィールドを利用する場合、チーム管理対象 (旧次世代) プロジェクト内のアクセス制限のある課題で WBS Gantt-Chart を使用することはできません。
アクセス制限された課題とは、チーム管理対象プロジェクトにおいて、課題画面に(鍵アイコン) が表示されている閲覧制限された課題を指します。プロジェクトのアクセス権によって制限された課題という意味ではありません。

Jira 右上の歯車アイコン > アプリ > WBS GANTT-CHART > Issue を選択します。
右上の Edit を選択します。
Hierarchy link (親子関係リンク) と Dependency link (依存関係リンク) を設定します。
インストールの際に追加された課題リンクが選択されています。
Jira で利用している他の課題リンクを選択することもできます。

Jira のフィールドを WBS Gantt-Chart で利用する

次に、Fields (フィールド) を設定します。Use WBS Gantt-Chart unique data から、Use Jira field に変更して、フィールドを選択していきます。
新しく WBS Gantt-Chart 用のカスタムフィールドを作成したい場合は、Create new custom field (新しいカスタムフィールドを作成する) を選択します。設定が完了したら、Update を押下して設定完了です。

Jira の Start date (開始日)と期日を利用したい場合には、Start date field: Start date、Finish date field: 期日、を選択してください。下記の動画で、音声付きで説明しています。

下記が、 Create new custom field を選択することによって新たに作成される Jira のカスタムフィールドの一覧となります。

カスタムフィールド一覧

名前	Jira で作成されるカスタムフィールド名

名前	Jira で作成されるカスタムフィールド名
Start date field	Start date (WBS Gantt-Chart)
Finish date field	Finish date (WBS Gantt-Chart)
Baseline start date field	Baseline start date (WBS Gantt-Chart)
Baseline finish date field	Baseline finish date (WBS Gantt-Chart)
Percent done field	Percent done (WBS Gantt-Chart)
Units field	Units (WBS Gantt-Chart)
Manually schedule field	Manually scheduled (WBS Gantt-Chart)
Milestone field	Milestone (WBS Gantt-Chart)

上記のカスタムフィールドは、Jira 右上の歯車アイコン > 課題 > カスタムフィールド から確認できます。

WBS Gantt-Chart のデータを Jira のデータに変換する

既に、WBS Gantt-Chart を利用している場合、上記の設定に加えて、Convert Data (データ変換) をする必要があります。Convert Data をすることによって、WBS Gantt-Chart に保存されていた課題リンクやフィールドのデータが、Jira に転送されて保存されます。

まずは、ページ下部の 変換にかかる時間を見積もる を選択して、データ変換にかかる時間の見積もりを確認します。

時間の見積もりの確認後、下記の注意点を全て確認してください。

データ変換に関する注意

変換が始まるとキャンセルできません。
変換中、WBS Gantt-Chart には不完全なデータが表示されます。
WBS Gantt-Chart の閲覧、編集、リンク権限を付与する必要があります。実現するには、"atlassian-addons-project-access" プロジェクトロールに以下のものを付与します。
- 全ての権限スキームの "Browse Projects"、"Edit Issues"、"Link Issues" 権限
- 全ての課題セキュリティスキームの全ての課題レベル
上記の全てのフィールドはフィールド設定スキームやフィールドコンテクストで非表示にはできません。※通常これらのフィールドは特別な操作なしに非表示にはできません。
変換後、WBS Gantt-Chart 独自データは使うことができなくなります。

注意点を全て確認し、問題がなければページ下部の データを変換する を選択して、データ変換が終了するまでそのままお待ちください。