Kebijakan AssertCondition

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Ringkasan

Kebijakan AssertCondition mengevaluasi pernyataan kondisional pada saat runtime dalam alur permintaan atau respons. Anda dapat menentukan kondisi berdasarkan variabel alur, dan menggunakan kebijakan ini untuk menegaskan kondisinya. Suatu kondisi selalu bernilai nilai boolean, baik benar atau salah. Untuk informasi selengkapnya tentang menulis pernyataan kondisional, lihat Referensi kondisi.

Setelah mengevaluasi kondisi, kebijakan AssertCondition menyimpan hasil evaluasi dalam variabel alur assertcondition.policy-name.truthValue. Anda dapat menggunakan variabel alur yang dihasilkan dalam pemanggilan berikutnya atau logika yang diorkestrasi. Jika kondisi bernilai benar (true), nilai variabel akan disetel ke true, false. Jika Anda telah menentukan beberapa kebijakan AssertCondition, policy-name di class nama variabel membantu Anda untuk mengidentifikasi variabel secara unik.

Kebijakan ini merupakan Kebijakan standar dan dapat di-deploy ke jenis lingkungan apa pun. Tidak semua perlu diketahui pengguna tentang jenis kebijakan dan lingkungan. Sebagai informasi tentang jenis kebijakan dan ketersediaan untuk setiap jenis lingkungan, lihat Jenis kebijakan.

<AssertCondition>

Menentukan kebijakan <AssertCondition>. Dengan menggunakan kebijakan ini, Anda dapat mengevaluasi pernyataan bersyarat yang memiliki satu atau beberapa kondisi yang digabungkan dengan operator logika. Untuk informasi tentang semua operator yang didukung dalam suatu kondisi, lihat Operator.

Hasil pernyataan kondisional adalah boolean yang dapat berupa true atau false.

Nilai Default	T/A
Wajib?	Wajib
Jenis	Jenis kompleks
Elemen Induk	T/A
Elemen Turunan	<Condition> <DisplayName>

Tabel berikut memberikan deskripsi tingkat tinggi untuk elemen turunan <AssertCondition>:

Elemen Turunan	Wajib?	Deskripsi
<Condition>	Ya	Menentukan kondisi yang akan dievaluasi.
<DisplayName>	Opsional	Nama kustom untuk kebijakan.

Elemen <AssertCondition> menggunakan sintaksis berikut:

Sintaks

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition">
    <!-- Display name for this policy -->
    <DisplayName>DISPLAY_NAME</DisplayName>
    <!-- Assertion's condition where operators are defined -->
    <Condition>CONDITIONAL_STATEMENT</Condition>
</AssertCondition>

Contoh

Contoh berikut memeriksa apakah variabel google.dialogflow.my-prefix.claimAmount lebih besar dari 0 dan kurang dari 1000.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition continueOnError="false" enabled="true"
        name="MyAssertCondition">
    <DisplayName>Assert My Condition</DisplayName>
    <Condition>(google.dialogflow.my-prefix.claimAmount > 0)
                and
               (google.dialogflow.my-prefix.claimAmount LesserThan 1000)</Condition>
</AssertCondition>

Dalam contoh ini:

• Jika nilai variabel google.dialogflow.my-prefix.claimAmount adalah 500, kondisi bernilai benar, sehingga Variabel assertcondition.MyAssertCondition.truthValue ditetapkan ke true.
• Namun, jika nilai variabel google.dialogflow.my-prefix.claimAmount adalah 1.200, variabel assertcondition.MyAssertCondition.truthValue ditetapkan ke false.

Elemen ini memiliki atribut berikut yang sama untuk semua kebijakan:

Atribut	Default	Wajib?	Deskripsi
name	T/A	Wajib	Nama internal kebijakan. Nilai atribut name dapat berisi huruf, angka, spasi, tanda hubung, garis bawah, dan titik. Nilai ini tidak boleh melebihi 255 karakter. Atau, gunakan elemen <DisplayName> untuk memberi label kebijakan di editor proxy UI pengelolaan dengan nama natural-language yang berbeda.
continueOnError	false	Opsional	Setel ke false untuk menampilkan error jika kebijakan gagal. Ini adalah perilaku yang wajar untuk sebagian besar kebijakan. Setel ke true agar eksekusi alur tetap berlanjut bahkan setelah kebijakan gagal. Lihat juga: Aturan error HANYA dipicu dalam status error (tentang continueOnError) Menangani kesalahan dalam alur saat ini
enabled	true	Opsional	Setel ke true untuk menerapkan kebijakan. Setel ke false untuk menonaktifkan kebijakan. Kebijakan tidak akan diterapkan meskipun tetap melekat pada alur.
async	false	Tidak digunakan lagi	Atribut ini sudah tidak digunakan lagi.

Referensi elemen turunan

Bagian ini menjelaskan elemen turunan dari <AssertCondition>.

<Condition>

Menentukan kondisi yang akan dievaluasi. Untuk informasi selengkapnya tentang menulis pernyataan kondisional di Apigee, lihat Referensi kondisi.

Nilai Default	T/A
Wajib?	Wajib
Jenis	String
Elemen Induk	<AssertCondition>
Elemen Turunan	Tidak ada

<DisplayName>

Gunakan selain atribut name untuk memberi label kebijakan di editor proxy UI pengelolaan dengan nama yang berbeda dan lebih alami.

Elemen <DisplayName> bersifat umum untuk semua kebijakan.

Nilai Default	T/A
Wajib?	Opsional. Jika Anda menghilangkan <DisplayName>, nilai atribut name kebijakan akan digunakan.
Jenis	String
Elemen Induk	<PolicyElement>
Elemen Turunan	Tidak ada

Elemen <DisplayName> menggunakan sintaksis berikut:

Sintaksis

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Contoh

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

Elemen <DisplayName> tidak memiliki atribut atau elemen turunan.

Kode error

Bagian ini menjelaskan kode kesalahan dan pesan error yang ditampilkan dan variabel kesalahan yang disetel oleh Apigee saat kebijakan ini memicu error. Informasi ini penting untuk diketahui apakah Anda mengembangkan aturan kesalahan untuk menangani kesalahan. Untuk mempelajari lebih lanjut, lihat Yang perlu Anda ketahui tentang error kebijakan dan Menangani kesalahan.

Error runtime

Error ini dapat terjadi saat kebijakan dieksekusi.

Kode kesalahan	Status HTTP	Penyebab
steps.assertcondition.ConditionEvaluationFailed	500	Gagal mengevaluasi pernyataan kondisional. Ada banyak alasan terjadinya error ini, termasuk nilai yang salah dalam variabel pada saat runtime.

Error saat deployment

Error ini dapat terjadi saat Anda men-deploy proxy yang berisi kebijakan ini.

Nama error	Penyebab
InvalidCondition	Kebijakan tidak dapat memvalidasi pernyataan kondisional. Ada banyak alasan error ini terjadi, termasuk kondisi yang salah format atau penggunaan operator yang tidak didukung.

Variabel kesalahan

Setiap kali terjadi error eksekusi dalam kebijakan, Apigee akan menghasilkan pesan error. Anda dapat melihat pesan error ini dalam respons error. Sering kali, pesan error yang dihasilkan sistem mungkin tidak relevan dalam konteks produk Anda. Anda mungkin ingin menyesuaikan pesan error berdasarkan jenis error agar pesan menjadi lebih bermakna.

Untuk menyesuaikan pesan error, Anda dapat menggunakan aturan kesalahan atau kebijakan RaiseFault. Untuk mengetahui informasi tentang perbedaan antara aturan fault dan kebijakan RaiseFault, lihat kebijakan FaultRules vs. RaiseFault. Anda harus memeriksa kondisi menggunakan elemen Condition di aturan fault dan kebijakan RaiseFault. Apigee menyediakan variabel kesalahan yang unik untuk setiap kebijakan dan nilai variabel kesalahan ditetapkan saat kebijakan memicu error runtime. Dengan menggunakan variabel ini, Anda dapat memeriksa kondisi error tertentu dan mengambil tindakan yang sesuai. Untuk mengetahui informasi selengkapnya tentang cara memeriksa kondisi error, lihat Mem-build kondisi.

Tabel berikut menjelaskan variabel kesalahan khusus untuk kebijakan ini.

Variabel	Dari mana	Contoh
fault.name="FAULT_NAME"	FAULT_NAME adalah nama kesalahan, seperti yang tercantum dalam tabel Error runtime. Nama kesalahan adalah bagian terakhir dari kode kesalahan.	fault.name Matches "ConditionEvaluationFailed"
AssertCondition.POLICY_NAME.failed	POLICY_NAME adalah nama kebijakan yang ditentukan pengguna yang menampilkan kesalahan.	AssertCondition.My-AssertCondition.failed = true

Untuk informasi selengkapnya tentang error kebijakan, lihat Yang perlu Anda ketahui tentang error kebijakan.