移行ガイド
With the future release of Portfolio for Jira 3.0, Portfolio for Jira will no longer support the use of classic plans. When we release this version, you will no longer be able to access or update any of your classic plans. We recommend to start planning your migration to the new experience.
問題や懸念事項がある場合は、portfoliofeedback@atlassian.com までお問い合わせください。
In this section, you will learn how to migrate from a Portfolio for Jira classic plan to the new planning experience. Depending on the size of your plan, this can be quite a lengthy, involved process, so this guide is intended to provide simple step-by-step instructions to help migrate your data.
How do you know you're using a classic plan?
The easiest way to determine whether or not you're using a classic plan is based on the positioning of the timeline. Classic plans have the timeline positioned at the bottom of your planning workspace.
クラシック プランの例
Portfolio for Jira 2.0 plans, which are also known as live plans, have the timeline positioned at the top.
Sample 2.0 live plan
In the new planning experience, the timeline is now positioned at the right of the scope section. This provides a more intuitive experience, where you can view your roadmap directly beside the data that corresponds to it.
Sample plan in the new experience
Why should I migrate to the new planning experience?
The new planning experience offers a new way to visualize, groom, and communicate your roadmaps. Today, it includes the following features and more:
- ロードマップを強化するデータを簡単に確認できる、プラン レイアウトの完全な更新
- 配色とグループ化オプションが強化された、新しいドラッグ & ドロップ スケジューリング機能
- 効果的な早期解決のため、競合ブロッカーを瞬時に浮かび上がらせる、改善された依存関係追跡
Plans in the new experience are regularly being updated with more great features, with every version we release. Keep an eye on our release notes, to know what we're releasing with each version in the future.
はじめる前に
To migrate to the new planning experience, you'll first need to migrate your classic plan data into a Portfolio for Jira live plan. Once you have your live plan ready, you can then easily enable the new experience in that plan.
This is necessary because the new planning experience is only available as an early access feature, and can only be enabled through an existing live plan.
In the future, when we make the new experience the default interface in all plans, classic plans will no longer be accessible.
移行前に考慮すべきこと
To migrate to the new experience, you'll need to be using Portfolio for Jira version 2.21 or later. This is needed to enable the early access features of the new experience.
After migrating to the new experience, you'll need to reconfigure the following items for each new plan:
| イニシアチブ関係 | Initiative ↔ epic relationships will not be automatically set when migrating to the new experience. Issue links are created between epics and initiatives in the Jira ticket itself, but you'll need to reset the initiative for all your epics. |
| チーム データ | Teams, team members, availabilities, and velocities will not be migrated over to the new experience. You'll need to create the teams, add members, and configure other team settings as needed. Also, individual availabilities are no longer supported in the new experience. |
| 設定を計画する | Configurations of your plan, such as default estimates, will not carry over during your migration. They will need to be reconfigured once your migration to the new experience is complete. |
| スプリントの割り当て状況 | Sprint assignment works a bit differently in the new experience. You first need to assign a team to each board issue source in your plan. The selected team will then be assigned to the sprints of each corresponding board. If you have sprints in your classic plans that you want to be available when you migrate to the new experience, then you'll need to create these sprints in Jira. You then need to assign teams to the corresponding board issue sources. The selected teams will then be assigned to the board sprints accordingly. The advantage of sprints in the new experience is that these are the actual sprints in Jira. This way, you can directly plan and groom your actual sprints in Portfolio for Jira. |
The following items will not be migrated and cannot be reconfigured in the new experience:
| 一番早い開始日 | We're simplifying the experience of scheduling issues by using only one type of date — target dates. This is why earliest start dates are no longer available in the new experience. You can still use other custom date fields that you may have configured before enabling the new experience. However, you'll first need to add these custom fields to your plan. |
スケジュールされた開始日および終了日 | The calculated dates from classic plans won't be directly accessible in the new experience. The dates will need to be reproduced by either:
Note that the date fields used in the new experience are called target dates, and these can be accessed and updated in both Jira and Portfolio for Jira. |
| ステージとスキル | Stages and skills are not supported in the new experience for the following reasons:
|
| テーマ | Themes are no longer available in the new planning experience. Instead, we're replicating much of its value by providing flexible coloring options for labels and other custom fields. |
| 将来のスプリント | At this stage, we're not considering implementing the functionality of future sprints in the new experience. |
Why should you migrate?
The new planning experience offers multiple advantages over classic plans. Most importantly, however, is the fact that the new planning experience relies on real-time, dynamic data directly from Jira. Meanwhile, in classic plans, data is stored independently.
Rather than having to import data from Jira to a classic plan, the new experience lets you define projects, boards, or filters as issue sources. With issue sources configured, real-time data is automatically surfaced in the new experience, and you can quickly save any changes you make in your plan back to Jira.
How to migrate from a classic plan to the new planning experience
The following steps are written with the assumption that the data in your classic plans are not linked to Jira. So, if you're already further along the process, jump to the relevant step:
- プロジェクトまたはボードを作成して、クラシック プランの課題のコレクションを保存する
- プロジェクトごとにリンクされた課題を作成する
- リリースを作成、リンクしてバージョンを修正する (オプション)
- 追加データを適用する
- Create a 2.0 live plan
- Enable the new planning experience
- Reconfigure missing data
1. Create projects/boards to store collections of classic plans issues
まず、課題を別々のプロジェクトにグループ化する方法を選択する必要があります。リリース ストリームごとに課題をグループ化するのが理想ですが、チーム別にグループ化することもできます。
a) 課題グループごとに新しいプロジェクトを作成します (たとえば、リリース ストリームごとに 1 つのプロジェクト)。
b) In the project creation dialog, create a Scrum or Kanban board, depending on how your teams work. Scrum boards are the most recommended issue source because Portfolio for Jira can make use of the velocity of past sprints to determine team velocity.
c) イニシアチブを使用している場合は、これらすべてのイニシアチブを保存するカンバン プロジェクトを作成することをお勧めします。このプロジェクトの設定で、他のすべての課題タイプを削除し、イニシアチブの新しい課題タイプを作成します。
New planning experience - Infinite hierarchy levels
This is also a good time to create the initiative level of hierarchy. You can create infinite levels of hierarchy in the new planning experience. However, it only goes as high as the epic level by default.
2. Create linked issues for each project
プロジェクトを作成したら、従来の計画の課題から Jira で課題事項を作成してリンクします。このプロセスでは、すべての課題の Jira バージョンが作成され、Jira プロジェクトに保存されます。
Before you complete the following steps, make sure to enable the Issue Link column in your classic plan.
課題リンク列を有効にしたクラシック プランの例
a) イニシアチブを追加する
- If you're using initiatives, start off by creating and linking issues for these initiatives. Set the view to Initiatives, and for the first issue, click the Issue Link drop-down > Create and link new issues.
- ダイアログで、イニシアチブ用に作成したプロジェクトを選択します。[Create issues for all related items (すべての関連項目の課題を作成する)] チェックボックスをオフにし (このイニシアチブ ステップでのみ行う必要があります)、[Create and link issues (課題を作成してリンクする)] をクリックします。
- イニシアチブごとにこれを行います。
b) エピックとストーリーを追加する
すべてのイニシアチブをリンクされた問題として Jira に保存したら、先に進んで、すべてのエピックとストーリーに同じ手順を行います。
- 従来のプランで、以前に決めたグループ化 (リリース ストリームなど ) でフィルタリングします。
- フィルターが適用されたスコープ内の各エピックについて、[課題リンク] ドロップダウン > [新しいリンクされた課題の作成] の順にクリックします。このフィルターされたグループに対して作成した関連プロジェクトを選択してください。
- Create issues for all related items (すべての関連項目の課題を作成する) チェックボックスをオンにすると、エピックとそのすべてのストーリーが Jira チケットにリンクされます。すでに別のプロジェクトに保存されているため、どのイニシアチブも選択されていないことを確認します。
- 各プロジェクト グループ化にこのプロセスを行います。完了したら、すべての問題を確認し、課題リンクがあることを確認します。
- プランに多くのイニシアチブやエピックがある場合は、しばらく時間がかかります。
- 課題リンクで正しいプロジェクトが選択されていることを確認してください。間違ったプロジェクトで課題を作成した場合は、それらの課題をプロジェクトから手動で削除して、正しく設定する必要があります。
3.リリースを作成、リンクしてバージョンを修正する (オプション)
この手順は、すべてのリリースを新しいプランに転送する場合に推奨されます。
You can create linked fix versions in each of your projects from your classic plan. In the Releases tab, for each release, hover over the release name until a drop-down appears. Click the drop-down > Create and link new versions. In the dialog, select the relevant project, and click Create and link versions.
You can also link your classic plan releases with existing fix Versions you may already have in your projects. To link a release with an existing fix Version, go to the Releases tab in your classic plan. Expand the streams and use the Version Link drop-down, to associate each release to the corresponding fix versions you created in the Jira projects.
Example: Each stream maps to a project, and each release stream maps to the fix versions in the linked project.
バージョン リンクを使用したクラシック プランの例
4.追加データを適用する
a) すべての課題とリリースがリンクされたら、Jira の課題とバージョンに追加データを適用する必要があります。手動で設定したデータのみが適用されます。つまり、計算されたデータは適用されません。
次のデータが適用されます。
- 課題データ
担当者 (課題に対してチーム メンバーが 1 人設定されている場合)
- 修正バージョン (対応する Jira チケットに適用されます)
- タスク期限
- リリース データ:
- 固定開始日
- 固定終了日
b) プラン > [Apply updates to project/s (更新をプロジェクトに適用)] をクリックします。
c) 課題フィールド セクションで [見積もり] チェックボックスをオフにします。
d) [更新] をクリックします。
見積りを無効にする理由は何ですか?
Estimates are already applied when you created and linked the issues. Disabling this will prevent epics with aggregated estimates from having that value applied to the Jira issue. If this were enabled, this would double up the estimates of your epics when you create your plan in the new experience.
Jira 課題の見積りが最新ではない場合、この手順で見積りの更新を有効にし、適用することをお勧めします。次に、この移行プロセスの最後のステップに進んだら、子を持つエピックからその追加の見積りを削除します。
5. Create a 2.0 live plan
At this stage, you should have all your issues and releases with their associated data stored as issues in Jira. Each of your issue and release groupings would already have their own project and board, which we can now use as the issue sources for your plans in the new experience.
- In Jira, go to Portfolio (in header) > Create. The 'Create' page will be displayed.
- [プラン] > [作成] を選択します。
- ウィザードのステップ 1 で、プランの名前を追加します。
- ステップ 2 では、従来のプラン課題用に作成したボードをすべて選択します。
- ステップ 3 で、プランに取り込むすべてのリリースを選択します。
ステップ 4 では、各課題ソースが自動的に関連チームを作成します。チームに合わせてこれらを設定してください。
これは、イニシアチブ プロジェクトには関連付けられたチームがあることも意味します。そのため、このチームを削除することをお勧めします。
- In step 5, confirm the scope of issues in the new plan, and then click Done.
6. Enable the new planning experience
Now that you've created a 2.0 live plan, you can easily switch over to the new planning experience, which is available as an early access feature.
- Go to your plan via Portfolio (in header) > View Portfolio > click your plan.
- Click more (
) > Try the new planning experience. The plan configuration page will display. - Click New experience.
- Click Enable new experience to switch on the new interface for your plan.
See Setting up the new experience for more details.
7. Reconfigure missing data
移行プロセス中に一部のデータを見逃した可能性があります。前の設定を再構成するには、次のチェックリストに移動します。
- イニシアチブ ↔ エピック関係
- テーマ: テーマの使用方法を置き換えるために、プランの課題をラベルで配色ことをお勧めします。ラベルによる課題の配色によって、テーマと同様の視覚的価値が得られます。
- チーム データ: チームとチーム メンバー
- プランの構成
- Sprint assignment: Only sprints that exist in Jira are assignable. Make sure to create sprints in your Scrum backlog, so they're assignable from Portfolio.
Note that team members are no longer available in the new experience. Instead, we're now using assignees, which can be directly set in either Jira or Portfolio for Jira.
お困りですか?
If you're having problems or need additional help migrating from classic plans, please visit our Support section and create a support request.