เริ่มต้นด้วยการทดสอบด้วยข้อความธรรมดาและแป้นพิมพ์: คัดลอกจากแอปในเครื่อง คลิกภายในเอกสาร Collabora แล้วกดCtrl+V(หรือCommand+Vบน macOS) หากต้องการคัดลอกออก ให้เลือกข้อความใน Collabora กดCtrl+CหรือCommand+Cจากนั้นวางลงในแอปในเครื่อง หากทางลัดใช้งานได้ แต่แถบเครื่องมือหรือการวางโดยคลิกขวาใช้งานไม่ได้ ปัญหาน่าจะอยู่ที่เส้นทางการอนุญาตคลิปบอร์ดของเบราว์เซอร์ หากทางลัดใช้งานไม่ได้เช่นกัน ให้ทดสอบทั้งสองทิศทางและตรวจสอบว่า Collabora ถูกฝังอยู่ในเว็บไซต์อื่นหรือไม่
วัดค่าความล้มเหลวก่อนทำการเปลี่ยนแปลงการตั้งค่า
คลิปบอร์ดของระบบคือบัฟเฟอร์ที่ใช้ร่วมกันซึ่งใช้ในการถ่ายโอนข้อมูลระหว่างแอปพลิเคชันต่างๆ Collabora Online ทำงานอยู่ภายในเบราว์เซอร์ ดังนั้นการคัดลอกข้ามขอบเขตของระบบจึงต้องผ่านกฎความปลอดภัยของเบราว์เซอร์ด้วย
- เปิดโปรแกรมแก้ไขข้อความพื้นฐานในเครื่อง แล้วคัดลอกประโยคสั้นๆ ที่ไม่เป็นความลับสักหนึ่งประโยค ใน Collabora ให้คลิกที่เนื้อหาเอกสาร แล้วใช้แป้นพิมพ์ลัดวางข้อความ
- ตอนนี้ให้คัดลอกประโยคสั้นๆ จากเอกสาร Collabora แล้ววางลงในโปรแกรมแก้ไขข้อความในเครื่อง
- สุดท้าย ลองคัดลอกและวางระหว่างแอปพลิเคชันในเครื่องสองแอป หากการทดสอบครั้งสุดท้ายนี้ยังคงล้มเหลว ให้ตรวจสอบระบบปฏิบัติการหรือคลิปบอร์ดของเดสก์ท็อประยะไกลก่อน เพราะ Collabora ไม่ใช่แอปพลิเคชันเดียวที่เกี่ยวข้อง
ให้ใช้ข้อความธรรมดาสำหรับการทดสอบครั้งแรก รูปภาพ ตาราง ช่วงข้อมูลในสเปรดชีต และข้อความที่มีการจัดรูปแบบอาจใช้รูปแบบคลิปบอร์ดที่แตกต่างกัน ดังนั้นการทดสอบด้วยข้อความธรรมดาจะช่วยแยกปัญหาการเข้าถึงพื้นฐานออกจากปัญหาการแปลงรูปแบบ
เกณฑ์พื้นฐานที่มีประโยชน์คือข้อความธรรมดาที่คัดลอกจากเอกสารบนเว็บไปยังแอปพลิเคชันในเครื่อง ทำซ้ำการทดสอบในทิศทางตรงกันข้ามลองใช้แป้นพิมพ์ของเบราว์เซอร์ดูก่อน
คลิกที่พื้นที่แก้ไขเอกสารเพื่อให้ได้รับโฟกัส ใช้ทางลัดของระบบแทนแถบเครื่องมือแก้ไขหรือเมนูบริบทของเบราว์เซอร์ บน Windows และ Linux ให้ใช้Ctrl+CและCtrl+V; บน macOS ให้ใช้Command+CและCommand+Vเมื่อข้อความจาก Collabora แจ้งว่าเบราว์เซอร์มีข้อจำกัดในการเข้าถึงคลิปบอร์ดและขอให้คุณใช้ทางลัด ให้ทำตามคำแนะนำนั้น การกระทำของแป้นพิมพ์จะเชื่อมโยงโดยตรงกับการกระทำของผู้ใช้และสามารถทำงานได้แม้ว่าการกระทำในเมนูที่เรียกใช้ API คลิปบอร์ดแบบอะซิงโครนัสจะถูกบล็อกอยู่ก็ตาม
หากไม่เป็นเช่นนั้น โปรดตรวจสอบให้แน่ใจว่าเอกสารสามารถแก้ไขได้ เคอร์เซอร์อยู่ในเอกสาร ไม่ใช่ในช่องค้นหาหรือช่องแถบเครื่องมือ และข้อความต้นฉบับถูกเลือกไว้จริง ปิดและเปิดเอกสารอีกครั้งหลังจากเปลี่ยนสิทธิ์การเข้าถึง เนื่องจากกรอบแก้ไขที่ค้างอยู่อาจคงนโยบายเดิมไว้
ขั้นแรก ตรวจสอบให้แน่ใจว่าข้อความธรรมดาถูกส่งมา จากนั้นทดสอบเนื้อหาที่มีรายละเอียดมากขึ้นที่คุณต้องการ เช่น ฟอนต์ สูตร รูปภาพ และรูปแบบเซลล์ ซึ่งอาจไม่ถ่ายโอนได้เหมือนกันทุกประการ ใช้ฟังก์ชันวางแบบพิเศษ (Paste Special) เมื่อปลายทางมีให้ใช้งาน
อนุญาตการเข้าถึงคลิปบอร์ดในเบราว์เซอร์
API Clipboard ในปัจจุบันถูกจำกัดให้ใช้งานเฉพาะในบริบทที่ปลอดภัย ซึ่งโดยปกติคือ HTTPS และเบราว์เซอร์อาจต้องการการกระทำหรือการอนุญาตจากผู้ใช้ ใน Chrome หรือ Edge ให้เปิดการควบคุมข้อมูลเว็บไซต์ที่อยู่ถัดจากที่อยู่ เปิดการตั้งค่าเว็บไซต์ และตั้งค่าClipboardเป็นอนุญาตสำหรับเว็บไซต์ที่เชื่อถือได้เมื่อมีสิทธิ์นั้น หากเบราว์เซอร์แสดงข้อความแจ้งเตือนเมื่อคุณเลือกวาง ให้อนุญาตเฉพาะบริการ Office ที่คุณเชื่อถือเท่านั้น โหลดเอกสารใหม่และทำซ้ำการทดสอบข้อความสองทิศทางอีกครั้ง
การอนุญาตคัดลอกและวางของเบราว์เซอร์อาจช่วยให้สามารถวางข้อมูลผ่านเมนูหรือการวางข้อมูลแบบละเอียดได้ เมื่อเบราว์เซอร์ร้องขอป้ายกำกับสิทธิ์การคัดลอกและพฤติกรรมของคลิปบอร์ดจะแตกต่างกันไปตามเบราว์เซอร์ เบราว์เซอร์บางตัวใช้ท่าทางของผู้ใช้หรือข้อความแจ้งให้วางชั่วคราวแทนการขออนุญาตแบบถาวร เบราว์เซอร์ที่มีการจัดการอาจบังคับใช้นโยบายที่ลบล้างการเลือกของคุณ หากตัวควบคุมถูกล็อกหรือนโยบายปฏิเสธการอนุญาต ให้ขอให้ผู้ดูแลระบบเบราว์เซอร์ตรวจสอบกฎสำหรับเว็บไซต์สำนักงาน รักษาเว็บไซต์ให้อยู่บน HTTPS: การให้สิทธิ์ไม่ได้เปลี่ยนแหล่งที่มาที่ไม่ปลอดภัยให้เป็นบริบทที่ปลอดภัย
หาก Collabora อยู่ภายใน iframe โปรดตรวจสอบการผสานรวม
iframe คือเว็บเพจที่ฝังอยู่ภายในเว็บเพจอื่น การใช้งาน Collabora หลายๆ รูปแบบใช้ iframe เพื่อให้แพลตฟอร์มหลักสามารถแสดงตัวแก้ไขได้ ในเบราว์เซอร์ที่ใช้ Chromium นั้น iframe ที่ฝังข้ามโดเมนอาจต้องการให้เว็บเพจที่ฝังข้อมูลอนุญาตการเข้าถึงคลิปบอร์ด คู่มือ SDK ของ Collabora ได้อธิบายคุณลักษณะของ iframe นี้ไว้สำหรับการสอบถามสิทธิ์การเข้าถึงคลิปบอร์ด:
<iframe allow="clipboard-read *; clipboard-write *">
เอกสาร SDK ของ Collabora ระบุสิทธิ์การเข้าถึงคลิปบอร์ดบน iframe ที่ฝังอยู่ มีเพียงแพลตฟอร์มที่สร้าง iframe นั้นเท่านั้นที่สามารถเปลี่ยนแปลงคุณลักษณะนี้ได้นี่คือการตั้งค่าสำหรับการผสานรวมที่สร้างเฟรม ไม่ใช่การตั้งค่า Docker บนเซิร์ฟเวอร์ Collabora หากคุณดูแลแอปพลิเคชันโฮสต์ โปรดตรวจสอบ iframe ของตัวแก้ไขจริงในเครื่องมือสำหรับนักพัฒนาของเบราว์เซอร์ และตรวจสอบว่าPermissions-Policyส่วนหัวการตอบสนองของหน้าหลักไม่ได้บล็อกclipboard-readหรือclipboard-writeปฏิเสธการเข้าถึง นโยบายหลักที่เข้มงวดอาจยังคงปฏิเสธการเข้าถึงแม้ว่า iframe จะมีallowแอตทริบิวต์ก็ตาม มอบสิทธิ์เฉพาะเฟรม Collabora ที่ผู้ใช้ของคุณต้องการเท่านั้น อย่าให้สิทธิ์การเข้าถึงคลิปบอร์ดอย่างกว้างขวางแก่เนื้อหาที่ฝังอยู่ซึ่งไม่เกี่ยวข้อง
หากคุณใช้ Nextcloud ที่โฮสต์อยู่ แพลตฟอร์มการเรียนรู้ หรือพอร์ทัลเอกสาร และไม่สามารถแก้ไขมาร์กอัปเฟรมหรือส่วนหัวการตอบสนองได้ โปรดส่งข้อมูลเบราว์เซอร์และเวอร์ชัน ทิศทางที่เกิดข้อผิดพลาด การใช้งานแป้นพิมพ์ลัด และข้อผิดพลาดคอนโซลที่เกี่ยวข้องกับคลิปบอร์ดไปยังผู้ดูแลระบบ พวกเขาอาจต้องอัปเดตการผสานรวม การเปลี่ยนพอร์ตเครือข่ายของ CODE หรือการรีสตาร์ทคอนเทนเนอร์จะไม่ให้สิทธิ์เบราว์เซอร์ในการเข้าถึง iframe
ใช้ข้อมูลอาการเพื่อเลือกการตรวจครั้งต่อไป
| สิ่งที่คุณสังเกตเห็น | สิ่งที่ต้องตรวจสอบต่อไป |
|---|
การวางบนแถบเครื่องมือล้มเหลว แต่Ctrl+Vใช้งานได้ | ใช้ทางลัดหรือให้สิทธิ์การเข้าถึงคลิปบอร์ดแก่เบราว์เซอร์สำหรับเว็บไซต์ที่เชื่อถือได้ตามที่ร้องขอ |
| มีเพียงการคัดลอก Collabora ไปยังเดสก์ท็อปเท่านั้นที่ล้มเหลว | ตรวจสอบข้อจำกัดในการคัดลอกหรือสิทธิ์ในการเขียนของเบราว์เซอร์ ตรวจสอบให้แน่ใจว่าได้คัดลอกข้อความที่เลือกไว้แบบง่ายๆ แล้ว |
| การวางข้อมูลจากเดสก์ท็อปไปยัง Collabora เท่านั้นที่ล้มเหลว | ตรวจสอบสิทธิ์การวางในเบราว์เซอร์ โฟกัสในเอกสาร และตรวจสอบว่าเฟรมโฮสต์มอบสิทธิ์การอ่านหรือไม่ |
| ข้อความในคอนโซลแจ้งว่า “API คลิปบอร์ดถูกบล็อกโดยนโยบายสิทธิ์การเข้าถึง” | หน้าเว็บที่ฝังตัวอยู่หรือส่วนหัวของการตอบกลับกำลังปิดกั้นการเข้าถึง เจ้าของระบบการผสานรวมต้องทำการปรับแก้ไข |
| ข้อความธรรมดาใช้ได้ แต่เนื้อหาที่มีรายละเอียดมากมายใช้ไม่ได้ | เปรียบเทียบรูปแบบคลิปบอร์ดที่รองรับกับตัวเลือกการวางของแอปปลายทาง อาจเป็นข้อจำกัดด้านความถูกต้องของรูปแบบมากกว่าความล้มเหลวของคลิปบอร์ดโดยสิ้นเชิง |
การละเมิดนโยบายสิทธิ์การเข้าถึงชี้ไปที่หน้าเว็บที่ฝังเนื้อหาหรือส่วนหัวของหน้าเว็บนั้น ตัวอย่างนี้เป็นเพียงภาพประกอบเพื่อการวินิจฉัย ไม่ใช่ผลการทดสอบจริงยืนยันผลลัพธ์
หลังจากเปลี่ยนแปลงสิทธิ์หรือการผสานรวมแล้ว ให้เปิดเอกสารอีกครั้งและทำการทดสอบข้อความธรรมดาทั้งสองแบบซ้ำอีกครั้ง: จากแอปในเครื่องไปยัง Collabora จากนั้นจาก Collabora ไปยังแอปในเครื่อง ตรวจสอบว่าข้อความปรากฏในตำแหน่งที่ต้องการ จากนั้นทดสอบเนื้อหาที่มีรายละเอียดเฉพาะที่คุณใช้งาน หากเมนูใช้งานได้เพียงอย่างเดียวหลังจากการเปลี่ยนแปลง ให้ตรวจสอบเส้นทางแป้นพิมพ์ด้วย หากทางลัดใช้งานได้เพียงอย่างเดียว แสดงว่าเส้นทางคลิปบอร์ดหลักใช้งานได้ แต่เส้นทางการอนุญาตเบราว์เซอร์แบบอะซิงโครนัสอาจยังคงถูกบล็อกอยู่
สำหรับกฎความปลอดภัยเกี่ยวกับการเข้าถึงคลิปบอร์ดของเบราว์เซอร์ โปรดดูเอกสารอ้างอิง Clipboard API ของ MDNสำหรับการควบคุมสิทธิ์ของเว็บไซต์ Chrome ให้ใช้ความช่วยเหลือเกี่ยวกับการตั้งค่าเว็บไซต์ของ Chrome เจ้าของระบบการผสานรวมสามารถตรวจสอบ เอกสารการผสานรวมขั้นสูงของ Collabora สำหรับข้อกำหนดด้านสิทธิ์การเข้าถึงคลิปบอร์ดของ iframe