Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione degli errori di deployment del criterio di convalida dei messaggi SOAP

Stai visualizzando la documentazione relativa a Apigee e Apigee ibrido.
Visualizza la documentazione di Apigee Edge.

InvalidResourceType

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non va a buon fine e viene visualizzato questo messaggio di errore:

Error Deploying Revision revision_number to environment
MessageValidation soap_message_validation_policy: Invalid Resource Type resource_type. It should be xsd or wsdl. Context Revision:revision_number;APIProxy:apiproxy_name;Organization:organization;Environment:environment.

Messaggio di errore di esempio

Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Invalid Resource Type py.
It should be xsd or wsdl. Context Revision:1;APIProxy:soapmessagevalidation;
Organization:gsc-hipaa;Environment:test.

Screenshot di errore di esempio

Messaggio di errore relativo a risorsa non valida.

Causa

Questo errore si verifica se l'elemento <ResourceURL> del criterio SOAPMessageValidation è impostato su un tipo di risorsa non supportato dal criterio. I tipi di risorse supportati sono xsd e wsdl.

Diagnosi

Identifica il nome del criterio SOAPMessageValidation e il tipo di risorsa non valido utilizzato nell'elemento <ResourceURL> del criterio. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio SOAPMessageValidation è SOAP-Message-Validation-1 e il tipo di risorsa è py.
```
Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Invalid Resource Type py. It should
be xsd or wsdl. Context Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-
hipaa;Environment:test.
```
Esamina il file XML del criterio SOAPMessageValidation non riuscito. Se il tipo di risorsa specificato per l'elemento <ResourceURL> corrisponde al tipo di risorsa non valida identificato nel passaggio 1 precedente, questa è la causa dell'errore.

Ad esempio, il seguente criterio consente di specificare il tipo di risorsa come py, che corrisponde al contenuto del messaggio di errore:
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" 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>py://Script-1.py</ResourceURL>
</MessageValidation>
```
Poiché il tipo di risorsa utilizzato in <ResourceURL> non è xsd o wsdl, il deployment non riuscirà e verrà restituito l'errore mostrato sopra.

Risoluzione

Assicurati che il tipo di risorsa specificato nell'elemento <ResourceURL> del criterio SOAPMessageValidation sia impostato su xsd o wsdl e che la formattazione del file di risorsa sia corretta.

Per correggere l'esempio di criterio SOAPMessageValidation mostrato sopra, puoi modificare il tipo di risorsa in xsd o wsdl:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" 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>

ResourceCompileFailed

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non va a buon fine e viene visualizzato questo messaggio di errore:

Error Deploying Revision revision_number to environment
MessageValidation soap_message_validation_policy: Failed to compile resource resource. Context Revision:revision_number;APIProxy:apiproxy_name;Organization:organization;Environment:environment.

Messaggio di errore di esempio

Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Failed to compile resource SOAP-Message-Validation-1.wsdl. Context Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-hipaa;Environment:test.

Screenshot di errore di esempio

Impossibile compilare il messaggio di errore relativo alle risorse.

Causa

Questo errore si verifica se lo script della risorsa a cui viene fatto riferimento nell'elemento <ResourceURL> del criterio SOAPMessageValidation contiene un errore che ne impedisce la compilazione durante il deployment.

Diagnosi

Identifica il nome del criterio SOAPMessageValidation e lo script della risorsa utilizzato nel criterio. Puoi trovare entrambe le voci nel messaggio di errore. Ad esempio, nell'errore seguente il nome del criterio SOAPMessageValidation è SOAP-Message-Validation-1 e lo script della risorsa è SOAP-Message-Validation-1.wsdl.
```
Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Failed to compile resource
SOAP-Message-Validation-1.wsdl. Context
Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-hipaa;
Environment:test.
```

Esamina il file XML del criterio SOAPMessageValidation non riuscito e verifica che lo script della risorsa specificato per l'elemento <ResourceURL> corrisponda a quanto indicato nel messaggio di errore.

Ad esempio, il seguente criterio specifica l'elemento <ResourceURL> come SOAP-Message-Validation-1.wsdl, che corrisponde al contenuto del messaggio di errore:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" 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>

Visualizza il file di script di risorse identificato nel passaggio 1 e verifica se esistono potenziali problemi che possono causare errori di compilazione.

Ecco un esempio di file di script di risorse:
```
<?xml version="1.0" encoding="ISO-8859-1"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsd/">
    <wsdl:types>
        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
            <xs:element name="request" type="xs:string"/>
        </xs:schema>
    </wsdl:types>
</wsdl:definitions>
```
Poiché xmlns:wsdl rimanda a un URL non valido, il deployment non andrà a buon fine e verrà restituito l'errore mostrato sopra.

Risoluzione

Assicurati che lo script della risorsa specificato nell'elemento <ResourceURL> del criterio SOAPMessageValidation non abbia problemi che ne impediscono la compilazione.

Per correggere lo script SOAP-Message-Validation-1.wsdl mostrato sopra, puoi modificare xmlns:wsdl in modo che punti a un URL valido:

<?xml version="1.0" encoding="ISO-8859-1"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:types>
        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
            <xs:element name="request" type="xs:string"/>
        </xs:schema>
    </wsdl:types>
</wsdl:definitions>

RootElementNameUnspecified

Messaggio di errore

Il salvataggio del proxy API tramite la UI o l'API Apigee non va a buon fine e viene visualizzato questo messaggio di errore:

Error Saving Revision revision_number
MessageValidation soap_message_validation_policy:
RootElement name is not specified.

Messaggio di errore di esempio

Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name is not specified.

Screenshot di errore di esempio

Messaggio di errore Nome RootElement non specificato.

Causa

Questo errore si verifica se l'elemento <Element> nel criterio SOAPMessageValidation non contiene il nome dell'elemento principale.

Diagnosi

Identifica il nome del criterio SOAPMessageValidation in cui si è verificato l'errore. Ad esempio, nell'errore seguente, il nome del criterio SOAPMessageValidation è SOAP-Message-Validation-1:
```
Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name is not specified.
```

Esamina il file XML del criterio SOAPMessageValidation non riuscito. Se il nome dell'elemento principale utilizzato per la convalida non è specificato nell'elemento <Element>, questa è la causa dell'errore.

Ad esempio, il seguente criterio non specifica il nome dell'elemento principale:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true"
name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices"/>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

Poiché il nome dell'elemento principale non è specificato, il deployment avrà esito negativo con l'errore mostrato sopra.

Risoluzione

Assicurati che l'elemento <Element> del criterio SOAPMessageValidation contenga l'elemento principale corretto.

Per correggere il criterio SOAPMessageValidation mostrato sopra, puoi modificare <Element> e aggiungere un elemento principale valido come indicato di seguito:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true"
name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

InvalidRootElementName

Messaggio di errore

Il salvataggio del proxy API tramite la UI o l'API Apigee non va a buon fine e viene visualizzato questo messaggio di errore:

Error Saving Revision revision_number
MessageValidation soap_message_validation_policy: RootElement name root_element_name is invalid.

Messaggio di errore di esempio

Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name 1GetPriceResponse
is invalid.

Screenshot di errore di esempio

Il messaggio di errore del nome RootElement 1GetPriceResponse non è valido.

Causa

Questo errore si verifica se l'elemento <Element> nel criterio SOAPMessageValidation contiene un nome di elemento principale che non rispetta le regole XML per la denominazione valida degli elementi.

Diagnosi

Identifica il nome del criterio SOAPMessageValidation in cui si è verificato l'errore. Ad esempio, nell'errore seguente, il nome del criterio SOAPMessageValidation è SOAP-Message-Validation-1:
```
Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name 1GetPriceResponse
is invalid.
```

Esamina il file XML del criterio SOAPMessageValidation non riuscito. Se il nome dell'elemento principale specificato nell'elemento <Element> non corrisponde ai criteri di un nome di elemento XML valido, questo è la causa dell'errore.

Ad esempio, il seguente criterio ha un nome di elemento radice che inizia con un numero, che non è valido. Anche un nome di elemento contenente spazi non sarebbe valido.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true"
name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
     <Element namespace="http://schemas.xmlsoap.org/soap/prices">1GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

Risoluzione

Assicurati che l'elemento <Element> del criterio SOAPMessageValidation contenga un nome di elemento principale valido.

Per correggere il criterio SOAPMessageValidation mostrato sopra, puoi modificare l'elemento <Element> in modo che contenga un nome di elemento radice valido, come mostrato di seguito:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

NoElements

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non va a buon fine e viene visualizzato questo messaggio di errore:

Error Deploying Revision revision_number
Resource "resource_url" has no element definitions.

Messaggio di errore di esempio

Error Deploying Revision 2 to test
Resource "xsd://Script-1.xsd" has no element definitions.

Screenshot di errore di esempio

La risorsa non ha un messaggio di errore relativo alle definizioni di elementi.

Causa

Questo errore si verifica se il file di risorse specificato nell'elemento <Resource> del criterio SOAPMessageValidation non contiene elementi utilizzabili per la convalida.

Diagnosi

Identifica le definizioni degli elementi mancanti nel file di risorse nel messaggio di errore. Ad esempio, nell'errore seguente, il file di risorse utilizzato nella è xsd://Script-1.xsd:
```
Error Deploying Revision 2 to test
Resource "xsd://Script-1.xsd" has no element definitions.
```
Esamina il file di risorse identificato nel passaggio 1. Se non ci sono elementi definiti, è la causa dell'errore.

Ad esempio, il seguente file di risorse Script-1.xsd non contiene elementi:
```
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
</xsd:schema>
```
Poiché il file della risorsa non contiene alcun elemento, il deployment non andrà a buon fine con l'errore mostrato sopra.

Risoluzione

Assicurati che il file di risorse utilizzato nel criterio SOAPMessageValidation contenga le definizioni degli elementi pertinenti.

Per correggere il file di risorse di esempio mostrato sopra, puoi modificare il file xsd per aggiungere i seguenti contenuti:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="shipOrder" type="order"/>
<xsd:complexType name="order">
<xsd:sequence>
<xsd:element name="shipTo" type="shipAddress"/>
<xsd:element name="items" type="cdItems"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="shipAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="street" type="xsd:string"/>
<xsd:element name="address" type="xsd:string"/>
<xsd:element name="country" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="cdItems">
<xsd:sequence>
<xsd:element name="item" type="cdItem" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="cdItem">
<xsd:sequence>
<xsd:element name="title" type="xsd:string"/>
<xsd:element name="quantity" type="xsd:integer"/>
<xsd:element name="price" type="xsd:decimal"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>