Askbase に質問をインポートする
Askbase(Confluence Cloud 向け Q&A)は CSV または JSON ファイルから質問と回答をインポートできます。Confluence 管理者が Confluence administration → Apps → Askbase → Import を開き、ファイルを選んでプレビューを確認し、Import now をクリックします。Askbase のエクスポートも同じ形式なので、サイト間で Q&A を移すこともできます。
ファイル形式
質問または回答ごとに1行、先頭にヘッダー行を置きます。列名の大文字・小文字は区別しません。他のツールでよく使われる名前(Question、Content、Labels、Space、Created、Score)も認識します。
| 列 | 意味 |
|---|---|
type | question または answer |
id | 旧ツールでの項目 ID(回答がある質問では必須) |
question_id | 回答の場合:その回答が属する質問の ID |
title | 質問のタイトル(質問では必須) |
body | 質問の詳細、または回答の本文(回答では必須) |
tags | カンマ区切りのタグ(最大5個) |
space_key | Confluence のスペースキー(サイト全体なら空欄) |
page_id | 質問をページに紐づける場合の Confluence ページ ID(任意) |
author_account_id | Atlassian アカウント ID(同じサイトにインポートする場合は投稿者を保持) |
author_name | アカウント ID がない場合に投稿者として表示 |
created_at | 元の日時(例:2024-03-18T09:30:00Z) |
votes | 投票数の合計 |
accepted | 承認された回答に yes |
例:
type,id,question_id,title,body,tags,accepted,author_name
question,101,,How do I request VPN access?,New starter next week,"it,onboarding",,Dana Lee
answer,,101,,File a ticket in the IT portal under Access.,,yes,Sam Ortiz
answer,,101,,Your manager can also request it for you.,,,Priya NQuestions for Confluence(Data Center / Server)から
- Data Center サイトで、Atlassian が公開している REST API(
/rest/questions/1.0/questionと/rest/questions/1.0/answer/{id})、または次の記事にあるデータベースクエリで質問と回答をエクスポートします: Atlassian のナレッジベース記事. - 上の列で CSV を作成します。質問ごとに
question行(コンテンツ ID をid、タイトル、本文、トピックをtags、スペースキー)、回答ごとにanswer行(質問のコンテンツ ID をquestion_id、承認された回答はaccepted= yes)を作ります。 - Cloud サイトに Askbase をインストールし、Askbase の設定から CSV をインポートします。
Questions for Confluence Cloud にはエクスポート機能がありません(Atlassian の FAQ)。この方法は Data Center / Server サイトが稼働している間しか使えないので、停止する前に実施してください。
他の Q&A アプリ、スプレッドシート、フォーラムから
- 旧ツールから CSV にエクスポートします(またはスプレッドシートに貼り付けて CSV で保存)。
- ヘッダーを上の列名に変更するか、Question / Answer / Labels など一般的な名前のままにします。
- Connect で作られたアプリは 2027年1月31日にサポートが終了します。旧アプリが動いているうちにエクスポートしてください: その意味について.
よくある質問
Questions for Confluence Cloud から直接インポートできますか?
直接はできません。Atlassian の FAQ によると Questions for Confluence Cloud のコンテンツはエクスポートできず、Cloud の REST API も廃止されています。Data Center / Server で Questions を使っている場合は、そちらでエクスポートし(上の手順)、Cloud の Askbase にインポートしてください。
投稿者と日付は引き継がれますか?
日付と投票数は引き継がれます。投稿者は、ファイルに Atlassian アカウント ID があり同じサイトにインポートする場合(別スペースやテストサイトからの Askbase エクスポートなど)に引き継がれます。それ以外はファイルの author_name を表示します。
複数のファイルに分けてインポートできますか?
はい。各質問は、その回答と同じファイルか、それより前のファイルに入れてください。Askbase は旧 ID を記憶するので、後のファイルの回答も質問に紐づきます。
インポート中にデータが外部に送信されますか?
いいえ。ファイルはブラウザ内で読み込まれ、サイトの Atlassian Forge ストレージに保存されます。Askbase は Atlassian 上で動作し、外部サーバーはありません。
形式で困ったら support@norynta.com 宛てにサンプル行をいくつか(機密データは除いて)送ってください。対応付けをお手伝いします。