تحديد وحلّ المشاكل المتعلقة بنشر سياسة JavaScript

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

InvalidResourceUrlFormat

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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.

مثال للقطة شاشة

السبب

إذا كان تنسيق عنوان URL للمورد المحدّد في <ResourceURL> أو العنصر <IncludeURL> في سياسة JavaScript غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات.

يتم توضيح التنسيق الصحيح لتحديد عنوان URL للمورد كما هو موضح أدناه:

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

على سبيل المثال، إذا تم تحديد العنصر <ResourceURL> كما هو موضّح أدناه، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات لأنّه لا يتّبع النمط المحدَّد:

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

التشخيص

  1. حدِّد تنسيق عنوان URL للمورد غير الصالح والمستخدَم في سياسة JavaScript. يمكنك العثور على هذه المعلومات من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون تنسيق عنوان URL للمورد غير صالح هو jsc:add_variables.js.

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

  2. افحص جميع سياسات JavaScript في الخادم الوكيل لواجهة برمجة التطبيقات المحدَّد الذي حدث به الخطأ. إذا كانت هناك أي سياسة JavaScript يتطابق فيها عنوان URL للمورد المحدّد في <ResourceURL> أو العنصر <IncludeURL> مع الإدخال غير الصالح المحدّد في الخطوة رقم 1 أعلاه، يكون سبب الخطأ هو سبب الخطأ.

    على سبيل المثال، تحدِّد السياسة التالية عنوان URL للمورد على أنّه 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>

    بما أنّه تم تحديد عنوان URL للمورد على أنّه jsc:add_variables.js، وهو عنوان غير صالح، تعذَّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ:

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

درجة الدقّة

تأكَّد من أنّ تنسيق عنوان URL للمورد المحدّد في العنصر <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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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> يشيران إلى ملف JavaScript غير متوفّر، سيتعذّر عندئذٍ نشر الخادم الوكيل لواجهة برمجة التطبيقات.

إذا كنت تنشر حزمة خادم وكيل من جهازك المحلي، يجب أن يتم تخزين ملفات مصدر JavaScript ضمن /apiproxy/resources/jsc. وفي هذه الحالة، يتم تحديد نطاق الملفات المصدر على الخادم الوكيل لواجهة برمجة التطبيقات.

في واجهة مستخدم Edge، تظهر ملفات مصدر JavaScript ضِمن jsc في قسم "النصوص البرمجية" ضِمن لوحة المستكشف في محرِّر الخادم الوكيل لواجهة برمجة التطبيقات. يمكنك أيضًا تخزين ملفات الموارد في المستودعات على مستوى المؤسسة والبيئة (لإتاحة رمز JavaScript لجميع الخوادم الوكيلة في مؤسسة أو بيئة مثلاً).

يحدث هذا الخطأ إذا تعذَّر العثور على أي ملفات موارد تم تحديدها في السياسة في أي من النطاقات المتاحة (الخادم الوكيل أو البيئة أو المؤسسة).

التشخيص

  1. حدِّد سياسة JavaScript التي حدث فيها الخطأ وتحتوي على مرجع عنوان URL غير صالح للمورد. يمكنك العثور على هذه المعلومات من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو js-TotalVariable ومرجع عنوان URL للمورد غير الصالح هو jsc://dependent_js.js.

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

  2. تحقَّق من أنّ مرجع عنوان URL للمورد المحدّد في سياسة JavaScript التي تعذّر تنفيذها يتطابق مع القيمة المحدّدة في رسالة الخطأ (الخطوة 1 أعلاه). على سبيل المثال، تحدِّد السياسة التالية مرجع عنوان URL للمورد على أنّه 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. تحقَّق مما إذا كان ملف المصدر المحدّد في الخطوة رقم 1 جزءًا من حزمة الخادم الوكيل لواجهة برمجة التطبيقات المحدّدة، أو متوفّر على نطاق المؤسسة أو البيئة.

    1. للتحقّق مما إذا كان الملف جزءًا من حزمة الخادم الوكيل لواجهة برمجة التطبيقات، اتّبِع إحدى الخطوات التالية:
      1. في واجهة مستخدم Edge، تحقَّق مما إذا كان هذا الملف في قسم "النصوص البرمجية" في الخادم الوكيل لواجهة برمجة التطبيقات.
      2. نزِّل حزمة الخادم الوكيل لواجهة برمجة التطبيقات وابحث عن الملف إذا كان متوفرًا.
    2. إذا لم يكن الملف جزءًا من حزمة الخادم الوكيل لواجهة برمجة التطبيقات، تحقَّق مما إذا كان متوفرًا على مستوى المؤسسة أو البيئة. يمكنك استخدام واجهة برمجة تطبيقات ملفات الموارد لهذا التحقيق.

    إذا لم يكن الملف متوفّرًا على مستوى الخادم الوكيل لواجهة برمجة التطبيقات أو مستوى المؤسسة أو البيئة، يكون هذا هو سبب الخطأ.

    في المثال الموضّح أعلاه، تذكَّر أنّ اسم ملف JavaScript غير الصالح هو dependent_js.js. في لقطة الشاشة أدناه، يُرجى ملاحظة أنّ الملف المحدَّد كعنوان URL لمورد في السياسة لا يظهر في قسم "النصوص البرمجية". ولذلك، فإنه ليس جزءًا من الخادم الوكيل لواجهة برمجة التطبيقات. وفي حال عدم وجود الملف على مستوى المؤسسة أو البيئة، يفشل نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ التالي:

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

درجة الدقّة

تأكَّد من أنّ ملفات JavaScript المحدّدة في العنصرَين <ResourceURL> و<IncludeURL> تشير إلى ملف صالح على مستوى الخادم الوكيل لواجهة برمجة التطبيقات أو المؤسسة أو البيئة.

لتصحيح نموذج سياسة JavaScript الموضّح أعلاه، أضِف الملف dependent_js.js إلى حزمة الخادم الوكيل لواجهة برمجة التطبيقات. في لقطة الشاشة أدناه، يمكنك الاطّلاع على ملفات JavaScript المحدّدة في العنصرَين <ResourceURL> و<IncludeURL> في قسم "النصوص البرمجية" ضمن حزمة الخادم الوكيل لواجهة برمجة التطبيقات.

WrongResourceType

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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> كما هو موضّح أدناه، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات:

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

وذلك لأنّه يشير إلى نوع مورد node غير صحيح.

التشخيص

  1. حدِّد نوع المورد غير الصالح المستخدَم في سياسة JavaScript. يمكنك العثور على هذه المعلومات من رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون نوع المورد غير الصالح هو node.

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

  2. افحص جميع سياسات JavaScript في الخادم الوكيل لواجهة برمجة التطبيقات المحدَّد الذي حدث به الخطأ. إذا كانت هناك أي سياسة JavaScript يتطابق فيها المورد المحدّد في <ResourceURL> أو العنصر <IncludeURL> مع نوع المورد غير الصالح المحدّد في الخطوة رقم 1 أعلاه، يكون سبب الخطأ هو سبب الخطأ.

    على سبيل المثال، تحدِّد السياسة التالية نوع المورد 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، وهو نوع غير صالح:

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

درجة الدقّة

تأكَّد من أنّ العنصرَين <ResourceURL> و<IncludeURL> في سياسة JavaScript يشيران دائمًا إلى نوع المورد 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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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> أو لم يتم تحديد عنوان URL للمورد داخل هذا العنصر العنصر <ResourceURL> هو عنصر إجباري.
  2. تم الإعلان عن العنصر <IncludeURL> لكن لم يتم تحديد عنوان URL للمورد داخل هذا العنصر. العنصر <IncludeURL> اختياري، ولكن إذا تم تعريفه، يجب تحديد عنوان URL للمورد داخل العنصر <IncludeURL>.

على سبيل المثال، إذا تم الإعلان عن العنصر <IncludeURL> كما هو موضّح أدناه، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات:

<IncludeURL></IncludeURL>

التشخيص

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

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

  2. في ملف XML الذي تعذّر تنفيذه لسياسة JavaScript، نفِّذ عمليات التحقق التالية:

    1. يجب الإعلان عن العنصر <ResourceURL> ويجب أن يتضمّن العنصر عنوان URL للمورد محدّدًا.
    2. إذا تم تعريف العنصر <IncludeURL>، عليك تحديد عنوان URL للمورّد داخله. إعلان العنصر <IncludeURL> اختياري.

    في حال تعذّر إكمال أي من عمليات التحقّق أعلاه، يكون هذا هو سبب الخطأ.

    المثال 1: لم يتم تعريف العنصر <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>، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ:

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

    المثال 2: تحتوي السياسة التالية على عنصر <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> لا يحتوي على عنوان URL للمورد، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ:

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

درجة الدقّة

تأكّد مما يلي في سياسة JavaScript:

  1. تم تعريف العنصر <ResourceURL> وتحديد عنوان URL للمورد داخل هذا العنصر. العنصر <ResourceURL> هو عنصر إجباري.

  2. إذا تم تعريف العنصر <IncludeURL>، يجب تحديد عنوان URL للمورد لتضمينه داخل هذا العنصر. ويكون العنصر <IncludeURL> اختياريًا ولكن إذا تم تعريفه، يجب تحديد عنوان URL للمورد داخل العنصر <IncludeURL>.

    لتصحيح المثال 1 الموضّح أعلاه، يجب تضمين العنصر <ResourceURL> مع ملف JavaScript صالح:

    <?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>

    لتصحيح المثال 2 المذكور أعلاه، يجب تضمين ملف 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>