擷取變數政策部署作業時發生錯誤

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

NothingToExtract

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數政策」沒有任何 URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload 元素，API Proxy 部署作業就會失敗，因為沒有任何內容可供擷取。

如錯誤訊息所示，「擷取變數」政策必須至少包含下列其中一個元素：URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload。

診斷

檢查錯誤訊息中提及的「擷取變數」政策。如果政策缺少下列任一元素：URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload，就會導致錯誤。舉例來說，下列「擷取變數」政策不含上述任何元素：

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

由於 Extract Variables 政策中沒有任何必要元素，因此 API Proxy 部署作業會失敗。

解析度

請確認「擷取變數」政策至少包含下列其中一個必要元素：URIPath、QueryParam、Header、FormParam、XMLPayload、JSONPayload。例如：

<?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 Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數」政策在 <Namespace> 元素下的 <XMLPayload> 元素中定義了前置字元，但未定義 URI，就會發生這項錯誤。

診斷

1. 找出發生錯誤的「擷取變數」政策和前置字元名稱。您可以在錯誤訊息中找到這兩項資訊。舉例來說，在下列錯誤中，政策名稱為 EV-XML-Age，前置字元為 apigee：

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

2. 在失敗的「擷取變數」政策 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>
   

3. 驗證在步驟 #2 中識別的特定前置字元<Namespace>是否具有有效的 URI。如果缺少 URI，就是造成錯誤的原因。

   在上述「擷取變數」政策範例中，請注意，沒有對應於前置字串為 apigee 的 <Namespace> 元素的 URI，因此您會收到下列錯誤訊息：

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

解析度

請確認以前置字串定義的所有 <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 Proxy 時失敗，並顯示這則錯誤訊息：

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

錯誤訊息範例

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

範例螢幕截圖

原因

如果「擷取變數政策」在 <XMLPayload> 元素下的 <Namespace> 元素中，定義了多次相同的前置字元，就會發生這項錯誤。

舉例來說，由於前置字元 apigee 定義了兩次，因此會發生這項錯誤，如下所示：

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

診斷

1. 找出發生錯誤的「擷取變數」政策和前置字元名稱。您可以在錯誤訊息中找到這兩項資訊。舉例來說，在下列錯誤中，政策名稱為 EV-XML-Age，前置字元為 apigee：

   ExtractVariables EV-XML-Age: Duplicate prefix apigee.
   

2. 在失敗的「擷取變數」政策 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="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>
   

3. 判斷是否已多次定義具有特定前置字元的 <Namespace> 元素 (步驟 2 中識別)。如果定義超過一次，就是造成錯誤的原因。

   在上方顯示的「擷取變數」政策範例中，請注意，前置字元為 apigee 的 <Namespace> 元素已定義兩次，因此您會收到下列錯誤訊息：

   ExtractVariables EV-XML-Age: Duplicate prefix apigee.
   
   

解析度

請確認「擷取變數」政策的 <Namespace> 元素中，每個前置字元只有一個定義。例如：

<?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 Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數」政策的 <XMLPayload> 元素中沒有 <XPath> 元素，API Proxy 部署作業就會失敗，並顯示上述錯誤。

診斷

1. 從錯誤訊息中找出失敗的「擷取變數」政策。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1：

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

2. 在失敗的「擷取變數」政策 XML 中，檢查是否有不含 <XPath> 子元素的 <XMLPayload> 元素。如果是，這就是錯誤原因。

   舉例來說，以下是含有 <XMLPayload> 元素的「擷取變數」政策：

   <?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 Proxy 部署作業會失敗。

解析度

確認 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 Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數政策」的 <XMLPayload> 元素內有空白的 <XPath> 運算式，API Proxy 的部署作業就會失敗。

診斷

1. 從錯誤訊息中找出失敗的「擷取變數」政策。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1：

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

2. 在失敗的「擷取變數」政策 XML 中，判斷是否有 <XMLPayload> 元素含有空白的 <XPath> 子項元素。如果是，這就是錯誤原因。

   舉例來說，以下是含有 <XMLPayload> 元素的「擷取變數」政策：

   <?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 Proxy 部署作業會失敗。

解析度

確認「擷取變數」政策在 <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 Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數」政策的 <JSONPayload> 元素中沒有 <JSONPath> 元素，API Proxy 部署作業就會失敗，並顯示上述錯誤。

診斷

1. 從錯誤訊息中找出失敗的「擷取變數」政策。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1：

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

2. 在失敗的「擷取變數」政策 XML 中，判斷是否有缺少必要 <JSONPath> 子元素的 <JSONPayload> 元素。如果是，這就是錯誤原因。

   舉例來說，以下是含有 <JSONPayload> 元素的「擷取變數」政策：

   <?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 Proxy 部署作業會失敗。

解析度

確認「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 Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數政策」的 <JSONPayload> 元素內有空白的 <JSONPath> 運算式，API Proxy 的部署作業就會失敗。

診斷

1. 從錯誤訊息中找出失敗的「擷取變數」政策。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1：

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

2. 在失敗的「擷取變數」政策 XML 中，確認是否有 <JSONPayload> 元素，且該元素含有空白的 <JSONPath> 子元素。如果是，這就是錯誤原因。

   舉例來說，以下是含有 <JSONPayload> 元素的「擷取變數」政策：

       <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
           <DisplayName>Extract Variables-1</DisplayName>
           <Properties/>
           <JSONPayload>
               <Variable name="account_number" type="integer">
                   <JSONPath></JSONPath>
               </Variable>
           </JSONPayload>
           <Source clearPayload="false">request</Source>
           <VariablePrefix>apigee</VariablePrefix>
       </ExtractVariables>
   

   由於 <JSONPayload> 元素內有空白的 <JSONPath> 元素，因此 API Proxy 部署作業會失敗。

解析度

確認「擷取變數」政策在 <JSONPayload> 元素下定義了非空白的有效 <JSONPath> 元素。例如：

<ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract-Variables-1">
    <DisplayName>Extract Variables-1</DisplayName>
    <Properties/>
    <JSONPayload>
        <Variable name="account_number" type="integer">
           <JSONPath>$.account.number</JSONPath>
        </Variable>
    </JSONPayload>
    <Source clearPayload="false">request</Source>
    <VariablePrefix>apigee</VariablePrefix>
</ExtractVariables>

MissingName

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示這則錯誤訊息：

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 Proxy 的部署作業就會失敗。

舉例來說，如果 Variable 元素缺少 name 屬性，就會發生這個錯誤。

診斷

1. 找出發生錯誤的「擷取變數」政策名稱，以及缺少 name 屬性的元素。您可以在錯誤訊息中找到這些項目。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1，元素名稱為 Variable：

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

2. 在失敗的「擷取變數」政策 XML 中，確認所有名稱由上述步驟 1 決定的元素都有 name 屬性。如果任何元素缺少名稱屬性，就是造成錯誤的原因。

   舉例來說，下列「擷取變數」政策定義了 <Variable> 元素：

   <?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/>
       <Variable type="boolean">
           <Pattern>{isAccountActive}</Pattern>
       </Variable>
   </ExtractVariables>
   

   請注意，Variable 元素中缺少 name 屬性，因此 API Proxy 部署作業會失敗。

解析度

請確認「擷取變數政策」包含 QueryParam、Header、FormParam 或 Variable 元素所需的 name 屬性。例如：

<?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/>
    <Variable name="account_active" type="boolean">
        <Pattern>{isAccountActive}</Pattern>
    </Variable>
</ExtractVariables>

PatternWithoutVariable

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示這則錯誤訊息：

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

錯誤訊息範例

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

範例螢幕截圖

原因

如果「擷取變數」政策的 <Pattern> 元素中未指定變數，API Proxy 部署作業就會失敗。<Pattern> 元素需要變數名稱，擷取的資料會儲存在該變數中。

診斷

1. 找出發生錯誤的「擷取變數」政策名稱，以及缺少變數的模式。您可以從錯誤訊息中找到這些項目。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-1，元素名稱為 /a/b：

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

2. 在失敗的「擷取變數」政策 XML 中，確認 <Pattern> 元素中設定的模式與錯誤訊息中識別的模式 (上述步驟 1) 相符。舉例來說，下列政策指定了 /a/b 模式，與錯誤訊息中的內容相符：

   舉例來說，以下是含有三個 <Pattern> 元素的「擷取變數」政策：

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ExtractVariables name="ExtractVariables-1">
      <Source>request</Source>
      <URIPath>
         <Pattern ignoreCase="true">/a/{pathSeg}</Pattern>
         <Pattern ignoreCase="true">/a/b/</Pattern>
         <Pattern ignoreCase="true">/a/b/c/{pathSeg}</Pattern>
      </URIPath>
      <VariablePrefix>urirequest</VariablePrefix>
   </ExtractVariables>
   

3. 檢查步驟 2 中識別的 <Pattern> 元素是否沒有變數。變數必須以大括號括住。如果模式沒有變數，就是造成錯誤的原因。

   具有 /a/b 模式的 <Pattern> 元素不含變數，因此 API Proxy 部署作業會失敗

   <Pattern ignoreCase="true">/a/b/</Pattern>
   
   

解析度

請確認所有 <Pattern> 元素都包含變數 (以大括號括住的名稱)。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<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>
</ExtractVariables>

CannotBeConvertedToNodeset

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果「擷取變數」政策含有 <XPath> 運算式，且 <Variable> 類型定義為 nodeset，但運算式無法轉換為節點集，則 API Proxy 部署作業會失敗。

診斷

1. 找出發生錯誤的「擷取變數」政策，以及無法轉換為節點集的 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.
   

2. 在失敗的「擷取變數」政策 XML 中，確認 <XPath> 元素中設定的 XPath 與錯誤訊息中識別的 XPath (上述步驟 1) 相符。舉例來說，下列政策會將 指定為 123，與錯誤訊息中的內容相符：

   <?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>visitor</VariablePrefix>
       <XMLPayload stopPayloadProcessing="false">
           <Namespaces/>
           <Variable name="age" type="nodeset">
               <XPath>123</XPath>
           </Variable>
       </XMLPayload>
   </ExtractVariables>
   

3. 檢查與上述步驟 2 中識別的 <XPath> 對應的 <Variable> 元素類型。如果 <Variable> 類型為 nodeset，就是導致錯誤的原因。

   請注意，在「擷取變數」政策範例中，<XPath> 運算式為 123。

   <XPath>123</XPath>
   

   運算式 123 無法轉換為節點集。因此 API Proxy 部署作業會失敗。

解析度

如果 <Variable> 類型定義為節點集，請確保 Extract Variables 政策中使用的 <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>visitor</VariablePrefix>
    <XMLPayload stopPayloadProcessing="false">
        <Namespaces/>
        <Variable name="age" type="nodeset">
            <XPath>/visitor/age</XPath>
        </Variable>
    </XMLPayload>
</ExtractVariables>

InvalidPattern

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示這則錯誤訊息：

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.

範例螢幕截圖

原因

如果 Extract Variables Policy 中任何元素 (例如 URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload) 的 <Pattern> 元素定義無效，API Proxy 的部署作業就會失敗。

診斷

1. 從錯誤訊息中找出失敗的「擷取變數」政策。舉例來說，在下列錯誤中，政策名稱為 Extract-Variables-2：

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

2. 在失敗的「擷取變數」政策 XML 中，檢查是否含有下列任一元素，並加入 <Pattern> 元素：URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload。

   舉例來說，以下是「擷取變數」政策範例，其中 <QueryParam> 元素內含有 <Pattern> 元素：

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ExtractVariables name="ExtractVariables-2">
       <DisplayName>ExtractVariables-2</DisplayName>
       <Source>request</Source>
       <QueryParam name="code">
           <Pattern ignoreCase="true">{*}</Pattern>
       </QueryParam>
       <VariablePrefix>queryinfo</VariablePrefix>
   </ExtractVariables>
   

3. 檢查每個 <Pattern> 元素的定義。如果任何 <Pattern> 元素含有無效定義，就會導致錯誤。

   在上述「擷取變數」政策範例中，請注意 <QueryParam> 元素內的 <Pattern> 定義無效，因此 API Proxy 部署作業會失敗。另請參閱 關於比對和變數建立

   <Pattern ignoreCase="true">{*}</Pattern>
   
   

解析度

請確認「擷取變數」政策中，元素 URIPath、QueryParam、Header、FormParam、XMLPayload 或 JSONPayload 內的 <Pattern> 元素定義是否有效。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables name="ExtractVariables-2">
    <DisplayName>Extract a value from a query parameter</DisplayName>
    <Source>request</Source>
    <QueryParam name="code">
        <Pattern ignoreCase="true">{code}</Pattern>
    </QueryParam>
    <VariablePrefix>queryinfo</VariablePrefix>
</ExtractVariables>

另請參閱「關於比對和變數建立」

XPathCompilationFailed

錯誤訊息

透過 Edge UI 或 Edge 管理 API 部署 API Proxy 時失敗，並顯示以下錯誤訊息：

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> 元素中使用的前置字元或值不屬於「擷取變數」政策中宣告的任何命名空間，API Proxy 的部署作業就會失敗。

如要進一步瞭解命名空間、XPath 和前置字串，請參閱「XML Namespaces and How They Affect XPath and XSLT」。

診斷

1. 找出發生錯誤的「擷取變數」政策，以及無法編譯的 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.
   

2. 在失敗的「擷取變數」政策 XML 中，確認 <XPath> 元素中設定的 XPath 與錯誤訊息中識別的 XPath (上述步驟 1) 相符。舉例來說，下列政策會將 指定為 /apigee:Directions/apigee:route/apigee:leg/apigee:name，與錯誤訊息中的內容相符：

   <?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>
       </Namespaces>
       <Variable name="legName" type="string">
       <XPath>/apigee:Directions/apigee:route/apigee:leg/apigee:name</XPath>
           </Variable>
     </XMLPayload>
   </ExtractVariables>
   

3. 檢查「擷取變數」政策中的 <Namespaces> 和 <XPath> 元素。如果錯誤訊息中指出的特定 <XPath> 使用的前置字元或值，並非「擷取變數」政策中宣告的命名空間，就會導致錯誤。

   請注意，在「擷取變數」政策範例中，特定 <XPath> 使用前置字串 apigee。

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

   不過，任何 <Namespace> 元素中都未定義前置字元 apigee，因此 <XPath> 編譯失敗，導致部署失敗。

解析度

確認 <XPath> 元素中使用的所有命名空間，都已在「擷取變數」政策中宣告。例如：

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