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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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>