Khắc phục sự cố về lỗi thời gian chạy chính sách JSON sang XML

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

SourceUnavailable

Mã lỗi

steps.json2xml.SourceUnavailable

Nội dung phản hồi lỗi

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

Ví dụ về lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu biến message được chỉ định trong phần tử <Source> của chính sách JSON sang XML là:

  • Ngoài phạm vi (không có trong quy trình cụ thể nơi chính sách đang được thực thi) hoặc
  • Không thể phân giải (chưa được xác định)

Ví dụ: lỗi này xảy ra nếu chính sách JSON sang XML được cho là sẽ thực thi trong luồng yêu cầu, nhưng phần tử <Source> được đặt thành biến response (không tồn tại trong luồng yêu cầu).

Chẩn đoán

  1. Xác định chính sách JSON sang XML nơi xảy ra lỗi và tên của biến không có sẵn. Bạn có thể tìm thấy cả hai mục này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là Convert-JSONToXML và biến là response:

    "faultstring": "JSONToXML[Convert-JSONToXML]: Source response is not available"

  2. Trong tệp XML chính sách JSON sang XML không thành công, hãy xác minh rằng tên của biến được đặt trong phần tử <Source> khớp với tên biến được xác định trong chuỗi lỗi (bước 1 ở trên). Ví dụ: chính sách JSON sang XML sau đây chỉ định một biến có tên là response trong phần tử <Source>, khớp với nội dung trong 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. Xác định xem biến được dùng trong phần tử <Source> có được xác định và có sẵn trong luồng mà chính sách JSON sang XML đang được thực thi hay không.

  4. Nếu biến là một trong hai trường hợp sau:

    • Ngoài phạm vi (không có trong quy trình cụ thể nơi chính sách đang được thực thi) hoặc
    • Không thể phân giải (chưa được xác định)

    thì đó là nguyên nhân gây ra lỗi.

    Ví dụ: giả sử chính sách JSON sang XML nêu trên sẽ được thực thi trong luồng yêu cầu. Hãy nhớ rằng biến response được dùng trong phần tử <Source> của chính sách JSON sang XML. Biến phản hồi chỉ có trong luồng phản hồi.

    Vì biến response không tồn tại trong luồng yêu cầu, nên bạn sẽ nhận được mã lỗi:

    steps.json2xml.SourceUnavailable

Độ phân giải

Đảm bảo rằng biến được đặt trong phần tử <Source> của chính sách JSON sang XML không thành công được xác định và tồn tại trong luồng mà chính sách thực thi.

Để sửa chính sách JSON sang XML mẫu nêu trên, bạn có thể sửa đổi phần tử <Source> để sử dụng biến request, vì biến này có trong luồng yêu cầu:

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

Mã lỗi

steps.json2xml.ExecutionFailed

Nội dung phản hồi lỗi

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

Các nguyên nhân có thể

Các nguyên nhân có thể gây ra lỗi này là:

Nguyên nhân Nội dung mô tả
Thiếu tải trọng đầu vào Tải trọng đầu vào (JSON) đang trống.
Đầu vào không hợp lệ hoặc không đúng định dạng Đầu vào (JSON) được truyền đến chính sách JSON sang XML là không hợp lệ hoặc sai định dạng.

Nguyên nhân: Thiếu tải trọng đầu vào

Trong chính sách JSON sang XML, nếu nội dung (tải trọng) của biến được chỉ định trong phần tử <Source> bị trống, thì lỗi này sẽ xảy ra.

Ví dụ: Nếu phần tử <Source> trong chính sách JSON sang XML được đặt làm biến request hoặc response và chúng được cho là chứa tải trọng JSON, nhưng nếu tải trọng trống thì lỗi sẽ xảy ra.

Chẩn đoán

  1. Xác định chính sách JSON sang XML nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là Convert-JSONToXML:

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

  2. Kiểm tra phần tử <Source> trong tệp XML chính sách JSON sang XML không thành công và xác định biến được chỉ định. Ví dụ: chính sách JSON sang XML sau đây có phần tử <Source> được đặt thành 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. Kiểm tra xem biến được chỉ định cho phần tử <Source> trong chính sách có trống hay không. Nếu trống, thì đó là nguyên nhân gây ra lỗi.

    Trong chính sách JSON sang XML mẫu nêu trên, tải trọng yêu cầu (tức là nội dung yêu cầu) do ứng dụng gửi là trống.

    Ví dụ:

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

    Vì tải trọng phản hồi JSON trống, nên bạn sẽ nhận được mã lỗi:

    steps.json2xml.ExecutionFailed

    Lỗi này cũng có thể xảy ra nếu phần tử <Source> được đặt thành phản hồi, nhưng máy chủ phụ trợ truyền tải một tải trọng trống.

Độ phân giải

Đảm bảo rằng dữ liệu đầu vào được truyền đến chính sách JSON sang XML trong phần tử <Source> là tải trọng JSON hợp lệ và không được để trống.

Để khắc phục vấn đề với chính sách JSON sang XML mẫu, hãy truyền một tải trọng JSON hợp lệ. Ví dụ:

  1. Tạo một tệp có tên là city.json với nội dung sau:

    {
  "Name":"Apigee",
  "City":"Bengaluru",
  "Pincode":"560016"
}

  2. Thực hiện lệnh gọi API bằng lệnh cURL như sau:

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

Nguyên nhân: Thông tin đầu vào không hợp lệ hoặc sai định dạng

Nếu chính sách JSON sang XML phân tích cú pháp đầu vào không hợp lệ hoặc không đúng định dạng, thì bạn sẽ gặp lỗi này.

Ví dụ: nếu JSON không hợp lệ sau đây được cung cấp làm đầu vào cho chính sách JSON sang XML,

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

bạn sẽ gặp lỗi:

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

Chẩn đoán

  1. Xác định chính sách JSON sang XML nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là Convert-JSONToXML:

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

  2. Kiểm tra phần tử <Source> được chỉ định trong tệp XML chính sách JSON sang XML không thành công. Ví dụ: chính sách JSON sang XML sau đây có phần tử <Source> được đặt thành biến 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. Xác thực xem dữ liệu đầu vào được chỉ định trong phần tử <Source> có phải là tải trọng JSON hợp lệ hay không. Nếu dữ liệu đầu vào không hợp lệ hoặc sai định dạng, thì đó là nguyên nhân gây ra lỗi.

    Giả sử JSON không hợp lệ sau đây được truyền đến chính sách

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

    Sau đây là lệnh gọi API mẫu cho biết cách truyền yêu cầu:

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

    Tải trọng JSON được truyền trong yêu cầu không hợp lệ vì đối tượng JSON bắt đầu và kết thúc bằng dấu ngoặc vuông ([ ]). Vì lý do này, bạn nhận được mã lỗi:

    steps.json2xml.ExecutionFailed

    Lỗi này cũng có thể xảy ra nếu phần tử <Source> được đặt thành phản hồi nhưng tải trọng phản hồi JSON không hợp lệ hoặc không đúng định dạng.

Độ phân giải

Đảm bảo rằng dữ liệu đầu vào được truyền đến chính sách JSON sang XML trong phần tử <Source> là hợp lệ và không bị lỗi.

Để khắc phục vấn đề với chính sách JSON sang XML mẫu đã thảo luận ở trên, hãy truyền một yêu cầu tải trọng JSON hợp lệ như sau:

{
  "args"  : {

        "name"  :  "Google"
   }
}

OutputVariableIsNotAvailable

Mã lỗi

steps.json2xml.OutputVariableIsNotAvailable

Nội dung phản hồi lỗi

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

Ví dụ về lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu biến được chỉ định trong phần tử <Source> của Chính sách JSON sang XML thuộc loại chuỗi và phần tử <OutputVariable> không được xác định. Phần tử <OutputVariable> là bắt buộc khi biến được xác định trong phần tử <Source> thuộc loại chuỗi.

Chẩn đoán

  1. Xác định Chính sách JSON sang XML nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là Check-JSONToXML:

    "faultstring": "JSONToXML[Check-JSONToXML]: Output variable is not available."

  2. Trong chính sách xác thực JSON sang XML không thành công, hãy kiểm tra xem có thiếu <OutputVariable> hay không.

    Chính sách JSONToXML mẫu sau đây bị thiếu phần tử <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. Xác định loại biến được chỉ định trong phần tử <Source>:

    1. Xác định vị trí đoạn mã trong API Proxy nơi biến được xác định lần đầu.
    2. Sau khi tìm ra chính sách mà biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      1. Kiểm tra giá trị của thuộc tính loại (nếu có).
      2. Nếu không có thuộc tính type, thì biến được coi là một chuỗi.
    3. Nếu loại của biến là chuỗi, thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong Tài liệu tham khảo về biến.

    Ví dụ: hãy xem biến PostalCode trong chính sách JSON sang XML ở trên.

    Ví dụ: giả sử chính sách Assign Message (Chỉ định thông báo) được dùng để chỉ định một giá trị cho biến có tên là PostalCode như minh hoạ dưới đây:

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

    Xin lưu ý rằng loại biến được đặt trong <AssignVariable> là chuỗi. Vậy biến PostalCode thuộc kiểu chuỗi.

    Bây giờ, hãy nhớ rằng biến PostalCode được dùng trong phần tử <Source> của chính sách JSONToXML:

    <Source>PostalCode</Source>

    Vì PostalCode thuộc loại chuỗi và thiếu phần tử <OutputVariable>, nên bạn sẽ nhận được mã lỗi:

    steps.json2xml.OutputVariableIsNotAvailable

Độ phân giải

Đảm bảo rằng nếu biến được chỉ định trong phần tử <Source> của Chính sách JSONToXML thuộc loại chuỗi, thì phần tử <OutputVariable> sẽ được xác định trong chính sách.

Để sửa Chính sách JSONToXML đã thảo luận ở trên, hãy thêm phần tử <OutputVariable> như minh hoạ dưới đây.

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

Mã lỗi

steps.json2xml.InCompatibleTypes

Nội dung phản hồi lỗi

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

Ví dụ về lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu loại biến được xác định trong phần tử <Source> và phần tử <OutputVariable> không giống nhau. Bạn bắt buộc phải khớp loại của các biến có trong phần tử <Source> và phần tử <OutputVariable>.

Các loại hợp lệ là message và string.

Chẩn đoán

  1. Xác định Chính sách JSON sang XML nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là JSONToXML_checktype:

    "faultstring": "JSONToXML[JSONToXML_checktype]: String can not be assigned to message type."

  2. Trong chính sách JSON sang XML không thành công, hãy lưu ý các giá trị được chỉ định trong <OutputVariable> và <Source>.

    Hãy xem xét ví dụ về chính sách sau:

    <?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. Xác định loại biến được chỉ định trong các phần tử <Source> và <OutputVariable>:

    1. Xác định vị trí đoạn mã trong API Proxy nơi mỗi biến này được xác định lần đầu.
    2. Sau khi tìm ra chính sách mà biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      1. Kiểm tra giá trị của thuộc tính loại (nếu có).
      2. Nếu không có thuộc tính type, thì biến được coi là một chuỗi.
    3. Nếu loại biến được chỉ định trong <Source> là chuỗi trong khi loại <OutputVariable> là thông báo hoặc ngược lại, thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong Tài liệu tham khảo về biến.

    Ví dụ: hãy xem xét chính sách Chỉ định thông báo được dùng để chỉ định một giá trị cho biến có tên là PostalCode như minh hoạ dưới đây:

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

    Xin lưu ý rằng kiểu biến được đặt trong <AssignVariable> là chuỗi; do đó, biến PostalCode thuộc kiểu chuỗi.

    Bây giờ, hãy nhớ rằng biến PostalCode được dùng trong phần tử <Source> của chính sách JSONToXML:

    <Source>PostalCode</Source>

    Tương tự, hãy nhớ rằng biến response được dùng trong phần tử <OutputVariable> của chính sách JSONToXML:

    <OutputVariable>response</OutputVariable>

    Vì PostalCode thuộc kiểu chuỗi trong khi biến response thuộc kiểu thông báo, nên đây là các kiểu không tương thích, do đó, bạn sẽ nhận được mã lỗi:

    steps.json2xml.InCompatibleTypes

    Lỗi nêu trên cũng có thể xảy ra nếu biến trong phần tử <Source> thuộc loại message nhưng biến trong phần tử <OutputVariable> thuộc loại chuỗi.

Độ phân giải

Đảm bảo rằng loại biến được xác định trong phần tử <Source> và phần tử <OutputVariable> luôn giống nhau. Bạn bắt buộc phải khớp loại của các biến có trong phần tử <Source> và phần tử <OutputVariable>. Tức là đảm bảo rằng loại của <Source> và các phần tử <OutputVariable> đều là loại chuỗi hoặc loại thông báo.

Để sửa Chính sách JSON sang XML đã thảo luận ở trên, bạn có thể khai báo một biến PostalCode_output khác thuộc loại chuỗi bằng cách sử dụng Chính sách gán thông báo và sử dụng biến này trong phần tử <OutputVariable> của Chính sách JSON sang XML.

Chính sách Assign Message (Chỉ định thông báo) đã được sửa đổi:

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

Sửa đổi chính sách 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

Mã lỗi

steps.json2xml.InvalidSourceType

Nội dung phản hồi lỗi

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

Ví dụ về lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu loại biến dùng để xác định phần tử <Source> không hợp lệ.Các loại biến hợp lệ là message và string.

Chẩn đoán

  1. Xác định loại nguồn không hợp lệ được dùng trong chính sách JSON sang XML. Bạn có thể tìm thấy thông tin này trong thông báo lỗi. Ví dụ: trong lỗi sau đây, loại không hợp lệ là Integer.

    "faultstring": "JSONToXML[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string]."

  2. Kiểm tra tất cả các chính sách JSON sang XML trong API Proxy cụ thể nơi xảy ra lỗi. Trong Chính sách JSON sang XML không thành công, hãy ghi lại tên của biến được chỉ định trong <Source>.

    Dưới đây là một chính sách mẫu có biến được chỉ định tên là EmployeeID trong phần tử <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. Xác định loại biến được chỉ định trong phần tử <Source>:

    1. Xác định vị trí đoạn mã trong API Proxy nơi biến này được xác định lần đầu.
    2. Sau khi tìm ra chính sách mà biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      1. Kiểm tra giá trị của thuộc tính loại (nếu có).
      2. Nếu không có thuộc tính type, thì biến được coi là một chuỗi.
    3. Nếu loại biến được chỉ định trong <Source> không phải là loại thông báo cũng không phải là loại chuỗi, thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong Tài liệu tham khảo về biến.

    Ví dụ: giả sử chính sách ExtractVariables được dùng để trích xuất giá trị từ tải trọng JSON và đặt giá trị cho biến EmployeeID thuộc loại số nguyên như minh hoạ dưới đây:

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

    Bây giờ, hãy nhớ rằng biến EmployeeID được dùng trong phần tử <Source> của chính sách JSONToXML:

    <Source>EmployeeID</Source>

    Vì loại biến này là Integer (không phải là loại <Source> hợp lệ), nên API Proxy sẽ gặp lỗi:

    steps.json2xml.InvalidSourceType

Độ phân giải

Đảm bảo rằng loại biến dùng để chỉ định phần tử <Source> là hợp lệ. Các loại <Source> hợp lệ là message và string.

Để tránh lỗi nêu trên với chính sách JSONToXML, bạn có thể sử dụng biến request có kiểu thông báo hoặc bất kỳ chuỗi nào khác là tải trọng JSON hợp lệ.