Risoluzione dei problemi relativi agli errori di deployment dei criteri di convalida dei messaggi SOAP

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

InvalidResourceType

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API di gestione perimetrale non va a buon fine e 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

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

  1. 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.
    
  2. 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 avrà esito negativo con 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 di gestione perimetrale non va a buon fine e 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

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

  1. 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.
    
  2. Esamina il codice 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>
    
  3. Visualizza il file di script della risorsa identificato nel passaggio 1 e verifica se sono presenti 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 con l'errore mostrato sopra.

Risoluzione

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

Per correggere lo script SOAP-Message-Validation-1.wsdl mostrato sopra, puoi modifica 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 di Edge o l'API di gestione perimetrale non va a buon fine con 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

Causa

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

Diagnosi

  1. Identifica il nome del criterio SOAPMessageValidation in cui si è verificato l'errore. Per 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.
    
  2. Esamina il file XML del criterio SOAPMessageValidation non riuscito. Se il nome dell'elemento principale utilizzato per la convalida non è specificato nell'elemento <Element>, allora 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 non andrà a buon fine e verrà restituito 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 il valore <Element> e aggiungi 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 di Edge o l'API di gestione perimetrale non va a buon fine con 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

Causa

Questo errore si verifica se l'elemento <Element> nel criterio SOAPMessageValidation contiene un nome di elemento principale che non ottempera alle regole XML per l'elemento valido di denominazione.

Diagnosi

  1. 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.
    
  2. 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 XML valido dell'elemento, questa è la causa dell'errore.

    Ad esempio, il seguente criterio ha un nome di elemento principale 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 il valore <Element> elemento deve contenere un nome di elemento principale 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 di Edge o l'API di gestione perimetrale non va a buon fine con 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

Causa

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

Diagnosi

  1. 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.
    
  2. Esamina il file di risorse identificato nel passaggio 1. Se non sono stati definiti elementi, questa è 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 di risorse non contiene alcun elemento, il deployment non riuscirà 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>