Blok aliran di Amazon Connect: Tabel Data - Amazon Connect
DeskripsiKasus penggunaanSaluran yang didukungJenis aliranIkhtisar konfigurasiMengevaluasi nilai Tabel DataDaftar nilai Tabel DataMenulis ke Tabel DataBlok yang dikonfigurasi

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

Blok aliran di Amazon Connect: Tabel Data

Deskripsi

Blok Tabel Data di Amazon Connect memungkinkan Anda mengevaluasi, membuat daftar, atau menulis data dari tabel data dalam alur kontak Anda. Blok ini memfasilitasi pengambilan keputusan dinamis, pengalaman pelanggan yang dipersonalisasi, dan manajemen data dengan berinteraksi dengan data terstruktur yang disimpan dalam tabel data Amazon Connect Anda.

Kasus penggunaan

Blok Tabel Data berguna untuk:

  • Pengambilan konfigurasi — Mengakses aturan bisnis, parameter perutean, atau pengaturan operasional yang disimpan dalam tabel data.

  • Keputusan perutean dinamis — Tabel data kueri untuk menentukan jalur antrian, agen, atau alur yang sesuai berdasarkan atribut pelanggan.

  • Pemeriksaan status — Verifikasi status akun, kelayakan, atau kondisi lainnya sebelum melanjutkan dengan tindakan tertentu.

Saluran yang didukung

Tabel berikut mencantumkan cara blok ini merutekan kontak yang menggunakan saluran yang ditentukan.

Channel Didukung?

Suara

Ya

Obrolan

Ya

Tugas

Ya

Email

Ya

Jenis aliran

Anda dapat menggunakan blok ini dalam jenis aliran berikut:

  • Semua aliran

Ikhtisar konfigurasi

Pilih tindakan

Pilih jenis operasi yang ingin Anda lakukan:

  • Baca dari tabel data - Kueri atau ambil data (Evaluasi atau Daftar tindakan)

  • Menulis ke tabel data - Buat catatan baru atau perbarui catatan yang ada

Tentukan tabel data

  • Pilih Setel secara manual untuk langsung memilih tabel data

  • Pilih tabel data target Anda dari dropdown

  • Penting: Setelah Anda memilih tabel data tertentu, antarmuka secara otomatis mengisi atribut yang tersedia dari tabel tersebut di bagian konfigurasi yang relevan

Mengevaluasi nilai Tabel Data

Gunakan tindakan Evaluasi untuk menanyakan tabel data dan mengambil nilai atribut tertentu berdasarkan kriteria yang ditentukan.

Gambar berikut menunjukkan halaman Properti dari blok Tabel Data yang dikonfigurasi untuk mengevaluasi nilai tabel data.

Halaman properti dari blok Tabel Data yang dikonfigurasi untuk tindakan Evaluasi.

Langkah-langkah konfigurasi

  1. Pilih Baca dari tabel data sebagai Tindakan.

  2. Pilih Evaluasi nilai Tabel Data dari dropdown tindakan baca.

  3. Konfigurasikan Kueri:

    • Anda dapat mengatur hingga 5 kueri per blok Tabel Data. Setidaknya satu kueri diperlukan untuk setiap blok Evaluasi Tabel Data.

    • Untuk setiap kueri:

      • Nama Kueri (Diperlukan) - Berikan nama deskriptif untuk kueri. Penting: Nama kueri harus unik di seluruh alur, tidak hanya di dalam blok khusus ini.

      • Atribut Primer — Saat Anda memilih tabel data secara manual, UI secara otomatis mengisi daftar atribut utama dari skema tabel tersebut. Semua bidang atribut utama diperlukan - Anda harus memberikan nilai untuk setiap atribut utama yang ditampilkan. Atribut ini bertindak sebagai filter untuk mengidentifikasi baris tertentu dalam tabel data Anda.

      • Atribut Kueri — Saat Anda memilih tabel data secara manual, tarik-turun secara otomatis diisi dengan semua atribut yang tersedia dari tabel tersebut. Pilih satu atau beberapa atribut dari dropdown. Ini adalah bidang data yang akan dikembalikan dan tersedia untuk digunakan dalam alur Anda. Nilai yang diambil dapat direferensikan di blok berikutnya menggunakan nama kueri.

Detail kunci untuk Evaluasi

  • Batas kueri - Hingga 5 kueri per blok

  • Persyaratan minimum - Setidaknya satu kueri harus dikonfigurasi

  • Keunikan nama kueri - Harus unik di seluruh alur kontak

  • Pencocokan atribut - Atribut primer menggunakan pencocokan yang tepat untuk menemukan baris

  • Bidang wajib - Semua atribut utama adalah wajib

Mengakses data yang diambil untuk Evaluasi

Setelah menjalankan tindakan Evaluasi, Anda dapat mengakses nilai atribut yang diambil menggunakan format namespace berikut: $.DataTables.<QueryName>.<AttributeName>

  • Komponen:

    • QueryName— Nama unik yang Anda tetapkan untuk kueri dalam konfigurasi

    • AttributeName— Nama atribut yang Anda pilih untuk diambil

  • Penggunaan - Nilai-nilai ini dapat direferensikan dalam blok aliran berikutnya seperti:

    • Periksa blok atribut kontak (untuk percabangan bersyarat)

    • Atur blok atribut kontak (untuk menyimpan di ruang nama lain)

    • Putar blok prompt (untuk memberikan pesan yang dipersonalisasi)

    • Memanggil blok fungsi Lambda (untuk diteruskan sebagai parameter input)

  • Contoh - Jika Anda mengonfigurasi kueri bernama "CustomerLookup" yang mengambil atribut “AccountStatus” dan “LoyaltyTier”:

    • Akses status akun: $.DataTables.CustomerLookup.accountStatus

    • Akses tingkat loyalitas: $.DataTables.CustomerLookup.loyaltyTier

  • Catatan - Jika query tidak mengembalikan hasil atau atribut tidak ditemukan, referensi akan kosong atau null.

Daftar nilai Tabel Data

Gunakan tindakan Daftar untuk mengambil seluruh baris dari tabel data yang cocok dengan kriteria tertentu.

Gambar berikut menunjukkan halaman Properti dari blok Tabel Data yang dikonfigurasi untuk mencantumkan nilai tabel data.

Halaman properti dari blok Tabel Data yang dikonfigurasi untuk tindakan Daftar.

Langkah-langkah konfigurasi

  1. Pilih Baca dari tabel data sebagai Tindakan.

  2. Pilih Nilai Daftar Data Tabel dari dropdown tindakan baca.

  3. Konfigurasikan Grup Nilai Utama:

    • Anda dapat menambahkan hingga 5 grup nilai utama untuk menentukan set kriteria penyaringan yang berbeda.

    • Untuk setiap kelompok nilai utama:

      • Nama Grup (Diperlukan) - Berikan nama deskriptif untuk grup nilai primer. Nama ini akan digunakan untuk mereferensikan catatan yang diambil yang ditetapkan di blok aliran berikutnya. Penting: Nama grup harus unik di seluruh alur, tidak hanya di dalam blok khusus ini.

      • Atribut Primer — Saat Anda memilih tabel data secara manual, UI secara otomatis mengisi daftar atribut utama dari skema tabel tersebut. Semua bidang atribut utama diperlukan - Anda harus memberikan nilai untuk setiap atribut utama yang ditampilkan. Atribut ini bertindak sebagai filter untuk mengidentifikasi baris tertentu dalam tabel data Anda yang akan dikembalikan.

    Catatan: Tidak seperti tindakan Evaluasi yang mengambil nilai atribut tertentu, tindakan Daftar mengembalikan seluruh catatan (semua atribut) yang cocok dengan kriteria atribut utama.

Detail kunci untuk Daftar

  • Batas grup nilai primer - Hingga 5 kelompok nilai primer per blok

  • Keunikan nama grup - Harus unik di seluruh alur kontak

  • Pencocokan atribut - Atribut primer menggunakan pencocokan yang tepat untuk menemukan baris

  • Perilaku pengembalian - Mengembalikan catatan lengkap, bukan hanya atribut yang dipilih. Jika tidak ada grup nilai primer yang dikonfigurasi, seluruh tabel akan dimuat dengan batas 32KB.

Mengakses data yang diambil untuk Daftar

Setelah menjalankan tindakan Daftar, data yang diambil disimpan dalam format terstruktur. Anda dapat mengakses data menggunakan pola namespace berikut:

  • Akses Metadata:

    • ID tabel data: $.DataTableList.Result.dataTableId

    • Versi kunci: $.DataTableList.Result.lockVersion.dataTable

  • Akses Data Daftar — Untuk mengakses data tertentu dari daftar:

    • Akses baris tertentu berdasarkan indeks: $.DataTableList.Result.primaryKeyGroups.<GroupName>[index]

    • Akses nilai kunci utama: $.DataTableList.Result.primaryKeyGroups.<GroupName>[index].primaryKeys[index].attributeValue

    • Nilai atribut akses: $.DataTableList.Result.primaryKeyGroups.<GroupName>[index].attributes[index].attributeValue

  • Penggunaan - Nilai-nilai ini dapat direferensikan dalam blok aliran berikutnya seperti:

    • Atur blok atribut kontak (untuk mengekstrak dan menyimpan nilai tertentu)

    • Panggil blok atau modul fungsi Lambda (untuk meneruskan seluruh set hasil untuk diproses)

  • Contoh - Jika Anda mengonfigurasi grup nilai utama bernama "OrderHistory“:

    • Akses baris pertama: $.DataTableList.Result.primaryKeyGroups.OrderHistory[0]

    • Akses nilai atribut pertama baris pertama: $.DataTableList.Result.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue

  • Catatan:

    • Daftar mengembalikan catatan lengkap (semua atribut), bukan hanya yang dipilih

    • Jika tidak ada catatan yang cocok ditemukan, primaryKeyGroups array akan kosong

    • Bila tidak ada grup kunci primer yang dikonfigurasi, seluruh tabel dimuat dan hasilnya dapat diakses dengan nama grup “default”: $.DataTableList.Result.primaryKeyGroups.default[index]

Menulis ke Tabel Data

Gunakan tindakan Menulis untuk membuat catatan baru atau memperbarui catatan yang ada dalam tabel data.

Gambar berikut menunjukkan halaman Properti dari blok Tabel Data yang dikonfigurasi untuk menulis ke tabel data.

Halaman properti dari blok Tabel Data yang dikonfigurasi untuk tindakan Menulis.

Langkah-langkah konfigurasi

  1. Pilih Tulis ke tabel data sebagai Tindakan.

  2. Konfigurasikan Grup Nilai Utama:

    • Anda dapat menambahkan beberapa grup nilai utama untuk menentukan catatan yang berbeda untuk ditulis atau diperbarui. Setidaknya satu kelompok nilai primer diperlukan untuk setiap blok Tabel Data Tulis.

    • Antarmuka menyediakan dua metode input melalui tab:

      • Tab input - Konfigurasi berbasis formulir terstruktur (direkomendasikan untuk sebagian besar pengguna)

      • Tab JSON mentah - Masukan JSON langsung untuk pengguna tingkat lanjut

    • Untuk setiap kelompok nilai utama:

      • Nama Grup (Diperlukan) - Berikan nama deskriptif untuk grup nilai primer. Nama ini akan digunakan untuk referensi operasi tulis di blok aliran berikutnya. Penting: Nama grup harus unik di seluruh alur, tidak hanya di dalam blok khusus ini.

      • Atribut Primer — Saat Anda memilih tabel data secara manual, UI secara otomatis mengisi daftar atribut utama dari skema tabel tersebut. Semua bidang atribut utama diperlukan - Anda harus memberikan nilai untuk setiap atribut utama yang ditampilkan. Atribut ini berfungsi sebagai bidang kunci yang menentukan record mana yang akan dibuat atau diperbarui. Jika catatan dengan nilai atribut primer yang cocok ada, itu akan diperbarui; jika tidak, catatan baru akan dibuat.

      • Konfigurasikan Atribut untuk Menulis

        • Nama Atribut (Diperlukan) - Ketika Anda memilih tabel data secara manual, dropdown secara otomatis diisi dengan semua atribut yang tersedia dari tabel tersebut. Pilih atribut yang ingin Anda tulis atau perbarui. Anda dapat menambahkan beberapa atribut dengan mengklik Tambahkan atribut untuk menulis.

        • Konfigurasi Nilai Atribut - Untuk setiap atribut, pilih salah satu opsi berikut:

          • Set nilai atribut (dipilih secara default) - Tentukan nilai untuk menulis ke atribut. Bidang ini diperlukan ketika opsi ini dipilih. Nilai dapat berupa teks statis, atribut kontak, atau variabel sistem.

          • Gunakan nilai default - Menggunakan nilai default yang ditentukan dalam skema tabel data. Tidak ada input nilai tambahan yang diperlukan saat opsi ini dipilih.

      • Konfigurasi Versi Kunci - Pengaturan versi kunci mengontrol bagaimana operasi penulisan bersamaan ke datatable ditangani:

        • Gunakan opsi Terbaru - Selalu menulis ke versi terbaru dari catatan. Cocokkan untuk sebagian besar kasus penggunaan di mana pembaruan bersamaan tidak mungkin atau dapat diterima.

        • Atur opsi dinamis - Memungkinkan Anda menentukan nomor versi secara dinamis saat runtime melalui Lambda atau modul.

Batas atribut untuk Menulis

Tindakan Write memiliki batas atribut total 25 di semua grup nilai utama dalam satu blok. Batas ini dihitung sebagai berikut:

  • Jika grup nilai primer tidak memiliki “Atribut untuk menulis” yang dikonfigurasi - Jumlah nilai atribut primer dalam grup tersebut dihitung terhadap batas total

  • Jika grup nilai primer memiliki “Atribut untuk menulis” yang dikonfigurasi - Jumlah atribut yang akan ditulis dihitung terhadap batas total (atribut primer tidak dihitung dalam kasus ini)

Contoh:

  • Contoh 1: Grup nilai primer dengan 3 atribut primer dan tidak ada atribut untuk menulis = 3 menuju batas

  • Contoh 2: Kelompok nilai primer dengan 3 atribut primer dan 5 atribut untuk menulis = 5 menuju batas

  • Contoh 3: Tiga kelompok nilai primer, masing-masing dengan 3 atribut primer dan 5 atribut untuk ditulis = 15 (5 + 5 + 5) menuju batas

Penting: Jumlah semua atribut yang dihitung di semua grup nilai primer tidak boleh melebihi 25.

Detail kunci untuk Menulis

  • Persyaratan minimum - Setidaknya satu grup nilai utama harus dikonfigurasi

  • Tidak ada batasan pada grup nilai primer - Tidak seperti tindakan Daftar, tidak ada batasan tetap pada jumlah grup nilai primer

  • Batas atribut - Jumlah total atribut yang dihitung di semua kelompok nilai primer tidak boleh melebihi 25

  • Pencocokan atribut - Atribut primer menggunakan pencocokan yang tepat untuk mengidentifikasi catatan target

  • Bidang wajib - Semua atribut utama dan nilai atribut yang dipilih (ketika “Set nilai atribut” dipilih) adalah wajib

  • Upsert behavior - Jika record dengan atribut primer yang cocok ada, itu akan diperbarui; jika tidak, catatan baru akan dibuat

Blok yang dikonfigurasi

Ketika dikonfigurasi, blok ini memiliki cabang untuk Sukses dan Kesalahan.