Extract Variables ポリシーのデプロイエラーのトラブルシューティング

NothingToExtract

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーに、URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload の要素がいずれも含まれない場合、抽出するものがないため API プロキシのデプロイは失敗します。

エラーメッセージに示されているように、Extract Variables ポリシーは、URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload のうち少なくとも 1 つの要素をポリシーに含む必要があります。

診断

エラーメッセージで指定されている Extract Variables ポリシーを調べます。ポリシーに URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload の要素が 1 つも含まれていない場合、これがエラーの原因です。たとえば、次の Extract Variables ポリシーには、上記の要素はありません。

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

Extract Variables ポリシーに必須の要素がないため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーに、必須の要素である URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload のうち少なくとも 1 つを含めるようにします。次に例を示します。

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

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

このエラーは、Extract Variables ポリシーで <XMLPayload> 要素の下の <Namespace> 要素に接頭辞が定義されているが、URI が定義されていない場合に発生します。

診断

エラーが発生した Extract Variables ポリシーと接頭辞の名前を特定します。これらの両方の項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は EV-XML-Age で、接頭辞は apigee です。
```
ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.
    
```

失敗した Extract Variables ポリシーの XML で、<XMLPayload> 要素の下の <Namespace> 要素に設定されている接頭辞の名前が、エラーメッセージ（上記のステップ 1）で識別された接頭辞の名前と一致することを確認します。たとえば、次のポリシーは、<Namespace> 要素に apigee という名前の接頭辞を指定しており、これはエラーメッセージ内の接頭辞と一致します。

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

ステップ 2 で識別された特定の接頭辞を持つ <Namespace> 要素に有効な URI があるかどうかを確認します。URI がない場合は、それがエラーの原因です。

上記の Extract Variables ポリシーの例では、接頭辞 apigee を持つ <Namespace> 要素に対応する URI が存在しないため、エラーが発生します。
```
ExtractVariables EV-XML-Age: Non-empty prefix apigee cannot be mapped to empty uri.

    
```

解決策

Extract Variables ポリシー内で、接頭辞が定義されたすべての <Namespace> 要素に対応する URI が存在するようにします。次に例を示します。

<?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">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>
    </ExtractVariables>

DuplicatePrefix

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

このエラーは、Extract Variables ポリシーで <XMLPayload> 要素の下の <Namespace> 要素に同じ接頭辞が複数回定義されている場合に発生します。

たとえば、次のように接頭辞 apigee が 2 回定義されていると、このエラーが発生します。

<Namespace prefix="apigee">http://www.apigee.com</Namespace>
    <Namespace prefix="apigee">http://www.apigee.com</Namespace>

診断

エラーが発生した Extract Variables ポリシーと接頭辞の名前を特定します。これらの両方の項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は EV-XML-Age で、接頭辞は apigee です。
```
ExtractVariables EV-XML-Age: Duplicate prefix apigee.
    
```

<?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="gmail">http://mail.google.com</Namespace>
              <Namespace prefix="apigee">http://www.apigee.com</Namespace>
              <Namespace prefix="apigee">http://www.apigee.com</Namespace>
          </Namespaces>
          <Variable name="legName" type="string
              <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>
          </Variable>
        </XMLPayload>
      </ExtractVariables>

ステップ 2 で識別された特定の接頭辞を持つ <Namespace> 要素が複数回定義されているかどうかを判別します。複数回定義されている場合は、それがエラーの原因になります。

上記の Extract Variables ポリシーの例では、接頭辞 apigee を持つ <Namespace> 要素が 2 回定義されているため、エラーが発生します。
```
ExtractVariables EV-XML-Age: Duplicate prefix apigee.

    
```

解決策

Extract Variables ポリシー内で、<Namespace> 要素内の接頭辞ごとに定義が 1 つのみとなるようにします。次に例を示します。

<?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">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>
    </ExtractVariables>

NoXPathsToEvaluate

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの <XMLPayload> 要素内に <XPath> 要素がない場合、API プロキシのデプロイは上記のエラーで失敗します。

XML ペイロードから変数を抽出する場合は、XPath 子要素を指定する必要があります。

診断

エラーメッセージから、失敗した Extract Variables ポリシーを特定します。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 です。
```
ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.
    
```

失敗した Extract Variables ポリシーの XML で、<XPath> 子要素を持たない <XMLPayload> 要素があるかどうかを確認します。存在する場合、それがエラーの原因です。

たとえば、<XMLPayload> 要素を持つ Extract Variables ポリシーを以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
        <XMLPayload stopPayloadProcessing="false">
            <Namespaces/>
            <Variable name="HostReachable" type="boolean">
            </Variable>
        </XMLPayload>
    </ExtractVariables>

<XPath> 要素がないため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーの <XMLPayload> 要素の下に <XPath> 要素が定義されるようにします。次に例を示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
        <XMLPayload stopPayloadProcessing="false">
            <Namespaces/>
            <Variable name="HostReachable" type="boolean">
                <XPath>/isReachable</XPath>
            </Variable>
        </XMLPayload>
    </ExtractVariables>

EmptyXPathExpression

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの <XMLPayload> 要素内に空の <XPath> 要素がある場合、API プロキシのデプロイは失敗します。

診断

エラーメッセージから、失敗した Extract Variables ポリシーを特定します。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 です。
```
ExtractVariables Extract-Variables-1: no xpaths to evaluate in variable name.
    
```

失敗した Extract Variables ポリシーの XML で、空の <XPath> 子要素を持つ <XMLPayload> 要素があるかどうかを判別します。存在する場合、それがエラーの原因です。

たとえば、<XMLPayload> 要素を持つ Extract Variables ポリシーを以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
        <XMLPayload stopPayloadProcessing="false">
            <Namespaces/>
            <Variable name="address" type="string">
                <XPath></XPath>
            </Variable>
        </XMLPayload>
    </ExtractVariables>

<XMLPayload> 要素内に空の <XPath> 要素があるため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーの <XMLPayload> 要素の下に、空でない有効な <XPath> 要素が定義されるようにします。次に例を示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
        <XMLPayload stopPayloadProcessing="false">
            <Namespaces/>
            <Variable name="address" type="string">
                <XPath>/address</XPath>
            </Variable>
        </XMLPayload>
    </ExtractVariables>

NoJSONPathsToEvaluate

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの <JSONPayload> 要素内に <JSONPath> 要素がない場合、API プロキシのデプロイは上記のエラーで失敗します。

JSON ペイロードから変数を抽出する場合は、JSONPath 子要素が必要です。

診断

エラーメッセージから、失敗した Extract Variables ポリシーを特定します。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 です。
```
ExtractVariables Extract-Variables-1: no jsonpaths to evaluate in variable name.
    
```

失敗した Extract Variables ポリシーの XML で、必須の <JSONPath> 子要素を持たない <JSONPayload> 要素があるかどうかを判別します。存在する場合、それがエラーの原因です。

たとえば、<JSONPayload> 要素を持つ Extract Variables ポリシーを以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <JSONPayload>
            <Variable name="title">
            </Variable>
        </JSONPayload>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
    </ExtractVariables>

<JSONPayload> 要素の下に <JSONPath> 子要素が定義されていないため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーの <JSONPayload> 要素の下に <JSONPath> 要素が定義されるようにします。次に例を示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
        <DisplayName>Extract Variables-1</DisplayName>
        <Properties/>
        <JSONPayload>
            <Variable name="title">
                <JSONPath>$.book.title</JSONPath>
            </Variable>
        </JSONPayload>
        <Source clearPayload="false">request</Source>
        <VariablePrefix>apigee</VariablePrefix>
    </ExtractVariables>

EmptyJSONPathExpression

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの <JSONPayload> 要素内に空の <JSONPath> 要素がある場合、API プロキシのデプロイは失敗します。

診断

エラーメッセージから、失敗した Extract Variables ポリシーを特定します。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 です。
```
ExtractVariables Extract-Variables-1: JSONPath expression is empty in variable name.
    
```

失敗した Extract Variables ポリシーの XML で、空の <JSONPath> 子要素を持つ <JSONPayload> 要素があるかどうかを判別します。存在する場合、それがエラーの原因です。

たとえば、<JSONPayload> 要素を持つ Extract Variables ポリシーを以下に示します。

    <ExtractVariables async="false" continueOnError="false" enabled="true&qu>ot; name=&quo<t;Extract-V>ariables-1"
  <          Di>splayNameExtr<act Variabl>es-1/DisplayN<ame
       >     Properties/
<            JSONPayload
                Varia>ble name="accoun<t_number><" ty>pe="integer&<quot;
   >             <    JSONPath>/JSONPath
   <             /Variable
    >       < /JSONP>ayload
      <      Source c>learPa<yload="fal>se"r<equest/Source
   >         VariablePrefixapigee/VariablePrefix
        /ExtractVariables

<JSONPayload> 要素内に空の <JSONPath> 要素があるため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーの <JSONPayload> 要素の下に、空でない有効な <JSONPath> 要素が定義されるようにします。次に例を示します。

<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="a<ccount_n>umber" type<="in>teger"
 <         >     JSON<Path$.accoun>t.number/<JSONPath
            /Varia>ble
   <     /J>SONPayloa<d
        Sour>ce cle<arPayload=">;fals<e"request/So>urce
        VariablePrefixapigee/VariablePrefix
    /ExtractVariables

MissingName

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの、QueryParam、Header、FormParam、Variable などのポリシー要素に、必須とされる name 属性が含まれない場合、API プロキシのデプロイは失敗します。

たとえば、Variable 要素に name 属性がない場合にこのエラーが発生します。

診断

エラーが発生した Extract Variables ポリシーの名前と、name 属性がない要素を特定します。これらの項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 で、要素名は Variable です。
```
Error occurred while validation of bean Extract-Variables-1.xml. Reason: - Required attribute name is missing in Variable
    
```
失敗した Extract Variables ポリシーの XML で、上記のステップ 1 で特定した名前を持つすべての要素に name 属性があることを確認します。name 属性がない要素があれば、それがエラーの原因になります。

たとえば、次の Extract Variables ポリシーでは <Variable> 要素が定義されています。
```
<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError="fal>se" <enabled=&qu>ot;true" name=<"Extrac>t-Variabl<es-1"<>/span>
        D<isplayNameExtract Varia>bles-1/Displa<yName
 >       Properties</
      >  Variabl<e type=&q>uot;b<oolean"
    >        Pattern{isAccountActive}/Pattern
        /Variable
    /ExtractVariables
    
```
Variable 要素に name 属性が指定されていないため、API プロキシのデプロイは失敗します。

解決策

Extract Variables ポリシーで、QueryParam、Header、FormParam、Variable の要素に必須の name 属性が含まれるようにしてください。次に例を示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError="fal>se" <enabled=&qu>ot;true" name=<"Extrac>t-Variabl<es-1"<>/span>
        D<isplayNameExtract Variables-1/DisplayName
   >     Properti<es/
   >     Variable nam<e=">account_a<ctive&quo>t; ty<pe="boolean&>quot;
            Pattern{isAccountActive}/Pattern
        /Variable
    /ExtractVariables

PatternWithoutVariable

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

Extract Variables ポリシーの <Pattern> 要素内に変数が指定されていない場合、API プロキシのデプロイは失敗します。<Pattern> 要素には、抽出されたデータが格納される変数の名前が必要です。

診断

エラーが発生した Extract Variables ポリシーの名前と、変数が存在しないパターンを特定します。これらの項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 で、要素名は /a/b です。
```
Pattern /a/b/ should have atleast one variable in ExtractVariables stepDefinition ExtractVariables-1.
    
```
失敗した Extract Variables ポリシーの XML で、<Pattern> 要素に設定されているパターンが、エラーメッセージ（上記のステップ 1）で識別されたパターンと一致することを確認します。たとえば、次のポリシーではパターン /a/b を指定し、これはエラーメッセージの内容と一致します。

たとえば、<Pattern> 要素を持つ Extract Variables ポリシーを以下に示します。
```
<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVaria>bles nam<e=&quo>t;Extra<ctVaria>bles-1&q<uot;
  >     Source<request/Source
       URI>Path
       <   Patte>rn ignoreCa<se="true"/a/{pa>thSeg<}/Patter>n
         < Pattern ignoreCase=">;true"/a/b/</Pattern>
       <   Patte>rn ignor<eCase="tr>ue"/a</b/c/{pathSeg}/>Patte<rn
       /URIPat>h
       VariablePrefixurirequest/VariablePrefix
    /ExtractVariables
    
```
ステップ 2 で特定された <Pattern> 要素に変数がないかどうかを確認します。変数は中括弧で囲む必要があります。パターンに変数がない場合、それがエラーの原因になります。

パターン /a/b を含む <Pattern> 要素に変数が含まれていないため、API プロキシのデプロイは失敗します
```
<Pattern ignoreCase=">true&<quot;/a/>b//Pattern

    
```

解決策

すべての <Pattern> 要素に変数（中括弧で囲まれた名前）が含まれるようにします。次に例を示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVaria>bles nam<e=&quo>t;Extra<ctVaria>bles-1&q<uot;
  >     Source<request/Source
       URI>Path
       <   Patte>rn ignoreCa<se="true"/a/{pa>thSeg}/Pattern<
       >   Pattern <ignoreCase="true&quo>t;/a/b/{pathSeg}</Pattern>
       <   Patte>rn ignor<eCase="tr>ue"/a</b/c/{pathSeg}/>Patte<rn
       /URIPat>h
       VariablePrefixurirequest/VariablePrefix
    /ExtractVariables

CannotBeConvertedToNodeset

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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.

スクリーンショットの例

原因

Extract Variables ポリシーに、<Variable> タイプが nodeset として定義されている <XPath> 式があるが、式を nodeset に変換できない場合、API プロキシのデプロイは失敗します。

診断

エラーが発生した Extract Variables ポリシーと、nodeset に変換できない XPath を特定します。これらの両方の項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は Extract-Variables-1 で、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.
    
```

失敗した Extract Variables ポリシーの XML で、<XPath> 要素に設定されている XPath が、エラーメッセージ（上記のステップ 1）で識別された XPath と一致することを確認します。たとえば、次のポリシーでは XPath を 123 として指定し、これはエラーメッセージの内容と一致します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError="fal>se" <enabled=&qu>ot;true" name=<"Extrac>t-Variabl<es-1"<>/span>
        D<isplayNameExtract Variables>-1/Disp<layName>
        <Properties/
  >      S<ource clearPayl>oad="<;false"request/Source
        Varia>blePrefixvisi<tor/Variabl>ePrefix
     <   XMLPayload stopPayloadProcessin>g="false&quo<t;
  >   <      > Namespaces/
<         >   Variab<le name=&qu>ot;ag<e" type=&quo>t;nodeset"
                XPath123/XPath
            /Variable
        /XMLPayload
    /ExtractVariables

上記のステップ 2 で特定された <XPath> に対応する <Variable> 要素のタイプを調べます。<Variable> タイプが nodeset の場合、それがこのエラーの原因です。

Extract Variables ポリシーの例では <XPath> 式が 123 であることに注意してください。
```
<XPath>123</XPath>
    
```
式 123 は nodeset に変換できません。したがって、API プロキシのデプロイは失敗します。

解決策

<Variable> タイプが nodeset として定義されている場合、Extract Variables ポリシーで使用される <XPath> 式を nodeset に変換できることを確認してください。次に例を示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError="fal>se" <enabled=&qu>ot;true" name=<"Extrac>t-Variabl<es-1"<>/span>
        D<isplayNameExtract Variables>-1/Disp<layName>
        <Properties/
  >      S<ource clearPayl>oad="<;false"request/Source
        Varia>blePrefixvisi<tor/Variabl>ePrefix
     <   XMLPayload stopPayloadProcessin>g="false&quo<t;
  >          Na<mespac>es/
         <   Variab>le name=&<quot;age&qu>ot; t<ype="nodeset>";
                XPath/visitor/age/XPath
            /Variable
        /XMLPayload
    /ExtractVariables

InvalidPattern

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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

スクリーンショットの例

原因

<Pattern> 要素の定義が、Extract Variables ポリシー内の URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload などのすべての要素で無効な場合、API プロキシのデプロイは失敗します。

Pattern 要素は、変数を含まない場合に無効と見なされます。パターン照合の詳細については、照合と変数の作成についてをご覧ください。

診断

エラーメッセージから、失敗した Extract Variables ポリシーを特定します。たとえば、次のエラーでは、ポリシー名は Extract-Variables-2 です。
```
Pattern {*} is invalid in ExtractVariables stepDefinition ExtractVariables-2.
    
```

失敗した Extract Variables ポリシーの XML で、URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload のいずれかの要素が存在して <Pattern> 要素を含んでいるかどうかを確認します。

たとえば、<QueryParam> 要素内に <Pattern> 要素を含む Extract Variables ポリシーの例を以下に示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVaria>bles name<="Extr>actVariables-2&quo<t;
        D>isplayNam<eExtra>ctVaria<bles-2/>DisplayNa<me
        Sourcereque>st/Source
   <     QueryParam name=&quo>t;c<ode">;
       <     Patter>n ignoreC<ase="true>"{*}</Pattern
      >  /Qu<eryParam
        >VariablePrefixqueryinfo/VariablePrefix
    /ExtractVariables

各 <Pattern> 要素の定義を調べます。無効な定義を持つ <Pattern> 要素があれば、それがエラーの原因です。

上記の Extract Variables ポリシーの例では、<QueryParam> 要素内の <Pattern> 定義が無効であるため、API プロキシのデプロイは失敗します。照合と変数の作成についてもご覧ください。
```
<Pattern ignoreCase=">tru<e"{>*}/Pattern

    
```

解決策

Extract Variables ポリシー内の URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload 要素内の <Pattern> 要素の定義が有効であるようにしてください。次に例を示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVaria>bles name<="Extr>actVariables-2"
        DisplayNa<meExtract a >value fro<m a qu>ery par<ameter/>DisplayNa<me
        Sourcereque>st/Source
   <     QueryParam name=&quo>t;code<"
 >         <  Pattern i>gnoreCase<="true&qu>ot;{code}</Pattern
      >  /Qu<eryParam
        >VariablePrefixqueryinfo/VariablePrefix
    /ExtractVariables

照合と変数の作成についてもご覧ください。

XPathCompilationFailed

エラーメッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラーメッセージが表示されます。

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

エラーメッセージの例

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.

スクリーンショットの例

原因

<XPath> 要素で使用される接頭辞または値が Extract Variables ポリシー内の宣言された名前空間の一部でない場合、API プロキシのデプロイは失敗します。

名前空間、XPath、接頭辞の詳細については、XML Namespaces and How They Affect XPath and XSLT をご覧ください。

診断

エラーが発生した Extract Variables ポリシーと、コンパイルできなかった XPath を特定します。これらの両方の項目は、エラーメッセージの中から見つけることができます。たとえば、次のエラーでは、ポリシー名は EV-XML-Age で、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.
    
```

失敗した Extract Variables ポリシーの XML で、<XPath> 要素に設定されている XPath が、エラーメッセージ（上記のステップ 1）で識別された XPath と一致することを確認します。たとえば、次のポリシーは、XPath を /apigee:Directions/apigee:route/apigee:leg/apigee:name として指定し、これはエラーメッセージの内容と一致します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError=>"f<alse" >enabled=&q<uot;true&quo>t; name<="EV-XML-Age"
   >   Disp<layName>EV-XML-<Age/DisplayName
      Source clearPayloa>d="f<alse">request/Sourc<e
      XMLPayload stopP>ayloadProcessing="<;false&quo>t;
      <  Namespace>s
       <     Namespace prefix="gmail&quo>t;http://<mail.>google.com/Namespace
        /Namespaces
        Varia<ble na>me="legN<ame"> type=&<quot;string>"<;
        XPath/a>pigee:Directions/apigee:route/apigee:leg/apigee:name/XPath
            /Variable
      /XMLPayload
    /ExtractVariables

Extract Variables ポリシーの <Namespaces> および <XPath> 要素を調べます。エラーメッセージに示された特定の <XPath> が、Extract Variables ポリシーで宣言されている名前空間の一部ではない接頭辞または値を使用する場合、これがエラーの原因です。

Extract Variables ポリシーの例では、特定の <XPath> が接頭辞 apigee を使用していることに注意してください。
```
<XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>
    
```
しかし、接頭辞 apigee はいずれの <Namespace> 要素にも定義されていないため、<XPath> のコンパイルに失敗してデプロイの失敗につながります。

解決策

<XPath> 要素で使用されているすべての名前空間が Extract Variables ポリシーで宣言されるようにします。次に例を示します。

<?xml version="1.0" encoding="UTF-8&quo>t; st<andalone="yes"?
    ExtractVariables async="false" continueOnError=>"f<alse" >enabled=&q<uot;true&quo>t; name<="EV-XML-Age"
   >   Disp<layName>EV-XML-<Age/DisplayName
      Source clearPayloa>d="f<alse">request/Sourc<e
      XMLPayload stopPa>yloadProcessing="<;false&quo>t;
        Na<mespaces
            Nam>espace prefix="ap<igee">http://ww<w.apigee.co>m/Namespa<ce
            Namespace prefix=">;gmail"h<ttp:/>/mail.google.com/Namespace
        /Namespaces
       < Varia>ble name=<"leg>Name&qu<ot; type=&q>uot;s<tring"
     >       XPath/apigee:Directions/apigee:route/apigee:leg/apigee:name/XPath
        /Variable
      /XMLPayload
    /ExtractVariables

Extract Variables ポリシーのデプロイエラーのトラブルシューティング

NothingToExtract

エラー メッセージ

原因

診断

解決策

NONEmptyPrefixMappedToEmptyURI

エラー メッセージ

原因

診断

解決策

DuplicatePrefix

エラー メッセージ

原因

診断

解決策

NoXPathsToEvaluate

エラー メッセージ

原因

診断

解決策

EmptyXPathExpression

エラー メッセージ

原因

診断

解決策

NoJSONPathsToEvaluate

エラー メッセージ

原因

診断

解決策

EmptyJSONPathExpression

エラー メッセージ

原因

診断

解決策

MissingName

エラー メッセージ

原因

診断

解決策

PatternWithoutVariable

エラー メッセージ

原因

診断

解決策

CannotBeConvertedToNodeset

エラー メッセージ

原因

診断

解決策

InvalidPattern

エラー メッセージ

原因

診断

解決策

XPathCompilationFailed

エラー メッセージ

原因

診断

解決策

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ

エラーメッセージ