如何取得考試成績與查看記錄

受眾：整合開發者 / 整合負責人（校長可讀摘要） · 適用：DodoSpeak Oral

目標：分清「學員在頁面裡看結果」「你們系統取成績寫回」「接入台演示記錄」三層，避免和教務 App 的班級報表混淆。

接入方式前提見 兩種正式接入。掛載見 怎麼嵌進你們的系統。

三層怎麼叫

教務 App 里老師看的「報告 / 班情」是另一套產品，見學生 / 老師指南；Oral 不提供整站教務成績冊後臺。

學員如何查看記錄（生產）

1. 登入換票：學生在你們系統登入 → 換票帶同一 外部用戶 id → 開啟記錄表面，看到自己的會話。
2. 頁面掛件：學生先用 學員碼（或 OTP / PIN）進入 → 開啟記錄表面，看到該名冊學員下的會話。
3. 兩種方式都可以看「我的練習 / 任務 / 考試」歷史；不要指望未認人的訪客彙總成個人檔案。

接入台對照：切到 學員：開口練 → 側欄 記錄。

如何取得考試成績（生產）

1. 學生走完 考試表面（exam）：熱身、計時、交卷（以嵌入頁為準）。掛件路徑須已完成學員認人。
2. 前端 onCompleted 只表示「頁面上像完成了」——成績以你們後端核對為準。
3. 後端用機構密鑰調用 Oral API（或接收 Webhook）拉取評分與交卷結果：
   • 換票：按會話 / 外部用戶 id；
   • 掛件：按會話 / 名冊學員 id（若名冊含學號欄位，再映射到你們 LMS）。
4. 再寫入你們的成績冊、作業系統或通知老師。

發布人在接入台按人查記錄，見 發布人：發布任務；生產等價能力兩條接入都有，主鍵不同（名冊人 vs 外部用戶 id）。

如何確認成功

• 學員開啟記錄表面能看到對應練習 / 考試結果（同一身份）。
• 換票路徑：後端按外部用戶 id 能拉到與交卷一致的成績欄位。
• 掛件路徑：後端或接入台按名冊學員能拉到成績；若業務要進學校成績冊，確認學號映射或改用換票。

常見失敗

相關閱讀

• 兩種正式接入：頁面掛件與登入換票
• 怎麼嵌進你們的系統
• 學員：開口練
• 術語表 · Oral