
Sử dụng mẫu Đăng ký của OneRoster trong Apple School Manager
Sử dụng mẫu Đăng ký của OneRoster để nhập danh sách lớp bằng SFTP. Trong một tổ chức, mỗi giá trị sourcedID cần phải là duy nhất – đối với mỗi hàng trong từng mẫu sourcedID cho mọi vị trí. Ví dụ: Nếu một mẫu Đăng ký của OneRoster có 600 học sinh/sinh viên thì cần nhập 600 hàng giá trị sourcedID duy nhất, giá trị sourcedID của từng học sinh/sinh viên và giá trị sourcedID cho lớp học tương ứng của họ.
Mẫu cũng cần chứa giá trị sourcedID lớp của mỗi khóa học và chứa ít nhất một giá trị sourcedID học sinh/sinh viên. Các học sinh/sinh viên bổ sung sẽ được thêm theo hàng. Ví dụ: 10 học sinh/sinh viên tương đương với 10 hàng, mỗi hàng một người.
Giá trị | Mô tả | Ví dụ | Bắt buộc/Độc nhất | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | Mã số dùng để nhận dạng độc nhất yêu cầu đăng ký này trong SIS hoặc cơ sở dữ liệu khác. | BE8FF4CC-5BE2-47C6-9C42-6CDADB9072F8 | Có/Có | ||||||||
status | Trạng thái của hồ sơ đăng ký. Có hai tùy chọn: “active” hoặc “tobedeleted.” | active | Không/Không | ||||||||
dateLastModified | Ngày sửa đổi gần nhất đối với thông tin đăng ký này. Ngày cần phải được thể hiện bằng định dạng ISO 8601 (thường được định dạng là YYYY-MM-DD). | 26/06/2024 | Không/Không | ||||||||
classSourcedID | sourcedID của một lớp học. | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | Có/Không | ||||||||
schoolSourcedID | sourcedID của trường học hoặc khoa có lớp này. | DF48675-8307-446A-BAA9-EDEA567493D3 | Không/Không | ||||||||
userSourcedID | sourcedID của học sinh/sinh viên tham gia lớp học hoặc giáo viên/giảng viên đứng lớp. | AE4A6BB3-8D97-446A-BAA9-EDEA567453D3 | Có/Không | ||||||||
role | Vai trò của người này. Có hai tùy chọn: “student” và “teacher”. | student | Có/Không | ||||||||
chính | Chỉ áp dụng cho người dùng có vai trò là “teacher”. Có hai tùy chọn: “true” và “false.” Chỉ định một người dùng làm giảng viên chính cho một lớp trong khoảng thời gian xác định (có ngày bắt đầu và ngày kết thúc). | TRUE | Không/Không | ||||||||
beginDate | Ngày bắt đầu đăng ký. Ngày này cần phải phù hợp với thời gian học (học kỳ) tương ứng được xác định cho lớp. | 22/08/2026 | Không/Không | ||||||||
endDate | Ngày kết thúc đăng ký (nằm ngoài thời gian đăng ký). Ngày này cần phải phù hợp với thời gian học (học kỳ) tương ứng được xác định cho lớp. | 30/05/2027 | Không/Không |