CSV ファイルからインポートした Jira の添付ファイルが破損する
プラットフォームの注記: Cloud のみ - This article only applies to Atlassian apps on the クラウド プラットフォーム上のアトラシアン製品にのみ適用されます。
要約
2 つの Jira Cloud サイト間の移行を、外部システム インポートによって CSV ファイルで行う場合、移行された課題の添付ファイルを読み込む際にエラーが表示される場合があります。
画像の添付ファイルについて、最初に気付くのは、サムネイルが破損していることです。
これをクリックすると、次のようなエラーが表示されます。
ソリューション
エクスポートされた CSV 内の URL に API 認証を追加する
Imported attachments break when the CSV file references attachments that are not publicly accessible. See an example below:
18/Jul/23 3:53 PM;image.png;https://mysite.atlassian.net/rest/api/2/attachment/content/10000このファイルは Jira サイトにすでにログインしていない限りアクセスできないため、CSV インポーターもアクセスできません。
添付ファイルを正しくインポートするには、ソース サイトとインポート対象の課題にアクセスできるユーザーが次のことを行う必要があります。
CSV ファイルを編集する
すべての添付ファイルの URL を API 認証を含むように変更する
CSV ファイルを再インポートする
In the new import experience, private attachments are not supported and are provided as weblinks. Since this is not supported, please don't add API tokens to the CSV. In the old flow, private attachments are supported, therefore, it is recommended to add the tokens.
⚠️ 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 インポートがすべて完了したら、アカウントの認証情報をリセットすることをお勧めします。
この内容はお役に立ちましたか?