XML to JSON ポリシーのデプロイエラーのトラブルシューティング

EitherOptionOrFormat

エラー メッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラー メッセージが表示されます。

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

エラーの例

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

スクリーンショットの例

原因

<Options> または <Format> のいずれかの要素が XML to JSON ポリシーに宣言されていない場合、API プロキシのデプロイは失敗します。

<Format> を使用しない場合、<Options> は必要です。

<Format> 要素または <Options> 要素のいずれかのグループを使用します。<Format> と <Options> の両方を使用することはできません。事前定義された形式には、xml.com、yahoo、google、badgerFish があります。

診断

  1. エラーが発生した特定の API プロキシで、すべての XML to JSON ポリシーを調べます。<Options> 要素も <Format> 要素も宣言されていない XML to JSON ポリシーがある場合、それがエラーの原因です。

    たとえば、次のポリシーでは両方の要素が宣言されていません。

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

解決策

XML to JSON ポリシーの XML に、<Options> または <Format> のいずれかの要素がポリシー内で宣言されるようにします。

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

例 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

エラー メッセージ

Edge UI または Edge 管理 API を使用した API プロキシのデプロイに失敗し、次のエラー メッセージが表示されます。

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

エラーの例

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

スクリーンショットの例

原因

XML to JSON ポリシー内の <Format> 要素に不明な形式が定義されている場合、API プロキシのデプロイは失敗します。

事前定義された形式には、xml.com、yahoo、google、badgerFish があります。

診断

  1. エラーが発生した XML to JSON ポリシーと不明な形式を特定します。この情報はエラー メッセージから見つけることができます。たとえば、次のエラーでは、ポリシー名は WithFormat で、不明な形式は google.com です。

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

  2. 失敗した XML to JSON ポリシーで指定された不明な形式が、エラー メッセージで特定された値（上記のステップ 1）と一致することを確認します。たとえば、次のポリシーでは google.com という形式が指定されています。これはエラー メッセージの内容と一致します。

    <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. 指定された形式が、事前に定義された形式（xml.com、yahoo、google、badgerFish）の中の 1 つでない場合は、それがエラーの原因です。

    上記の XML to JSON ポリシーの例では、形式は無効な google.com です。したがって、API プロキシのデプロイは次のエラーで失敗します。

    XMLToJSON[WithFormat]: Unknown Format google.com.

解決策

XML to JSON ポリシーの <Format> 要素で指定された形式が有効であるようにします。次に例を示します。

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