SDS V2.1 CSV ファイル形式

学校データ同期 (SDS) V2.1 形式の CSV (コンマ区切り値) ファイルを使用して、学校情報システム (SIS) をOffice 365と同期できます。 SDS V2.1 CSV ファイル形式を使用してデータカテゴリを取り込むため、プロビジョニング用のコア SDS 機能を明るくすることができます。また、Microsoft 365 の製品と機能のエクスペリエンスを強化するのにも役立ちます。 SDS V2.1 CSV ファイル形式は、引き続きサポートされているデータカテゴリを拡張します。

SDS V2.1形式を使用している場合は、ファイルを適切にフォーマットする必要があります。詳細とまったく同じ名前のファイルをアップロードします。列ヘッダーでは、大文字と小文字が区別されます。 CSV ファイルは UTF-8 形式で、RFC に準拠している必要があります。また、受信データの改行は受け付けられません。 SDS V2.1 CSV ファイルのサンプルセットを確認してダウンロードするには、 SDS GitHub リポジトリを参照してください。

重要

受信フローの作成中に最初にアップロードした後は、オプションのファイルでデータが変更されたかどうかに関係なく、後続のアップロードに同じファイルセットを常に指定する必要があります。そうしないと、レコードがアクティブではなくなったとシステムによって判断され、そのようにマークされます。

必須: 次の 3 つのファイルを指定する必要があります。クラスではなくユーザーのみを管理している場合は、これらのファイルのみを指定する必要があります。 

orgs.csv
users.csv
roles.csv

省略可能/必須: ユーザーのみを管理している場合、次の 2 つのファイルは必要ありません。クラスとクラスの登録も管理している場合は、これら 2 つのファイルと 3 つのファイルを指定する必要があります。

classes.csv
enrollments.csv

省略可能: 次のファイルは省略可能であり、エクスペリエンスを強化するために使用されます。前述のファイルにメモに基づくデータ参照がない限り、これらのファイルは必要ありません。 

academicSessions.csv (roles.csv、classes.csv、または courses.csv に学術セッションデータが含まれている場合は、データを処理するときにエラーメッセージを回避するために、対応するデータを指定する必要があります)。
courses.csv (classes.csv データにコースへのリンクが含まれている場合は、データを処理するときにエラーメッセージを回避するために、対応するデータを指定する必要があります)。
demographics.csv
userFlags.csv
relationships.csv

各 CSV ファイルには、[必須] の [はい] と書き込まれたフィールドのデータが含まれている必要があります。"いいえ" と書き込まれたフィールドは "省略可能" のデータです。 "必須" としてマークされたフィールドヘッダーは、指定されたファイルに存在する必要があります。または、受け入れられません。 'Optional' としてマークされたフィールドヘッダーは、対応する省略可能なデータを渡さない場合、ファイルに存在する必要はありません。

[データ型] 列でマークされている定義済みの列挙値を持つフィールドには、サポートされている特定の値のセットがあります。 Enum フィールドでサポートされている既定値のセットについては、「値の既定の一覧」を参照してください。

orgs.csv

フィールド	必須	例	データ型
sourcedId	はい	10001	一意な ID
name	はい	工学部	文字列
type	はい	カレッジ	列挙
parentSourcedId	不要	10000	一意な ID

users.csv

フィールド	必須	例	データ型
sourcedId	はい	14001	一意な ID
username	はい	cbeane@___domain.com	文字列
familyName	はい (ユーザーを作成する場合のみ)	クレイグ	文字列
givenName	はい (ユーザーを作成する場合のみ)	ビーン	文字列
activeDirectoryMatchId	不要	craig.beane@___domain.com	文字列
メール	不要	cbeane@___domain.com	電子メール
phone	不要	+1234567890	Phone
sms	不要	+1234567890	Phone
userNumber	不要	14001	文字列

"一致しないユーザーの作成" オプションを使用する場合は、familyName と givenName がユーザーに必要です。
familyName、givenName、および電子メールは、relationships.csv で連絡先関係の役割を持つユーザーの "学生の連絡先の関連付け" のオプションを使用する場合は、ユーザーに必要です。スタッフであり、連絡先でもあるユーザーの場合は、連絡先ユーザーレコードがプライベートメールアドレスに関連付けられた 2 つのユーザーレコードを一覧表示することをお勧めします。
E.164 標準に基づいて、電話と SMS のフィールドが書式設定されることを想定しています。プラス記号は電話番号で成功するか、プラス記号の後に国コード、地域コード、電話番号、および行番号が続きます。
password は、新しいユーザーを作成するための既定のパスワードを指定するために使用されなくなりました。

roles.csv

フィールド	必須	例	データ型
userSourcedId	はい	14001	一意な ID
orgSourcedId	はい	10001	一意な ID
role	はい	student	列挙
sessionSourcedId	不要	FS2021	一意な ID
grade	不要	PS1	列挙
isPrimary	不要	true	ブール型
roleStartDate	不要	2020-08-24	Date
roleEndDate	不要	2020-12-11	Date

'userSourcedId' フィールドを使用して関連付けられているユーザーへの参照を要求し、users.csv ファイルへの依存関係を生成します。
'orgSourcedId' フィールドを使用して関連付けられている組織への参照を必要とし、orgs.csv ファイルへの依存関係を生成します。
渡された場合: これは、'sessionSourcedId' フィールドを使用して関連する用語 (アカデミックセッション) への参照を必要とし、academicSessions.csv ファイルへの依存関係を生成します。
isPrimary は、このロールがその組織のプライマリ (true) またはセカンダリ (false) ロールであるかどうかを示します。複数のロールを渡す場合、同じユーザーと同じ組織に対して、各組織に対して 1 つのプライマリロールのみが (true) に設定されている必要があります。
ISO8601形式で指定する日付値。
成績レベル列挙型の受信値に先行ゼロ '0' が見つからない場合 (たとえば、'1' は、定義された値のリスト (ENUM) '01' と一致し、'01' として格納されます。

classes.csv

フィールド	必須	例	データ型
sourcedId	はい	12001	一意な ID
orgSourcedId	はい	10001	一意な ID
title	はい	コンピューターサイエンス 101	文字列
sessionSourcedIds	不要	FS2021	一意の ID[]
courseSourcedId	不要	C12001	一意な ID
code	不要	12001	文字列

これには、'orgSourcedId' フィールドを使用して関連付けられている学校 (org) への参照が必要であり、orgs.csv ファイルへの依存関係が生成されます。
渡された場合: これは、'sessionSourcedIds' フィールドを使用して関連する用語 (アカデミックセッション) への参照を必要とし、academicSessions.csv ファイルへの依存関係を生成します。
渡された場合: クラスが同じ学年の複数のセッション (秋学期や春学期など) に関連付けられている場合は、レコード上のセッションに両方の sourcedId を指定できます。値は、引用符で囲まれ、コンマで区切られた値を持つ単一の文字列に結合する必要があります。
- 複数の sessionSourcedIds への関連付けは、Data Lake にのみ格納されます。
- セッション ID の Microsoft 365 グループ拡張属性では、複数の関連付けがサポートされていません。
渡された場合: これは、'courseSourcedId' フィールドを使用して関連付けられているコースへの参照を必要とし、courses.csv ファイルへの依存関係を生成します。

enrollments.csv

フィールド	必須	例	データ型
classSourcedId	はい	12001	一意な ID
userSourcedId	はい	14001	一意な ID
role	はい	student	列挙

これには、'classSourcedId' フィールドを使用して関連付けられているクラスへの参照が必要であり、classes.csv ファイルへの依存関係が生成されます。
これには、'userSourcedId' フィールドを使用して関連付けられているユーザーへの参照が必要であり、users.csv ファイルへの依存関係が生成されます。

academicSessions.csv

フィールド	必須	例	データ型
sourcedId	はい	FS2021	一意な ID
title	はい	秋学期	文字列
type	はい	学期	列挙
schoolYear	はい	2021	列挙
startDate	はい	2020-08-24	Date
endDate	はい	2020-12-11	Date

日付値がISO8601形式で指定されることを想定しています。

courses.csv

フィールド	必須	例	データ型
sourcedId	はい	C12001	一意な ID
orgSourcedId	はい	10001	一意な ID
title	はい	コンピューターサイエンス 101	文字列
code	不要	CS101	文字列
schoolYearSourcedId	不要	Y2021	一意な ID
subject	不要	10	列挙
grade	不要	学部	列挙

これには、orgSourcedId フィールドを使用して関連付けられているorganization (org) への参照が必要であり、orgs.csv ファイルへの依存関係が生成されます。
渡された場合: これには、型が schoolYear である 'schoolYearSourcedId' フィールドを使用して、関連するアカデミックセッション年レコードへの参照が必要です。これにより、academicSessions.csv ファイルへの依存関係が生成されます。
成績レベル列挙型の受信値に先行ゼロ '0' が見つからない場合 (たとえば、'1' は、定義された値のリスト (ENUM) '01' と一致し、'01' として格納されます。

relationships.csv

フィールド	必須	例	データ型
userSourcedId	はい	14001	一意な ID
relationshipUserSourcedId	はい	P14001	一意な ID
relationshipRole	はい	後見人	列挙

連絡先関係 (ガーディアン) も同期している場合は、それらのレコードを users.csv に含める必要があります。
これには、'userSourcedId' フィールドを使用して関連付けられているユーザーへの参照が必要であり、users.csv ファイルへの依存関係が生成されます。
これには、'relationshipUserSourcedId' フィールドを使用して関連付けられているユーザーへの参照が必要であり、users.csv ファイルへの依存関係が生成されます。
さらに、連絡先関係ロールを持つユーザーには familyName、givenName、および電子メールが必要です。

demographics.csv

フィールド	必須	例	データ型
userSourcedId	はい	14001	一意な ID
性	不要	男性	列挙
birthDate	不要	2001-07-20	Date
birthCity	不要	Woodenville	文字列
birthState	不要	WA	列挙
birthCountry	不要	米国	文字列
ethnicityCodes	不要	hispanicOrLatinoEthnicity	列挙
raceCodes	不要	demographicRaceTwoOrMoreRaces	列挙

これには、'userSourcedId' フィールドを使用して関連付けられているユーザーへの参照が必要であり、users.csv ファイルへの依存関係が生成されます。
'raceCodes' への複数の値マッピングは、引用符で囲まれ、コンマで区切られた値を持つ 1 つの文字列に結合する必要があります。

userFlags.csv

フィールド	必須	例	データ型
userSourcedId	はい	14001	一意な ID
flag	はい	lep	列挙

これには、'userSourcedId' フィールドを使用して関連付けられているユーザーへの参照が必要であり、users.csv ファイルへの依存関係が生成されます。

Last updated on 2025-09-11