Apple School Managerにレコードを読み込むためのテンプレート情報
場所にデータを追加するために、次の6個のテンプレートが用意されています:
生徒:生徒アカウント情報が含まれます。
職員:講師を含む職員アカウント情報が含まれます。
コース:コースを定義します。
クラス:コースと講師(職員)情報が含まれます。
名簿:クラス、生徒、場所情報が含まれます。
場所:場所情報が含まれます。
テンプレートと管理対象Apple ID
管理対象Apple IDのフォーマットにperson_numberやsis_usernameといったオプションのフィールドが含まれている場合、それらのフィールドは必須フィールドになります。それらのフィールドを空白のままにした場合、SFTPのアップロードが失敗し、「MANAGED_ID_GENERATION_FAILED」のエラーが表示されます。
テンプレートの用意
テンプレートを用意する際は、以下の条件が満たされていなければなりません:
students.csvとstaff.csvのテンプレートでは、すべての場所を通じてperson_idが一意の値を持つようにします。
重要: SFTPを使用して新規ユーザをアップロードする際、割り当てたperson_idが別のユーザにすでに割り当てられている場合は、その新規ユーザでApple School Managerの既存のユーザが上書きされます。上書きの完了後、そのユーザのアップデートはSFTP経由でのみ行えます。
テンプレートを編集する場合は、サンプルデータを独自のデータで置き換えます。各ファイルのヘッダー行の内容を変更しないでください。どのファイルでも重複する列を作成しないでください。特定のテンプレートには、列を追加することができます。
それぞれのテンプレートで、各行に一意の値が指定されている必要があります。たとえば、students.csvファイル内の各行はそれぞれ固有の生徒が指定されている必要があります。生徒の一部の値は空にすることができます。リテラル値(たとえば、名前に含まれる改行や引用符)はバックスラッシュ(\)でエスケープする必要があります。例:\"。入力する識別子はすべて、英数字でなければなりません。ただし、ハイフン(-)を含めることはできます。
値にスペース( )またはカンマ(,)が含まれる場合は、直線型の引用符(")で囲みます。値にこれらの特殊文字が含まれない場合、引用符は使用しないでください。必要なところで引用符が使用されていない場合や、曲線型の引用符を使用した場合は、アップロードプロセスでエラーが発生します。
ファイルの作成方法に関わらず、ファイル内の値は、カンマ(,)またはセミコロン(;)で区切られていなければなりません。カンマまたはセミコロンと後続の値の間に、スペースやタブを使用しないでください。ファイルのエンコーディングにはUTF-8を使用します。行の終わりを示すには、UNIXの改行コードである\nを使用します。
以前にアップロードしたデータのエントリがなくなっている場合、そのアカウントは無効化され、120日後に自動的に削除されます(そのアカウントでコンテンツを一括購入している場合は除きます)。
.csvファイルの名前は、元のファイル名と完全に一致させる必要があります。
すべてのファイルを1つのZIPアーカイブファイル(.zip)に圧縮してからアップロードします。
ZIPアーカイブファイルに含まれるフォルダ内には、ファイルを入れないようにしてください。
他の.csvファイルに対する外部キー参照はすべて、参照先のファイル内で定義されている必要があります。
.csvテンプレートでの文字数制限
.csvテンプレートの一部のフィールドには、許容文字数に制限があります。
フィールド | テンプレート | 文字数制限 |
---|---|---|
first_name | 生徒、職員 | 32 |
middle_name | 生徒、職員 | 32 |
last_name | 生徒、職員 | 64 |
grade_level | 生徒 | 64 |
email_address | 生徒 | 256 |
person_number | 生徒、職員 | 64 |
person_id | 生徒、職員、クラス、名簿 | 256 |
sis_username | 生徒、職員 | 256 |
class_id | クラス、名簿 | 256 |
class_number | クラス | 64 |
course_id | コース、クラス | 256 |
course_name | コース | 128 |
course_number | コース | 64 |
location_name | 場所 | 256 |
location_id | 生徒、職員、コース、クラス、場所 | 256 |