Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Baca dokumentasi Apigee Edge.
Gunakan kebijakan FlowCallout
untuk memanggil alur bersama dari proxy API atau alur bersama lainnya.
Dalam alur bersama, Anda membuat urutan langkah yang dapat digunakan kembali pada waktu proses dari beberapa
tempat. Langkah-langkah ini diimplementasikan sebagai kebijakan, seperti dalam proxy API. Kebijakan FlowCallout
memberi Anda cara untuk memanggil alur bersama dari proxy API dan alur bersama lainnya.
Fungsi ini seperti panggilan fungsi dalam bahasa pemrograman tradisional.
- Misalnya, Anda telah membuat alur bersama dengan fitur keamanan seperti verifikasi kunci API, validasi token OAuth, dan perlindungan ekspresi reguler. Alur bersama ini
mewakili konvensi Anda tentang cara memeriksa permintaan masuk.
Dengan menggunakan kebijakan
FlowCallout
, Anda dapat memanggil alur bersama tersebut dari beberapa proxy API. - Anda dapat memanggil satu alur bersama dari alur lain dengan menerapkan kebijakan
FlowCallout
dari dalam alur bersama.
Kebijakan ini merupakan Kebijakan yang dapat diperluas, dan penggunaan kebijakan ini mungkin memiliki implikasi biaya atau pemanfaatan, bergantung pada lisensi Apigee Anda. Untuk mengetahui informasi tentang jenis kebijakan dan implikasi penggunaan, lihat Jenis kebijakan.
Sampel
Memverifikasi kunci API di alur bersama
Dalam contoh ini, alur bersama digunakan untuk melakukan tugas umum terkait keamanan. Di sini, alur bersama memvalidasi kunci API. Proxy API dan alur bersama lainnya dapat menggunakan
kebijakan FlowCallout
untuk melakukan panggilan ke alur bersama ini.
Definisi alur bersama berikut mencakup kebijakan Verify-API-Key
yang dijalankan
saat alur bersama dipanggil dari kebijakan FlowCallout
di proxy API.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <SharedFlow name="default"> <Step> <Name>Verify-API-Key</Name> </Step> </SharedFlow>
Kebijakan VerifyAPIKey
dalam alur bersama sebelumnya mengambil nilai kunci dan memverifikasinya.
<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key"> <DisplayName>Verify API Key</DisplayName> <APIKey ref="request.queryparam.apikey"/> </VerifyAPIKey>
Kebijakan FlowCallout
berikut, yang digunakan dalam proxy API, memanggil alur bersama sebelumnya untuk memverifikasi kunci API. Paket alur bersama verify-apikey-shared
(tidak ditampilkan di sini) mengonfigurasi alur bersama dengan cara paket APIProxy mengonfigurasi proxy.
<FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout"> <DisplayName>Auth Flow Callout</DisplayName> <SharedFlowBundle>verify-apikey-shared</SharedFlowBundle> </FlowCallout>
Meneruskan parameter ke alur bersama
Contoh ini menggambarkan cara meneruskan parameter dari kebijakan FlowCallout
ke
alur bersama. Di sini, kebijakan FlowCallout
memanggil alur bersama yang dirancang untuk menjalankan fungsi penanganan string yang umum. Alur bersama menyertakan JavaScript yang menggabungkan input-nya, menulis inputnya menjadi huruf kecil, atau keduanya. Kebijakan FlowCallout
menentukan parameter yang menentukan
input, output string, dan tindakan yang harus dilakukan dengan input tersebut.
Kebijakan
String-Handler
FlowCallout
memanggil alur bersama, yang meneruskan parameter yang menentukan variabel untuk menyimpan output alur bersama, operasi alur bersama apa yang digunakan, dan input apa yang akan digunakan (di sini, literal string, tetapi bisa juga berupa variabel alur). ElemenParameter
menentukan nama dan nilai variabel untuk membuat runtime. Alur bersama dapat mengambil variabel-variabel ini untuk digunakan dalam kodenya sendiri.<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler"> <DisplayName>String Handler</DisplayName> <Parameters> <Parameter name="input">Gladys Kravitz</Parameter> <Parameter name="operations">concatenate tolowercase</Parameter> <Parameter name="outputVariable">string.handler.output</Parameter> </Parameters> <SharedFlowBundle>StringHandler</SharedFlowBundle> </FlowCallout>
Alur bersama
default
berikut menyertakan kebijakan JavaScriptSharedStringFunctions
yang dijalankan saat alur bersama dipanggil dari kebijakanFlowCallout
.<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <SharedFlow name="default"> <Step> <Name>SharedStringFunctions</Name> </Step> </SharedFlow>
Dalam alur bersama, kebijakan JavaScript
SharedStringFunctions
berikut menentukan file JavaScriptSharedStringFunctions.js
dengan kode yang akan dieksekusi.<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="SharedStringFunctions"> <DisplayName>SharedStringFunctions</DisplayName> <Properties/> <ResourceURL>jsc://SharedStringFunctions.js</ResourceURL> </Javascript>
JavaScript berikut,
SharedStringFunctions.js
, dijalankan dari kebijakan JavaScriptSharedStringFunctions
. Skrip ini mengambil nilai dari variabel yang dibuat dari elemenParameter
kebijakanFlowCallout
.// Input value from the calling API proxy. var handledString = context.getVariable("input"); // Variable to use for output from this script. var outputVariable = context.getVariable("outputVariable"); // A space-separated list of things to do to the input string. // Convert to lower case to handle unintentional capitals in configuration. var operation = context.getVariable("operations").toLowerCase(); // If "lowercase" was given as an operation, convert the input to lowercase. if (operation.includes("tolowercase")) { handledString = handledString.toLowerCase(); } // If "concatenate" was given as an operation, concatenate the input. if (operation.includes("concatenate")) { handledString = handledString.replace(/\s+/g, ''); } // Assign the resulting string to the output variable specified by // the calling API proxy. context.setVariable(outputVariable, handledString);
- Eksekusi mengalir kembali dari kebijakan JavaScript, ke alur bersama, lalu ke kebijakan
FlowCallout
di proxy API asal.
Referensi elemen
Berikut adalah elemen dan atribut yang dapat Anda konfigurasi pada kebijakan ini:
<FlowCallout async="false" continueOnError="false" enabled="true" name="Flow-Callout-1"> <DisplayName>Custom label used in UI</DisplayName> <SharedFlowBundle>thereferencedsharedflowbundle</SharedFlowBundle> </FlowCallout>
Atribut <FlowCallout>
<FlowCallout async="false" continueOnError="false" enabled="true" name="Flow-Callout-1">
Tabel berikut menjelaskan atribut yang sama untuk semua elemen induk kebijakan:
Atribut | Deskripsi | Default | Kehadiran |
---|---|---|---|
name |
Nama internal kebijakan. Nilai atribut Atau, gunakan elemen |
T/A | Diperlukan |
continueOnError |
Setel ke Setel ke |
false | Opsional |
enabled |
Setel ke Setel ke |
true | Opsional |
async |
Atribut ini sudah tidak digunakan lagi. |
false | Tidak digunakan lagi |
Elemen <DisplayName>
Gunakan selain atribut name
untuk memberi label kebijakan di
editor proxy UI pengelolaan dengan nama natural-language yang berbeda.
<DisplayName>Policy Display Name</DisplayName>
Default |
T/A Jika Anda menghapus elemen ini, nilai atribut |
---|---|
Kehadiran | Opsional |
Jenis | String |
Elemen <SharedFlowBundle>
Menentukan nama alur bersama yang akan dipanggil. Nilai elemen ini harus sama dengan
nilai atribut nama elemen <SharedFlowBundle>
target.
<SharedFlowBundle/>
Dalam contoh yang paling sederhana, berikan nama alur bersama yang dipanggil sebagai nilai untuk elemen ini. Artinya, nilai elemen ini harus sama dengan nilai atribut name
alur bersama.
<SharedFlowBundle>Shared-Flow-Name</SharedFlowBundle>
Default | T/A |
---|---|
Kehadiran | Diperlukan |
Jenis | T/A |
Atribut
Tidak ada.
Elemen <Parameter>
Menentukan parameter dan nilai (atau sumber nilai) untuk diteruskan sebagai variabel ke alur bersama yang dipanggil oleh kebijakan ini.
Dengan menggunakan parameter, Anda dapat menentukan nilai (atau variabel yang berisi nilai) yang harus diteruskan ke alur bersama yang dipanggil oleh kebijakan tersebut. Secara konsep mirip dengan menentukan
parameter dalam panggilan fungsi. Seperti parameter fungsi, nilai parameter FlowCallout
dapat bervariasi berdasarkan konteks panggilan flow bersama.
Parameter FlowCallout
hanya terlihat selama eksekusi alur bersama.
Sintaksis
Anda dapat menggunakan elemen ini dengan salah satu bentuk sintaksis berikut. Perhatikan bahwa jika Anda menggunakan nilai literal, format nilai yang Anda tentukan akan bergantung pada kode yang memakainya.
<!- A literal value in an attribute. --/> <Parameter name="parameter-name" value='parameter-value' /> <!- A reference to a variable in an attribute. --/> <Parameter name="parameter-name" ref='source-variable-name' /> <!- A literal value in the element content. --/> <Parameter name="parameter-name">parameter-value</Parameter> <!- An reference to an attribute in the element content. --/> <Parameter name="parameter-name">{source-variable-name}</Parameter>
Contoh
Kebijakan String-Handler
FlowCallout
ini meneruskan parameter yang menentukan tempat
untuk menyimpan output alur bersama dan input yang akan digunakan. Elemen Parameter
menentukan nama dan nilai variabel untuk membuat runtime. Alur bersama dapat mengambil variabel ini untuk digunakan dalam kodenya sendiri.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler"> <DisplayName>String Handler</DisplayName> <Parameters> <Parameter name="input">Gladys Kravitz</Parameter> <Parameter name="outputVariable">string.handler.output</Parameter> </Parameters> <SharedFlowBundle>StringHandler</SharedFlowBundle> </FlowCallout>
Default | T/A |
---|---|
Kehadiran | Diperlukan |
Jenis | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name |
Nama variabel runtime yang akan dibuat dengan parameter ini. | Tidak ada | Diperlukan | String |
ref |
Variabel yang berisi nilai untuk digunakan pada runtime. Hapus atribut ini jika Anda menentukan nilai literal yang akan digunakan. |
Tidak ada | Opsional | String |
value |
Nilai yang akan digunakan dalam variabel runtime yang dibuat dengan parameter ini. Hapus atribut ini jika Anda menentukan nama variabel yang seharusnya menjadi sumber nilai. | Tidak ada | Opsional | String |
Elemen <Parameters>
Menentukan kumpulan elemen <Parameter> untuk diteruskan sebagai variabel ke dalam alur bersama yang dipanggil oleh kebijakan ini.
Sintaksis
<Parameters> <Parameter name="parameter-name" value='parameter-value' /> </Parameters>
Default | T/A |
---|---|
Kehadiran | Opsional |
Jenis | T/A |
Atribut
Tidak ada.
Skema
Variabel alur
Variabel alur memungkinkan perilaku kebijakan dan alur yang dinamis saat runtime, berdasarkan header HTTP, konten pesan, atau konteks alur. Untuk informasi selengkapnya tentang Variabel alur, lihat Referensi variabel.
Variabel | Deskripsi |
---|---|
|
Cakupan: Selama eksekusi flow bersama Nilai atribut nama alur bersama. |
|
Cakupan: Selama eksekusi alur bersama yang dipasang ke hook alur. Nama flow hook. |
Referensi 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 Hal yang perlu Anda ketahui tentang error kebijakan dan Menangani kesalahan.
Error runtime
Error ini dapat terjadi saat kebijakan dieksekusi.
Kode kesalahan | Status HTTP | Penyebab | Perbaikan |
---|---|---|---|
flow.SharedFlowNotFound |
500 |
Alur bersama tidak ada, atau alur bersama ada tetapi tidak di-deploy. | build |
Error saat deployment
T/A
Topik terkait
- Membuat alur bersama: Alur bersama yang dapat digunakan kembali
- Mengeksekusi alur bersama di beberapa proxy: Melampirkan alur bersama menggunakan flow hook