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.
Chuyển đến tài liệu về 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 có một trong hai trường hợp sau:

  • Ngoài phạm vi (không có trong quy trình cụ thể mà 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 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 response trong phần tử <Source>, khớp với biến 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 sử 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à:

    • Ngoài phạm vi (không có trong luồng cụ thể mà 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 hiển thị ở trên đượ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 chuyển đổi 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 thành XML không thành công đã được xác định và tồn tại trong quy trình thực thi chính sách.

Để sửa chính sách JSON sang XML mẫ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 tồn tại 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ể

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.
Dữ liệu đầu vào không hợp lệ hoặc có định dạng không chính xác Dữ liệu đầu vào (JSON) được chuyển vào chính sách JSON sang XML 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à các phần tử này phải chứa tải trọng JSON, nhưng nếu tải trọng này trống thì lỗi sẽ xảy ra.

Chẩn đoán

  1. Xác định chính sách JSON sang XML mà lỗi đã xảy ra. 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 giá trị này trống, thì đó là nguyên nhân gây ra lỗi.

    Trong chính sách JSON sang XML mẫ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 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 trống.

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

  1. Tạo một tệp có tên 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: Dữ liệu đầu vào không hợp lệ hoặc không đúng định dạng

Nếu chính sách JSON sang XML phân tích cú pháp dữ liệu đầ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 dữ liệu đầ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 mà lỗi đã xảy ra. 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, 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" ]
]

    Dưới đây là lệnh gọi API mẫu cho thấy cách yêu cầu được truyền:

    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 sai định dạng.

Độ phân giải

Hãy đảm bảo rằng dữ liệu đầu vào được chuyển tới chính sách JSON sang XML trong phần tử <Source> là hợp lệ và không sai định dạng.

Để 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 chuyển đổi 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 về việc chuyển đổi JSON sang XML mà lỗi đã xảy ra. 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 chuyển đổi JSON sang XML không thành công, hãy xác thực xem <OutputVariable> có bị thiếu 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. Tìm mã trong Proxy API nơi biến được xác định trước.
    2. Sau khi tìm ra chính sách trong đó 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 type (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ụ: hãy lưu ý rằng chính sách Chỉ định thông báo được dùng để gán 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ì vậy, biến PostalCode thuộc loại 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> phải được xác định trong chính sách.

Để sửa Chính sách JSONToXML được 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 so khớp loại biến trong phần tử <Source> và phần tử <OutputVariable>.

Có 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 đã 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 thành XML bị lỗi, hãy ghi chú các giá trị được chỉ định trong <OutputVariable> và <Source>.

    Hãy xem xét chính sách mẫu 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 phần tử <Source> và <OutputVariable>:

    1. Tìm mã trong Proxy API, nơi mỗi biến này được xác định trước.
    2. Sau khi tìm ra chính sách mà trong đó biến được xác định và điề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 type (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 được chỉ định trong <Source> là chuỗi trong khi loại của <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 dùng để gán giá trị cho biến 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; do đó, biến PostalCode thuộc loại chuỗi.

    Bây giờ, hãy nhớ rằng biến PostalCode được sử 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 là loại chuỗi trong khi biến response là loại thông báo, nên đây là các loại không tương thích và bạn sẽ nhận được mã lỗi:

    steps.json2xml.InCompatibleTypes

    Lỗi 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. Kiểu của các biến có trong phần tử <Source> và phần tử <OutputVariable> bắt buộc phải khớp nhau. Tức là đảm bảo rằng loại của phần tử <Source> và <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 chỉ định 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.

Sửa đổi chính sách về việc chỉ định tin nhắn:

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

Chính sách JSONToXML đã sửa đổi:

<?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 sử 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, kiểu 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ả chính sách JSON sang XML trong Proxy API 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ó tên EmployeeID được chỉ định 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. Tìm mã trong Proxy API nơi biến này được xác định trước tiên.
    2. Sau khi tìm ra chính sách mà trong đó biến được xác định và điề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 type (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 hay 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 phần Tài liệu tham khảo về biến.

    Ví dụ: hãy xem xét chính sách ExtractVariables được dùng để trích xuất giá trị từ tải trọng JSON và đặt giá trị đó thành 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 sử dụng trong phần tử <Source> của chính sách JSONToXML:

    <Source>EmployeeID</Source>

    Vì loại của biến này là Integer, không phải là loại <Source> hợp lệ, nên Proxy API không thành công với lỗi:

    steps.json2xml.InvalidSourceType

Độ phân giải

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

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