عیب‌یابی خطای استقرار خط‌مشی «نوشته راهنمای افزونه»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

InvalidConnectorInstance

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر 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> در خط‌مشی «افزونه‌ تماس» وجود نداشته باشد یا روی مقدار خالی تنظیم شده باشد.

تشخیص

  1. نام خط‌مشی «افزونه‌پیام‌واره» را در پیام خطا شناسایی کنید. برای مثال، در خطای زیر، نام خط‌مشی «توضیحات تماس با افزونه» Extension Callout-1 است:

    Error Saving Revision 1
    In Extension Callout-1: Connector must not be empty
  2. «زبان نشانه‌گذاری توسعه‌پذیر» خط‌مشی «افزونه‌تماس» ناموفق را بررسی کنید و مطمئن شوید عنصر <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> خالی است، استقرار «پراکسی API» ناموفق است.

وضوح

مطمئن شوید که مقدار عنصر <Connector> خط‌مشی «نوشته راهنمای افزونه» همیشه مشخص شده باشد و با نام افزونه واقعی که در سازمان ایجاد شده است مطابقت داشته باشد.

برای اصلاح خط‌مشی «توضیح تماس با افزونه» نشان‌داده‌شده در بالا، می‌توانید عنصر <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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر 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> در خط‌مشی «بازده تماس افزونه» روی نامی تنظیم شده باشد که در محیطی که پراکسی API در آن مستقر می‌شود وجود ندارد.

تشخیص

  1. نام خط‌مشی «افزونه‌نوشته راهنما»، نام «افزونه» نامعتبر استفاده‌شده در عنصر <Connector> خط‌مشی «افزونه‌نوشته راهنما»، و محیطی که خطا در آن رخ داده است را شناسایی کنید. می‌توانید همه این موارد را در پیام خطا پیدا کنید.

    برای مثال، در خطای زیر، نام خط‌مشی «دعوت به اقدام افزونه» 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 خط‌مشی «بازخرید افزونه» ناموفق را بررسی کنید و مطمئن شوید نام افزونه مشخص‌شده برای عنصر <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. بررسی کنید که نام افزونه در محیط (تعیین‌شده در مرحله ۱) ایجاد شده باشد.

    در میانای کاربری Edge، به سرپرست > افزونه‌ها بروید و بررسی کنید که افزونه وجود دارد و نام آن با نام مشخص‌شده در عنصر <Connector> در خط‌مشی «افزونه پیامک‌راهنما» مطابقت دارد.

    توجه کنید که در نماگرفت زیر، افزونه cloud_storage_ext وجود دارد، اما با عنصر <Connector> مشخص‌شده در خط‌مشی «افزونه‌تماس‌بها» که در بالا نشان داده شده است مطابقت ندارد:

    نام همه افزونه‌ها را در «میانای کاربری Edge» مشاهده کنید.

    ازآنجایی‌که نام افزونه مشخص‌شده در عنصر <Connector> وجود ندارد، خطای استقرار دریافت می‌کنید:

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

وضوح

مطمئن شوید که افزونه مشخص‌شده در عنصر <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>

InvalidAction

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر 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> در خط‌مشی «افزونه‌ تماس» وجود نداشته باشد یا روی مقدار خالی تنظیم شده باشد.

تشخیص

  1. نام خط‌مشی «افزونه‌تماس» را شناسایی کنید. می‌توانید این اطلاعات را در پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی «افزونه‌نوشته‌راهنما» Extension Callout-1: است

        Error Saving Revision 1
        In Extension Callout-1: Action must not be empty.
  2. «زبان نشانه‌گذاری توسعه‌پذیر خط‌مشی» ناموفق «پیام‌واره افزونه» را بررسی کنید و ببینید آیا کنش در عنصر <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> همیشه در خط‌مشی «افزونه‌نوشته‌راهنما» مشخص شده باشد و خالی نباشد.

برای اطلاعات درباره نحوه ایجاد افزونه و نحوه استفاده از آن در خط‌مشی با عنصر <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.

نماگرفت خطای نمونه

پیام خطای «اجازه دادن به افزونه‌ها در جریان کارخواه پس‌از پست»

علت

داشتن خط‌مشی «افزونه پیامک‌راهنما» در «جریان PostClient» ممنوع است. اگر خط‌مشی «افزونه‌تماس‌بها» در «جریان PostClient» قرار داده شود، استقرار پراکسی «میانای برنامه‌سازی کاربردی» با این خطا ناموفق خواهد بود.

تشخیص

  1. نام خط‌مشی «افزونه‌تماس» را شناسایی کنید. می‌توانید این اطلاعات را در پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی «افزونه‌نوشته‌راهنما» Extension Callout-1: است

    In Extension Callout-1: Policy is not allowed in PostClientFlow.
  2. همه «جریان‌های PostClient» را در همه نقاط پایانی «پراکسی API» خاصی که در آن خرابی رخ داده است بررسی کنید. لطفاً به مقاله کنترل نحوه اجرای کارگزار با جریان‌ها مراجعه کنید.

    اگر متوجه شدید که خط‌مشی «بازده تماسی افزونه» (که در مرحله ۱ تعیین شده است) در «جریان پس‌از مشتری» قرار گرفته است، این دلیل خطا است.

    برای مثال، «جریان PostClient» زیر «خط‌مشی ExtensionCallout» را در خود دارد:

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

وضوح

مطمئن شوید که خط‌مشی «توضیحات تماس افزونه» در «جریان PostClient» قرار نگرفته باشد.

برای رفع مشکل ذکرشده در بالا، باید خط‌مشی «افزونه‌تماس‌بها» را به «جریان» دیگری منتقل کنید.

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