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

أنت تعرض مستندات 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.

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

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

السبب

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

التشخيص

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

    على سبيل المثال، في الخطأ التالي، يكون اسم سياسة ExtensionCallout هو Extension Callout-1,اسمd الإضافة 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 في مسار PostClient. في حال وضع سياسة ExtensionCallout في مسار PostClient، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور هذا الخطأ.

التشخيص

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

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

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

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

    على سبيل المثال، يتضمن تدفق 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>
...