Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat, mengedit, atau menghapus tindakan data
Tindakan data digunakan dalam aplikasi untuk menjalankan tindakan pada data entitas, seperti mengambil semua catatan, atau mengambil catatan berdasarkan ID. Tindakan data dapat digunakan untuk menemukan dan mengembalikan data yang cocok dengan kondisi tertentu untuk dilihat dalam komponen seperti tabel atau tampilan detail.
**Contents**
+ [Membuat tindakan data](#data-entities-data-action-add)
+ [Mengedit atau mengonfigurasi tindakan data](#data-entities-data-action-edit)
+ [Operator dan contoh kondisi tindakan data](#data-entities-data-action-operators)
+ [Kondisi dukungan operator oleh database](#data-entities-data-action-operators-support)
+ [Contoh kondisi tindakan data](#data-entities-data-action-operators-examples)
+ [Menghapus tindakan data](#data-entities-data-action-delete)
## Membuat tindakan data
**Tip**
Anda dapat menekan CTRL\+Z untuk membatalkan perubahan terbaru pada entitas Anda.
1. Jika perlu, navigasikan ke entitas yang ingin Anda buat tindakan datanya.
1. Pilih tab **Tindakan data**.
1. Ada dua metode untuk membuat tindakan data:
+ (Disarankan) Untuk menggunakan AI untuk menghasilkan tindakan data untuk Anda, berdasarkan nama entitas, bidang, dan sumber data yang terhubung, pilih **Hasilkan tindakan data**. Tindakan berikut akan dihasilkan:
1. `getAll`: Mengambil semua catatan dari entitas. Tindakan ini berguna ketika Anda perlu menampilkan daftar catatan atau melakukan operasi pada beberapa catatan sekaligus.
1. `getByID`: Mengambil satu catatan dari entitas berdasarkan pengenal uniknya (ID atau kunci utama). Tindakan ini berguna ketika Anda perlu menampilkan atau melakukan operasi pada catatan tertentu.
+ Untuk menambahkan tindakan data tunggal, pilih **\+ Tambahkan tindakan data**.
1. Untuk melihat atau mengonfigurasi tindakan data baru, lihat bagian berikut,[Mengedit atau mengonfigurasi tindakan data](#data-entities-data-action-edit).
## Mengedit atau mengonfigurasi tindakan data
1. Jika perlu, navigasikan ke entitas yang ingin Anda buat tindakan datanya.
1. Pilih tab **Tindakan data**.
1. Di **Bidang** konfigurasikan bidang yang akan dikembalikan oleh kueri. Secara default, semua bidang yang dikonfigurasi dalam entitas dipilih.
Anda juga dapat menambahkan **Gabungan** ke tindakan data dengan melakukan langkah-langkah berikut:
1. Pilih **\+ Tambahkan Gabung** untuk membuka kotak dialog.
1. Di **Entitas terkait**, pilih entitas yang ingin Anda gabungkan dengan entitas saat ini.
1. Di **Alias**, secara opsional masukkan nama alias sementara untuk entitas terkait.
1. Di **Jenis Gabung**, pilih jenis gabungan yang diinginkan.
1. Tentukan klausa gabungan dengan memilih bidang dari setiap entitas.
1. Pilih **Tambah** untuk membuat bergabung.
**Setelah dibuat, gabungan akan ditampilkan di bagian Gabung, membuat bidang tambahan tersedia di dropdown **Fields to Return**.** Anda dapat menambahkan beberapa gabungan, termasuk gabungan berantai di seluruh entitas. Anda juga dapat memfilter dan mengurutkan berdasarkan bidang dari entitas yang bergabung.
Untuk menghapus gabungan, pilih ikon sampah di sebelahnya. Ini akan menghapus bidang apa pun dari gabungan itu dan mematahkan gabungan atau batasan dependen apa pun menggunakan bidang tersebut.
1. Dalam **Kondisi**, tambahkan, edit, atau hapus aturan yang memfilter output kueri. Anda dapat mengatur aturan ke dalam grup, dan Anda dapat menggabungkan beberapa aturan dengan `AND` atau `OR` pernyataan. Untuk informasi selengkapnya tentang operator yang dapat Anda gunakan, lihat[Operator dan contoh kondisi tindakan data](#data-entities-data-action-operators).
1. Di **Sorting**, konfigurasikan bagaimana hasil kueri diurutkan dengan memilih atribut dan memilih urutan naik atau turun. Anda dapat menghapus konfigurasi penyortiran dengan memilih ikon sampah di sebelah aturan penyortiran.
1. Di **hasil Transform**, Anda dapat memasukkan kustom JavaScript untuk memodifikasi atau memformat hasil sebelum ditampilkan atau dikirim ke otomatisasi.
1. Di **Pratinjau keluaran**, lihat tabel pratinjau output kueri berdasarkan bidang yang dikonfigurasi, filter, pengurutan, dan JavaScript.
## Operator dan contoh kondisi tindakan data
Anda dapat menggunakan operator kondisi untuk membandingkan nilai ekspresi yang dikonfigurasi dengan kolom entitas untuk mengembalikan subset objek database. Operator yang dapat Anda gunakan bergantung pada tipe data kolom, dan jenis database yang terhubung dengan entitas, seperti Amazon Redshift, Amazon Aurora, atau Amazon DynamoDB.
Operator kondisi berikut dapat digunakan dengan semua layanan database:
+ `=`dan`!=`: Tersedia untuk semua tipe data (tidak termasuk kolom kunci primer).
+ `<=`,`>=`,`<`, dan`>=`: Hanya tersedia untuk kolom numerik.
+ `IS NULL`dan`IS NOT NULL`: Digunakan untuk mencocokkan kolom yang memiliki nilai nol atau kosong. Nilai nol sering ditafsirkan secara berbeda di setiap database, namun di App Studio, `NULL` operator mencocokkan dan mengembalikan catatan yang memiliki nilai nol dalam tabel database yang terhubung.
Operator kondisi berikut hanya dapat digunakan dalam entitas yang terhubung ke layanan database yang mendukungnya:
+ `LIKE`dan `NOT LIKE` (Redshift, Aurora): Digunakan untuk melakukan kueri berbasis pola di database yang terhubung. `LIKE`Operator menyediakan fleksibilitas dalam fungsionalitas pencarian karena menemukan dan mengembalikan catatan yang sesuai dengan pola yang ditentukan. Anda menentukan pola menggunakan karakter wildcard yang cocok dengan karakter atau urutan karakter apa pun dalam pola. Setiap sistem manajemen database memiliki satu set karakter wildcard yang unik, tetapi dua yang paling populer adalah `%` untuk mewakili sejumlah karakter (termasuk 0), dan `_` untuk mewakili satu karakter.
+ `Contains`dan `Not Contains` (DynamoDB): Digunakan untuk melakukan pencarian peka huruf besar/kecil untuk menentukan apakah teks yang diberikan ditemukan dalam nilai kolom.
+ `Starts With`dan `Not Starts With` (DynamoDB): Digunakan untuk melakukan pencarian peka huruf besar/kecil untuk menentukan apakah teks yang diberikan ditemukan di awal nilai kolom.
### Kondisi dukungan operator oleh database
Tabel berikut menunjukkan operator kondisi tindakan data yang didukung oleh setiap database yang dapat terhubung ke App Studio.
| | =, \!=, <, >, <=, >= | SEPERTI, TIDAK SUKA | Berisi, Tidak Berisi | Dimulai dengan, bukan dimulai dengan | ADALAH NULL, BUKAN NULL |
| --- | --- | --- | --- | --- | --- |
| **DynamoDB** | Ya | Tidak | Ya | Ya | Ya |
| **Aurora** | Ya | Ya | Tidak | Tidak | Ya |
| **Pergeseran Merah** | Ya | Ya | Tidak | Tidak | Ya |
### Contoh kondisi tindakan data
Pertimbangkan tabel database berikut, yang mencakup beberapa item dengan`name`,`city`, dan `hireDate` bidang.
| name | kota | HireDate |
| --- | --- | --- |
| Adam | Seattle | 2025-03-01 |
| Adrienne | Boston | 2025-03-05 |
| Bob | Albuquerque | 2025-03-06 |
| Carlos | Chicago | 2025-03-10 |
| Caroline | NULL | 2025-03-12 |
| Rita | Miami | 2025-03-15 |
Sekarang, pertimbangkan untuk membuat tindakan data di App Studio yang menampilkan `name` bidang untuk item yang cocok dengan kondisi tertentu. Daftar berikut berisi contoh kondisi dan nilai-nilai yang dikembalikan tabel untuk masing-masing.
**catatan**
Contoh diformat sebagai contoh SQL — mereka mungkin tidak muncul seperti yang mereka lakukan di App Studio, tetapi digunakan untuk menggambarkan perilaku operator.
+ `WHERE name LIKE 'Adam'`: Pengembalian`Adam`.
+ `WHERE name LIKE 'A%'`: Pengembalian `Adam` dan`Adrienne`.
+ `WHERE name NOT LIKE 'B_B'`: Pengembalian `Adam``Adrienne`,,`Carlos`,`Caroline`, dan`Rita`.
+ `WHERE contains(name, 'ita')`: Pengembalian`Rita`.
+ `WHERE begins_with(name, 'Car')`: Pengembalian `Carlos` dan`Caroline`.
+ `WHERE city IS NULL`: Pengembalian`Caroline`.
+ `WHERE hireDate < "2025-03-06"`: Pengembalian `Adam` dan`Adrienne`.
+ `WHERE hireDate >= DateTime.now().toISODate()`: Perhatikan bahwa `DateTime.now().toISODate()` mengembalikan tanggal saat ini. Dalam skenario di mana tanggal saat ini adalah 2025-03-10, ekspresi kembali`Carlos`,, dan. `Caroline` `Rita`
**Tip**
Untuk informasi selengkapnya tentang membandingkan tanggal dan waktu dalam ekspresi, lihat[Tanggal dan waktu](expressions.md#expressions-date-time).
## Menghapus tindakan data
Gunakan prosedur berikut untuk menghapus tindakan data dari entitas App Studio.
1. Jika perlu, navigasikan ke entitas yang ingin Anda hapus tindakan datanya.
1. Pilih tab **Tindakan data**.
1. **Untuk setiap tindakan data yang ingin Anda hapus, pilih menu tarik-turun di sebelah **Edit** dan pilih Hapus.**
1. Pilih **Konfirmasi** di kotak dialog.