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