Impor dari Confluence

Penting untuk memiliki semua data Anda di satu tempat. Berikut adalah tutorial bermanfaat untuk mengimpor ruang Confluence Anda ke Notion. Bergantung pada kebutuhan Anda, ada dua cara yang dapat Anda gunakan untuk mengimpor dari Confluence ke Notion.

• Pengimpor file-Zip: Dapat digunakan untuk mengimpor hanya sebagian dari ruang kerja Anda. Hanya dapat mengimpor ruang kerja yang lebih kecil hingga 5GB (atau 15GB berdasarkan permintaan).

• Pengimpor API: Hanya dapat mengimpor seluruh ruang kerja. Dapat mengimpor ruang kerja hingga 30GB. Mempertahankan komentar dan pemetaan pengguna.

Impor multi-ruang: Hingga 10 ruang Confluence dapat diimpor sekaligus langsung melalui UI. Setiap ruang Confluence yang dipilih menghasilkan halaman log-nya sendiri dan diimpor sebagai halaman pribadi tingkat atas yang terpisah (ke dalam Ruang tim Notion yang berbeda sesuai kebutuhan). Fitur ini hanya tersedia untuk paket Business dan Paket Perusahaan.

• Situs Confluence → Organisasi Notion

• Ruang Confluence → Ruang kerja Notion

• Halaman Confluence → Halaman Notion

• Makro → konten yang diratakan atau jenis blok Notion terdekat (misalnya, Confluence Expand → Notion Tombol)

• Impor hingga ~50k halaman atau 30GB. Impor yang lebih besar mungkin gagal.

  • Tips: Untuk ruang yang besar, bagi ekspor berdasarkan subruang atau bagian dan gunakan pengimpor ZIP. Jika ukuran ruang kerja >100GB, hubungi manajer akun Anda.

• Setelah impor dimulai, Anda dapat menutup browser dengan aman — kami akan mengirimkan email kepada Anda setelah selesai.

• Tinjau progres impor Anda di Pengaturan → Impor. Di sana Anda dapat melihat status impor Anda dan impor yang telah selesai.

Ekspor ruang Confluence Anda ke HTML

1. Dari ruang kerja Confluence Anda, buka Pengaturan Ruang di bilah sisi kanan atas.

2. Pilih Alat Konten di bilah alat atas, lalu Ekspor. Jika Anda tidak melihat salah satu dari opsi ini, Anda mungkin perlu meminta izin untuk mengekspor dari admin Ruang Kerja.

3. Pilih HTML dari daftar format.

4. Pilih Ekspor Kustom dan hapus centang pada kotak Sertakan komentar.

5. Pilih halaman mana yang ingin Anda ekspor. Perhatikan bahwa halaman yang berisi lampiran besar dapat meningkatkan ukuran dan kompleksitas ekspor secara signifikan.

6. Biarkan ekspor Anda selesai diproses. Ini bisa memakan waktu cukup lama untuk ruang kerja yang besar.

7. Setelah selesai, klik Unduh untuk menyimpan ekspor ke komputer Anda. File tersebut akan diberi judul seperti Confluence-space-export-XXXXXX.html.zip.

Impor ke Notion

1. Buka ruang kerja Notion tempat Anda ingin mengimpor konten Confluence Anda.

2. Buka Pengaturan di bilah sisi Anda → Impor → Third party imports → Confluence.

3. Buka file .zip yang diekspor dari Confluence dan pilih file tersebut untuk diunggah. Anda tidak perlu mengekstrak file tersebut - unggah seluruh arsip.

4. Anda akan melihat pesan \"Uploading...\" saat browser mengunggah file Anda, kemudian pesan status saat impor berlangsung.

5. Setelah impor selesai, Anda akan diarahkan ke konten yang baru saja diimpor.

Hubungkan Confluence dan Notion

1. Buka Pengaturan di bilah sisi Anda → Impor → Confluence.

2. Pilih Impor via API.

3. Pilih jenis instans Confluence Anda: cloud atau server. Untuk menemukan jenis instans Anda, buka Confluence, klik Help → ? di samping profil Anda → About Confluence. Notion hanya mendukung instans cloud dan server.

Autentikasi dengan Confluence Cloud

1. Masukkan email dan situs Confluence Anda.

2. Buat token API dari akun Atlassian Anda dan masukkan ke dalam kolom tersebut. Baca selengkapnya tentang cara membuat token di Confluence.

3. Klik Autentikasi.

Autentikasi dengan Confluence Server

1. Cari dan pilih versi Confluence Anda.

2. Masukkan email dan situs Confluence Anda.

3. Jika Anda menjalankan Confluence 7.9 atau yang lebih baru, buat Personal Access Token dan tempel token tersebut. Jika Anda menggunakan versi yang lebih lama, masukkan nama pengguna dan kata sandi Confluence Anda.

4. Klik Autentikasi.

Impor

1. Klik Confluence dari menu Impor.

2. Pantau progres impor Anda — langkah ini mungkin memakan waktu beberapa jam untuk ruang yang besar.

   • Setelah Anda melihat Importing pages…, Anda dapat menutup jendela browser dengan aman. Kami akan mengirimkan email kepada Anda setelah impor selesai.

3. Ulangi bagian ini jika Anda ingin mengimpor lebih dari satu ruang Confluence.

• Notion mengimpor semuanya ke satu root/induk di bagian pribadi, atau ke Ruang tim terpilih dari orang yang melakukan impor.

• Pengguna diharapkan untuk membersihkan dan menyiapkan arsitektur ruang kerja sebelum mengundang orang lain.

• Izin harus diterapkan kembali di Notion — rencanakan langkah pasca-impor untuk memetakan grup dan batasan Confluence ke grup, Ruang tim, dan izin tingkat halaman Notion.

• Jika ada file atau lampiran dalam tabel Confluence, itu akan menjadi database Notion; jika tidak, itu menjadi tabel sederhana.

• Gaya tabel dan makro/plugin sering kali menurun (misalnya, ui-steps, callout, keterangan gambar).

• Sebagian besar makro tidak didukung. Notion mencoba memetakan data ke blok Notion terdekat.

• Kegagalan sementara karena ketidakandalan API Confluence dapat menyebabkan keseluruhan impor atau halaman tertentu gagal. Anda mungkin perlu mencoba ulang seluruh impor.

• Untuk beberapa ruang, jalankan impor secara berurutan (satu ruang dalam satu waktu) kecuali menggunakan impor multi-ruang (hanya Bisnis/Paket Perusahaan).

• Kegagalan impor dapat terjadi pada data Confluence yang rumit (misalnya, sel yang digabungkan, tabel di dalam tabel).

• Notion hanya mendukung token API cakupan pengguna (bukan token cakupan). Gunakan opsi token API pribadi saat melakukan autentikasi.

• Lampiran dan media yang tidak dirujuk di halaman tidak akan diimpor.

• Hierarki terkadang tidak sepenuhnya dipertahankan — validasi dengan impor percontohan.

• Blok Matematika LaTeX tidak diimpor dengan benar

  • Mengapa ini terjadi: Format makro blok plugin LaTeX Confluence berbeda dari matematika inline. Notion mendukung makro LaTeX inline tetapi bukan varian makro blok.

  • Untuk memperbaiki: Konversikan makro blok LaTeX ke makro inline di Confluence sebelum mengimpor ulang, atau tempatkan LaTeX dalam blok kode dan konversikan ke blok matematika secara manual setelah impor.

• Tidak dapat mengimpor konten Gliffy

  • Mengapa ini terjadi: Notion tidak mendukung gambar Gliffy melalui pengimpor file.

  • Untuk memperbaiki: Ubah HTML untuk mengganti blok Gliffy dengan blok gambar yang merujuk ke file yang benar sebelum mengimpor.

• Impor gagal

  • Mengapa ini terjadi: Ruang yang sangat besar, ekspor yang rusak, batas kecepatan, atau waktu tunggu habis.

  • Cara memperbaiki: Impor satu ruang dalam satu waktu, bagi ruang yang besar menjadi beberapa bagian, ekspor ulang ZIP yang bersih, atau gunakan pengimpor API dengan proses yang dicakup.

• Impor tidak menyertakan gambar atau lampiran

  • Mengapa ini terjadi: Aset mungkin tidak dibundel dalam Ekspor atau tidak dapat dijangkau oleh token API.

  • Cara memperbaiki: Pastikan "Sertakan lampiran" dipilih saat Ekspor, jaga jalur relatif tetap utuh di dalam ZIP, atau unggah ulang aset utama setelah impor.

• Pratinjau tautan Jira rusak setelah impor

  • Mengapa ini terjadi: Pratinjau tautan Jira hanya berfungsi jika pengguna diautentikasi sebelum memulai migrasi.

  • Cara memperbaiki: Autentikasi dengan Jira sebelum menjalankan migrasi.

• Hierarki file tidak dipertahankan seperti yang diharapkan

  • Mengapa ini terjadi: Kasus khusus dalam struktur Ekspor atau penumpukan yang dalam.

  • Cara memperbaiki: Uji dengan subset yang representatif terlebih dahulu; atur ulang di Notion setelah impor.

• Makro Confluence dan/atau pemformatan khusus hilang:

  • Mengapa ini terjadi: Makro atau konten aplikasi yang tidak didukung.

  • Cara memperbaiki: Petakan ke blok asli Notion: Expand → Tombol, Action items → To-do. Sederhanakan tabel yang kompleks atau Ekspor ke CSV dan impor ke dalam database Notion.

• Izin Confluence tidak direplikasi di Notion:

  • Mengapa ini terjadi: Ini adalah hal yang wajar pada impor mandiri.

  • Cara memperbaiki: Rencanakan dan jalankan pemetaan izin setelah konten masuk ke Notion, menggunakan grup Notion, Ruang tim, dan izin tingkat halaman.