XSLTransform 政策

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

結果

XSL 轉換政策會將自訂的可延伸樣式表語言轉換 (XSLT) 套用至 XML 訊息，可讓您從 XML 轉換成其他格式，例如 XML、HTML 或 plain (純文字) 文字。這項政策通常用於整合支援 XML 但需要 為相同資料套用不同的 XML 格式

範例

下列範例顯示 XSL 轉換流程中的所有資源。

XSL 政策 ->

<XSL name="TransformXML">
  <ResourceURL>xsl://my_transform.xsl</ResourceURL>
  <Source>request</Source>
</XSL>

簡易 XSL 政策。前往下一個範例，查看 政策 (my_transform.xsl)。<Source> 元素非常重要。 舉例來說，如果回應中包含您要轉換的 XML，則轉換不會 除非您將來源設為 response (且政策已附加至 回應流程)。但在這個例子中，要轉換的 XML 是在要求中。

XSLT 樣式表 ->

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

政策所參照的 my_transform.xsl 樣式表。前往下一個 查看傳入 XML 訊息的範例。

訊息 ->

<?xml version="1.0"?>
<list>
  <title>A few of my favorite albums</title>
  <listitem>A Love Supreme</listitem>
  <listitem>Beat Crazy</listitem>
  <listitem>Here Come the Warm Jets</listitem>
  <listitem>Kind of Blue</listitem>
  <listitem>London Calling</listitem>
  <listitem>Remain in Light</listitem>
  <listitem>The Joshua Tree</listitem>
  <listitem>The Indestructible Beat of Soweto</listitem>
</list>

要求中的範例訊息 (註明政策的 <Source>request</Source> 元素)。

已轉換的訊息

<Life>
Here are the odd-numbered items from the list:
1. A Love Supreme
3. Here Come the Warm Jets
5. London Calling
7. The Joshua Tree
</Life>

這些範例的 XSLT 樣式表之後的轉換訊息會套用至 XML 撰寫新的電子郵件訊息

元素參照

使用下列元素設定 XSL 轉換政策。

欄位名稱 說明
名稱 (必要) 政策名稱。名稱中可使用的字元僅限於： A-Z0-9._\-$ %。不過，管理 UI 會強制執行其他限制， 例如自動移除非英數字元
來源 (選填) 包含需要擷取資訊的訊息。這個值通常為 設為 request 或 response，取決於發送訊息的對象 轉換為內式或傳出的轉換
  • 如果缺少來源，系統會將其視為簡易訊息。例如：<Source>message</Source>
  • 如果無法解析來源變數，或是無法解析為非訊息類型， 轉換步驟失敗
輸出變數 (選用)

儲存轉換輸出內容的變數。輸出變數不得 訊息類型，即不能是「message」、「request」或「response」。請 請將此元素設為自訂變數，然後取用該變數。

如要以轉換的輸出內容取代訊息內容，請刪除 元素。舉例來說，如果您要將訊息轉換為 HTML，請勿加入這段程式碼， 元素。
ResourceURL (Mandatory) 要用來轉換訊息的 XSLT 檔案。
參數 (選用) 忽略未解析的變數 (選用)
忽略 XSLT 指令碼指示中任何未解決的變數錯誤。
有效值：true/false
預設值為 false。
參數 (選用) 名稱 (必要)

參數支援在樣式表中使用 XSL 參數，也就是您要新增名稱 這裡是 XSL 參數的名稱舉例來說，如果您輸入名稱 「uid」則範例如下：<xsl:param name="uid" select="''"/>)。

參數會從結構定義變數的參照取得值 (使用 ref 屬性) 或明確的 value。

如需範例和更多資訊，請參閱 http://community.apigee.com/questions/1860/how-should-the-the-optional-parameters-on-the-xsl.html#answer-1864。
參考資料 (選填)

指定從變數中取得值的參照。舉例來說 &quot;uid&quot;參數的值必須從名為「authn.uid」的變數取得， 元素看起來會像這樣：<Parameter name="uid" ref="authn.uid"/>

使用這項屬性時，請勿使用值屬性。
值 (選填)

您可以使用這項屬性，對參數值進行硬式編碼。

加入這項屬性時，請勿使用 ref 屬性。

使用須知

XSLT 會在獨立的 .xsl 檔案中實作，該檔案會儲存在 API 中 位於 /resources/xsl 下。XSL 政策只會參照 XSL 檔案。詳情請見 資源檔案。

XSL 政策需要兩個輸入內容：

  • XSLT 樣式表的名稱，其中包含一組轉換規則，儲存於 /resources/xsl 下的 API Proxy
  • 要轉換的 XML 來源 (通常是要求或回應訊息)

不支援 <xsl:include> 和 <xsl:import>。

Apigee Edge 仰賴 Saxon XSLT 處理器，並且支援 XSLT 1.0 和 2.0。

錯誤參考資料

Runtime errors

These errors can occur when the policy executes.

Fault code HTTP status Cause Fix
steps.xsl.XSLSourceMessageNotAvailable 500 This error occurs if the message or string variable specified in the <Source> element of the XSL Transform policy is either out of scope (not available in the specific flow where the policy is being executed) or can't be resolved (is not defined).
steps.xsl.XSLEvaluationFailed 500 This error occurs if the input XML payload is unavailable/malformed or the XSLTransform policy fails/is unable to transform the input XML file based on the transformation rules provided in the XSL file. There could be many different causes for the XSLTransform policy to fail. The reason for failure in the error message will provide more information on the cause.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Error name Cause Fix
XSLEmptyResourceUrl If the <ResourceURL> element in the XSL Transform policy is empty, then the deployment of the API proxy fails.
XSLInvalidResourceType If the resource type specified in the <ResourceURL> element of the XSL Transform policy is not of type xsl, then the deployment of the API proxy fails.

相關主題