SDS V1 CSVファイル形式
重要
SDS (クラシック) 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 | String |
| 学校 NCES_ID | いいえ | 456789 | String |
| 学校番号 | データはサポートされていません | ||
| 低成績 | データはサポートされていません | ||
| 高成績 | データはサポートされていません | ||
| 都道府県 ID | データはサポートされていません | ||
| 校長 SIS ID | データはサポートされていません | ||
| 校長名 | データはサポートされていません | ||
| 校長セカンダリ メール | データはサポートされていません | ||
| Address | データはサポートされていません | ||
| 市区町村 | データはサポートされていません | ||
| 状態コード | データはサポートされていません | ||
| 郵便番号 | データはサポートされていません | ||
| 国 | データはサポートされていません | ||
| Phone | データはサポートされていません | ||
| 領域 | データはサポートされていません |
- 一覧に表示されるすべての組織は、organizationの種類 'school' に設定されます。
student.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 123456 | 一意な ID |
| 学校 SIS ID | はい | 456789 | 一意な ID |
| Username | はい | jsmith@contoso.edu | String |
| 名 | はい (ユーザーを作成する場合のみ) | John | String |
| 姓 | はい (ユーザーを作成する場合のみ) | Smith | String |
| ミドル ネーム | いいえ | ウィリアム | String |
| セカンダリ メール | いいえ | jsmith@contoso.edu | 電子メール |
| 学生番号 | いいえ | 123456 | String |
| 成績 | いいえ | 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 | String |
| 名 | はい (ユーザーを作成する場合のみ) | ジェーン | String |
| 姓 | はい (ユーザーを作成する場合のみ) | 料理する | String |
| ミドル ネーム | いいえ | メレディス | String |
| Teacher Number | いいえ | 654321 | String |
| 成績 | いいえ | 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 - 世界の歴史 | String |
| セクション番号 | いいえ | 334466 | String |
| コース SIS ID | いいえ | 123456789 | 一意な ID |
| コース名 | いいえ | 世界史 10 | String |
| コース番号 | いいえ | 123456789 | String |
| コースの説明 | いいえ | 世界の歴史 | String |
| コースの主題 | いいえ | 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 |
- これには、"セクション SIS ID" フィールドを使用して、関連付けられているセクションへの参照が必要です。 これにより、section.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して、関連付けられているユーザーへの参照が必要です。 これにより、student.csv ファイルへの依存関係が生成されます。
teacherroster.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| セクション SIS ID | はい | 334455 | 一意な ID |
| SIS ID | はい | 654321 | 一意な ID |
- これには、"セクション SIS ID" フィールドを使用して、関連付けられているセクションへの参照が必要です。 これにより、section.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して、関連付けられているユーザーへの参照が必要です。 これにより、teacher.csv ファイルへの依存関係が生成されます。
user.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| 電子メール | はい | jsmith@outlook.com | 電子メール |
| 名 | はい | John | String |
| 姓 | はい | Smith | String |
| Phone | いいえ | +1234567890 | Phone |
| SIS ID | いいえ | P_123456 | 一意な ID |
- 連絡先関係 (ガーディアン) も同期している場合は、それらのレコードを user.csv に含める必要があります。
- プラス記号が使用され、電話番号によって成功する E.164 標準に基づいて、またはプラス文字の後に国コード、市域コード、電話番号、および行番号が続く場合は、電話フィールドの書式設定が必要です。
guardianrelationship.csv
| フィールド | 必須 | 例 | データ型 |
|---|---|---|---|
| SIS ID | はい | 123456 | 一意な ID |
| 電子メール | はい | jsmith@outlook.com | 電子メール |
| 役割 | いいえ | Parent | 列挙 |
- 連絡先関係 (ガーディアン) も同期している場合は、それらのレコードを user.csv に含める必要があります。
- これには、'Email' フィールドを使用して、関連付けられているユーザーへの参照が必要です。 これにより、user.csv ファイルへの依存関係が生成されます。
- これには、'SIS ID' フィールドを使用して、関連付けられているユーザーへの参照が必要です。 これにより、student.csv ファイルへの依存関係が生成されます。
- ロールの値が指定されていない場合、リレーションシップ値の既定値は 'userContact' になります。