CSV Gateway คือวิธีการอัตโนมัติในการนำเข้าไฟล์ CSV เข้าสู่ Canvas โดยไฟล์จะถูกถ่ายโอนผ่านโปรโตคอลการถ่ายโอนไฟล์ที่ปลอดภัย (SFTP) CSV Gateway จะมีประโยชน์อย่างยิ่งหากระบบสารสนเทศนักศึกษา (SIS) ของคุณไม่มีการเชื่อมต่อ API โดยตรงกับ Canvas
หากท่านสนใจในการตั้งค่า CSV Gateway/SFTP สำหรับการจัดเตรียมข้อมูลหรือการส่งออกเกรด โปรดติดต่อผู้จัดการฝ่ายความสำเร็จของลูกค้า (CSM) ของ Instructure
สิ่งที่คุณควรรู้
- ไฟล์ CSV ต้องเป็นไปตามหลักเกณฑ์รูปแบบ CSV ของ Canvas สามารถดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบ CSV ของ Canvas ได้ใน...ไกด์ของเรา.
- กฎมาตรฐานของไฟล์ CSV มีผลบังคับใช้:
- แถวแรกถือเป็นส่วนหัวและเป็นข้อมูลที่จำเป็น
- ข้อความทั้งหมดในไฟล์ต้องเข้ารหัสแบบ UTF-8
- เวลาทั้งหมดควรอยู่ในรูปแบบ ISO 8601 โดยค่าเริ่มต้นจะใช้เวลา UTC เว้นแต่จะระบุค่าชดเชยเขตเวลาไว้
- การนำเข้าข้อมูลไม่ได้เกิดขึ้นแบบเรียลไทม์ การซิงค์ข้อมูลจะถูกกำหนดเวลาไว้ ความถี่ในการซิงค์จะขึ้นอยู่กับชุดข้อมูลของคุณ และสามารถปรึกษาหารือเพิ่มเติมกับที่ปรึกษาของ Instructure ได้ โดยทั่วไปแล้ว การซิงค์ตามกำหนดเวลาส่วนใหญ่จะเป็นวันละหนึ่งหรือสองครั้ง
- ตัวเลือกเสริมรายงานการส่งออกเกรดสามารถตั้งเวลาให้ติดตั้งที่ประตูทางเข้าได้วันละครั้ง
- เอความแตกต่างสามารถกำหนดค่าไดเร็กทอรีได้ตามคำขอ การนำเข้าแบบเปรียบเทียบความแตกต่างจะตรวจสอบการเปลี่ยนแปลงในไฟล์ที่ส่งมาและดำเนินการกับระเบียนใดๆ ที่หายไป หากคุณสนใจที่จะกำหนดค่านี้ ที่ปรึกษาของ Instructure สามารถให้ข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าได้
- หลังจากตั้งค่าและซิงค์ SFTP กับระบบ Production เสร็จแล้ว ลูกค้าจะต้องติดต่อฝ่ายสนับสนุนเพื่อขอความช่วยเหลือในการแก้ไขปัญหาและ/หรือเปลี่ยนแปลงการตั้งค่า SFTP
ฉันจะเริ่มต้นได้อย่างไร?
ขั้นแรก ลูกค้าต้องพิจารณาว่าใครจะเป็นผู้ให้บริการเซิร์ฟเวอร์ SFTP โดยมีสองตัวเลือกสำหรับการให้บริการเซิร์ฟเวอร์ SFTP
- Instructure สามารถให้บริการโฮสติ้งเซิร์ฟเวอร์ได้
- ลูกค้าเป็นผู้ให้บริการเซิร์ฟเวอร์ SFTP
ลูกค้ามีหน้าที่สร้างไฟล์ CSV สำหรับข้อมูลของตนเองให้ตรงตามข้อกำหนด CSV ของ Canvas และส่งไฟล์เหล่านั้นไปยังเซิร์ฟเวอร์ SFTP จากนั้น Instructure จะประมวลผลไฟล์ที่ส่งมาตามกำหนดการ
ในขั้นต้น CSV Gateway จะเชื่อมต่อกับอินสแตนซ์ Canvas Beta ของลูกค้าเพื่อทำการทดสอบเบื้องต้น การเชื่อมต่อจะไม่เปลี่ยนไปยังอินสแตนซ์ Canvas Production ของลูกค้าจนกว่าลูกค้าจะส่งหนังสือยืนยันเป็นลายลักษณ์อักษรเพื่อสิ้นสุดการทดสอบให้กับที่ปรึกษาของ Instructure
เซิร์ฟเวอร์ที่โฮสต์โดย Instructure
หาก Instructure เป็นผู้ให้บริการเซิร์ฟเวอร์ SFTP ลูกค้าจะต้องสร้างคู่คีย์ SSH โดยคีย์สาธารณะจะถูกส่งไปยังที่ปรึกษาของ Instructure
ไม่ควรเปิดเผยรหัสส่วนตัว หากมีการเปิดเผยรหัสส่วนตัว Instructure จะขอให้สร้างคู่รหัสใหม่
เมื่อสร้างคู่คีย์ SSH โปรดคำนึงถึงสิ่งต่อไปนี้:
- Instructure กำหนดให้คีย์ต้องมีความยาวบิตขั้นต่ำ 2048 บิต
- โดยทั่วไปแล้ว คีย์สาธารณะจะมีนามสกุลอย่างใดอย่างหนึ่งต่อไปนี้: .pub หรือ .pem
- รูปแบบคีย์บางรูปแบบจะมีคีย์ส่วนตัวพร้อมกับคีย์สาธารณะ โปรดส่งเฉพาะคีย์สาธารณะมาให้เรา มิเช่นนั้นเราจะต้องสร้างคู่คีย์ใหม่
หลังจากที่ได้ส่งรหัสสาธารณะให้กับที่ปรึกษาของ Instructure และอัปโหลดไปยังเซิร์ฟเวอร์ SFTP แล้ว ลูกค้าจะได้รับข้อมูลต่อไปนี้:
- เซิร์ฟเวอร์
- ท่าเรือ
- ชื่อผู้ใช้
- ไดเร็กทอรี
- ซิงค์ตารางเวลา
เซิร์ฟเวอร์ที่ลูกค้าเป็นผู้ดูแล
หากลูกค้าเลือกที่จะเป็นผู้ให้บริการเซิร์ฟเวอร์ SFTP เอง Instructure จะต้องได้รับข้อมูลการเชื่อมต่อ
ห้ามส่งข้อมูลนี้ทางอีเมล
ที่ปรึกษาของ Instructure จะส่งลิงก์ที่ปลอดภัยให้คุณเพื่ออัปโหลดไฟล์ .txt ที่มีข้อมูลต่อไปนี้:
- เซิร์ฟเวอร์
- ท่าเรือ
- ชื่อผู้ใช้
- การตรวจสอบสิทธิ์
- โฟลเดอร์/ไดเร็กทอรี
นอกเหนือจากการให้ข้อมูลที่ร้องขอแก่ที่ปรึกษาของ Instructure แล้ว ลูกค้าอาจจำเป็นต้องเพิ่มที่อยู่ IP ของ Instructure ลงในรายการที่อนุญาต (allowlist) ที่ปรึกษาของ Instructure จะให้ข้อมูลที่ร้องขอแก่คุณ การกำหนดค่า/การปรับแต่งเพิ่มเติมอาจจำเป็นบนเซิร์ฟเวอร์ที่โฮสต์ของลูกค้า หาก Instructure ไม่สามารถเชื่อมต่อกับเซิร์ฟเวอร์ SFTP ระยะไกลได้