המדיניות בנושא ExtractVariables

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

מה

המדיניות tractVariables מחלצת תוכן מבקשה או מתגובה ומגדירה את הערך של משתנה לתוכן הזה. אפשר לחלץ כל חלק מההודעה, כולל כותרות, נתיבי 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=&quo>t;t<rue" n>ame="<;GetURIPath&>quo<t;<>/span>
  Dis<playNam>eGetXML<Var/DisplayName
  A>dd
    Headers
      Header nam<e=">;tmod<e"{>dir<ecti>ons<response.travelmode}/Head>er
 <   /Headers
  /Add
  Ignor>eUn<resolvedVariablestrue/IgnoreUnresolvedVariables
  AssignTo >c<reateNew=">;false" transport="http" type="request"/
/AssignMessage

מידע על המדיניות tractVariables

מפתחי API בונים שרתי proxy ל-API שמתנהגים באופן שונה בהתאם לתוכן ההודעות, כולל כותרות, נתיבי URI, מטענים ייעודיים ופרמטרים של שאילתות. לעיתים קרובות, שרת ה-proxy מחלץ חלק חלק מהתוכן הזה לשימוש בהצהרת תנאי. כדי לבצע את הפעולה הזו, צריך להשתמש במדיניות ExtensionVariables הזה.

כשמגדירים את המדיניות TransVariables, אפשר לבחור:

• שמות המשתנים להגדרה
• מקור המשתנים
• כמה משתנים צריך לחלץ ולהגדיר

כשמתבצעת הרצה, המדיניות מחילה תבנית טקסט על התוכן, ואחרי שמוצאים התאמה, היא מגדירה בערך של המשתנה הייעודי עם התוכן. לאחר מכן, ניתן לקבל גישה לקודים ולכללי מדיניות אחרים את המשתנים האלה כדי לאפשר התנהגות דינמית או כדי לשלוח נתונים עסקיים אל Edge API Analytics.

כדי לראות כיצד ניתן להשתמש במשתני חילוץ כדי ליצור דוחות Analytics מבוססי-תוכן, ניתוח תוכן של הודעות API באמצעות ניתוח נתונים בהתאמה אישית.

היקף

למשתנים שמוגדרים במדיניות חילוץ משתנים יש היקף גלובלי. כלומר, אחרי המדיניות extractVariables מגדירה משתנה חדש. ניתן לגשת למשתנה הזה מכל מדיניות או בכל שלב בתהליך (שמופעל אחרי המדיניות tractVariables). הזה כוללת:

• PreFlow: ProxyEndpoint ו-TargetEndpoint (בקשה ותגובה)
• PostFlow: ProxyEndpoint ו-TargetEndpoint (בקשה ותגובה)
• PostClientFlow: ProxyEndpoint (תגובה בלבד, באמצעות התחילית של מדיניות בנושא רישום הודעות)
• תהליכים של שגיאות

מידע על התאמה ויצירת משתנים

המדיניות tractVariables שולפת מידע מבקשה או מתגובה וכותבת למשתנה. לגבי כל סוג מידע שאפשר לחלץ, כמו נתיב ה-URI או נתוני XML, מציינים את הדפוס שצריך להתאים ואת שם המשתנה שמשמש לשמירת התחילית שחולץ.

עם זאת, אופן הפעולה של התאמת תבניות תלוי במקור של החילוץ. הבאים מתארים את שתי הקטגוריות הבסיסיות של המידע שאפשר לחלץ.

נתיבי URI תואמים, פרמטרים של שאילתות, כותרות, פרמטרים של טפסים ומשתנים

כשמחלצים מידע מנתיב URI, פרמטרים של שאילתה, כותרות, פרמטרים של טפסים שבהם משתמשים בתג <Pattern> כדי לציין אחד או יותר ולהתאים אותם אישית. לדוגמה, הדוגמה הבאה למדיניות מציגה דפוס תואם אחד של נתיב ה-URI:

<ExtractVariables name="ExtractVariabl>es-1<">
   Sou<rcerequ>est/<Source
>   URIP<ath
      Pattern ignoreC>ase="tr<ue">/a/{<pathSeg}>/Pat<tern
   /URIPa>th
   Vari<ablePrefixurire>ques<t/VariablePrefix
   Ignor>eUnr<esolvedVariablestrue/Ignor>e<UnresolvedVariabl>es
/ExtractVariables

בדוגמה הזו, המשתנה urirequest.pathSeg מוגדר למה שמופיע ב-Proxy.pathsuffix אחרי '/a/'. לדוגמה, נניח שהנתיב הבסיסי של שרת ה-proxy ל-API הוא /basepath/v1 . עם בקשה נכנסת אל http://myCo.com/basepath/v1/a/b מוגדר ל-"b".

ציון תבניות מרובות

ניתן לציין מספר תבניות להתאמה, בהתאם לתגי <Pattern>, כאשר:

• מתבצעת בדיקה של התאמה לכל הדפוסים.
• אם אף אחת מהתבניות לא תואמת, המדיניות לא עושה דבר והמשתנים לא נוצר.
• אם יותר מדפוס אחד תואם, הדפוס עם מקטעי הנתיב הארוכים ביותר משמש עבור חילוץ.
• אם לשני דפוסים תואמים יש את אותם מקטעי הנתיב הארוכים ביותר, הדפוס שצוין ראשון המדיניות משמשת לחילוץ.

בדוגמה הבאה, יוצרים מדיניות שמכילה שלוש תבניות תואמות ל-URI path:

<ExtractVariables name="ExtractVariabl>es-1<">
   Sou<rcerequ>est/<Source
>   URIP<ath
      Pattern ignoreC>ase="tr<ue">/a/{pat<hSeg}/Pattern
      Patte>rn ignoreCase=<"tr>ue"<;/a/b/{pathSeg}/Pattern
 >     Pattern ign<oreCase=>&quo<t;true&q>uot;</a/b/c/{pathSe>g}/Pattern<
   /URIPath
  > Var<iablePrefixurirequest/Var>iabl<ePrefix
   IgnoreUnresolve>d<Variablestrue/Ign>oreUnresolvedVariables
/ExtractVariables

נניח שלשרת Proxy ל-API עם הנתיב Basepath של /basepath/v1, כתובת ה-URL של הבקשה הנכנסת. ל-proxy ל-API בצורה הבאה:

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="ExtractVariabl>es-1<">
   Sou<rcerequ>est/<Source
>   URIP<ath
      Pattern ignoreC>ase="tr<ue">/a/{pat<hSeg}/Pattern
      Patte>rn ignoreCase=<"tr>ue"<;/a/b/{pathSeg}/Pattern
 >     Pattern ignoreCase=&q<uot;true>&quo<t;/a/{pa>thSe<g1}/c/{pathSeg>2}/Pattern<
   /URIPath
  > Var<iablePrefixurirequest/Var>iabl<ePrefix
   IgnoreUnresolve>d<Variablestrue/Ign>oreUnresolvedVariables
/ExtractVariables

שוב שימוש בשרת proxy ל-API עם נתיב הבסיס של /basepath/v1 , לבקשה הנכנסת כתובת ה-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, משתמשים באינדקסים, כאשר המופע הראשון של פרמטר השאילתה לא מכיל אינדקס, המופע השני נמצא באינדקס 2 והשלישי ב- אינדקס 3 וכו'. לדוגמה, המדיניות הבאה מחלצת את הערך של פרמטר השאילתה השני בשם 'w' בבקשה:

<ExtractVariables name="ExtractVariabl>es-1<">
   Sou<rcerequ>est/<Source
   QueryParam >name=&q<uot;w.2"
      Patte>rn ignore<Case=&qu>ot;t<rue"{s>econ<dW}/Pattern
  > /QueryPar<am
   VariableP>refi<xurirequest/VariablePrefi>x
  < IgnoreUnresolvedVariables>t<rue/IgnoreUnresol>vedVariables
/ExtractVariables

המשתנה urirequest.secondW הוא מוגדר ל-'2'. אם פרמטר השאילתה השני יושמט מהבקשה, המשתנה urirequest.secondW ריק. אפשר להשתמש בהוספה לאינדקס בכל פעם שיש מספר פריטים עם אותו שם בבקשה.

שימוש בתווים מיוחדים בתבנית

כשמתאימים בין נתיבי URI, אפשר להשתמש בסימן '*' וגם '**' בתווים כלליים לחיפוש בתבנית, איפה:

• "*" תואם לחלק אחד של הנתיב
• '**' תואם לכמה קטעים בנתיב

לדוגמה, מציינים תבניות לרכיב <URIPath> כפי שמוצג למטה:

<URIPath>
  <Pattern ignoreCase=">true"<;/a/*/{i>d}/<Pattern
  Pattern ignoreC>ase="<true&quo>t<;/a/**/{>id}/Pattern
/URIPath

הדפוס הראשון תואם לבקשות עם נתיבים (החלק של נתיב ה-URI שאחרי ה-basepath), למשל " /a/b/c", "/a/foo/bar" וכו'. הדפוס השני תואם לכל מספר של נתיב פלחים אחרי "/a/", למשל "/a/foo/bar/baz/c", וגם "/a/b/c" ו-" /a/foo/bar".

כשמציינים דפוסים לפרמטרים של שאילתות, לכותרות ולפרמטרים של טפסים, התו '*' מציין התאמה לכל מספר של תווים. לדוגמה, כשמתאימים כותרת, צריך לציין את דפוס כ:

*;charset={encoding}

הדפוס הזה תואם לערכים 'text/xml;charset=UTF-16' וגם 'application/xml;charset=ASCII'.

אם הערך שמועבר למדיניות tractVariables מכיל תו מיוחד, כמו "{", השתמשו ב"%" כדי לסמן בתו בריחה (escape). הדוגמה הבאה תורמת לסימון בתו בריחה (escape) של "{" ו-"}" תווים בדפוס כי הם משמשים כתווים מילוליים בערך השאילתה :

<QueryParam>
  <Pattern ignoreCase=">true"%{use<r%} {nam>e<}/Pattern
/>QueryParam

בדוגמה הזו, הדפוס תואם לערך '{user} Steve' אבל לא את הערך user סטיב".

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="t>oke<n"
  Pattern ignoreC>ase="tr<ue">{<tokenValue}>/Pa<ttern
/QueryParam
 
!-- Overwrite tokenValue even if it was found in> <query parameter. -->
He<ader name="Token&quo>t;
  Pattern< ignoreC>a<se=&quo>t;true"{tokenValue}/Pattern
/Header

שליטה במה שקורה כשאין התאמה

אם הדפוס לא תואם, לא ייווצר משתנה מתאים. לכן, אם מדיניות אחרת מפנה למשתנה, והיא עלולה לגרום לשגיאה.

אפשרות אחת היא להגדיר את <IgnoreUnresolvedVariables> ל- במדיניות שמפנה את המשתנה כדי להגדיר את המדיניות לטיפול כל משתנה שלא ניתן לפתרון כמחרוזת ריקה (null):

<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>

הפניה לרכיב

בהפניה לרכיב מתוארים הרכיבים והמאפיינים של extractVariables המדיניות בנושא

<ExtractVariables async="false" continueOnError="false" enabled="true&qu>ot; <name=">Extract-Variables-1<"
   Di>spla<yNameExtract Variables 1/Display>Name
  < Source> cle<arPayload=&quo>t;true|f<alse"reque>st/S<ource
   VariablePrefixmy>prefix/Var<iablePrefix
   IgnoreUnres>olve<dVariab>lestrue<|false/IgnoreUnresolvedVar>iables
   URIP<ath
    >  Pa<ttern ig>nore<Case="false">/accoun<ts/{id}/Pattern
   /URIPa>th
   QueryP<aram nam>e=&q<uot;code&qu>ot;
<      Pattern ignoreCase=&q>uot;tru<e"DBN{dbncode}/Patter>n
   /QueryParam
  < Header >name<=">Auth<orization"
      Pat>tern ig<noreCas>e="fals<e"B>eare<r {oauthto>ken}</Pattern
   /Header
   FormPara>m name=&<quot;gr>eeting"<
      P>atte<rnhello {>user<}/Pattern
 >  /Form<Param
   Variable na>me="r<equest.c>ontent&qu<ot;
     >  Patte<rnhello {>user<}/Pattern
  > /Va<riable
   JSONPayload
      Variable nam>e="<;name">
      <   JSONPath{example}/JSONPath
     > /Variable<
   />JSONPayload
 <  XMLP>ayload <stopPaylo>adPr<ocessing=&q>u<ot;false"
  >    Namespaces/
      Variable name="name" type="boolean"
         XPath/test/example/XPath
      /Variable
   /XMLPayload
/ExtractVariables

<ExtractVariables> מאפיינים

<ExtractVariables async="false" continueOnError="false" enabled="true&qu>ot; name="Extract-Variables-1"

בטבלה הבאה מתוארים מאפיינים שמשותפים לכל רכיבי ההורה של המדיניות:

<DisplayName> רכיב

צריך להשתמש בנוסף למאפיין name כדי להוסיף תווית למדיניות עורך proxy של ממשק משתמש לניהול עם שם אחר בשפה טבעית.

<DisplayName>Policy Display Name</DisplayName>

<Source> רכיב

(אופציונלי) מציין את המשתנה שרוצים לנתח. הערך של ברירת המחדל של <Source> היא message. הערך message הוא תלוי הקשר. בתהליך הבקשה, message עונה על הודעת הבקשה. לחשבון רצף תגובה, message מוביל להודעת התשובה.

המדיניות הזו משמשת לעיתים קרובות כדי לחלץ מידע מבקשה או מהודעת תשובה, אבל יכולים להשתמש בו כדי לחלץ מידע מכל משתנה. לדוגמה, אפשר להשתמש בו כדי לחלץ מידע מישות שנוצרה במסגרת מדיניות AccessEntity, מנתונים הוחזרה על ידי השירות מדיניות יתרונות מרכזיים, או חילוץ מידע מאובייקט XML או JSON.

אם לא ניתן לפענח את <Source> או שהנושא שלו משתנה מסוג שאינו הודעה, אם המדיניות לא תוכל להגיב.

<Source clearPayload="true|f>alse&qu<ot;requ>est/Source

מאפיינים

<VariablePrefix> רכיב

(אופציונלי) כדי ליצור את השם המלא של המשתנה, צריך לאחד את <VariablePrefix>, נקודה והשם שמגדירים ב{curly braces} רכיב <Pattern> או רכיב <Variable>. מוצרים לדוגמה: myprefix.id, myprefix.dbncode או myprefix.oauthtoken.

<VariablePrefix>myprefix</VariablePrefix>

לדוגמה, נניח שהערך של השם הוא "user".

• אם לא צוין <VariablePrefix>, הערכים שיחולצו הם הוקצה למשתנה בשם user.
• אם צוין <VariablePrefix> כ-myprefix, הערך שחולץ מוקצים למשתנה בשם myprefix.user.

<IgnoreUnresolvedVariables> רכיב

(אופציונלי) מגדירים לפרמטר את הערך true כדי להתייחס לכל משתנה שלא ניתן לפתרון כמחרוזת ריקה (null). יש להגדיר את הערך 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, שלא כולל את basepath של ה-API ל-Proxy. אם המיקום הודעת המקור מובילה לסוג ההודעה תגובה, והרכיב הזה לא עושה דבר.

<URIPath>
   <Pattern ignoreCase="f>alse"/acc<ounts/{i>d<}/Patter>n
/URIPath

ניתן להשתמש במספר רכיבי <Pattern>:

<URIPath>
   <Pattern ignoreCase="f>alse"/acc<ounts/{i>d}/P<attern
   Pattern ignoreCa>se="false"/accounts/{id}/<transact>i<ons/{ind>ex}/Pattern
/URIPath

מאפיינים

<QueryParam> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) חילוץ ערך מפרמטר השאילתה שצוין של הודעת מקור מסוג בקשה. אם הודעת המקור מובילה לסוג ההודעה תגובה, ואז הרכיב הזה שום דבר.

<QueryParam name=">code<"
   Pattern ignoreC>ase="tr<ue">D<BN{dbncode}>/Pattern
/QueryParam

אם לכמה פרמטרים של שאילתה יש שם זהה, השתמשו באינדקסים כדי להפנות לפרמטרים:

<QueryParam name=">;w.2<"
   Pattern ignoreC>ase="<;true&qu>o<t;{secondW}>/Pattern
/QueryParam

מאפיינים

<Header> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) חילוץ ערך מכותרת ה-HTTP שצוינה של הודעת ה-request או ה-response שצוינו. אם יש כמה כותרות אותו שם, הערכים שלהם מאוחסנים במערך.

<!-- The name is the actual header name. -->
<Header name="Authoriza>t<ion"
!-- Provide a name for your new custom variabl>e he<re. --
   Pattern ignoreCa>se="false"<;Bearer >{<oauthto>ken}/Pattern
/Header

אם יש כמה כותרות בעלות שם זהה, השתמשו באינדקסים כדי להפנות לכותרות נפרדות מערך:

<Header name="myHead>er.2<"
   Pattern ignoreC>ase="true<"{s>e<condHea>der}/Pattern
/Header

או את הקוד הבא כדי להציג את כל הכותרות במערך:

<Header name="myHeader.va>lues<"
   Pattern ignoreC>ase="t<rue">;<{myHead>ers}/Pattern
/Header

מאפיינים

<FormParam> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) חילוץ ערך מהפרמטר של הטופס שצוין בהודעת ה-request או ה-response שצוינו. פרמטרים של טופס רק כשהכותרת Content-Type של ההודעה שצוינה היא application/x-www-form-urlencoded.

<FormParam name="gree>ting&<quot;
 >   Patternhe<llo {use>r<}/Pattern
>/FormParam

מאפיינים

<Variable> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) מציינת את שם של משתנה שממנו יש לחלץ את הערך.

<Variable name="m>yVar&<quot;
 >   Patternhe<llo {use>r<}/Pattern>
/Variable

כדי לחלץ שני ערכים מהמשתנה:

<Variable name="m>yVar<"
>   Patternhello {firstName} <{lastNam>e<}/Pattern>
/Variable

מאפיינים

<JSONPayload> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) מציינת את הודעה בפורמט JSON שממנה יתבצע חילוץ הערך של המשתנה. JSON החילוץ מתבצע רק כשהכותרת Content-Type של ההודעה היא application/json.

<JSONPayload>
   <Variable name="name" typ>e="<;string&>quot;
   <   JSONPa>th{e<xample}/J>S<ONPath
   /V>ariable
/JSONPayload

<JSONPayload>/<Variable> רכיב

(נדרש ברכיב JSONPayload.) מציינת את המשתנה שבו הערך שחולץ הוקצה. כדי לאכלס, אפשר לכלול כמה תגי <Variable> ברכיב <Variable>. משתנים רבים.

<Variable name="name" typ>e=&q<uot;stri>ng"
<   JSONPa>t<h{example>}/JSONPath
/Variable

מאפיינים

<JSONPayload>/<Variable>/<JSONPath> רכיב

(נדרש ברכיב JSONPayload:Variable). מציינת את נתיב ה-JSON שמשמש לחילוץ קובץ מהודעה בפורמט JSON.

<Variable name=">name<"
 >  JSONPath$.rss.cha<nnel.titl>e</JSONPath>
/Variable

<XMLPayload> רכיב

(אופציונלי, אבל אפשר לעיין בשורה 'נוכחות' בטבלה שלמטה כדי לקבל מידע נוסף.) מציינת את הודעה בפורמט XML שממנה יחול הערך של המשתנה. מטענים ייעודיים (payloads) מסוג XML מחולצים רק כאשר הכותרת Content-Type של ההודעה. היא text/xml, application/xml, או application/*+xml.

<XMLPayload stopPayloadProcessing="f>als<e"
  >Namesp<aces
     Namespace prefi>x="apigee"h<ttp://www.>apigee<.com/Namespace
     Name>space prefix="gma<il"ht>tp:<//mail.goog>le.<com/Namespace
  /Namespaces
  Varia>ble na<me=&q>uot;name" type="b<oolean>&qu<ot;
     >X<Path/apigee>:test/apigee:example/XPath
  /Variable
/XMLPayload

מאפיינים

<XMLPayload>/<Namespaces> רכיב

(אופציונלי) מציין את מרחב השמות שישמש בהערכת ה-XPath. אם אתם משתמשים מרחבי השמות בביטויי ה-XPath שלכם, עליכם להצהיר כאן על מרחבי השמות, כפי שמוצג בדוגמה הבאה.

<XMLPayload stopPayloadProcessing="f>als<e"
  >Namesp<aces
     Namespace prefi>x="apigee"h<ttp://www.>apigee<.com/Namespace
     Name>space prefix="gma<il"ht>tp:<//mail.goog>le.<com/Namespace
  /Namespaces
  Variabl>e nam<e=&qu>ot;legName" type="string"
    XPath/api<gee:Di>rec<tions/api>g<ee:route/ap>igee:leg/apigee:name/XPath
  /Variable
/XMLPayload

אם אתם לא משתמשים במרחבי שמות בביטויי ה-XPath שלכם, תוכלו להשמיט או להוסיף תגובה. <Namespaces>, כמו בדוגמה הבאה:

<XMLPayload stopPayloadProcessing="f>als<e&qu<ot;
  !-- N>ame>spa<ces/ --
  Variable name="legName>"<; typ>e="string"
    X<Path/D>ire<ctions/ro>u<te/leg/name>/XPath
  /Variable
/XMLPayload

מאפיינים

<XMLPayload>/<Variable> רכיב

(אופציונלי) מציין משתנה שאליו יוקצה הערך שחולץ.

<Variable name="name" type>=&qu<ot;bo>olean"
 <  XPat>h</test/exa>mple/XPath
/Variable

מאפיינים

<XMLPayload>/<Variable>/<XPath> רכיב

(חובה ברכיב XMLPayload:Variable). מציינת את ה-XPath שהוגדר עבור מותאם אישית. יש תמיכה רק בביטויי XPath 1.0.

<Variable name="name" type>=&qu<ot;bo>olean"
 <  XPat>h</test/exa>mple/XPath
/Variable

דוגמה עם מרחב שמות. אם אתם משתמשים במרחבי שמות בביטויי XPath, עליכם להצהיר (declare) מרחבי השמות בקטע <XMLPayload><Namespaces> של המדיניות.

<Variable name="name" type>=&qu<ot;bo>olean"
   XPath/<foo:te>s<t/foo:exa>mple/XPath
/Variable

התייחסות לשגיאות

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 this policy triggers an error at runtime. For more information, see What you need to know about policy errors.

Example error response

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

Example fault rule

<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 תוכן של הודעות באמצעות ניתוח נתונים בהתאמה אישית

הפניה למשתנים