CSV ファイルからインポートした Jira の添付ファイルが破損する

プラットフォームの注記: Cloud のみ - This article only applies to Atlassian apps on the クラウド プラットフォーム上のアトラシアン製品にのみ適用されます。

要約

2 つの Jira Cloud サイト間の移行を、外部システム インポートによって CSV ファイルで行う場合、移行された課題の添付ファイルを読み込む際にエラーが表示される場合があります。

画像の添付ファイルについて、最初に気付くのは、サムネイルが破損していることです。

Jira 添付ファイルの壊れたサムネイル

これをクリックすると、次のようなエラーが表示されます。

画像を読み込めません

ソリューション

エクスポートされた CSV 内の URL に API 認証を追加する

CSV ファイルが一般公開されていない添付ファイルを参照している場合、 インポートした添付ファイルが破損します。次の例をご参照ください。

18/Jul/23 3:53 PM;image.png;https://mysite.atlassian.net/rest/api/2/attachment/content/10000

このファイルは Jira サイトにすでにログインしていない限りアクセスできないため、CSV インポーターもアクセスできません。

添付ファイルを正しくインポートするには、ソース サイトとインポート対象の課題にアクセスできるユーザーが次のことを行う必要があります。

  1. API トークンを生成する

  2. CSV ファイルを編集する

  3. すべての添付ファイルの URL を API 認証を含むように変更する

  4. CSV ファイルを再インポートする

⚠️ CSV ファイルの編集によく使用される一部のアプリケーションでは、ファイルを保存すると自動的にフォーマットが変更され、インポート用としてはファイルが壊れてしまう場合があることに注意してください。

下記のサンプル添付ファイルに必要な編集の例を参照してください。

Original exported link 18/Jul/23 3:53 PM;image.png;https://mysite.atlassian.net/rest/api/2/attachment/content/10000 Edited authenticated link 18/Jul/23 3:53 PM;image.png;https://user%40domain.com:<API-Token>@mysite.atlassian.net/rest/api/2/attachment/content/10000
  • メール アドレスの「@」記号が HTML 文字「%40」に置き換えられ、そのあとにコロンと API トークンが続きます

  • 最後に、Cloud サイトのホスト名の前に「@」記号を追加します。

  • URL の残りの部分は同一になります。

ソースサイトが Jira Data Center の場合

Jira Cloud のメール アドレスと API トークンの代わりに、Jira Data Center のユーザー名とパスワードを使用します。例:

Original exported link 18/Jul/23 3:53 PM;image.png;https://mysite.atlassian.net/rest/api/2/attachment/content/10000 Edited authenticated link 18/Jul/23 3:53 PM;image.png;https://adminuser:password@myjirasite.com/secure/attachment/10000/filename

メモ:

  • パスワードまたはユーザー名に #、^、%、$、* などの特殊文字が含まれている場合は、URL でエンコードされた同等の文字に置き換える必要があります。

  • この方法は、シングル サインオンなどの外部認証方法をサポートしていません。Jira On-Prem アカウントにはローカル認証情報を使用する必要があります。

  • Jira Cloud への CSV インポートがすべて完了したら、アカウントの認証情報をリセットすることをお勧めします。

更新日時: 2025 年 4 月 8 日

さらにヘルプが必要ですか?

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