View a markdown version of this page

Integrasi Airtable - Amazon Quick
Sebelum Anda mulaiMengkonfigurasi AirtableMenyiapkan konektor di Amazon QuickTindakan yang tersediaMengelola dan memecahkan masalah

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasi Airtable

Dengan konektor aksi Airtable, Anda dapat mengakses platform Airtable langsung di Amazon Quick melalui bahasa alami. Anda dapat membuat dan memperbarui catatan, mengelola basis dan tabel, memfilter tampilan, dan melakukan operasi data relasional tanpa meninggalkan Amazon Quick.

Amazon Quick mendukung beberapa metode otentikasi untuk Airtable. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.

  • Aplikasi OAuth default — Menggunakan aplikasi OAuth yang AWS dikelola. Tidak diperlukan kredensil tambahan. Pengguna mengautentikasi langsung dengan akun Airtable mereka.

  • Aplikasi OAuth khusus - Menggunakan aplikasi OAuth yang dikelola pelanggan yang terdaftar di Airtable. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.

  • API Key — Menggunakan token akses pribadi Airtable untuk otentikasi. Cocokkan untuk penggunaan individu atau pengujian.

Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihatMetode autentikasi.

Sebelum Anda mulai

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.

  • Akun Airtable aktif dengan akses ke pangkalan dan data yang ingin Anda gunakan.

  • Untuk aplikasi OAuth Kustom: Akses ke Airtable Builder Hub di situs web Airtable untuk mendaftarkan integrasi OAuth.

  • Untuk Kunci API: Token akses pribadi dari Airtable Builder Hub di situs web Airtable.

  • Untuk persyaratan berlangganan Amazon Quick, lihatSiapkan integrasi di konsol.

Mengkonfigurasi Airtable

Jika Anda menggunakan otentikasi aplikasi OAuth Default, lewati bagian ini dan lanjutkan ke. Menyiapkan konektor di Amazon Quick

Untuk aplikasi Custom OAuth atau otentikasi API Key, selesaikan langkah-langkah yang berlaku di Airtable sebelum mengonfigurasi Amazon Quick.

Daftarkan integrasi OAuth (aplikasi OAuth khusus)

Buat integrasi OAuth di Airtable Builder Hub untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick.

  1. Masuk ke Airtable Builder Hub di situs web Airtable dan pilih integrasi OAuth.

  2. Pilih Daftarkan integrasi OAuth baru.

  3. Masukkan Nama untuk integrasi Anda.

  4. Untuk URL pengalihan OAuth, masukkan URL pengalihan dari Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. Pilih Registrasi integrasi.

  6. Setelah pendaftaran, buat rahasia klien dengan memilih Regenerasi rahasia klien.

  7. Catat nilai-nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.

    • ID Klien

    • Rahasia klien

  8. Di bawah Cakupan, pilih izin yang diperlukan integrasi Anda. Untuk daftar lengkap cakupan yang direkomendasikan, lihatCakupan yang direkomendasikan.

Buat token akses pribadi (API Key)

Buat token akses pribadi di Airtable Builder Hub untuk autentikasi API Key.

  1. Masuk ke Airtable Builder Hub di situs web Airtable dan pilih Token akses pribadi.

  2. Pilih Buat token.

  3. Konfigurasikan nama token, cakupan, dan akses dasar sesuai kebutuhan untuk kasus penggunaan Anda.

  4. Salin dan simpan token yang dihasilkan dengan aman. Anda membutuhkannya saat mengonfigurasi Amazon Quick.

Cakupan yang direkomendasikan

Saat Anda mendaftarkan integrasi OAuth atau membuat token akses pribadi, konfigurasikan cakupan berikut berdasarkan tindakan yang ingin Anda gunakan.

Cakupan yang direkomendasikan Airtable
Lingkup Deskripsi
data.records:read Baca data dalam catatan.
data.records:write Membuat, mengedit, dan menghapus catatan.
data.recordComments:read Baca komentar dalam catatan.
data.recordComments:write Buat, edit, dan hapus catatan komentar.
schema.bases:read Baca struktur basis, termasuk nama tabel dan jenis bidang.
schema.bases:write Edit struktur basis, termasuk nama tabel dan jenis bidang.
user.email:read Baca alamat email pengguna yang diautentikasi.

Menyiapkan konektor di Amazon Quick

Connect dari tab Tersedia

Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab Tersedia tanpa konfigurasi tambahan.

  1. Di konsol Amazon Quick, pilih Konektor.

  2. Pada tab Tersedia, cari Airtable dan pilih Connect.

  3. Selesaikan aliran masuk Airtable dan berikan izin yang diminta.

Untuk mengonfigurasi konektor dengan aplikasi OAuth Kustom atau Kunci API, gunakan tab Buat untuk tim Anda seperti yang dijelaskan di bawah ini.

Buat dari tab Buat untuk tim Anda

Setelah Anda menyelesaikan konfigurasi Airtable yang diperlukan, buat konektor di Amazon Quick.

  1. Di konsol Amazon Quick, pilih Konektor.

  2. Pilih tab Buat untuk tim Anda.

  3. Temukan dan pilih Airtable.

    catatan

    Jika konektor Airtable sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih Tidak, buat yang baru.

  4. Masukkan Nama untuk konektor Anda. Secara opsional, pilih + Tambahkan Deskripsi untuk menambahkan deskripsi.

  5. Untuk jenis Koneksi, pilih Jaringan publik.

  6. Untuk Konfigurasi OAuth, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.

    1. Untuk aplikasi OAuth Default:

      Tidak diperlukan kredensil tambahan. Pilih Next untuk melanjutkan.

    2. Untuk aplikasi Custom OAuth, konfigurasikan bidang berikut:

      • URL Dasar (Opsional) - URL dasar API Airtable. Contoh: https://api.airtable.com

      • ID Klien — ID klien dari integrasi OAuth Airtable Anda.

      • Rahasia klien — Rahasia klien dari integrasi Airtable OAuth Anda.

      • URL Token — Titik akhir token. Contoh: https://airtable.com/oauth2/v1/token

      • URL Otorisasi — Titik akhir otorisasi. Contoh: https://airtable.com/oauth2/v1/authorize

      • Redirect URL — Pre-filled dengan URL callback Amazon Quick.

    3. Untuk API Key, konfigurasikan bidang berikut:

      • URL Dasar (Opsional) - URL dasar API Airtable. Contoh: https://api.airtable.com

      • Kunci API — Token akses pribadi Airtable Anda.

      • Email (Opsional) — Alamat email yang terkait dengan akun Airtable Anda.

  7. Pilih Berikutnya.

  8. Jika Anda memilih aplikasi OAuth Default atau aplikasi Custom OAuth, jendela otorisasi Airtable akan terbuka. Tinjau izin yang diminta, pilih basis dan ruang kerja untuk memberikan akses, dan pilih Berikan akses.

  9. Pada halaman Ulasan, tinjau tindakan yang tersedia untuk konektor. Pilih Berikutnya.

  10. Pada halaman Publikasikan, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.

  11. Pilih Terbitkan.

Tindakan yang tersedia

Setelah Anda mengatur konektor, tindakan berikut tersedia.

Tindakan yang tersedia Airtable
Kategori Tindakan Deskripsi
Catatan Daftar Catatan Daftar catatan dalam tabel dengan pemfilteran dan penyortiran opsional.
Catatan Dapatkan Rekam Mengambil catatan tertentu berdasarkan ID.
Catatan Batch Buat Rekaman Membuat satu atau lebih catatan baru dalam tabel.
Catatan Perbarui Rekaman Memperbarui bidang pada catatan yang ada.
Catatan Catatan Pembaruan Batch Memperbarui beberapa catatan dalam satu operasi menggunakan PATCH.
Catatan Batch Put Record Upserts beberapa catatan dalam satu operasi menggunakan PUT.
Komentar Daftar Komentar Daftar komentar pada catatan.
Komentar Buat Komentar Menambahkan komentar ke catatan.
Komentar Perbarui Komentar Mengedit komentar yang ada pada catatan.
Skema Daftar Basis Daftar semua basis yang dapat diakses oleh pengguna yang diautentikasi.
Skema Dapatkan Skema Dasar Mengambil skema basis, termasuk tabel dan definisi bidang.
Skema Buat Tabel Membuat tabel baru di basis.
Skema Perbarui Tabel Memperbarui properti tabel seperti nama atau deskripsi.
Skema Buat Bidang Menambahkan bidang baru ke tabel.
Skema Bidang Perbarui Memperbarui properti bidang seperti nama atau jenis.
Lampiran Buat Lampiran Mengunggah lampiran ke rekaman.
Pengguna Dapatkan Info Pengguna Mengambil informasi tentang pengguna yang diautentikasi.
catatan

Tindakan yang dapat Anda gunakan bergantung pada basis dan ruang kerja yang dapat diakses oleh pengguna yang diautentikasi.

Mengelola dan memecahkan masalah

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihatMengelola integrasi yang ada.

Masalah otentikasi

  • Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth) — Verifikasi bahwa akun Airtable Anda aktif dan Anda dapat masuk ke airtable.com di situs web Airtable secara langsung. Untuk aplikasi Custom OAuth, konfirmasikan bahwa URL pengalihan dalam integrasi OAuth Airtable Anda cocok dengan URL callback Amazon Quick.

  • Kredensi klien tidak valid (aplikasi OAuth Kustom) — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai dalam integrasi OAuth Airtable Anda. Jika Anda membuat ulang rahasia klien, perbarui nilainya di Amazon Quick.

  • Kunci API ditolak — Verifikasi bahwa token akses pribadi Anda aktif dan memiliki cakupan yang diperlukan. Token dapat dicabut atau kedaluwarsa di Airtable Builder Hub.

  • Izin tidak memadai — Verifikasi bahwa cakupan yang dikonfigurasi untuk metode autentikasi Anda menyertakan izin yang diperlukan untuk tindakan yang ingin Anda gunakan. Lihat Cakupan yang direkomendasikan.