تحديد المشاكل وحلّها في ما يتعلّق بنشر سياسة التحقّق من صحة رسائل SOAP

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

InvalidResourceType

رسالة الخطأ

تعذَّر نشر الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة 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

رسالة الخطأ

تعذَّر نشر الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة 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

رسالة الخطأ

تعذّر حفظ الخادم الوكيل لواجهة برمجة التطبيقات عبر واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة 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

رسالة الخطأ

تعذّر حفظ الخادم الوكيل لواجهة برمجة التطبيقات عبر واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة 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

رسالة الخطأ

تعذَّر نشر الخادم الوكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة 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>