従来のリンク修正方法: Cloud への移行に成功後、新しい Cloud インスタンスで URL リンクが壊れている
プラットフォームの注記: Cloud のみ - This article only applies to Atlassian apps on the クラウド プラットフォーム上のアトラシアン製品にのみ適用されます。
要約
Jira Server および Confluence Server を Atlassian Cloud に移行したあと、または Atlassian Cloud から Atlassian Cloud に移行したあと、URL リンクがソース URL を引き続き参照しているため、URL リンクが破損して見える
診断
このページは、大部分で古い情報となっています。
このページでは、移行後にリンク修正を依頼する従来の方法について説明しています。このページではなく、「Server から Cloud への移行に成功後、新しい Cloud インスタンスで URL リンクが壊れている」を使用してください。
サポート チームから案内された場合や、メインの手順がうまくいかなかった場合はこちらの手順に従ってください。
原因
Current migration tooling does not handle fixing these links natively, nor does it address issues such as missing images or inconsistencies in link behavior, particularly in pages using the legacy editor. As a result, a post-migration task is needed to update these references in bulk. Some content objects don't retain the same ID values as they had on the source (for example: Page IDs for Confluence). The Atlassian Migration Support team can provide assistance for running these link fixes as part of post-migration tasks.
壊れたマクロ
壊れた Jira マクロは、このページで説明されているリンクの種類とは異なります。壊れたマクロを解決するには、対象サイトの URL (<サイト名>.atlassian.net/wiki/admin/jim-validator/view.action) から Jira マクロの修復ツールを実行してください。
Jira マクロの修復ツールに関する詳細は、「Jira マクロの修復を利用する」を参照してください。それでも問題が解決しない場合には、移行サポート チームにお問い合わせください。
ソリューション
これは時間のかかる手動タスクであるため、当社ではリンクの修正作業は本番移行後にお客様のサポート地域の営業時間内で実行しています。
移行サポートで必要な更新を行うには、次のようないくつかの必須情報を集める必要があります。
Jira インスタンスの以前のベース URL
Jira Server ID:
「Jira システム管理者」グローバル権限を持つユーザーとしてログインします。
上部のナビゲーション バーから [管理者] > [システム] を選択します。左側のメニューで [システム情報] を選択し、システム情報ページを開きます。
Server ID は、そのページの [Jira 情報] セクションに表示されています。
Confluence インスタンスの以前のベース URL
Confluence Server ID:
Confluence のシステム管理者としてログインします。
設定アイコンをクリックし、[一般設定] を選択します。
[ライセンス詳細] リンク ([管理] の下) をクリックします。
Server ID は、[Server ID] フィールドに記載されています。
Server から Cloud への移行のみ: 次のデータベース クエリで取得できる、Confluence Server のページ ID のマッピングを生成します。
PostgreSQL - MySQL - Microsoft SQL Server
SELECT c.title,
c.contentid,
s.spacekey
FROM content c
JOIN spaces s ON s.spaceid=c.spaceid
WHERE c.contenttype='PAGE'
AND c.prevver IS NULL
AND c.content_status='current'
AND c.title !=''
AND c.title IS NOT NULL
ORDER BY s.spacekey, c.title;ORACLE
SELECT C.TITLE,
C.CONTENTID,
S.SPACEKEY
FROM CONTENT C
JOIN SPACES S ON (S.SPACEID = C.SPACEID)
WHERE C.CONTENTTYPE='PAGE'
AND C.PREVVER IS NULL
AND C.CONTENT_STATUS = 'current'
AND LENGTH (C.TITLE) > 0;SQL 結果をコンマ区切りの csv ファイルで提供してください。
Confluence のソース インスタンスについて上述のメタデータを提供していただくことで、移行サポート チームは、古いコンテンツ ID と Atlassian Cloud の対応する新しい ID との 1:1 のマッピングを作成し、一括で置き換えを行えるようになります。
CSV 作成の書式詳細
CSV を作成する際は、次のことを確認してください。
エンコーディングは UTF-8
これはテキスト エディタを使って確認できます。
スクリプトは次のことに依存しています。
コンマ「,」を区切り文字として使用
CSV で、タイトルにコンマが含まれている場合、そのタイトルは引用符で囲んでください。
タイトル内の引用符:
タイトル列にもタイトル内の単語の引用符が含まれている場合には、それらをエスケープしてください。テキストエディターの拡張機能または Google Sheets を使用して、列が CSV に沿っているかを確認してください。
改行シーケンス:
正しい改行シーケンスは LF です。ファイルが CRLF に設定されている場合は、テキスト エディタを使用してこれを確認し、LF に変更してください。
アトラシアン サポートで解決可能なリンクの種類一覧
サポート対象
サポート チームによる現在の修正では、以下に挙げられているリンク タイプのみが更新されます。Confluence ページのページ ID がリンクに含まれている場合は、Atlassian Cloud の現在のページに更新されます。リストにないリンク パターンや、Jira または Confluence エンティティの ID 値を含むリンクは更新されません。以下の表は、ID 値が含まれていないか、ページ ID 値しか含まれていないためにサポート対象となるリンクの例を示しています。
リンクのタイプ | 場所 | 例 (該当する場合) |
Confluence 上の、ページ ID を参照している Confluence リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/pages/view.action?pageId=123456 |
Confluence 上の、ページタイトル を参照している Confluence リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/wiki/spaces/ACME/pages/123456/Hello+World |
Confluence 上の、ページ タイトル ("Pretty") 形式の Confluence リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/display/SPACEKEY/Page+Title |
Confluence 上の、Confluence のタイニー URL | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/x/a4OcE |
Confluence 上の、Confluence 添付ファイル リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/download/attachments/123456 |
Confluence 上の、ラベルへの Confluence リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/label/ABC/text |
Confluence 上の Jira 課題リンク | Confluence - 現在のページ (ボディ) | https://www.acme-jira.com/browse/ACME-1 https://www.acme-jira.com/projects/ACME/issue/ACME-1 https://www.acme-jira.com/issues/ACME |
Confluence 上の、ページ ID を参照している Confluence ページ編集リンク | Confluence - 現在のページ (ボディ) | https://confluence.acmecorp.com/pages/editpage.action?pageId=123456 |
Jira 課題上の、ページ ID を参照する Confluence リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/pages/view.action?pageId=123456 |
Jira 課題上の、ページ タイトルを参照する Confluence リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/wiki/spaces/ACME/pages/123456/Hello+World |
リモート リンク経由で Jira 課題にリンクされている Confluence ページ | Jira 課題 - [Confluence ページ] パネルの [メンション:] | https://confluence.acmecorp.com/pages/view.action?pageId=123456 |
Jira 課題上の、ページ タイトル ("Pretty") 形式の Confluence リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/display/SPACEKEY/Page+Title |
Jira 課題上の、Confluence のタイニー URL | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/x/a4OcE |
Jira 課題上の、Jira 課題リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://www.acme-jira.com/browse/ACME-1 https://www.acme-jira.com/projects/ACME/issue/ACME-1 https://www.acme-jira.com/issues/ACME |
Jira 上の、ラベルへの Confluence リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/label/ABC/text |
Jira 上の、ページ ID を参照している Confluence ページ編集リンク | Jira 課題 - 説明 Jira 課題 - コメント Jira 課題 - カスタム フィールド (テキスト フィールド) | https://confluence.acmecorp.com/pages/editpage.action?pageId=123456 |
サポート対象外
上記のサポート対象の一覧に記載のないリンク タイプまたは場所はすべてサポート対象外です。また、過去のページ、下書き、ブログ投稿もこれらの修正の対象外となります。
その他
このような URL 変換をネイティブで処理するための複数のオープンな機能リクエストがあります。
この内容はお役に立ちましたか?