Apple School ManagerでOneRoster登録テンプレートを使用する
SFTPを使用して、OneRoster登録テンプレートを使ってクラスの名簿を読み込みます。組織内で、すべての場所のすべてのsourcedIDテンプレートのすべての行に対して、それぞれのsourcedID値が一意でなければなりません。たとえば、あるOneRoster登録テンプレートに600名の生徒が含まれる場合、それらの600行には一意なsourcedID値、各生徒のsourcedID値、およびその生徒に関連付けられたクラスsourcedID値が含まれます。
また、各コースのクラスsourcedID値と、最低1個の生徒sourcedIDが含まれている必要もあります。それ以上の生徒がいる場合は行を追加していきます。たとえば10名の生徒がいる場合は10行が含まれており、各行が1名の生徒を表します。
値 | 説明 | 例 | 必須／固有 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | SISまたはその他のデータベース内でこの登録を一意に識別するために使われる数値です。 | BE8FF4CC-5BE2-47C6-9C42-6CDADB9072F8 | はい／はい | ||||||||
status | 登録レコードのステータス。オプションとして「アクティブ」または「削除予定」の2つがあります。 | アクティブ | いいえ／いいえ | ||||||||
dateLastModified | この登録の情報が最後に変更された日付。日付はISO 8601形式（一般的な形式はYYYY-MM-DD）で表現される必要があります。 | 2024-06-26 | いいえ／いいえ | ||||||||
classSourcedID | クラスのsourcedIDです。 | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | はい／いいえ | ||||||||
schoolSourcedID | このクラスが所属する学校または学部のsourcedIDです。 | DF48675-8307-446A-BAA9-EDEA567493D3 | いいえ／いいえ | ||||||||
userSourcedID | そのクラスを受講する生徒、またはクラスを受け持つ講師のsourcedID。 | AE4A6BB3-8D97-446A-BAA9-EDEA567453D3 | はい／いいえ | ||||||||
role | そのユーザの役割。オプションとして「生徒」および「教師」の2つがあります。 | 生徒 | はい／いいえ | ||||||||
primary | 役割が「教師」であるユーザにのみ当てはまります。オプションとして「True」および「False」の2つがあります。 開始日と終了日で定義された期間において、1人のユーザのみがクラスの主担当（primary）教師として指定されるべきです。 | True | いいえ／いいえ | ||||||||
beginDate | 登録の開始日。この日付は、クラスに指定されている関連学期（期間）と一致していなければなりません。 | 2026-08-22 | いいえ／いいえ | ||||||||
endDate | 登録の終了日（排他的）。この日付は、クラスに指定されている関連学期（期間）と一致していなければなりません。 | 2027-05-30 | いいえ／いいえ | ||||||||