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

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

SourceUnavailable

รหัสข้อผิดพลาด

steps.json2xml.SourceUnavailable

เนื้อหาการตอบกลับข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: Source [source_variable] is not available",
        "detail": {
            "errorcode": "steps.json2xml.SourceUnavailable"
        }
    }
}

ตัวอย่างข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[Convert-JSONToXML]: Source response is not available",
        "detail": {
            "errorcode": "steps.json2xml.SourceUnavailable"
        }
    }
}

สาเหตุ

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

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

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

การวินิจฉัย

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

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

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
        <DisplayName>Convert-JSONToXML</DisplayName>
        <Properties/>
        <Options>
            <NullValue>NULL</NullValue>
            <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
            <NamespaceSeparator>:</NamespaceSeparator>
            <TextNodeName>#text</TextNodeName>
            <AttributeBlockName>#attrs</AttributeBlockName>
            <AttributePrefix>@</AttributePrefix>
            <InvalidCharsReplacement>_</InvalidCharsReplacement>
            <ObjectRootElementName>Root</ObjectRootElementName>
            <ArrayRootElementName>Array</ArrayRootElementName>
            <ArrayItemElementName>Item</ArrayItemElementName>
        </Options>
        <OutputVariable>request</OutputVariable>
        <Source>response</Source>
    </JSONToXML>
    
  3. ระบุว่าตัวแปรที่ใช้ในองค์ประกอบ <Source> ได้รับการกำหนดและพร้อมใช้งานในโฟลว์ที่มีการดำเนินการนโยบาย JSON เป็น XML หรือไม่

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

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

    ก็จะเป็นสาเหตุของข้อผิดพลาด

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

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

    steps.json2xml.SourceUnavailable
    

ความละเอียด

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

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

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
      <DisplayName>Convert-JSONToXML</DisplayName>
      <Properties/>
      <Options>
          <NullValue>NULL</NullValue>
          <NamespaceBlockName>#namespaces</NamespaceBlockName>
          <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
          <NamespaceSeparator>:</NamespaceSeparator>
          <TextNodeName>#text</TextNodeName>
          <AttributeBlockName>#attrs</AttributeBlockName>
          <AttributePrefix>@</AttributePrefix>
          <InvalidCharsReplacement>_</InvalidCharsReplacement>
          <ObjectRootElementName>Root</ObjectRootElementName>
          <ArrayRootElementName>Array</ArrayRootElementName>
          <ArrayItemElementName>Item</ArrayItemElementName>
      </Options>
      <OutputVariable>request</OutputVariable>
      <Source>request</Source>
  </JSONToXML>

ExecutionFailed

รหัสข้อผิดพลาด

steps.json2xml.ExecutionFailed

เนื้อหาการตอบกลับข้อผิดพลาด

{
   "fault": {
        "faultstring": "JSONToXML[policy_name]: Execution failed due to reason: Expecting { or [ at line 1",
        "detail": {
            "errorcode": "steps.json2xml.ExecutionFailed"
        }
    }
}

สาเหตุที่เป็นไปได้

สาเหตุที่เป็นไปได้สำหรับข้อผิดพลาดนี้คือ

สาเหตุ คำอธิบาย
ไม่มีเพย์โหลดอินพุต เพย์โหลดอินพุต (JSON) ว่างเปล่า
ข้อมูลที่ป้อนไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง อินพุต (JSON) ที่ส่งไปยังนโยบาย JSON เป็น XML ไม่ถูกต้องหรือผิดรูปแบบ

สาเหตุ: เพย์โหลดอินพุตขาดหายไป

ในนโยบาย JSON เป็น XML หากเนื้อหา (เพย์โหลด) ของตัวแปรที่ระบุในองค์ประกอบ <Source> ว่างเปล่า ระบบจะแสดงข้อผิดพลาดนี้

เช่น หากองค์ประกอบ <Source> ในนโยบาย JSON เป็น XML มีการตั้งค่าเป็นตัวแปร request หรือ response และควรมีเพย์โหลด JSON แต่หากเพย์โหลดว่างเปล่า ก็จะเกิดข้อผิดพลาดขึ้น

การวินิจฉัย

  1. ระบุนโยบาย JSON เป็น XML ที่เกิดข้อผิดพลาด โดยคุณดูข้อมูลนี้ได้ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ Convert-JSONToXML

    "faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"
    
  2. ตรวจสอบองค์ประกอบ <Source> ใน XML ของนโยบาย JSON เป็น XML ที่ล้มเหลวและระบุตัวแปรที่ระบุ ตัวอย่างเช่น นโยบาย JSON เป็น XML ต่อไปนี้มีการตั้งค่าองค์ประกอบ <Source> เป็น request

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
    <DisplayName>Convert-JSONToXML</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>request</OutputVariable>
    <Source>request</Source>
    </JSONToXML>
    
  3. ตรวจสอบว่าตัวแปรที่ระบุสำหรับองค์ประกอบ <Source> ในนโยบายว่างเปล่าหรือไม่ หากพารามิเตอร์ว่างเปล่า นั่นเป็นสาเหตุของข้อผิดพลาด

    ในตัวอย่างนโยบาย JSON เป็น XML ที่แสดงด้านบน เพย์โหลดคำขอ (เนื้อหาคำขอ) ที่ไคลเอ็นต์ส่งว่างเปล่า

    เช่น

    curl -v "http://<org>-<env>.apigee.net/v1/testjsontoxml" -H "Content-Type: application/json"
    

    เนื่องจากเพย์โหลดการตอบกลับ JSON ว่างเปล่า คุณจึงได้รับรหัสข้อผิดพลาดต่อไปนี้

    steps.json2xml.ExecutionFailed
    

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

ความละเอียด

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

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

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

    {
      "Name":"Apigee",
      "City":"Bengaluru",
      "Pincode":"560016"
    }
    
  2. เรียก API โดยใช้คำสั่ง cURL ดังนี้

    curl -v "http://<org>-<env>.apigee.net/v1/testxmltojson" -H "Content-Type: application/json" -X POST -d @company.json
    

สาเหตุ: ข้อมูลที่ป้อนไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง

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

ตัวอย่างเช่น หากมีการระบุ JSON ที่ไม่ถูกต้องต่อไปนี้เป็นอินพุตนโยบาย JSON เป็น XML

[
    "args": ["name" : "Google" ]
]

คุณจะเห็นข้อผิดพลาด

"faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"

การวินิจฉัย

  1. ระบุนโยบาย JSON เป็น XML ที่เกิดข้อผิดพลาด โดยคุณดูข้อมูลนี้ได้ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ Convert-JSONToXML

    "faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"
    
  2. ตรวจสอบองค์ประกอบ <Source> ที่ระบุใน XML ของนโยบาย JSON เป็น XML ที่ล้มเหลว ตัวอย่างเช่น นโยบาย JSON เป็น XML ต่อไปนี้มีการตั้งค่าองค์ประกอบ <Source> เป็นตัวแปร request

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
      <DisplayName>Convert-JSONToXML</DisplayName>
      <Properties/>
      <Options>
          <NullValue>NULL</NullValue>
          <NamespaceBlockName>#namespaces</NamespaceBlockName>
          <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
          <NamespaceSeparator>:</NamespaceSeparator>
          <TextNodeName>#text</TextNodeName>
          <AttributeBlockName>#attrs</AttributeBlockName>
          <AttributePrefix>@</AttributePrefix>
          <InvalidCharsReplacement>_</InvalidCharsReplacement>
          <ObjectRootElementName>Root</ObjectRootElementName>
          <ArrayRootElementName>Array</ArrayRootElementName>
          <ArrayItemElementName>Item</ArrayItemElementName>
      </Options>
      <OutputVariable>request</OutputVariable>
      <Source>request</Source>
    </JSONToXML>
    
  3. ตรวจสอบว่าอินพุตที่ระบุในองค์ประกอบ <Source> เป็นเพย์โหลด JSON ที่ถูกต้องหรือไม่ หากข้อมูลที่ป้อนไม่ถูกต้องหรือผิดรูปแบบ นั่นเป็นสาเหตุของข้อผิดพลาด

    สมมติว่ามีการส่ง JSON ที่ไม่ถูกต้องต่อไปนี้ไปยังนโยบาย

    [
        "args": ["name" : "Google" ]
    ]
    

    ต่อไปนี้คือตัวอย่างการเรียก API ที่แสดงให้เห็นว่ามีการส่งคำขออย่างไร

    curl -v "http://<org>-<env>.apigee.net/v1/testjsontoxml" -H "Content-Type:
    application/json" -X POST -d '[ "args" : ["name" : "Google" ]]'
    

    เพย์โหลด JSON ที่ส่งในคำขอไม่ถูกต้องเนื่องจากออบเจ็กต์ JSON เริ่มต้นและลงท้ายด้วยวงเล็บเหลี่ยม ([ ]) ด้วยเหตุนี้ คุณจึงได้รับรหัสข้อผิดพลาดต่อไปนี้

    steps.json2xml.ExecutionFailed

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

ความละเอียด

ตรวจสอบว่าอินพุตที่ส่งไปยังนโยบาย JSON เป็น XML ในองค์ประกอบ <Source> ถูกต้องและมีรูปแบบไม่ถูกต้อง

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

{
  "args"  : {

        "name"  :  "Google"
   }
}

OutputVariableIsNotAvailable

รหัสข้อผิดพลาด

steps.json2xml.OutputVariableIsNotAvailable

เนื้อหาการตอบกลับข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: Output variable is not available.",
        "detail": {
            "errorcode": "steps.json2xml.OutputVariableIsNotAvailable"
        }
    }
}

ตัวอย่างข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[Check-JSONToXML]: Output variable is not available.",
        "detail": {
            "errorcode": "steps.json2xml.OutputVariableIsNotAvailable"
        }
    }
}

สาเหตุ

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

การวินิจฉัย

  1. ระบุนโยบาย JSON เป็น XML ที่เกิดข้อผิดพลาด ซึ่งจะอยู่ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ Check-JSONToXML

    "faultstring": "JSONToXML[Check-JSONToXML]: Output variable is not available."
    
  2. ในนโยบาย JSON เป็น XML ที่ไม่สำเร็จ ให้ตรวจสอบว่า <OutputVariable> หายไปหรือไม่

    ตัวอย่างนโยบาย JSONToXML ต่อไปนี้ไม่มีองค์ประกอบ <OutputVariable>

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
        <DisplayName>Check-JSONToXML</DisplayName>
        <Properties/>
        <Options>
            <NullValue>NULL</NullValue>
            <NamespaceBlockName>#namespaces</NamespaceBlockName>
            <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
            <NamespaceSeparator>:</NamespaceSeparator>
            <TextNodeName>#text</TextNodeName>
            <AttributeBlockName>#attrs</AttributeBlockName>
            <AttributePrefix>@</AttributePrefix>
            <InvalidCharsReplacement>_</InvalidCharsReplacement>
            <ObjectRootElementName>Root</ObjectRootElementName>
            <ArrayRootElementName>Array</ArrayRootElementName>
            <ArrayItemElementName>Item</ArrayItemElementName>
        </Options>
        <Source>PostalCode</Source>
    </JSONToXML>
    
  3. กำหนดประเภทของตัวแปรที่ระบุในองค์ประกอบ <Source> ดังนี้

    1. ค้นหาโค้ดภายในพร็อกซี API ที่มีการกำหนดตัวแปรไว้ก่อน
    2. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว คุณจะต้องกำหนดประเภทของตัวแปรนั้น ดังนี้
      1. ตรวจสอบค่าของแอตทริบิวต์ type (หากมี)
      2. หากไม่มีแอตทริบิวต์ type จะถือว่าตัวแปรเป็นสตริง
    3. หากประเภทของตัวแปรเป็นสตริง แสดงว่าเป็นสาเหตุของข้อผิดพลาด คุณดูข้อมูลเกี่ยวกับตัวแปรทั่วไปและประเภทของตัวแปรได้ในข้อมูลอ้างอิงตัวแปร

    เช่น ลองดูตัวแปร PostalCode ในนโยบาย JSON เป็น XML ด้านบน

    ตัวอย่างเช่น ลองพิจารณาการใช้นโยบายการกำหนดข้อความเพื่อกำหนดค่าให้กับตัวแปรที่เรียกว่า PostalCode ดังที่ปรากฏด้านล่าง

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
        <DisplayName>Assign_PostalCode</DisplayName>
        <Properties/>
        <AssignVariable>
            <Name>PostalCode</Name>
            <Value>{"value":"56008"}</Value>
            <Ref/>
        </AssignVariable>
        <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
        <AssignTo createNew="false" transport="http" type="request"/>
    </AssignMessage>
    

    โปรดทราบว่าประเภทตัวแปรที่ตั้งค่าไว้ใน <AssignVariable> เป็นสตริง ดังนั้นตัวแปร PostalCode จึงเป็นสตริงประเภท

    อย่าลืมว่ามีการใช้ตัวแปร PostalCode ในองค์ประกอบ <Source> ของนโยบาย JSONToXML ดังนี้

    <Source>PostalCode</Source>
    

    เนื่องจาก PostalCode เป็นประเภทสตริงและไม่มีองค์ประกอบ <OutputVariable> คุณจึงได้รับรหัสข้อผิดพลาด

    steps.json2xml.OutputVariableIsNotAvailable
    

ความละเอียด

ตรวจสอบว่าหากตัวแปรที่ระบุในองค์ประกอบ <Source> ของนโยบาย JSONToXML เป็นประเภทสตริง ระบบจะกำหนดองค์ประกอบ <OutputVariable> ภายในนโยบาย

หากต้องการแก้ไขนโยบาย JSONToXML ที่กล่าวถึงข้างต้น ให้ใส่องค์ประกอบ <OutputVariable> ดังที่แสดงด้านล่าง

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
      <DisplayName>Check-JSONToXML</DisplayName>
      <Properties/>
      <Options>
          <NullValue>NULL</NullValue>
          <NamespaceBlockName>#namespaces</NamespaceBlockName>
          <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
          <NamespaceSeparator>:</NamespaceSeparator>
          <TextNodeName>#text</TextNodeName>
          <AttributeBlockName>#attrs</AttributeBlockName>
          <AttributePrefix>@</AttributePrefix>
          <InvalidCharsReplacement>_</InvalidCharsReplacement>
          <ObjectRootElementName>Root</ObjectRootElementName>
          <ArrayRootElementName>Array</ArrayRootElementName>
          <ArrayItemElementName>Item</ArrayItemElementName>
      </Options>
      <OutputVariable>response</OutputVariable>
      <Source>PostalCode</Source>
  </JSONToXML>

InCompatibleTypes

รหัสข้อผิดพลาด

steps.json2xml.InCompatibleTypes

เนื้อหาการตอบกลับข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: String can not be assigned to message type.",
        "detail": {
            "errorcode": "steps.json2xml.InCompatibleTypes"
        }
    }
}

ตัวอย่างข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[JSONToXML_checktype]: String can not be assigned to message type.",
        "detail": {
            "errorcode": "steps.json2xml.InCompatibleTypes"
        }
    }
}

สาเหตุ

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

ประเภทที่ถูกต้องคือ message และ string

การวินิจฉัย

  1. ระบุนโยบาย JSON เป็น XML ที่เกิดข้อผิดพลาด ซึ่งจะอยู่ในองค์ประกอบ faultstring ของการตอบกลับข้อผิดพลาด ตัวอย่างเช่น ใน faultstring ต่อไปนี้ ชื่อนโยบายคือ JSONToXML_checktype

    "faultstring": "JSONToXML[JSONToXML_checktype]: String can not be assigned to message type."
    
  2. ในนโยบาย JSON เป็น XML ที่ล้มเหลว ให้บันทึกค่าที่ระบุใน <OutputVariable> และ <Source>

    ลองพิจารณานโยบายตัวอย่างต่อไปนี้

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML_checktype">
        <DisplayName>JSONToXML_checktype</DisplayName>
        <Properties/>
        <Options>
            <NullValue>NULL</NullValue>
            <NamespaceBlockName>#namespaces</NamespaceBlockName>
            <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
            <NamespaceSeparator>:</NamespaceSeparator>
            <TextNodeName>#text</TextNodeName>
            <AttributeBlockName>#attrs</AttributeBlockName>
            <AttributePrefix>@</AttributePrefix>
            <InvalidCharsReplacement>_</InvalidCharsReplacement>
            <ObjectRootElementName>Root</ObjectRootElementName>
            <ArrayRootElementName>Array</ArrayRootElementName>
            <ArrayItemElementName>Item</ArrayItemElementName>
        </Options>
        <OutputVariable>response</OutputVariable>
        <Source>PostalCode</Source>
    </JSONToXML>
    
    
  3. กำหนดประเภทของตัวแปรที่ระบุในองค์ประกอบ <Source> และ <OutputVariable> ดังนี้

    1. ค้นหาโค้ดภายในพร็อกซี API ที่มีการระบุตัวแปรแต่ละรายการก่อน
    2. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว คุณจะต้องกำหนดประเภทของตัวแปรนั้น ดังนี้
      1. ตรวจสอบค่าของแอตทริบิวต์ type (หากมี)
      2. หากไม่มีแอตทริบิวต์ type จะถือว่าตัวแปรเป็นสตริง
    3. หากประเภทของตัวแปรที่ระบุใน <Source> เป็นสตริง ในขณะที่ประเภทของ <OutputVariable> เป็นข้อความหรือในทางกลับกัน นั่นเป็นสาเหตุของข้อผิดพลาด คุณดูข้อมูลเกี่ยวกับตัวแปรทั่วไปและประเภทของตัวแปรได้ในข้อมูลอ้างอิงตัวแปร

    ลองดูตัวอย่างนโยบาย Assign Message ที่ใช้กําหนดค่าให้กับตัวแปรชื่อ PostalCode ตามที่แสดงด้านล่าง

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
        <DisplayName>Assign_PostalCode</DisplayName>
        <Properties/>
        <AssignVariable>
            <Name>PostalCode</Name>
            <Value>{"value":"56008"}</Value>
            <Ref/>
        </AssignVariable>
        <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
        <AssignTo createNew="false" transport="http" type="request"/>
    </AssignMessage>
    

    โปรดทราบว่าประเภทตัวแปรที่ตั้งค่าไว้ใน <AssignVariable> เป็นสตริง ดังนั้นตัวแปร PostalCode จึงเป็นสตริงประเภท

    อย่าลืมว่ามีการใช้ตัวแปร PostalCode ในองค์ประกอบ <Source> ของนโยบาย JSONToXML ดังนี้

    <Source>PostalCode</Source>
    

    ในทำนองเดียวกัน โปรดจำว่ามีการใช้ตัวแปร response ในองค์ประกอบ <OutputVariable> ของนโยบาย JSONToXML ดังนี้

    <OutputVariable>response</OutputVariable>
    

    เนื่องจาก PostalCode เป็นประเภทสตริง ส่วนตัวแปร response เป็นประเภทข้อความ จึงเป็นประเภทที่ใช้ร่วมกันไม่ได้ ดังนั้นคุณจะได้รับรหัสข้อผิดพลาด

    steps.json2xml.InCompatibleTypes
    

    ข้อผิดพลาดข้างต้นอาจเกิดขึ้นหากตัวแปรในองค์ประกอบ <Source> เป็นประเภท message แต่ตัวแปรในองค์ประกอบ <OutputVariable> เป็นประเภทสตริง

ความละเอียด

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

หากต้องการแก้ไขนโยบาย JSON เป็น XML ที่กล่าวถึงข้างต้น คุณสามารถประกาศตัวแปร PostalCode_output ของประเภทสตริงโดยใช้นโยบายกำหนดข้อความ และใช้ตัวแปรนี้ในองค์ประกอบ <OutputVariable> ของนโยบาย JSON เป็น XML

นโยบายการมอบหมายข้อความที่แก้ไข:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
    <DisplayName>Assign_PostalCode</DisplayName>
    <Properties/>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Value>{"value":"56008"}</Value>
        <Ref/>
    </AssignVariable>
    <AssignVariable>
        <Name>PostalCode_output</Name>
        <Ref/>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

นโยบาย JSONToXML ที่แก้ไขแล้ว:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
    <DisplayName>JSONToXML_checktype</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>PostalCode_output</OutputVariable>
    <Source>PostalCode</Source>
</JSONToXML>

InvalidSourceType

รหัสข้อผิดพลาด

steps.json2xml.InvalidSourceType

เนื้อหาการตอบกลับข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[class invalid_class]: Invalid source type class invalid_class. Valid source types are [message, string].",
        "detail": {
            "errorcode": "steps.json2xml.InvalidSourceType"
        }
    }
}

ตัวอย่างข้อผิดพลาด

{
    "fault": {
        "faultstring": "JSONToXML[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string].",
        "detail": {
            "errorcode": "steps.json2xml.InvalidSourceType"
        }
    }
}

สาเหตุ

ข้อผิดพลาดนี้เกิดขึ้นหากประเภทของตัวแปรที่ใช้กำหนดองค์ประกอบ <Source> ไม่ถูกต้อง ประเภทตัวแปรที่ถูกต้องคือ message และ string

การวินิจฉัย

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

    "faultstring": "JSONToXML[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string]."
    
  2. ตรวจสอบนโยบาย JSON เป็น XML ทั้งหมดในพร็อกซี API เฉพาะที่เกิดความล้มเหลว ในนโยบาย JSON เป็น XML ที่ล้มเหลว ให้จดชื่อตัวแปรที่ระบุใน <Source>

    ตัวอย่างนโยบายที่มีตัวแปรชื่อ EmployeeID ระบุไว้ในองค์ประกอบ <Source> มีดังนี้

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
    <DisplayName>Check_SourceType</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>request</OutputVariable>
    <Source>EmployeeID</Source>
</JSONToXML>
  1. กำหนดประเภทของตัวแปรที่ระบุในองค์ประกอบ <Source> ดังนี้

    1. ค้นหาโค้ดภายในพร็อกซี API ที่มีการกำหนดตัวแปรนี้ก่อน
    2. เมื่อคุณทราบถึงนโยบายที่กำหนดและเติมค่าตัวแปรก่อนแล้ว คุณจะต้องกำหนดประเภทของตัวแปรนั้น ดังนี้
      1. ตรวจสอบค่าของแอตทริบิวต์ type (หากมี)
      2. หากไม่มีแอตทริบิวต์ type จะถือว่าตัวแปรเป็นสตริง
    3. หากประเภทของตัวแปรที่ระบุใน <Source> ไม่ใช่ประเภทข้อความหรือสตริง นั่นเป็นสาเหตุของข้อผิดพลาด คุณดูข้อมูลเกี่ยวกับตัวแปรทั่วไปและประเภทของตัวแปรได้ในข้อมูลอ้างอิงตัวแปร

    ตัวอย่างเช่น เราจะใช้นโยบาย ExtractVariant เพื่อดึงค่าจากเพย์โหลด JSON และตั้งค่าเป็นตัวแปร EmployeeID ของประเภทจำนวนเต็มตามที่แสดงด้านล่าง

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ExtractVariables name="ExtractJSONVariables">
        <Source>request</Source>
        <JSONPayload>
            <Variable name="EmployeeID" type="integer">
                <JSONPath>$.ID</JSONPath>
            </Variable>
        </JSONPayload>
    </ExtractVariables>
    

    อย่าลืมว่ามีการใช้ตัวแปร EmployeeID ในองค์ประกอบ <Source> ของนโยบาย JSONToXML ดังนี้

    <Source>EmployeeID</Source>
    

    เนื่องจากประเภทของตัวแปรนี้คือ Integer ซึ่งไม่ใช่ประเภท <Source> ที่ถูกต้อง พร็อกซี API จะล้มเหลวโดยมีข้อผิดพลาด:

    steps.json2xml.InvalidSourceType
    

ความละเอียด

ตรวจสอบว่าประเภทของตัวแปรที่ใช้ระบุองค์ประกอบ <Source> ถูกต้อง <Source> ประเภทที่ใช้ได้คือ message และ string

เพื่อหลีกเลี่ยงข้อผิดพลาดข้างต้นด้วยนโยบาย JSONToXML คุณสามารถใช้ตัวแปรคําขอซึ่งเป็นข้อความประเภทหรือสตริงอื่นๆ ซึ่งเป็นเพย์โหลด JSON ที่ถูกต้อง