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

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

EitherOptionOrFormat

رسالة الخطأ

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

Error Saving Revision [revision_number]
XMLToJSON[{0}]: Either Options or Format must be specified.

مثال على الخطأ

Error Saving Revision 1
XMLToJSON[{0}]: Either Options or Format must be specified.

مثال على لقطة شاشة

السبب

إذا لم يتم تعريف أحد العنصرَين <Options> أو <Format> في سياسة XML إلى JSON، سيتعذّر نشر خادم API الوكيل.

السمة <Options> مطلوبة في حال عدم استخدام السمة <Format>.

استخدِم العنصر <Format> أو مجموعة العناصر <Options>. لا يمكنك استخدام كل من <Format> و<Options>. تشمل التنسيقات المحدّدة مسبقًا ما يلي: xml.com وyahoo وgoogle وbadgerFish.

التشخيص

  1. افحص جميع سياسات XML إلى JSON في خادم وكيل واجهة برمجة التطبيقات المحدّد الذي حدث فيه الخطأ. إذا كانت هناك أي سياسة XML إلى JSON لم يتم فيها تعريف أي من العنصرين <Options> أو <Format>، سيكون ذلك هو سبب الخطأ.

    على سبيل المثال، لا تتضمّن السياسة التالية أيًا من العنصرَين المحدّدَين:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

الدقة

تأكَّد من أنّ XML لسياسة XML إلى JSON يحتوي على أحد العنصرين <Options> أو <Format> المحدّدين في السياسة.

المثال 1:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <Format>google</Format>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

المثال 2:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <Options>
        <RecognizeNumber>true</RecognizeNumber>
        <RecognizeBoolean>true</RecognizeBoolean>
        <RecognizeNull>true</RecognizeNull>
    </Options>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

UnknownFormat

رسالة الخطأ

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

Error Saving Revision [revision_number]
XMLToJSON[policy_name]: Unknown Format [unknown_format].

مثال على الخطأ

Error Saving Revision 1
XMLToJSON[WithFormat]: Unknown Format google.com.

مثال على لقطة شاشة

السبب

إذا كان العنصر <Format> ضمن سياسة XML إلى JSON يتضمّن تنسيقًا غير معروف، سيتعذّر نشر خادم API الوكيل.

تشمل التنسيقات المحدّدة مسبقًا ما يلي: xml.com وyahoo وgoogle وbadgerFish.

التشخيص

  1. حدِّد سياسة XML إلى JSON التي حدث فيها الخطأ والتنسيق غير المعروف. يمكنك العثور على هذه المعلومات من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو WithFormat والتنسيق غير المعروف هو google.com:

    Error Saving Revision 1
XMLToJSON[WithFormat]: Unknown Format google.com.

  2. تأكَّد من أنّ التنسيق غير المعروف المحدّد في سياسة XML إلى JSON التي تعذّر تنفيذها يتطابق مع القيمة المحدّدة في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدّد السياسة التالية التنسيق على أنّه google.com، وهو ما يتطابق مع ما ورد في رسالة الخطأ:

    <XMLToJSON async="false" continueOnError="false" enabled="true" name="WithFormat">
  <DisplayName>WithFormat</DisplayName>
  <Properties/>
  <Format>google.com</Format>
  <OutputVariable>response</OutputVariable>
  <Source>response</Source>
</XMLToJSON>

  3. إذا لم يكن التنسيق المحدّد أحد التنسيقات المحدّدة مسبقًا xml.com أو yahoo أو google أو badgerFish، سيكون ذلك هو سبب الخطأ.

    في مثال سياسة XML إلى JSON الموضّح أعلاه، التنسيق هو google.com وهو تنسيق غير صالح. لذلك، يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات ويظهر الخطأ التالي:

    XMLToJSON[WithFormat]: Unknown Format google.com.

الدقة

تأكَّد من أنّ التنسيق المحدّد في العنصر <Format> من سياسة XML إلى JSON صالح. على سبيل المثال:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="WithFormat">
  <DisplayName>WithFormat</DisplayName>
  <Properties/>
  <Format>google</Format>
  <OutputVariable>response</OutputVariable>
  <Source>response</Source>
</XMLToJSON>