Membuat ekspresi menggunakan Power Fx

Artikel
02/21/2025

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 Power Fx gambaran umum dan referensi rumus.

Catatan

Power Fx rumus menggunakan Copilot Studio penomoran gaya AS. Artinya, pemisah desimal adalah titik atau titik, seperti dalam 12,567.892. Ini berarti Power Fx parameter harus dipisahkan dengan koma (,).

Prasyarat

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 Conversation.Id sistem dalam rumus, lihat variabel sistem sebagai System.Conversation.Id.

Cuplikan layar panel Masukkan rumus dengan ekspresi yang berisi variabel sistem.

Menggunakan nilai literal dalam rumus

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

Tipe	Contoh format
String	`"hi"`,, `"hello world!""copilot"`
Boolean	Hanya atau `truefalse`
Angka	`1`,, `532`, `5.258-9201`
Catatan 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 mencantumkan tipe data dan rumus yang sesuai Power Fx untuk digunakan dengan tipe data tersebut.

Tipe	Power Fx Rumus
String	Fungsi teks Fungsi Concat dan Concatenate Fungsi Len Fungsi Bawah, Atas, dan Tepat Fungsi IsMatch, Match, dan MatchAll Fungsi EndsWith dan StartsWith Cari fungsi Fungsi Ganti dan Ganti
Boolean	Fungsi Boolean Fungsi Dan, Atau, dan Tidak Fungsi If dan Switch
Angka	Fungsi Desimal, Float, dan Nilai Fungsi Int, Round, RoundDown, RoundUp, dan Trun
Catatan dan Tabel	Fungsi Concat dan Concatenate Fungsi Count, CountA, CountIf, dan CountRows Fungsi ForAll Fungsi First, FirstN, Index, Last, dan LastN Fungsi Filter, Pencarian, dan Pencarian Fungsi JSON Fungsi ParseJSON
WaktuTanggal	Fungsi Date, DateTime, dan Time Fungsi DateValue, TimeValue, dan DateTimeValue Fungsi Hari, Bulan, Tahun, Jam, Menit, Kedua, dan Hari Kerja Sekarang, Hari Ini, IsnIni, UTCNow, UTCToday, IsUTCToday fungsi 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.

Buat topik dan tambahkan simpul Pertanyaan .
Untuk Masukkan pesan, masukkan "Siapa nama Anda?".
Di bawah Identifikasi, pilih entitas Nama orang.
Pilih kotak di bawah Simpan respons pengguna sebagai, lalu pilih variabel Var1 dan beri nama. customerName
Di bawah simpul Pertanyaan , pilih + lalu pilih Atur nilai variabel.
Pilih kotak di bawah Atur variabel , lalu pilihBuat baru dan beri nama . capsName
Dalam kotak Nilai Untuk, pilih panah, lalu pilih tab Rumus >.
Di kotak fx , masukkan Upper(Text(Topic.customerName)), lalu pilih Sisipkan.
Di bawah simpul Pertanyaan , pilih + lalu pilih Kirim pesan.
Masukkan "HALO ", pilih {x}, lalu pilih capsName.

Menggunakan Power Fx rumus sebagai syarat

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

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.

Buat topik dan tambahkan simpul Pertanyaan .
Untuk Masukkan pesan, masukkan "Tanggal pemesanan?".
Di bawah Identifikasi, pilih entitas Tanggal dan waktu.
Pilih kotak di bawah Simpan respons pengguna sebagai, lalu pilih variabel Var1 dan beri nama. bookingDate
Pilih ikon Tambahkan simpul di bawah simpul Pertanyaan , lalu pilih Tambahkan kondisi .
Pilih ikon Lainnya (...) dari simpul Kondisi, lalu pilihUbah ke rumus .
Dalam kotak Fungsi , pilih > panah, lalu pilih tab Rumus .
Ganti isi kotak fx dengan rumus Topic.bookingDate > (DateAdd (Now(), 14)), lalu pilih Sisipkan.
Di bawah simpul Kondisi , tambahkan simpul Pesan dan masukkan pesan "Anda memenuhi syarat untuk mendapatkan diskon".
Di bawah simpul Semua Kondisi Lainnya, tambahkan simpul Pesan dan masukkan pesan, "Maaf, Anda tidak memenuhi syarat untuk mendapatkan diskon."

Bagikan melalui