XMLtoJSON নীতি

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

কী

এই নীতি এক্সটেনসিবল মার্ক-আপ ল্যাঙ্গুয়েজ (XML) ফর্ম্যাট থেকে মেসেজকে জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON)-এ কনভার্ট করে, এর ফলে মেসেজ কীভাবে কনভার্ট করা হবে তা নিয়ন্ত্রণ করার জন্য আপনি একাধিক বিকল্প পাবেন।

যদি ধরে নেওয়া হয় যে XML-ফর্ম্যাট করা উত্তরকে JSON-ফর্ম্যাট করা উত্তরে পরিবর্তন করার উদ্দেশ্য রয়েছে, তাহলে নীতিটি একটি উত্তর ফ্লোতে (যেমন, উত্তর / ProxyEndpoint / PostFlow) অ্যাটাচ করা হবে।

সম্পর্কে

সাধারণত মধ্যস্থতা সংক্রান্ত পরিস্থিতিতে, ইনবাউন্ড অনুরোধ ফ্লোতে JSON থেকে XML নীতি প্রায়ই আউটবাউন্ড উত্তর ফ্লোতে XML থেকে JSON নীতির সাথে পেয়ার করা হয়। এইভাবে নীতি একত্রিত করার মাধ্যমে, JSON API-কে ব্যাক-এন্ড পরিষেবার জন্য এক্সপোজ করা যেতে পারে যা নেটিভভাবে শুধুমাত্র XML-এ কাজ করে।

যেসব পরিস্থিতিতে বিভিন্ন ক্লায়েন্ট অ্যাপ API ব্যবহার করে, যেগুলির JSON বা XML প্রয়োজন হতে পারে, সেখানে শর্তসাপেক্ষে চালানোর জন্য JSON থেকে XML এবং XML থেকে JSON নীতি কনফিগার করে, রেসপন্স ফর্ম্যাট ডায়নামিক সেট করা যেতে পারে। এই পরিস্থিতি প্রয়োগ করার জন্য ফ্লো ভেরিয়েবল ও কন্ডিশন দেখুন।

নমুনা

JSON ও XML-এর মধ্যে কনভার্ট করা নিয়ে বিস্তারিত আলোচনা পেতে, Apigee-এর মাধ্যমে XML ও JSON-এর মধ্যে কনভার্ট করা: আপনার যা জানা প্রয়োজন দেখুন।

<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">

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<Source> এলিমেন্ট

ভেরিয়েবল, অনুরোধ বা উত্তর, যাতে XML মেসেজ থাকে যা আপনি JSON-এ কনভার্ট করতে চান।

সোর্স মেসেজের HTTP কন্টেন্ট-টাইপ হেডারকে অবশ্যই application/xml হিসেবে সেট করতে হবে, তা না হলে নীতি প্রয়োগ করা যাবে না।

<Source> সংজ্ঞায়িত করা না থাকলে, এটিকে মেসেজ হিসেবে গণ্য করা হয় (যা কোনও অনুরোধ ফ্লোতে নীতি অ্যাটাচ করা থাকলে অনুরোধ হিসেবে সমাধান হয় অথবা কোনও উত্তর ফ্লোতে নীতি অ্যাটাচ করা থাকলে উত্তর হিসেবে সমাধান হয়)।

সোর্স ভেরিয়েবল সমাধান করা না গেলে অথবা মেসেজ নয় এমন কোনও ধরনের সাথে সমাধান করা হলে, নীতি একটি সমস্যা দেখায়।

<Source>response</Source>

<OutputVariable> এলিমেন্ট

XML থেকে JSON ফর্ম্যাটে কনভার্সন করা আউটপুট সেভ করে। এটি সাধারণত সোর্সের মতোই একই ভ্যালু হয়, অর্থাৎ, সাধারণত XML রেসপন্সকে JSON রেসপন্সে কনভার্ট করা হয়।

XML মেসেজের পেলোড পার্স করে JSON-এ কনভার্ট করা হয় এবং XML-ফর্ম্যাট করা মেসেজের HTTP Content-type হেডার application/json হিসেবে সেট করা হয়।

OutputVariable উল্লেখ করা না থাকলে, source-কে OutputVariable হিসেবে বিবেচনা করা হয়। যেমন, source-এর মান response হলে, OutputVariable-এর ডিফল্ট মান response হবে।

<OutputVariable>response</OutputVariable>

<Options>

বিকল্পগুলি আপনাকে XML থেকে JSON-এ কনভার্সনের উপর নিয়ন্ত্রণ দেয়। আপনি <Options> গ্রুপ ব্যবহার করতে পারেন, যা আপনাকে নির্দিষ্ট কনভার্সন সেটিংস যোগ করতে দেয় অথবা <Format> এলিমেন্ট ব্যবহার করতে পারেন, যা আপনাকে আগে থেকে নির্ধারিত বিকল্পের টেমপ্লেট রেফারেন্স করতে দেয়। আপনি <Options> ও <Format>, দুটিই ব্যবহার করতে পারবেন না।

<Format> ব্যবহার করা না হলে <Options> প্রয়োজন।

<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> এলিমেন্ট

কনভার্সন, ভ্যালুকে স্ট্রিংয়ে পরিবর্তন না করে, বুলিয়ান true/false ভ্যালু বজায় রাখে।

<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> এলিমেন্ট

আপনাকে খালি মানকে নাল মানে কনভার্ট করতে দেয়।

<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। 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"/>

XML থেকে JSON-এর উদাহরণে যেভাবে উল্লেখ করা হয়েছে, সেইভাবে দুটি অ্যাট্রিবিউটই (AttributeBlockName এবং AttributePrefix) নির্দিষ্ট করা থাকলে, নিম্নলিখিত 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"
    }
}

কোনওটিই নির্দিষ্ট করা না থাকলে, নিম্নলিখিত JSON স্ট্রাকচার তৈরি হয়:

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

<Options>/<OutputPrefix>
<Options>/<OutputSuffix> এলিমেন্ট

এইসব এলিমেন্ট একসাথে ব্যবহার করুন।

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

নিচের XML উদাহরণটি দেখুন:

<a>value</a>

XML থেকে JSON-এর উদাহরণে যেভাবে উল্লেখ করা হয়েছে, সেইভাবে দুটি অ্যাট্রিবিউট (OutputPrefix এবং OutputSuffix) নির্দিষ্ট করা থাকলে নিচে দেখানো 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>

কখনও কখনও SOAP-এর মতো XML পেলোডের অনেক প্যারেন্ট লেভেল থাকে যা আপনি কনভার্ট করা 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>

আপনি রাজ্য, শহর, বিবরণ ও তাপমাত্রা লেভেলে পৌঁছানোর আগে ৪টি লেভেল আছে। <StripLevels> ব্যবহার না করলে, কনভার্ট করা JSON উত্তরটি এইরকম দেখাবে:

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

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
                        }  ...

এই উদাহরণে লেভেল ৩ হল GetCityForecastByZIPResponse, যার একটিই চাইল্ড আছে। তাই, আপনি যদি <StripLevels>3</StripLevels> ব্যবহার করেন (প্রথম তিনটি লেভেল সরিয়ে দিন), তাহলে 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
            }  ...

যেহেতু লেভেল ৪ হল প্রথম লেভেল যেখানে একাধিক সন্তান আছে, তাই আপনি এর থেকে কম লেভেল বাদ দিতে পারবেন না। আপনি স্ট্রিপ লেভেল ৫, ৬, ৭ ইত্যাদি হিসেবে সেট করলে, উপরে উল্লিখিত উত্তরটি আপনি পেতে থাকবেন।

<Options>/<TreatAsArray>/<Path> এলিমেন্ট

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

এইসব এলিমেন্ট একসাথে ব্যবহার করলে, XML ডকুমেন্ট থেকে পাওয়া ভ্যালু JSON অ্যারেতে রাখা হয়েছে কিনা তা নিশ্চিত করতে পারবেন। এটি তখন কাজে লাগে, যখন চাইল্ড এলিমেন্টের সংখ্যা পরিবর্তিত হতে পারে (একটি থেকে একাধিক) এবং আপনি নিশ্চিত করতে চান যে ভ্যালুগুলি সবসময় একটি অ্যারেতে আছে। এটি করলে আপনার কোড স্থিতিশীল থাকে, কারণ আপনি প্রতিবার একই পদ্ধতিতে অ্যারে থেকে ডেটা পেতে পারেন। যেমন: $.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"
              ]}
           }
      }
}

লক্ষ্য করুন যে দুটি ছাত্রের নাম একটি অ্যারেতে রাখা হয়েছে।

তবে, 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 এখন একটি অ্যারেতে আছে। এখন, একজন বা একাধিক শিক্ষার্থী থাকুক না কেন, আপনি নিম্নলিখিত JSONPath ব্যবহার করে আপনার কোডে JSON অ্যারে থেকে তাদের রিট্রিভ করতে পারবেন: $.teachers.teacher.studentnames.name[0]

<Path> এলিমেন্টে unwrap অ্যাট্রিবিউটও আছে, যা পরের বিভাগে ব্যাখ্যা করা হয়েছে।

অ্যাট্রিবিউট

 <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 কমিউনিটি নিবন্ধ দেখুন: কমিউনিটি টিউটোরিয়াল: XML থেকে JSON নীতিতে TreatAsArray বিকল্প।

<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>

স্কিমা

সমস্যার রেফারেন্স

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Fault variables

These variables are set when a runtime error occurs. For more information, see What you need to know about policy errors.

Example error response

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

Example fault rule

<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 নীতি