تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة 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 إلى 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>