Risoluzione dei problemi relativi agli errori di deployment dei criteri Estrazione variabili

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

NothingToExtract

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory. Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Esempio di messaggio di errore

Error Saving Revision 2
ExtractVariables EV-XML-Age: at least one of URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload is mandatory.

Screenshot di esempio

Causa

Se il criterio Estrai variabili non contiene gli elementi URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload, il deployment del proxy API non va a buon fine perché non c'è nulla da estrarre.

Come indicato nel messaggio di errore, il criterio Estrai variabili deve includere almeno uno dei seguenti elementi: URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload.

Diagnosi

Esamina il criterio Estrai variabili indicato nel messaggio di errore. Se il criterio non contiene nemmeno uno dei seguenti elementi: URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload, è questo la causa dell'errore. Ad esempio, il seguente criterio Estrai variabili non contiene nessuno degli elementi sopra menzionati:

<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Properties/>
</ExtractVariables>

Poiché nessuno degli elementi obbligatori è presente nel criterio Estrai variabili, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili abbia almeno uno di questi elementi obbligatori: URIPath, QueryParam, Header, FormParam, XMLPayload, JSONPayload. Ad esempio:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
  <DisplayName>EV-XML-Age</DisplayName>
  <Properties/>
  <Source>request</Source>
  <XMLPayload>
    <Namespaces/>
      <Variable name="age" type="integer">
          <XPath>/age</XPath>
      </Variable>
  </XMLPayload>
</ExtractVariables>

NONEmptyPrefixMappedToEmptyURI

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: Non-empty prefix [prefix_name] cannot be mapped to empty uri.

Esempio di messaggio di errore

Error Saving Revision 3
ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

Screenshot di esempio

Causa

Questo errore si verifica se il criterio Estrai variabili ha un prefisso definito nell'elemento <Namespace> all'interno dell'elemento <XMLPayload>, ma non è stato definito alcun URI.

Diagnosi

  1. Identifica il criterio Estrai variabili in cui si è verificato l'errore e il nome del prefisso. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nel seguente errore , il nome del criterio è EV-XML-Age e il prefisso è apigee:

    ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

  2. Nel file XML del criterio di estrazione delle variabili con errori, verifica che il nome del prefisso impostato nell'elemento <Namespace> sotto l'elemento <XMLPayload> corrisponda al nome del prefisso identificato nel messaggio di errore (passaggio 1 sopra). Ad esempio, il seguente criterio consente di specificare un prefisso denominato apigee nell'elemento <Namespace> , che corrisponde al contenuto del messaggio di errore:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="EV-XML-Age">
    <DisplayName>EV-XML-Age</DisplayName>
    <Source clearPayload="false">request</Source>
    <XMLPayload stopPayloadProcessing="false">
      <Namespaces>
        <Namespace prefix="apigee"></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>
</ExtractVariables>

  3. Verifica che l'elemento <Namespace> con il prefisso specifico identificato nel passaggio 2 abbia un URI valido. Se manca l'URI, questo è la causa dell'errore.

    Nell'esempio del criterio Estrai variabili mostrato sopra, puoi notare che non esiste un URI corrispondente all'elemento <Namespace> con il prefisso apigee. perciò viene visualizzato l'errore:

    ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

Risoluzione

Assicurati che tutti gli elementi <Namespace> definiti con un prefisso abbiano un URI corrispondente nel criterio Estrai variabili. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError=>"<;false">; enabled=<"true&q>uot; <name="EV-XML-Age">
    Di<splayNa>meEV-<XML-Age/DisplayName
    Source clearPayl>oad=&<quot;false>"req<uest/Source
    XMLPayloa>d stopPayloadProcessi<ng="f>alse"<;
    Namespaces
       > Namespace prefix=&quo<t;apigee&q>uot;ht<tp://www.ap>igee.<com/Namespace
        Namespace prefi>x="g<mail&>quot;http://mail.google.com/Namespace
     /Namespaces<
    V>ariab<le name=&>quot;<legName&quo>t<; type="stri>ng"
        XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/Xpath
    /Variable
    /XMLPayload
/ExtractVariables

DuplicatePrefix

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: Duplicate prefix [prefix_name].

Esempio di messaggio di errore

Error Saving Revision 2
ExtractVariables EV-XML-Age: Duplicate prefix apigee.

Screenshot di esempio

Causa

Questo errore si verifica se il criterio Estrai variabili ha lo stesso prefisso definito più di una volta nell'elemento <Namespace> all'interno dell'elemento <XMLPayload>.

Ad esempio, questo errore si verifica perché il prefisso apigee è definito due volte come illustrato di seguito:

<Namespace prefix="ap>igee"http://www.<apigee.com>/<Namespace
Namespace prefi>x="apigee"h<ttp://www.>apigee.com/Namespace

Diagnosi

  1. Identifica il criterio Estrai variabili in cui si è verificato l'errore e il nome del prefisso. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è EV-XML-Age e il prefisso è apigee:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

  2. Nel file XML del criterio di estrazione delle variabili con errori, verifica che il nome del prefisso impostato nell'elemento <Namespace> sotto l'elemento <XMLPayload> corrisponda al nome del prefisso identificato nel messaggio di errore (passaggio 1 sopra). Ad esempio, il seguente criterio consente di specificare un prefisso denominato apigee nell'elemento <Namespace> , che corrisponde al contenuto del messaggio di errore:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError=>"<;false">; enabled=<"true&q>uot; <name="EV-XML-Age">
    Di<splayNa>meEV-<XML-Age/DisplayName
    Source clearPayl>oad=&qu<ot;false&q>uot;request</Source
    XMLPayload s>topPayloadProcessing=&<quot;false>"
    <  Namespaces
          Na>mespace prefix="<gmail">;http://mai<l.google.com/Namespace
  >        Namespace pre<fix=">apigee&<quot;http:/>/www.ap<igee.com/Namespace
          Namespace prefix=&<quot;>apigee"http://www.apigee.com/Namespace
      /Nam<espace>s
     < Variable> name<="legN>ame<" type=">;string
          XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/XPath
      /Variable
    /XMLPayload
  /ExtractVariables

  3. Determina se l'elemento <Namespace> con il prefisso specifico identificato nel passaggio 2 è stato definito più di una volta. Se viene definito più di una volta, ciò è la causa dell'errore.

    Nell'esempio del criterio Estrai variabili mostrato sopra, puoi notare che l'elemento <Namespace> con il prefisso apigee è stato definito due volte; perciò viene visualizzato l'errore:

    ExtractVariables EV-XML-Age: Duplicate prefix apigee.

Risoluzione

Assicurati che esista una sola definizione per ogni prefisso negli elementi <Namespace> del criterio Estrai variabili. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError=>"<;false">; enabled=<"true&q>uot; <name="EV-XML-Age">
    Di<splayNa>meEV-<XML-Age/DisplayName
    Source clearPayl>oad=&qu<ot;false&q>uot;request</Source
    XMLPayload st>opPayloadProcessing=&<quot;false>"
    <  Namespaces
          N>amespace prefix="<apigee&quo>t;http:<//www.apige>e.com/N<amespace
          Namespace prefix=&>quot;gmail&<quot;>http://mail.google.com/Namespace
      /Namespaces
   <   Var>iable n<ame=">;legN<ame" t>y<pe="string&q>uot;
          XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/Xpath
      /Variable
    /XMLPayload
/ExtractVariables

NoXPathsToEvaluate

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]:no xpaths to evaluate in variable name.

Esempio di messaggio di errore

Error Saving Revision 4
ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili non include l'elemento <XPath> all'interno dell'elemento <XMLPayload>, il deployment del proxy API non va a buon fine e restituisce l'errore mostrato sopra.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili non riuscito dal messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

  2. Nel file XML del criterio di estrazione delle variabili che non è riuscito, controlla se esiste un elemento <XMLPayload> senza l'elemento secondario <XPath>. In tal caso, questa è la causa dell'errore.

    Ad esempio, ecco un criterio Estrai variabili che ha un elemento <XMLPayload>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
<    Source clea>rPayl<oad="false"request/Source
    >VariableP<refixapigee>/Variable<Prefix
    XMLPayload stopPayloadProcessing=>"fal<se"<>/span>
     <   Namespac>e<s/
        Variab>le name="HostReachable" type="boolean"
        /Variable
    /XMLPayload
/ExtractVariables

    Poiché non è presente alcun elemento <XPath>, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili abbia un elemento <XPath> definito sotto l'elemento <XMLPayload>. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
<    Source clea>rPayl<oad="false"request/Source
    >VariableP<refixapigee>/Variable<Prefix
    XMLPayload stopPayloadProcessing=>"false&q<uot;<>/span>
        Name<spaces>/
       < Variable> name<="Host>R<eachable" ty>pe="boolean"
            XPath/isReachable/XPath
        /Variable
    /XMLPayload
/ExtractVariables

EmptyXPathExpression

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: XPath expression is empty in variable name.

Esempio di messaggio di errore

Error Saving Revision 6
ExtractVariables Extract-Variables-1: XPath expression is empty in variable name.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili ha un'espressione <XPath> vuota nell'elemento <XMLPayload>, il deployment del proxy API non va a buon fine.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili non riuscito dal messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.

  2. Nel file XML del criterio di estrazione delle variabili con errori, determina se è presente un elemento <XMLPayload> con un elemento secondario <XPath> vuoto. In tal caso, questa è la causa dell'errore.

    Ad esempio, ecco un criterio Estrai variabili che ha un elemento <XMLPayload>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
<    Source clea>rPayl<oad="false"request/Source
    >VariableP<refixapigee>/Variable<Prefix
    XMLPayload stopPayloadProc>essing="<false><">
        <Namespace>s/
  <      Varia>b<le name="add>ress" type="string"
            XPath/XPath
        /Variable
    /XMLPayload
/ExtractVariables

    Poiché è presente un elemento <XPath> vuoto all'interno dell'elemento <XMLPayload>, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili abbia un elemento <XPath> valido e non vuoto definito sotto l'elemento <XMLPayload>. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
<    Source clea>rPayl<oad="false"request/Source
    >VariableP<refixapigee>/Variable<Prefix
    XMLPayload stopPayloadProc>essing="<false>"
 <      > Namespac<es/
     >   Va<riable name>=<"address&quo>t; type="string"
            XPath/address/XPath
        /Variable
    /XMLPayload
/ExtractVariables

NoJSONPathsToEvaluate

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]:no jsonpaths to evaluate in variable name.

Esempio di messaggio di errore

Error Saving Revision 6
ExtractVariables Extract-Variables-1: no jsonpaths to evaluate in variable name.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili non include l'elemento <JSONPath> all'interno dell'elemento <JSONPayload>, il deployment del proxy API non va a buon fine e restituisce l'errore mostrato sopra.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili non riuscito dal messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1:

    ExtractVariables Extract-Variables-1: no jsonpaths to evaluate in variable name.

  2. Nel file XML del criterio di estrazione delle variabili con errori, determina se è presente un elemento <JSONPayload> senza l'elemento secondario <JSONPath> richiesto. In tal caso, questa è la causa dell'errore.

    Ad esempio, ecco un criterio Estrai variabili che contiene l'elemento <JSONPayload>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    Disp>layNameEx<tract Variables-1/Dis>playName
<    Prope>rties</
    JSONPa>yload<
        Variable name=&quo>t;title<"<>/span>
     <   /Variable
 >   /JS<ONPayload
    S>o<urce clearPayload>="false"request/Source
    VariablePrefixapigee/VariablePrefix
/ExtractVariables

    Poiché non è presente alcun elemento secondario <JSONPath> definito nell'elemento <JSONPayload>, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili abbia un elemento <JSONPath> definito sotto l'elemento <JSONPayload>. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    Disp>layNameEx<tract Variables-1/Dis>playName
    <Properti>es/
    JSON<Payload
 >       Va<riable na>me=&q<uot;title&qu>ot;
 <           JSONPath$.book.t>itle/JS<ONPath<>/span>
     <   /Variable
 >   /JS<ONPayload
    S>o<urce clearPayload>="false"request/Source
    VariablePrefixapigee/VariablePrefix
/ExtractVariables

EmptyJSONPathExpression

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
ExtractVariables [policy_name]: JSONPath expression is empty in variable name.

Esempio di messaggio di errore

Error Saving Revision 6
ExtractVariables Extract-Variables-1: JSONPath expression is empty in variable name.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili ha un'espressione <JSONPath> vuota nell'elemento <JSONPayload>, il deployment del proxy API non va a buon fine.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili non riuscito dal messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1:

    ExtractVariables Extract-Variables-1: JSONPath expression is empty in variable name.

  2. Nel file XML del criterio di estrazione delle variabili che non è riuscito, verifica se è presente un elemento <JSONPayload> con un elemento secondario <JSONPath> vuoto. In tal caso, questa è la causa dell'errore.

    Ad esempio, ecco un criterio Estrai variabili con un elemento <JSONPayload>:

        <ExtractVariables async="false" continueOnError="false" enabled="true&qu>ot; name=<"Extra>ct-Variables-1"<;
        Di>splayName<Extract Var>iables-1/<DisplayName>
        Prop<erties/
        JSONPayload
            Varia>ble name="ac<count_nu><mber">; type="<integer&q>uot;
    <            >JSONPath/<JSONPath
            /Varia>ble
   <     /J>SONPayloa<d
        Sour>ce cle<arPayload=">;fals<e"request/So>urce
        VariablePrefixapigee/VariablePrefix
    /ExtractVariables

    Poiché è presente un elemento <JSONPath> vuoto all'interno dell'elemento <JSONPayload>, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili abbia un elemento <JSONPath> valido e non vuoto definito sotto l'elemento <JSONPayload>. Ad esempio:

<ExtractVariables async="false" continueOnError="false" enabled="true&qu>ot; n<ame="E>xtract-Variables-1&<quot;
    Di>splay<NameExtract> Vari<ables-1/Dis>playName
<    Properties/
    JSONPayload
        Varia>ble name=&qu<ot;accou>nt_number" <type=&quo>t;integer<"
  >     <    JSONPath>$.acc<ount.number/JSONPath
      >  /Vari<able
  >  /JS<ONPayload
    >Source< clearPayload=&>q<uot;false"re>quest/Source
    VariablePrefixapigee/VariablePrefix
/ExtractVariables

MissingName

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
Error occurred while validation of bean [policy_name].xml Reason: - Required attribute name is missing in [element_name]

Esempio di messaggio di errore

Error Saving Revision 6
Error occurred while validation of bean Extract-Variables-1.xml. Reason: - Required attribute name is missing in Variable

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili non ha l'attributo name in nessuno degli elementi del criterio come QueryParam, Header, FormParam o Variable, dove richiesto, il deployment del proxy API non va a buon fine.

Ad esempio, questo errore si verifica se l'attributo name non è presente in un elemento Variable.

Diagnosi

  1. Identifica il nome del criterio Estrai variabili in cui si è verificato l'errore e l'elemento in cui manca l'attributo name. Puoi trovare questi elementi nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1 e il nome dell'elemento è Variable:

    Error occurred while validation of bean Extract-Variables-1.xml. Reason: - Required attribute name is missing in Variable

  2. Nel file XML del criterio di estrazione delle variabili che non è stato superato, controlla che tutti gli elementi il cui nome sia stato determinato nel passaggio 1 precedente abbiano un attributo name. Se c'è un elemento in cui l'attributo name non è presente, ciò è la causa dell'errore.

    Ad esempio, per il seguente criterio di estrazione delle variabili è definito l'elemento <Variable>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtra>ct Variab<les-1/D>isplayName
    Pr<operties>/
   < Variable> <type="boolea>n"
        Pattern{isAccountActive}/Pattern
    /Variable
/ExtractVariables

    Tieni presente che l'attributo name non è presente nell'elemento Variable, quindi il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che il criterio Estrai variabili contenga l'attributo name obbligatorio per gli elementi QueryParam, Header, FormParam o Variable. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract Variables-1/Display>Name
    <Propert>ies/
    Variable< name=&q>uot;a<ccount_ac>t<ive" type=&q>uot;boolean"
        Pattern{isAccountActive}/Pattern
    /Variable
/ExtractVariables

PatternWithoutVariable

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Saving Revision [revision_number]
Pattern [pattern] should have at least one variable in ExtractVariables stepDefinition [policy_name]

Esempio di messaggio di errore

Error Saving Revision 7
Pattern /a/b/ should have at least one variable in ExtractVariables stepDefinition ExtractVariables-1.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili non ha una variabile specificata all'interno dell'elemento <Pattern>, il deployment del proxy API non va a buon fine. L'elemento <Pattern> richiede il nome della variabile in cui verranno archiviati i dati estratti.

Diagnosi

  1. Identifica il nome del criterio Estrai variabili in cui si è verificato l'errore e il pattern in cui la variabile è mancante. Puoi trovare questi elementi nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-1 e il nome dell'elemento è /a/b:

    Pattern /a/b/ should have at least one variable in ExtractVariables stepDefinition ExtractVariables-1.

  2. Nel file XML del criterio di estrazione delle variabili con errori, verifica che il pattern impostato nell'elemento <Pattern> corrisponda al pattern identificato nel messaggio di errore (passaggio 1 sopra). Ad esempio, il seguente criterio specifica un pattern /a/b, che corrisponde al contenuto del messaggio di errore:

    Ad esempio, ecco un criterio Estrai variabili con tre elementi <Pattern>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVaria>bles< name=>"E<xtractV>aria<bles-1&>quot;
 <  Sourcerequest/Source
  > URIPath
   <   Patte>rn igno<reCase="true"/a>/{pat<hSeg}/Pa>ttern
 <     Pattern ignoreCase=&>quot;true"/<a/b//Pat>tern<
      P>atte<rn ignoreCase=>"true<"/a/b/c/{p>a<thSeg}/Pattern
  > /URIPath
   VariablePrefixurirequest/VariablePrefix
/ExtractVariables

  3. Controlla se l'elemento <Pattern> identificato nel passaggio 2 non ha una variabile. Variabili deve essere racchiuso tra parentesi graffe. Se il pattern non ha una variabile, la causa dell'errore.

    L'elemento <Pattern> con il pattern /a/b non include una variabile. pertanto il deployment del proxy API ha esito negativo

    <Pattern ignoreCase=">true&<quot;/a/>b//Pattern

Risoluzione

Assicurati che tutti gli elementi <Pattern> includano una variabile (un nome racchiuso tra caratteri curvi parentesi graffe). Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVaria>bles< name=>"E<xtractV>aria<bles-1&>quot;
 <  Sourcerequest/Source
  > URIPath
   <   Patte>rn igno<reCase="true"/a>/{pathSeg}/Pat<tern
   >   Patt<ern ignoreCase="true>"/a/b/{path<Seg}/Pat>tern<
      P>atte<rn ignoreCase=>"true<"/a/b/c/{p>a<thSeg}/Pattern
  > /URIPath
   VariablePrefixurirequest/VariablePrefix
/ExtractVariables

CannotBeConvertedToNodeset

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Deploying Revision [revision_number]
ExtractVariables [policy_name]: Result of xpath [policy_name] cannot be converted to nodeset. Context Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Esempio di messaggio di errore

Error Deploying Revision 4 to test
ExtractVariables Extract-Variables-1: Result of xpath 123 cannot be converted to nodeset. Context Revision:4;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

Screenshot di esempio

Causa

Se il criterio di estrazione delle variabili ha un'espressione <XPath> in cui il tipo <Variable> è definito come nodeset, ma l'espressione non può essere convertita in set di nodi, il deployment del proxy API non va a buon fine.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili in cui si è verificato l'errore e l'XPath che non può essere convertito in un set di nodi. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nell'errore seguente , il nome del criterio è Extract-Variables-1 e l'XPath è 123.

    ExtractVariables Extract-Variables-1: Result of xpath 123 cannot be converted to nodeset. Context Revision:4;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

  2. Nel file XML del criterio di estrazione delle variabili con errori, verifica che l'XPath impostato nell'elemento <XPath> corrisponda all'XPath identificato nel messaggio di errore (passaggio 1 sopra). Ad esempio, il seguente criterio specifica come 123, che corrisponde al contenuto del messaggio di errore:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
 <   Source clear>Paylo<ad="false"request/Source
    V>ariablePr<efixvisitor>/Variable<Prefix
    XMLPayload stopPayloadP>rocessing=&qu<ot;fa>lse<">
        <Namespace>s/
  <      Varia>b<le name="age>&quot; type="nodeset"
            XPath123/XPath
        /Variable
    /XMLPayload
/ExtractVariables

  3. Esamina il tipo dell'elemento <Variable> corrispondente all'elemento <XPath> identificato nel passaggio 2 precedente. Se il tipo <Variable> è nodeset, questa è la causa dell'errore.

    Nota che l'espressione <XPath> è 123 nel criterio di estrazione delle variabili di esempio.

    <XPath>123</XPath>

    L'espressione 123 non può essere convertita in un set di nodi. Pertanto, il deployment del proxy API non va a buon fine.

Risoluzione

Assicurati che le espressioni <XPath> utilizzate nel criterio Estrai variabili possano essere convertite in set di nodi se il tipo <Variable> è definito come set di nodi. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Ex>tract<-Variables->1&quo<t;
    DisplayNameExtract V>ariable<s-1/Dis>playN<ame
    Proper>ties/
 <   Source clear>Paylo<ad="false"request/Source
    V>ariablePr<efixvisitor>/Variable<Prefix
    XMLPayload stopPayloadP>rocessing=&qu<ot;fa>lse"
  <      >Namespace<s/
      >  Var<iable name=>&<quot;age" ty>pe="nodeset"
            XPath/visitor/age/XPath
        /Variable
    /XMLPayload
/ExtractVariables

InvalidPattern

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e questo messaggio di errore:

Error Deploying Revision [revision_number]
Pattern [pattern] is invalid in ExtractVariables stepDefinition [policy_name]

Esempio di messaggio di errore

Error Deploying Revision 18 to test
Pattern {*} is invalid in ExtractVariables stepDefinition ExtractVariables-2.

Screenshot di esempio

Causa

Se la definizione dell'elemento <Pattern> non è valida in uno qualsiasi degli elementi come URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload nel criterio di estrazione delle variabili, il deployment del proxy API non va a buon fine.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili in errore dal messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è Extract-Variables-2:

    Pattern {*} is invalid in ExtractVariables stepDefinition ExtractVariables-2.

  2. Nel file XML del criterio di estrazione delle variabili con errori, controlla se uno di questi elementi è presente e include un elemento <Pattern>. URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload.

    Ad esempio, ecco un criterio Estrai variabili con un elemento <Pattern> all'interno di un elemento <QueryParam>:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVaria>bles <name=">ExtractVariables-2<"
    D>ispla<yNameE>xtractV<ariable>s-2/D<isplayName
    Sourcer>equest/So<urce
    QueryParam name=>&qu<ot;code&>quot;<
        Pa>ttern< ignoreCase=&q>uot;true&<quot;{*}/Patter>n<
    /QueryParam
>    VariablePrefixqueryinfo/VariablePrefix
/ExtractVariables

  3. Esamina la definizione di ciascuno degli elementi <Pattern>. Se è presente un elemento <Pattern> con una definizione non valida, questo è la causa dell'errore.

    Nell'esempio del criterio Estrai variabili mostrato sopra, nota che la definizione di <Pattern> all'interno dell'elemento <QueryParam> non è valida. pertanto il deployment del proxy API non va a buon fine. Vedi anche Informazioni sulla corrispondenza e sulla creazione di variabili

    <Pattern ignoreCase=">tru<e"{>*}/Pattern

Risoluzione

Assicurati che la definizione dell'elemento <Pattern> negli elementi URIPath, QueryParam, Header, FormParam, XMLPayload o JSONPayload nel criterio Estrai variabili sia valida. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVaria>bles <name=">ExtractVariables-2"
    DisplayNa<meExtract a >value< from >a query< parame>ter/D<isplayName
    Sourcer>equest/So<urce
    QueryParam name=>"<code&quo>t;
  <      Patte>rn ig<noreCase=">;true&quo<t;{code}/Patter>n<
    /QueryParam
>    VariablePrefixqueryinfo/VariablePrefix
/ExtractVariables

Consulta anche Informazioni sulla corrispondenza e sulla creazione di variabili

XPathCompilationFailed

Messaggio di errore

Il deployment del proxy API tramite la UI di Edge o l'API di gestione perimetrale non va a buon fine con questo messaggio di errore:

Error Deploying Revision [revision_number]
ExtractVariables [policy_name]: Failed to compile xpath [xpath] Context Revision:[revision_number]; APIProxy:[proxy_name]; Organization:[org_name]; Environment:[env_name].

Esempio di messaggio di errore

Error Deploying Revision 1 to test
ExtractVariables EV-XML-Age: Failed to compile xpath /apigee:Directions/apigee:route/apigee:leg/apigee:name. Context Revision:1;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

Screenshot di esempio

Causa

Se il prefisso o il valore utilizzato nell'elemento <XPath> non fa parte di nessuno degli spazi dei nomi dichiarati nel criterio di estrazione delle variabili, il deployment del proxy API non va a buon fine.

Puoi trovare ulteriori informazioni su spazi dei nomi, XPath e prefisso in XML Namespaces and How they Affect XPath e TCF.

Diagnosi

  1. Identifica il criterio di estrazione delle variabili in cui si è verificato l'errore e l'XPath che non è stato possibile compilare. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nell'errore seguente , il nome del criterio è EV-XML-Age e l'xpath è /apigee:Directions/apigee:route/apigee:leg/apigee:name.

    ExtractVariables EV-XML-Age: Failed to compile xpath /apigee:Directions/apigee:route/apigee:leg/apigee:name. Context Revision:1;APIProxy:EV-XML;Organization:aprabhashankar-eval;Environment:test.

  2. Nel file XML del criterio di estrazione delle variabili con errori, verifica che l'XPath impostato nell'elemento <XPath> corrisponda all'XPath identificato nel messaggio di errore (passaggio 1 sopra). Ad esempio, il seguente criterio specifica come /apigee:Directions/apigee:route/apigee:leg/apigee:name, che corrisponde al contenuto del messaggio di errore:

    <?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError=>&qu<ot;false&qu>ot; enable<d="true>&qu<ot; name="EV-XML-Age&q>uot;
  <Display>Nam<eEV-XML-Age/DisplayName
  Source clearPa>yload<="fal>se"r<equest/Source
  XMLPaylo>ad stopPayloadProcessi<ng="f>alse&<quot;
    N>amesp<aces
        Namespace prefix="g>mail&<quot;>http://mail.google.com/Namespace
    /Namespaces
    V<ariabl>e name=&q<uot;legNa>me&<quot; type=>&<quot;string">
    XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/XPath
        /Variable
  /XMLPayload
/ExtractVariables

  3. Esamina gli elementi <Namespaces> e <XPath> del criterio Estrai variabili. Se lo specifico <XPath> indicato nel messaggio di errore utilizza un prefisso o un valore che non fa parte degli spazi dei nomi dichiarati nel criterio Estrai variabili, questo è la causa dell'errore.

    Tieni presente che lo specifico <XPath> utilizza il prefisso apigee nell'esempio di criterio di estrazione delle variabili.

    <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>

    Tuttavia, il prefisso apigee non è definito in nessuno degli elementi <Namespace>. pertanto la compilazione di <XPath> non va a buon fine e porta a un errore del deployment.

Risoluzione

Assicurati che tutti gli spazi dei nomi utilizzati negli elementi <XPath> siano dichiarati nel criterio di estrazione delle variabili. Ad esempio:

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ExtractVariables async="false" continueOnError=>&qu<ot;false&qu>ot; enable<d="true>&qu<ot; name="EV-XML-Age&q>uot;
  <Display>Nam<eEV-XML-Age/DisplayName
  Source clearPa>yload<="fal>se"r<equest/Source
  XMLPayloa>d stopPayloadProcessi<ng="f>alse"<;
    Namespaces
       > Namespace prefix=&quo<t;apigee&q>uot;h<ttp://www.a>pigee<.com/Namespace
        Namespace pref>ix="<gmail>"http://mail.google.com/Namespace
    /Namespaces<
    V>ariab<le name=&>quo<t;legName&q>u<ot; type="st>ring"
        XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/XPath
    /Variable
  /XMLPayload
/ExtractVariables