Home Page - Tindakan Daftar Khusus (Custom List Actions)

Mirip dengan Tindakan Kustom, Tindakan Daftar Kustom memungkinkan Anda menambahkan tindakan kustom yang dapat Anda lakukan langsung dari tampilan daftar berbagai master BizOps CRM (misalnya, Prospek, Transaksi, Organisasi). Tindakan ini meningkatkan alur kerja Anda dengan memungkinkan eksekusi tugas-tugas tertentu secara cepat tanpa perlu membuka data individual.

Jenis Tindakan Daftar

Ada dua kategori utama tindakan daftar kustom:

Tindakan: Ini mirip dengan tindakan kustom yang Anda temukan di halaman prospek/transaksi individual. Tindakan ini muncul sebagai tombol di header tampilan daftar di samping tombol buat. Contoh:

{
    "label": "Delete junk deals",
    "onClick": () => {}
}

Dalam contoh ini, tombol "Hapus transaksi sampah" ditambahkan ke tampilan daftar yang akan otomatis menghapus semua transaksi sampah. Anda dapat membuat semua jenis tindakan (Tombol Normal, Tindakan Terkelompok, Tindakan Terkelompok dengan label, dan kombinasi semuanya).

Tindakan Massal: Dirancang untuk melakukan tugas tertentu pada beberapa baris terpilih dalam tampilan daftar. Ini cocok untuk situasi di mana Anda perlu menerapkan tindakan yang sama ke sekelompok data secara bersamaan.

Contoh:

{
  "label": "Mark Won",
  "onClick": async ({ list, selections, unselectAll, call }) => {
    let docs = Array.from(selections)
    for (const doc of docs) {
        // Update the status of each selected Lead/Deal to "Won"
        let updated = await call('frappe.client.set_value', {
            doctype: 'CRM Deal',
            name: doc,
            fieldname: 'status',
            value: 'Won',
        })
    }
    unselectAll()
    list.reload()
  }
}

Dalam contoh ini, tombol "Tandai Menang" akan mengulangi setiap nama Prospek/Transaksi yang dipilih ( selections) dan memperbarui statusnya menjadi "Menang" menggunakan callmetode tersebut. Terakhir, tombol ini akan membatalkan pilihan semua baris menggunakan unselectAllmetode tersebut dan memuat ulang tampilan daftar menggunakan list.reload().

Menambahkan Tindakan Daftar Kustom

Anda dapat menentukan tindakan daftar kustom menggunakan fungsi Form Script BizOps CRM. Berikut panduan langkah demi langkahnya:

Navigasi ke Meja: Beralih ke Meja dan navigasikan ke Skrip Formulir CRM.
Pilih Doctype dan Terapkan Ke: Pilih Doctype (misalnya, Pelanggan) yang ingin Anda buatkan daftar tindakannya. Di kolom "Terapkan Ke", pilih "Daftar" dan simpan konfigurasinya. Ini akan menghasilkan cuplikan kode boilerplate.
Tentukan Tindakan: Kode boilerplate menyediakan dua opsi:
- Tindakan: Di sini, Anda dapat menentukan daftar tombol tindakan yang serupa dengan tindakan kustom pada halaman rekaman individual (lihat dokumentasi tindakan kustom untuk panduan detail tentang cara menentukan fungsi tombol tautan ). Tombol-tombol ini akan terlihat di header tampilan daftar.
- bulk_actions: Bagian ini memungkinkan Anda menentukan tombol tindakan yang dirancang khusus untuk operasi massal pada baris yang dipilih.
Konteks Daftar: Kedua jenis tindakan menggunakan kode JavaScript untuk menjalankan fungsi yang diinginkan. Anda akan memiliki akses ke listobjek sebagai parameter pada setupListdan juga pada onClickperistiwa, yang memberikan konteks berharga tentang tampilan daftar. Objek ini menawarkan fungsionalitas seperti memuat ulang daftar ( list.reload()) dan mengakses informasi tambahan. \ Selain listkonteks lain juga dilewatkan seperti $dialog, router, createToast, dan call. (untuk lebih jelasnya cek di sini )
Konteks Tindakan Massal: Saat menentukan tindakan massal, onClickperistiwa menerima konteks tambahan selain parameter standar. Konteks ini meliputi:
- pilihan: Ini adalah objek Set yang berisi nama semua baris yang dipilih saat ini dalam tampilan daftar.
- unselectAll: Ini adalah fungsi yang memungkinkan Anda membatalkan pilihan semua baris yang saat ini dipilih.

Dengan memanfaatkan tindakan daftar kustom ini secara efektif, Anda dapat menyederhanakan alur kerja dan meningkatkan pengalaman manajemen data Anda dalam BizOps CRM.

Memanfaatkan Tindakan Daftar Kustom

Tindakan Daftar Kustom menawarkan cara ampuh untuk mengotomatiskan tugas berulang pada beberapa Prospek atau Transaksi. Anda dapat memanfaatkannya untuk berbagai tujuan, seperti:

Memperbarui status untuk sekelompok Prospek/Transaksi
Mengirim email atau notifikasi massal
Mengekspor data yang dipilih untuk analisis lebih lanjut
Memicu alur kerja khusus berdasarkan tindakan massal