คุณควรทดสอบส่วนเสริมอย่างละเอียดก่อนเผยแพร่เพื่อให้มั่นใจว่าส่วนเสริมจะทำงานตามที่ต้องการ Apps Script ช่วยให้คุณทดสอบส่วนเสริมของเอดิเตอร์ ที่กำลังพัฒนาในไฟล์ Google เอกสาร, ชีต, ฟอร์ม หรือสไลด์ที่เฉพาะเจาะจงได้ ซึ่งใช้เพื่อวัตถุประสงค์ต่อไปนี้ได้
- ตรวจสอบว่าส่วนเสริมที่เขียนในสคริปต์แบบสแตนด์อโลนทำงานตามที่ต้องการ เมื่อนำไปใช้กับชีต เอกสาร งานนำเสนอ หรือแบบฟอร์ม
- ตรวจสอบว่าขั้นตอนการติดตั้งส่วนเสริมทำงานตามที่ต้องการ โดยเฉพาะสำหรับ สถานะวงจรการให้สิทธิ์เริ่มต้น ที่แตกต่างกัน (ติดตั้ง เปิดใช้ หรือทั้ง 2 อย่าง)
- ตรวจสอบว่าส่วนเสริมทำงานได้ตามที่ต้องการเมื่อดำเนินการกับเอกสารและเนื้อหาของเอกสารนั้นๆ
- ทดสอบและเปรียบเทียบส่วนเสริมเวอร์ชันปัจจุบันกับเวอร์ชันก่อนหน้า
สร้างการทำให้ใช้งานได้สำหรับการทดสอบ
การติดตั้งใช้งานทดสอบคือการรวมกันของส่วนเสริมและเอกสารทดสอบ เมื่อพัฒนาเวอร์ชันสคริปต์และต้องการทดสอบเป็นส่วนเสริมแล้ว ให้ทำตามขั้นตอนต่อไปนี้
- หากยังไม่มี ให้สร้างสเปรดชีต เอกสาร งานนำเสนอ หรือแบบฟอร์มเพื่อทดสอบส่วนเสริม
- เปิดโปรเจ็กต์สคริปต์ที่มีส่วนเสริม
- คลิกทำให้ใช้งานได้ > ทดสอบการทำให้ใช้งานได้
- ข้างเลือกประเภท ให้คลิกเปิดใช้ประเภทการติดตั้งใช้งาน แล้วเลือกส่วนเสริมของเอดิเตอร์
- คลิกสร้างการทดสอบใหม่หรือเพิ่มการทดสอบ
- เลือกเวอร์ชันโค้ดหรือเลือกโค้ดล่าสุด
- ในส่วนกำหนดค่า ให้เลือกสถานะการให้สิทธิ์เริ่มต้นสำหรับการทดสอบ
- คลิกยังไม่ได้เลือกเอกสารในส่วนเอกสารทดสอบ เลือกไฟล์ชีต, เอกสาร, สไลด์ หรือฟอร์มที่ต้องการใช้เพื่อทดสอบส่วนเสริม แล้วคลิกแทรก
- คลิกบันทึกการทดสอบ
การติดตั้งใช้งานทดสอบที่บันทึกไว้ทั้งหมดจะปรากฏในกล่องโต้ตอบการติดตั้งใช้งานทดสอบ ซึ่งจะช่วยให้ คุณกลับไปดูการทดสอบเดียวกันได้ในภายหลัง
เรียกใช้การทดสอบการติดตั้งใช้งาน
หากมีการทดสอบการติดตั้งใช้งานที่บันทึกไว้อย่างน้อย 1 รายการ คุณจะเรียกใช้รายการใดรายการหนึ่งได้โดย ทำตามขั้นตอนต่อไปนี้
- เปิดโปรเจ็กต์สคริปต์ที่มีส่วนเสริม
- คลิกทำให้ใช้งานได้ > ทดสอบการทำให้ใช้งานได้
- ในส่วนการทดสอบที่บันทึกไว้ ให้เลือกปุ่มตัวเลือกข้างการติดตั้งใช้งานการทดสอบที่บันทึกไว้ ที่ต้องการเรียกใช้ แล้วคลิกดำเนินการ
เอกสารทดสอบจะเปิดขึ้นในแท็บใหม่ ส่วนเสริมอยู่ในสถานะการให้สิทธิ์ ที่ระบุในการทำให้ใช้งานได้สำหรับการทดสอบ คุณยืนยันว่าส่วนเสริมทำงานตามที่ ต้องการได้โดยโต้ตอบกับเมนูและองค์ประกอบ UI ของส่วนเสริม
หากต้องการทดสอบฟีเจอร์ OAuth แบบละเอียดในส่วนเสริม โปรดตรวจสอบว่าโปรเจ็กต์ของคุณยังไม่มีการให้สิทธิ์ หากต้องการยกเลิกการให้สิทธิ์ที่มีอยู่ ให้ใช้ ScriptApp.invalidateAuth
รายละเอียดการทดสอบ
มีหลายสิ่งที่คุณควรคำนึงถึงขณะทดสอบส่วนเสริมของเอดิเตอร์ด้วยวิธีนี้
- ระบบไม่รองรับทริกเกอร์ที่ติดตั้งได้ เมื่อทดสอบ ฟังก์ชันการทำงานที่ขึ้นอยู่กับทริกเกอร์ที่ติดตั้งได้ จะทดสอบไม่ได้
- ขณะเรียกใช้การติดตั้งใช้งานทดสอบที่ตั้งค่าให้ทดสอบด้วยโค้ดล่าสุด คุณจะเห็นการเปลี่ยนแปลงที่บันทึกไว้ในสคริปต์ส่วนเสริมได้โดยการรีเฟรชเอกสารทดสอบ
- เอกสารทดสอบมี URL ที่คุณแชร์กับเอดิเตอร์ของเอกสารทดสอบต้นฉบับได้ วิธีนี้จะช่วยให้คุณทำงานร่วมกับผู้อื่นได้ง่ายขึ้นขณะ ทดสอบและพัฒนา
- หากส่วนเสริมใช้บริการพร็อพเพอร์ตี้ พร็อพเพอร์ตี้จะยังคงอยู่และพร้อมใช้งานในครั้งถัดไปที่เรียกใช้การติดตั้งใช้งานทดสอบ
- นอกจากนี้ การติดตั้งใช้งานการทดสอบใดๆ ที่ใช้ส่วนเสริมและเอกสารทดสอบชุดเดียวกันจะมีสิทธิ์เข้าถึงข้อมูลพร็อพเพอร์ตี้เดียวกัน เช่น หากคุณสร้างการทดสอบ 2 รายการ พร็อพเพอร์ตี้ที่บันทึกไว้ขณะเรียกใช้การทดสอบแรกจะพร้อมใช้งานขณะเรียกใช้การทดสอบที่ 2 และในทางกลับกัน แต่จะใช้ได้ก็ต่อเมื่อการทดสอบใช้สคริปต์และเอกสารทดสอบเดียวกัน
- หากเรียกใช้การติดตั้งใช้งานทดสอบ คุณอาจได้รับแจ้งให้ให้สิทธิ์หาก ยังไม่เคยเรียกใช้สคริปต์มาก่อน โปรดทราบว่าการให้สิทธิ์สคริปต์ขณะทดสอบจะให้สิทธิ์สคริปต์นอกการทดสอบด้วย