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

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

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

يتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ بسبب عدم توفّر عنوان URL للمورد في العنصر <IncludeURL>:

  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>