นโยบาย XSLTransform

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล

อะไร

นโยบายการเปลี่ยนรูปแบบ XSL จะใช้การเปลี่ยนรูปแบบภาษาของสไตล์ชีต (XSLT) ที่ขยายได้กับ ข้อความ XML ช่วยให้คุณเปลี่ยนรูปแบบจาก XML เป็นรูปแบบอื่น เช่น XML, HTML หรือข้อความธรรมดา ข้อความ นโยบายนี้มักจะใช้เพื่อผสานรวมแอปพลิเคชันที่รองรับ XML แต่จำเป็นต้องใช้ รูปแบบ XML ที่แตกต่างกันสำหรับข้อมูลเดียวกัน

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงทรัพยากรทั้งหมดในขั้นตอนการเปลี่ยนรูปแบบ XSL

นโยบาย XSL ->สไตล์ชีต XSLT ->ข้อความ ->ข้อความที่เปลี่ยนรูปแบบ 
<XSL name="TransformXML">
  <ResourceURL>xsl://my_transform.xsl</ResourceURL>
  <Source>request</Source>
</XSL>

นโยบาย XSL อย่างง่าย ไปที่ตัวอย่างถัดไปเพื่อดูสไตล์ชีต XSLT ที่อ้างอิงใน (my_transform.xsl) องค์ประกอบ <Source> มีความสำคัญ ตัวอย่างเช่น หาก XML ที่คุณต้องการเปลี่ยนรูปแบบอยู่ในคำตอบ การเปลี่ยนรูปแบบจะไม่ เว้นแต่คุณจะตั้งค่าแหล่งที่มาเป็น response (และแนบนโยบายไว้กับ ลำดับการตอบกลับ) แต่ในกรณีนี้ XML ที่จะเปลี่ยนรูปแบบอยู่ในคำขอดังกล่าว

<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>ข้อความ</Source>
  • หากตัวแปรแหล่งที่มาไม่สามารถแก้ไข หรือแก้ไขเป็นประเภทที่ไม่ใช่ข้อความ ขั้นตอนการเปลี่ยนรูปแบบไม่สำเร็จ
ตัวแปรเอาต์พุต (ไม่บังคับ)

ตัวแปรที่จัดเก็บเอาต์พุตของการเปลี่ยนรูปแบบ ตัวแปรเอาต์พุตไม่สามารถ ประเภทข้อความ กล่าวคือ ต้องไม่เป็น "ข้อความ" "คำขอ" หรือ "ตอบกลับ" คุณควร ให้ตั้งค่าองค์ประกอบนี้เป็นตัวแปรที่กำหนดเอง แล้วใช้ตัวแปรนั้น

หากต้องการแทนที่เนื้อหาข้อความด้วยเอาต์พุตของการเปลี่ยนรูปแบบ ให้ลบข้อความนี้ ตัวอย่างเช่น หากคุณกำลังเปลี่ยนรูปแบบข้อความเป็น HTML โปรดอย่ารวม URL นี้

ResourceURL (บังคับ) ไฟล์ XSLT ที่จะใช้สำหรับเปลี่ยนรูปแบบข้อความ
พารามิเตอร์ (ไม่บังคับ) หากไม่แก้ไขตัวแปร (ไม่บังคับ)
ไม่ประมวลผลข้อผิดพลาดตัวแปรที่ยังไม่ได้แก้ไขในคำแนะนำสคริปต์ XSLT
ค่าที่ใช้ได้: true/false
ค่าเริ่มต้น: false
พารามิเตอร์ (ไม่บังคับ) ชื่อ (บังคับ)

พารามิเตอร์รองรับการใช้พารามิเตอร์ XSL ในสไตล์ชีต ซึ่งชื่อที่คุณเพิ่ม ในนโยบายคือชื่อของพารามิเตอร์ XSL ตัวอย่างเช่น หากคุณป้อนชื่อ "uid" XSL ของคุณอาจมีลักษณะดังนี้ <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
ref (ไม่บังคับ)

ระบุการอ้างอิงที่ดึงค่ามาจากตัวแปร ตัวอย่างเช่น หาก &quot;uid&quot; พารามิเตอร์จำเป็นต้องรับค่าของพารามิเตอร์จากตัวแปรที่ชื่อ "authn.uid" ซึ่งเป็นพารามิเตอร์ องค์ประกอบจะมีลักษณะดังนี้: <Parameter name="uid" ref="authn.uid"/>

หากใช้แอตทริบิวต์นี้ อย่าใช้แอตทริบิวต์นี้
value (ไม่บังคับ)

คุณใช้แอตทริบิวต์นี้เพื่อฮาร์ดโค้ดค่าของพารามิเตอร์ได้

หากคุณใช้แอตทริบิวต์นี้ อย่าใช้แอตทริบิวต์ ref

หมายเหตุการใช้งาน

ระบบจะใช้ XSLT ในไฟล์ .xsl แบบสแตนด์อโลน ซึ่งจัดเก็บไว้ใน API พร็อกซีภายใต้ /resources/xsl นโยบาย XSL อ้างอิงไฟล์ XSL เท่านั้น โปรดดู ไฟล์ทรัพยากรสำหรับข้อมูลเพิ่มเติม

นโยบาย XSL กำหนดให้มีอินพุต 2 ประเภทดังนี้

  • ชื่อของสไตล์ชีต XSLT ซึ่งมีชุดกฎการเปลี่ยนรูปแบบ) ที่จัดเก็บไว้ใน พร็อกซี API ภายใต้ /resources/xsl
  • แหล่งที่มาของ XML ที่จะเปลี่ยนรูปแบบ (โดยปกติจะเป็นคำขอหรือข้อความตอบกลับ)

ไม่รองรับ <xsl:include> และ <xsl:import>

Apigee Edge ใช้ Saxon ePub ตัวประมวลผล และรองรับ 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.

หัวข้อที่เกี่ยวข้อง