重要
School Data Sync (SDS) Classic TRANSITION CUSTOMERS: v1 形式に基づいて新しい SDS エクスペリエンスにデータを取り込むため、すべてのフィールドがサポートされているわけではありません。 SDS v1 CSV ファイル形式で、データがサポートされていない場合は、[必須] 列に示されています。
重要
また、 渡される成績 の値と コースの件名 の値は、対応する 値のリスト (ENUM) コードに合わせる必要があります。 必要に応じて、[ 値のリストの管理] を 使用して 、[成績] の値と [コースの件名] を展開して、既定ではサポートされていないコード値をサポートします。
SDS V1 形式の CSV (コンマ区切り値) ファイルを使用して、学校情報システム (SIS) をOffice 365と同期できます。 SDS V1 CSV ファイル形式を使用してデータ カテゴリを取り込むため、プロビジョニング用のコア SDS 機能を明るくすることができます。 また、Microsoft 365 の製品と機能のエクスペリエンスを強化するのにも役立ちます。
SDS V1形式を使用している場合は、ファイルを適切にフォーマットする必要があります。 この記事で詳しく説明した名前のファイルをアップロードします。 列ヘッダーでは、大文字と小文字が区別されます。 CSV ファイルは UTF-8 形式で、RFC に準拠している必要があります。 また、受信データの改行は受け付けられません。 SDS V1 CSV ファイルのサンプル セットを確認してダウンロードするには、 SDS GitHub リポジトリを参照してください。
重要
受信フローの作成時に最初にアップロードした後は、オプションのファイルで行われたデータの変更に関係なく、後続のアップロードに同じファイル セットを常に指定する必要があります。 そうしないと、レコードがアクティブではなくなったとシステムによって判断され、そのようにマークされます。
必須: 続行するには、次の 3 つのファイルを選択する必要があります。 クラスではなくユーザーのみを管理している場合は、これらのファイルのみを指定する必要があります。
school.csv
student.csv
teacher.csv
省略可能/必須: ユーザーのみを管理している場合は必須ではありません。 クラスとクラスの登録も管理している場合は、次の 3 つのファイルと、前述の 3 つのファイルを指定する必要があります。 そうでない場合は、これらの名前を持つファイルを選択しないでください。
section.csv
studentenrollment.csv
teacherroster.csv
省略可能: 次のファイルは続行する必要はありませんが、エクスペリエンスを向上させる可能性があります。 次のいずれかのファイルを選択した場合は、もう一方のファイルも選択して続行する必要があります。
user.csv
guardianrelationship.csv (連絡先の関連付けを構築するには、ユーザーと学生のレコードが必要です)。
各 CSV ファイルには、[必須] の [はい] と書き込まれたフィールドのデータが含まれている必要があります。"いいえ" と書き込まれたフィールドは "省略可能" のデータです。 "必須" としてマークされたフィールド ヘッダーは、指定されたファイルに存在する必要があります。または、受け入れられません。 "省略可能" としてマークされたフィールド ヘッダーは、対応する省略可能なデータを渡さない場合、ファイルに存在する必要はありません。
[データ型] 列でマークされている定義済みの列挙値を持つフィールドには、サポートされている特定の値のセットがあります。 Enum フィールドでサポートされている既定値のセットについては 、「値の既定の一覧」を参照してください。
school.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 456789 | 一意な ID |
| 名前 | はい | Contoso High School | 文字列 |
| 学校 NCES_ID | 不要 | 456789 | 文字列 |
| 学校番号 | データはサポートされていません | ||
| 低成績 | データはサポートされていません | ||
| 高成績 | データはサポートされていません | ||
| 都道府県 ID | データはサポートされていません | ||
| 校長 SIS ID | データはサポートされていません | ||
| 校長名 | データはサポートされていません | ||
| 校長セカンダリ メール | データはサポートされていません | ||
| アドレス | データはサポートされていません | ||
| 都市 | データはサポートされていません | ||
| 状態 | データはサポートされていません | ||
| 郵便番号 | データはサポートされていません | ||
| 国 | データはサポートされていません | ||
| Phone | データはサポートされていません | ||
| 領域 | データはサポートされていません |
- 一覧に表示されるすべての組織は、organizationの種類 'school' に設定されます。
student.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 123456 | 一意な ID |
| 学校 SIS ID | はい | 456789 | 一意な ID |
| Username | はい | jsmith@contoso.edu | 文字列 |
| 名 | はい (ユーザーを作成する場合のみ) | John | 文字列 |
| 姓 | はい (ユーザーを作成する場合のみ) | Smith | 文字列 |
| ミドル ネーム | 不要 | ウィリアム | 文字列 |
| セカンダリ メール | 不要 | jsmith@contoso.edu | 電子メール |
| 学生番号 | 不要 | 123456 | 文字列 |
| 成績 | 不要 | 8 | 列挙 |
| 誕生日 | 不要 | 2009-12-19 | Date |
| 状態 | データはサポートされていません | ||
| Password | データはサポートされていません | ||
| 卒業年度 | データはサポートされていません | ||
| 都道府県 ID | データはサポートされていません |
- [School SIS ID] フィールドを使用して関連付けられている学校への参照を要求し、school.csv ファイルへの依存関係を生成します。
- 一覧表示されているすべてのユーザーは、ロールの種類 'student' に設定されます。
- 日付値がISO8601形式で指定されることを想定しています。
- グレード レベル ENUM の受信値に先頭のゼロ '0' が見つからない (例: '1') は、定義された値のリスト (ENUM) '01' と一致し、'01' として格納されます。
teacher.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 654321 | 一意な ID |
| 学校 SIS ID | はい | 456789 | 一意な ID |
| Username | はい | jcook@contoso.edu | 文字列 |
| 名 | はい (ユーザーを作成する場合のみ) | ジェーン | 文字列 |
| 姓 | はい (ユーザーを作成する場合のみ) | 料理する | 文字列 |
| ミドル ネーム | 不要 | メレディス | 文字列 |
| Teacher Number | 不要 | 654321 | 文字列 |
| 成績 | 不要 | 8 | 列挙 |
| セカンダリ メール | 不要 | jcook@contoso.edu | 電子メール |
| 状態 | データはサポートされていません | ||
| Password | データはサポートされていません | ||
| タイトル | データはサポートされていません | ||
| 都道府県 ID | データはサポートされていません | ||
| 資格 | データはサポートされていません |
- [School SIS ID] フィールドを使用して関連付けられている学校への参照が必要であり、school.csv ファイルへの依存関係が生成されます。
- 一覧表示されているすべてのユーザーは、ロールの種類 'teacher' に設定されます。
- グレード レベル ENUM の受信値に先行ゼロ '0' がありません。 たとえば、'1' は定義された値のリスト (ENUM) '01' と一致し、'01' として格納されます。
section.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 334455 | 一意な ID |
| 学校 SIS ID | はい | 456789 | 一意な ID |
| セクション名 | はい | 期間 1 - 世界の歴史 | 文字列 |
| セクション番号 | 不要 | 334466 | 文字列 |
| コース SIS ID | いいえ | 123456789 | 一意な ID |
| コース名 | 不要 | 世界史 10 | 文字列 |
| コース番号 | 不要 | 123456789 | 文字列 |
| コースの説明 | 不要 | 世界の歴史 | 文字列 |
| コースの主題 | 不要 | 54999 | 列挙 |
| 学期 SIS ID | データはサポートされていません | ||
| 学期名 | データはサポートされていません | ||
| 学期開始日 | データはサポートされていません | ||
| 学期終了日 | データはサポートされていません | ||
| 状態 | データはサポートされていません | ||
| Periods | データはサポートされていません |
- [School SIS ID] フィールドを使用して関連付けられている学校への参照が必要であり、school.csv ファイルへの依存関係が生成されます。
- 用語情報が必要な場合は、 SDS v2.1 CSV 形式 に移行し、academicSessions.csv ファイルも提供することをお勧めします。
studentenrollment.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| セクション SIS ID | はい | 334455 | 一意な ID |
| SIS ID | はい | 123456 | 一意な ID |
- これには、'Section SIS ID' フィールドを使用して関連するセクションへの参照が必要であり、section.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して関連付けられているユーザーへの参照が必要であり、student.csv ファイルへの依存関係が生成されます。
teacherroster.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| セクション SIS ID | はい | 334455 | 一意な ID |
| SIS ID | はい | 654321 | 一意な ID |
- これには、'Section SIS ID' フィールドを使用して関連するセクションへの参照が必要であり、section.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して関連付けられているユーザーへの参照が必要であり、teacher.csv ファイルへの依存関係が生成されます。
user.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| 電子メール | はい | jsmith@outlook.com | 電子メール |
| 名 | はい | John | 文字列 |
| 姓 | はい | Smith | 文字列 |
| Phone | 不要 | +1234567890 | Phone |
| SIS ID | 不要 | P_123456 | 一意な ID |
- 連絡先関係 (ガーディアン) も同期している場合は、それらのレコードを user.csv に含める必要があります。
- プラス記号が電話番号で使用され、成功する E.164 標準に基づいて、電話フィールドの書式設定が行われるか、プラス記号の後に国コード、市区コード、電話番号、および行番号が続く必要があります。
guardianrelationship.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 123456 | 一意な ID |
| 電子メール | はい | jsmith@outlook.com | 電子メール |
| 役割 | 不要 | 親 | 列挙 |
- 連絡先関係 (ガーディアン) も同期している場合は、それらのレコードを user.csv に含める必要があります。
- これには、'Email' フィールドを使用して関連付けられているユーザーへの参照が必要であり、user.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して関連付けられているユーザーへの参照が必要であり、student.csv ファイルへの依存関係が生成されます。
- ロールの値が指定されていない場合、リレーションシップ値の既定値は 'userContact' になります。