Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
SourceUnavailable
Codice di errore
steps.xml2json.SourceUnavailable
Corpo della risposta all'errore
{ "fault": { "faultstring": "XMLToJSON[policy_name]: Source [source_variable] is not available", "detail": { "errorcode": "steps.xmltojson.SourceUnavailable" } } }
Esempio di messaggio di errore
{
"fault": {
"faultstring": "XMLToJSON[Convert-XMLToJSON]: Source response is not available",
"detail": {
"errorcode": "steps.xml2json.SourceUnavailable"
}
}
}
Causa
Questo errore si verifica se la variabile message o stringa specificata nell'elemento <Source>
del criterio da XML a JSON è:
- fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) oppure
- non può essere risolto (non è definito)
Ad esempio, questo errore si verifica se il criterio da XML a JSON deve essere eseguito nel flusso della richiesta, ma l'elemento <Source>
è impostato sulla variabile response
, che non esiste nel flusso della richiesta.
Diagnostica
Identifica il criterio da XML a JSON in cui si è verificato l'errore e il nome della variabile che non è disponibile. Puoi trovare entrambi gli elementi nell'elemento
faultstring
della risposta di errore. Ad esempio, nel seguentefaultstring
, il nome del criterio èConvert-XMLToJSON
e la variabile èresponse
:"faultstring": "XMLToJSON[Convert-XMLToJSON]: Source response is not available"
Nel file XML del criterio da XML a JSON non riuscito, verifica che il nome della variabile impostata nell'elemento
<Source>
corrisponda al nome della variabile identificato nella stringa di errore (passaggio 1 riportato sopra). Ad esempio, il seguente criterio da XML a JSON specifica una variabile denominataresponse
nell'elemento<Source>
, che corrisponde al contenutofaultstring
:<?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>
Determina se la variabile utilizzata nell'elemento
<Source>
è definita e disponibile nel flusso in cui viene eseguito il criterio da XML a JSON.Se la variabile è:
- fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) oppure
- non può essere risolto (non è definito)
è questa la causa dell'errore.
Supponiamo, ad esempio, che il criterio da XML a JSON mostrato sopra debba essere eseguito nel flusso di richiesta. Ricorda che la variabile
response
viene utilizzata nell'elemento<Source>
del criterio da XML a JSON. La variabile di risposta è disponibile solo nel flusso di risposta.Poiché la variabile di risposta non esiste nel flusso di richiesta, riceverai il codice di errore:
steps.xml2json.SourceUnavailable
Risoluzione
Assicurati che la variabile impostata nell'elemento <Source>
del criterio da XML a JSON che non ha superato il test sia definita e esista nel flusso in cui viene eseguito il criterio.
Per correggere il criterio da XML a JSON di esempio mostrato sopra, puoi modificare l'elemento <Source>
in modo da utilizzare la variabile request
esistente nel flusso di richiesta:
<?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
Codice di errore
steps.xml2json.ExecutionFailed
Corpo della risposta all'errore
{ "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" } } }
Possibili cause
Le possibili cause di questo errore sono:
Causa | Descrizione |
Payload di input mancante | Il payload di input (XML) è vuoto. |
Input non valido o in formato non valido | L'input (XML) passato al criterio da XML a JSON non è valido o è in un formato non corretto. |
Causa: payload di input mancante
Nel criterio da XML a JSON, se i contenuti (payload) della variabile specificata nell'elemento <Source>
sono vuoti, si verifica questo errore.
Ad esempio, se l'elemento <Source>
nel criterio da XML a JSON è impostato come una variabile request
o response
e dovrebbe contenere un payload XML, questo errore si verifica se il payload è vuoto.
Diagnostica
Identifica il criterio da XML a JSON in cui si è verificato l'errore. Puoi trovare queste informazioni nell'elemento
faultstring
della risposta di errore. Ad esempio, nel seguentefaultstring
, il nome del criterio èConvert-XMLToJSON
:"faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 1(possibly around char 0)"
Esamina l'elemento
<Source>
nel file XML del criterio da XML a JSON con errori e determina la variabile specificata. Ad esempio, nel seguente criterio da XML a JSON è impostato l'elemento<Source>
da richiedere:<?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>
Controlla se la variabile specificata per l'elemento
<Source>
nel criterio XMLToJSON è vuota. Se il campo è vuoto, è questo il motivo dell'errore.Nell'esempio di criterio da XML a JSON mostrato sopra, il payload della richiesta (ovvero il corpo della richiesta) inviato dal client era vuoto.
Ad esempio:
curl -v "http://<org>-<env>.apigee.net/v1/testxmltojson" -H "Content-Type: application/xml"
Poiché il payload della richiesta XML è vuoto, riceverai il codice di errore:
steps.xml2json.ExecutionFailed
Questo errore può verificarsi anche se l'elemento
<Source>
è impostato in risposta, ma il server di backend trasmette un payload vuoto.
Risoluzione
Assicurati che l'input trasmesso al criterio da XML a JSON tramite l'elemento <Source>
sia un payload XML valido e non vuoto.
Per risolvere il problema relativo al criterio da XML a JSON di esempio, trasmetti un payload XML valido. Ad esempio:
Crea un file denominato city.xml con il seguente contenuto:
<?xml version="1.0" encoding="UTF-8"?> <root> <City>Bengaluru</City> <Name>Apigee</Name> <Pincode>560016</Pincode> </root>
Effettua la chiamata API utilizzando un comando cURL come segue:
curl -v "http://<org>-<env>.apigee.net/v1/testxmltojson" -H "Content-Type: application/xml" -X POST -d @company.xml
Causa: input non valido o non corretto
Se il criterio da XML a JSON analizza un input non valido o in un formato non corretto, viene visualizzato questo errore.
Ad esempio, se viene fornito il seguente codice XML non valido come input nel criterio da XML a JSON:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<City>Bengaluru</City>
<Name>Apigee</Name>
<Pincode>560016</Pincode>
riceverai l'errore:
"faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 6(possibly around char 0)"
Diagnostica
Identifica il criterio da XML a JSON in cui si è verificato l'errore. Puoi trovare queste informazioni nell'elemento
faultstring
della risposta di errore. Ad esempio, nel seguentefaultstring
, il nome del criterio èConvert-XMLToJSON
:"faultstring": "XMLToJSON[Convert-XMLToJSON]: Execution failed. reason: Premature end of document while parsing at line 6(possibly around char 0)"
Esamina l'elemento
<Source>
specificato nel codice XML del criterio da XML a JSON con errori. Ad esempio, nel seguente criterio da XML a JSON l'elemento<Source>
è impostato sulla variabilerequest
:<?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>
Verifica se l'input specificato nell'elemento
<Source>
nel criterio da XML a JSON è un payload XML valido. Se l'input non è valido o è in un formato non corretto, è questa la causa dell'errore.Nel criterio da XML a JSON di esempio mostrato sopra, il seguente codice XML non valido è stato trasmesso al criterio Estrai variabili tramite il file
city.xml
:<?xml version="1.0" encoding="UTF-8"?> <root> <City>Bengaluru</City> <Name>Apigee</Name> <Pincode>560016</Pincode>
Ecco la chiamata API di esempio che mostra come è stata trasmessa la richiesta:
curl -v "http://<org>-<env>.apigee.net/v1/testxmltpjson" -H "Content-Type: application/xml" -X POST -d @city.xml
Il payload XML passato all'API non è valido, poiché il codice XML non ha un tag di fine per l'elemento
<root>
. Riceverai quindi il codice di errore:steps.xml2json.ExecutionFailed
Questo errore può verificarsi anche se l'elemento
<Source>
è stato impostato in risposta, ma il payload della risposta XML del server di backend non è valido o è in un formato non corretto.
Risoluzione
Assicurati che l'input trasmesso al criterio XML al criterio JSON tramite l'elemento <Source>
sia valido e che non sia in un formato valido.
Per risolvere il problema relativo al criterio da XML a JSON di esempio di cui sopra, trasmetti una richiesta di payload XML valida come segue:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<City>Bengaluru</City>
<Name>Apigee</Name>
<Pincode>560016</Pincode>
</root>
OutputVariableIsNotAvailable
Codice di errore
steps.xml2json.OutputVariableIsNotAvailable
Corpo della risposta all'errore
{ "fault": { "faultstring": "XMLToJSON[policy_name]: Output variable is not available.", "detail": { "errorcode": "steps.xml2json.OutputVariableIsNotAvailable" } } }
Esempio di messaggio di errore
{
"fault": {
"faultstring": "XMLToJSON[Convert-XMLToJSON]: Output variable is not available.",
"detail": {
"errorcode": "steps.xml2json.OutputVariableIsNotAvailable"
}
}
}
Causa
Questo errore si verifica se la variabile specificata nell'elemento <Source>
del criterio da XML a JSON è di tipo stringa e l'elemento <OutputVariable>
non è definito. L'elemento <OutputVariable>
è obbligatorio quando la variabile definita nell'elemento <Source>
è di tipo string
.
Diagnostica
Identifica il criterio da XML a JSON in cui si è verificato l'errore. Puoi trovarlo nell'elemento
faultstring
della risposta di errore. Ad esempio, nel seguentefaultstring
, il nome del criterio èConvert-XMLToJSON
:"faultstring": "XMLToJSON[Convert-XMLToJSON]: Output variable is not available."
Nel criterio da XML a JSON non è stato possibile convalidare l'assenza di
<OutputVariable>
.Ecco un esempio di criterio da XML a JSON in cui manca l'elemento
<OutputVariable>
.<?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>
Determina il tipo di variabile specificato nell'elemento
<Source>
:- Individua il codice all'interno del bundle proxy API, in cui la variabile è stata definita per prima.
- Una volta compreso il criterio in cui la variabile viene definita e compilata, devi determinarne il tipo nel seguente modo:
- Verifica il valore dell'attributo tipo (se presente).
- Se l'attributo type non è presente, la variabile viene considerata come una stringa.
- Se il tipo di variabile è
string
, l'errore è questo. Per saperne di più sulle variabili comuni e sui loro tipi, consulta Riferimento variabili.
Ad esempio, guarda la variabile TrackingNumber nelle norme da XML a JSON riportate sopra. È di tipo stringa. Prendiamo in considerazione un criterio Assegna messaggio utilizzato per impostare un valore su una variabile denominata
TrackingNumber
, come mostrato di seguito:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AssignMessage async="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> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
Tieni presente che il tipo di variabile impostato tramite
<AssignVariable>
è stringa. La variabileTrackingNumber
è di tipo stringa.Ricorda che la variabile
TrackingNumber
viene utilizzata nell'elemento<Source>
del criterio da XML a JSON:<Source>TrackingNumber</Source>
Poiché
TrackingNumber
è di tipo stringa e<OutputVariable>
non è presente nel criterio, riceverai il seguente codice di errore:steps.xml2json.OutputVariableIsNotAvailable
Risoluzione
Assicurati che se la variabile specificata nell'elemento <Source>
del criterio XMLToJSON sia di tipo stringa, in questo caso l'elemento <OutputVariable>
sia obbligatorio.
Per correggere il criterio da XML a JSON di cui sopra, includi l'elemento <OutputVariable>
come mostrato di seguito.
<?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
Codice di errore
steps.xml2json.InCompatibleTypes
Corpo della risposta all'errore
{ "fault": { "faultstring": "XMLToJSON[policy_name]: String can not be assigned to message type.", "detail": { "errorcode": "steps.xml2json.InCompatibleTypes" } } }
Esempio di messaggio di errore
{
"fault": {
"faultstring": "XMLToJSON[XMLToJSON_CheckType]: String can not be assigned to message type.",
"detail": {
"errorcode": "steps.xml2json.InCompatibleTypes"
}
}
}
Causa
Questo errore si verifica se il tipo della variabile definita nell'elemento <Source>
e nell'elemento <OutputVariable>
non corrispondono. È obbligatorio che il tipo di variabili contenute all'interno dell'elemento <Source>
e dell'elemento <OutputVariable>
corrisponda.
The valid types are message and string.
Diagnostica
Identifica il criterio da XML a JSON in cui si è verificato l'errore. Puoi trovarlo nell'elemento
faultstring
della risposta di errore. Ad esempio, nel seguentefaultstring
, il nome del criterio èXMLToJSON_CheckType
:"faultstring": "XMLToJSON[XMLToJSON_CheckType]: String can not be assigned to message type."
Nel criterio XML To JSON, che non è stato caricato, nota i valori specificati in
<OutputVariable>
.Ecco un criterio XMLToJSON di esempio con elemento
<OutputVariable>
mancante<?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>
Determina il tipo di variabile specificato negli elementi
<Source>
e<OutputVariable>
:- Individua il codice all'interno del bundle del proxy API, in cui ognuna di queste variabili è stata definita per prima.
- Una volta compreso il criterio in cui la variabile viene definita e compilata, devi determinarne il tipo nel seguente modo:
- Verifica il valore dell'attributo tipo (se presente).
- Se l'attributo type non è presente, la variabile viene considerata come una stringa.
- Se il tipo della variabile specificata in
<Source>
èstring
mentre il tipo di<OutputVariable>
è messaggio o viceversa, allora l'errore è questo. Per saperne di più sulle variabili comuni e sui loro tipi, consulta Riferimento variabili.
Prendi ad esempio il criterio Assegna messaggio utilizzato per impostare un valore su una variabile denominata
TrackingNumber
, come mostrato di seguito:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AssignMessage async="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> <AssignTo createNew="false" transport="http" type="request"/> </AssignMessage>
Tieni presente che il tipo di variabile impostato tramite
<AssignVariable>
è stringa. La variabileTrackingNumber
è di tipo stringa.Ora ricorda che la variabile
TrackingNumber
viene utilizzata nell'elemento<Source>
del criterio XMLToJSON:<Source>TrackingNumber</Source>
Allo stesso modo, ricorda che la variabile
request
viene utilizzata nell'elemento<OutputVariable>
del criterio da XML a JSON:<OutputVariable>request</OutputVariable>
Poiché
TrackingNumber
è di tipostring
mentre la variabileresponse
è di tipomessage
, non sono di tipi incompatibili, pertanto riceverai il seguente codice di errore:steps.xml2json.InCompatibleTypes
L'errore precedente può verificarsi anche se la variabile nell'elemento
<Source>
è di tipomessage
, ma la variabile nell'elemento<OutputVariable>
è di tipo stringa.
Risoluzione
Assicurati che il tipo della variabile definita nell'elemento <Source>
e nell'elemento <OutputVariable>
siano sempre uguali. È obbligatorio che il tipo di variabili contenute all'interno dell'elemento <Source>
e dell'elemento <OutputVariable>
corrisponda.
Per correggere il criterio da XML a JSON di cui sopra, potresti dichiarare un'altra variabile TrackingNumber_output
di tipo string
utilizzando il criterio Assegna messaggio e utilizzare questa variabile nell'elemento <OutputVariable>
del criterio da XML a JSON.
Criterio di assegnazione dei messaggi modificato:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="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>
<AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
Criterio XMLToJSON modificato:
<?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
Codice di errore
steps.xml2json.InvalidSourceType
Corpo della risposta all'errore
{ "fault": { "faultstring": "XMLToJSON[class invalid_class]: Invalid source type class invalid_class. Valid source types are [message, string].", "detail": { "errorcode": "steps.xml2json.InvalidSourceType" } } }
Esempio di messaggio di errore
{
"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"
}
}
}
Causa
Questo errore si verifica se il tipo di variabile utilizzato per definire l'elemento <Source>
non è valido.I tipi di variabile validi sono message
e string
.
Diagnostica
Identifica il tipo di origine non valido utilizzato nel criterio da XML a JSON. Puoi trovare queste informazioni nel messaggio di errore. Ad esempio, nell'errore seguente, il tipo non valido è un numero intero.
"faultstring": "XMLToJSON[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string]."
Esamina tutti i criteri da XML a JSON nello specifico proxy API in cui si è verificato l'errore. Nel criterio XML a JSON con errori, annota il nome della variabile specificata 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>
Determina il tipo di variabile specificata nell'elemento
<Source>
:- Individua il codice all'interno del bundle proxy API, in cui questa variabile è stata definita per prima.
- Una volta compreso il criterio in cui la variabile viene definita e compilata, devi determinarne il tipo nel seguente modo:
- Verifica il valore dell'attributo tipo (se presente).
- Se l'attributo type non è presente, la variabile viene considerata come una stringa.
- Se il tipo della variabile specificata in
<Source>
non è némessage
néstring
, allora l'errore è questo. Per saperne di più sulle variabili comuni e sui loro tipi, consulta Riferimento variabili.
Prendi in considerazione, ad esempio, un criterio ExtractVariables utilizzato per estrarre il valore da un payload XML e imposta il valore sulla variabile
BookCode
in modo che sia di tipointeger
, come mostrato di seguito:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ExtractVariables async="false" continueOnError="false" enabled="true" name="Extract_BookCode"> <DisplayName>Extract_BookCode</DisplayName> <Properties/> <Source>request</Source> <XMLPayload stopPayloadProcessing="false"> <Variable name="BookCode" type="integer"> <XPath>/root/BookCode</XPath> </Variable> </XMLPayload> </ExtractVariables>
Ricorda che la variabile
BookCode
viene utilizzata nell'elemento<Source>
del criterio da XML a JSON:<Source>BookCode</Source>
Poiché il tipo di questa variabile è
Integer
, che non è un tipo<Source>
valido, il proxy API genera un errore e genera l'errore:steps.xml2json.InvalidSourceType
Risoluzione
Assicurati che il tipo della variabile utilizzata per specificare l'elemento <Source>
sia valido. I tipi di <Source>
validi sono message
e string
.
Per evitare il precedente errore relativo al criterio da XML a JSON, puoi utilizzare la variabile request
che è di tipo message
o qualsiasi altra stringa che rappresenti un payload XML valido.