在 Apple School Manager 使用 OneRoster 用户範本
使用 OneRoster 用户範本輸入學生、教師和職員帳户。person_id 值在所有位置都必須是獨一無二的。請參閱密碼類型例子。
附註:如果已開啟 聯合認證,便需輸入電郵地址。另外,如果特定電郵地址使用已建立聯合認證的網域,電郵地址必須獨一無二。如果電郵地址在已建立聯合認證網域內,用户帳户亦必須建立聯合認證。請參閱聯合認證簡介。
值 | 描述 | 範例 | 必須填寫/唯一 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sourcedId | SIS 或其他資料庫用以識別成員的獨有編號 請在名單和班級 .csv 中使用同一個 sourcedId 值來代表成員。 | AE4A6BB3-8D97-446A-BAA9-EDEA892453D3 | 是/是 | ||||||||
identifier | 在機構中用來識別成員的職員證編號或 ID 號碼 有別於 sourcedId,identifier 在其他 .csv 檔案中並不用來識別成員。 | 49 | 是/是 | ||||||||
orgSourcedIDs | 成員所屬機構的 SourcedId。 在大多數情況下,一名成員應只屬於一間學校 | 9P8O7I6U-5XCT-1WQ0-7F6G-3K2L1R6CVBMD | 是/否 | ||||||||
givenName | 成員的名字 | Eliza | 是/否 | ||||||||
middleName | 成員的中間名 | M | 是/否 | ||||||||
familyName | 成員的姓氏 | Block | 是/否 | ||||||||
grades | 與成員相關的年級 | 9 | 是/否 | ||||||||
role | 此成員的角色。選項有兩個:「student」和「teacher」。如果留空,系統會自動為此成員分派學生角色。 | 學生 | 是/否 | ||||||||
用户名稱 | 成員在 SIS 或其他學校資料庫中的用户名稱 | eblock | 是/否 | ||||||||
agentSourcedIDs | 與此成員有關係的成員 SourcedId。如果需要多個 ID,則使用雙引號並以逗號分隔。 在大多數情況下,這表示親子關係。 | AZP66BB3-8D97-446A-BQQ9-EDEA892453D3 | 否/否 | ||||||||
電郵 | 成員的電郵地址 | eb@townshipschools.org | 否/否 | ||||||||
status | 成員記錄的狀態。選項有兩個:「active」或「tobedeleted」。 | active | 否/否 | ||||||||
dateLastModified | 上次修改此成員資料的日期。日期必須使用 ISO 8601 格式表示(較常見的格式為 YYYY-MM-DD)。 | 2024-06-26 | 否/否 | ||||||||
enabledUser | 選項有兩個:「true」和「false」。True 表示此成員為有效用户。False 表示此成員為有效用户,但根據當地管理規則,系統存取權受到限制。 | True | 否/否 | ||||||||
userIDs | 此成員的外部機器可讀 ID(例如 LDAP Id)。此 ID 必須附帶一個類型來指示識別碼的性質。 | {LDAP:Id} {LDAP:Id},{LTI:Id},{Fed:Id} | 否/否 | ||||||||
電話 | 此成員的電話號碼。 | 888-555-1212 | 否/否 | ||||||||
sms | 此成員的 SMS 號碼。 | 888-555-1212 | 否/否 | ||||||||
密碼 | 成員登入帳户使用的密碼類型 密碼類型有以下三種:「8」(預設的標準類型)、「6」(六位數類型)和「4」(四位數類型)。 此值將取代位置的密碼類型及之前設定的密碼類型。 如 .csv 檔案中的密碼留空,該位置的學生預設密碼類型可設定如下:
| 8 | 否/否 |