Khắc phục sự cố về lỗi triển khai chính sách XML sang JSON

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

EitherOptionOrFormat

Thông báo lỗi

Việc triển khai proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và xuất hiện thông báo lỗi sau:

Error Saving Revision [revision_number]
XMLToJSON[{0}]: Either Options or Format must be specified.

Ví dụ về lỗi

Error Saving Revision 1
XMLToJSON[{0}]: Either Options or Format must be specified.

Ảnh chụp màn hình ví dụ

Nguyên nhân

Nếu một trong các phần tử <Options> hoặc <Format> không được khai báo trong Chính sách XML sang JSON, thì quá trình triển khai proxy API sẽ không thành công.

<Options> là thuộc tính bắt buộc nếu bạn không sử dụng <Format>.

Sử dụng phần tử <Format> hoặc nhóm phần tử <Options>. Bạn không thể sử dụng cả <Format> và <Options>. Các định dạng được xác định trước bao gồm: xml.com, yahoo, google và badgerFish.

Chẩn đoán

  1. Kiểm tra tất cả các chính sách XML sang JSON trong một proxy API cụ thể nơi xảy ra lỗi. Nếu có chính sách XML sang JSON mà trong đó một trong các phần tử <Options> hoặc <Format> không được khai báo, thì đó là nguyên nhân gây ra lỗi.

    Ví dụ: chính sách sau đây không có phần tử nào được khai báo:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

Độ phân giải

Đảm bảo rằng XML của chính sách XML sang JSON có một trong các phần tử <Options> hoặc <Format> được khai báo trong chính sách.

Ví dụ 1:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <Format>google</Format>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

Ví dụ 2:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLToJSON">
    <DisplayName>XMLToJSON</DisplayName>
    <Properties/>
    <Options>
        <RecognizeNumber>true</RecognizeNumber>
        <RecognizeBoolean>true</RecognizeBoolean>
        <RecognizeNull>true</RecognizeNull>
    </Options>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

UnknownFormat

Thông báo lỗi

Việc triển khai proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và xuất hiện thông báo lỗi sau:

Error Saving Revision [revision_number]
XMLToJSON[policy_name]: Unknown Format [unknown_format].

Ví dụ về lỗi

Error Saving Revision 1
XMLToJSON[WithFormat]: Unknown Format google.com.

Ảnh chụp màn hình ví dụ

Nguyên nhân

Nếu phần tử <Format> trong chính sách XML sang JSON có định dạng không xác định, thì quá trình triển khai proxy API sẽ không thành công.

Các định dạng được xác định trước bao gồm: xml.com, yahoo, google và badgerFish.

Chẩn đoán

  1. Xác định chính sách XML sang JSON nơi xảy ra lỗi và định dạng không xác định. 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, tên chính sách là WithFormat và định dạng không xác định là google.com:

    Error Saving Revision 1
XMLToJSON[WithFormat]: Unknown Format google.com.

  2. Xác minh rằng định dạng không xác định được chỉ định trong chính sách XML sang JSON không thành công khớp với giá trị được xác định trong thông báo lỗi (bước 1 ở trên). Ví dụ: chính sách sau đây chỉ định định dạng là google.com, khớp với nội dung trong thông báo lỗi:

    <XMLToJSON async="false" continueOnError="false" enabled="true" name="WithFormat">
  <DisplayName>WithFormat</DisplayName>
  <Properties/>
  <Format>google.com</Format>
  <OutputVariable>response</OutputVariable>
  <Source>response</Source>
</XMLToJSON>

  3. Nếu Định dạng được chỉ định không phải là một trong các định dạng được xác định trước xml.com, yahoo, google hoặc badgerFish, thì đó là nguyên nhân gây ra lỗi.

    Trong Chính sách XML sang JSON trong ví dụ nêu trên, định dạng là google.com, đây là định dạng không hợp lệ. Do đó, việc triển khai API Proxy không thành công với lỗi:

    XMLToJSON[WithFormat]: Unknown Format google.com.

Độ phân giải

Đảm bảo rằng định dạng được chỉ định trong phần tử <Format> của chính sách XML sang JSON là hợp lệ. Ví dụ:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="WithFormat">
  <DisplayName>WithFormat</DisplayName>
  <Properties/>
  <Format>google</Format>
  <OutputVariable>response</OutputVariable>
  <Source>response</Source>
</XMLToJSON>