تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة المتغيّرات

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

NothingToExtract

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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].

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا لم تتضمّن سياسة "استخراج المتغيّرات" أيًا من العناصر URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload، سيتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات، لأنّه لا يوجد ما يمكن استخراجه.

كما هو موضّح في رسالة الخطأ، يجب أن تتضمّن سياسة "استخراج المتغيّرات" أحد العناصر التالية على الأقل: URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload.

التشخيص

افحص سياسة "استخراج المتغيرات" المذكورة في رسالة الخطأ. إذا لم تتضمّن السياسة أحد العناصر التالية على الأقل: URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload، سيكون ذلك هو سبب الخطأ. على سبيل المثال، لا تحتوي سياسة "استخراج المتغيرات" التالية على أي من العناصر المذكورة أعلاه:

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

بما أنّه لا تتوفّر أي من العناصر الإلزامية في سياسة "استخراج المتغيرات"، يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة "استخراج المتغيّرات" تتضمّن عنصرًا واحدًا على الأقل من العناصر الإلزامية التالية: URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload. على سبيل المثال:

<?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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

يحدث هذا الخطأ إذا كانت "سياسة استخراج المتغيرات" تتضمّن بادئة محدّدة في العنصر <Namespace> ضمن العنصر <XMLPayload>، ولكن لم يتم تحديد أي معرّف موارد منتظم (URI).

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي حدث فيها الخطأ واسم البادئة. يمكنك العثور على كلتا القيمتين في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم السياسة هو EV-XML-Age والبادئة هي apigee:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيرات" الذي تعذّر تنفيذه، تأكَّد من أنّ اسم البادئة الذي تم ضبطه في العنصر <Namespace> ضمن العنصر <XMLPayload> يتطابق مع اسم البادئة المحدّد في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية بادئة باسم apigee في العنصر <Namespace>، وهي تتطابق مع ما ورد في رسالة الخطأ:

    <?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. تحقَّق مما إذا كان العنصر <Namespace> الذي يتضمّن البادئة المحدّدة في الخطوة 2 يتضمّن معرّف موارد موحّدًا صالحًا. إذا كان معرّف URI غير متوفّر، سيكون هذا هو سبب الخطأ.

    في مثال سياسة "استخراج المتغيرات" الموضّح أعلاه، لاحظ أنّه لا يوجد معرّف URI مطابق للعنصر <Namespace> الذي يتضمّن البادئة apigee، وبالتالي سيظهر لك الخطأ التالي:

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

الدقة

تأكَّد من أنّ جميع عناصر <Namespace> المحدّدة ببادئة لها معرّف موارد موحّد مطابق في سياسة "استخراج المتغيّرات". على سبيل المثال:

<?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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

يحدث هذا الخطأ إذا كان لسياسة "استخراج المتغيّرات" البادئة نفسها المحدّدة أكثر من مرة في العنصر <Namespace> ضمن العنصر <XMLPayload>.

على سبيل المثال، يحدث هذا الخطأ لأنّ البادئة apigee معرَّفة مرّتين كما هو موضّح أدناه:

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

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي حدث فيها الخطأ واسم البادئة. يمكنك العثور على كلتا القيمتين في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم السياسة هو EV-XML-Age والبادئة هي apigee:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، تأكَّد من أنّ اسم البادئة الذي تم ضبطه في العنصر <Namespace> ضمن العنصر <XMLPayload> يتطابق مع اسم البادئة المحدّد في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية بادئة باسم apigee في العنصر <Namespace>، وهي تتطابق مع ما ورد في رسالة الخطأ:

    <?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. تحديد ما إذا تم تحديد العنصر <Namespace> الذي يتضمّن البادئة المحدّدة، والتي تم تحديدها في الخطوة 2، أكثر من مرة إذا تم تحديدها أكثر من مرة، سيكون ذلك هو سبب الخطأ.

    في مثال سياسة "استخراج المتغيرات" الموضّح أعلاه، لاحظ أنّه تم تحديد العنصر <Namespace> الذي يتضمّن البادئة apigee مرّتين، وبالتالي سيظهر لك الخطأ التالي:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

الدقة

تأكَّد من وجود تعريف واحد فقط لكل بادئة في عناصر <Namespace> في سياسة "استخراج المتغيّرات". على سبيل المثال:

<?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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا لم يكن لعنصر <XPath> عنصر ضمن عنصر <XMLPayload> في سياسة استخراج المتغيّرات، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات وسيظهر الخطأ الموضّح أعلاه.

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو Extract-Variables-1:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، تحقَّق ممّا إذا كان هناك عنصر <XMLPayload> بدون العنصر الفرعي <XPath>. إذا كان الأمر كذلك، هذا هو سبب الخطأ.

    على سبيل المثال، إليك سياسة "استخراج المتغيرات" التي تتضمّن العنصر <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>

    بما أنّه لا يتوفّر العنصر <XPath>، يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة "استخراج المتغيّرات" تتضمّن عنصر <XPath> محدّدًا ضمن العنصر <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">
            <XPath>/isReachable</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

EmptyXPathExpression

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا كانت "سياسة استخراج المتغيرات" تتضمّن تعبيرًا فارغًا <XPath> ضمن العنصر <XMLPayload>، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو Extract-Variables-1:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيرات" الذي تعذّر تنفيذه، حدِّد ما إذا كان هناك عنصر <XMLPayload> يتضمّن عنصرًا فرعيًا <XPath> فارغًا. إذا كان الأمر كذلك، هذا هو سبب الخطأ.

    على سبيل المثال، إليك سياسة "استخراج المتغيرات" التي تتضمّن العنصر <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>

    بما أنّ هناك عنصر <XPath> فارغًا ضمن العنصر <XMLPayload>، يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة "استخراج المتغيّرات" تتضمّن عنصر <XPath> غير فارغ وصالح محدّد ضمن العنصر <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>/address</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

NoJSONPathsToEvaluate

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا لم يكن لعنصر <JSONPath> عنصر ضمن عنصر <JSONPayload> في سياسة استخراج المتغيّرات، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات وسيظهر الخطأ الموضّح أعلاه.

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو Extract-Variables-1:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، حدِّد ما إذا كان هناك عنصر <JSONPayload> بدون العنصر الفرعي المطلوب <JSONPath>. إذا كان الأمر كذلك، هذا هو سبب الخطأ.

    على سبيل المثال، إليك سياسة "استخراج المتغيرات" التي تحتوي على العنصر <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>

    بما أنّه لم يتم تحديد عنصر فرعي <JSONPath> ضمن العنصر <JSONPayload>، يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة "استخراج المتغيّرات" تتضمّن عنصر <JSONPath> محدّدًا ضمن العنصر <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">
            <JSONPath>$.book.title</JSONPath>
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

EmptyJSONPathExpression

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا كانت "سياسة استخراج المتغيرات" تتضمّن تعبيرًا فارغًا <JSONPath> ضمن العنصر <JSONPayload>، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو Extract-Variables-1:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيرات" الذي تعذّر تنفيذه، تحقَّق مما إذا كان هناك عنصر <JSONPayload> يتضمّن عنصرًا فرعيًا <JSONPath> فارغًا. إذا كان الأمر كذلك، هذا هو سبب الخطأ.

    على سبيل المثال، إليك سياسة "استخراج المتغيرات" التي تتضمّن العنصر <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>

    بما أنّ هناك عنصر <JSONPath> فارغًا ضمن العنصر <JSONPayload>، يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة "استخراج المتغيّرات" تتضمّن عنصر <JSONPath> غير فارغ وصالح محدّد ضمن العنصر <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>$.account.number</JSONPath>
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

MissingName

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا لم تتضمّن سياسة "استخراج المتغيّرات" السمة name في أيّ من عناصر السياسة، مثل QueryParam أو Header أو FormParam أو Variable، حيث تكون مطلوبة، سيتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

على سبيل المثال، يحدث هذا الخطأ إذا كانت السمة name غير متوفّرة في العنصر Variable.

التشخيص

  1. حدِّد اسم سياسة "استخراج المتغيّرات" التي حدث فيها الخطأ والعنصر الذي لا تتوفّر فيه السمة name. يمكنك العثور على هذه العناصر في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم السياسة هو Extract-Variables-1 واسم العنصر هو Variable:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، تأكَّد من أنّ جميع العناصر التي تحمل الاسم الذي تم تحديده من الخطوة 1 أعلاه تحتوي على السمة name. إذا كان هناك أي عنصر لا تتوفّر فيه سمة الاسم، سيكون ذلك هو سبب الخطأ.

    على سبيل المثال، تتضمّن سياسة "استخراج المتغيّرات" التالية العنصر <Variable> المحدّد:

    <?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>

    لاحظ أنّ السمة name غير متوفّرة في العنصر Variable، لذا يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

الدقة

تأكَّد من أنّ سياسة استخراج المتغيرات تتضمّن السمة name المطلوبة للعناصر QueryParam أو Header أو FormParam أو Variable. على سبيل المثال:

<?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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا لم تتضمّن سياسة "استخراج المتغيّرات" متغيّرًا محدّدًا ضمن العنصر <Pattern>، سيتعذّر نشر خادم API الوكيل. يتطلّب العنصر <Pattern> اسم المتغيّر الذي سيتم تخزين البيانات المستخرَجة فيه.

التشخيص

  1. تحديد اسم سياسة "استخراج المتغيرات" التي حدث فيها الخطأ والنمط الذي لم يتم العثور على المتغير فيه يمكنك العثور على هذه العناصر من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم السياسة هو Extract-Variables-1 واسم العنصر هو /a/b:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، تأكَّد من أنّ النمط الذي تم ضبطه في العنصر <Pattern> يتطابق مع النمط المحدّد في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية نمطًا /a/b يتطابق مع ما هو وارد في رسالة الخطأ:

    على سبيل المثال، إليك سياسة "استخراج المتغيرات" التي تتضمّن ثلاثة عناصر <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. تحقَّق ممّا إذا كان العنصر <Pattern> الذي تم تحديده في الخطوة 2 لا يحتوي على متغيّر. يجب وضع المتغيّرات بين أقواس معقوفة. إذا لم يتضمّن النمط متغيّرًا، سيكون ذلك هو سبب الخطأ.

    لا يتضمّن العنصر <Pattern> الذي يتضمّن النمط /a/b متغيّرًا، وبالتالي يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

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

الدقة

تأكَّد من أنّ أي عناصر <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/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/b/c/{pathSeg}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
</ExtractVariables>

CannotBeConvertedToNodeset

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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].

مثال على رسالة خطأ

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.

لقطة شاشة كمثال

السبب

إذا كانت سياسة "استخراج المتغيرات" تتضمّن تعبير <XPath> حيث تم تحديد النوع <Variable> على أنّه nodeset، ولكن لا يمكن تحويل التعبير إلى nodeset، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

التشخيص

  1. حدِّد سياسة "استخراج المتغيّرات" التي حدث فيها الخطأ وXPath الذي لا يمكن تحويله إلى مجموعة عقد. يمكنك العثور على كلتا القيمتين في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم السياسة هو Extract-Variables-1 وXPath هو 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. في ملف XML لسياسة "استخراج المتغيرات" الذي تعذّر تنفيذه، تأكَّد من أنّ XPath الذي تم ضبطه في العنصر <XPath> يتطابق مع XPath المحدّد في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية على أنّه 123، وهو ما يتطابق مع ما ورد في رسالة الخطأ:

    <?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. افحص نوع العنصر <Variable> الذي يتوافق مع <XPath> المحدّد في الخطوة رقم 2 أعلاه. إذا كان نوع <Variable> هو nodeset، سيكون هذا هو سبب الخطأ.

    لاحظ أنّ تعبير <XPath> هو 123 في مثال سياسة "استخراج المتغيّرات".

    <XPath>123</XPath>

    لا يمكن تحويل التعبير 123 إلى مجموعة عقد. لذلك، يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

الدقة

تأكَّد من إمكانية تحويل تعبيرات <XPath> المستخدَمة في سياسة "استخراج المتغيّرات" إلى مجموعة عقد إذا تم تحديد نوع <Variable> على أنّه مجموعة عقد. على سبيل المثال:

<?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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

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

مثال على رسالة خطأ

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

لقطة شاشة كمثال

السبب

إذا كان تعريف العنصر <Pattern> غير صالح في أي من العناصر، مثل URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload ضمن سياسة استخراج المتغيرات، سيتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات.

التشخيص

  1. حدِّد سياسة "استخراج المتغيرات" التي تعذّر تنفيذها من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو Extract-Variables-2:

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

  2. في ملف XML الخاص بسياسة "استخراج المتغيّرات" الذي تعذّر تنفيذه، تحقَّق مما إذا كان أي من هذه العناصر متوفّرًا ويتضمّن العنصر <Pattern>: URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload

    على سبيل المثال، إليك نموذجًا لسياسة "استخراج المتغيرات" يتضمّن عنصر <Pattern> ضمن العنصر <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. افحص تعريف كل عنصر من عناصر <Pattern>. إذا كان هناك أي عنصر <Pattern> يتضمّن تعريفًا غير صالح، سيكون هذا هو سبب الخطأ.

    في مثال سياسة "استخراج المتغيرات" الموضّح أعلاه، لاحظ أنّ تعريف <Pattern> ضمن العنصر <QueryParam> غير صالح، وبالتالي يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات. اطّلِع أيضًا على لمحة عن المطابقة وإنشاء المتغيّرات

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

الدقة

تأكَّد من أنّ تعريف عنصر <Pattern> ضِمن العناصر URIPath أو QueryParam أو Header أو FormParam أو XMLPayload أو JSONPayload في سياسة "استخراج المتغيّرات" صالح. على سبيل المثال:

<?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>

اطّلِع أيضًا على لمحة عن المطابقة وإنشاء المتغيّرات

XPathCompilationFailed

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، مع ظهور رسالة الخطأ التالية:

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].

مثال على رسالة خطأ

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.

لقطة شاشة كمثال

السبب

إذا لم يكن البادئة أو القيمة المستخدَمة في العنصر <XPath> جزءًا من أي من مساحات الأسماء المعرَّفة في سياسة استخراج المتغيرات، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

يمكنك العثور على مزيد من المعلومات حول مساحات الأسماء وXPath والبادئة في مساحات أسماء XML وتأثيرها في XPath وXSLT.

التشخيص

  1. حدِّد سياسة "استخراج المتغيّرات" التي حدث فيها الخطأ وXPath الذي تعذّر تجميعه. يمكنك العثور على كلتا القيمتين في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو EV-XML-Age ويكون xpath هو /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. في ملف XML لسياسة "استخراج المتغيرات" الذي تعذّر تنفيذه، تأكَّد من أنّ XPath الذي تم ضبطه في العنصر <XPath> يتطابق مع XPath المحدّد في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية على أنّه /apigee:Directions/apigee:route/apigee:leg/apigee:name، وهو ما يتطابق مع ما ورد في رسالة الخطأ:

    <?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. افحص العنصرَين <Namespaces> و<XPath> في سياسة "استخراج المتغيّرات". إذا كانت السمة <XPath> المحدّدة في رسالة الخطأ تستخدم بادئة أو قيمة ليست جزءًا من مساحات الأسماء المحدّدة في سياسة "استخراج المتغيّرات"، سيكون ذلك هو سبب الخطأ.

    يُرجى العِلم أنّ <XPath> المحدّد يستخدم البادئة apigee في مثال سياسة "استخراج المتغيّرات".

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

    ومع ذلك، لم يتم تحديد البادئة apigee في أي من عناصر <Namespace>، وبالتالي يتعذّر تجميع <XPath>، ما يؤدي إلى تعذّر النشر.

الدقة

تأكَّد من أنّ جميع مساحات الأسماء المستخدَمة في عناصر <XPath> معرَّفة في سياسة استخراج المتغيرات. على سبيل المثال:

<?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>