การแก้ปัญหาข้อผิดพลาดเกี่ยวกับรันไทม์ของนโยบายการเปลี่ยนรูปแบบ XSL

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
info

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

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากข้อความหรือตัวแปรสตริงที่ระบุไว้ในองค์ประกอบ <Source> ของนโยบายการเปลี่ยนรูปแบบ XSL มีลักษณะดังนี้

  • อยู่นอกขอบเขต (ไม่พร้อมใช้งานในขั้นตอนที่นโยบายกำลังทำงาน)
  • ไม่สามารถแก้ไขได้ (ไม่ได้กําหนด)

ตัวอย่างเช่น ข้อผิดพลาดนี้เกิดขึ้นหากระบบควรจะใช้นโยบายการแปลง XSL ในขั้นตอนคำขอ แต่องค์ประกอบ <Source> ได้รับการตั้งค่าเป็นตัวแปรการตอบกลับ ซึ่งไม่มีอยู่ในขั้นตอนคำขอ

การวินิจฉัย

  1. ระบุนโยบายการเปลี่ยนรูปแบบ XSL ที่ทำให้เกิดข้อผิดพลาดและชื่อตัวแปรที่ไม่พร้อมใช้งาน คุณจะเห็นทั้ง 2 รายการนี้ในองค์ประกอบ faultstring ของคำตอบข้อผิดพลาด ตัวอย่างเช่น ในfaultstringต่อไปนี้ ชื่อนโยบายคือ xslt และตัวแปรคือ response

    faultstring": "response message is not available for XSL: xslt
    
  2. ใน XML นโยบายการเปลี่ยนรูปแบบ XSL ที่ดำเนินการไม่สำเร็จ ให้ตรวจสอบว่าชื่อตัวแปรที่ตั้งค่าไว้ในองค์ประกอบ <Source> ตรงกับชื่อตัวแปรที่ระบุไว้ในสตริงข้อผิดพลาด (ขั้นตอนที่ 1 ด้านบน) ตัวอย่างเช่น นโยบายการเปลี่ยนรูปแบบ XSL ต่อไปนี้จะระบุตัวแปรชื่อ response ในองค์ประกอบ <Source> ซึ่งตรงกับสิ่งที่อยู่ในสตริงข้อบกพร่อง

    <?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>
    
  3. ตรวจสอบว่าตัวแปรที่ใช้ในองค์ประกอบ <Source> ได้รับการกำหนดและพร้อมใช้งานในขั้นตอนที่มีการบังคับใช้นโยบายการเปลี่ยนรูปแบบ XSL หรือไม่

  4. หากตัวแปรเป็นค่าใดค่าหนึ่งต่อไปนี้

    • อยู่นอกขอบเขต (ไม่พร้อมใช้งานในขั้นตอนที่นโยบายจะทำงาน) หรือ
    • ไม่สามารถแก้ไขได้ (ไม่ได้กําหนด)

    แสดงว่านี่อาจเป็นสาเหตุของข้อผิดพลาด

    ตัวอย่างเช่น สมมติว่านโยบายการเปลี่ยนรูปแบบ XSL ที่แสดงด้านบนควรทำงานในขั้นตอนการส่งคำขอ โปรดทราบว่ามีการใช้ตัวแปร response ในองค์ประกอบ <Source> ของนโยบายตัวอย่าง ตัวแปร response จะใช้ได้เฉพาะในขั้นตอนการตอบกลับเท่านั้น

    เนื่องจากไม่มีตัวแปร response อยู่ในขั้นตอนคำขอ คุณจะได้รับรหัสข้อผิดพลาด:

    steps.xsl.XSLSourceMessageNotAvailable
    

ความละเอียด

ตรวจสอบว่าตัวแปรที่ตั้งค่าไว้ในองค์ประกอบ <Source> ของนโยบายการเปลี่ยนรูปแบบ XSL ที่ไม่สําเร็จได้รับการกําหนดและอยู่ในขั้นตอนที่นโยบายทํางาน

หากต้องการแก้ไขตัวอย่างนโยบายการเปลี่ยนรูปแบบ 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 ไม่สําเร็จ/แปลงไฟล์ XML อินพุตไม่ได้ตามกฎการเปลี่ยนรูปแบบที่ระบุไว้ในไฟล์ XSL นโยบาย XSLTransform อาจไม่ผ่านการตรวจสอบได้จากหลายสาเหตุ สาเหตุของความล้มเหลวในข้อความแสดงข้อผิดพลาดจะแสดงข้อมูลเพิ่มเติมเกี่ยวกับสาเหตุ ตารางต่อไปนี้แสดงสาเหตุหนึ่งของการไม่ผ่านการตรวจสอบนี้ ซึ่งก็คือ "คำนำหน้าไม่ถูกต้อง" พร้อมคำอธิบายและตัวอย่าง
สาเหตุ คำอธิบาย
เพย์โหลด XML อินพุตไม่พร้อมใช้งาน เพย์โหลด XML ที่ป้อนไม่ได้ส่งผ่านหรือว่างเปล่า
Input XML มีรูปแบบไม่ถูกต้อง เพย์โหลด XML ของอินพุตผิดรูปแบบหรือไม่ถูกต้อง
คำนำหน้าไม่ถูกต้อง เพย์โหลด XML อินพุตมีคำนำหน้าที่ไม่ได้กำหนดไว้ในไฟล์ XSL

สาเหตุ: ข้อมูลโค้ด XML ของอินพุตไม่พร้อมใช้งาน

ข้อผิดพลาดนี้เกิดขึ้นหากไม่มีการส่งเพย์โหลด XML อินพุต หรือเพย์โหลด XML ที่ส่งเป็นส่วนหนึ่งของคําขอ API ไปยังพร็อกซี API ที่มีนโยบาย XSLTransform ว่างเปล่า

ตัวอย่างข้อความแสดงข้อผิดพลาด

{
    "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"
        }
    }
}

การวินิจฉัย

  1. ระบุไฟล์ XSL ที่นโยบายการแปลง XML ประเมินไม่ได้และเหตุผลที่ล้มเหลว หากเพย์โหลด 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)\""
    
  2. ตรวจสอบว่าเพย์โหลด 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 ที่ถูกต้องและไม่ใช่ค่าว่าง

ในการแก้ไขปัญหาเกี่ยวกับตัวอย่างนโยบาย DKIMransform ให้ส่งเพย์โหลด XML ที่ถูกต้อง เช่น

  1. สร้างไฟล์ชื่อ city.xml ที่มีเนื้อหาต่อไปนี้

    <?xml version="1.0" encoding="UTF-8"?>
    <root>
       <City>Bengaluru</City>
       <Name>Apigee</Name>
       <Pincode>560016</Pincode>
    </root>
    
  2. เรียก API โดยใช้คำสั่ง cURL ดังนี้

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

สาเหตุ: XML อินพุตมีรูปแบบไม่ถูกต้อง

เพย์โหลด XML อินพุตที่ส่งเป็นส่วนหนึ่งของคําขอ API ไปยังนโยบาย XSLTransform มีรูปแบบไม่ถูกต้องหรือไม่ถูกต้อง

ตัวอย่างข้อความแสดงข้อผิดพลาด

{
    "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"
        }
    }
}

การวินิจฉัย

  1. ระบุไฟล์ XSL ที่นโยบายการแปลง XML ประเมินไม่ได้และเหตุผลที่ล้มเหลว หากเพย์โหลด XML อินพุตมีรูปแบบไม่ถูกต้อง สาเหตุของการไม่สําเร็จจะระบุว่ามีอักขระที่ไม่คาดคิด คุณดูข้อมูลทั้งหมดนี้ได้ในองค์ประกอบ faultstring ของคำตอบข้อผิดพลาด เช่น ใน faultstring ต่อไปนี้ ไฟล์ XSL คือ XSL-Transform.xsl และสาเหตุของการไม่ผ่านคือ Unexpected char while looking for open tag ('&lt;') character กล่าวคือ "<" ขาดหายไปในเพย์โหลด XML

    "faultstring": "Evaluation of XSL XSL-Transform.xsl failed with reason: \"Unexpected char while looking for open tag ('&lt;') character\""
    
  2. ตรวจสอบเพย์โหลด XML อินพุตที่ส่งไปยังนโยบาย XSLTransform และดูว่าเนื้อหา 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\""
    

ความละเอียด

ตรวจสอบว่าอินพุตที่ส่งไปยังนโยบาย XSLTransform เป็นเพย์โหลด XML ที่ถูกต้องและไม่ว่างเปล่า

ในการแก้ไขปัญหาเกี่ยวกับตัวอย่างนโยบาย DKIMransform ให้ส่งเพย์โหลด XML ที่ถูกต้อง เช่น

  1. แก้ไขไฟล์ city.xml ให้เนื้อหาเป็น XML ดังที่แสดงด้านล่าง

    <?xml version="1.0" encoding="UTF-8"?>
    <root>
       <City>Bengaluru</City>
       <Name>Apigee</Name>
       <Pincode>560016</Pincode>
    </root>
    
  2. เรียกใช้ API โดยใช้คำสั่ง cURL ดังนี้

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

สาเหตุ: คำนำหน้าไม่ถูกต้อง

เพย์โหลด XML ของอินพุตที่ส่งไปยังนโยบาย MRSS มีองค์ประกอบที่ไม่ได้กำหนดไว้เป็นคำนำหน้าในไฟล์ 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"
        }
    }
}

การวินิจฉัย

  1. ระบุไฟล์ XSL ที่นโยบายการเปลี่ยนรูปแบบ XML ประเมินไม่ได้และสาเหตุที่ดำเนินการไม่สำเร็จ ในกรณีนี้ เหตุผลที่ล้มเหลวอาจบ่งชี้ว่ามีคำนำหน้าที่ยังไม่ได้แก้ไขที่หมายเลขบรรทัดที่เฉพาะเจาะจงในเพย์โหลด 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)\""
    
  2. ตรวจสอบเนื้อหาของไฟล์ XSL (ระบุไว้ในขั้นตอนที่ 1 ด้านบน) และข้อมูลเพย์โหลด XML ของอินพุต หากไม่มีคำนำหน้าที่ใช้ในหมายเลขบรรทัด (ระบุในขั้นตอนที่ 1 ด้านบน) ของเพย์โหลด XML ของอินพุตในไฟล์ XSL นี่จึงเป็นสาเหตุของข้อผิดพลาด

    ตัวอย่าง 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>&lt;Life&gt;</xsl:text> แทน คุณจึงได้รับข้อผิดพลาดดังต่อไปนี้

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

ความละเอียด

ตรวจสอบว่าเพย์โหลด XML อินพุตที่ส่งไปยังนโยบาย XSLTransform มีรูปแบบองค์ประกอบทั้งหมดที่กําหนดเป็นคำนำหน้าในไฟล์ XSL ที่ใช้ในนโยบาย

หากต้องการแก้ไขไฟล์ XML ตัวอย่างที่แสดงด้านบน ให้แก้ไขไฟล์ดังที่แสดงด้านล่าง

ข้อมูลโค้ด 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>