Membuat ekspresi dengan menggunakan Power Fx

Power Fx adalah bahasa kode rendah yang menggunakan rumus seperti Excel. Gunakan Power Fx untuk membuat logika kompleks yang memungkinkan agen Anda memanipulasi data. Misalnya, rumus Power Fx dapat mengatur nilai variabel, mengurai string, atau menggunakan ekspresi dalam kondisi. Untuk informasi selengkapnya, lihat gambaran umum Power Fx dan referensi rumus.

Catatan

Rumus Power Fx di Copilot Studio menggunakan penomoran gaya AS. Artinya, pemisah desimal adalah titik, seperti dalam 12,567.892. Ini berarti Anda harus menggunakan koma (,) sebagai pemisah parameter untuk rumus Power Fx Anda.

Prasyarat

• Membuat dan mengedit topik
• Ikhtisar variabel

Menggunakan variabel dalam rumus

Untuk menggunakan variabel dalam rumus Power Fx , Anda harus menambahkan awalan ke namanya untuk menunjukkan cakupan variabel:

• Untuk variabel sistem, gunakan System.
• Untuk variabel global. gunakan Global.
• Untuk variabel topik, gunakan Topic.

Misalnya, untuk menggunakan variabel sistem Conversation.Id dalam rumus, lihat variabel sistem sebagai System.Conversation.Id.

Menggunakan nilai harfiah dalam rumus

Selain menggunakan variabel dalam rumus Power Fx , Anda dapat memasukkan nilai harfiah. Untuk menggunakan nilai harfiah dalam rumus, Anda harus memasukkannya dalam format yang sesuai dengan jenisnya. Tabel berikut mencantumkan jenis data dan format nilai harfiah yang sesuai.

Tipe	Contoh format
String	"hi", "hello world!", "copilot"
Boolean	Hanya true atau false
Angka	1, 532, 5.258,-9201
Rekaman dan Tabel	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
WaktuTanggal	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Pilihan	Tidak didukung
Kosong	Hanya Blank()

Rumus umum Power Fx

Tabel berikut ini mencantumkan tipe data dan rumus Power Fx yang bisa Anda gunakan dengan setiap tipe data.

Tipe	Rumus Power Fx
String	Fungsi Teks Fungsi Concat dan Satukan Fungsi Len Fungsi Lower, Upper, dan Proper Fungsi IsMatch, Match, dan MatchAll Fungsi EndsWith dan StartsWith Fungsi Find Fungsi Replace dan Substitute
Boolean	Fungsi Boolean Fungsi And, Or, dan Not Fungsi If dan Switch
Angka	Fungsi Desimal, Float, dan Nilai Fungsi Int, Round, RoundDown, RoundUp, dan Trunc
Rekaman dan Tabel	Fungsi Concat dan Satukan Fungsi Count, CountA, CountIf, dan CountRows Fungsi ForAll Fungsi First, FirstN, Index, Last, dan LastN Fungsi Filter, Search, dan LookUp Fungsi JSON Fungsi ParseJSON
WaktuTanggal	Fungsi Date, DateTime, dan Time Fungsi DateValue, TimeValue, dan DateTimeValue Fungsi Day, Month, Year, Hour, Minute, Second, dan Weekday fungsi Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Fungsi DateAdd, DateDiff, dan TimeZoneOffset Fungsi Teks
Kosong	Fungsi Blank, Coalesce, IsBlank, dan IsEmpty Fungsi Error, IfError, IsError, IsBlankOrError

Gunakan Power Fx untuk mengatur variabel

Dalam contoh ini, ekspresi Power Fx menyimpan dan menampilkan nama pelanggan dalam huruf kapital.

1. Buat topik dan tambahkan node Pertanyaan.

2. Untuk Memasukkan pesan, masukkan "Siapa nama Anda?".

3. Di bawah Identifikasi, pilih entitas Nama orang.

4. Pilih kotak di bawah Simpan respons pengguna sebagai, lalu pilih variabel Var1 dan beri nama customerName.

5. Di bawah node Pertanyaan , pilih + lalu pilih Atur nilai variabel.

6. Pilih kotak di bawah Atur variabel, lalu pilih Buat baru dan beri nama capsName.

7. Dalam kotak To value, pilih panah >, lalu pilih tab Rumus.

8. Di kotak fx , masukkan Upper(Text(Topic.customerName)), lalu pilih Sisipkan.

   

9. Di bawah node Pertanyaan , pilih + lalu pilih Kirim pesan.

10. Masukkan "HALO ", pilih {x}, lalu pilih capsName.

    

Menggunakan Power Fx rumus sebagai syarat

Untuk mengevaluasi ekspresi yang lebih kompleks, siapkan node Kondisi untuk menggunakan rumus Power Fx.

Dalam contoh ini, agen menentukan apakah tanggal pemesanan memenuhi syarat untuk diskon. Untuk melakukan itu, ia memeriksa apakah tanggal pemesanan yang diberikan oleh pelanggan adalah 14 hari atau lebih dari tanggal saat ini.

1. Buat topik dan tambahkan node Pertanyaan.

2. Untuk Masukkan pesan, masukkan "Tanggal pemesanan?".

3. Di bawah Identifikasi, pilih entitas Tanggal dan waktu.

4. Pilih kotak di bawah Simpan respons pengguna sebagai, lalu pilih variabel Var1 dan beri nama bookingDate.

   

5. Pilih ikon Tambahkan node di bawah node Pertanyaan, lalu pilih Tambahkan kondisi.

6. Pilih ikon Lainnya (...) dari node Kondisi, lalu pilih Ubah ke rumus.

7. Dalam kotak Function, pilih panah >, lalu pilih tab Rumus.

8. Ganti isi kotak fx dengan rumus Topic.bookingDate > (DateAdd (Now(), 14)), lalu pilih Sisipkan.

9. Di bawah node Kondisi , tambahkan node Pesan dan masukkan pesan "Anda memenuhi syarat untuk mendapatkan diskon".

10. Di bawah node Semua Kondisi Lainnya, tambahkan node Pesan dan masukkan pesan, "Maaf, Anda tidak memenuhi syarat untuk mendapatkan diskon."