SDS (クラシック) V2.1 CSV ファイル形式
インジェスト方法による主要な SDS 機能と Microsoft 365 機能
SDS V2.1 形式の CSV (コンマ区切り値) ファイルを使用して、学校情報システム (SIS) をOffice 365と同期できます。 SDS V2.1 CSV ファイル形式を使用してデータ カテゴリを取り込むため、プロビジョニング用のコア SDS 機能を明るくすることができます。 また、一覧表示されている Microsoft 365 の製品と機能のエクスペリエンスを強化するのにも役立ちます。
注:
現在の CSV V2 形式のお客様は、2022 年 5 月まで引き続き使用できます。 追加機能を備えた CSV V2.1 形式を使用することをお勧めします。
SDS V2.1ファイルを適切にフォーマットする必要があります。 詳細とまったく同じ名前の 5 つのファイルをすべてアップロードします。 ファイルと列ヘッダーでは、大文字と小文字が区別されます。 CSV ファイルは UTF-8 形式である必要があります。 SDS V2.1 CSV ファイルのサンプル セットを確認してダウンロードするには、 SDS GitHub リポジトリを参照してください。
各 CSV ファイルには、緑色で 強調表示されているすべての 必須フィールドが含まれている必要があります。 強調表示されていないフィールドは省略可能です。 特定の属性の内容は省略可能ですが、列ヘッダーが必要です。 [型] 列でマークされている定義済みの列挙値を持つ属性には、サポートされている特定の値のセットがあります。 各属性でサポートされている列挙値のセットは、次のセクションにあります。
*'school' のみをフィルター処理するには
ユーザーを作成する場合:
ユーザー名フィールドでは、SDS で受け入れるためにドメインが必要です。 たとえば、「 cbean@domain.com 」のように入力します。
FamilyName、givenName、および電子メールは、relationships.csv でガーディアン ロールを持つユーザーに必要です。 スタッフであるだけでなく、連絡先でもあるユーザーは、プライベート メール アドレスに関連付けられた連絡先ユーザー レコードを含む 2 つのユーザー レコードを一覧表示することをお勧めします。
電話とSMSがE.164に入る予定です。 SDS プロビジョニングは、E.164 と一致していない場合、電話や SMS にエラーが発生しません。 検証は () -、 スペース、ピリオド (.) を取り除き、指定された値の先頭に存在する場合は + を保持します。
*レコードに複数の値が見つかった場合は、SDS プロビジョニングで 1 つの値のみを同期します。
サポートされる列挙値
SDS V2.1 形式では、列挙値として定義された属性があります。つまり、CSV ファイル内で選択した値のセットのみを指定できます。 指定した値以外の値を指定すると、同期処理中にエラーが発生します。 このセクションでは、SDS V2.1 形式でサポートされる列挙値を定義します。
users.csv には "role" 属性が含まれており、列挙型の値がサポートされています。
| ユーザー組織の役割 | ||
|---|---|---|
| 学生 | TeacherAssistant | Principal |
| プロクター | スタッフ | SpecialServices |
| 教師 | 教授 | コーチ |
| ItAdmin | リサーチ ツール | アシスタント |
| OfficeStaff | 講師 | 椅子 |
| 看護 師 | アフィリ エイト | 非常勤 |
| OccupationalTherapist | 卒業 生 | Substitute |
| インストラクター | Advisor | Paraprofessional |
| PhysicalTherapist | 教員 | 管理者 |
| SpeechTherapist | VisionTherapist | その他 |
orgs.csv には "type" 属性が含まれており、列挙型の値がサポートされています。
| 組織の種類 | ||
|---|---|---|
| 学校 | MinistryOfEducation | LocalAuthority |
| 部署 | 大学 | Region |
| 地区 | 大学 | 部署 |
| ローカル | キャンパス | 州 |
| 状態 | AdultEducation | ResearchCenter |
| National/標準の数字形式 | 自治 体 | プログラム |
| DepartmentOfEducation | AcademicTrust |
demographics.csv には "birth state" 属性が含まれており、列挙型の値がサポートされています。
| 状態 | ||
|---|---|---|
| Ak | La | または |
| アル | Ma | Pa |
| Ar | Md | Pr |
| AS | 私 | PW |
| アリゾナ 州 | Mh | Ri |
| CA | Mi | Sc |
| 共同 | ミネソタ | Sd |
| Ct | Mo | テネシー |
| DC | Mp | テキサス 州 |
| DE | さん | Ut |
| 階 | 山 | バージニア 州 |
| Fm | Nc | Vi |
| GA | Nd | Vt |
| 区 | NE | WA |
| こんにちは | Nh | ウィスコンシン |
| Ia | ニュージャージー | Wv |
| ID | Nm | ワイオミング 州 |
| イリノイ | ネバダ 州 | Aa |
| IN | ニューヨーク | Ae |
| Ks | ああ | Ap |
| ケンタッキー 州 | OK |
academicSessions.csv には、アカデミック セッションの "type" 属性が含まれており、列挙型の値がサポートされています。
| アカデミック セッションの種類 | ||
|---|---|---|
| SchoolYear | 学期 | 用語 |
demographics.csv には "sex" 属性が含まれており、列挙値がサポートされています。
| セックス | ||
|---|---|---|
| 男性 | 女性 | NotSelected |
academicSessions.csv には "学年" 属性が含まれており、列挙型の値がサポートされています。
| 学年 | ||
|---|---|---|
| 2021 | 2025 | 2029 |
| 2022 | 2026 | 2030 |
| 2023 | 2027 | 2031 |
| 2024 | 2028 |
relationships.csv には "リレーションシップ ロール" 属性が含まれており、列挙値がサポートされています。
| リレーションシップ ロール | ||
|---|---|---|
| 親 | ガーディアン | 補佐 官 |
| Relative | 子 | 管理者 |
| 医師 | その他 |
enrollments.csv には "role" 属性が含まれており、列挙型の値がサポートされています。
| 登録ロール | ||
|---|---|---|
| 学生 | VisionTherapist | Substitute |
| 補佐 官 | Paraprofessional | Principal |
| プロクター | TeacherAssistant | SpecialServices |
| 教師 | 教授 | Advisor |
| 管理者 | 講師 | コーチ |
| OccupationalTherapist | アフィリ エイト | Assistant |
| PhysicalTherapist | 非常勤 | スタッフ |
| SpeechTherapist | インストラクター |
Courses.csv には、アカデミック セッション "subject" 属性が含まれており、列挙型の値がサポートされています。
| コースの主題 | 説明 |
|---|---|
| 01 | 英語と文学 |
| 02 | 数学 |
| 03 | 生命物理科学 |
| 04 | 社会科学と歴史 |
| 05 | ビジュアル・パフォーミング・アーツ |
| 07 | 宗教教育と神学 |
| 08 | 身体・健康・安全教育 |
| 09 | 軍事科学 |
| 10 | 情報技術 |
| 11 | コミュニケーションとオーディオ/ビジュアル テクノロジ |
| 12 | ビジネスとマーケティング |
| 13 | 製造 |
| 14 | 医療科学 |
| 15 | パブリック、プロテクティブ、政府機関向けサービス |
| 16 | ホスピタリティと観光 |
| 17 | アーキテクチャと建設 |
| 18 | 農業、食料、天然資源 |
| 19 | Human Services |
| 20 | 輸送、物流、物流 |
| 21 | エンジニア リングとテクノロジ |
| 22 | その他 |
| 23 | サブジェクト固有ではない |
| 24 | 世界の言語 |
userFlags.csv には "flag" 属性が含まれており、列挙型の値がサポートされています。
| ユーザー フラグ | 説明 |
|---|---|
| FreeLunch | 無料ランチ |
| ReducedLunch | 減らされた昼食 |
| ホームレス | ホームレス |
| GiftedOrTalented | 才能または才能 |
| 504 | セクション 504 配置 |
| エル | 英語学習者 |
| Lep | 限られた英語能力 |
| IEP | 特別教育サービス/独立教育プランの対象 |
demographics.csv には "民族性" 属性が含まれており、列挙型の値がサポートされています。
| 民族 | 説明 |
|---|---|
| HispanicOrLatinoEthnicity | ヒスパニック系またはラテン系民族 |
demographics.csv には "race" 属性が含まれており、列挙型の値がサポートされています。
| レース | 説明 |
|---|---|
| AmericanIndianOrAlaskaNative | アメリカインディアンまたはアラスカネイティブ |
| NativeHawaiianOrOtherPacificIslander | ハワイ先住民または他の太平洋諸島人 |
| BlackOrAfricanAmerican | 黒人またはアフリカ系アメリカ人 |
| DemographicRaceTwoOrMoreRaces | 複数のレースを指定します |
| アジア | アジア |
| ホワイト | ホワイト |
roles.csv には "grade" 属性が含まれており、列挙型の値がサポートされています。
Courses.csv には、アカデミック セッション "grade" 属性が含まれており、列挙型の値がサポートされています。
| 成績 | 説明 |
|---|---|
| IT | 幼児/幼児 |
| Pr | 就学 前 |
| Pk | プレキンダーガーテン |
| TK | 移行幼稚園 |
| Kg | 幼稚園 |
| 01 | 1 年生 |
| 02 | 2 年生 |
| 03 | 3 年生 |
| 04 | 4 年生 |
| 05 | 5 年生 |
| 06 | 6 年生 |
| 07 | 1年生 |
| 08 | 8 年生 |
| 09 | 9 年生 |
| 10 | 10 年生 |
| 11 | 11年生 |
| 12 | 12年生 |
| 13 | グレード 13 |
| 14 | グレード 14 |
| Ps | 短大 |
| Ug | 非採点 |
| その他 | その他 |
| PS1 | 1 年生の後 |
| PS2 | 2年生後 |
| Ps3 | 2 秒後のジュニア |
| Ps4 | 2 番目のシニアの後 |
| 学部 | 学部 |
| 大学院 | 大学院 |
| 大学院 | 研究に重点を置いて卒業 |
| 卒業 生 | 卒業 生 |
| AdultEducation | 成人教育 |