Confluence からインポート

前提条件

Confluence から YouTrack にスペースをインポートする前に、次の要件を確認してください。

• Confluence のバージョンは 5.5.6 以降です。以前のバージョンの Confluence から記事をインポートする機能は検証されていません。

• 自己管理型の Confluence Server インストールからコンテンツをインポートする場合、Confluence インストールはインターネット経由でアクセスできる必要があります。具体的には、ネットワークが Confluence インストールと YouTrack 間の接続をブロックしていないことを確認する必要があります。

• Confluence のユーザーアカウントには管理者権限があります。

• パスワードまたはトークンを使用して、ソースアプリケーションに直接ログインしてアクセスできます。

  YouTrack のインポートエンジンは、外部認証モジュールによる認証をサポートしていません。

詳細のインポート

Confluence データベースに、YouTrack にまだ存在しないエンティティへの参照が含まれている場合、それらは作成されます。インポートの実行に使用する YouTrack ユーザーアカウントには、インポートされたすべてのエンティティを作成するための十分な権限が必要です。インポートを実行するには、システム管理者ロールまたは低レベルの管理者書き込み権限を持つアカウントを使用することをお勧めします。

Confluence からのインポートを設定する

新しいインポート構成を追加する前に、Confluence インスタンスへのアクセスを許可する資格情報を準備します。YouTrack でインポートを設定するときは、認証のためにこれらのクレデンシャルが必要になります。

Confluence Cloud からのインポートを構成するには、API トークンが必要です。API トークンの作成の詳細については、Confluence クラウドの API トークンを作成するを参照してください。

YouTrack で Confluence からのインポートを構成する

セットアップウィザードは、セットアッププロセスをガイドします。

Confluence からのインポートを構成するには:

1. 管理メニューから、統合> インポートを選択します。

2. 新規インポートをクリックして、セットアップダイアログを開きます。

   

3. Confluence を選択します。

   • Confluence からの新規インポートの設定が表示されます。

   

4. 以下の設定に値を入力します。

   設定	説明
   Confluence の URL	Confluence インスタンスのベース URL を入力します。Confluence Cloud の場合、URL に /wiki パスを含めるようにしてください。
   ユーザー名またはメール	Confluence へのログインに使用するアカウントのユーザー名を入力します。このアカウントは、インポートする必要のあるスペースへのアクセス権を持っている必要があります。
   パスワード	Confluence インスタンスへのログインに使用するアカウントのパスワードを入力します。 Confluence Cloud の場合、Atlassian アカウント用に API トークンを作成し、入力フィールドに貼り付けます。

   Confluence インスタンスで必要な場合は、クライアント認証に SSL キーを使用するオプションを有効にします。

5. 次へボタンをクリックしてください。

   • インポート設定の 2 番目のセットが表示されます。

   

6. Confluence スペースを選択し、インポートするプロジェクトをターゲットにします。詳細については、プロジェクトマッピングを参照してください。

7. インポートを開始しますボタンをクリックしてください。

   • YouTrack は、構成されたプロジェクトマッピングに従って、新しいプロジェクトを作成し、既存のプロジェクトにデータをインポートします。

   • YouTrack は、記事、コメント、ユーザーをターゲットプロジェクトにインポートします。

インポートプロジェクトを設定すると、それがインポートリストに表示されます。構成とインポートの詳細を表示するには、リストからインポート構成を選択します。

詳細サイドバーの YouTrack には、インポートされたデータのインポートステータスと詳細が表示されます。ツールバーの 再開ボタンをクリックすると、変更のポーリングとソース Confluence インスタンスからの更新のインポートが明示的に開始されます。

インポートログファイルをダウンロードして、必要に応じて調査および調査することもできます。

プロジェクトマッピング

インポート設定の最後のステップで、YouTrack にインポートする Confluence スペースを選択するオプションがあります。インポート用に新しいプロジェクトを作成するか、YouTrack の既存のプロジェクトにデータをインポートするかを選択することもできます。

YouTrack は、Web アドレスが以前のインポートによってソースプロジェクトをすでにマップしているかどうかを認識します。YouTrack ですでにマップされているインポートされたソースプロジェクトは選択できません。重複データをインポートせずに、同じソースから複数のインポートジョブを作成できます。

インポートオプション

最初のインポート後、サイドバーで次のコントロールを使用できます。