Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Baca dokumentasi Apigee Edge.
Apa
Kebijakan ExtractVariables mengekstrak konten dari permintaan atau respons dan menetapkan nilai variabel ke konten tersebut. Anda dapat mengekstrak setiap bagian pesan, termasuk header, jalur URI, payload JSON/XML, parameter formulir, dan parameter kueri. Kebijakan ini bekerja dengan menerapkan pola teks ke konten pesan dan, setelah menemukan kecocokan, menetapkan variabel dengan konten pesan yang ditentukan.
Meskipun Anda sering menggunakan ExtractVariables untuk mengekstrak informasi dari pesan permintaan atau respons, Anda juga dapat menggunakannya untuk mengekstrak informasi dari sumber lain, termasuk entity yang dibuat oleh kebijakan AccessEntity, objek XML, atau objek JSON.
Setelah mengekstrak konten pesan yang ditentukan, Anda dapat mereferensikan variabel dalam kebijakan lain sebagai bagian dari pemrosesan permintaan dan respons.
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.
Video
Tonton video berikut untuk mempelajari kebijakan ExtractVariables lebih lanjut.
Video | Deskripsi |
---|---|
Mengekstrak variabel dari payload XML | Ekstrak variabel dari payload XML menggunakan kebijakan Ekstrak Variabel. |
Mengekstrak variabel dari payload JSON | Ekstrak variabel dari payload JSON menggunakan kebijakan Ekstrak Variabel. |
Mengekstrak variabel dari parameter | Ekstrak variabel dari parameter, seperti parameter kueri, header, formulir, atau URI. |
Mengekstrak variabel dari parameter multinilai | Mengekstrak variabel dari parameter multinilai. |
Sampel
Contoh kode kebijakan ini menggambarkan cara mengekstrak variabel dari jenis artefak berikut:
URI
<ExtractVariables name="ExtractVariables-1"> <DisplayName>Extract a portion of the url path</DisplayName> <Source>request</Source> <URIPath> <Pattern ignoreCase="true">/accounts/{id}</Pattern> </URIPath> <VariablePrefix>urirequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Pertimbangkan contoh kode kebijakan di atas. Elemen <URIPath>
memberi tahu kebijakan ExtractVariables untuk mengekstrak informasi dari jalur URI. Elemen
<Pattern>
menentukan pola yang akan diterapkan ke jalur URI. Polanya diperlakukan sebagai template sederhana, dengan tanda kurung kurawal yang menunjukkan bagian yang bervariasi dari jalur URI.
Nama variabel yang akan ditetapkan ditentukan oleh nilai yang ditetapkan dalam
elemen <VariablePrefix>
, serta nilai yang diapit tanda kurung kurawal {}
dalam elemen <Pattern>
. Kedua nilai tersebut digabungkan dengan titik intervensi,
sehingga menghasilkan nama variabel urirequest.id
misalnya. Jika tidak ada elemen <VariablePrefix>
, nama variabel hanya nilai yang diapit tanda kurung kurawal.
Pertimbangkan contoh kode kebijakan di atas yang berfungsi dengan permintaan masuk berikut:
GET http://example.com/svc1/accounts/12797282
Misalkan jalur dasar untuk Proxy API adalah /svc1
. Saat menerapkan kode kebijakan ExtractVariables di atas ke permintaan masuk ini, Apigee akan menetapkan variabel urirequest.id
ke 12797282
. Setelah Apigee mengeksekusi kebijakan, kebijakan atau kode berikutnya dalam alur pemrosesan dapat merujuk ke variabel bernama urirequest.id
untuk mendapatkan nilai string 12797282
.
Misalnya, kebijakanAssignMessage berikut menyematkan nilai variabel tersebut ke dalam payload pesan permintaan baru:
<AssignMessage async="false" continueOnError="false" enabled="true" name="AssignPayload"> <DisplayName>AssignPayload</DisplayName> <Set> <Payload contentType="text/xml"> <IdExtractedFromURI>{urirequest.id}</IdExtractedFromURI> </Payload> </Set> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="true" transport="http" type="request">newRequest</AssignTo> </AssignMessage>
Parameter kueri
<ExtractVariables name="ExtractVariables-2"> <DisplayName>Extract a value from a query parameter</DisplayName> <Source>request</Source> <QueryParam name="code"> <Pattern ignoreCase="true">DBN{dbncode}</Pattern> </QueryParam> <VariablePrefix>queryinfo</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Pertimbangkan contoh kode kebijakan di atas yang berfungsi dengan permintaan masuk berikut:
GET http://example.com/accounts/12797282?code=DBN88271
Saat menerapkan kode kebijakan ExtractVariables di atas ke permintaan masuk ini, Apigee akan menetapkan variabel queryinfo.dbncode
ke 88271
. Setelah Apigee mengeksekusi kebijakan, kebijakan atau kode berikutnya dalam alur pemrosesan dapat merujuk ke variabel bernama queryinfo.dbncode
untuk mendapatkan nilai string 88271
.
Anda sekarang dapat mengakses variabel queryinfo.dbncode
di proxy Anda.
Misalnya, kebijakanAssignMessage berikut akan menyalinnya ke payload permintaan:
<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath"> <DisplayName>GetQP</DisplayName> <Set> <Payload contentType="text/xml"> <ExtractQP>{queryinfo.dbncode}</ExtractQP> </Payload> </Set> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
Beberapa parameter
<ExtractVariables name="ExtractVariables-2"> <DisplayName>Extract a value from a query parameter</DisplayName> <Source>request</Source> <QueryParam name="w"> <Pattern ignoreCase="true">{firstWeather}</Pattern> </QueryParam> <QueryParam name="w.2"> <Pattern ignoreCase="true">{secondWeather}</Pattern> </QueryParam> <VariablePrefix>queryinfo</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Misalnya desain API memungkinkan Anda menetapkan beberapa parameter kueri dengan nama yang sama. Anda dapat menggunakan kebijakan ExtractVariables untuk mengekstrak nilai beberapa instance parameter kueri. Untuk mereferensikan parameter kueri dengan nama yang sama dalam kebijakan, gunakan indeks yang instance pertama parameter kuerinya tidak memiliki indeks, yang kedua ada di indeks 2, yang ketiga ada di indeks 3, dan seterusnya.
Pertimbangkan contoh kode kebijakan di atas yang berfungsi dengan permintaan masuk berikut:
GET http://example.com/weather?w=Boston&w=Chicago
Saat menerapkan kode kebijakan ExtractVariables di atas ke permintaan masuk ini, Apigee akan menetapkan variabel queryinfo.firstWeather
ke Boston
dan variabel queryInfo.secondWeather
ke Chicago
.
Anda sekarang dapat mengakses variabel queryinfo.firstWeather
dan queryinfo.secondWeather
di proxy Anda. Misalnya, kebijakanAssignMessage berikut menyalinnya ke payload
permintaan:
<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath"> <DisplayName>GetQP</DisplayName> <Set> <Payload contentType="text/xml"> <ExtractQP1>{queryinfo.firstWeather}</ExtractQP1> <ExtractQP2>{queryinfo.secondWeather}</ExtractQP2> </Payload> </Set> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
Header
<ExtractVariables name='ExtractVariable-OauthToken'> <Source>request</Source> <Header name="Authorization"> <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern> </Header> <VariablePrefix>clientrequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Misalkan API Anda menggunakan token pembawa OAuth v2.0. Pertimbangkan contoh kode kebijakan di atas
menangani permintaan yang berisi token OAuth v2.0 yang menyertakan header seperti ini:
Authorization: Bearer TU08xptfFfeM7aS0xHqlxTgEAdAM.
Sebagai desainer API, anggaplah Anda ingin menggunakan nilai token (tetapi tidak seluruh header) sebagai kunci dalam pencarian cache. Anda dapat menggunakan kode kebijakan ExtractVariables di atas untuk mengekstrak token.
Saat menerapkan kode kebijakan ExtractVariables di atas ke header ini, Apigee akan menetapkan variabel clientrequest.oauthtoken
ke TU08xptfFfeM7aS0xHqlxTgEAdAM
.
Sekarang Anda dapat mengakses variabel clientrequest.oauthtoken
di proxy. Misalnya, kebijakan TetapkanMessage berikut menyalinnya ke payload
permintaan:
<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath"> <DisplayName>GetHeader</DisplayName> <Set> <Payload contentType="text/xml"> <ExtractHeader>{clientrequest.oauthtoken}</ExtractHeader> </Payload> </Set> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
JSON
<ExtractVariables name="ExtractVariables-3"> <Source>response</Source> <JSONPayload> <Variable name="latitude" type="float"> <JSONPath>$.results[0].geometry.location.lat</JSONPath> </Variable> <Variable name="longitude" type="float"> <JSONPath>$.results[0].geometry.location.lng</JSONPath> </Variable> </JSONPayload> <VariablePrefix>geocoderesponse</VariablePrefix> </ExtractVariables>
Pertimbangkan payload respons JSON berikut:
{ "results": [{ "geometry": { "location": { "lat": 37.42291810, "lng": -122.08542120 }, "location_type": "ROOFTOP", "viewport": { "northeast": { "lat": 37.42426708029149, "lng": -122.0840722197085 }, "southwest": { "lat": 37.42156911970850, "lng": -122.0867701802915 } } } }] }
Saat menerapkan kode kebijakan ExtractVariables di atas ke pesan JSON ini, Apigee akan menetapkan dua variabel: geocoderesponse.latitude
dan geocoderesponse.longitude
. Kedua variabel menggunakan awalan variabel yang sama, yaitu geocoderesponse
. Akhiran untuk variabel ini ditentukan secara eksplisit oleh
atribut name
elemen <Variable>
.
Variabel geocoderesponse.latitude
mendapatkan nilai
37.42291810
. Variabel geocoderesponse.longitude
mendapatkan nilai
-122.08542120
.
Sekarang Anda dapat mengakses variabel geocoderesponse.latitude
di proxy. Misalnya, kebijakan ConfigureMessage berikut akan menyalinnya ke header bernama
latitude
dalam respons:
<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath"> <DisplayName>GetJSONVar</DisplayName> <Add> <Headers> <Header name="latitude">{geocoderesponse.latitude}</Header> </Headers> </Add> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="false" transport="http" type="response"/> </AssignMessage>
XML
<ExtractVariables name="ExtractVariables-4"> <Source>response</Source> <XMLPayload> <Namespaces> <Namespace prefix="dir">urn:43BFF88D-D204-4427-B6BA-140AF393142F</Namespace> </Namespaces> <Variable name="travelmode" type="string"> <XPath>/dir:Directions/dir:route/dir:leg/dir:step/@mode</XPath> </Variable> <Variable name="duration" type="string"> <XPath>/dir:Directions/dir:route/dir:leg/dir:step/dir:duration/dir:value</XPath> </Variable> <Variable name="timeunit" type="string"> <XPath>/dir:Directions/dir:route/dir:leg/dir:step/dir:duration/dir:text</XPath> </Variable> </XMLPayload> <VariablePrefix>directionsresponse</VariablePrefix> </ExtractVariables>
Pertimbangkan payload respons XML berikut:
<Directions xmlns="urn:43BFF88D-D204-4427-B6BA-140AF393142F"> <status>OK</status> <route> <summary>I-40 W</summary> <leg> <step mode="DRIVING"> <start_location> <lat>41.8507300</lat> <lng>-87.6512600</lng> </start_location> <end_location> <lat>41.8525800</lat> <lng>-87.6514100</lng> </end_location> <duration> <value>19</value> <text>minutes</text> </duration> </step> </leg> </route> </Directions>
Saat menerapkan kode kebijakan ExtractVariables di atas ke pesan XML ini, Apigee akan menetapkan tiga variabel:
directionsresponse.travelmode
: Mendapatkan nilaiDRIVING
directionsresponse.duration
: Mendapatkan nilai19
directionsresponse.timeunit
: Mendapatkan nilaiminutes
Semua variabel menggunakan awalan variabel directionsresponse
yang sama. Akhiran untuk
variabel ini ditentukan secara eksplisit oleh atribut
name
milik elemen <Variable>
.
Sekarang Anda dapat mengakses variabel directionresponse.travelmode
di proxy Anda. Misalnya, kebijakanAssignMessage berikut menyalinnya ke header bernama
tmode
dalam respons:
<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath"> <DisplayName>GetXMLVar</DisplayName> <Add> <Headers> <Header name="tmode">{directionsresponse.travelmode}</Header> </Headers> </Add> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
Tentang kebijakan ExtractVariables
Developer API membuat proxy API yang berperilaku berbeda berdasarkan konten pesan, termasuk header, jalur URI, payload, dan parameter kueri. Sering kali, proxy mengekstrak beberapa bagian dari konten ini untuk digunakan dalam pernyataan kondisi. Gunakan kebijakan ExtractVariables untuk melakukannya.
Saat menentukan kebijakan ExtractVariables, Anda dapat memilih:
- Nama variabel yang akan ditetapkan
- Sumber variabel
- Berapa banyak variabel yang harus diekstrak dan ditetapkan
Jika dijalankan, kebijakan akan menerapkan pola teks pada konten dan, setelah menemukan kecocokan, menetapkan nilai variabel yang ditetapkan bersama konten tersebut. Selanjutnya, kebijakan dan kode lain dapat memakai variabel tersebut untuk mengaktifkan perilaku dinamis atau mengirim data bisnis ke Apigee API Analytics.
Cakupan
Variabel yang ditetapkan dengan kebijakan ExtractVariables memiliki cakupan global. Artinya, setelah kebijakan ExtractVariables menentukan variabel baru, Anda dapat mengakses variabel tersebut dari kebijakan atau kode apa pun di setiap tahap alur (yang dijalankan setelah kebijakan ExtractVariables). Hal ini mencakup:
- PreFlow: ProxyEndpoint dan TargetEndpoint (Permintaan dan Respons)
- PostFlow: ProxyEndpoint dan TargetEndpoint (Permintaan dan Respons)
- PostClientFlow: ProxyEndpoint (Hanya respons, menggunakan kebijakan MessageLogging>)
- Alur Error
Tentang pencocokan dan pembuatan variabel
Kebijakan ExtractVariables mengekstrak informasi dari permintaan atau respons dan menulis informasi tersebut ke variabel. Untuk setiap jenis informasi yang dapat diekstrak, seperti jalur URI atau data XML, Anda menentukan pola yang akan dicocokkan dan nama variabel yang digunakan untuk menyimpan informasi yang diekstrak.
Namun, cara kerja pencocokan pola bergantung pada sumber ekstraksi. Bagian berikut menjelaskan dua kategori dasar informasi yang dapat Anda ekstrak.
Mencocokkan jalur URI, parameter kueri, header, parameter formulir, dan variabel
Saat mengekstrak informasi dari jalur URI, parameter kueri, header, parameter formulir, dan variabel, Anda menggunakan tag <Pattern>
untuk menentukan satu atau beberapa pola yang akan dicocokkan. Misalnya, contoh kebijakan berikut menunjukkan satu pola yang cocok untuk
jalur URI:
<ExtractVariables name="ExtractVariables-1"> <Source>request</Source> <URIPath> <Pattern ignoreCase="true">/a/{pathSeg}</Pattern> </URIPath> <VariablePrefix>urirequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Dalam contoh ini, variabel urirequest.pathSeg
disetel ke
apa pun yang muncul dalam proxy.pathsuffix setelah /a/
. Misalnya, jalur dasar untuk Proxy API Anda adalah /basepath/v1
. Dengan permintaan masuk ke http://myCo.com/basepath/v1/a/b
, variabel ditetapkan ke b
.
Menentukan beberapa pola
Anda dapat menentukan beberapa pola yang akan dicocokkan, sesuai dengan tag <Pattern>
,
dengan:
- Semua pola diuji untuk kecocokan.
- Jika tidak ada pola yang cocok, kebijakan tidak akan melakukan apa pun dan variabel tidak akan dibuat.
- Jika lebih dari satu pola cocok, pola dengan segmen jalur terpanjang akan digunakan untuk ekstraksi.
- Jika dua pola yang cocok memiliki segmen jalur terpanjang yang sama, pola yang ditentukan pertama kali dalam kebijakan akan digunakan untuk ekstraksi.
Pada contoh berikutnya, Anda membuat kebijakan yang berisi tiga pola yang cocok untuk jalur URI:
<ExtractVariables name="ExtractVariables-1"> <Source>request</Source> <URIPath> <Pattern ignoreCase="true">/a/{pathSeg}</Pattern> <Pattern ignoreCase="true">/a/b/{pathSeg}</Pattern> <Pattern ignoreCase="true">/a/b/c/{pathSeg}</Pattern> </URIPath> <VariablePrefix>urirequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Misalnya, untuk Proxy API dengan jalur dasar /basepath/v1
, URL permintaan masuk ke proxy API adalah bentuk berikut:
http://myCo.com/basepath/v1/a/b
Dalam contoh ini, pola pertama cocok dengan URI dan variabel
urirequest.pathSeg
ditetapkan ke b
.
Jika URL permintaan:
http://myCo.com/basepath/v1/a/b/c/d
...maka pola ketiganya cocok dan variabel urirequest.pathSeg
ditetapkan ke d
.
Menentukan pola dengan beberapa variabel
Anda dapat menentukan beberapa variabel dalam pola yang cocok. Misalnya, Anda menentukan pola yang cocok dengan dua variabel:
<ExtractVariables name="ExtractVariables-1"> <Source>request</Source> <URIPath> <Pattern ignoreCase="true">/a/{pathSeg}</Pattern> <Pattern ignoreCase="true">/a/b/{pathSeg}</Pattern> <Pattern ignoreCase="true">/a/{pathSeg1}/c/{pathSeg2}</Pattern> </URIPath> <VariablePrefix>urirequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Sekali lagi, anggap Proxy API dengan jalur dasar /basepath/v1
, untuk URL permintaan masuk:
http://myCo.com/basepath/v1/a/b/c/d
...variabel urirequest.pathSeg1
disetel ke b
dan
variabel urirequest.pathSeg2
disetel ke d
.
Mencocokkan beberapa instance dalam pola
Anda juga dapat mencocokkan pola jika ada beberapa item dengan nama yang sama. Misalnya, Anda dapat membuat permintaan yang berisi beberapa parameter kueri atau beberapa header dengan nama yang sama. Permintaan berikut berisi dua parameter kueri bernama "w":
http://myCo.com/basepath/v1/a/b/c/d?w=1&w=2
Untuk mereferensikan parameter kueri ini dalam kebijakan ExtractVariables, Anda menggunakan indeks, dengan instance pertama parameter kueri tidak memiliki indeks, yang kedua ada di indeks 2, yang ketiga ada di indeks 3, dst. Misalnya, kebijakan berikut mengekstrak nilai parameter kueri kedua bernama "w" dalam permintaan:
<ExtractVariables name="ExtractVariables-1"> <Source>request</Source> <QueryParam name="w.2"> <Pattern ignoreCase="true">{secondW}</Pattern> </QueryParam> <VariablePrefix>urirequest</VariablePrefix> <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables> </ExtractVariables>
Variabel urirequest.secondW
ditetapkan ke "2". Jika parameter kueri kedua dihilangkan dari permintaan, variabel urirequest.secondW
akan kosong. Gunakan pengindeksan setiap kali ada beberapa item dengan nama yang sama dalam permintaan.
Menggunakan karakter khusus dalam pola
Saat mencocokkan jalur URI, Anda dapat menggunakan karakter pengganti "*" dan "**" dalam pola, dengan kondisi:
- "*" cocok dengan salah satu segmen jalur
- "**" cocok dengan beberapa segmen jalur
Misalnya, Anda menentukan pola ke elemen <URIPath>
seperti yang ditunjukkan
di bawah ini:
<URIPath> <Pattern ignoreCase="true">/a/*/{id}</Pattern> <Pattern ignoreCase="true">/a/**/{id}</Pattern> </URIPath>
Pola pertama mencocokkan permintaan dengan jalur (bagian dari jalur URI setelah jalur dasar) seperti "/a/b/c", "/a/foo/bar", dll. Pola kedua cocok dengan sejumlah segmen jalur setelah "/a/", seperti "/a/foo/bar/baz/c", serta "/a/b/c" dan "/a/foo/bar".
Saat menentukan pola untuk parameter kueri, header, dan parameter formulir, karakter "*" ditetapkan agar cocok dengan berapa pun jumlah karakter. Misalnya, saat mencocokkan header, tentukan pola sebagai:
*;charset={encoding}
Pola ini cocok dengan nilai "text/xml;charset=UTF-16" dan "application/xml;charset=ASCII".
Jika nilai yang diteruskan ke kebijakan ExtractVariables berisi karakter khusus, seperti "{", gunakan karakter "%" untuk meng-escape karakter tersebut. Contoh berikut meng-escape karakter "{" dan "}" dalam pola karena digunakan sebagai karakter literal dalam nilai parameter kueri:
<QueryParam> <Pattern ignoreCase="true">%{user%} {name}</Pattern> </QueryParam>
Dalam contoh ini, pola cocok dengan nilai "{user} Steve", tetapi tidak dengan nilai "user Steve".
Mencocokkan JSON dan XML
Saat mengekstrak data dari JSON dan XML, Anda harus menentukan satu atau beberapa tag <Variable>
dalam kebijakan.
Tag <Variable>
menentukan nama
variabel tujuan tempat informasi yang diekstrak disimpan, dan JsonPath
(JSON) atau XPATH (XML) untuk informasi yang diekstrak,
Semua tag <Variable>
dalam kebijakan
akan dievaluasi, sehingga Anda dapat mengisi beberapa variabel dari satu kebijakan. Jika
tag <Variable>
tidak
mengevaluasi ke kolom yang valid di JSON atau XML, variabel yang sesuai tidak akan
dibuat.
Contoh berikut menunjukkan kebijakan ExtractVariables yang mengisi dua variabel dari isi JSON suatu respons:
<ExtractVariables name="ExtractVariables-3"> <Source>response</Source> <JSONPayload> <Variable name="latitude" type="float"> <JSONPath>$.results[0].geometry.location.lat</JSONPath> </Variable> <Variable name="longitude" type="float"> <JSONPath>$.results[0].geometry.location.lng</JSONPath> </Variable> </JSONPayload> <VariablePrefix>geocoderesponse</VariablePrefix> </ExtractVariables>
Menulis ke variabel yang sama di beberapa tempat
Berhati-hatilah saat memilih nama variabel yang akan ditetapkan. Kebijakan ini dijalankan secara berurutan dari pola ekstraksi pertama hingga terakhir. Jika kebijakan ini menulis nilai ke variabel yang sama dari beberapa tempat, penulisan terakhir dalam kebijakan akan menentukan nilai variabel. (Ini mungkin yang Anda inginkan.)
Misalnya, Anda ingin mengekstrak nilai token yang dapat diteruskan baik dalam parameter kueri maupun di header, seperti yang ditunjukkan di bawah ini:
<!-- If token only in query param, the query param determines the value. If token is found in both the query param and header, header sets value. --> <QueryParam name="token"> <Pattern ignoreCase="true">{tokenValue}</Pattern> </QueryParam> <!-- Overwrite tokenValue even if it was found in query parameter. --> <Header name="Token"> <Pattern ignoreCase="true">{tokenValue}</Pattern> </Header>
Mengontrol apa yang terjadi jika tidak ada kecocokan
Jika polanya tidak cocok, variabel yang sesuai tidak akan dibuat. Oleh karena itu, jika kebijakan lain mereferensikan variabel tersebut, error dapat terjadi.
Salah satu opsinya adalah menyetel <IgnoreUnresolvedVariables>
ke benar (true) dalam kebijakan yang mereferensikan variabel tersebut untuk mengonfigurasi kebijakan guna memperlakukan variabel yang tidak dapat di-resolve sebagai string kosong (null):
<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
Referensi elemen
Referensi elemen menjelaskan elemen dan atribut kebijakan ExtractVariables.
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1"> <DisplayName> 1</DisplayName> <Source clearPayload="true|false">request</Source> <VariablePrefix>myprefix</VariablePrefix> <IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables> <URIPath> <Pattern ignoreCase="false">/accounts/{id}</Pattern> </URIPath> <QueryParam name="code"> <Pattern ignoreCase="true">DBN{dbncode}</Pattern> </QueryParam> <Header name="Authorization"> <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern> </Header> <FormParam name="greeting"> <Pattern>hello {user}</Pattern> </FormParam> <Variable name="request.content"> <Pattern>hello {user}</Pattern> </Variable> <JSONPayload> <Variable name="name"> <JSONPath>{example}</JSONPath> </Variable> </JSONPayload> <XMLPayload stopPayloadProcessing="false"> <Namespaces/> <Variable name="name" type="boolean"> <XPath>/test/example</XPath> </Variable> </XMLPayload> </ExtractVariables>
Atribut <ExtractVariables>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-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 <Source>
(Opsional) Menentukan variabel yang akan diuraikan. Nilai
<Source>
ditetapkan secara default ke message
. Nilai message
bersifat sensitif konteks. Dalam alur permintaan, message
me-resolve pesan permintaan. Dalam
alur respons, message
me-resolve ke pesan respons.
Meskipun kebijakan ini sering digunakan untuk mengekstrak informasi dari pesan permintaan atau respons, Anda dapat menggunakannya untuk mengekstrak informasi dari variabel apa pun. Misalnya, Anda dapat menggunakannya untuk mengekstrak
informasi dari entity yang dibuat oleh kebijakan AccessEntity, dari data
yang ditampilkan oleh kebijakan ServiceCallout, atau mengekstrak informasi dari objek XML atau JSON.
Jika <Source>
tidak dapat diselesaikan, atau di-resolve menjadi jenis non-pesan,
kebijakan akan gagal merespons.
<Source clearPayload="true|false">request</Source>
Default: | pesan |
Kehadiran: | Opsional |
Jenis: | String |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
clearPayload |
Tetapkan ke true jika Anda ingin menghapus payload yang ditentukan dalam Gunakan opsi |
false |
Opsional | Boolean |
Elemen <VariablePrefix>
(Opsional) Nama variabel lengkap dibuat dengan menggabungkan <VariablePrefix>
, titik, dan nama yang Anda tentukan di {kurung kurawal} dalam elemen <Pattern>
atau elemen <Variable>
. Contoh:
myprefix.id
, myprefix.dbncode
, atau myprefix.oauthtoken.
<VariablePrefix>myprefix</VariablePrefix>
Misalnya, nilai namanya adalah "user".
- Jika
<VariablePrefix>
tidak ditentukan, nilai yang diekstrak akan ditetapkan ke variabel bernamauser
. - Jika
<VariablePrefix>
ditentukan sebagai myprefix, nilai yang diekstrak akan ditetapkan ke variabel bernamamyprefix.user
.
Default: | T/A |
Kehadiran: | Opsional |
Jenis: | String |
Elemen <IgnoreUnresolvedVariables>
(Opsional) Tetapkan ke true
untuk memperlakukan variabel yang tidak dapat di-resolve sebagai string kosong (null). Tetapkan ke false
jika Anda ingin kebijakan menampilkan error saat variabel yang direferensikan tidak dapat diselesaikan.
<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
Default: | Salah |
Kehadiran: | Opsional |
Jenis: | Boolean |
Elemen <URIPath>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Mengekstrak nilai dari proxy.pathsuffix pesan sumber request
. Jalur yang diterapkan ke pola tersebut adalah proxy.pathsuffix, yang tidak menyertakan jalur dasar untuk Proxy API. Jika pesan sumber me-resolve ke jenis pesan response
, elemen ini tidak akan melakukan apa pun.
<URIPath> <Pattern ignoreCase="false">/accounts/{id}</Pattern> </URIPath>
Anda dapat menggunakan beberapa elemen <Pattern>
:
<URIPath> <Pattern ignoreCase="false">/accounts/{id}</Pattern> <Pattern ignoreCase="false">/accounts/{id}/transactions/{index}</Pattern> </URIPath>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
ignoreCase | Menyatakan agar mengabaikan huruf besar/kecil saat mencocokkan pola. |
false |
Opsional | Boolean |
Elemen <QueryParam>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Mengekstrak nilai dari parameter kueri yang ditentukan untuk pesan sumber request
. Jika pesan sumber me-resolve ke jenis pesan response
, elemen ini tidak akan melakukan apa pun.
<QueryParam name="code"> <Pattern ignoreCase="true">DBN{dbncode}</Pattern> </QueryParam>
Jika beberapa parameter kueri memiliki nama yang sama, gunakan indeks untuk mereferensikan parameter:
<QueryParam name="w.2"> <Pattern ignoreCase="true">{secondW}</Pattern> </QueryParam>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name | Menentukan nama parameter kueri. Jika beberapa parameter kueri memiliki nama yang sama, gunakan referensi yang diindeks, dengan instance pertama parameter kueri tidak memiliki indeks, yang kedua ada di indeks 2, yang ketiga ada di indeks 3, dst. |
T/A |
Diperlukan | String |
Elemen <Header>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Mengekstrak nilai dari header HTTP yang ditentukan untuk pesan request
atau response
yang ditentukan. Jika beberapa header memiliki
nama yang sama, nilainya akan disimpan dalam array.
<!-- The name is the actual header name. --> <Header name="Authorization"> <!-- Provide a name for your new custom variable here. --> <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern> </Header>
Jika beberapa header memiliki nama yang sama, gunakan indeks untuk mereferensikan header individual dalam array:
<Header name="myHeader.2"> <Pattern ignoreCase="true">{secondHeader}</Pattern> </Header>
Atau perintah berikut untuk menampilkan semua header dalam array:
<Header name="myHeader.values"> <Pattern ignoreCase="true">{myHeaders}</Pattern> </Header>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name | Menentukan nama header tempat Anda mengekstrak nilai. Jika beberapa
header memiliki nama yang sama, gunakan referensi yang diindeks, dengan instance pertama
header tidak memiliki indeks, yang kedua ada di indeks 2, yang ketiga ada di indeks 3, dst. Gunakan
.values untuk mendapatkan semua header dalam array. |
T/A |
Diperlukan | String |
Elemen <FormParam>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Mengekstrak nilai dari parameter formulir yang ditentukan untuk pesan request
atau response
yang ditentukan. Parameter formulir hanya dapat diekstrak jika header Content-Type
dari pesan yang ditentukan adalah application/x-www-form-urlencoded
.
<FormParam name="greeting"> <Pattern>hello {user}</Pattern> </FormParam>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name | Nama parameter formulir tempat Anda mengekstrak nilai. |
T/A |
Diperlukan | String |
Elemen <Variable>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Menentukan nama variabel yang digunakan untuk mengekstrak nilai.
<Variable name="myVar"> <Pattern>hello {user}</Pattern> </Variable>
Untuk mengekstrak dua nilai dari variabel:
<Variable name="myVar"> <Pattern>hello {firstName} {lastName}</Pattern> </Variable>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name | Nama variabel tempat mengekstrak nilai. |
T/A |
Diperlukan | String |
Elemen <JSONPayload>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Menentukan pesan berformat JSON yang menjadi asal ekstraksi nilai variabel. Ekstraksi JSON hanya dilakukan jika header Content-Type
pesan adalah application/json
.
<JSONPayload> <Variable name="name" type="string"> <JSONPath>{example}</JSONPath> </Variable> </JSONPayload>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Elemen <JSONPayload>/<Variable>
(Diperlukan dalam elemen JSONPayload.) Menentukan variabel tempat nilai yang diekstraksi ditetapkan. Anda dapat menyertakan beberapa tag <Variable>
di elemen
<JSONPayload>
untuk mengisi
beberapa variabel.
<Variable name="name" type="string"> <JSONPath>{example}</JSONPath> </Variable>
Default: | T/A |
Kehadiran: | Wajib dalam elemen JSONPayload. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name |
Menentukan nama variabel yang akan diberi nilai yang diekstraksi. |
name |
Diperlukan | String |
jenis | Menentukan jenis data nilai variabel. | T/A | Opsional |
String. Pilih dari:
|
Elemen <JSONPayload>/<Variable>/<JSONPath>
(Diperlukan dalam elemen JSONPayload:Variable.) Menentukan jalur JSON yang digunakan untuk mengekstrak nilai dari pesan berformat JSON.
<Variable name="name"> <JSONPath>$.rss.channel.title</JSONPath> </Variable>
Default: | T/A |
Kehadiran: | Diperlukan |
Jenis: | String |
Elemen <XMLPayload>
(Opsional, tetapi lihat baris Kehadiran pada tabel di bawah untuk informasi selengkapnya.) Menentukan pesan berformat XML yang akan digunakan untuk mengekstrak nilai variabel. Payload XML
hanya diekstrak jika header Content-Type
pesan adalah text/xml
, application/xml
,
atau application/*+xml
.
<XMLPayload stopPayloadProcessing="false"> <Namespaces> <Namespace prefix="apigee">http://www.apigee.com</Namespace> <Namespace prefix="gmail">http://mail.google.com</Namespace> </Namespaces> <Variable name="name" type="boolean"> <XPath>/apigee:test/apigee:example</XPath> </Variable> </XMLPayload>
Default: | T/A |
Kehadiran: | Opsional. Namun, Anda harus menyertakan minimal salah satu dari hal berikut:
<URIPath> , <QueryParam> , <Header> ,
<FormParam> , <JSONPayload> , atau
<XMLPayload>. |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
stopPayloadProcessing |
Tetapkan ke |
false |
Opsional | Boolean |
Elemen <XMLPayload>/<Namespaces>
(Opsional) Menentukan namespace yang akan digunakan dalam evaluasi XPath. Jika menggunakan namespace dalam ekspresi XPath, Anda harus mendeklarasikan namespace di sini, seperti yang ditunjukkan dalam contoh berikut.
<XMLPayload stopPayloadProcessing="false"> <Namespaces> <Namespace prefix="apigee">http://www.apigee.com</Namespace> <Namespace prefix="gmail">http://mail.google.com</Namespace> </Namespaces> <Variable name="legName" type="string"> <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath> </Variable> </XMLPayload>
Jika tidak menggunakan namespace dalam ekspresi XPath, Anda dapat menghilangkan atau menjadikan elemen
<Namespaces>
sebagai komentar, seperti yang ditunjukkan contoh berikut:
<XMLPayload stopPayloadProcessing="false"> <!-- <Namespaces/> --> <Variable name="legName" type="string"> <XPath>/Directions/route/leg/name</XPath> </Variable> </XMLPayload>
Default: | T/A |
Kehadiran: | Opsional |
Jenis: | String |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
prefix |
Awalan namespace. |
T/A |
Diperlukan | String |
Elemen <XMLPayload>/<Variable>
(Opsional) Menentukan variabel yang akan ditetapkan ke nilai yang diekstrak.
<Variable name="name" type="boolean"> <XPath>/test/example</XPath> </Variable>
Default: | T/A |
Kehadiran: | Opsional |
Jenis: | T/A |
Atribut
Atribut | Deskripsi | Default | Kehadiran | Jenis |
---|---|---|---|---|
name |
Menentukan nama variabel yang akan diberi nilai yang diekstraksi. |
name |
Diperlukan | String |
jenis | Menentukan jenis data nilai variabel. | Boolean | Opsional |
String. Pilih dari:
|
Elemen <XMLPayload>/<Variable>/<XPath>
(Diperlukan dalam elemen XMLPayload:Variable.) Menentukan XPath yang ditentukan untuk variabel tersebut. Hanya ekspresi XPath 1.0 yang didukung.
<Variable name="name" type="boolean"> <XPath>/test/example</XPath> </Variable>
Contoh dengan namespace. Jika menggunakan namespace dalam ekspresi XPath, Anda harus mendeklarasikan
namespace di
bagian <XMLPayload><Namespaces>
kebijakan.
<Variable name="name" type="boolean"> <XPath>/foo:test/foo:example</XPath> </Variable>
Default: | T/A |
Kehadiran: | Diperlukan |
Jenis: | String |
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 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 |
---|---|---|---|
steps.extractvariables.ExecutionFailed |
500 |
Error ini terjadi saat:
|
build |
steps.extractvariables.ImmutableVariable |
500 |
Variabel yang digunakan dalam kebijakan tidak dapat diubah. Kebijakan tidak dapat menetapkan variabel ini. | T/A |
steps.extractvariables.InvalidJSONPath |
500 |
Error ini terjadi jika jalur JSON yang tidak valid digunakan dalam elemen JSONPath kebijakan. Misalnya, jika payload JSON tidak memiliki objek Name , tetapi Anda menentukan Name sebagai jalur dalam kebijakan, error ini akan terjadi. |
build |
steps.extractvariables.JsonPathParsingFailure |
500 |
Error ini terjadi jika kebijakan tidak dapat mengurai jalur JSON dan
mengekstrak data dari variabel flow yang ditentukan dalam elemen Source . Biasanya hal ini
terjadi jika variabel flow yang ditentukan dalam elemen Source tidak ada dalam alur
saat ini. |
build |
steps.extractvariables.SetVariableFailed |
500 |
Error ini terjadi jika kebijakan tidak dapat menetapkan nilai ke variabel. Error ini umumnya terjadi jika Anda mencoba menetapkan nilai ke beberapa variabel yang namanya diawali dengan kata yang sama dalam format yang dipisahkan dengan titik. | build |
steps.extractvariables.SourceMessageNotAvailable |
500 |
Error ini terjadi jika variabel message
yang ditentukan dalam elemen Source kebijakan
adalah:
|
build |
steps.extractvariables.UnableToCast |
500 |
Error ini terjadi jika kebijakan tidak dapat mentransmisikan nilai yang diekstrak ke variabel. Biasanya ini terjadi jika Anda mencoba menetapkan nilai satu jenis data ke variabel jenis data lain. | build |
Error saat deployment
Error ini dapat terjadi saat Anda men-deploy proxy yang berisi kebijakan ini.
Nama error | Penyebab | Perbaikan |
---|---|---|
NothingToExtract |
Jika kebijakan tidak memiliki salah satu elemen URIPath , QueryParam , Header , FormParam , XMLPayload , atau JSONPayload , deployment Proxy API akan gagal karena tidak ada yang dapat diekstrak. |
build |
NONEmptyPrefixMappedToEmptyURI |
Error ini terjadi jika kebijakan memiliki awalan yang ditentukan dalam elemen
Namespace di bagian elemen XMLPayload , tetapi tidak ada URI
yang ditentukan. |
build |
DuplicatePrefix |
Error ini terjadi jika kebijakan memiliki awalan yang sama yang ditentukan lebih dari
sekali dalam elemen Namespace pada elemen XMLPayload . |
build |
NoXPathsToEvaluate |
Jika kebijakan tidak memiliki elemen XPath dalam elemen
XMLPayload , deployment proxy API akan gagal dengan error ini.
|
build |
EmptyXPathExpression |
Jika kebijakan memiliki ekspresi XPath kosong dalam elemen XMLPayload , deployment proxy API akan gagal. |
build |
NoJSONPathsToEvaluate |
Jika kebijakan tidak memiliki elemen JSONPath dalam elemen
JSONPayload , deployment proxy API akan gagal dengan error ini. |
build |
EmptyJSONPathExpression |
Jika kebijakan memiliki ekspresi XPath kosong dalam elemen
XMLPayload , deployment proxy API akan gagal. |
build |
MissingName |
Jika kebijakan tidak memiliki atribut name di salah satu elemen kebijakan seperti QueryParam , Header , FormParam atau Variable , jika diperlukan, deployment proxy API akan gagal. |
build |
PatternWithoutVariable |
Jika kebijakan tidak memiliki variabel yang ditentukan dalam elemen Pattern ,
deployment proxy API akan gagal. Elemen Pattern memerlukan nama variabel tempat data yang diekstrak akan disimpan. |
build |
CannotBeConvertedToNodeset |
Jika kebijakan memiliki ekspresi XPath dengan jenis Variable
ditentukan sebagai nodeset,
tetapi ekspresi tersebut tidak dapat dikonversi menjadi nodeset, deployment proxy API akan gagal. |
build |
JSONPathCompilationFailed |
Kebijakan tidak dapat mengompilasi Jalur JSON yang ditentukan. | T/A |
InstantiationFailed |
Kebijakan tidak dapat dibuat instance. | T/A |
XPathCompilationFailed |
Jika awalan atau nilai yang digunakan dalam elemen XPath bukan bagian dari namespace yang dideklarasikan dalam kebijakan, deployment proxy API akan gagal. |
build |
InvalidPattern |
Jika definisi elemen Pattern tidak valid di salah satu elemen seperti URIPath , QueryParam , Header , FormParam , XMLPayload , atau JSONPayload dalam kebijakan, deployment proxy API akan gagal.
|
build |
Variabel kesalahan
Variabel ini ditetapkan saat kebijakan ini memicu error saat runtime. Untuk informasi selengkapnya, lihat Yang perlu Anda ketahui tentang error kebijakan.
Variabel | Dari mana | Contoh |
---|---|---|
fault.name="fault_name" |
fault_name adalah nama kesalahan, seperti yang tercantum dalam tabel Error runtime di atas. Nama kesalahan adalah bagian terakhir dari kode kesalahan. | fault.name = "SourceMessageNotAvailable" |
extractvariables.policy_name.failed |
policy_name adalah nama kebijakan yang ditentukan pengguna yang menampilkan kesalahan. | extractvariables.EV-ParseJsonResponse.failed = true |
Contoh respons error
{ "fault":{ "detail":{ "errorcode":"steps.extractvariables.SourceMessageNotAvailable" }, "faultstring":"request message is not available for ExtractVariable: EV-ParseJsonResponse" } }
Contoh aturan kesalahan
<FaultRule name="Extract Variable Faults"> <Step> <Name>AM-CustomErrorMessage</Name> <Condition>(fault.name = "SourceMessageNotAvailable") </Condition> </Step> <Condition>(extractvariables.EM-ParseJsonResponse.failed = true) </Condition> </FaultRule>