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

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

InvalidResourceUrlFormat

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

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

    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 ใช้งานได้ผ่าน Edge UI หรือ 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

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

    1. หากต้องการตรวจสอบว่าไฟล์เป็นส่วนหนึ่งของแพ็กเกจพร็อกซี API ดังกล่าวหรือไม่ ให้ทําตามขั้นตอนใดขั้นตอนหนึ่งต่อไปนี้
      1. ใน Edge UI ให้ตรวจสอบว่าไฟล์นี้อยู่ในส่วนสคริปต์ของพร็อกซี 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 ใช้งานได้ผ่าน Edge UI หรือ 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 ใช้งานได้ผ่าน Edge UI หรือ 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>