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

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

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 至 XML 政策的輸入內容 (JSON) 無效或格式錯誤。

原因:缺少輸入酬載

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

舉例來說,如果 JSON 到 XML 政策中的 <Source> 元素設為 requestresponse 變數,且這些變數應包含 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> 元素,並判斷指定的變數。舉例來說,下列對 XML 政策的 JSON 政策已將 <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://<org>-<env>.apigee.net/v1/testjsontoxml" -H "Content-Type: application/json"
    

    由於 JSON 回應酬載為空白,因此您會收到以下錯誤代碼:

    steps.json2xml.ExecutionFailed
    

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

解析度

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

如要修正 JSON 到 XML 政策的範例問題,請傳遞有效的 JSON 酬載。例如:

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

    {
      "Name":"Apigee",
      "City":"Bengaluru",
      "Pincode":"560016"
    }
    
  2. 使用 cURL 指令發出 API 呼叫,如下所示:

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

原因:輸入內容無效或格式不正確

如果 JSON 至 XML 政策剖析的輸入內容無效或格式錯誤,就會顯示這個錯誤。

舉例來說,如果您將下列無效的 JSON 做為 JSON 至 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://<org>-<env>.apigee.net/v1/testjsontoxml" -H "Content-Type:
    application/json" -X POST -d '[ "args" : ["name" : "Google" ]]'
    

    由於 JSON 物件的開頭和結尾都使用方括號 ([ ]),因此要求中傳遞的 JSON 酬載無效,因此您會收到以下錯誤代碼:

    steps.json2xml.ExecutionFailed

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

解析度

請確認傳遞給 JSON 到 <Source> 元素中 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> 元素。

診斷

  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. 檢查 type 屬性值 (如有)。
      2. 如果沒有類型屬性,則系統會將變數視為字串。
    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> 元素所含的變數類型必須相符。

有效的類型為 messagestring

診斷

  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. 檢查 type 屬性值 (如有)。
      2. 如果沒有類型屬性,則系統會將變數視為字串。
    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> 元素的變數類型無效,就會發生這個錯誤。有效的變數類型為 messagestring

診斷

  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. 檢查 type 屬性值 (如有)。
      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> 類型為 messagestring

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