You're viewingApigee Edge documentation.
Go to theApigee X documentation.info

SourceUnavailable

Error code

steps.xml2json.SourceUnavailable

Error response body

{"fault":{"faultstring":"XMLToJSON[policy_name]: Source [source_variable] is not available","detail":{"errorcode":"steps.xmltojson.SourceUnavailable"}}}

Example Error Message

{    "fault": {        "faultstring": "XMLToJSON[Convert-XMLToJSON]: Source response is not available",        "detail": {            "errorcode": "steps.xml2json.SourceUnavailable"        }    }}

Cause

This error occurs if themessage or string variable specified in the<Source> element of the XML to JSON policy is either:

• out of scope (not available in the specific flow where the policy is being executed) or
• can't be resolved (is not defined)

For example, this error occurs if the XML to JSON policy is supposed to be executed in the request flow, but the<Source> element is set to theresponse variable, which doesn't exist in the request flow.

Diagnosis

1. Identify the XML to JSON policy where the error occurred and the name of the variable that is not available. You can find both of these items in thefaultstring element of the error response. For example, in the followingfaultstring, the policy name isConvert-XMLToJSON and the variable isresponse:

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

2. In the failed XML to JSON policy XML, verify that the name of the variable set in the<Source> element matches the variable name identified in the fault string (step #1 above). For example, the following XML to JSON policy specifies a variable namedresponse in the<Source> element, which matches what's in thefaultstring:

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

3. Determine if the variable used in the<Source> element is defined and available in the flow in which the XML to JSON policy is being executed.

4. If the variable is either:

   • out of scope (not available in the specific flow where the policy is being executed) or
   • can't be resolved (is not defined)

   then that's the cause for the error.

   As an example, let's say the XML to JSON policy shown above is supposed to be executed in therequest flow. Recall that theresponse variable is used in the<Source> element of the XML to JSON policy. The response variable is available only in the response flow.

   Because the response variable does not exist in the request flow, you receive the error code:

   steps.xml2json.SourceUnavailable

Resolution

Ensure that the variable set in the<Source> element of the failed XML to JSON policy, is defined and exists in the flow where the policy executes.

To correct the example XML to JSON policy shown above, you could modify the<Source> element to use therequest variable as it exists in the request flow:

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

ExecutionFailed

Error code

steps.xml2json.ExecutionFailed

Error response body

{"fault":{"faultstring":"XMLToJSON[policy_name]: Execution failed. reason: Premature end of document while parsing at line [line_number](possibly  around char [character_number])","detail":{"errorcode":"steps.xml2json.ExecutionFailed"}}}

Possible causes

The possible causes for this error are:

Cause: Missing input payload

In the XML to JSON policy if the content (payload) of the variable specified in the<Source> element is empty, then this error occurs.

For example, if the<Source> element in the XML to JSON policy is set as arequest orresponse variable and it is supposed to contain an XML payload, this error occurs if the payload is empty.

Diagnosis

1. Identify the XML to JSON policy where the error occurred. You can find this information in thefaultstring element of the error response. For example, in the followingfaultstring, the policy name isConvert-XMLToJSON:

   "faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 1(possibly  around char 0)"

2. Examine the<Source> element in the failing XML to JSON policy XML and determine the variable specified. For example, the following XML to JSON policy has<Source> element set to request:

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

3. Check if the variable specified for the<Source> element in the XMLToJSON policy is empty. If it is empty, then that's the cause for the error.

   In the example XML to JSON policy shown above, the request payload (i.e, request body) that was sent by the client was empty.

   For example:

   curl -v "http://<org>-<env>.apigee.net/v1/testxmltojson" -H "Content-Type: application/xml"

   Because the XML request payload is empty, you receive the error code:

   steps.xml2json.ExecutionFailed

   This error can also occur if the<Source> element is set to response, but an empty payload is passed by the backend server.

   Note: The HTTP Content-type header of the source message must be set toapplication/xml, otherwise the policy is not enforced, meaning it is skipped during processing.

Resolution

Ensure that the input passed to XML to JSON policy via the<Source> element is a valid XML payload and non-empty.

To fix the issue with the sample XML to JSON policy, pass a valid XML payload. For example:

1. Create a file named city.xml with the following contents:

   <?xml version="1.0" encoding="UTF-8"?><root>   <City>Bengaluru</City>   <Name>Apigee</Name>   <Pincode>560016</Pincode></root>

2. Make the API call using a cURL command as follows:

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

Cause: Invalid or Malformed Input

If the XML to JSON policy parses input that is invalid or malformed, then you get this error.

For example, if the following invalid XML is provided as input to the XML to JSON policy,

<?xml version="1.0" encoding="UTF-8"?><root>   <City>Bengaluru</City>   <Name>Apigee</Name>   <Pincode>560016</Pincode>

"faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 6(possibly  around char 0)"

1. Identify the XML to JSON policy where the error occurred. You can find this information in thefaultstring element of the error response. For example, in the followingfaultstring, the policy name isConvert-XMLToJSON:

   "faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 6(possibly  around char 0)"

2. Examine the<Source> element specified in the failing XML to JSON policy XML. For example, the following XML to JSON policy has the<Source> element set to therequest variable:

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

3. Validate if the input specified in the<Source> element to the XML To JSON policy is a valid XML payload. If the input is invalid or malformed, then that's the cause for the error.

   In the example XML to JSON policy shown above, the following invalid XML was passed to Extract Variables policy via the filecity.xml:

   <?xml version="1.0" encoding="UTF-8"?><root>   <City>Bengaluru</City>   <Name>Apigee</Name>   <Pincode>560016</Pincode>

   Here's the sample API call that shows how the request was passed:

   curl-v"http://<org>-<env>.apigee.net/v1/testxmltpjson"-H"Content-Type: application/xml"-XPOST-d@city.xml

   The XML payload passed to the API is invalid, as the XML does not have an end tag for<root> element. So you receive the error code:

   steps.xml2json.ExecutionFailed

   This error can also occur if the<Source> element was set to response but the XML response payload from the backend server is invalid or malformed.

   Note: The HTTP Content-type header of the source message must be set toapplication/xml, otherwise the policy is not enforced, meaning it is skipped during processing.

Resolution

Ensure that the input passed to XML to JSON policy via the<Source> element is valid and not malformed.

To fix the issue with the sample XML to JSON policy discussed above, pass a valid XML payload request as follows:

<?xml version="1.0" encoding="UTF-8"?><root>   <City>Bengaluru</City>   <Name>Apigee</Name>   <Pincode>560016</Pincode></root>

steps.xml2json.OutputVariableIsNotAvailable

{"fault":{"faultstring":"XMLToJSON[policy_name]: Output variable is not available.","detail":{"errorcode":"steps.xml2json.OutputVariableIsNotAvailable"}}}

{"fault":{"faultstring":"XMLToJSON[Convert-XMLToJSON]: Output variable is not available.","detail":{"errorcode":"steps.xml2json.OutputVariableIsNotAvailable"}}}

1. Identify the XML to JSON Policy where the error has occurred. You can find this in thefaultstring element of the error response. For example, in the followingfaultstring, the policy name isConvert-XMLToJSON:

   "faultstring":"XMLToJSON[Convert-XMLToJSON]: Output variable is not available."

2. In the failed XML to JSON Policy validate if the<OutputVariable> is missing.

   Here's a sample XML to JSON Policy that has missing<OutputVariable> element.

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

3. Determine the type of variable specified in the<Source> element:

   1. Locate the code within the API Proxy bundle, where the variable was defined first.
   2. Once you figure out the policy in which the variable is defined and populated first, you need to determine the type of that variable as follows:
      1. Check the value of the type attribute (if present).
      2. If the type attribute is not present, then the variable is considered to be a string.
   3. If the variable's type isstring, then that's the cause of the error. You can learn about common variables and their types in theVariables reference.

   For example, look at the TrackingNumber variable in the above XML to JSON policy. It is of type string. Now, consider an Assign Message policy that is used to set value to a variable calledTrackingNumber as shown below:

   <?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><AssignMessageasync="false"continueOnError="false"enabled="true"name="Assign_TrackingNumber"><DisplayName>Assign_TrackingNumber</DisplayName><Properties/><AssignVariable><Name>TrackingNumber</Name><Value><![CDATA[<Code>560075393539898</Code>]]></Value><Ref/></AssignVariable><IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables><AssignTocreateNew="false"transport="http"type="request"/></AssignMessage>

   Note that the variable type set via<AssignVariable> is string. So the variableTrackingNumber is of type string.

   Now, recall that theTrackingNumber variable is used in the<Source> element of the XML To JSON policy:

   <Source>TrackingNumber</Source>

   SinceTrackingNumber is of string type and the<OutputVariable> is missing in the policy, you receive the error code:

   steps.xml2json.OutputVariableIsNotAvailable

Resolution

Ensure that if the variable specified in the<Source> element of the XMLToJSON Policy is of type string, the<OutputVariable> element is mandatory in this case.

To correct the XML To JSON Policy discussed above, include the<OutputVariable> element as shown below.

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

InCompatibleTypes

Error code

steps.xml2json.InCompatibleTypes

Error response body

{"fault":{"faultstring":"XMLToJSON[policy_name]: String can not be assigned to message type.","detail":{"errorcode":"steps.xml2json.InCompatibleTypes"}}}

Example Error Message

{"fault":{"faultstring":"XMLToJSON[XMLToJSON_CheckType]: String can not be assigned to message type.","detail":{"errorcode":"steps.xml2json.InCompatibleTypes"}}}

Cause

This error occurs if the type of the variable defined in the<Source> element and the<OutputVariable> element are not the same. It is mandatory that the type of the variables contained within the<Source> element and the<OutputVariable> element matches.

Thevalidtypesaremessageandstring.

Diagnosis

1. Identify the XML to JSON Policy where the error has occurred. You can find this in thefaultstring element of the error response. For example, in the followingfaultstring, the policy name isXMLToJSON_CheckType:

   "faultstring":"XMLToJSON[XMLToJSON_CheckType]: String can not be assigned to message type."

2. In the failed XML To JSON Policy note the values specified in<OutputVariable>.

   Here's a sample XMLToJSON policy that has missing<OutputVariable> element

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

3. Determine the type of variable specified in<Source> and<OutputVariable> elements:

   1. Locate the code within the API Proxy bundle, where each of these variables were defined first.
   2. Once you figure out the policy in which the variable is defined and populated first, you need to determine the type of that variable as follows:
      1. Check the value of the type attribute (if present).
      2. If the type attribute is not present, then the variable is considered to be a string.
   3. If the type of the variable specified in<Source> isstring while the type of<OutputVariable> is message or vice versa, then that's the cause of the error. You can learn about common variables and their types in theVariables reference.

   As an example, consider an Assign Message policy that is used to set a value to a variable calledTrackingNumber as shown below:

   <?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><AssignMessageasync="false"continueOnError="false"enabled="true"name="Assign_TrackingNumber"><DisplayName>Assign_TrackingNumber</DisplayName><Properties/><AssignVariable><Name>TrackingNumber</Name><Value><![CDATA[<Code>560075393539898</Code>]]></Value><Ref/></AssignVariable><IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables><AssignTocreateNew="false"transport="http"type="request"/></AssignMessage>

   Note that the variable type set via<AssignVariable> is string. So the variableTrackingNumber is of type string.

   Now, recall that theTrackingNumber variable is used in the<Source> element of the XMLToJSON policy:

   <Source>TrackingNumber</Source>

   Similarly, recall that therequest variable is used in the<OutputVariable> element of the XML To JSON policy:

   <OutputVariable>request</OutputVariable>

   BecauseTrackingNumber is of typestring while theresponse variable is of typemessage, they are incompatible types so you receive the error code:

   steps.xml2json.InCompatibleTypes

   The above error can also occur if the variable in the<Source> element is of typemessage but the variable in the<OutputVariable> element is of type string.

Resolution

Ensure that the type of the variable defined in the<Source> element and the<OutputVariable> element are always the same. It is mandatory that the type of the variables contained within the<Source> element and the<OutputVariable> element matches.

To correct the XML To JSON Policy discussed above, you could declare another variableTrackingNumber_output of typestring using the Assign Message Policy and use this variable in the<OutputVariable> element of the XML To JSON Policy.

Modified Assign Message policy:

<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><AssignMessageasync="false"continueOnError="false"enabled="true"name="Assign_TrackingNumber"><DisplayName>Assign_TrackingNumber</DisplayName><Properties/><AssignVariable><Name>TrackingNumber</Name><Value><![CDATA[<Code>560098</Code>]]></Value><Ref/></AssignVariable><AssignVariable><Name>TrackingNumber_output</Name><Ref/></AssignVariable><IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables><AssignTocreateNew="false"transport="http"type="request"/></AssignMessage>

Modified XMLToJSON policy:

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

InvalidSourceType

Error code

steps.xml2json.InvalidSourceType

Error response body

{"fault":{"faultstring":"XMLToJSON[classinvalid_class]: Invalid source type classinvalid_class. Valid source types are [message, string].","detail":{"errorcode":"steps.xml2json.InvalidSourceType"}}}

Example Error Message

{"fault":{"faultstring":"XMLToJSON[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string].","detail":{"errorcode":"steps.xml2json.InvalidSourceType"}}}

Cause

This error occurs if the type of the variable used to define the<Source> element is invalid.The valid types of variable aremessage andstring.

Diagnosis

1. Identify the invalid source type used in the XML to JSON policy. You can find this information from the error message. For example, in the following error, the invalid type is integer.

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

2. Examine all the XML to JSON policies in the specific API Proxy where the failure has occurred. In the failed XML To JSON Policy note the name of the variable specified in<Source>.

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

3. Determine the type of variable specified in<Source> element:

   1. Locate the code within the API Proxy bundle, where this variable was defined first.
   2. Once you figure out the policy in which the variable is defined and populated first, you need to determine the type of that variable as follows:
      1. Check the value of the type attribute (if present).
      2. If the type attribute is not present, then the variable is considered to be a string.
   3. If the type of the variable specified in<Source> is neithermessage norstring type, then that's the cause of the error. You can learn about common variables and their types in theVariables reference.

   As an example, consider an ExtractVariables policy that is used to extract the value from an XML payload and sets the value to the variableBookCode to beinteger type as shown below:

   <?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><ExtractVariablesasync="false"continueOnError="false"enabled="true"name="Extract_BookCode"><DisplayName>Extract_BookCode</DisplayName><Properties/><Source>request</Source><XMLPayloadstopPayloadProcessing="false"><Variablename="BookCode"type="integer"><XPath>/root/BookCode</XPath></Variable></XMLPayload></ExtractVariables>

   Now, recall that theBookCode variable is used in the<Source> element of the XML To JSON policy:

   <Source>BookCode</Source>

   Because the type of this variable isInteger, which is not a valid<Source> type, the API Proxy fails with the error:

   steps.xml2json.InvalidSourceType

Resolution

Ensure that the type of the variable used to specify the<Source> element is valid. The valid<Source> types aremessage andstring.

To avoid the above error with XML To JSON policy, you could use therequest variable which is of typemessage or any other string which is a valid XML payload.