การแก้ปัญหาข้อผิดพลาดในการทำให้นโยบาย JavaScript ใช้งานได้

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

InvalidResourceUrlFormat

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

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 ไม่ถูกต้อง การติดตั้งใช้งานพร็อกซี API จะล้มเหลว

รูปแบบที่ถูกต้องในการระบุ URL ของทรัพยากรมีดังนี้

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

เช่น หากระบุองค์ประกอบ <ResourceURL> ดังที่แสดงด้านล่าง การติดตั้งใช้งานพร็อกซี API จะไม่สำเร็จเนื่องจากไม่เป็นไปตามรูปแบบที่กำหนด

<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 ทั้งหมดในพร็อกซี API ที่เฉพาะเจาะจงซึ่งเกิดข้อผิดพลาด หากมีนโยบาย 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 ซึ่งไม่ถูกต้อง การติดตั้งใช้งาน API Proxy จึงล้มเหลวและแสดงข้อผิดพลาดต่อไปนี้

    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

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

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 ที่ไม่มีอยู่ การติดตั้งใช้งานพร็อกซี API จะล้มเหลว

หากคุณกําลังติดตั้งใช้งานชุดพร็อกซีจากเครื่องในพื้นที่ คุณต้องจัดเก็บไฟล์ต้นฉบับ JavaScript ไว้ใน /apiproxy/resources/jsc ในกรณีนี้ ไฟล์ต้นฉบับจะอยู่ในขอบเขตของพร็อกซี API

ใน UI ของ Edge ไฟล์ต้นฉบับ JavaScript จะปรากฏในส่วน jsc ในส่วน Scripts ของแผง Navigator ของเครื่องมือแก้ไขพร็อกซี API นอกจากนี้ คุณยังจัดเก็บไฟล์ทรัพยากรในที่เก็บระดับองค์กรและสภาพแวดล้อมได้ด้วย (เช่น เพื่อให้โค้ด 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 เป็นส่วนหนึ่งของชุด API Proxy ที่เฉพาะเจาะจง หรือมีอยู่ที่ขอบเขตขององค์กรหรือสภาพแวดล้อม

    1. หากต้องการตรวจสอบว่าไฟล์เป็นส่วนหนึ่งของชุดพร็อกซี API ที่เฉพาะเจาะจงหรือไม่ ให้ทำตามขั้นตอนใดขั้นตอนหนึ่งต่อไปนี้
      1. ใน UI ของ Edge ให้ตรวจสอบว่าไฟล์นี้อยู่ในส่วนสคริปต์ของพร็อกซี API หรือไม่
      2. ดาวน์โหลดแพ็กเกจพร็อกซี API แล้วค้นหาว่ามีไฟล์อยู่หรือไม่
    2. หากไฟล์ไม่ได้เป็นส่วนหนึ่งของชุดพร็อกซี API ที่เฉพาะเจาะจง ให้ตรวจสอบว่ามีอยู่ที่ระดับองค์กรหรือสภาพแวดล้อมหรือไม่ คุณสามารถใช้ Resource Files API ในการตรวจสอบนี้ได้

    หากไม่มีไฟล์ดังกล่าวในระดับพร็อกซี API, องค์กร หรือสภาพแวดล้อม แสดงว่านั่นคือสาเหตุของข้อผิดพลาด

    ในตัวอย่างที่อธิบายไว้ข้างต้น โปรดทราบว่าชื่อไฟล์ JavaScript ที่ไม่ถูกต้องคือ dependent_js.js ในภาพหน้าจอด้านล่าง โปรดสังเกตว่าไฟล์ที่ระบุเป็น URL ทรัพยากรในนโยบายจะไม่ปรากฏในส่วนสคริปต์ ดังนั้นจึงไม่ได้เป็นส่วนหนึ่งของพร็อกซี API หากไม่มีไฟล์ในระดับองค์กรหรือสภาพแวดล้อม การติดตั้งใช้งานพร็อกซี API จะไม่สำเร็จและแสดงข้อผิดพลาดต่อไปนี้

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

ความละเอียด

ตรวจสอบว่าไฟล์ JavaScript ที่ระบุในองค์ประกอบ <ResourceURL> และ <IncludeURL> อ้างอิงถึงไฟล์ที่ถูกต้องซึ่งมีอยู่ที่ระดับพร็อกซี API, องค์กร หรือสภาพแวดล้อม

หากต้องการแก้ไขนโยบาย JavaScript ตัวอย่างที่แสดงด้านบน ให้เพิ่มไฟล์ dependent_js.js ลงในชุดพร็อกซี API ในภาพหน้าจอด้านล่าง คุณจะเห็นว่าไฟล์ JavaScript ที่ระบุในองค์ประกอบ <ResourceURL> และ <IncludeURL> จะแสดงในส่วนสคริปต์ของชุดพร็อกซี API

WrongResourceType

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

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. ระบุประเภททรัพยากรที่ไม่ถูกต้องที่ใช้ในนโยบาย JavaScript คุณดูข้อมูลนี้ได้จากข้อความแสดงข้อผิดพลาด ตัวอย่างเช่น ในข้อผิดพลาดต่อไปนี้ ประเภททรัพยากรที่ไม่ถูกต้องคือ node

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

  2. ตรวจสอบนโยบาย JavaScript ทั้งหมดในพร็อกซี API ที่เฉพาะเจาะจงซึ่งเกิดข้อผิดพลาด หากมีนโยบาย 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 ซึ่งไม่ถูกต้อง การติดตั้งใช้งานพร็อกซี API จึงล้มเหลวพร้อมข้อผิดพลาดต่อไปนี้

    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

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน UI ของ Edge หรือ Edge Management API จะล้มเหลวพร้อมข้อความแสดงข้อผิดพลาดนี้

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> ดังที่แสดงด้านล่าง การติดตั้งใช้งานพร็อกซี API จะไม่สำเร็จ

<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> การติดตั้งใช้งานพร็อกซี API จึงไม่สำเร็จโดยมีข้อผิดพลาดดังนี้

    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 ของทรัพยากร การติดตั้งใช้งานพร็อกซี API จึงล้มเหลวโดยมีข้อผิดพลาดดังนี้

  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>