นโยบาย XMLtoJSON

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

อะไร

นโยบายนี้จะแปลงข้อความจากรูปแบบ Extensible Markup Language (XML) เป็น JavaScript Object Notation (JSON) ซึ่งจะช่วยให้คุณมีตัวเลือกหลายอย่างในการควบคุมวิธีแปลงข้อความ

หากต้องการแปลงการตอบกลับในรูปแบบ XML เป็นการตอบกลับในรูปแบบ JSON นโยบายจะแนบไปกับโฟลว์การตอบกลับ (เช่น Response / ProxyEndpoint / PostFlow)

เกี่ยวกับ

ในสถานการณ์การไกล่เกลี่ยทั่วไป นโยบาย JSON เป็น XML ในโฟลว์คำขอขาเข้ามักจะ จับคู่กับนโยบาย XML เป็น JSON ในโฟลว์การตอบกลับขาออก การรวมนโยบายด้วยวิธีนี้จะช่วยให้แสดง JSON API สำหรับบริการแบ็กเอนด์ที่รองรับเฉพาะ XML ได้

สำหรับสถานการณ์ที่แอปไคลเอ็นต์ต่างๆ ใช้ API ซึ่งอาจต้องใช้ JSON หรือ XML คุณสามารถตั้งค่ารูปแบบการตอบกลับแบบไดนามิกได้โดยการกำหนดค่านโยบาย JSON เป็น XML และ XML เป็น JSON เพื่อดำเนินการแบบมีเงื่อนไข ดูการติดตั้งใช้งานสถานการณ์นี้ได้ที่ตัวแปรและเงื่อนไขของโฟลว์

ตัวอย่าง

ดูรายละเอียดเกี่ยวกับการแปลงระหว่าง JSON กับ XML ได้ที่การแปลงระหว่าง XML กับ JSON ด้วย Apigee: สิ่งที่คุณต้องรู้

<XMLToJSON name="ConvertToJSON">
  <Options>
  </Options>
  <OutputVariable>response</OutputVariable>
  <Source>response</Source>
</XMLToJSON>

การอ้างอิงองค์ประกอบ

ต่อไปนี้คือองค์ประกอบและแอตทริบิวต์ที่คุณกำหนดค่าในนโยบายนี้ได้

<XMLToJSON async="false" continueOnError="false" enabled="true" name="XML-to-JSON-1">
    <DisplayName>XML to JSON 1</DisplayName>
    <Source>response</Source>
    <OutputVariable>response</OutputVariable>
    <Options>
        <RecognizeNumber>true</RecognizeNumber>
        <RecognizeBoolean>true</RecognizeBoolean>
        <RecognizeNull>true</RecognizeNull>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>&</DefaultNamespaceNodeName>
        <NamespaceSeparator>***</NamespaceSeparator>
        <TextAlwaysAsProperty>true</TextAlwaysAsProperty>
        <TextNodeName>TEXT</TextNodeName>
        <AttributeBlockName>FOO_BLOCK</AttributeBlockName>
        <AttributePrefix>BAR_</AttributePrefix>
        <OutputPrefix>PREFIX_</OutputPrefix>
        <OutputSuffix>_SUFFIX</OutputSuffix>
        <StripLevels>2</StripLevels>
        <TreatAsArray>
            <Path unwrap="true">teachers/teacher/studentnames/name</Path>
        </TreatAsArray>
    </Options>
    <!-- Use Options or Format, not both -->
    <Format>yahoo</Format>
</XMLToJSON>

แอตทริบิวต์ <XMLtoJSON>

<XMLtoJSON async="false" continueOnError="false" enabled="true" name="XML-to-JSON-1">

ตารางต่อไปนี้อธิบายแอตทริบิวต์ทั่วไปในองค์ประกอบระดับบนสุดของนโยบายทั้งหมด

&lt;DisplayName&gt; องค์ประกอบ

ใช้เพิ่มเติมจากแอตทริบิวต์ name เพื่อติดป้ายกำกับนโยบายใน เครื่องมือแก้ไขพร็อกซี UI การจัดการด้วยชื่อที่เป็นภาษาธรรมชาติต่างกัน

<DisplayName>Policy Display Name</DisplayName>

องค์ประกอบ <Source>

ตัวแปร คำขอ หรือการตอบกลับที่มีข้อความ XML ที่คุณต้องการแปลงเป็น JSON

ต้องตั้งค่าส่วนหัวประเภทเนื้อหา HTTP ของข้อความต้นทางเป็น application/xml มิเช่นนั้นนโยบายจะไม่มีผล

หากไม่ได้กำหนด <Source> ไว้ ระบบจะถือว่าเป็นข้อความ (ซึ่งจะเปลี่ยนเป็นคำขอเมื่อแนบนโยบายกับโฟลว์คำขอ หรือเปลี่ยนเป็นการตอบกลับเมื่อแนบนโยบายกับโฟลว์การตอบกลับ)

หากไม่สามารถระบุตัวแปรแหล่งที่มา หรือระบุเป็นประเภทที่ไม่ใช่ข้อความ นโยบาย จะแสดงข้อผิดพลาด

<Source>response</Source>

องค์ประกอบ <OutputVariable>

จัดเก็บเอาต์พุตของการแปลง XML เป็นรูปแบบ JSON โดยปกติแล้วค่านี้จะเหมือนกับค่าของแหล่งที่มา นั่นคือโดยปกติแล้วการตอบกลับ XML จะได้รับการแปลงเป็นการตอบกลับ JSON

ระบบจะแยกวิเคราะห์เพย์โหลดของข้อความ XML และแปลงเป็น JSON จากนั้นตั้งค่าส่วนหัว Content-type ของ HTTP ของข้อความรูปแบบ XML เป็น application/json

หากไม่ได้ระบุ OutputVariable ระบบจะถือว่า source เป็น OutputVariable เช่น หาก source คือ response OutputVariable จะมีค่าเริ่มต้นเป็น response

<OutputVariable>response</OutputVariable>

<ตัวเลือก>

ตัวเลือกช่วยให้คุณควบคุมการแปลงจาก XML เป็น JSON ได้ ใช้กลุ่ม <Options> ซึ่งช่วยให้คุณเพิ่มการตั้งค่า Conversion ที่เฉพาะเจาะจง หรือใช้องค์ประกอบ <Format> ซึ่งช่วยให้คุณอ้างอิงเทมเพลตของ ตัวเลือกที่กำหนดไว้ล่วงหน้า คุณไม่สามารถใช้ทั้ง <Options> และ <Format>

ต้องระบุ <Options> หากไม่ได้ใช้ <Format>

องค์ประกอบ <Options>/<RecognizeNumber>

หากเป็นจริง ฟิลด์ตัวเลขในเพย์โหลด XML จะยังคงรูปแบบเดิม

<RecognizeNumber>true</RecognizeNumber>

ลองดูตัวอย่าง XML ต่อไปนี้

<a>
  <b>100</b>
  <c>value</c>
</a>

หาก true จะแปลงเป็น

{
    "a": {
        "b": 100,
        "c": "value"
    }
}

หาก false จะแปลงเป็น

{
    "a": {
        "b": "100",
        "c": "value"
    }
}

องค์ประกอบ <Options>/<RecognizeBoolean>

ช่วยให้ Conversion รักษาค่าบูลีนเป็นจริง/เท็จไว้ได้แทนที่จะเปลี่ยนค่าเป็นสตริง

<RecognizeBoolean>true</RecognizeBoolean>

สำหรับตัวอย่าง XML ต่อไปนี้

<a>
  <b>true</b>
  <c>value</c>
</a>

หาก true จะแปลงเป็น

{
    "a": {
        "b": true,
        "c": "value"
    }
}

หาก false จะแปลงเป็น

{
    "a": {
        "b": "true",
        "c": "value"
    }
}

องค์ประกอบ <Options>/<RecognizeNull>

ช่วยให้คุณแปลงค่าว่างเป็นค่า Null ได้

<RecognizeNull>true</RecognizeNull>

สำหรับ XML ต่อไปนี้

<a>
  <b></b>
  <c>value</c>
</a>

หาก true จะแปลงเป็น

{
  "a": {
    "b": null,
    "c": "value"
  }
}

หาก false จะแปลงเป็น

{
  "a": {
    "b": {},
    "c": "value"
  }
}

องค์ประกอบ <Options>/<NullValue>

ระบุค่าที่ควรแปลงค่า Null ที่ระบบรู้จักในข้อความต้นฉบับ โดยค่าเริ่มต้น ค่าจะเป็น null ตัวเลือกนี้จะมีผลก็ต่อเมื่อ RecognizeNull เป็นจริงเท่านั้น

<NullValue>not-present</NullValue>

องค์ประกอบ <Options>/<NamespaceBlockName>
<Options>/<DefaultNamespaceNodeName>
<Options>/<NamespaceSeparator>

ใช้องค์ประกอบเหล่านี้ร่วมกัน

<NamespaceBlockName>#namespaces</NamespaceBlockName>
<DefaultNamespaceNodeName>&</DefaultNamespaceNodeName>
<NamespaceSeparator>***</NamespaceSeparator>

ลองดูตัวอย่าง XML ต่อไปนี้

<a xmlns="http://ns.com" xmlns:ns1="http://ns1.com">
  <ns1:b>value</ns1:b>
</a>

หากไม่ได้ระบุ NamespaceSeparator ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
    "a": {
        "b": "value"
    }
}

หากระบุองค์ประกอบ NamespaceBlockName, DefaultNamespaceNodeName และ NamespaceSeparator เป็น #namespaces, & และ *** ตามลำดับ ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
    "a": {
        "#namespaces": {
            "&": "http://ns.com",
            "ns1": "http://ns1.com"
        },
        "ns1***b": "value"
    }
}

องค์ประกอบ <Options>/<TextAlwaysAsProperty>
<Options>/<TextNodeName>

ใช้องค์ประกอบเหล่านี้ร่วมกัน

หากตั้งค่าเป็น true ระบบจะแปลงเนื้อหาขององค์ประกอบ XML เป็นพร็อพเพอร์ตี้สตริง

<TextAlwaysAsProperty>true</TextAlwaysAsProperty>
<TextNodeName>TEXT</TextNodeName>

สำหรับ XML ต่อไปนี้

<a>
  <b>value1</b>
  <c>value2<d>value3</d>value4</c>
</a>

หากตั้งค่า TextAlwaysAsProperty เป็น true และระบุ TextNodeName เป็น TEXT ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
  "a": {
    "b": {
      "TEXT": "value1"
    },
    "c": {
      "TEXT": [
        "value2",
        "value4"
        ],
        "d": {
          "TEXT": "value3"
        }
      }
    }
}

หากตั้งค่า TextAlwaysAsProperty เป็น false และ ระบุ TextNodeName เป็น TEXT ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
  "a": {
    "b": "value1",
    "c": {
      "TEXT": [
        "value2",
        "value4"
      ],
      {
        "d": "value3",
      }
    }
}

<Options>/<AttributeBlockName>
องค์ประกอบ <Options>/<AttributePrefix>

ใช้องค์ประกอบเหล่านี้ร่วมกัน

ช่วยให้คุณจัดกลุ่มค่าเป็นบล็อก JSON และต่อท้ายคำนำหน้ากับชื่อแอตทริบิวต์

<AttributeBlockName>FOO_BLOCK</AttributeBlockName>
<AttributePrefix>BAR_</AttributePrefix>

ลองดูตัวอย่าง XML ต่อไปนี้

<a attrib1="value1" attrib2="value2"/>

หากระบุทั้งแอตทริบิวต์ (AttributeBlockName และ AttributePrefix) ตามที่กำหนดไว้ในตัวอย่าง XML เป็น JSON ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
  "a": {
    "FOO_BLOCK": {
      "BAR_attrib1": "value1",
      "BAR_attrib2": "value2"
    }
  }
}

หากระบุเฉพาะ AttributeBlockName ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้ ขึ้น

{
    "a": {
        "FOO_BLOCK": {
            "attrib1": "value1",
            "attrib2": "value2"
        }
    }
}

หากระบุเฉพาะ AttributePrefix ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้ ขึ้น

{
    "a": {
        "BAR_attrib1": "value1",
        "BAR_attrib2": "value2"
    }
}

หากไม่ได้ระบุทั้ง 2 อย่าง ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
    "a": {
        "attrib1": "value1",
        "attrib2": "value2"
    }
}

องค์ประกอบ <Options>/<OutputPrefix>
<Options>/<OutputSuffix>

ใช้องค์ประกอบเหล่านี้ร่วมกัน

<OutputPrefix>PREFIX_</OutputPrefix>
<OutputSuffix>_SUFFIX</OutputSuffix>

ลองดูตัวอย่าง XML ต่อไปนี้

<a>value</a>

หากระบุทั้งแอตทริบิวต์ (OutputPrefix และ OutputSuffix) ตามที่กำหนดไว้ในตัวอย่าง XML เป็น JSON ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

PREFIX_{
    "a": "value"
}_SUFFIX

หากระบุเฉพาะ OutputPrefix ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

PREFIX_{
  "a" : "value"
}

หากระบุเฉพาะ OutputSuffix ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
  "a" : "value"
}_SUFFIX

หากไม่ได้ระบุทั้ง OutputPrefix และ OutputSuffix ระบบจะสร้างโครงสร้าง JSON ต่อไปนี้

{
    "a": "value"
}

องค์ประกอบ <Options>/<StripLevels>

<Options>
    <StripLevels>4</StripLevels>
</Options>

บางครั้งเพย์โหลด XML เช่น SOAP มีระดับพาเรนต์หลายระดับที่คุณไม่ต้องการรวมไว้ใน JSON ที่แปลงแล้ว ต่อไปนี้คือตัวอย่างการตอบกลับ SOAP ที่มีหลายระดับ

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/Schemata-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
      <GetCityWeatherByZIPResponse xmlns="http://ws.cdyne.com/WeatherWS/">
          <GetCityWeatherByZIPResult>
              <State>CO</State>
              <City>Denver</City>
              <Description>Sunny</Description>
              <Temperature>62</Temperature>
          </GetCityWeatherByZIPResult>
      </GetCityWeatherByZIPResponse>
  </soap:Body>
</soap:Envelope>

โดยมี 4 ระดับก่อนที่จะถึงระดับรัฐ เมือง คำอธิบาย และอุณหภูมิ หากไม่ใช้ <StripLevels> การตอบกลับ JSON ที่แปลงแล้วจะมีลักษณะดังนี้

{
   "Envelope" : {
      "Body" : {
         "GetCityWeatherByZIPResponse" : {
            "GetCityWeatherByZIPResult" : {
               "State" : "CO",
               "City" : "Denver",
               "Description" : "Sunny",
               "Temperature" : "62"
            }
         }
      }
   }
}

หากต้องการลบ 4 ระดับแรกในการตอบกลับ JSON คุณจะต้องตั้งค่า <StripLevels>4</StripLevels> ซึ่งจะให้ JSON ต่อไปนี้ แก่คุณ

{
  "State" : "CO",
  "City" : "Denver",
  "Description" : "Sunny",
  "Temperature" : "62"
}

คุณสามารถลบระดับออกได้จนถึงองค์ประกอบแรกที่มีองค์ประกอบย่อยหลายรายการ หมายความว่าอย่างไร มาดูตัวอย่าง JSON ที่ซับซ้อนขึ้นกัน

{
   "Envelope" : {
      "Body" : {
         "GetCityForecastByZIPResponse" : {
            "GetCityForecastByZIPResult" : {
               "ResponseText" : "City Found",
               "ForecastResult" : {
                  "Forecast" : [
                     {
                        "ProbabilityOfPrecipiation" : {
                           "Nighttime" : "00",
                           "Daytime" : 10
                        }  ...

ระดับ 3 ในตัวอย่างนี้คือ GetCityForecastByZIPResponse ซึ่งมีลูกเพียงคนเดียว ดังนั้นหากคุณใช้ <StripLevels>3</StripLevels> (นำ 3 ระดับแรกออก) JSON จะมีลักษณะดังนี้

{
   "GetCityForecastByZIPResult" : {
      "ResponseText" : "City Found",
      "ForecastResult" : {
         "Forecast" : [
            {
               "ProbabilityOfPrecipiation" : {
                  "Nighttime" : "00",
                  "Daytime" : 10
               }  ...

โปรดสังเกตว่า GetCityForecastByZIPResult มีองค์ประกอบย่อยหลายรายการ เนื่องจากเป็นองค์ประกอบแรกที่มีองค์ประกอบย่อยหลายรายการ คุณจึงลบระดับสุดท้ายนี้ได้โดยใช้ <StripLevels>4</StripLevels> ซึ่งจะให้ JSON ต่อไปนี้

{
   "ResponseText" : "City Found",
   "ForecastResult" : {
      "Forecast" : [
         {
            "ProbabilityOfPrecipiation" : {
               "Nighttime" : "00",
               "Daytime" : 10
            }  ...

เนื่องจากระดับ 4 เป็นระดับแรกที่มีโฟลเดอร์ย่อยหลายโฟลเดอร์ คุณจึงไม่สามารถแยกโฟลเดอร์ระดับที่ต่ำกว่านี้ได้ หากตั้งค่าระดับแถบเป็น 5, 6, 7 และอื่นๆ คุณจะยังคงได้รับคำตอบ ข้างต้น

องค์ประกอบ <Options>/<TreatAsArray>/<Path>

<Options>
    <TreatAsArray>
        <Path unwrap="true">teachers/teacher/studentnames/name</Path>
    </TreatAsArray>
</Options>

การรวมองค์ประกอบนี้ช่วยให้มั่นใจได้ว่าค่าจากเอกสาร XML จะอยู่ในอาร์เรย์ JSON ซึ่งจะมีประโยชน์ เช่น เมื่อจำนวนองค์ประกอบย่อยอาจแตกต่างกัน (ตั้งแต่ 1 รายการขึ้นไป) และคุณต้องการให้ค่าอยู่ในอาร์เรย์เสมอ การทำเช่นนี้จะช่วยให้โค้ดของคุณเสถียร เนื่องจากคุณจะรับข้อมูลจากอาร์เรย์ได้ในลักษณะเดียวกันทุกครั้ง ตัวอย่างเช่น $.teachers.teacher.studentnames[0] จะรับค่าชื่อนักเรียนคนแรก ในอาร์เรย์โดยไม่คำนึงถึงจำนวนค่าในอาร์เรย์

มาดูพฤติกรรมเริ่มต้นของ XML เป็น JSON แล้วดูวิธี ควบคุมเอาต์พุตโดยใช้ <TreatAsArray>/<Path> กัน

เมื่อเอกสาร XML มีองค์ประกอบที่มีค่าลูกหลายค่า (โดยปกติจะอิงตามสคีมา ที่องค์ประกอบมี maxOccurs='unbounded') นโยบาย XML เป็น JSON จะ วางค่าเหล่านั้นไว้ในอาร์เรย์โดยอัตโนมัติ เช่น บล็อก XML ต่อไปนี้

<teacher>
    <name>teacherA</name>
    <studentnames>
        <name>student1</name>
        <name>student2</name>
    </studentnames>
</teacher>

...จะได้รับการแปลงเป็น JSON ต่อไปนี้โดยอัตโนมัติโดยไม่มีการกำหนดค่านโยบายพิเศษ

{
  "teachers" : {
      "teacher" : {
          "name" : "teacherA",
          "studentnames" : {
              "name" : [
                 "student1",
                 "student2"
              ]}
           }
      }
}

โปรดสังเกตว่าชื่อนักเรียน 2 คนจะอยู่ในอาร์เรย์

อย่างไรก็ตาม หากมีนักเรียนเพียงคนเดียวในเอกสาร XML นโยบาย XML เป็น JSON จะถือว่าค่าเป็นสตริงเดียวโดยอัตโนมัติ ไม่ใช่อาร์เรย์ของสตริง ดังที่แสดงในตัวอย่างต่อไปนี้

{
  "teachers" : {
      "teacher" : {
          "name" : "teacherA",
          "studentnames" : {
              "name" : "student1"
              }
          }
      }
}

ในตัวอย่างก่อนหน้า ระบบจะแปลงข้อมูลที่คล้ายกันในรูปแบบที่แตกต่างกัน โดยครั้งหนึ่งเป็นอาร์เรย์ และอีกครั้งเป็นสตริงเดียว องค์ประกอบ <TreatAsArray>/<Path> ช่วยให้คุณควบคุมเอาต์พุตได้ เช่น คุณสามารถตรวจสอบว่าระบบจะใส่ชื่อนักเรียนในอาร์เรย์เสมอแม้จะมีค่าเพียงค่าเดียวก็ตาม คุณกำหนดค่านี้ได้โดยระบุเส้นทางไปยังองค์ประกอบ ซึ่งมีค่าที่คุณต้องการใส่ในอาร์เรย์ ดังนี้

<Options>
    <TreatAsArray>
        <Path>teachers/teacher/studentnames/name</Path>
    </TreatAsArray>
</Options>

การกำหนดค่าข้างต้นจะเขียน JSON ดังนี้

{
  "teachers" : {
      "teacher" : {
          "name" : "teacherA",
          "studentnames" : {
              "name" : ["student1"]
              }
            ]
          }
      }
}

โปรดสังเกตว่าตอนนี้ student1 อยู่ในอาร์เรย์แล้ว ตอนนี้ไม่ว่าจะมีนักเรียน/นักศึกษาคนเดียวหรือหลายคน คุณก็สามารถดึงข้อมูลจากอาร์เรย์ JSON ในโค้ดได้โดยใช้ JSONPath ต่อไปนี้ $.teachers.teacher.studentnames.name[0]

นอกจากนี้ องค์ประกอบ <Path> ยังมีแอตทริบิวต์ unwrap ซึ่งอธิบายไว้ใน ส่วนถัดไป

Attributes

 <Options>
    <TreatAsArray>
        <Path unwrap="true">teachers/teacher/studentnames/name</Path>
    </TreatAsArray>
</Options>

{
  "teachers" : {
      "teacher" : {
          "name" : "teacherA",
          "studentnames" : {
              "name" : [
                 "student1",
                 "student2"
              ]}...

<TreatAsArray>
    <Path unwrap="true">teachers/teacher</Path>
    <Path unwrap="true">teachers/teacher/studentnames/name</Path>
</TreatAsArray>

{
  "teachers" : [{
      "name" : "teacherA",
      "studentnames" : ["student1","student2"]
      }]...

ดูตัวอย่างเพิ่มเติมและคำแนะนำแบบทีละขั้นตอนเกี่ยวกับฟีเจอร์ได้ที่บทความในชุมชน Apigee นี้: บทแนะนำสำหรับชุมชน: ตัวเลือก TreatAsArray ในนโยบาย XML เป็น JSON

<Format>

รูปแบบช่วยให้คุณควบคุมการแปลงจาก XML เป็น JSON ได้ ป้อนชื่อเทมเพลตที่กำหนดไว้ล่วงหน้า ซึ่งมีชุดค่าผสมเฉพาะขององค์ประกอบตัวเลือกที่อธิบายไว้ในหัวข้อนี้ รูปแบบที่กำหนดไว้ล่วงหน้า ได้แก่ xml.com, yahoo, google, badgerFish

ใช้ทั้งองค์ประกอบ <Format> หรือกลุ่ม <Options> คุณไม่สามารถใช้ทั้ง <Format> และ <Options>

คำจำกัดความของรูปแบบของเทมเพลตที่กำหนดไว้ล่วงหน้าแต่ละรายการมีดังนี้

xml.com

<RecognizeNull>true</RecognizeNull>
<TextNodeName>#text</TextNodeName>
<AttributePrefix>@</AttributePrefix>

yahoo

<RecognizeNumber>true</RecognizeNumber>
<TextNodeName>content</TextNodeName>

Google

<TextNodeName>$t</TextNodeName>
<NamespaceSeparator>$</NamespaceSeparator>
<TextAlwaysAsProperty>true</TextAlwaysAsProperty>

badgerFish

<TextNodeName>$</TextNodeName>
<TextAlwaysAsProperty>true</TextAlwaysAsProperty>
<AttributePrefix>@</AttributePrefix>
<NamespaceSeparator>:</NamespaceSeparator>
<NamespaceBlockName>@xmlns</NamespaceBlockName>
<DefaultNamespaceNodeName>$</DefaultNamespaceNodeName>

ไวยากรณ์ขององค์ประกอบ

<Format>yahoo</Format>

สคีมา

ข้อมูลอ้างอิงข้อผิดพลาด

ส่วนนี้จะอธิบายรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดที่แสดงกลับมา และตัวแปรข้อผิดพลาดที่ Edge ตั้งค่าไว้เมื่อนโยบายนี้ทริกเกอร์ข้อผิดพลาด ข้อมูลนี้มีความสำคัญต่อการทราบว่าคุณจะสร้างกฎความผิดพลาดเพื่อ จัดการกับข้อผิดพลาด หากต้องการเรียนรู้เพิ่มเติม โปรดดูที่สิ่งที่คุณจำเป็นต้องทราบ เกี่ยวกับข้อผิดพลาดของนโยบายและการจัดการ ข้อผิดพลาด

ข้อผิดพลาดเกี่ยวกับรันไทม์

ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นเมื่อนโยบายทำงาน

ข้อผิดพลาดในการทำให้ใช้งานได้

ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นเมื่อคุณใช้พร็อกซีที่มีนโยบายนี้

ตัวแปรความผิดพลาด

ระบบจะตั้งค่าตัวแปรเหล่านี้เมื่อเกิดข้อผิดพลาดรันไทม์ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อสิ่งที่คุณจำเป็นต้องทราบ เกี่ยวกับข้อผิดพลาดของนโยบาย

ตัวอย่างการตอบสนองข้อผิดพลาด

{
  "fault": {
    "faultstring": "XMLToJSON[XMLtoJSON-1]: Source xyz is not available",
    "detail": {
      "errorcode": "steps.xml2json.SourceUnavailable"
    }
  }
}

ตัวอย่างกฎข้อผิดพลาด

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="XML to JSON Faults">
    <Step>
        <Name>AM-SourceUnavailableMessage</Name>
        <Condition>(fault.name Matches "SourceUnavailable") </Condition>
    </Step>
    <Step>
        <Name>AM-BadXML</Name>
        <Condition>(fault.name = "ExecutionFailed")</Condition>
    </Step>
    <Condition>(xmltojson.XMLtoJSON-1.failed = true) </Condition>
</FaultRule>

หัวข้อที่เกี่ยวข้อง

JSON เป็น XML: นโยบาย JSON เป็น XML