本頁面由 Cloud Translation API 翻譯而成。

XSL 轉換政策執行階段錯誤疑難排解

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。資訊

XSLSourceMessageNotAvailable

錯誤代碼

steps.xsl.XSLSourceMessageNotAvailable

錯誤回應主體

{
    "fault": {
        "faultstring": "response message is not available for XSL: policy_name",
        "detail": {
            "errorcode": "steps.xsl.XSLSourceMessageNotAvailable"
        }
    }
}

錯誤訊息範例

{
    "fault": {
        "faultstring": "response message is not available for XSL: xslt",
        "detail": {
            "errorcode": "steps.xsl.XSLSourceMessageNotAvailable"
        }
    }
}

原因

如果在 XSL 轉換政策的 <Source> 元素中指定 message 或字串變數，就會發生這個錯誤：

超出範圍 (不適用於執行政策的特定流程)
無法解析 (未定義)

例如，如果 XSL 轉換政策應在要求流程中執行，但 <Source> 元素設為回應變數，但要求流程中並不存在，就會發生這個錯誤。

診斷

找出發生錯誤的 XSL 轉換政策和無法使用的變數名稱。您可以在錯誤回應的 faultstring 元素中找到這兩個項目。舉例來說，在下列 faultstring 中，政策名稱為 xslt，變數則為 response：
```
faultstring": "response message is not available for XSL: xslt
```

在失敗的 XSL 轉換政策 XML 中，驗證 <Source> 元素中設定的變數名稱是否與錯誤字串中識別的變數名稱相符 (上述步驟 #1)。例如，下列 XSL 轉換政策在 <Source> 元素中指定名為 response 的變數，該變數與錯誤字串中的內容相符：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <XSL async="false" continueOnError="false" enabled="true" name="xslt">
  <DisplayName>xslt</DisplayName>
      <Properties/>
      <ResourceURL>xsl://XSL-Transform.xsl</ResourceURL>
      <Source>response</Source>
      <Parameters ignoreUnresolvedVariables="false"/>
     <OutputVariable/>
</XSL>

確定 <Source> 元素中使用的變數是否已定義，且能在執行 XSL 轉換政策的流程中使用。
如果該變數為其中一種：
- 在範圍外 (不適用於執行政策的特定流程) 或
- 無法解析 (未定義)
才是發生錯誤的原因

例如，假設上述的 XSL 轉換政策應該在要求流程中執行。提醒您，在範例政策的 <Source> 元素中使用 response 變數。response 變數僅適用於回應流程。

由於要求流程中不存在 response 變數，因此您會收到錯誤代碼：
```
steps.xsl.XSLSourceMessageNotAvailable
```

解析度

確保在失敗的 XSL 轉換政策的 <Source> 元素中設定變數，並存在於執行政策的流程中。

如要修正上述範例 XSL 轉換政策，您可以將 <Source> 元素修改為使用 request 變數，因為該變數存在於要求流程中：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <XSL async="false" continueOnError="false" enabled="true" name="xslt">
  <DisplayName>xslt</DisplayName>
    <Properties/>
    <ResourceURL>xsl://XSL-Transform.xsl</ResourceURL>
    <Source>request</Source>
    <Parameters ignoreUnresolvedVariables="false"/>
   <OutputVariable/>
</XSL>

XSLEvaluationFailed

錯誤代碼

steps.xsl.XSLEvaluationFailed

錯誤回應主體

{
  "fault": {
      "faultstring": "Evaluation of XSL <var>XSL_file_name</var> failed with reason: \"<var>reason_for_failure</var>",
      "detail": {
          "errorcode": "steps.xsl.XSLEvaluationFailed"
      }
  }
}

錯誤訊息範例

{
    "fault": {
        "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Premature end of document while parsing at line 1(possibly  around char 0)\"",
        "detail": {
            "errorcode": "steps.xsl.XSLEvaluationFailed"
        }
    }
}

可能原因

發生以下狀況時會出現這個錯誤：

輸入內容 XML 酬載無法使用/格式錯誤。
XSLTransform 政策無法/無法依據 XSL 檔案提供的轉換規則轉換輸入 XML 檔案。XSLTransform 政策失敗的原因可能有很多。錯誤訊息中失敗的原因會提供原因詳細資訊。下表列出造成此失敗的一個原因 - 前置字串無效。請參考以下範例。

原因	說明
輸入內容 XML 酬載無法使用	輸入的 XML 酬載未傳遞或為空白。
輸入 XML 格式錯誤	輸入的 XML 酬載格式錯誤或無效。
前置字元無效	輸入內容 XML 酬載的前置字串未在 XSL 檔案定義。

原因：無法取得輸入內容的 XML 酬載

如果未傳遞輸入內容 XML 酬載，或是將 XML 酬載做為 API 要求的一部分傳遞給具有 XSLTransform 政策的 API Proxy，就會發生這個錯誤。

錯誤訊息範例

{
    "fault": {
        "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Premature end of document while parsing at line 1(possibly  around char 0)\"",
        "detail": {
            "errorcode": "steps.xsl.XSLEvaluationFailed"
        }
    }
}

診斷

找出 XML 轉換政策無法評估的 XSL 檔案，以及失敗的原因。如果輸入的 XML 酬載未傳遞或為空白，失敗原因就會顯示剖析時文件處於前期。您可以在錯誤回應的 faultstring 元素中找到所有這些資訊。例如，在下列 faultstring 中，XSL 檔案為 XSL-Transform.xsl，失敗原因為 Premature end of document while parsing at line 1 (possibly around char 0)。該錯誤表示 XML 酬載未傳遞或空白。
```
    "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Premature end of document while parsing at line 1(possibly  around char 0)\""
```
判斷在要求中傳遞的輸入 XML 酬載是否為空白。如果未傳遞輸入酬載或為空白，就是發生錯誤的原因。

在下面的要求範例中，使用者傳送的要求酬載 (也就是要求主體) 為空白。

例如：
```
curl -v "http://<org>-<env>.apigee.net/v1/xsltransform" -H "Content-Type: application/xml"
```
由於 XML 輸入酬載為空白，您會收到以下錯誤：
```
"faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Premature end of document while parsing at line 1(possibly  around char 0)\""
```
注意： 來源訊息的 HTTP 內容類型標頭必須設為 application/xml，否則政策一律會傳回成功。

解析度

確保傳遞至 XSLTransform 政策的輸入是有效的 XML 酬載，且不得空白。

如要修正 XSLTransform 政策範例的問題，請傳遞有效的 XML 酬載。例如：

建立名為 city.xml 的檔案，並在當中加入下列內容：

<?xml version="1.0" encoding="UTF-8"?>
<root>
   <City>Bengaluru</City>
   <Name>Apigee</Name>
   <Pincode>560016</Pincode>
</root>

使用 cURL 指令發出 API 呼叫，如下所示：

curl -v "http://<org>-<env>.apigee.net/v1/xsltransform" -H "Content-Type: application/xml" -X POST -d @city.xml

原因：輸入 XML 格式錯誤

在 XSLTransform 政策的 API 要求中，傳遞的輸入 XML 酬載格式錯誤或無效。

錯誤訊息範例

{
    "fault": {
        "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unexpected char while looking for open tag ('&lt;') character\"",
        "detail": {
            "errorcode": "steps.xsl.XSLEvaluationFailed"
        }
    }
}

診斷

找出 XML 轉換政策無法評估的 XSL 檔案，以及失敗的原因。如果輸入的 XML 酬載格式錯誤，故障的原因可能表示有非預期的字元。您可以在錯誤回應的 faultstring 元素中找到所有這些資訊。例如，在下列 faultstring 中，XSL 檔案為 XSL-Transform.xsl，失敗的原因為 Unexpected char while looking for open tag ('<') character。也就是說，XML 酬載缺少「<」。
```
"faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unexpected char while looking for open tag ('&lt;') character\""
```
檢查傳送至 XSLTransform 政策的輸入 XML 酬載，確認其是否包含有效的 XML 內容。如果輸入酬載不是有效的 XML，這就是錯誤的原因。

在下面的要求範例中，使用者傳送的輸入酬載 (也就是要求主體) 無效。

例如：
```
curl -v "http://<org>-<env>.apigee.net/v1/xsltransform" -H "Content-Type: application/xml" -X POST -d @city.xml
```
其中 city.xml 為：
```
{
   "City": "Bengaluru",
   "Name": "Apigee",
   "Pincode": "560016"
}
```
由於輸入酬載為 JSON 且不是有效的 XML，您會收到以下錯誤：
```
"faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unexpected char while looking for open tag ('&lt;') character\""
```
注意： 來源訊息的 HTTPContent-type 標頭必須設為 application/xml，否則政策一律會傳回成功。

解析度

確保傳遞至 XSLTransform 政策的輸入是有效的 XML 酬載，且不得空白。

如要修正 XSLTransform 政策範例的問題，請傳遞有效的 XML 酬載。例如：

修改 city.xml 檔案，使其包含 XML 中的內容，如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<root>
   <City>Bengaluru</City>
   <Name>Apigee</Name>
   <Pincode>560016</Pincode>
</root>

使用 cURL 指令發出 API 呼叫，如下所示：

curl -v "http://<org>-<env>.apigee.net/v1/xsltransform" -H "Content-Type: application/xml" -X POST -d @city.xml

原因：前置字元無效

傳送至 XSLTransform 政策的輸入 XML 酬載，在政策中指定的 XSL 檔案未定義為前置字串的元素。

錯誤訊息範例

{
    "fault": {
        "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unresolved Prefix at line 1(possibly  around char 270)\"",
        "detail": {
            "errorcode": "steps.xsl.XSLEvaluationFailed"
        }
    }
}

診斷

找出 XML 轉換政策無法評估的 XSL 檔案，以及失敗原因。在此情況下，失敗原因表示輸入 XML 酬載中的特定行號含有未解析的前置字元。您可以在錯誤回應的 faultstring 元素中找到所有這些資訊。例如，在下列 faultstring 中，XSL 檔案為 XSL-Transform.xsl，失敗原因為 Unresolved Prefix，行數為 1。
```
"faultstring":"Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unresolved Prefix at line 1(possibly  around char 270)\""
```

檢查 XSL 檔案的內容 (識別在上述步驟 #1 中) 以及輸入 XML 酬載。如果 XSL 檔案中沒有在輸入 XML 酬載的行號 (識別上述步驟 #1) 中使用的前置字串，這就是發生錯誤的原因。

以下是造成錯誤的 XSL 範例和對應的 XML 酬載：

XSL-Transform.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:output method="text"/>
  <xsl:variable name="newline">
   <xsl:text>
   </xsl:text>
  </xsl:variable>
  <xsl:template match="/">
  <xsl:text>&lt;Life&gt;</xsl:text>
    <xsl:value-of select="$newline"/>
    <xsl:text>Here are the odd-numbered items from the list:</xsl:text>
    <xsl:value-of select="$newline"/>
    <xsl:for-each select="list/listitem">
      <xsl:if test="(position() mod 2) = 1">
        <xsl:number format="1. "/>
        <xsl:value-of select="."/>
        <xsl:value-of select="$newline"/>
      </xsl:if>
    </xsl:for-each>
  <xsl:text>&lt;/Life&gt;</xsl:text>
</xsl:template>
</xsl:stylesheet>

輸入 XML 酬載

<?xml version="1.0"?>
<Life:Books>
  <title>A few of my favorite albums</title>
  <listitem>Beat Crazy</listitem>
  <listitem>Here Come the Warm Jets</listitem>
  <listitem>Kind of Blue</listitem>
  <listitem>London Calling</listitem>
</Life:Books>

上方所示的 XML 酬載範例包含 <Life:Books> 元素。請注意，XSL 沒有這個前置字元。而是前置字串為 <xsl:text><Life></xsl:text>。因此您會收到錯誤訊息：

"faultstring":"Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unresolved Prefix at line 1(possibly  around char 270)\""

解析度

確認傳送至 XSLTransform 政策的輸入 XML 酬載，包含所有在政策使用的 XSL 檔案中定義為前置字串的所有元素格式。

如要修正上述 XML 範例檔案，您可以修改該檔案，如下所示：

已更新 Input XML 酬載

<?xml version="1.0"?>
<Life>
  <title>A few of my favorite albums</title>
  <listitem>Beat Crazy</listitem>
  <listitem>Here Come the Warm Jets</listitem>
  <listitem>Kind of Blue</listitem>
  <listitem>London Calling</listitem>
</Life>