Sinkronkan data dari alat lain ke Notion
Bawa data dari alat seperti GitHub, Jira, dan Salesforce ke dalam database Notion yang diperbarui secara otomatis.
Sinkronisasi database kami memungkinkan Anda bekerja dengan dan memperkaya informasi dari alat lain bersama dengan rencana, dokumen, dan proyek tim Anda. Hubungkan akun, pilih apa yang akan disinkronkan, dan Notion akan membuat database serta terus memperbaruinya.
Notion mengelola sinkronisasi ini sehingga Anda dapat menghubungkan akun dan menggunakan database yang disinkronkan tanpa harus membangun atau memelihara integrasi sendiri.
Koneksi | Data yang dapat Anda sinkronkan | Database yang dibuat |
|---|---|---|
GitHub | Pull Request dari repositori yang dipilih | Pull Request |
Jira | Ruang dan item kerja dari ruang Jira Cloud yang dipilih | Ruang Jira dan Item Kerja Jira |
Salesforce | Akun, kontak, dan peluang | Akun, Kontak, dan/atau Peluang, tergantung pada pilihan |
Setiap catatan dari alat lain menjadi halaman di database Notion. Bidang dari sumber menjadi properti database.
Sinkronisasi terkelola memperbarui data dalam satu arah: dari alat yang terhubung ke Notion. Properti yang disinkronkan bersifat baca-saja di Notion. Untuk mengubah nilai yang disinkronkan, perbarui di GitHub, Jira, atau Salesforce. Anda akan melihat perubahannya di Notion.
Sinkronisasi diproses secara otomatis di latar belakang. Waktu pembaruan bervariasi tergantung pada koneksi, jumlah data, dan batas permintaan alat sumber.
Catatan: Perlu menghubungkan alat lain? Jika alat yang ingin Anda hubungkan tidak didukung, gunakan Notion Workers untuk membangun sinkronisasi kustom, atau ikuti Panduan Workers bawaan kami untuk Asana dan GitLab.
Anda harus menjadi anggota ruang kerja Notion dan memiliki akun dengan akses ke data yang ingin Anda sinkronkan. Organisasi Anda mungkin mengharuskan administrator untuk menyetujui koneksi atau memberikan akses di alat sumber.
Akun yang Anda gunakan untuk membuat sinkronisasi menentukan data mana yang dapat dibaca oleh Notion. Jika izinnya berubah atau koneksi kedaluwarsa, sinkronisasi mungkin mengharuskan Anda untuk melakukan autentikasi ulang.
Sinkronisasi GitHub dan Sinkronisasi Jira memerlukan Business plan (atau add-on Mobile Business). Sinkronisasi Salesforce memerlukan Enterprise plan.
Buka Settings → Koneksi di ruang kerja Notion Anda.
Buka koneksi yang ingin Anda sinkronkan (GitHub, Jira, atau Salesforce) dari Telusuri atau Terinstal, lalu pilih Sinkronisasi database dari opsi koneksi tersebut.
Hubungkan akun dan selesaikan langkah-langkah otorisasi untuk alat tersebut.
Pilih repositori, ruang, atau jenis objek yang ingin Anda sinkronkan.
Pilih seberapa banyak riwayat yang ingin disertakan. Untuk sumber yang menawarkan properti kustom, seperti Jira dan Salesforce, Anda juga dapat memilih properti kustom mana yang ingin disertakan dalam sinkronisasi Anda.
Pilih Buat sinkronisasi.
Notion membuat database di bagian bilah sisi Pribadi Anda. Impor pertama dimulai di latar belakang. Anda dapat membuka database saat catatan masih diimpor.
Impor pertama
Notion membuat struktur database, lalu mengimpor catatan yang cocok dengan pengaturan Anda. Impor besar bisa memakan waktu lebih lama karena Notion membaca data secara bertahap dan mengikuti batas permintaan alat sumber.
Database mungkin hanya menampilkan sebagian data Anda saat impor pertama berjalan. Anda tidak perlu membiarkan Notion tetap terbuka agar impor terus berlanjut.
Pembaruan berkelanjutan
Setelah impor pertama, Notion secara berkala memeriksa alat yang terhubung untuk mencari catatan baru atau yang diubah dan memperbarui properti yang disinkronkan. Sinkronisasi terus berjalan di latar belakang bahkan saat tidak ada yang melihat database tersebut.
Secara umum, kami memperkirakan perubahan akan disinkronkan ke Notion dalam beberapa menit atau kurang.
Waktu bervariasi tergantung pada koneksi, jumlah data, dan ketersediaan alat sumber. Pemeriksaan perubahan tidak berarti setiap perubahan langsung muncul di Notion. Salesforce memeriksa perubahan setiap menit secara default; lihat panduan setiap koneksi untuk detailnya.
Saat sumber membatasi permintaan untuk sementara atau tidak tersedia, Notion akan mencoba lagi. Jika sinkronisasi memerlukan otorisasi baru atau izin yang berbeda, statusnya akan memberi tahu Anda apa yang harus dilakukan.
Jendela riwayat
Anda dapat menyertakan semua riwayat yang tersedia atau membatasi sinkronisasi ke catatan yang diperbarui dalam 30, 90, atau 365 hari terakhir. Jendela riwayat menggunakan waktu pembaruan terakhir catatan sumber, bukan tanggal pembuatannya. Salesforce menggunakan waktu modifikasi sistemnya.
Jendela tersebut bergerak maju seiring waktu. Catatan dapat keluar dari database jika belum diperbarui dalam jendela tersebut, meskipun catatan itu masih terbuka atau aktif di alat sumber.
Catatan: Jendela riwayat dapat menghapus halaman. Saat catatan berada di luar jendela, halaman yang disinkronkan akan dihapus dari Notion, termasuk nilai apa pun yang Anda tambahkan ke halaman tersebut di properti Anda sendiri. Pilih semua riwayat yang tersedia jika Anda perlu menyimpan catatan lama yang tidak berubah.
Memperluas jendela akan mengimpor catatan tambahan yang cocok. Memperpendek jendela akan menghapus catatan yang tidak lagi memenuhi syarat. Ini berbeda dari filter database Notion, yang hanya mengubah apa yang ditampilkan oleh tampilan.
Anda dapat membuat tampilan, memfilter dan mengurutkan catatan, serta menambahkan properti Notion Anda sendiri. Misalnya, tambahkan prioritas tim ke Pull Request atau status perencanaan akun ke akun Salesforce. Nilai dalam properti ini tetap berada di Notion.
Berikan nama yang berbeda pada properti Anda sendiri agar tidak berkonflik dengan properti yang dikelola oleh sinkronisasi.
Database dimulai sebagai halaman pribadi. Bagikan database tersebut menggunakan izin halaman Notion saat Anda siap.
Catatan: Berbagi Notion mengontrol siapa yang dapat melihat data yang disinkronkan. Seseorang dengan akses ke database Notion mungkin dapat melihat catatan yang tidak dapat mereka akses di alat sumber. Izin sumber tidak disalin ke setiap penampil di Notion. Tinjau akses sebelum berbagi.
Perubahan izin di alat sumber dapat menghentikan pembaruan di masa mendatang tanpa menghapus data yang sudah ada di Notion. Tinjau pengaturan berbagi database Notion saat akses sumber berubah.
Kembali ke pengaturan Database sync koneksi untuk meninjau status sinkronisasi, informasi proses terkini, dan detail kesalahan apa pun.
Status | Apa yang harus dilakukan |
|---|---|
Menginisialisasi atau Mengisi Ulang | Sinkronisasi sedang disiapkan atau mengimpor catatan yang ada. Biarkan proses impor berlanjut. |
Normal | Sinkronisasi diproses dengan normal. Perubahan sumber terkini mungkin masih dalam proses. |
Mengalami penurunan performa atau gagal | Buka detail kesalahan sinkronisasi untuk melihat apa yang menghambat pembaruan. |
Tindakan diperlukan | Ikuti Instruksi yang ditampilkan, seperti menghubungkan kembali akun atau memulihkan akses sumber. |
Nonaktif | Sinkronisasi dijeda. Anda dapat melanjutkan sinkronisasi di pengaturan sinkronisasi. |
Tidak tersedia | Informasi status saat ini tidak tersedia. Periksa kembali nanti. |
Waktu proses terkini menunjukkan adanya Aktivitas. Hal ini tidak menjamin bahwa setiap perubahan sumber telah sampai ke Notion.
Gunakan sinkronisasi terkelola jika salah satu koneksi yang didukung mencakup data dan pengaturan yang Anda perlukan. Notion menangani impor awal, pemeriksaan berkala, dan logika sinkronisasi khusus koneksi.
Gunakan Notion Worker saat Anda perlu membangun sinkronisasi kustom, seperti mengimpor dari layanan lain atau mengubah data sebelum mencapai Notion.
Apa yang Anda butuhkan | Sinkronisasi database terkelola | Worker |
|---|---|---|
Siapkan koneksi yang didukung tanpa kode | Pilih akun, data, dan pengaturan di Notion. | Memerlukan kode dan penerapan. |
Pilih struktur data | Gunakan catatan dan properti yang didukung oleh koneksi. | Tentukan skema dan transformasi kustom. |
Sesuaikan cara data diambil | Gunakan perilaku sinkronisasi bawaan. | Implementasikan permintaan sumber dan perilaku sinkronisasi yang dibutuhkan alur kerja Anda. |
Pelihara sinkronisasi | Notion memelihara logika koneksi bawaan. | Tim Anda memelihara kode Worker; Notion menjalankan Worker tersebut. |
Sebagai contoh, gunakan sinkronisasi GitHub terkelola untuk melacak Pull Request di Notion. Pertimbangkan Worker jika Anda memerlukan sumber kustom, tipe data tambahan, atau perhitungan yang menggabungkan data sebelum impor.
Catatan hilang.
Periksa repositori, ruang, atau tipe objek yang dipilih, jendela riwayat Anda, dan izin sumber akun yang terhubung. Periksa juga apakah impor pertama masih berjalan dan apakah filter tampilan Notion menyembunyikan catatan.
Relasi hilang
Jika halaman yang disinkronkan seharusnya terkait dengan halaman lain yang disinkronkan tetapi tidak, hal itu mungkin disebabkan oleh jendela riwayat Anda, atau halaman terkait masih dalam proses impor. Kami hanya membuat relasi jika kedua halaman disinkronkan ke database Notion.
Pembaruan telah berhenti
Buka detail status sinkronisasi. Hubungkan kembali jika otorisasi telah kedaluwarsa, atau minta administrator sumber Anda untuk memulihkan akses. Pemadaman sumber sementara dan batas permintaan dapat menunda pembaruan saat Notion mencoba kembali.
Sinkronisasi telah mencapai batas baris
Kurangi data yang dipilih atau pilih jendela riwayat yang lebih singkat. Tinjau efeknya sebelum menyimpan: menghapus sumber atau mempersingkat riwayat dapat menghapus halaman yang disinkronkan. Panduan khusus koneksi menjelaskan apa yang terjadi saat Anda mengubah pilihan.
Untuk sinkronisasi Asana atau GitLab yang sudah ada, gunakan panduan penggantian Worker:
