您正在查看 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)\""
解析度
確保傳遞至 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 ('<') 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 ('<') 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 ('<') character\""
解析度
確保傳遞至 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><Life></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></Life></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>