عیب‌یابی خطای استقرار خط‌مشی جاوا اسکریپت

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

InvalidResourceUrlFormat

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Deploying Revision revision_number to environment
Invalid resource url format. Resource url is invalid_URL.

پیام خطای نمونه

Error Deploying Revision 1 to test
Invalid resource url format. Resource url is jsc:add_variables.js.

نماگرفت نمونه

علت

اگر قالب نشانی وب منبع مشخص‌شده در عنصر <ResourceURL> یا <IncludeURL> خط‌مشی JavaScript نامعتبر باشد، استقرار پراکسی API ناموفق خواهد بود.

قالب صحیح برای مشخص کردن نشانی وب منبع به‌صورت زیر است:

<ResourceURL>jsc://<file_name>.js</ResourceURL>
<IncludeURL>jsc://<file_name>.js</IncludeURL>

برای مثال، اگر عنصر <ResourceURL> به‌صورت زیر مشخص شده باشد، استقرار پراکسی API ناموفق خواهد بود زیرا از الگوی تجویز‌شده پیروی نمی‌کند:

<ResourceURL>jsc:add_variables.js</ResourceURL>

تشخیص

  1. قالب نامعتبر نشانی وب منبع استفاده‌شده در خط‌مشی JavaScript را شناسایی کنید. می‌توانید این اطلاعات را از پیام خطا پیدا کنید. برای مثال، در خطای زیر، قالب نامعتبر نشانی وب منبع jsc:add_variables.js است.

      Error Deploying Revision 1 to test
        Invalid resource url format. Resource url is jsc:add_variables.js.
    
  2. همه خط‌مشی‌های جاوا اسکریپت را در «پراکسی API» خاصی که خطا در آن رخ داده است بررسی کنید. اگر خط‌مشی JavaScript وجود داشته باشد که در آن نشانی وب منبع مشخص‌شده در عنصر <ResourceURL> یا <IncludeURL> با ورودی نامعتبر شناسایی‌شده در مرحله ۱ در بالا مطابقت داشته باشد، آن خط‌مشی دلیل خطا است.

    برای مثال، خط‌مشی زیر نشانی وب منبع را به‌عنوان jsc:add_variables.js مشخص می‌کند که با آنچه در پیام خطا است مطابقت دارد:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
        <DisplayName>js-TotalVariable</DisplayName>
        <Properties/>
        <ResourceURL>jsc:add_variables.js</ResourceURL>
    </Javascript>
    

    چون نشانی وب منبع به‌عنوان jsc:add_variables.js مشخص شده است که نامعتبر است، استقرار «پراکسی API» با این خطا ناموفق است:

    Invalid resource url format. Resource url is jsc:add_variables.js.
    

وضوح

مطمئن شوید قالب نشانی وب منبع مشخص‌شده در عنصر <ResourceURL> یا <IncludeURL> خط‌مشی JavaScript معتبر باشد. برای مثال:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
    <DisplayName>js-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>jsc://add_variables.js</ResourceURL>
</Javascript>

InvalidResourceUrlReference

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Deploying Revision revision_number to environment
Invalid resource url ref invalid_reference in policy policy_name in org_name

پیام خطای نمونه

Error Deploying Revision 8 to test
Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval

نماگرفت نمونه

علت

اگر عناصر <ResourceURL> و <IncludeURL> به فایل جاوا اسکریپتی که وجود ندارد اشاره کنند، استقرار پراکسی API ناموفق خواهد بود.

اگر بسته پراکسی را از ماشین محلی‌تان مستقر می‌کنید، فایل‌های منبع JavaScript باید در /apiproxy/resources/jsc ذخیره شوند. در این مورد، فایل‌های منبع به پراکسی API محدود می‌شوند.

در «میانای کاربری Edge»، فایل‌های منبع JavaScript در بخش «نوشتارها» در قاب «پیمایشگر» ویرایشگر پراکسی API در زیر jsc نشان داده می‌شود. همچنین می‌توانید فایل‌های منبع را در مخازن سطح سازمان و محیط ذخیره کنید (برای مثال، برای دردسترس قرار دادن کد جاوا اسکریپت برای همه پراکسی‌ها در یک سازمان یا محیط).

اگر هیچ‌یک از فایل‌های منبع مشخص‌شده در خط‌مشی در هیچ‌یک از دامنه‌های دردسترس (کارگزار، محیط، یا سازمان) پیدا نشود، این خطا رخ می‌دهد.

تشخیص

  1. خط‌مشی JavaScript را که خطا در آن رخ داده است و حاوی مرجع نشانی وب منبع نامعتبر است شناسایی کنید. می‌توانید این اطلاعات را از پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی js-TotalVariable و مرجع نشانی وب منبع نامعتبر jsc://dependent_js.js است.

    Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval
    
  2. تأیید کنید که مرجع نشانی وب منبع مشخص‌شده در خط‌مشی جاوا اسکریپت ناموفق با مقدار شناسایی‌شده در پیام خطا (مرحله ۱ در بالا) مطابقت داشته باشد. برای مثال، خط‌مشی زیر مرجع نشانی وب منبع را به‌عنوان jsc://dependent_js.js مشخص می‌کند که با آنچه در پیام خطا است مطابقت دارد:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
      <DisplayName>js-TotalVariable</DisplayName>
      <Properties/>
      <ResourceURL>jsc://add_variables.js</ResourceURL>
      <IncludeURL>jsc://dependent_js.js</IncludeURL>
    </Javascript>
    
  3. بررسی کنید که آیا فایل منبع شناسایی‌شده در فایل مرحله #۱ بخشی از بسته «پراکسی API» خاص است یا در محدوده سازمان یا محیط وجود دارد.

    1. برای بررسی اینکه فایل بخشی از بسته «پراکسی API» خاص است یا نه، یکی از مراحل زیر را دنبال کنید:
      1. در «میانای کاربری Edge»، بررسی کنید که آیا این فایل در بخش «دستورگان» پراکسی API قرار دارد یا نه.
      2. بسته «پراکسی API» را بارگیری کنید و جستجو کنید که آیا فایل وجود دارد یا نه.
    2. اگر فایل بخشی از بسته «پراکسی میانای برنامه‌سازی کاربردی» خاصی نیست، بررسی کنید که آیا در سطح سازمان یا محیط وجود دارد یا خیر. می‌توانید از واسط برنامه‌سازی کاربردی فایل‌های منبع برای این تحقیق استفاده کنید.

    اگر فایل در سطح «پراکسی API»، سازمان، یا محیط وجود نداشته باشد، این دلیل خطا است.

    در مثال شرح‌داده‌شده در بالا، به‌یاد داشته باشید که نام فایل جاوا اسکریپت نامعتبر dependent_js.js است. در نماگرفت زیر، توجه کنید که فایل مشخص‌شده به‌عنوان نشانی وب منبع در خط‌مشی در بخش «نوشته‌ها» نشان داده نمی‌شود. بنابراین، این ویژگی بخشی از «پراکسی API» نیست. اگر فایل در سطح سازمان یا محیط نیز وجود نداشته باشد، استقرار «پراکسی API» با این خطا ناموفق خواهد بود:

    Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval
    

وضوح

مطمئن شوید که فایل‌های JavaScript مشخص‌شده در عناصر <ResourceURL> و <IncludeURL> به فایل معتبری که در سطح «پراکسی میانای برنامه‌سازی کاربردی»، سازمان، یا محیط وجود دارد اشاره می‌کنند.

برای اصلاح خط‌مشی جاوا اسکریپت نمونه نشان‌داده‌شده در بالا، فایل dependent_js.js را به دسته «پراکسی API» اضافه کنید. در نماگرفت زیر می‌بینید که فایل‌های JavaScript مشخص‌شده در عناصر <ResourceURL> و <IncludeURL> در بخش «دستورگان» بسته «پراکسی میانای برنامه‌سازی کاربردی» قابل‌مشاهده است.

WrongResourceType

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Deploying Revision revision_number to environment
Resource JavaScript_file is the wrong type. It is invalid_type: but Javascript steps use type jsc:.

پیام خطای نمونه

Error Deploying Revision 2 to test
Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.

نماگرفت نمونه

علت

اگر عناصر <ResourceURL> و <IncludeURL> خط‌مشی JavaScript به هر نوع منبعی به‌جز jsc (فایل JavaScript) اشاره کنند، این خطا درطول استقرار رخ می‌دهد.

برای مثال، اگر عنصر <IncludeURL> همان‌طور که در زیر نشان داده شده است اعلام شود، استقرار پراکسی API ناموفق خواهد بود:

<IncludeURL>node://javascript-dependency.js</IncludeURL>

دلیل آن این است که به نوع منبع node ارجاع می‌دهد که نادرست است.

تشخیص

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

    Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.
    
  2. همه خط‌مشی‌های جاوا اسکریپت را در «پراکسی API» خاصی که خطا در آن رخ داده است بررسی کنید. اگر خط‌مشی JavaScript وجود داشته باشد که در آن منبع مشخص‌شده در عنصر <ResourceURL> یا <IncludeURL> با نوع منبع نامعتبر شناسایی‌شده در «مرحله ۱» در بالا مطابقت داشته باشد، آن خط‌مشی دلیل خطا است.

    برای مثال، خط‌مشی زیر نوع منبع را به‌عنوان node مشخص می‌کند که با آنچه در پیام خطا است مطابقت دارد:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
        <DisplayName>js-TotalVariable</DisplayName>
        <Properties/>
        <ResourceURL>node://js_checkType.js</ResourceURL>
        <IncludeURL>jsc://javascript-dependency.js</IncludeURL>
    </Javascript>
    

    چون نوع منبع به‌عنوان node مشخص شده است که نامعتبر است، استقرار «پراکسی API» با این خطا ناموفق است:

    Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.
    

وضوح

مطمئن شوید که عناصر <ResourceURL> و <IncludeURL> در خط‌مشی جاوا اسکریپت همیشه به نوع منبع jsc اشاره می‌کنند.

برای اصلاح کردن مثال نشان‌داده‌شده در بالا، عنصر <ResourceURL> را تغییر دهید تا نوع منبع jsc را داشته باشد.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
    <DisplayName>js-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>jsc://js_checkType.js</ResourceURL>
    <IncludeURL>jsc://javascript-dependency.js</IncludeURL>
</Javascript>

NoResourceURLOrSource

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Saving Revision revision_number
Bundle is invalid. Errors:[Entity : Policy-policy_name, No ResourceURL or Source;].

پیام خطای نمونه

Error Saving Revision 10
Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].

نماگرفت نمونه

علت

استقرار خط‌مشی JavaScript می‌تواند تحت سناریوهای زیر با این خطا ناموفق باشد:

  1. اگر عنصر <ResourceURL> اعلام نشده باشد یا اگر نشانی وب منبع در این عنصر تعریف نشده باشد. عنصر <ResourceURL> عنصری الزامی است.
  2. عنصر <IncludeURL> اعلام شده است اما نشانی وب منبع در این عنصر تعریف نشده است. عنصر <IncludeURL> اختیاری است اما اگر اعلام شود، نشانی وب منبع باید در عنصر <IncludeURL> مشخص شود.

برای مثال، اگر عنصر <IncludeURL> همان‌طور که در زیر نشان داده شده است اعلام شود، استقرار پراکسی API ناموفق خواهد بود:

<IncludeURL></IncludeURL>

تشخیص

  1. خط‌مشی جاوا اسکریپتی را که خطا در آن رخ داده است شناسایی کنید. می‌توانید این اطلاعات را از پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی Policy-js-example است:

    Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
    
  2. در فایل زبان نشانه‌گذاری توسعه‌پذیر خط‌مشی JavaScript ناموفق، بررسی‌های زیر را انجام دهید:

    1. عنصر <ResourceURL> باید اعلام شود و عنصر باید نشانی وب منبع تعریف‌شده داشته باشد.
    2. اگر عنصر <IncludeURL> اعلام شده است، باید نشانی وب منبعی را در آن مشخص کنید. اعلام عنصر <IncludeURL> اختیاری است.

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

    مثال ۱: خط‌مشی زیر عنصر <ResourceURL> را اعلام نکرده است:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example">
        <DisplayName>js-example</DisplayName>
        <Properties/>
    </Javascript>
    

    چون عنصر <ResourceURL> تعریف نشده است، استقرار «پراکسی API» با این خطا ناموفق است:

    Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
    

    مثال ۲: خط‌مشی زیر عنصر <IncludeURL> خالی دارد.

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example">
      <DisplayName>js-example</DisplayName>
      <Properties/>
      <ResourceURL>jsc://check_var.js</ResourceURL>
      <IncludeURL></IncludeURL>
  </Javascript>

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

  Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].

وضوح

در خط‌مشی جاوااسکریپت، موارد زیر را تضمین کنید:

  1. عنصر <ResourceURL> اعلام شده است و نشانی وب منبع در این عنصر تعریف شده است. عنصر <ResourceURL> عنصری الزامی است.
  2. اگر عنصر <IncludeURL>اعلام شده باشد، نشانی وب منبع گنجانده‌شده باید در این عنصر تعریف شود. عنصر <IncludeURL>اختیاری است اما اگر اعلام شده باشد، نشانی وب منبع باید در عنصر <IncludeURL>مشخص شود.

    برای اصلاح «مثال ۱» نشان‌داده‌شده در بالا، عنصر <ResourceURL> را با فایل جاوا اسکریپت معتبر اضافه کنید:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example">
        <DisplayName>js-example</DisplayName>
        <Properties/>
        <ResourceURL>jsc://check_var.js</ResourceURL>
    </Javascript>
    

    برای اصلاح «مثال ۲» نشان‌داده‌شده در بالا، فایل جاوا اسکریپت معتبری را در عنصر <IncludeURL> قرار دهید

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example">
        <DisplayName>js-example</DisplayName>
        <Properties/>
        <ResourceURL>jsc://check_var.js</ResourceURL>
        <IncludeURL>jsc://js_dependency.js</IncludeURL>
    </Javascript>