排解 JSON 到 XML 政策執行階段錯誤的問題

您目前查看的是 Apigee 和 Apigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

注意：這份疑難排解劇本是否實用？請按一下「提供意見」 ，讓我們瞭解情況。

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

原因

如果 JSON 轉 XML 政策的 <Source> 元素中指定的 message 變數符合下列任一條件，就會發生這項錯誤：

• 超出範圍 (無法在執行政策的特定流程中使用) 或
• 無法解析 (未定義)

舉例來說，如果 JSON 轉 XML 政策應在要求流程中執行，但 <Source> 元素設為 response 變數，而該變數不存在於要求流程中，就會發生這項錯誤。

診斷

1. 找出發生錯誤的 JSON 對應 XML 政策，以及無法使用的變數名稱。您可以在錯誤回應的 faultstring 元素中找到這兩項資訊。舉例來說，在下列 faultstring 中，政策名稱為 Convert-JSONToXML，變數為 response：

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

2. 在失敗的 JSON 轉 XML 政策 XML 中，確認 <Source> 元素中設定的變數名稱，與錯誤字串中識別的變數名稱 (如上方的步驟 1) 相符。舉例來說，下列 JSON 轉 XML 政策會在 <Source> 元素中指定名為 response 的變數，與 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 變數會用於 JSON 轉 XML 政策的 <Source> 元素。回應變數只能在回應流程中使用。

   由於要求流程中沒有 response 變數，因此您會收到下列錯誤代碼：

   steps.json2xml.SourceUnavailable
   

解析度

確認失敗的 JSON 轉 XML 政策 <Source> 元素中設定的變數已定義，且存在於政策執行的流程中。

如要修正上述範例 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 to XML」政策的輸入內容 (JSON) 無效或格式錯誤。

原因：缺少輸入酬載

在 JSON 轉 XML 政策中，如果 <Source> 元素中指定的變數內容 (酬載) 為空，就會發生這個錯誤。

舉例來說，如果 JSON 轉 XML 政策中的 <Source> 元素設為 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. 檢查失敗的 JSON 轉 XML 政策 XML 中的 <Source> 元素，並判斷指定的變數。舉例來說，下列 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://your_host_alias/v1/testjsontoxml" -H "Content-Type: application/json"
   

   其中 your_host_alias 是用於存取 API 的公開網域，已在覆寫檔案的 virtualhosts.hostAliases 屬性中設定。請參閱「指定設定覆寫」。

   由於 JSON 回應酬載為空白，您會收到錯誤代碼：

   steps.json2xml.ExecutionFailed
   

   如果 <Source> 元素設為回應，但後端伺服器傳遞的酬載為空，也可能發生這項錯誤。

   注意： 來源訊息的 HTTP Content-Type 標頭必須設為 application/json，否則系統會在處理期間略過政策，因此不會強制執行。

解析度

請確認傳遞至 <Source> 元素中 JSON 至 XML 政策的輸入內容是有效的 JSON 酬載，且不為空白。

如要修正範例 JSON 轉 XML 政策的問題，請傳遞有效的 JSON 酬載。例如：

1. 建立名為 city.json 的檔案，並在當中加入下列內容：

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

2. 使用下列 curl 指令發出 API 呼叫：

   curl -v "http://your_host_alias/v1/testxmltojson" -H "Content-Type: application/json" -X POST -d @company.json
   

   其中 your_host_alias 是用於存取 API 的公開網域，已在覆寫檔案的 virtualhosts.hostAliases 屬性中設定。請參閱「指定設定覆寫」。

原因：輸入內容無效或格式有誤

如果 JSON 轉 XML 政策剖析的輸入內容無效或格式錯誤，就會出現這項錯誤。

舉例來說，如果將下列無效的 JSON 提供給「JSON to 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. 檢查失敗的 JSON 轉 XML 政策 XML 中指定的 <Source> 元素。舉例來說，下列 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://your_host_alias/v1/testjsontoxml" -H "Content-Type:
   application/json" -X POST -d '[ "args" : ["name" : "Google" ]]'
   

   其中 your_host_alias 是用於存取 API 的公開網域，已在覆寫檔案的 virtualhosts.hostAliases 屬性中設定。請參閱「指定設定覆寫」。

   要求中傳遞的 JSON 酬載無效，因為 JSON 物件是以方括號 ([ ]) 開頭和結尾。因此，您會收到下列錯誤代碼：

   steps.json2xml.ExecutionFailed

   注意： JSON 酬載可包含 JSON 物件和/或 JSON 陣列。有效的 JSON 物件會以 { 開頭並以 } 結尾。有效的 JSON 陣列 (位於最外層) 會以 [ 開頭並以 ] 結尾。

   如果 <Source> 元素設為回應，但 JSON 回應酬載無效或格式錯誤，也可能發生這項錯誤。

   注意： 來源訊息的 HTTP Content-type 標頭必須設為 application/json，否則系統不會強制執行政策，也就是在處理期間略過政策。

解決方法

請確認傳遞至 <Source> 元素中 JSON 至 XML 政策的輸入內容有效，且格式正確。

如要修正上述範例 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"
        }
    }
}

原因

如果 JSON 轉 XML 政策的 <Source> 元素中指定的變數屬於字串類型，但未定義 <OutputVariable> 元素，就會發生這項錯誤。如果 <Source> 元素中定義的變數屬於字串類型，則 <OutputVariable> 元素為必要元素。

注意： 如果 <Source> 元素屬於訊息類型，則 <OutputVariable> 為非必要項目。

診斷

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 Proxy 中找出變數的定義位置。
   2. 找出變數定義和填入的政策後，請按照下列步驟判斷變數類型：
      1. 檢查類型屬性的值 (如有)。
      2. 如果沒有 type 屬性，變數會視為字串。
   3. 如果變數的類型是字串，就是導致錯誤的原因。如要瞭解常見變數及其類型，請參閱「變數參考資料」。

   舉例來說，請查看上述 JSON 轉 XML 政策中的 PostalCode 變數。

   舉例來說，假設您使用「指派訊息」政策，將值指派給名為 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 變數是用於 JSONToXML 政策的 <Source> 元素：

   <Source>PostalCode</Source>
   

   由於 PostalCode 屬於字串類型，且缺少 <OutputVariable> 元素，因此您會收到下列錯誤代碼：

   steps.json2xml.OutputVariableIsNotAvailable
   

解析度

請確認如果 JSONToXML 政策的 <Source> 元素中指定的變數屬於字串類型，則 <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 Proxy 中找出定義這些變數的程式碼。
   2. 找出變數定義和填入的政策後，請按照下列步驟判斷變數類型：
      1. 檢查類型屬性的值 (如有)。
      2. 如果沒有 type 屬性，變數會視為字串。
   3. 如果 <Source> 中指定的變數類型為字串，而 <OutputVariable> 的類型為訊息，反之亦然，這就是造成錯誤的原因。如要瞭解常見變數及其類型，請參閱「變數參考資料」。

   舉例來說，假設您使用「指派訊息」政策，將值指派給名為 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 變數是用於 JSONToXML 政策的 <Source> 元素：

   <Source>PostalCode</Source>
   

   同樣地，請回想一下，response 變數是用於 JSONToXML 政策的 <OutputVariable> 元素中：

   <OutputVariable>response</OutputVariable>
   

   由於 PostalCode 是字串類型，而 response 變數是訊息類型，因此兩者類型不相容，您會收到錯誤代碼：

   steps.json2xml.InCompatibleTypes
   

   如果 <Source> 元素中的變數屬於 message 類型，但 <OutputVariable> 元素中的變數屬於字串類型，也可能發生上述錯誤。

解析度

請確保 <Source> 元素和 <OutputVariable> 元素中定義的變數類型一律相同。<Source> 元素和 <OutputVariable> 元素中包含的變數類型必須相符。也就是說，請確保 <Source> 和 <OutputVariable> 元素都是字串或訊息類型。

如要修正上述 JSON 至 XML 政策，您可以使用指派訊息政策宣告另一個字串型別的變數 PostalCode_output，並在 JSON 至 XML 政策的 <OutputVariable> 元素中使用這個變數。

修改後的指派訊息政策：

<?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 政策中使用的無效來源類型。您可以在錯誤訊息中找到這項資訊。舉例來說，在下列錯誤中，無效型別為 Integer。

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

2. 檢查發生失敗的特定 API Proxy 中的所有 JSON 轉 XML 政策。在失敗的 JSON 轉 XML 政策中，記下 <Source> 中指定的變數名稱。

   以下是範例政策，其中 <Source> 元素指定了名為 EmployeeID 的變數：

<?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 Proxy 中定義這個變數的程式碼。
   2. 找出變數定義和填入的政策後，請按照下列步驟判斷變數類型：
      1. 檢查類型屬性的值 (如有)。
      2. 如果沒有 type 屬性，變數會視為字串。
   3. 如果 <Source> 中指定的變數類型既不是訊息類型，也不是字串類型，就是造成錯誤的原因。如要瞭解常見變數及其類型，請參閱「變數參考資料」。

   舉例來說，假設 ExtractVariables 政策用於從 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 變數是用於 JSONToXML 政策的 <Source> 元素：

   <Source>EmployeeID</Source>
   

   由於這個變數的類型是 Integer，並非有效的 <Source> 類型，因此 API Proxy 會失敗並顯示下列錯誤：

   steps.json2xml.InvalidSourceType
   

解析度

請確認用於指定 <Source> 元素的變數類型有效。有效的 <Source> 類型為 message 和 string。

為避免 JSONToXML 政策發生上述錯誤，您可以使用訊息類型的要求變數，或任何其他有效的 JSON 酬載字串。