Pemecahan masalah error deployment kebijakan Ekstrak Variabel

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Lihat dokumentasi Apigee Edge.

NothingToExtract

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory. Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Contoh pesan error

Error Saving Revision 2
ExtractVariables EV-XML-Age: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.

Contoh screenshot

Terjadi error saat menyimpan revisi 2.

Penyebab

Jika Kebijakan Ekstrak Variabel tidak memiliki elemen URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload, deployment API Proxy akan gagal karena tidak ada yang akan diekstrak.

Seperti yang ditunjukkan dalam pesan error, kebijakan Ekstrak Variabel harus menyertakan setidaknya salah satu elemen berikut dalam kebijakan: URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload.

Diagnosis

Periksa kebijakan Extract Variables yang disebutkan dalam pesan error. Jika kebijakan tidak memiliki salah satu elemen berikut: URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload, maka itulah penyebab error. Misalnya, kebijakan Ekstrak Variabel berikut tidak memiliki elemen yang disebutkan di atas:

<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Properties/>
</ExtractVariables>

Karena tidak ada elemen wajib yang ada dalam kebijakan Extract Variables, deployment proxy API akan gagal.

Resolusi

Pastikan kebijakan Ekstrak Variabel memiliki setidaknya salah satu elemen wajib berikut: URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
  <DisplayName>EV-XML-Age</DisplayName>
  <Properties/>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces/>
      <Variable name="age" type="integer">
          <XPath>/age</XPath>
      </Variable>
  </XMLPayload>
</ExtractVariables>

NONEmptyPrefixMappedToEmptyURI

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: Non-empty prefix [prefix_name] cannot be mapped to empty uri.

Contoh pesan error

Error Saving Revision 3
ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

Contoh screenshot

Terjadi error saat menyimpan revisi 3.

Penyebab

Error ini terjadi jika Kebijakan Ekstrak Variabel memiliki awalan yang ditentukan di elemen <Namespace> pada elemen <XMLPayload>, tetapi tidak ada URI yang ditentukan.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel tempat error terjadi dan nama awalan. Anda dapat menemukan kedua item ini dalam pesan error. Misalnya, dalam error berikut , nama kebijakan adalah EV-XML-Age dan awalan adalah apigee:

    ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan nama awalan yang ditetapkan di elemen <Namespace> pada elemen <XMLPayload> cocok dengan nama awalan yang diidentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan awalan bernama apigee di elemen <Namespace> , yang cocok dengan yang ada dalam pesan error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Source clearPayload="false">request</Source>
    <XMLPayload stopPayloadProcessing="false">
      <Namespaces>
        <Namespace prefix="apigee"></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>
</ExtractVariables>

  3. Validasi apakah elemen <Namespace> dengan awalan tertentu yang diidentifikasi pada langkah #2 memiliki URI yang valid. Jika URI tidak ada, hal itu adalah penyebab error.

    Pada contoh kebijakan Ekstrak Variabel yang ditampilkan di atas, perhatikan bahwa tidak ada URI yang sesuai dengan elemen <Namespace> dengan awalan apigee; oleh karena itu, Anda mendapatkan error:

    ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

Resolusi

Pastikan semua elemen <Namespace> yang ditentukan dengan awalan memiliki URI yang sesuai dalam kebijakan Ekstrak Variabel. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Source clearPayload="false">request</Source>
    <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>
</ExtractVariables>

DuplicatePrefix

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: Duplicate prefix [prefix_name].

Contoh pesan error

Error Saving Revision 2
ExtractVariables EV-XML-Age: Duplicate prefix apigee.

Contoh screenshot

Terjadi error saat menyimpan revisi 2.

Penyebab

Error ini terjadi jika Kebijakan Ekstrak Variabel memiliki awalan yang sama yang ditentukan lebih dari sekali di elemen <Namespace> pada elemen <XMLPayload>.

Misalnya, error ini terjadi karena awalan apigee ditentukan dua kali seperti yang ditunjukkan di bawah:

<Namespace prefix="apigee">http://www.apigee.com</Namespace>
<Namespace prefix="apigee">http://www.apigee.com</Namespace>

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel tempat error terjadi dan nama awalan. Anda dapat menemukan kedua item ini dalam pesan error. Misalnya, dalam error berikut, nama kebijakan adalah EV-XML-Age dan awalan adalah apigee:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan nama awalan yang ditetapkan di elemen <Namespace> pada elemen <XMLPayload> cocok dengan nama awalan yang diidentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan awalan bernama apigee di elemen <Namespace> , yang cocok dengan yang ada dalam pesan error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Source clearPayload="false">request</Source>
    <XMLPayload stopPayloadProcessing="false">
      <Namespaces>
          <Namespace prefix="gmail">http://mail.google.com</Namespace>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
          <Namespace prefix="apigee">http://www.apigee.com</Namespace>
      </Namespaces>
      <Variable name="legName" type="string
          <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>
      </Variable>
    </XMLPayload>
  </ExtractVariables>

  3. Tentukan apakah elemen <Namespace> dengan awalan tertentu, yang diidentifikasi pada langkah #2 telah ditentukan lebih dari sekali. Jika ditentukan lebih dari sekali, hal itu adalah penyebab error.

    Pada contoh kebijakan Ekstrak Variabel yang ditampilkan di atas, perhatikan bahwa elemen <Namespace> dengan awalan apigee telah ditentukan dua kali; oleh karena itu, Anda mendapatkan error:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

Resolusi

Pastikan hanya ada satu definisi untuk setiap awalan dalam elemen <Namespace> dalam kebijakan Ekstrak Variabel. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Source clearPayload="false">request</Source>
    <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>
</ExtractVariables>

NoXPathsToEvaluate

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]:no xpaths to evaluate in variable name.

Contoh pesan error

Error Saving Revision 4
ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

Contoh screenshot

Terjadi error saat menyimpan revisi 4.

Penyebab

Jika Kebijakan Ekstrak Variabel tidak memiliki elemen <XPath> dalam elemen <XMLPayload>, deployment proxy API akan gagal dengan error yang ditampilkan di atas.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel yang gagal dari pesan error. Misalnya, dalam error berikut, nama kebijakannya adalah Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

  2. Dalam XML kebijakan Extract Variables yang gagal, periksa apakah ada elemen <XMLPayload> tanpa elemen turunan <XPath>. Jika demikian, hal itu adalah penyebab error.

    Misalnya, berikut adalah kebijakan Ekstrak Variabel yang memiliki elemen <XMLPayload>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="HostReachable" type="boolean">
        </Variable>
    </XMLPayload>
</ExtractVariables>

    Karena tidak ada elemen <XPath>, deployment Proxy API akan gagal.

Resolusi

Pastikan kebijakan Ekstrak Variabel memiliki elemen <XPath> yang ditentukan di bagian elemen <XMLPayload>. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="HostReachable" type="boolean">
            <XPath>/isReachable</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

EmptyXPathExpression

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: XPath expression is empty in variable name.

Contoh pesan error

Error Saving Revision 6
ExtractVariables Extract-Variables-1: XPath expression is empty in variable name.

Contoh screenshot

Terjadi error saat menyimpan revisi 6.

Penyebab

Jika Kebijakan Ekstrak Variabel memiliki ekspresi <XPath> kosong dalam elemen <XMLPayload>, deployment proxy API akan gagal.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel yang gagal dari pesan error. Misalnya, dalam error berikut, nama kebijakannya adalah Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

  2. Dalam XML kebijakan Extract Variables yang gagal, tentukan apakah ada elemen <XMLPayload> dengan elemen turunan <XPath> kosong. Jika demikian, hal itu adalah penyebab error.

    Misalnya, berikut adalah kebijakan Ekstrak Variabel yang memiliki elemen <XMLPayload>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="address" type="string">
            <XPath></XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

    Karena ada elemen <XPath> kosong dalam elemen <XMLPayload>, deployment Proxy API akan gagal.

Resolusi

Pastikan kebijakan Extract Variables memiliki elemen <XPath> yang tidak kosong dan valid yang ditentukan di bagian elemen <XMLPayload>. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="address" type="string">
            <XPath>/address</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

NoJSONPathsToEvaluate

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]:no jsonpaths to evaluate in variable name.

Contoh pesan error

Error Saving Revision 6
ExtractVariables Extract-Variables-1: no jsonpaths to evaluate in variable name.

Contoh screenshot

Terjadi error saat menyimpan revisi 6.

Penyebab

Jika Kebijakan Ekstrak Variabel tidak memiliki elemen <JSONPath> dalam elemen <JSONPayload>, deployment proxy API akan gagal dengan error yang ditampilkan di atas.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel yang gagal dari pesan error. Misalnya, dalam error berikut, nama kebijakannya adalah Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no jsonpaths to evaluate in variable name.

  2. Dalam XML kebijakan Extract Variables yang gagal, tentukan apakah ada elemen <JSONPayload> tanpa elemen turunan <JSONPath> yang diperlukan. Jika demikian, hal itu adalah penyebab error.

    Misalnya, berikut adalah kebijakan Ekstrak Variabel yang memiliki elemen <JSONPayload>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <JSONPayload>
        <Variable name="title">
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

    Karena tidak ada elemen turunan <JSONPath> yang ditentukan di bawah elemen <JSONPayload>, deployment API Proxy akan gagal.

Resolusi

Pastikan kebijakan Ekstrak Variabel memiliki elemen <JSONPath> yang ditentukan di bagian elemen <JSONPayload>. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <JSONPayload>
        <Variable name="title">
            <JSONPath>$.book.title</JSONPath>
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

EmptyJSONPathExpression

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: JSONPath expression is empty in variable name.

Contoh pesan error

Error Saving Revision 6
ExtractVariables Extract-Variables-1: JSONPath expression is empty in variable name.

Contoh screenshot

Terjadi error saat menyimpan revisi 6.

Penyebab

Jika Kebijakan Ekstrak Variabel memiliki ekspresi <JSONPath> kosong dalam elemen <JSONPayload>, deployment proxy API akan gagal.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel yang gagal dari pesan error. Misalnya, dalam error berikut, nama kebijakannya adalah Extract-Variables-1:

    ExtractVariables Extract-Variables-1: JSONPath expression is empty in variable name.

  2. Dalam XML kebijakan Extract Variables yang gagal, verifikasi apakah ada elemen <JSONPayload> dengan elemen turunan <JSONPath> yang kosong. Jika demikian, hal itu adalah penyebab error.

    Misalnya, berikut adalah kebijakan Ekstrak Variabel yang memiliki elemen <JSONPayload>:

        <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <JSONPayload>
            <Variable name="account_number" type="integer">
                <JSONPath></JSONPath>
            </Variable>
        </JSONPayload>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
    </ExtractVariables>

    Karena ada elemen <JSONPath> kosong dalam elemen <JSONPayload>, deployment Proxy API akan gagal.

Resolusi

Pastikan kebijakan Extract Variables memiliki elemen <JSONPath> yang tidak kosong dan valid yang ditentukan di bagian elemen <JSONPayload>. Contoh:

<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <JSONPayload>
        <Variable name="account_number" type="integer">
           <JSONPath>$.account.number</JSONPath>
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

MissingName

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
Error occurred while validation of bean [policy_name].xml Reason: - Required attribute name is missing in [element_name]

Contoh pesan error

Error Saving Revision 6
Error occurred while validation of bean Extract-Variables-1.xml. Reason: - Required attribute name is missing in Variable

Contoh screenshot

Terjadi error saat menyimpan revisi 6.

Penyebab

Jika Kebijakan Ekstrak Variabel tidak memiliki atribut name di salah satu elemen kebijakan seperti QueryParam, Header, FormParam, atau Variable, yang diperlukan, deployment proxy API akan gagal.

Misalnya, error ini terjadi jika atribut name tidak ada di elemen Variable.

Diagnosis

  1. Identifikasi nama kebijakan Ekstrak Variabel tempat error terjadi dan elemen tempat atribut name tidak ada. Anda dapat menemukan item ini dalam pesan error. Misalnya, dalam error berikut, nama kebijakan adalah Extract-Variables-1 dan nama elemen adalah Variable:

    Error occurred while validation of bean Extract-Variables-1.xml. Reason: - Required attribute name is missing in Variable

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan semua elemen dengan nama yang ditentukan dari langkah #1 di atas memiliki atribut name. Jika ada elemen yang tidak memiliki atribut nama, hal itu adalah penyebab error.

    Misalnya, kebijakan Ekstrak Variabel berikut memiliki elemen <Variable> yang ditentukan:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Variable type="boolean">
        <Pattern>{isAccountActive}</Pattern>
    </Variable>
</ExtractVariables>

    Perhatikan bahwa atribut name tidak ada di elemen Variable, sehingga deployment API Proxy gagal.

Resolusi

Pastikan Kebijakan Ekstrak Variabel berisi atribut name yang diperlukan, untuk elemen QueryParam, Header, FormParam , atau Variable. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Variable name="account_active" type="boolean">
        <Pattern>{isAccountActive}</Pattern>
    </Variable>
</ExtractVariables>

PatternWithoutVariable

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Saving Revision [revision_number]
Pattern [pattern] should have at least one variable in ExtractVariables stepDefinition [policy_name]

Contoh pesan error

Error Saving Revision 7
Pattern /a/b/ should have at least one variable in ExtractVariables stepDefinition ExtractVariables-1.

Contoh screenshot

Terjadi error saat menyimpan revisi 7.

Penyebab

Jika Kebijakan Ekstrak Variabel tidak memiliki variabel yang ditentukan dalam elemen <Pattern>, deployment proxy API akan gagal. Elemen <Pattern> memerlukan nama variabel tempat data yang diekstrak akan disimpan.

Diagnosis

  1. Identifikasi nama kebijakan Ekstrak Variabel tempat error terjadi dan pola yang Variabelnya tidak ada. Anda dapat menemukan item ini dari pesan error. Misalnya, dalam error berikut, nama kebijakan adalah Extract-Variables-1 dan nama elemen adalah /a/b:

    Pattern /a/b/ should have at least one variable in ExtractVariables stepDefinition ExtractVariables-1.

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan pola yang ditetapkan di elemen <Pattern> cocok dengan pola yang diidentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan pola /a/b, yang cocok dengan yang ada dalam pesan error:

    Misalnya, berikut adalah kebijakan Ekstrak Variabel yang memiliki tiga elemen <Pattern>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables name="ExtractVariables-1">
   <Source>request</Source>
   <URIPath>
      <Pattern ignoreCase="true">/a/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/b/</Pattern>
      <Pattern ignoreCase="true">/a/b/c/{pathSeg}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
</ExtractVariables>

  3. Periksa apakah elemen <Pattern> yang diidentifikasi pada langkah #2 tidak memiliki variabel. Variabel harus diapit dalam tanda kurung kurawal. Jika pola tidak memiliki variabel, maka hal itu adalah penyebab error.

    Elemen <Pattern> yang memiliki pola /a/b tidak menyertakan variabel; oleh karena itu, deployment Proxy API gagal

    <Pattern ignoreCase="true">/a/b/</Pattern>

Resolusi

Pastikan elemen <Pattern> menyertakan variabel (nama yang diapit dalam kurung kurawal). Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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>
</ExtractVariables>

CannotBeConvertedToNodeset

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Deploying Revision [revision_number]
ExtractVariables [policy_name]: Result of xpath [policy_name] cannot be converted to nodeset. Context Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Contoh pesan error

Error Deploying Revision 4 to test
ExtractVariables Extract-Variables-1: Result of xpath 123 cannot be converted to nodeset. Context Revision:4;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

Contoh screenshot

Terjadi error saat men-deploy revisi 4 untuk pengujian.

Penyebab

Jika Kebijakan Ekstrak Variabel memiliki ekspresi <XPath> dengan jenis <Variable> yang ditentukan sebagai nodeset, tetapi ekspresi tidak dapat dikonversi menjadi nodeset, deployment proxy API akan gagal.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel tempat error terjadi dan XPath yang tidak dapat dikonversi menjadi nodeset. Anda dapat menemukan kedua item ini dalam pesan error. Misalnya, dalam error berikut , nama kebijakan adalah Extract-Variables-1 dan XPath adalah 123.

    ExtractVariables Extract-Variables-1: Result of xpath 123 cannot be converted to nodeset. Context Revision:4;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan XPath yang ditetapkan di elemen <XPath> cocok dengan XPath yang diidentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan sebagai 123, yang cocok dengan yang ada dalam pesan error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>visitor</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="age" type="nodeset">
            <XPath>123</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

  3. Periksa jenis elemen <Variable> yang sesuai dengan <XPath> yang diidentifikasi pada langkah #2 di atas. Jika jenis <Variable> adalah nodeset, maka itulah penyebab error.

    Perhatikan bahwa ekspresi <XPath> adalah 123 dalam contoh kebijakan Ekstrak Variabel.

    <XPath>123</XPath>

    Ekspresi 123 tidak dapat dikonversi menjadi nodeset. Jadi, deployment Proxy API akan gagal.

Resolusi

Pastikan ekspresi <XPath> yang digunakan dalam kebijakan Ekstrak Variabel dapat dikonversi menjadi nodeset jika jenis <Variable> ditentukan sebagai nodeset. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>visitor</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="age" type="nodeset">
            <XPath>/visitor/age</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

InvalidPattern

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Deploying Revision [revision_number]
Pattern [pattern] is invalid in ExtractVariables stepDefinition [policy_name]

Contoh pesan error

Error Deploying Revision 18 to test
Pattern {*} is invalid in ExtractVariables stepDefinition ExtractVariables-2.

Contoh screenshot

Terjadi error saat men-deploy revisi 18 untuk pengujian.

Penyebab

Jika definisi elemen <Pattern> tidak valid di salah satu elemen seperti URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload dalam Kebijakan Ekstrak Variabel, deployment proxy API akan gagal.

Diagnosis

  1. Identifikasi kebijakan Extract Variables yang gagal dari pesan error. Misalnya, dalam error berikut, nama kebijakannya adalah Extract-Variables-2:

    Pattern {*} is invalid in ExtractVariables stepDefinition ExtractVariables-2.

  2. Dalam XML kebijakan Extract Variables yang gagal, periksa apakah ada elemen berikut dan sertakan elemen <Pattern>.: URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload.

    Misalnya, berikut adalah contoh kebijakan Ekstrak Variabel dengan elemen <Pattern> dalam elemen <QueryParam>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables name="ExtractVariables-2">
    <DisplayName>ExtractVariables-2</DisplayName>
    <Source>request</Source>
    <QueryParam name="code">
        <Pattern ignoreCase="true">{*}</Pattern>
    </QueryParam>
    <VariablePrefix>queryinfo</VariablePrefix>
</ExtractVariables>

  3. Periksa definisi setiap elemen <Pattern>. Jika ada elemen <Pattern> dengan definisi yang tidak valid, elemen tersebut adalah penyebab error.

    Dalam contoh kebijakan Extract Variables yang ditampilkan di atas, perhatikan bahwa definisi <Pattern> dalam elemen <QueryParam> tidak valid; oleh karena itu, deployment API Proxy gagal. Lihat juga Tentang pencocokan dan pembuatan variabel

    <Pattern ignoreCase="true">{*}</Pattern>

Resolusi

Pastikan definisi elemen <Pattern> dalam elemen URIPath, QueryParam, Header, FormParam, XMLPayload, atau JSONPayload dalam kebijakan Ekstrak Variabel valid. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables name="ExtractVariables-2">
    <DisplayName>Extract a value from a query parameter</DisplayName>
    <Source>request</Source>
    <QueryParam name="code">
        <Pattern ignoreCase="true">{code}</Pattern>
    </QueryParam>
    <VariablePrefix>queryinfo</VariablePrefix>
</ExtractVariables>

Lihat juga Tentang pencocokan dan pembuatan variabel

XPathCompilationFailed

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Deploying Revision [revision_number]
ExtractVariables [policy_name]: Failed to compile xpath [xpath] Context Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Contoh pesan error

Error Deploying Revision 1 to test
ExtractVariables EV-XML-Age: Failed to compile xpath /apigee:Directions/apigee:route/apigee:leg/apigee:name. Context Revision:1;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

Contoh screenshot

Terjadi error saat men-deploy revisi 1 untuk pengujian.

Penyebab

Jika awalan atau nilai yang digunakan dalam elemen <XPath> bukan bagian dari namespace yang dideklarasikan dalam Kebijakan Ekstrak Variabel, deployment proxy API akan gagal.

Anda dapat menemukan informasi selengkapnya tentang namespace, XPath, dan awalan di Namespace XML dan Pengaruhnya terhadap XPath dan XSLT.

Diagnosis

  1. Identifikasi kebijakan Ekstrak Variabel tempat error terjadi dan XPath yang tidak dapat dikompilasi. Anda dapat menemukan kedua item ini dalam pesan error. Misalnya, dalam error berikut , nama kebijakan adalah EV-XML-Age dan xpath adalah /apigee:Directions/apigee:route/apigee:leg/apigee:name.

    ExtractVariables EV-XML-Age: Failed to compile xpath /apigee:Directions/apigee:route/apigee:leg/apigee:name. Context Revision:1;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

  2. Dalam XML kebijakan Extract Variables yang gagal, pastikan XPath yang ditetapkan di elemen <XPath> cocok dengan XPath yang diidentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan sebagai /apigee:Directions/apigee:route/apigee:leg/apigee:name, yang cocok dengan yang ada dalam pesan error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
  <DisplayName>EV-XML-Age</DisplayName>
  <Source clearPayload="false">request</Source>
  <XMLPayload stopPayloadProcessing="false">
    <Namespaces>
        <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>
</ExtractVariables>

  3. Periksa elemen <Namespaces> dan <XPath> dalam kebijakan Ekstrak Variabel. Jika <XPath> tertentu yang ditunjukkan dalam pesan error menggunakan awalan atau nilai yang bukan bagian dari namespace yang dideklarasikan dalam kebijakan Ekstrak Variabel, hal tersebut adalah penyebab error.

    Perhatikan bahwa <XPath> tertentu menggunakan awalan apigee dalam contoh kebijakan Ekstrak Variabel.

    <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>

    Namun, awalan apigee tidak ditentukan di elemen <Namespace> mana pun; oleh karena itu, kompilasi <XPath> gagal sehingga menyebabkan kegagalan deployment.

Resolusi

Pastikan semua namespace yang digunakan dalam elemen <XPath> dideklarasikan dalam Kebijakan Ekstrak Variabel. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
  <DisplayName>EV-XML-Age</DisplayName>
  <Source clearPayload="false">request</Source>
  <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>
</ExtractVariables>