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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

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، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

السمة <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، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

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

التشخيص

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

    Error Saving Revision 1
    XMLToJSON[WithFormat]: Unknown Format google.com.
    
  2. تحقَّق من أنّ التنسيق غير المعروف الذي تم تحديده في سياسة XML التي تعذّر نقلها من 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>