SFTP を使って生徒、職員、クラスのデータを Apple School Manager にアップロードする

テンプレートを編集する場合は、サンプルデータを実際のデータに置き換えてください。各ファイルの見出しセルの内容は変更しないでください。以下に説明されている場合を除いては、ファイルに列を追加しないでください。

どのテンプレートでも、各行でそれぞれ一意の値を表す必要があります。たとえば、「students.csv」では、各行が個々の生徒を表します。生徒に関する一部の値が空になってもかまいません。改行や疑問符などのリテラル値が名前に含まれている場合は、バックスラッシュ (\) でエスケープする必要があります (例：\”)。ID を入力する場合は必ず英数字を使います。「-」は含めてもかまいません。

値にスペース ( ) やカンマ (,) が含まれている場合は、二重引用符 (") で囲みます。値にこうした特殊文字が含まれていない場合は、二重引用符は使わないでください。必要な二重引用符を割愛した場合や、スマート (カーリー) 引用符を使った場合は、アップロードの過程でエラーが起きることがあります。

ファイル内の値は、ファイルの作成方法を問わず、カンマ (,) またはセミコロン (;) で区切る必要があります。カンマまたはセミコロンと次の値との間に、スペースやタブを入れないでください。各ファイルを UTF-8 でエンコードし、Unix の改行 (\n) を使う必要があります。 

person_number や sis_username といったオプションのフィールドでも、管理対象 Apple ID のフォーマットの一部となっている場合は、必須フィールドになります。空欄にすると、MANAGED_ID_GENERATION_FAILED エラーが起きてアップロードは失敗します。

「Locations」ファイルには、場所を少なくとも 1 つ定義しておく必要があります。SFTP を使って、「本部」となるメインの場所に生徒や職員のアカウントを作成することはできません。

SFTP を使って新しい人員をアップロードする際に、割り当てる person_id がすでに Apple School Manager で使われている場合、Apple School Manager の既存のユーザが新しいユーザで上書きされます。上書きが完了した後、そのユーザは SFTP 経由でしか変更できなくなります。 

* Federated Authentication が有効になっている場合、メールアドレスは必須です。メールアドレスが認証連携しているドメインのものである場合、該当するユーザアカウントも認証連携されます。

1 名の生徒に複数の場所を割り当てることができます。「Students」ファイルに場所 (location) の列を複数追加してください。最大で 998 個の location 列を追加できます。location_id_2、location_id_3 から location_id_999 までの名前を付けてください。各生徒に対し、これらの各列に別の location_id を任意に入力できます。「Locations」ファイルの location_id に対応する値を指定してください。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。

SFTP を使って新しい人員をアップロードする際に、割り当てる person_id がすでに Apple School Manager で使われている場合、Apple School Manager の既存のユーザが新しいユーザで上書きされます。上書きが完了した後、そのユーザは SFTP 経由でしか変更できなくなります。全職員に対し、標準パスワードポリシー (8 桁以上の英数字) が適用されます。

* Federated Authentication が有効になっている場合、メールアドレスは必須です。メールアドレスが認証連携しているドメインのものである場合、該当するユーザアカウントも認証連携されます。

1 名の職員に複数の場所を割り当てることができます。「Staff」ファイルに場所 (location) の列を複数追加してください。最大で 998 個の location 列を追加できます。location_id_2、location_id_3 から location_id_999 までの名前を付けてください。各職員に対し、これらの各列に別の location_id を任意に入力できます。「Locations」ファイルの location_id に対応する値を指定してください。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。

1 つのクラスに 4 名以上の講師を割り当てることができます。「Classes」ファイルに講師 (instructor) の列を複数追加してください。最大で 12 個の instructor 列を追加できます。instructor_id_4、instructor_id_5 から instructor_id_15 までの名前を付けてください。各クラスに対し、これらの各列に別の person_id を任意に入力できます。「Staff」ファイルで使われている person_id と一致する ID を指定してください。

「Rosters」ファイルを使って、クラスに生徒を追加します。ファイルの各行には、固有の roster_id が必要です。また、class_id と person_id をそれぞれ 1 つだけ含めます。

以前アップロードしたときにはあったエントリがなくなっている場合、そのアカウントはボリュームコンテンツを購入しない限り、120 日経つと無効化され、自動的に削除されます。

コースやクラスがアップロード対象から削除された場合、そのクラスから生徒が削除され、ソースは「手動」に切り替わります。コースがスクールワークで使用されていた場合は、名簿が削除されるので、再登録できるように新しいコースを作成する必要があります。クラスがスクールワークで使われていた場合、進捗データが自動的に削除され、生徒も教師も利用できなくなります。

手動ソースのコースやクラスは引き続き MDM ソリューションと同期されますが、クラスルーム App には表示されなくなります。手動設定のクラスを同期対象から削除する場合、Apple School Manager で削除できます。