SDS v1 CSV 形式でのデータインジェスト

[アーティクル]
11/30/2023

注意

SDS (クラシック) TRANSITION CUSTOMERS: v1 形式に基づいて新しい SDS エクスペリエンスにデータを取り込むには、すべてのフィールドがサポートされていません。 SDS v1 CSV ファイル形式の [必須] 列には、データがサポートされていないため、これらのファイル形式が示されています。

重要

また、 渡される成績 の値と コースの件名 の値は、対応する値のリスト (ENUM) コードに合わせる必要があります。必要に応じて、[ 値の一覧の管理] を使用して [成績値] と [ コースの件名] を展開し、既定ではサポートされていないコード値をサポートします。

Microsoft 365 Education テナントの SDS を設定する

テナントのMicrosoft 365 Education
グローバル管理者のアクセス許可が必要

警告

CSV (コンマ区切り値) ファイルを使用して、学校情報システム (SIS)/学生管理システム (SMS) を同期できます。 SDS では、UTF-8 形式と RFC 準拠の CSV ファイルのアップロードのみがサポートされています。各 CSV ファイルには、[必須] の [はい] と書き込まれたフィールドのデータが含まれている必要があります。"いいえ" と書き込まれたフィールドは "省略可能" のデータです。 "必須" としてマークされたフィールドヘッダーは、指定されたファイルに存在する必要があります。または、受け入れられない場合があります。 "省略可能" としてマークされたフィールドヘッダーは、対応する省略可能なデータを渡さない場合、ファイルに存在する必要はありません。詳細については、「 SDS v1 CSV ファイル形式」を参照してください。

重要

School Data Sync で教育機関のデータを接続して利用できるようにすることで、このデータを Microsoft と共有し、organizationのデータガバナンス標準に準拠することをコミットする権限があることを確認します。

SDS 管理ポータルにアクセスするには、Web ブラウザーを起動し、[sds.microsoft.com] に移動し、Microsoft 365 Global 管理アカウントを使用してサインインします。

[開始する] を選択します。
[続行] を選択します。

次の手順の前に、サービスがテナントにプロビジョニングされるまで少し待ちます。
[ 新しい受信フローの作成] と [次へ] を選択して続行します。
データソースを選択します。 CSV の場合は、[ データに接続する] オプションを選択します。
形式を選択します。 CSV の場合は、[CSV] オプションを選択 します。次に続行します。
SIS/SMS の名前を指定する必要があります。また、[ SDS v1 CSV] を選択します。 [次へ] を選んで続行します。
[ ファイルの参照] を 選択して、参照と選択ダイアログを表示します。

重要

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

SDS v1 CSV ファイル形式を参照してください。

必須: 次に示す 3 つのファイルは、続行する前に選択する必要があります。クラスではなくユーザーのみを管理している場合は、これらのファイルのみを指定する必要があります。
- school.csv
- student.csv
- teacher.csv
省略可能/必須: ユーザーのみを管理している場合は必須ではありません。クラスとクラスの登録も管理している場合は、次の 3 つのファイルと上記の 3 つのファイルを指定する必要があります。そうでない場合は、これらの名前を持つファイルを選択しないでください。 1 つが選択されていて、他のファイルが選択されていない場合は、[ 次へ] を選択すると、これらのファイルのいずれかが見つからないことを示すメッセージが表示されます。続行する前に修正する必要があります。
- section.csv
- studentenrollment.csv
- teacherroster.csv
省略可能: これらは続行する必要はありませんが、エクスペリエンスが向上する可能性があります。以下のいずれかのファイルが選択されている場合は、もう一方も選択して続行する必要があります。
- user.csv
- guardianrelationship.csv (連絡先の関連付けを構築するには、ユーザーと学生のレコードが必要です)。
ファイルの選択が完了したら、[ 次へ ] を選択して続行します。システムは、次の画面に進む前に、選択したファイルの名前を検証します。必要なファイルが見つからない場合は、メッセージが表示され、ファイルまたはファイルに対処して再選択する必要があります。
ファイル名が検証されると、選択したファイルの構造を検証するためにファイルがアップロードされ、SDS CSV v1 仕様に基づいてヘッダー名で正しく書式設定されます。
- メッセージが表示された場合: 次の 1 つ以上のファイルが想定される形式と一致しない場合は、画面を確認して、ファイルが正しく書式設定されていないかどうかを確認します。問題を修正した後でファイルを再選択するには、前の画面に戻る必要があります。
- メッセージが表示された場合: オプションのファイルが 1 つ以上見つからない場合は、画面を確認して、見つからないファイルまたはファイルを確認します。このメッセージが表示されない場合は、前の画面に戻ってファイルを再選択する必要があります。それ以外の場合は、[ 次へ ] を選択して続行します。
ファイルスキーマが検証されると、SDS はアップロードされたファイルから迅速なデータ検証を実行します。アップロードされたデータは、一部の SDS データマッチングおよび検証ルールを通過して、適切な必須データと提供された省略可能なデータを特定するのに役立ちます。すべての検証規則ではなく、最も発生した規則です。

ヒント

データ検証の結果は、オンボードまたは csv アップロードエクスペリエンス中にブロックされません。2 つのオプションがあります。データの修正後に終了して戻るか、次の手順に進んでデータ接続の設定を続行し、後で修正されたデータをその後のアップロードで提供します。
調査のフラグが設定されたデータの詳細については、一覧からファイル名の詳細の表示を選択して、特定の項目をドリルインします。

また、ファイル別にレポートをダウンロードして、ソースシステムの調査と修正に関するヘッドスタートを取得することもできます。

フラグが設定されたファイル列が表示され、フラグが設定されたルールまたはルールを展開して調査できます。

ルールをクリックすると、たとえば、上位 10 件のレコードの別の概要が表示されます。

調査が完了したら、ダイアログを閉じてから [ 次へ] を選択します。
現在の学年を選択し、2023 年や 2022 年から 2023 年などのフレンドリ名を指定します。 (文字は utf8 である必要があります。または自動的に削除されます)。

重要

年度は、年単位の履歴データを構築するのに役立つ受信データを関連付けるために使用されます。このアプローチは、学年と暦年に合わせて調整されます。たとえば、学年が 2022 年 8 月 15 日から 2023 年 6 月 15 日に終了する場合、選択する学年の値は 2023 年の終了年になります。詳細については、学年処理に関するページを参照してください。

学年の開始日と終了日を入力します。

定義された学年に基づいて SDS がデータの同期を停止する日付を入力します。入力した学期末日にデータの同期を停止するのが最も一般的です。

[次へ] を選んで続行します。
ユーザー ID ルールのオプションを選択します。スタッフロールと学生ロールの両方を選択します。

注:

ユーザーマッチングは受信フローで実行され、Microsoft Entra ID内のユーザーオブジェクトの書き込みまたは更新は行われません。照合が実行され、Education データレイクに格納されます。詳細については、「 Microsoft 365 Manage Users with the match link forward with the outbound flow」を参照してください。
- ソースからの属性: SIS/SMS から送信されるデータに基づくユーザー属性。
  - 使用可能なソースオプションは、Username、Email、ActiveDirectory MatchId です。
- 一致する属性: 一致するMicrosoft Entra IDのユーザープロパティ。
  - 一致オプションMicrosoft Entra ID使用できるのは、UserPrincipalName と Mail です。
- (省略可能)ユーザーデータに @domain 値が含まれていない場合は、一覧からドメインを選択します。
警告

ドメインの選択は省略可能であり、 ソースから 選択した属性に基づく受信データに @domain 値が含まれていない場合にのみ使用する必要があります。 SDS はチェックせず、レコードに値がない場合は追加されます。 SDS は、ドメインの選択をすべてのレコードに追加します。これにより、@domain@domainが発生する可能性があり、Microsoft Entra ID内のユーザーとの既存のユーザーマッピングに対する一致がそれらのインスタンスで見つからない可能性があります。

注意

SIS/SMS ユーザー (たとえば、スタッフロールグループ内のユーザー) を @domain1 または @domain2 または @domain3 に関連付けることができる場合は、ソースデータに含まれる @domain を、ソース の選択から 選択した属性 (例: prefix@domain) に基づいてソースデータに含める必要があります。これは、属性が一致するために必要です。 UserPrincipalName または Mail は、一致する正しいMicrosoft Entraユーザーを見つけます。

ユーザーが複数のロールを持つインスタンスでは、次のルールを使用して、ユーザーレコードとMicrosoft Entra ユーザーオブジェクトの間で使用するスタッフまたは学生の一致ルールを決定します。
- isPrimary がすべての学生ロールに設定されている場合、スタッフロールへの関連付けが存在する場合でも、一致は学生ロールに基づいて行われます。
- isPrimary が任意のスタッフロールに設定されている場合、学生ロールへの関連付けが存在する場合でも、スタッフロールに基づいて一致が行われます。
- isPrimary がスタッフロールと学生ロールの両方に設定されている場合、スタッフロールに基づいて一致が行われます。
- isPrimary がロールに設定されていない場合 (特にスタッフロールと学生ロールの両方が混在している場合)、一致はスタッフロールに基づいています。
重要

Microsoft 365 Manage Users フローを構成する場合、これらのルールは、オプションが [一致しないユーザーの作成] にアクティブ化されている場合に使用され、Microsoft Entra UserPrincipalName プロパティのコンストラクトを定義します。

選択内容に問題がなければ、[ 次へ ] を選択して続行します。
レビューと作成に関するページに記載されている情報 を確認します。すべてが正しければ、[作成] ボタンを選択します。そうでない場合は、正しい場所に戻ります。
受信データフローが作成され、最初の実行が保留中の場合は、[ 完了 ] ボタンを選択します。もう一度確認して、最初の実行の状態を確認します。

ヒント

Connect データ構成を定義した直後、アクティブな初回実行時、または最初の実行が完了した後で、データの管理構成を設定できます。
実行の状態をチェックするには、[ホーム] ダッシュボードページに戻ります。

データに問題がない場合は、[ホーム] ダッシュボードに "データエラーまたは警告が見つかりません" と表示され、"前回の実行時にデータエラーや警告が発生しませんでした。素晴らしい作業を続けてください。

データに問題が見つかった場合は、[ホーム] ダッシュボードに [データに問題がいくつか見つかりました] と表示され、同期の正常性を調査することをお勧めします。

注:

最初の実行後に変更を手動でアップロードしてソースデータからの変更を更新するには、「ソースデータを SDS CSV で更新する」を参照してください。

対応する実行を含む最大アップロード数は、1 暦日あたり 6 回です。アップロードした場合、1 日に 6 回実行された後は、12 時間ごとに SDS 自動実行回数に基づいて最大 2 回まで実行されます。