GET /v1/assignments/{id}/enrollments 本來就會傳回的結構。此查詢不會將模組轉置為資料行。
政策確認不屬於本報告範圍。Living Security 沒有政策接受 API,因此這些舊版資料行不在範圍內,也不是待處理的對應項目。請參閱與舊版匯出內容的差異。
Fn_FetchAll 查詢;本報告會依名稱呼叫該查詢。
必要的金鑰範圍
來源端點
此查詢不會呼叫
GET /v1/entities。註冊資料列已包含 email 與 display_name,而且實體清單中沒有部門或職稱,因此巡覽該清單也無法填入註冊資料列尚未提供的目錄資料行。
資料粒度
每筆註冊(人員 × 指派)一列。若同一人員透過兩筆指派被指派相同課程,則會產生兩列。沒有任何註冊的人員不會出現,因為/v1 在沒有電子郵件的情況下無法產生可用的目錄資料列,而自行建立僅含人員的資料列會混用不同的資料粒度。
要求預算:每筆指派依序進行一次分頁巡覽,並受共用的每金鑰速率限制約束。請務必設定 limit = "500"。
資料行對應
舊版資料行名稱來自您先前供應商的匯出內容。/v1 欄位為公開 API 名稱;查詢會為報表將其中部分欄位設定別名。
為星狀結構描述模型保留的聯結鍵:
entity_id、assignment_id、course_id、user_assignment_id。
此查詢也會保留 course_slug、assignment_title、passed、attempts、assignment_lifecycle_status 與 assignment_created_at。enrollment_status 是學習者的進度,而非指派的生命週期(active / paused / completed)。
與舊版匯出內容的差異
- 無法取得政策接受資料。 本平台沒有政策領域,不存在
/policies、/policy_acceptances或同等的/v1資源。請勿將這些資料行視為待處理的對應項目,它們不在範圍內。 - 目錄附加資訊省略而不填入空值。 部門、職稱、主管與地點不在
/v1上。查詢不會為它們建立空白資料行。 - 包含到期日,即使舊版匯出內容沒有,因為 API 提供
Enrollment.due_at。 - 課程名稱優先採用型錄標題。
Course.title為模組名稱。僅在型錄資料列遺失(已刪除或未發布)時才使用Assignment.title。 - 長格式,不轉置。 每筆註冊一列,而非每位人員一列、每個模組一個資料行。
後續步驟
Power BI 與 Excel 設定
認證、分頁,以及在 Power BI 或 Excel 中載入這些查詢。
電子郵件網路釣魚記錄
過去 12 個月的事件層級網路釣魚互動。
最易受攻擊的使用者
每位人員 12 個月的點擊、認證及回報彙總。
API 金鑰
在重新整理本報告的金鑰上授予
training:read 與 course:read。
