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

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

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.

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

رسالة الخطأ لمثيل الموصل غير موجود

السبب

يحدث هذا الخطأ إذا تم ضبط العنصر <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> المحدّد في نموذج سياسة ExtensionCallout الموضح أعلاه:

    يمكنك عرض أسماء جميع الإضافات في واجهة مستخدم 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.

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

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

السبب

يحدث هذا الخطأ إذا كان العنصر <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.

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

السماح بالإضافات في رسالة الخطأ في مسار عميل المشاركات

السبب

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

التشخيص

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

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

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

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

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

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

درجة الدقّة

يُرجى التأكُّد من عدم وضع سياسة ExtensionCallout في مسار PostClient.

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

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