Criterio di SOAPMessageValidation

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Il criterio SOAPMessageValidation:

• Convalida qualsiasi messaggio XML in base ai relativi schemi XSD
• Convalida i messaggi SOAP in base a una definizione WSDL
• Determina la formattazione corretta dei messaggi JSON e XML.

Anche se il nome di questo criterio nell'interfaccia utente è SOAPMessageValidation, il criterio non convalida solo i messaggi SOAP. Questa sezione fa riferimento al criterio MessageValidation.

Questo è un criterio standard e può essere implementato in qualsiasi tipo di ambiente. Non tutti gli utenti devono conoscere i tipi di criteri e di ambiente. Per informazioni sui tipi di criteri e sulla disponibilità con ogni tipo di ambiente, consulta Tipi di criteri.

Informazioni sul criterio MessageValidation

Vantaggi

La convalida dei messaggi offre i seguenti vantaggi:

• Informa immediatamente gli sviluppatori di app che utilizzano la tua API se le loro richieste sono non conformi o incomplete.
• Problemi di rilevamento dei punti nelle richieste, ad esempio tag XML che non sono stati chiusi correttamente.
• Protegge i servizi di backend bloccando i messaggi XML o SOAP con strutture che potrebbero causare comportamenti imprevedibili.
• Riduzione del tempo dedicato alla risoluzione dei problemi, alla ricerca nei forum o alla consulenza con l'assistenza tecnica.
• Incoraggia gli sviluppatori ad acquisire familiarità con la definizione WSDL dello schema XML per eliminare gli errori di convalida, rendendo gli schemi XML ben comprensibili un componente chiave della documentazione dell'API.

Video

Guarda i seguenti video per saperne di più sulle norme di MessageValidation:

Video	Descrizione
Convalida richiesta XML	Convalida la richiesta XML per un'API utilizzando il criterio MessageValidation.
Convalida richiesta JSON	Convalida la richiesta JSON per un'API utilizzando il criterio MessageValidation.

<MessageValidation> elemento

Definisce il criterio MessageValidation.

Valore predefinito	Consulta la scheda Criterio predefinito di seguito
Obbligatorio?	Facoltativo
Tipo	Oggetto complesso
Elemento principale	n/d
Elementi secondari	<DisplayName> <Element> <ResourceURL> <SOAPMessage> <Source>

Sintassi

L'elemento <MessageValidation> utilizza la seguente sintassi:

<MessageValidation
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
    <!-- All MessageValidation child elements are optional -->
    <DisplayName>policy_display_name</DisplayName>
    <Element namespace="element_namespace">element_to_validate</Element>
    <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
    <Source>message_to_validate</Source>
    <ResourceURL>validation_WSDL_or_XSD</ResourceURL>

</MessageValidation>

Criterio predefinito

L'esempio seguente mostra le impostazioni predefinite quando aggiungi un criterio MessageValidation al flusso nell'interfaccia utente di Apigee:

<MessageValidation continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
  <DisplayName>SOAP Message Validation-1</DisplayName>
  <Properties/>
  <Element namespace="http://sample.com">sampleObject</Element>
  <SOAPMessage/>
  <Source>request</Source>
  <ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
</MessageValidation>

Questo elemento ha i seguenti attributi comuni a tutti i criteri:

Attributo	Predefinito	Obbligatorio?	Descrizione
name	N/A	Obbligatorio	Il nome interno del criterio. Il valore dell'attributo name può contenere lettere, numeri, spazi, trattini, trattini bassi e punti. Questo valore non può superare i 255 caratteri. Facoltativamente, utilizza l'elemento <DisplayName> per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso in linguaggio naturale.
continueOnError	falso	Facoltativo	Imposta su false per restituire un errore in caso di errore del criterio. Questo è un comportamento previsto per la maggior parte dei criteri. Imposta su true per continuare l'esecuzione del flusso anche dopo un errore nel criterio. Vedi anche: Le regole di errore vengono attivate SOLO in uno stato di errore (su continueOnError) Gestione degli errori nel flusso corrente
enabled	true	Facoltativo	Imposta su true per applicare il criterio. Imposta su false per disattivare il criterio. Il criterio non verrà applicato anche se rimane collegato a un flusso.
async	falso	Deprecato	Questo attributo è stato ritirato.

Esempi

I seguenti esempi mostrano alcuni modi in cui è possibile utilizzare il criterio MessageValidation:

1. Convalida XSD

Puoi utilizzare il criterio di convalida dei messaggi per convalidare il payload di una richiesta di messaggio XML in base a uno schema XSD.

1. Crea un nuovo file di risorse XSD. Ad esempio, note-schema.xsd:

   <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
     <xs:element name="note">
       <xs:complexType>
         <xs:sequence>
           <xs:element name="to" type="xs:string"/>
           <xs:element name="from" type="xs:string"/>
           <xs:element name="heading" type="xs:string"/>
           <xs:element name="body" type="xs:string"/>
         </xs:sequence>
       </xs:complexType>
     </xs:element>
   </xs:schema>

2. Aggiungi il criterio di convalida dei messaggi SOAP al pre-flusso dell'endpoint proxy:
   1. Specifica la località del file di risorse XSD con l'elemento <ResourceURL>. Ad esempio:

      ...
        <ResourceURL>xsd://note-schema.xsd</ResourceURL>
      ...

   2. Rimuovi gli elementi <SOAPMessage> e <Element> dalla definizione del criterio.

   La definizione delle norme dovrebbe avere il seguente aspetto:

   <MessageValidation continueOnError="false"
       enabled="true" name="validateXMLRequest">
     <DisplayName>My XML Validator</DisplayName>
     <Properties/>
     <Source>request</Source>
     <ResourceURL>xsd://note-schema.xsd</ResourceURL>
   </MessageValidation>

3. Invia una richiesta POST al tuo proxy API utilizzando il tuo XML come payload del messaggio, come mostrato nell'esempio seguente:

   curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     -d '<note>
     <to>Fred Rogers</to>
     <from>Nick Danger</from>
     <heading>Greetings from my neighborhood</heading>
     <body>Just writing to say hello.</body>
   </note>'

   Tieni presente che l'intestazione Content-type è impostata su application/xml.

   Puoi anche creare un file di dati per il payload e farvi riferimento con un comando simile al seguente:

   curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     --data '@../examples/note-payload.xml'

Dovresti ricevere una risposta HTTP 200. A seconda dell'endpoint di destinazione, potresti ricevere dettagli aggiuntivi sulla richiesta. Ad esempio, se utilizzi http://httpbin.org/post come endpoint di destinazione e specifichi un output -v (dettagliato), la risposta dovrebbe essere simile alla seguente:

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

Per verificare che la convalida XSD funzioni, prova a inserire un altro tag nel corpo della richiesta. Ad esempio:

curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  -d '<note>
  <to>Fred Rogers</to>
  <from>Nick Danger</from>
  <heading>Greetings from my neighborhood</heading>
  <body>Just writing to say hello.</body>
  <badTag>Not good</badTag>
</note>'

Dovresti ricevere un errore di convalida.

2: Convalida SOAP

Puoi utilizzare il criterio di convalida dei messaggi per convalidare il payload di una richiesta di messaggio SOAP a fronte di un WSDL.

1. Crea un nuovo file di risorse WSDL. Ad esempio, "example-wsdl.wsdl":

   Visualizza WSDL completo

   <?xml version="1.0" encoding="UTF-8"?>
   <wsdl:definitions targetNamespace="https://example.com/gateway"
       xmlns:tns="https://example.com/gateway"
       xmlns:types="https://example.com/gateway/types"
       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
       xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
       xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/">
     <wsdl:types>
       <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
           targetNamespace="https://example.com/gateway/types"
           elementFormDefault="qualified">
         <xsd:element name="MyType">
           <xsd:complexType>
             <xsd:sequence>
               <xsd:element name="ID" nillable="false" minOccurs="1" maxOccurs="1"/>
             </xsd:sequence>
           </xsd:complexType>
         </xsd:element>
       </xsd:schema>
       <schema attributeFormDefault="unqualified" elementFormDefault="qualified"
           targetNamespace="https://example.com/gateway"
           xmlns="http://www.w3.org/2001/XMLSchema">
         <xsd:import namespace="https://example.com/gateway/types"/>
         <element name="getID">
           <complexType>
             <sequence>
               <element ref="types:MyType"/>
             </sequence>
           </complexType>
         </element>
       </schema>
     </wsdl:types>
   
     <wsdl:message name="getRequest">
       <wsdl:part name="getRequest" element="tns:getID"/>
     </wsdl:message>
     <wsdl:message name="getResponse">
       <wsdl:part name="getResponse" element="tns:getID"/>
     </wsdl:message>
   
     <wsdl:portType name="PortType">
       <wsdl:operation name="get">
         <wsdl:input name="methodRequest" message="tns:getRequest"/>
         <wsdl:output name="methodResponse" message="tns:getResponse"/>
       </wsdl:operation>
     </wsdl:portType>
   
     <wsdl:service name="Gateway">
       <wsdl:port name="GatewaySoap" binding="tns:SoapBinding">
         <wsdlsoap:address location="https://example.com/gateway"/>
       </wsdl:port>
     </wsdl:service>
   
     <wsdl:binding name="SoapBinding" type="tns:PortType">
       <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
   
       <wsdl:operation name="get">
         <wsdlsoap:operation soapAction="get"/>
         <wsdl:input name="methodRequest"/>
         <wsdl:output name="methodResponse"/>
       </wsdl:operation>
   
     </wsdl:binding>
   </wsdl:definitions>

2. Aggiungi il criterio di convalida dei messaggi SOAP al pre-flusso dell'endpoint proxy:
   1. Imposta l'attributo version dell'elemento <SOAPMessage> sulla versione del protocollo SOAP in base a cui vuoi eseguire la convalida. Ad esempio, "1.1":

      ...
        <SOAPMessage version="1.1"/>
      ...

   2. Imposta il valore dell'elemento <Element> sull'elemento che vuoi convalidare:

      ...
        <Element namespace="https://example.com/gateway">getID</Element>
      ...

      <Element> specifica il primo elemento secondario sotto l'elemento <Body> nella busta della richiesta SOAP.

      Imposta l'attributo namespace sullo spazio dei nomi per il file figlio.

   3. Specifica la località del file di risorse WSDL con l'elemento <ResourceURL>. Ad esempio:

      ...
        <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
      ...

   La definizione delle norme dovrebbe avere il seguente aspetto:

   <MessageValidation continueOnError="false"
       enabled="true" name="validateSOAPRequest">
     <DisplayName>My SOAP Validator</DisplayName>
     <Properties/>
     <Source>request</Source>
     <SOAPMessage version="1.1"/>
     <Element namespace="https://example.com/gateway">getID</Element>
     <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
   </MessageValidation>

3. Invia una richiesta POST al tuo proxy API con la busta SOAP come payload del messaggio, come illustrato nell'esempio seguente:

   curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     -d '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:prox="https://example.com/gateway" xmlns:typ="https://example.com/gateway/types">
     <soapenv:Header/>
     <soapenv:Body>
       <prox:getID>
         <typ:MyType>
           <typ:ID>42</typ:ID>
         </typ:MyType>
       </prox:getID>
     </soapenv:Body>
   </soapenv:Envelope>'

   Tieni presente che l'intestazione Content-type è impostata su "application/xml".

   Puoi anche creare un file di dati per il payload e farvi riferimento con un comando simile al seguente:

   curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     --data '@../examples/soap-payload.xml'

Dovresti ricevere una risposta HTTP 200. A seconda dell'endpoint di destinazione, potresti ricevere dettagli aggiuntivi sulla richiesta. Ad esempio, se utilizzi http://httpbin.org/post come endpoint di destinazione, la risposta dovrebbe essere simile alla seguente:

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

3: XML/JSON con formato corretto

Puoi utilizzare il criterio di convalida dei messaggi per confermare che un payload di messaggi JSON o XML sia nel formato corretto (non equivale alla convalida). Le norme garantiscono che la struttura e i contenuti soddisfino standard accettati, tra cui:

• C'è un solo elemento radice
• I contenuti non contengono caratteri illegali
• Oggetti e tag sono nidificati correttamente
• I tag di inizio e fine corrispondono

Per verificare la presenza di un payload XML o JSON con formato corretto:

1. Aggiungi il criterio di convalida dei messaggi SOAP al pre-flusso del tuo endpoint proxy.
2. Rimuovi gli elementi <ResourceURL>, <SOAPMessage> e <Element> dalla definizione del criterio.

   La definizione delle norme dovrebbe avere il seguente aspetto:

   <MessageValidation async="false" continueOnError="false"
       enabled="true" name="validateXMLRequest">
     <DisplayName>My JSON Checker</DisplayName>
     <Properties/>
     <Source>request</Source>
   </MessageValidation>

3. Invia una richiesta POST al tuo proxy API, come illustrato nell'esempio seguente:

   curl -v -X POST -H 'Content-Type: application/json' http://my-test.apigee.net/v1/xsd-mock
     -d '{
   "note": {
     "to": "Fred Rogers",
     "from": "Nick Danger",
     "header": "Greetings from my neighborhood",
     "body": "Just writing to say hello."
     }
   }'

   Tieni presente che l'intestazione Content-type è impostata su application/json.

   Per verificare che un file XML sia nel formato corretto, utilizza XML come payload del messaggio e imposta Content-type su application/xml.

Dovresti ricevere una risposta HTTP 200. Quando invii un payload del messaggio che non contiene un formato XML o JSON corretto, dovresti ricevere un errore steps.messagevalidation.Failed.

Riferimento elemento secondario

In questa sezione vengono descritti gli elementi secondari di <MessageValidation>.

<DisplayName>

Utilizzalo in aggiunta all'attributo name per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso e più naturale.

L'elemento <DisplayName> è comune a tutti i criteri.

Valore predefinito	N/A
Obbligatorio?	Facoltativo. Se ometti <DisplayName>, viene utilizzato il valore dell'attributo name del criterio.
Tipo	Stringa
Elemento principale	<PolicyElement>
Elementi secondari	Nessuna esperienza

La sintassi dell'elemento <DisplayName> è la seguente:

Sintassi

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Esempio

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

L'elemento <DisplayName> non ha attributi o elementi secondari.

<Element>

Specifica l'elemento del messaggio da convalidare. Questo è il primo elemento secondario sotto l'elemento <Body> nella busta della richiesta SOAP.

Valore predefinito	sampleObject
Obbligatorio?	Facoltativo
Tipo	Stringa
Elemento principale	<MessageValidation>
Elementi secondari	Nessuna selezione

L'elemento <Element> utilizza la seguente sintassi:

Sintassi

...
  <Element namespace="element_namespace">element_to_validate</Element>
...

Esempio 1

L'esempio seguente definisce un singolo elemento da convalidare:

...
<Element namespace="https://example.com/gateway">getID</Element>
...

Esempio 2

Puoi specificare più di un elemento da convalidare aggiungendo più elementi <Element>:

...
<Element namespace="https://example.com/gateway">getID</Element>
<Element namespace="https://example.com/gateway">getDetails</Element>
...

L'elemento <Element> ha i seguenti attributi:

Attributo	Predefinito	Obbligatorio?	Descrizione
namespace	"http://sample.com"	Facoltativo	Definisce lo spazio dei nomi dell'elemento da convalidare.

<ResourceURL>

Identifica lo schema XSD o la definizione WSDL da utilizzare per convalidare il messaggio di origine.

Valore predefinito	wsdl://display_name.wsdl
Obbligatorio?	Facoltativo
Tipo	Stringa
Elemento principale	<MessageValidation>
Elementi secondari	Nessuna selezione

L'elemento <ResourceURL> utilizza la seguente sintassi:

Sintassi

...
  <ResourceURL>[wsdl|xsd]://validation_WSDL_or_XSD</ResourceURL>
...

Esempi

Per un file XML:

...
<ResourceURL>xsd://note-schema.xsd</ResourceURL>
...

Per un WSDL:

...
<ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
...

Il valore di <ResourceURL> deve puntare a un file di risorse nel proxy API. Non può fare riferimento a risorse esterne tramite HTTP o HTTPS.

Se non specifichi un valore per <ResourceURL>, il messaggio viene controllato per verificare la presenza di JSON o XML nel formato corretto se l'intestazione Content-type è rispettivamente application/json o application/xml.

L'elemento <ResourceURL> non ha elementi o attributi secondari.

Utilizzare gli XSD per la convalida

Se il payload XML convalidato con il criterio MessageValidation fa riferimento a un altro schema, devi far precedere il file XSD incluso con xsd nell'attributo schemaLocation.

Il seguente schema di esempio è composto da più XSD:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    elementFormDefault="qualified" attributeFormDefault="unqualified">
  <xs:include schemaLocation="xsd://note-schema.xsd"/>
  <xs:include schemaLocation="xsd://letter-schema.xsd"/>
  <xs:include schemaLocation="xsd://user-schema.xsd"/>
</xs:schema>

Nota:puoi includere o importare XSD solo se si tratta di file di risorse nel tuo proxy API. Non puoi includere file XSD esterni.

Utilizzo dei WSDL per la convalida

Un WSDL deve definire almeno uno schema. Se non fa riferimento ad almeno uno schema, il criterio MessageValidation ha esito negativo.

La profondità di importazione massima per uno schema è 10. Se superi questo numero di importazioni nidificate, il criterio MessageValidation avrà esito negativo.

<SOAPMessage>

Definisce la versione SOAP in base alla quale viene convalidato il criterio MessageValidation.

Valore predefinito	n/d
Obbligatorio?	Facoltativo
Tipo	n/d
Elemento principale	<MessageValidation>
Elementi secondari	Nessuna selezione

L'elemento <SOAPMessage> utilizza la seguente sintassi:

Sintassi

...
  <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
...

Esempio

...
<SOAPMessage version="1.1"/>
...

L'elemento <SOAPMessage> ha i seguenti attributi:

Attributo	Predefinito	Obbligatorio?	Descrizione
version	Nessuna selezione	Facoltativo	La versione SOAP utilizzata da questo criterio per convalidare i messaggi SOAP. I valori validi sono: "1,1" "1,2" "1,1/1,2"

Per maggiori informazioni, consulta Da SOAP/1.1 a SOAP Versione 1.2 in 9 punti.

<Source>

Identifica il messaggio di origine da convalidare. Il valore di questo elemento è il nome del messaggio che vuoi convalidare.

Se non configuri <Source>, questo criterio verrà impostato in modo predefinito su message, che si riferisce al messaggio di richiesta completo (in un flusso di richiesta) o al messaggio di risposta (in un flusso di risposta), inclusi eventuali payload. Puoi anche impostarlo esplicitamente su request o response per fare riferimento alla richiesta o alla risposta.

Valore predefinito	request
Obbligatorio?	Facoltativo
Tipo	Stringa
Elemento principale	<MessageValidation>
Elementi secondari	Nessuna selezione

L'elemento <Source> utilizza la seguente sintassi:

Sintassi

...
  <Source>message_to_validate</Source>
...

Esempio

...
<Source>request</Source>
...

Oltre a message, request e response, puoi impostare il valore di <Source> sul nome di qualsiasi messaggio nel flusso. Se lo fai, tuttavia, devi creare un messaggio personalizzato con quel nome nel flusso prima dell'esecuzione di questo criterio. In caso contrario, verrà visualizzato un errore.

Se il valore di <Source> non può essere risolto nel flusso di messaggi o si risolve in un tipo non di messaggio, si verifica uno dei seguenti casi:

• Se il valore è null: Apigee genera un errore steps.messagevalidation.SourceMessageNotAvailable.
• Se non è di tipo messaggio: Apigee genera un errore steps.messagevalidation.NonMessageVariable.

L'elemento <Source> non ha attributi o elementi secondari.

Codici di errore

Questa sezione descrive i codici e i messaggi di errore che vengono restituiti e le variabili di errore impostate da Apigee quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Hai bisogno di aiuto per risolvere un errore? Fai clic su nella colonna Correggi per informazioni dettagliate sulla risoluzione dei problemi.

Utilizza il monitoraggio delle API per esaminare i codici di errore e diagnosticare i problemi più velocemente. Per un esempio, consulta Configurare un avviso relativo al codice di errore del criterio. Consulta la sezione Riferimento codice di errore per un elenco completo di tutti i codici di errore che puoi gestire con API Monitoring.

Codice di errore	Stato HTTP	Causa	Correggi
steps.messagevalidation.SourceMessageNotAvailable	500	Questo errore si verifica se una variabile specificata nell'elemento <Source> del criterio è: fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o non può essere risolto (non è definito)
steps.messagevalidation.NonMessageVariable	500	Questo errore si verifica se l'elemento <Source> nel criterio SOAPMessageValidation è impostato su una variabile non di tipo messaggio. Le variabili del tipo di messaggio rappresentano intere richieste e risposte HTTP. Le variabili di flusso Apigee integrate request, response e message sono di tipo messaggio. Per scoprire di più sulle variabili messaggio, consulta la documentazione di riferimento sulle variabili.
steps.messagevalidation.Failed	500	Questo errore si verifica se il criterio SOAPMessageValidation non riesce a convalidare il payload dei messaggi di input in base allo schema XSD o alla definizione WSDL. Si verifica anche se il formato JSON o XML del messaggio del payload è in formato errato.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Hai bisogno di aiuto per risolvere un errore? Fai clic su accanto alla descrizione della causa dell'errore per visitare la pagina di risoluzione dei problemi.

Nome errore	Causa	Correggi
InvalidResourceType	L'elemento <ResourceURL> nel criterio SOAPMessageValidation è impostato su un tipo di risorsa non supportato dal criterio.
ResourceCompileFailed	Lo script della risorsa a cui viene fatto riferimento nell'elemento <ResourceURL> del criterio SOAPMessageValidation contiene un errore che ne impedisce la compilazione.
RootElementNameUnspecified	L'elemento <Element> nel criterio SOAPMessageValidation non contiene il nome dell'elemento principale.
InvalidRootElementName	L'elemento <Element> nel criterio SOAPMessageValidation contiene un nome dell'elemento principale che non ottempera alle regole XML per la denominazione di elementi validi.

Schema

Ogni tipo di criterio è definito da uno schema XML (.xsd). Per riferimento, gli schemi dei criteri sono disponibili su GitHub.

Argomenti correlati

• Criterio di protezione dalle minacce XML
• Criterio da XML a JSON
• Norme da JSON a XML
• Criteri di JSON Threat Protection