Устранение ошибок развертывания политики проверки сообщений SOAP

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

InvalidResourceType

Сообщение об ошибке

Развертывание API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже:

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.

Пример сообщения об ошибке 

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.

Пример скриншота ошибки

Причина

Эта ошибка возникает, если элемент <ResourceURL> в политике SOAPMessageValidation задан для типа ресурса, не поддерживаемого данной политикой. Поддерживаемые типы ресурсов: xsd и wsdl .

Диагноз

  1. Определите имя политики SOAPMessageValidation и недопустимый тип ресурса, используемые в элементе <ResourceURL> политики. Оба эти элемента можно найти в сообщении об ошибке. Например, в следующей ошибке имя политики SOAPMessageValidation — SOAP-Message-Validation-1 , а тип ресурса — 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. Изучите XML-файл политики проверки SOAPMessageValidation, в котором произошла ошибка. Если тип ресурса, указанный для элемента <ResourceURL> совпадает с недопустимым типом ресурса, выявленным на шаге 1 выше, то это и есть причина ошибки.

    Например, следующая политика указывает тип ресурса как py , что соответствует содержимому сообщения об ошибке:

    <?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>

    Поскольку тип ресурса, используемый в <ResourceURL> , не является xsd или wsdl , развертывание завершится с ошибкой, указанной выше.

Разрешение

Убедитесь, что тип ресурса, указанный в элементе <ResourceURL> политики SOAPMessageValidation, установлен либо на xsd , либо на wsdl , и что файл ресурса имеет правильное форматирование.

Чтобы исправить приведенную выше политику SOAPMessageValidation, можно изменить тип ресурса на xsd или 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

Сообщение об ошибке

Развертывание API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже:

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.

Пример сообщения об ошибке 

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.

Пример скриншота ошибки

Причина

Эта ошибка возникает, если скрипт ресурса, на который ссылается элемент <ResourceURL> политики SOAPMessageValidation, содержит ошибку, препятствующую его компиляции во время развертывания.

Диагноз

  1. Определите имя политики SOAPMessageValidation и используемый в ней скрипт ресурсов. Оба эти элемента можно найти в сообщении об ошибке. Например, в следующем сообщении об ошибке имя политики SOAPMessageValidation — SOAP-Message-Validation-1 , а скрипт ресурсов — 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. Изучите XML-файл политики SOAPMessageValidation, в котором произошла ошибка, и убедитесь, что скрипт ресурса, указанный для элемента <ResourceURL> соответствует содержимому сообщения об ошибке.

    Например, следующая политика указывает элемент <ResourceURL> как SOAP-Message-Validation-1.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>

  3. Просмотрите файл скрипта ресурсов, указанный на шаге 1, и проверьте, нет ли в нем потенциальных проблем, которые могут привести к ошибкам компиляции.

    Вот пример файла скрипта ресурсов: 

    <?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>

    Поскольку xmlns:wsdl указывает на недопустимый URL-адрес, развертывание завершится с ошибкой, указанной выше.

Разрешение

Убедитесь, что скрипт ресурсов, указанный в элементе <ResourceURL> политики SOAPMessageValidation, не имеет проблем, препятствующих его компиляции.

Чтобы исправить приведенный выше скрипт SOAP-Message-Validation-1.wsdl , вы можете изменить xmlns:wsdl , указав в нем действительный URL-адрес: 

<?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

Сообщение об ошибке

Сохранение API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже: 

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

Пример сообщения об ошибке 

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

Пример скриншота ошибки

Причина

Эта ошибка возникает, если элемент <Element> в политике SOAPMessageValidation не содержит имя корневого элемента.

Диагноз

  1. Укажите имя политики SOAPMessageValidation, в которой произошла ошибка. Например, в следующем примере имя политики SOAPMessageValidation — SOAP-Message-Validation-1 : 

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

  2. Изучите XML-файл политики проверки SOAPMessageValidation, в котором произошла ошибка. Если имя корневого элемента, используемого для проверки, не указано в элементе <Element> , то это и является причиной ошибки.

    Например, следующая политика не указывает имя корневого элемента: 

    <?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>

    Поскольку имя корневого элемента не указано, развертывание завершится с ошибкой, показанной выше.

Разрешение

Убедитесь, что элемент <Element> политики SOAPMessageValidation содержит правильный корневой элемент.

Чтобы исправить политику SOAPMessageValidation, показанную выше, вы можете изменить <Element> и добавить допустимый корневой элемент, как показано ниже: 

<?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

Сообщение об ошибке

Сохранение API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже: 

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

Пример сообщения об ошибке 

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

Пример скриншота ошибки

Причина

Эта ошибка возникает, если элемент <Element> в политике SOAPMessageValidation содержит имя корневого элемента, которое не соответствует правилам XML для допустимого именования элементов.

Диагноз

  1. Укажите имя политики SOAPMessageValidation, в которой произошла ошибка. Например, в следующем примере имя политики SOAPMessageValidation — SOAP-Message-Validation-1 : 

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

  2. Изучите XML-файл политики SOAPMessageValidation, в котором произошла ошибка. Если имя корневого элемента, указанное в элементе <Element> , не соответствует критериям допустимого имени XML-элемента, то это и является причиной ошибки.

    Например, в следующей политике имя корневого элемента начинается с цифры, что является недопустимым. Имя элемента, содержащее пробелы, также будет недопустимым. 

    <?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>

Разрешение

Убедитесь, что элемент <Element> политики SOAPMessageValidation содержит допустимое имя корневого элемента.

Чтобы исправить политику SOAPMessageValidation, показанную выше, вы можете изменить элемент <Element> , указав в нем допустимое имя корневого элемента, как показано ниже: 

<?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

Сообщение об ошибке

Развертывание API-прокси через пользовательский интерфейс Edge или API управления Edge завершается с ошибкой, о которой сообщается ниже: 

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

Пример сообщения об ошибке 

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

Пример скриншота ошибки

Причина

Эта ошибка возникает, если файл ресурсов, указанный в элементе <Resource> политики SOAPMessageValidation, не содержит элементов, которые можно использовать для проверки.

Диагноз

  1. Укажите в сообщении об ошибке, в каком файле ресурсов отсутствуют определения элементов. Например, в следующем сообщении об ошибке используется файл ресурсов xsd://Script-1.xsd : 

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

  2. Проверьте файл ресурсов, указанный на шаге 1. Если в нем не определены никакие элементы, то это и является причиной ошибки.

    Например, следующий ресурсный файл Script-1.xsd не содержит никаких элементов: 

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
</xsd:schema>

    Поскольку файл ресурсов не содержит никаких элементов, развертывание завершится с ошибкой, указанной выше.

Разрешение

Убедитесь, что файл ресурсов, используемый в политике SOAPMessageValidation, содержит соответствующие определения элементов.

Чтобы исправить показанный выше пример файла ресурсов, вы можете изменить файл xsd , добавив следующее содержимое: 

<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>