এক্সট্রাক্ট ভেরিয়েবল নীতি

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

কি

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

যদিও আপনি প্রায়শই এই নীতিটি একটি অনুরোধ বা প্রতিক্রিয়া বার্তা থেকে তথ্য বের করার জন্য ব্যবহার করেন, আপনি এটি অন্যান্য উৎস থেকে তথ্য বের করার জন্যও ব্যবহার করতে পারেন, যার মধ্যে AccessEntity নীতি , XML অবজেক্ট বা JSON অবজেক্ট দ্বারা তৈরি সত্তা অন্তর্ভুক্ত রয়েছে।

নির্দিষ্ট বার্তার বিষয়বস্তু বের করার পরে, আপনি অনুরোধ এবং প্রতিক্রিয়া প্রক্রিয়াকরণের অংশ হিসাবে অন্যান্য নীতিতে ভেরিয়েবলটি উল্লেখ করতে পারেন।

ভিডিও

ExtractVariables নীতি সম্পর্কে আরও জানতে নিম্নলিখিত ভিডিওগুলি দেখুন।

নমুনা

এই নীতি কোড নমুনাগুলি নিম্নলিখিত ধরণের শিল্পকর্ম থেকে ভেরিয়েবলগুলি কীভাবে বের করতে হয় তা ব্যাখ্যা করে:

<ExtractVariables name="ExtractVariables-1">
   <DisplayName>Extract a portion of the url path</DisplayName>
   <Source>request</Source>
   <URIPath>
      <Pattern ignoreCase="true">/accounts/{id}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

<AssignMessage async="false" continueOnError="false" enabled="true" name="AssignPayload">
 <DisplayName>AssignPayload</DisplayName>
  <Set>
   <Payload contentType="text/xml">
    <IdExtractedFromURI>{urirequest.id}</IdExtractedFromURI>
   </Payload>
  </Set>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="true" transport="http" type="request">newRequest</AssignTo>
</AssignMessage>

<ExtractVariables name="ExtractVariables-2">
   <DisplayName>Extract a value from a query parameter</DisplayName>
   <Source>request</Source>
   <QueryParam name="code">
      <Pattern ignoreCase="true">DBN{dbncode}</Pattern>
   </QueryParam>
   <VariablePrefix>queryinfo</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath">
 <DisplayName>GetQP</DisplayName>
  <Set>
   <Payload contentType="text/xml">
    <ExtractQP>{queryinfo.dbncode}</ExtractQP>
   </Payload>
  </Set>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<ExtractVariables name="ExtractVariables-2">
   <DisplayName>Extract a value from a query parameter</DisplayName>
   <Source>request</Source>
   <QueryParam name="w">
      <Pattern ignoreCase="true">{firstWeather}</Pattern>
   </QueryParam>
   <QueryParam name="w.2">
     <Pattern ignoreCase="true">{secondWeather}</Pattern>
   </QueryParam>
   <VariablePrefix>queryinfo</VariablePrefix>
 <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath">
 <DisplayName>GetQP</DisplayName>
  <Set>
   <Payload contentType="text/xml">
    <ExtractQP1>{queryinfo.firstWeather}</ExtractQP1>
    <ExtractQP2>{queryinfo.secondWeather}</ExtractQP2>
   </Payload>
  </Set>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<ExtractVariables name='ExtractVariable-OauthToken'>
  <Source>request</Source>
  <Header name="Authorization">
    <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern>
  </Header>
  <VariablePrefix>clientrequest</VariablePrefix>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath">
 <DisplayName>GetHeader</DisplayName>
  <Set>
   <Payload contentType="text/xml">
    <ExtractHeader>{clientrequest.oauthtoken}</ExtractHeader>
   </Payload>
  </Set>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<ExtractVariables name="ExtractVariables-3">
   <Source>response</Source>
   <JSONPayload>
      <Variable name="latitude" type="float">
         <JSONPath>$.results[0].geometry.location.lat</JSONPath>
      </Variable>
      <Variable name="longitude" type="float">
         <JSONPath>$.results[0].geometry.location.lng</JSONPath>
      </Variable>
   </JSONPayload>
   <VariablePrefix>geocoderesponse</VariablePrefix>
</ExtractVariables>

{
  "results": [{
    "geometry": {
      "location": {
        "lat": 37.42291810,
        "lng": -122.08542120
      },
      "location_type": "ROOFTOP",
      "viewport": {
        "northeast": {
          "lat": 37.42426708029149,
          "lng": -122.0840722197085
        },
        "southwest": {
          "lat": 37.42156911970850,
          "lng": -122.0867701802915
        }
      }
    }
  }]
}

<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath">
  <DisplayName>GetJSONVar</DisplayName>
  <Add>
    <Headers>
      <Header name="latitude">{geocoderesponse.latitude}</Header>
    </Headers>
  </Add>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

<ExtractVariables name="ExtractVariables-4">
   <Source>response</Source>
   <XMLPayload>
      <Namespaces>
         <Namespace prefix="dir">urn:43BFF88D-D204-4427-B6BA-140AF393142F</Namespace>
      </Namespaces>
      <Variable name="travelmode" type="string">
         <XPath>/dir:Directions/dir:route/dir:leg/dir:step/@mode</XPath>
      </Variable>
      <Variable name="duration" type="string">
         <XPath>/dir:Directions/dir:route/dir:leg/dir:step/dir:duration/dir:value</XPath>
      </Variable>
      <Variable name="timeunit" type="string">
         <XPath>/dir:Directions/dir:route/dir:leg/dir:step/dir:duration/dir:text</XPath>
      </Variable>
   </XMLPayload>
   <VariablePrefix>directionsresponse</VariablePrefix>
</ExtractVariables>

<Directions xmlns="urn:43BFF88D-D204-4427-B6BA-140AF393142F">
   <status>OK</status>
   <route>
      <summary>I-40 W</summary>
      <leg>
         <step mode="DRIVING">
            <start_location>
               <lat>41.8507300</lat>
               <lng>-87.6512600</lng>
            </start_location>
            <end_location>
               <lat>41.8525800</lat>
               <lng>-87.6514100</lng>
            </end_location>
            <duration>
                <value>19</value>
                <text>minutes</text>
            </duration>
         </step>
      </leg>
   </route>
</Directions>

<AssignMessage async="false" continueOnError="false" enabled="true" name="GetURIPath">
  <DisplayName>GetXMLVar</DisplayName>
  <Add>
    <Headers>
      <Header name="tmode">{directionsresponse.travelmode}</Header>
    </Headers>
  </Add>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

ExtractVariables নীতি সম্পর্কে

API ডেভেলপাররা এমন API প্রক্সি তৈরি করে যা বার্তার বিষয়বস্তুর উপর ভিত্তি করে ভিন্নভাবে আচরণ করে, যার মধ্যে হেডার, URI পাথ, পেলোড এবং কোয়েরি প্যারামিটার অন্তর্ভুক্ত। প্রায়শই, প্রক্সি এই বিষয়বস্তুর কিছু অংশ একটি শর্ত বিবৃতিতে ব্যবহারের জন্য বের করে। এটি করার জন্য ExtractVariables নীতি ব্যবহার করুন।

ExtractVariables নীতি সংজ্ঞায়িত করার সময়, আপনি বেছে নিতে পারেন:

• সেট করা ভেরিয়েবলের নাম
• ভেরিয়েবলের উৎস
• কতগুলি ভেরিয়েবল বের করে সেট করতে হবে

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

কন্টেন্ট-চালিত অ্যানালিটিক্স রিপোর্ট তৈরিতে ExtractVariables কীভাবে ব্যবহার করা যেতে পারে তা জানতে, কাস্টম অ্যানালিটিক্স ব্যবহার করে API বার্তার বিষয়বস্তু বিশ্লেষণ করুন দেখুন।

ব্যাপ্তি

ExtractVariables নীতির সাথে সেট করা ভেরিয়েবলগুলির বিশ্বব্যাপী সুযোগ রয়েছে। অর্থাৎ, ExtractVariables নীতি একটি নতুন ভেরিয়েবল সংজ্ঞায়িত করার পরে, আপনি প্রবাহের যেকোনো পর্যায়ে (যা ExtractVariables নীতির পরে কার্যকর হয়) যেকোনো নীতি বা কোড থেকে সেই ভেরিয়েবলটি অ্যাক্সেস করতে পারবেন। এর মধ্যে রয়েছে:

• প্রিফ্লো: প্রক্সিএন্ডপয়েন্ট এবং টার্গেটএন্ডপয়েন্ট (অনুরোধ এবং প্রতিক্রিয়া)
• পোস্টফ্লো: প্রক্সিএন্ডপয়েন্ট এবং টার্গেটএন্ডপয়েন্ট (অনুরোধ এবং প্রতিক্রিয়া)
• পোস্টক্লায়েন্টফ্লো: প্রক্সিএন্ডপয়েন্ট (শুধুমাত্র প্রতিক্রিয়া, বার্তা লগিং নীতি ব্যবহার করে)
• ত্রুটি প্রবাহ

মিল এবং পরিবর্তনশীল সৃষ্টি সম্পর্কে

ExtractVariables নীতি একটি অনুরোধ বা প্রতিক্রিয়া থেকে তথ্য বের করে এবং সেই তথ্য একটি ভেরিয়েবলে লেখে। আপনি যে ধরণের তথ্য বের করতে পারেন, যেমন URI পাথ বা XML ডেটা, তার জন্য আপনাকে মিল করার জন্য প্যাটার্ন এবং এক্সট্র্যাক্ট করা তথ্য ধরে রাখার জন্য ব্যবহৃত ভেরিয়েবলের নাম নির্দিষ্ট করতে হবে।

তবে, প্যাটার্ন ম্যাচিং কীভাবে কাজ করে তা নিষ্কাশনের উৎসের উপর নির্ভর করে। নিম্নলিখিত বিভাগগুলিতে দুটি মৌলিক তথ্যের বিভাগ বর্ণনা করা হয়েছে যা আপনি নিষ্কাশন করতে পারেন।

URI পাথ, কোয়েরি প্যারামিটার, হেডার, ফর্ম প্যারামিটার এবং ভেরিয়েবলের সাথে মিল করা

URI পাথ, কোয়েরি প্যারামিটার, হেডার, ফর্ম প্যারামিটার এবং ভেরিয়েবল থেকে তথ্য বের করার সময়, আপনি এক বা একাধিক প্যাটার্ন মেলানোর জন্য <Pattern> ট্যাগ ব্যবহার করেন। উদাহরণস্বরূপ, নিম্নলিখিত নীতির উদাহরণে URI পাথের জন্য একটি একক ম্যাচিং প্যাটার্ন দেখানো হয়েছে:

<ExtractVariables name="ExtractVariables-1">
   <Source>request</Source>
   <URIPath>
      <Pattern ignoreCase="true">/a/{pathSeg}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

এই উদাহরণে, urirequest.pathSeg ভেরিয়েবলটি "/a/" এর পরে proxy.pathsuffix-এ যা প্রদর্শিত হবে তাতে সেট করা আছে। উদাহরণস্বরূপ, ধরুন আপনার API প্রক্সির বেস পাথ হল /basepath/v1 । http://myCo.com/basepath/v1/a/b- এ একটি ইনবাউন্ড অনুরোধের মাধ্যমে ভেরিয়েবলটি "b" তে সেট করা আছে।

একাধিক প্যাটার্ন নির্দিষ্ট করা

আপনি <Pattern> ট্যাগের সাথে মিল রেখে একাধিক প্যাটার্ন নির্দিষ্ট করতে পারেন, যেখানে:

• সমস্ত প্যাটার্ন মিলের জন্য পরীক্ষা করা হয়।
• যদি কোনও প্যাটার্নই মেলে না, তাহলে নীতিটি কিছুই করে না এবং চলক(গুলি) তৈরি হয় না।
• যদি একাধিক প্যাটার্ন মিলে যায়, তাহলে দীর্ঘতম পাথ সেগমেন্ট সহ প্যাটার্নটি নিষ্কাশনের জন্য ব্যবহার করা হয়।
• যদি দুটি মিলে যাওয়া প্যাটার্নের দীর্ঘতম পাথ সেগমেন্ট একই থাকে, তাহলে নীতিতে প্রথমে উল্লেখিত প্যাটার্নটি নিষ্কাশনের জন্য ব্যবহার করা হবে।

পরবর্তী উদাহরণে, আপনি একটি নীতি তৈরি করবেন যাতে URI পাথের জন্য তিনটি মিলে যাওয়া প্যাটার্ন থাকবে:

<ExtractVariables name="ExtractVariables-1">
   <Source>request</Source>
   <URIPath>
      <Pattern ignoreCase="true">/a/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/b/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/b/c/{pathSeg}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

ধরুন, /basepath/v1 এর বেসপাথ সহ একটি API প্রক্সির জন্য, API প্রক্সিতে ইনবাউন্ড অনুরোধ URL এই ফর্মের:

http://myCo.com/basepath/v1/a/b

এই উদাহরণে, প্রথম প্যাটার্নটি URI এর সাথে মিলে যায় এবং urirequest.pathSeg ভেরিয়েবলটি "b" তে সেট করা আছে।

যদি অনুরোধের URLটি হয়:

http://myCo.com/basepath/v1/a/b/c/d

...তারপর তৃতীয় প্যাটার্নটি মিলে যায় এবং urirequest.pathSeg ভেরিয়েবলটি "d" তে সেট করা হয়।

একাধিক ভেরিয়েবল সহ প্যাটার্ন নির্দিষ্ট করা

আপনি ম্যাচিং প্যাটার্নে একাধিক ভেরিয়েবল নির্দিষ্ট করতে পারেন। উদাহরণস্বরূপ, আপনি দুটি ভেরিয়েবল সহ একটি ম্যাচিং প্যাটার্ন নির্দিষ্ট করেন:

<ExtractVariables name="ExtractVariables-1">
   <Source>request</Source>
   <URIPath>
      <Pattern ignoreCase="true">/a/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/b/{pathSeg}</Pattern>
      <Pattern ignoreCase="true">/a/{pathSeg1}/c/{pathSeg2}</Pattern>
   </URIPath>
   <VariablePrefix>urirequest</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

আবার ধরুন /basepath/v1 এর বেস পাথ সহ একটি API প্রক্সি, ইনবাউন্ড রিকোয়েস্ট URL এর জন্য:

http://myCo.com/basepath/v1/a/b/c/d

... urirequest.pathSeg1 ভেরিয়েবলটি "b" তে সেট করা হয়েছে এবং urirequest.pathSeg2 ভেরিয়েবলটি "d" তে সেট করা হয়েছে।

প্যাটার্নে একাধিক উদাহরণ মেলানো

একই নামের একাধিক আইটেম থাকলে আপনি প্যাটার্ন মেলাতে পারেন। উদাহরণস্বরূপ, আপনি এমন একটি অনুরোধ করতে পারেন যাতে একাধিক কোয়েরি প্যারামিটার বা একই নামের একাধিক হেডার থাকে। নিম্নলিখিত অনুরোধে "w" নামে দুটি কোয়েরি প্যারামিটার রয়েছে:

http://myCo.com/basepath/v1/a/b/c/d?w=1&w=2

ExtractVariables নীতিতে এই ক্যোয়ারী প্যারামিটারগুলি উল্লেখ করার জন্য, আপনি indexes ব্যবহার করেন, যেখানে ক্যোয়ারী প্যারামিটারের প্রথম উদাহরণে কোনও সূচী থাকে না, দ্বিতীয়টি সূচী 2 এ থাকে, তৃতীয়টি সূচী 3 এ থাকে, ইত্যাদি। উদাহরণস্বরূপ, নিম্নলিখিত নীতিটি অনুরোধে "w" নামক দ্বিতীয় ক্যোয়ারী প্যারামিটারের মান বের করে:

<ExtractVariables name="ExtractVariables-1">
   <Source>request</Source>
   <QueryParam name="w.2">
      <Pattern ignoreCase="true">{secondW}</Pattern>
   </QueryParam>
   <VariablePrefix>urirequest</VariablePrefix>
   <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</ExtractVariables>

urirequest.secondW ভেরিয়েবলটি "2" তে সেট করা আছে। যদি অনুরোধ থেকে দ্বিতীয় কোয়েরি প্যারামিটারটি বাদ দেওয়া হয়, তাহলে urirequest.secondW ভেরিয়েবলটি খালি থাকে। অনুরোধে একই নামের একাধিক আইটেম থাকলে যেকোনো সময় ইন্ডেক্সিং ব্যবহার করুন।

প্যাটার্নে বিশেষ অক্ষর ব্যবহার করা

URI পাথ মেলানোর সময়, আপনি প্যাটার্নে "*" এবং "**" ওয়াইল্ডকার্ড অক্ষর ব্যবহার করতে পারেন, যেখানে:

• "*" পথের যেকোনো একটি অংশের সাথে মেলে
• "**" পথের একাধিক অংশের সাথে মেলে

উদাহরণস্বরূপ, আপনি নীচের চিত্রের মতো <URIPath> উপাদানে প্যাটার্ন নির্দিষ্ট করুন:

<URIPath>
  <Pattern ignoreCase="true">/a/*/{id}</Pattern>
  <Pattern ignoreCase="true">/a/**/{id}</Pattern>
</URIPath>

প্রথম প্যাটার্নটি pathsuffix (বেসপাথ অনুসরণকারী URI পাথের অংশ) যেমন "/a/b/c", "/a/foo/bar" ইত্যাদির সাথে অনুরোধগুলির সাথে মেলে। দ্বিতীয় প্যাটার্নটি "/a/" এর পরে যেকোনো সংখ্যক পাথ সেগমেন্টের সাথে মেলে, যেমন "/a/foo/bar/baz/c", সেইসাথে "/a/b/c" এবং "/a/foo/bar"।

প্যারামিটার, হেডার এবং ফর্ম প্যারামিটারের জন্য প্যাটার্ন নির্দিষ্ট করার সময়, "*" অক্ষরটি যেকোনো সংখ্যক অক্ষরের সাথে মিল করার জন্য নির্দিষ্ট করে। উদাহরণস্বরূপ, একটি হেডার মেলানোর সময়, প্যাটার্নটি এইভাবে নির্দিষ্ট করুন:

*; অক্ষর সেট={এনকোডিং}

এই প্যাটার্নটি "text/xml;charset=UTF-16" এবং "application/xml;charset=ASCII" মানের সাথে মেলে।

যদি ExtractVariables নীতিতে পাস করা মানটিতে "{" এর মতো একটি বিশেষ অক্ষর থাকে, তাহলে এটি এড়াতে "%" অক্ষরটি ব্যবহার করুন। নিম্নলিখিত উদাহরণটি প্যাটার্নের "{" এবং "}" অক্ষরগুলিকে এড়িয়ে যায় কারণ এগুলি কোয়েরি প্যারামিটারের মানের আক্ষরিক অক্ষর হিসাবে ব্যবহৃত হয়:

<QueryParam>
  <Pattern ignoreCase="true">%{user%} {name}</Pattern>
</QueryParam>

এই উদাহরণে, প্যাটার্নটি "{user} Steve" মানের সাথে মেলে কিন্তু "user Steve" মানের সাথে মেলে না।

JSON এবং XML এর সাথে মিল করা হচ্ছে

JSON এবং XML থেকে ডেটা বের করার সময়, আপনি নীতিতে এক বা একাধিক <Variable> ট্যাগ নির্দিষ্ট করেন। <Variable> ট্যাগটি গন্তব্য ভেরিয়েবলের নাম নির্দিষ্ট করে যেখানে এক্সট্র্যাক্ট করা তথ্য সংরক্ষণ করা হয়, এবং JsonPath (JSON) বা XPATH (XML) এক্সট্র্যাক্ট করা তথ্যের জন্য।

নীতিমালার সমস্ত <Variable> ট্যাগ মূল্যায়ন করা হয়, যাতে আপনি একটি একক নীতি থেকে একাধিক ভেরিয়েবল পূরণ করতে পারেন। যদি <Variable> ট্যাগটি JSON বা XML-এর একটি বৈধ ক্ষেত্রে মূল্যায়ন না করে, তাহলে সংশ্লিষ্ট ভেরিয়েবল তৈরি করা হয় না।

নিম্নলিখিত উদাহরণে একটি ExtractVariables নীতি দেখানো হয়েছে যা একটি প্রতিক্রিয়ার JSON বডি থেকে দুটি ভেরিয়েবল পূরণ করে:

<ExtractVariables name="ExtractVariables-3">
   <Source>response</Source>
   <JSONPayload>
      <Variable name="latitude" type="float">
         <JSONPath>$.results[0].geometry.location.lat</JSONPath>
      </Variable>
      <Variable name="longitude" type="float">
         <JSONPath>$.results[0].geometry.location.lng</JSONPath>
      </Variable>
   </JSONPayload>
   <VariablePrefix>geocoderesponse</VariablePrefix>
</ExtractVariables>

একই ভেরিয়েবলে একাধিক স্থানে লেখা

সেট করার জন্য ভেরিয়েবলের নাম নির্বাচন করার সময় সাবধানতা অবলম্বন করুন। নীতিটি প্রথম এক্সট্রাকশন প্যাটার্ন থেকে শেষ পর্যন্ত ক্রমানুসারে কার্যকর হয়। যদি নীতিটি একাধিক স্থান থেকে একই ভেরিয়েবলে একটি মান লেখে, তাহলে নীতিতে শেষ লেখাটি ভেরিয়েবলের মান নির্ধারণ করে। (আপনি যা চান তা এটি হতে পারে।)

উদাহরণস্বরূপ, আপনি একটি টোকেন মান বের করতে চান যা একটি কোয়েরি প্যারামিটারে অথবা একটি হেডারে পাস করা যেতে পারে, যেমনটি নীচে দেখানো হয়েছে:

<!-- If token only in query param, the query param determines the value.
     If token is found in both the query param and header, header sets value. -->
<QueryParam name="token">
  <Pattern ignoreCase="true">{tokenValue}</Pattern>
</QueryParam>

<!-- Overwrite tokenValue even if it was found in query parameter. -->
<Header name="Token">
  <Pattern ignoreCase="true">{tokenValue}</Pattern>
</Header>

যখন কোনও মিল না হয় তখন কী ঘটে তা নিয়ন্ত্রণ করা

যদি প্যাটার্নটি মিল না করে, তাহলে সংশ্লিষ্ট ভেরিয়েবলটি তৈরি করা হয় না। অতএব, যদি অন্য কোনও নীতি ভেরিয়েবলটিকে উল্লেখ করে, তাহলে এটি একটি ত্রুটির কারণ হতে পারে।

একটি বিকল্প হল <IgnoreUnresolvedVariables> কে true তে সেট করা, যে নীতিটি ভেরিয়েবলটিকে উল্লেখ করে, যাতে নীতিটি যেকোনো অমীমাংসিত ভেরিয়েবলকে খালি স্ট্রিং (নাল) হিসেবে বিবেচনা করে:

<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>

উপাদানের রেফারেন্স

উপাদানের রেফারেন্সটি ExtractVariables নীতির উপাদান এবং বৈশিষ্ট্যগুলি বর্ণনা করে।

<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
   <DisplayName>Extract Variables 1</DisplayName>
   <Source clearPayload="true|false">request</Source>
   <VariablePrefix>myprefix</VariablePrefix>
   <IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>
   <URIPath>
      <Pattern ignoreCase="false">/accounts/{id}</Pattern>
   </URIPath>
   <QueryParam name="code">
      <Pattern ignoreCase="true">DBN{dbncode}</Pattern>
   </QueryParam>
   <Header name="Authorization">
      <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern>
   </Header>
   <FormParam name="greeting">
      <Pattern>hello {user}</Pattern>
   </FormParam>
   <Variable name="request.content">
       <Pattern>hello {user}</Pattern>
   </Variable>
   <JSONPayload>
      <Variable name="name">
         <JSONPath>{example}</JSONPath>
      </Variable>
   </JSONPayload>
   <XMLPayload stopPayloadProcessing="false">
      <Namespaces/>
      <Variable name="name" type="boolean">
         <XPath>/test/example</XPath>
      </Variable>
   </XMLPayload>
</ExtractVariables>

<এক্সট্র্যাক্টভেরিয়েবল> বৈশিষ্ট্য

<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">

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

<DisplayName> উপাদান

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

<DisplayName>Policy Display Name</DisplayName>

<সূত্র> উপাদান

(ঐচ্ছিক) পার্স করার জন্য ভেরিয়েবল নির্দিষ্ট করে। <Source> এর মান ডিফল্টভাবে message এ থাকে। message মান প্রসঙ্গ-সংবেদনশীল। একটি অনুরোধ প্রবাহে, message অনুরোধ বার্তার সমাধান করে। একটি প্রতিক্রিয়া প্রবাহে, message প্রতিক্রিয়া বার্তার সমাধান করে।

যদিও আপনি প্রায়শই এই নীতিটি একটি অনুরোধ বা প্রতিক্রিয়া বার্তা থেকে তথ্য বের করার জন্য ব্যবহার করেন, আপনি এটি যেকোনো ভেরিয়েবল থেকে তথ্য বের করতে ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি এটি AccessEntity নীতি দ্বারা তৈরি একটি সত্তা থেকে তথ্য বের করতে, পরিষেবা কলআউট নীতি দ্বারা ফেরত পাঠানো ডেটা থেকে, অথবা একটি XML বা JSON অবজেক্ট থেকে তথ্য বের করতে ব্যবহার করতে পারেন।

যদি <Source> সমাধান করা না যায়, অথবা একটি অ-বার্তা ধরণের সমাধান করে, তাহলে নীতিটি সাড়া দিতে ব্যর্থ হবে।

<Source clearPayload="true|false">request</Source>

গুণাবলী

<VariablePrefix> উপাদান

(ঐচ্ছিক) সম্পূর্ণ ভেরিয়েবলের নামটি <VariablePrefix> , একটি বিন্দু এবং <Pattern> উপাদান বা <Variable> উপাদানের {কোঁকড়া বন্ধনী}-এ আপনার সংজ্ঞায়িত নামটি যোগ করে তৈরি করা হয়। উদাহরণস্বরূপ: myprefix.id , myprefix.dbncode , অথবা myprefix.oauthtoken.

<VariablePrefix>myprefix</VariablePrefix>

উদাহরণস্বরূপ, ধরুন নামের মান "user"।

• যদি <VariablePrefix> নির্দিষ্ট না করা থাকে, তাহলে এক্সট্র্যাক্ট করা মানগুলি user নামক একটি ভেরিয়েবলের জন্য নির্ধারিত হয়।
• যদি <VariablePrefix> কে myprefix হিসেবে নির্দিষ্ট করা হয়, তাহলে এক্সট্র্যাক্ট করা মানগুলি myprefix.user নামক একটি ভেরিয়েবলের জন্য নির্ধারিত হয়।

<IgnoreUnresolvedVariables> উপাদান

(ঐচ্ছিক) যেকোনো অমীমাংসিত চলককে খালি স্ট্রিং (নাল) হিসেবে গণ্য করার জন্য true হিসেবে সেট করুন। কোনো রেফারেন্সকৃত চলক অমীমাংসিত থাকলে নীতিটি যদি একটি ত্রুটি বর্ষণ করতে চায়, তাহলে false হিসেবে সেট করুন।

<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>

যদি একটি XPath রেফারেন্স একটি <XMLPayload> তে অমীমাংসিত থাকে, তাহলে নীতিটি নিম্নলিখিত ত্রুটিটি ছুঁড়ে দেয়:

{
   "fault":{
      "faultstring":"Unresolved xpath path in policy policy_name.",
      "detail":{
         "errorcode":"steps.extractvariables.InvalidXPath"
      }
   }
}

<URIPath> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) একটি অনুরোধ উৎস বার্তার proxy.pathsuffix থেকে একটি মান বের করে। প্যাটার্নে প্রয়োগ করা পাথ হল proxy.pathsuffix, যা API Proxy-এর জন্য বেসপাথ অন্তর্ভুক্ত করে না। যদি উৎস বার্তাটি একটি বার্তা ধরণের প্রতিক্রিয়াতে সমাধান করে, তাহলে এই উপাদানটি কিছুই করে না।

<URIPath>
   <Pattern ignoreCase="false">/accounts/{id}</Pattern>
</URIPath>

একাধিক <Pattern> উপাদান ব্যবহার করা সম্ভব:

<URIPath>
   <Pattern ignoreCase="false">/accounts/{id}</Pattern>
   <Pattern ignoreCase="false">/accounts/{id}/transactions/{index}</Pattern>
</URIPath>

গুণাবলী

<ক্যোয়ারীপ্যারাম> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) একটি অনুরোধ উৎস বার্তার নির্দিষ্ট ক্যোয়ারী প্যারামিটার থেকে একটি মান বের করে। যদি উৎস বার্তাটি একটি বার্তা ধরণের প্রতিক্রিয়াতে সমাধান করে, তাহলে এই উপাদানটি কিছুই করে না।

<QueryParam name="code">
   <Pattern ignoreCase="true">DBN{dbncode}</Pattern>
</QueryParam>

যদি একাধিক কোয়েরি প্যারামিটারের নাম একই থাকে, তাহলে প্যারামিটারগুলি উল্লেখ করতে সূচী ব্যবহার করুন:

<QueryParam name="w.2">
   <Pattern ignoreCase="true">{secondW}</Pattern>
</QueryParam>

গুণাবলী

<শিরোনাম> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) নির্দিষ্ট অনুরোধ বা প্রতিক্রিয়া বার্তার নির্দিষ্ট HTTP হেডার থেকে একটি মান বের করে। যদি একাধিক হেডারের একই নাম থাকে, তাহলে তাদের মানগুলি একটি অ্যারেতে সংরক্ষণ করা হয়।

<!-- The name is the actual header name. -->
<Header name="Authorization">
<!-- Provide a name for your new custom variable here. -->
   <Pattern ignoreCase="false">Bearer {oauthtoken}</Pattern>
</Header>

যদি একাধিক হেডারের নাম একই থাকে, তাহলে অ্যারেতে পৃথক হেডার উল্লেখ করতে সূচী ব্যবহার করুন:

<Header name="myHeader.2">
   <Pattern ignoreCase="true">{secondHeader}</Pattern>
</Header>

অথবা অ্যারের সমস্ত হেডার তালিকাভুক্ত করার জন্য নিম্নলিখিতগুলি ব্যবহার করুন:

<Header name="myHeader.values">
   <Pattern ignoreCase="true">{myHeaders}</Pattern>
</Header>

গুণাবলী

<FormParam> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) নির্দিষ্ট অনুরোধ বা প্রতিক্রিয়া বার্তার নির্দিষ্ট ফর্ম প্যারামিটার থেকে একটি মান বের করে। ফর্ম প্যারামিটারগুলি কেবল তখনই বের করা যেতে পারে যখন নির্দিষ্ট বার্তার Content-Type হেডার application/x-www-form-urlencoded হয়।

<FormParam name="greeting">
    <Pattern>hello {user}</Pattern>
</FormParam>

গুণাবলী

<ভেরিয়েবল> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) একটি ভ্যারিয়েবলের নাম নির্দিষ্ট করে যেখান থেকে একটি মান বের করা হবে।

<Variable name="myVar">
    <Pattern>hello {user}</Pattern>
</Variable>

চলক থেকে দুটি মান বের করতে:

<Variable name="myVar">
   <Pattern>hello {firstName} {lastName}</Pattern>
</Variable>

গুণাবলী

<JSONPayload> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) JSON-ফর্ম্যাট করা বার্তাটি নির্দিষ্ট করে যেখান থেকে ভেরিয়েবলের মান বের করা হবে। JSON নিষ্কাশন কেবল তখনই করা হয় যখন বার্তার Content-Type হেডারটি application/json হয়।

<JSONPayload>
   <Variable name="name" type="string">
      <JSONPath>{example}</JSONPath>
   </Variable>
</JSONPayload>

<JSONPayload>/<পরিবর্তনশীল> উপাদান

(JSONPayload উপাদানের মধ্যে প্রয়োজনীয়।) এক্সট্র্যাক্ট করা মানটি যেখানে বরাদ্দ করা হয়েছে সেই ভেরিয়েবলটি নির্দিষ্ট করে। একাধিক ভেরিয়েবল পূরণ করতে আপনি JSONPayload> উপাদানে একাধিক <Variable> ট্যাগ অন্তর্ভুক্ত করতে পারেন।

<Variable name="name" type="string">
   <JSONPath>{example}</JSONPath>
</Variable>

গুণাবলী

<JSONPayload>/<Variable>/<JSONPath> উপাদান

(JSONPayload:Variable উপাদানের মধ্যে প্রয়োজনীয়।) JSON-ফরম্যাট করা বার্তা থেকে একটি মান বের করতে ব্যবহৃত JSON পাথ নির্দিষ্ট করে।

<Variable name="name">
   <JSONPath>$.rss.channel.title</JSONPath>
</Variable>

<XMLPayload> উপাদান

(ঐচ্ছিক, তবে আরও তথ্যের জন্য নীচের টেবিলে উপস্থিতি সারিটি দেখুন।) XML-ফরম্যাট করা বার্তাটি নির্দিষ্ট করে যেখান থেকে ভেরিয়েবলের মান বের করা হবে। XML পেলোডগুলি তখনই বের করা হয় যখন বার্তার Content-Type হেডার text/xml , application/xml , অথবা application/*+xml হয়।

<XMLPayload stopPayloadProcessing="false">
  <Namespaces>
     <Namespace prefix="apigee">http://www.apigee.com</Namespace>
     <Namespace prefix="gmail">http://mail.google.com</Namespace>
  </Namespaces>
  <Variable name="name" type="boolean">
     <XPath>/apigee:test/apigee:example</XPath>
  </Variable>
</XMLPayload>

গুণাবলী

<XMLPayload>/<Namespaces> এলিমেন্ট

(ঐচ্ছিক) XPath মূল্যায়নে ব্যবহৃত নেমস্পেস নির্দিষ্ট করে। যদি আপনি আপনার XPath এক্সপ্রেশনে নেমস্পেস ব্যবহার করেন, তাহলে আপনাকে এখানে নেমস্পেসগুলি ঘোষণা করতে হবে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

<XMLPayload stopPayloadProcessing="false">
  <Namespaces>
     <Namespace prefix="apigee">http://www.apigee.com</Namespace>
     <Namespace prefix="gmail">http://mail.google.com</Namespace>
  </Namespaces>
  <Variable name="legName" type="string">
    <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>
  </Variable>
</XMLPayload>

যদি আপনি আপনার XPath এক্সপ্রেশনে namespace ব্যবহার না করেন, তাহলে আপনি <Namespaces> উপাদানটি বাদ দিতে পারেন অথবা মন্তব্য করতে পারেন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

<XMLPayload stopPayloadProcessing="false">
  <!-- <Namespaces/> -->
  <Variable name="legName" type="string">
    <XPath>/Directions/route/leg/name</XPath>
  </Variable>
</XMLPayload>

গুণাবলী

<XMLPayload>/<পরিবর্তনশীল> উপাদান

(ঐচ্ছিক) এমন একটি চলক নির্দিষ্ট করে যেখানে নিষ্কাশিত মান নির্ধারিত হবে।

<Variable name="name" type="boolean">
   <XPath>/test/example</XPath>
</Variable>

গুণাবলী

<XMLPayload>/<Variable>/<XPath> এলিমেন্ট

(XMLPayload:Variable উপাদানের মধ্যে প্রয়োজনীয়।) ভেরিয়েবলের জন্য নির্ধারিত XPath নির্দিষ্ট করে। শুধুমাত্র XPath 1.0 এক্সপ্রেশন সমর্থিত।

<Variable name="name" type="boolean">
   <XPath>/test/example</XPath>
</Variable>

একটি নেমস্পেস সহ উদাহরণ। যদি আপনি আপনার XPath এক্সপ্রেশনে নেমস্পেস ব্যবহার করেন, তাহলে আপনাকে নীতির <XMLPayload><Namespaces> বিভাগে নেমস্পেসগুলি ঘোষণা করতে হবে।

<Variable name="name" type="boolean">
   <XPath>/foo:test/foo:example</XPath>
</Variable>

ত্রুটির উল্লেখ

এই বিভাগটি ফল্ট কোড এবং ত্রুটি বার্তাগুলি বর্ণনা করে যেগুলি ফেরত দেওয়া হয় এবং ত্রুটি ভেরিয়েবলগুলি যেগুলি এজ দ্বারা সেট করা হয় যখন এই নীতিটি একটি ত্রুটি ট্রিগার করে৷ এই তথ্যটি জানা গুরুত্বপূর্ণ যে আপনি ত্রুটিগুলি পরিচালনা করার জন্য ত্রুটির নিয়ম তৈরি করছেন কিনা। আরও জানতে, নীতিগত ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার যা জানা দরকার তা দেখুন৷

রানটাইম ত্রুটি

নীতি কার্যকর করার সময় এই ত্রুটিগুলি ঘটতে পারে৷

স্থাপনার ত্রুটি

আপনি যখন এই নীতি সম্বলিত একটি প্রক্সি স্থাপন করেন তখন এই ত্রুটিগুলি ঘটতে পারে৷

ফল্ট ভেরিয়েবল

যখন এই নীতি রানটাইমে একটি ত্রুটি ট্রিগার করে তখন এই ভেরিয়েবলগুলি সেট করা হয়৷ আরও তথ্যের জন্য, নীতি ত্রুটি সম্পর্কে আপনার যা জানা দরকার তা দেখুন।

উদাহরণ ত্রুটি প্রতিক্রিয়া

{
   "fault":{
      "detail":{
         "errorcode":"steps.extractvariables.SourceMessageNotAvailable"
      },
      "faultstring":"request message is not available for ExtractVariable: EV-ParseJsonResponse"
   }
}

উদাহরণ দোষ নিয়ম

<FaultRule name="Extract Variable Faults">
    <Step>
        <Name>AM-CustomErrorMessage</Name>
        <Condition>(fault.name = "SourceMessageNotAvailable") </Condition>
    </Step>
    <Condition>(extractvariables.EM-ParseJsonResponse.failed = true) </Condition>
</FaultRule>

স্কিমা

সম্পর্কিত বিষয়

কাস্টম অ্যানালিটিক্স ব্যবহার করে API বার্তার বিষয়বস্তু বিশ্লেষণ করুন

ভেরিয়েবলের রেফারেন্স