SFTPを使って生徒、職員、クラスのデータをApple School Managerにアップロードする
現時点で、ご利用のStudent Information System（SIS）にApple School Managerが対応していない場合、またはSISをご利用でない場合は、生徒、職員、クラスのデータをSFTPを使ってApple School Managerにアップロードできます。
Apple School ManagerのSIS／SFTPアシスタントでSFTPを設定する際に、CSV形式のテンプレートファイルと、プライベートSFTPサーバへのアクセス情報が提供されます。サポート対象のSISからデータを書き出しても、Numbersなどのスプレッドシートアプリケーションでファイルを作成してもかまいません。SISから書き出す前に、SISの担当者に問い合わせて、Apple School Manager用の正しいフォーマットになっているか確認してください。
SFTPでアップロードするには、macOSに他社製のアプリケーションが必要です。SFTPクライアントがインストールされていない場合は、Mac App Storeでお探しください。
以下のボタンを使って、SFTPファイルの設定方法についてご確認ください。SFTPを使ってデータをApple School Managerにアップロードしたことがない場合は、「初回のSFTPアップロードを設定する」セクションから読み進めてください。
初回のSFTPアップロードを設定する
管理者、サイトマネージャ、またはユーザマネージャとしてApple School Managerにサインインします。
サイドバーの一番下でご自分の名前をクリックし、「環境設定」＞「アカウント」＞「ディレクトリ同期」の順にクリックして、「SIS／SFTP」セクションで「有効にする」を選択します。ドメインの確認作業を済ませてからでないと、SFTPを設定できません。
「生徒、講師、クラスを検索」をクリックします。
/locale/ja-jp/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
「SFTPの設定」をクリックします。
/locale/ja-jp/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple School Managerで、ファイルのアップロード時に使うURL、ユーザ名、パスワードが生成されます。この情報を使って、SFTPクライアントを構成します。
/locale/ja-jp/2022-asm-sftp-upload-data-sftp-info-step-5.png)
「テンプレートをダウンロード」をクリックします。
テンプレートを使う手順については、「データファイルに記入する」セクションを参照してください。
データファイルの入力が完了したら、6つのファイルすべてをまとめてzipアーカイブを作成します。Finderでファイルを選択し、「ファイル」メニューから「6項目を圧縮」を選択します。zipアーカイブの名前は問いません。
このzipファイルをApple School Managerにアップロードします。SFTPクライアントを使って、SIS／SFTPアシスタントに表示されるURLに接続します。サインイン情報の入力を求められたら、「SFTPを設定」をクリックしたときに受け取ったユーザ名とパスワードを使用してください。zipファイルをdropboxディレクトリにコピーします。
SIS／SFTPアシスタントで「続ける」をクリックします。アップロード内容にエラーがある場合は、ログを調べれば、エラーがあるのがどのファイルのどの行かを確認できます。データファイルの誤りを修正し、手順8と9を繰り返します。以前のファイルをSFTPサーバから削除する必要はありません。
SFTPでの読み込みが終わったら、「SFTPデータを確認」をクリックします。エラーが見つかった場合は、「キャンセル」をクリックします。データファイルにエラーがあれば訂正し、アップロードプロセスを繰り返してください。データが正確で過不足なく仕上がったら、「続ける」をクリックします。
/locale/ja-jp/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
「アカウントとクラスを作成」で、生徒、講師、職員の管理対象Apple IDのフォーマットを選択します。「アカウントとクラスをプレビュー」をクリックします。IDが正しいフォーマットで表示される場合は、「アカウントとクラスを作成」をクリックします。管理対象Apple IDフォーマットで使えるのは、確認済みのドメインだけです。
/locale/ja-jp/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
アカウントが作成された後で、サインイン情報をユーザに配布し、職員に役割を割り当てます。
/locale/ja-jp/2022-asm-sftp-upload-data-done-step-13.png)
データファイルに記入する
ダウンロードしたテンプレートには、クラス（Classes）、コース（Courses）、場所（Locations）、名簿（Rosters）、生徒（Students）、職員（Staff）用にカンマ区切り値（CSV）ファイルが6個入っています。テンプレートがApple School Managerに用意されていない場合や、オリジナルテンプレートのコピーをなくしてしまった場合は、再びダウンロードできます。
SISを使用して、テンプレートおよびこの記事で説明されているフォーマットでデータをエクスポートしたり、Numbersなどのスプレッドシートアプリでテンプレートを編集したりすることができます。
この記事の表を参考に、確かめながら正しい情報を入力し、各ファイルを名前を変更せずに保存してください。
所定のフォーマットで値を指定する
テンプレートを編集する場合は、サンプルデータを実際のデータに置き換えてください。各ファイルの見出しセルの内容は変更しないでください。以下に説明されている場合を除いては、ファイルに列を追加しないでください。
どのテンプレートでも、各行でそれぞれ一意の値を表す必要があります。たとえば、「students.csv」では、各行が個々の生徒を表します。生徒に関する一部の値が空になってもかまいません。名前に改行や引用符などのリテラル値が含まれている場合は、バックスラッシュ「\」でエスケープする必要があります（例：\"）。入力する識別子は英数字で構成され、「-」を含めることができます。
値にスペースやカンマ（,）が含まれている場合は、直線引用符（"）で囲んでください。値にこうした特殊文字が含まれていない場合は、引用符は使わないでください。必要な場所で引用符を使用しない場合や、曲線引用符を使用した場合は、アップロード処理でエラーが発生します。
ファイル内の値は、ファイルの作成方法に関係なく、カンマ（,）またはセミコロン（;）で区切ってください。カンマまたはセミコロンと次の値との間に、スペースやタブを入れないでください。各ファイルはUTF-8でエンコードし、Unix形式の改行（\n）を使用してください。
person_numberやsis_usernameといったオプションのフィールドでも、管理対象Apple IDのフォーマットの一部となっている場合は、必須項目になります。未入力のままにすると「MANAGED_ID_GENERATION_FAILED」エラーが発生し、アップロードが失敗します。
「Locations」ファイル
location_id | 数値や文字から成る固有の識別子。スペースは含めません。 | 必須 |
location_name | 場所の名前。 | 必須 |
「Locations」ファイルで少なくとも1つの場所を定義する必要があります。SFTPを使って、メインの「本部」の場所で生徒や職員のアカウントを作成することはできません。
「Students」ファイル
SFTPを使って新しいユーザをアップロードする際に、割り当てたperson_idがすでにApple School Managerに存在している場合、新しいユーザが既存のユーザをApple School Managerで上書きします。上書きが完了した後は、そのユーザはSFTP経由でしか更新できません。
person_id | 特定の生徒に固有の識別子。person_idは、SISで該当する固有識別子が使われている場合は、必ずその識別子と同じにしてください。このperson_idは、Apple School Managerにおけるその生徒の固有の識別子です。「Rosters」ファイルで生徒を参照したり、「Classes」ファイルで講師を参照したりする際にはこの値を使用します。 | 必須 |
person_number | 校内の生徒の識別に使える別の値。生徒の識別番号などを指定できます。 | 任意 |
first_name | 生徒の名前。 | 必須 |
middle_name | 生徒のミドルネーム。 | 任意 |
last_name | 生徒の姓。 | 必須 |
grade_level | 生徒の学年。 | 任意 |
email_address* | 生徒のメールアドレス。 | 任意 |
sis_username | SISにおける生徒のユーザ名。 | 任意 |
password_policy | password_policyフィールドを使って、生徒ごとにパスワードポリシーを設定します。password_policyフィールドには、数値の4、6、8を指定するか、空欄にしておく必要があります。8を選択した場合、標準のパスワードポリシー（8桁以上の英数字）が設定されます。この値は、場所のパスワードポリシーや、該当する生徒に対して設定されているほかのパスワードポリシーよりも優先して適用されます。password_policyを空欄にすると、新しい生徒にはその場所のデフォルトのパスワードポリシーが適用され、既存の生徒のパスワードポリシーは変更されません。 | 任意 |
location_id | 生徒のlocation_id。「Locations」ファイルのlocation_idに対応する値を指定する必要があります。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。 | 必須 |
* Federated Authenticationが有効になっている場合、メールアドレスは必須です。メールアドレスが認証連携しているドメインのものである場合、該当するユーザアカウントも認証連携されます。
複数の場所を割り当てる
「Students」ファイルにlocation列を複数追加することで、1人の生徒に複数の場所を割り当てることができます。最大で998個のlocation列を追加できます。location_id_2、location_id_3からlocation_id_999までの名前を付けてください。各生徒に対して、これらの各列に別のlocation_idを任意で入力できます。「Locations」ファイルのlocation_idに対応する値を指定する必要があります。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。
「Staff」ファイル
SFTPを使って新しいユーザ情報をアップロードする際、割り当てたperson_idがApple School Managerにすでに存在している場合、新しいユーザ情報でApple School Managerの既存のユーザが上書きされます。上書きが完了した後は、そのユーザはSFTP経由でしか更新できません。すべての職員に標準のパスワードポリシー（8文字以上の英数字）が適用されます。
person_id | 職員に固有の識別子。person_idは、SISで該当する固有識別子が使われている場合は、必ずその識別子と同じにしてください。このperson_idは、Apple School Managerにおけるその職員の固有の識別子です。「Classes」ファイルで講師を参照する際は、この値を使います。 | 必須 |
person_number | 校内の職員の識別に使える別の値。職員バッジの番号などを指定できます。 | 任意 |
first_name | 職員の名前。 | 必須 |
middle_name | 職員のミドルネーム。 | 任意 |
last_name | 職員の姓。 | 必須 |
email_address* | 職員のメールアドレス。 | 任意 |
sis_username | SISにおける職員のユーザ名。 | 任意 |
location_id | 職員のlocation_id。「Locations」ファイルのlocation_idに対応する値を指定してください。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。 | 必須 |
* Federated Authenticationが有効になっている場合、メールアドレスは必須です。メールアドレスが認証連携しているドメインのものである場合、該当するユーザアカウントも認証連携されます。
複数の場所を割り当てる
「Staff」ファイルにlocation列を追加することで、1人の職員に複数の場所を割り当てることができます。最大で998個のlocation列を追加できます。location_id_2、location_id_3からlocation_id_999までの名前を付けてください。各職員に対し、これらの各列に別のlocation_idを任意で入力できます。「Locations」ファイルのlocation_idに対応する値を指定する必要があります。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。
「Courses」ファイル
course_id | コースに固有の識別子。この値は、「Classes」ファイルで使われる、対応するcourse_idと一致させておく必要があります。 | 必須 |
course_number | コースの番号。SISやカリキュラムガイドのコース番号を指定できます。 | 任意 |
course_name | コースの名前。 | 任意 |
location_id | コースに紐づくlocation_id。「Locations」ファイルのlocation_idに対応する値を指定してください。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。 | 必須 |
「Classes」ファイル
class_id | クラスに固有の識別子。 | 必須 |
class_number | 教育機関内でクラスを識別するための番号またはコード。class_idとは異なり、class_numberはCSV形式の名簿でクラスを参照する際には使われません。 | 任意 |
course_id | このクラスが属するコースのcourse_id。「Courses」ファイルのcourse_idと一致するIDを指定してください。 | 必須 |
instructor_id | 講師のperson_id。「Staff」ファイルで使われているperson_idと一致するIDを指定してください。 | 任意 |
instructor_id_2 | 講師のperson_id。「Staff」ファイルで使われているperson_idと一致するIDを指定してください。 | 任意 |
instructor_id_3 | 講師のperson_id。「Staff」ファイルで使われているperson_idと一致するIDを指定してください。 | 任意 |
location_id | クラスのlocation_id。「Locations」ファイルのlocation_idに対応する値を指定してください。この値が「Locations」ファイルのエントリと一致しない場合は、アップロードの過程で問題が起きます。 | 必須 |
複数の講師を割り当てる
「Classes」ファイルにinstructor列を追加することで、1つのクラスに3名を超える講師を割り当てることができます。最大で12個のinstructor列を追加できます。instructor_id_4、instructor_id_5からinstructor_id_15までの名前を付けてください。各クラスに対し、別の講師のperson_idを任意で入力できます。「Staff」ファイルで使われているperson_idと一致するIDを指定してください。
「Rosters」ファイル
roster_id | SISやその他のコースデータベースにおける名簿の固有の識別子（利用可能な場合）。 | 必須 |
class_id | クラスに固有の英数値の識別子。「Class」ファイルのclass_idと一致するIDを指定してください。 | 必須 |
student_id | 1名の生徒のperson_id。 | 必須 |
「Rosters」ファイルを使って、クラスに生徒を追加します。ファイルの各行には、固有のroster_idが必要です。また、class_idとperson_idをそれぞれ1つだけ含めます。
ファイルをアップデートする
生徒、職員、クラスを追加または編集する際は、データファイルを編集して新しいコピーをアップロードします。ファイルをアップロードする際は、必ず6つのファイルすべてをアップロードしてください。また、各ファイルには追加対象の項目だけでなく、各カテゴリのリスト全体を含める必要があります。SFTPアカウント情報は、「設定」>「データソース」の順に選択して確認できます。
Apple School Manager内でSFTP接続を切断した場合、アカウントとクラスは手動設定に切り替わります。この問題を解決するには、SFTP接続を復元させ、新たにアップロードを実行してください。
初回のアップロードの後は、アップロードした時点で新しいアカウントとクラスが自動的に作成されます。エラーがある場合は、Apple School Managerからメールが届きます。
前回のアップロード時にはあったエントリがなくなっている場合
以前アップロードしたときにはあったエントリがなくなっている場合、そのアカウントはボリュームコンテンツを購入しない限り、120日経つと無効化され、自動的に削除されます。
コースやクラスが削除された場合
コースやクラスがアップロード対象から削除された場合、そのクラスから生徒が削除され、ソースは「手動」に切り替わります。コースがスクールワークで使用されていた場合は、名簿が削除されるので、再登録できるように新しいコースを作成する必要があります。クラスがスクールワークで使われていた場合、進捗データが自動的に削除され、生徒も教師も利用できなくなります。
手動ソースのコースやクラスは引き続きMDMソリューションと同期されますが、クラスルームアプリには表示されなくなります。手動設定のクラスを同期対象から削除する場合、Apple School Managerで削除できます。
Apple が製造していない製品に関する情報や、Apple が管理または検証していない個々の Web サイトについては、推奨や承認なしで提供されています。Apple は他社の Web サイトや製品の選択、性能、使用に関しては一切責任を負いません。Apple は他社の Web サイトの正確性や信頼性についてはいかなる表明もいたしません。詳しくは各メーカーや開発元にお問い合わせください。