SDS 用の Clever 形式の CSV ファイル

Clever 形式の CSV (コンマ区切り値) ファイルを使用して、学校情報システム (SIS) をOffice 365と同期できます。 このファイル形式を使用して以下のデータ カテゴリを取り込み、プロビジョニング用のコア SDS 機能を明るくすることができます。 また、以下に示す Microsoft 365 の製品と機能のエクスペリエンスを強化することもできます。

Microsoft 365 の製品と機能のエクスペリエンスを強化する

Clever format CSV Files for SDS を使用する場合は、ファイルを適切にフォーマットする必要があります。 このセクションでは、SDS で使用する書式設定の要件について説明します。 絶対に必要なフィールドは、下の緑で強調表示されています。 これは、 CSV ファイル サンプル ページのサンプル情報とも結び付けられます。 次の 5 つの CSV ファイルは、以下の詳細とまったく同じ名前である必要があります。 admins.csv は SDS での使用を受け付けられません。

重要

受け入れる CSV ファイルとエクスポートされる既定の CSV ファイルには、いくつかの違いがあります。 これらの CSV ファイルをアップロードして正常に同期するには、ここに記載されている形式に従う必要があります。 詳細については、このページの下部にあります。 CSV ファイルは UTF-8 形式である必要があります。

students.csv

teachers.csv

schools.csv

sections.csv

enrollments.csv

Csv ファイル形式

各 CSV ファイルには、下の緑色で 強調表示されているすべての 必須フィールドが含まれている必要があります。 各 CSV ファイルには、一覧表示されている任意のオプション フィールドも含まれる場合があります。 CSV ファイルにサポートされていない文字が含まれている場合は、SDS 同期プロファイルセットアップ ウィザードで [サポートされていない特殊文字の置換] オプションを選択することで、同期中にインラインで置換できます。 ただし、これは"空白" を削除しません。これも無効です。 次の表に、ファイルごとに必要な属性と省略可能な属性を示します。

注:

Microsoft では、YYYY-MM-DD または YYYYMMDD の形式で、SDS CSV ファイル内のすべての日付フィールドに ISO 8601 形式 を使用することをお勧めします。 SDS では、次に示す [用語の開始日] フィールドと [終了日] フィールド内で、この形式を必要とする機能を今後数か月以内に導入する予定です。

  • >Students.csv 誕生日
  • >Sections.csv Term StartDate
  • >Sections.csv 用語 EndDate

必須属性と省略可能な属性。

必須属性と省略可能な属性

正しい列挙型

エラーと警告

分析情報検証処理用の sds

既定の Clever 形式の CSV ファイルと SDS で受け入れられるファイルの違い

SDS で受け入れられる Clever CSV ファイルと、Clever によってエクスポートされた既定の CSV ファイルとの間には、混乱が生じる可能性があるいくつかの相違点があります。 最大の違いは、Student.csv ファイルの [ユーザー名] と [パスワード] の列です。

ユーザー名フィールドは、主にプロファイルの作成時に一致する条件に必要です。 これは、「Clever 形式の CSV ファイルを使用してデプロイする方法」の手順 5 で確認できます。

ユーザー名列とパスワード列は、プロファイルの新しいユーザーを作成するときに使用されます。

その他の違いは、オプションの同期属性です。 SDS では、上記の関連するグループとユーザーに対してのみ拡張機能属性が同期されます。 これらのファイルに追加情報が含まれている場合、同期は引き続き処理されますが、追加情報はユーザーまたはグループに関連付けられません。 これは予期される動作であり、すべての CSV プロファイル同期に当てはまります。

例: Clever ドキュメントに記載されている "Gender" 列を使用して student.csv ファイルがアップロードされた場合、SDS はファイルを処理し、他の属性を対象の学生に同期しますが、性別と同期される属性はありません。