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

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

InvalidConnectorInstance

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Saving Revision revision_number
In policy_name: Connector must not be empty.

مثال على رسالة الخطأ

Error Saving Revision 1
In Extension Callout-1: Connector must not be empty.

مثال على لقطة شاشة الخطأ

رسالة الخطأ "مثيل الموصّل غير صالح"

السبب

يحدث هذا الخطأ إذا كان العنصر <Connector> في سياسة ExtensionCallout غير متوفّر أو تم ضبطه على قيمة فارغة.

التشخيص

  1. حدِّد اسم سياسة ExtensionCallout في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم سياسة ExtensionCallout هو Extension Callout-1:

    Error Saving Revision 1
In Extension Callout-1: Connector must not be empty

  2. افحص ملف XML الخاص بسياسة ExtensionCallout الذي تعذّر تنفيذه وتأكَّد من توفُّر العنصر <Connector> وعدم فراغه. على سبيل المثال، في السياسة أدناه، يكون عنصر <Connector> فارغًا ولا يحتوي على اسم الإضافة:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector></Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

بما أنّ العنصر <Connector> فارغ، يتعذّر نشر خادم وكيل واجهة برمجة التطبيقات.

الدقة

تأكَّد من تحديد قيمة العنصر <Connector> في سياسة "وسيلة شرح الإضافة" دائمًا ومن أنّها تتطابق مع اسم الإضافة الفعلية التي تم إنشاؤها في المؤسسة.

لتصحيح مثال سياسة ExtensionCallout الموضّحة أعلاه، يمكنك ضبط العنصر <Connector> على اسم الإضافة المتوفّرة في البيئة المحدّدة التي يتم نشر خادم وكيل واجهة برمجة التطبيقات فيها.

لتحديد اسم الإضافة، يمكنك الانتقال إلى المشرف > الإضافات في واجهة مستخدم Edge. سيتم عرض أسماء جميع الإضافات في مؤسستك هناك. يجب ضبط اسم الإضافة في العنصر <Connector>.

عرض أسماء جميع الإضافات في واجهة مستخدم Edge

في ما يلي المثال مع ضبط "اسم الإضافة" بشكل صحيح في العنصر <Connector>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

ConnectorInstanceDoesNotExists

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Deploying Revision revision_number to environment
In policy_name: Connector <extension_name> does not exist in environment environment.

مثال على رسالة الخطأ

Error Deploying Revision 1 to test
In Extension Callout-1: Connector cloud_storage does not exist in environment test.

مثال على لقطة شاشة الخطأ

رسالة الخطأ &quot;مثيل الموصّل غير متوفّر&quot;

السبب

يحدث هذا الخطأ إذا تم ضبط العنصر <Connector> في سياسة ExtensionCallout على اسم غير متوفّر في البيئة التي يتم نشر خادم وكيل لواجهة برمجة التطبيقات فيها.

التشخيص

  1. حدِّد اسم سياسة ExtensionCallout، واسم الإضافة غير الصالح المستخدَم في العنصر <Connector> من سياسة ExtensionCallout، والبيئة التي حدث فيها الخطأ. يمكنك العثور على كل هذه العناصر في رسالة الخطأ.

    على سبيل المثال، في الخطأ التالي، يكون اسم سياسة ExtensionCallout هو Extension Callout-1,invalid واسم الإضافة هو cloud_storage واسم البيئة هو test:

        Error Deploying Revision 1 to test
    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

  2. افحص ملف XML الخاص بسياسة ExtensionCallout الذي تعذّر تنفيذه وتأكَّد مما إذا كان اسم الإضافة المحدّد للعنصر <Connector> يتطابق مع ما ورد في رسالة الخطأ.

    في هذا المثال، اسم الإضافة المحدّد في العنصر <Connector> هو cloud_storage:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage</Connector>
        <Action>downloadFile</Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

  3. تأكَّد مما إذا تم إنشاء اسم الإضافة في البيئة (المحدّدة في الخطوة 1).

    في واجهة مستخدم Edge، انتقِل إلى المشرف > الإضافات وتأكَّد من توفّر الإضافة ومن أنّ الاسم يطابق الاسم المحدّد في العنصر <Connector> في سياسة ExtensionCallout.

    لاحظ في لقطة الشاشة أدناه أنّ الإضافة cloud_storage_ext متوفّرة، ولكنّها لا تتطابق مع العنصر <Connector> المحدّد في مثال سياسة "وسائل شرح الإضافات" الموضّح أعلاه:

    عرض أسماء جميع الإضافات في واجهة مستخدم Edge

    بما أنّ اسم الإضافة المحدّد في العنصر <Connector> غير متوفّر، سيظهر لك خطأ النشر التالي:

    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

الدقة

تأكَّد من إنشاء الإضافة المحدّدة في العنصر <Connector> من سياسة ExtensionCallout وتحديد الاسم بشكل صحيح.

راجِع البرنامج التعليمي: استخدام الإضافات للحصول على معلومات حول كيفية إنشاء الإضافة.

لحلّ المثال أعلاه، يجب تعديل الاسم ليتطابق مع الامتداد الفعلي:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

InvalidAction

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Saving Revision revision_number
In policy_name: Action must not be empty.

مثال على رسالة الخطأ

Error Saving Revision 1
In Extension Callout-1: Action must not be empty.

مثال على لقطة شاشة الخطأ

رسالة الخطأ &quot;إجراء غير صالح&quot;

السبب

يحدث هذا الخطأ إذا كان العنصر <Action> في سياسة ExtensionCallout غير متوفّر أو تم ضبطه على قيمة فارغة.

التشخيص

  1. حدِّد اسم سياسة ExtensionCallout. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم سياسة ExtensionCallout هو Extension Callout-1:

        Error Saving Revision 1
    In Extension Callout-1: Action must not be empty.

  2. افحص ملف XML الخاص بسياسة ExtensionCallout الذي تعذّر تنفيذه وتأكَّد مما إذا كان الإجراء محدّدًا في العنصر <Action>. إذا كان العنصر <Action> غير متوفّر أو فارغًا، سيكون ذلك هو سبب الخطأ.

    في هذا المثال، يكون العنصر <Action> فارغًا:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage_ext</Connector>
        <Action></Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

الدقة

تأكَّد من أنّ العنصر <Action> محدّد دائمًا وغير فارغ في سياسة ExtensionCallout.

راجِع البرنامج التعليمي: استخدام الإضافات للحصول على معلومات حول كيفية إنشاء إضافة وكيفية استخدامها في السياسة مع عنصر <Action> الصحيح.

لحلّ المشكلة المذكورة أعلاه، حدِّد الإجراء الصحيح للإضافة:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

AllowExtensionsInPostClientFlow

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم Edge أو واجهة برمجة تطبيقات إدارة Edge، وتظهر رسالة الخطأ التالية:

Error Deploying Revision revision_number to environment
In policy_name: Policy is not allowed in PostClientFlow.

مثال على رسالة الخطأ

Error Deploying Revision 1 to test
In Extension Callout-1: Policy is not allowed in PostClientFlow.

مثال على لقطة شاشة الخطأ

رسالة الخطأ Allow Extensions In Post Client Flow

السبب

يُحظر استخدام سياسة ExtensionCallout في PostClient Flow. إذا تم وضع سياسة ExtensionCallout في PostClient Flow، سيتعذّر نشر خادم وكيل واجهة برمجة التطبيقات وسيظهر هذا الخطأ.

التشخيص

  1. حدِّد اسم سياسة ExtensionCallout. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، اسم سياسة ExtensionCallout هو Extension Callout-1:

    In Extension Callout-1: Policy is not allowed in PostClientFlow.

  2. افحص جميع عمليات PostClient Flows في جميع نقاط نهاية خادم وكيل واجهة برمجة التطبيقات المحدّد الذي حدث فيه الخطأ. يُرجى الرجوع إلى مقالة التحكّم في طريقة تنفيذ الخادم الوكيل باستخدام المسارات.

    إذا لاحظت أنّ سياسة ExtensionCallout (التي تم تحديدها في الخطوة 1) موضوعة في PostClient Flow، فهذا هو سبب الخطأ.

    على سبيل المثال، يحتوي PostClient Flow التالي على سياسة ExtensionCallout:

        ...
    <PostClientFlow>
            <Request/>
            <Response>
                <Step>
                    <Name>Extension-Callout-1</Name>
                </Step>
            </Response>
        </PostClientFlow>
    ...

الدقة

تأكَّد من عدم وضع سياسة ExtensionCallout في PostClient Flow.

لحلّ المشكلة المذكورة أعلاه، عليك نقل سياسة ExtensionCallout إلى أيّ Flow آخر.

...
<PreFlow name="PreFlow">
    <Request/>
    <Response>
        <Step>
            <Name>Extension-Callout-1</Name>
        </Step>
    </Response>
</PreFlow>
...