Clever 形式の CSV ファイルを使用して School Data Sync をデプロイする方法

重要

School Data Sync (クラシック) エクスペリエンスは、2024 年末までに 新しい School Data Sync エクスペリエンス に置き換えられます。 次の年の新しいエクスペリエンスへの 移行の計画 を開始することをお勧めします学校に戻ります。

SDS を使用して Clever 形式のコンマ区切り値 (CSV) ファイルを使用して、学生情報システム (SIS) データをインポートしてOffice 365に同期できます。 SDS では、学生、教師、学校、セクション、名簿情報を SIS からMicrosoft Entra IDおよびOffice 365に同期できます。 この方法を使用して、SIS データを含む Clever 形式 の CSV ファイルをエクスポートまたは作成し、同期プロファイルを設定し、処理のために CSV ファイルを SDS にアップロードします。

使用を開始する前に

Clever メソッドを使用して SDS との同期を開始する前に、「 学校データ同期の概要」を確認してください。

次の前提条件を満たしていることを確認します。

  • Education テナントのOffice 365

  • グローバル管理者アカウント

  • School Data Sync (プラン 1) が有効

    注:

    SDS を介して提供するデータは、アプリを介してサード パーティのアプリケーション プロバイダーからアクセスできる可能性があるため、これらのサード パーティが利用できるようにするデータのみを同期する必要があります。

同期プロファイルを作成し、CSV ファイルをインポートする

Clever 形式の CSV ファイルをエクスポートまたは作成していることを確認します。 次に、次の手順に従ってファイルをインポートし、同期プロファイルを作成します。 同期プロファイルは、アップロードする予定の CSV データを同期するために SDS によって使用されるオプションと設定のグループにすぎません。 1 つのOffice 365 テナント内に複数の同期プロファイルを作成できます。

SDS アクセスと初回サインイン

SDS 管理 ポータルにアクセスするには、プライベート Web ブラウザーを起動し、sds.microsoft.com に移動し、Office 365 Education テナントのグローバル 管理資格情報を使用してサインインします。

同期プロファイルを作成し、Clever 形式の CSV ファイルを同期する

  1. サインイン後、[+ プロファイルの 追加] を選択して SDS 同期プロファイルを作成し、Clever からのデータの同期を開始します。

    プロファイルを追加します。

  2. [ 接続の種類の選択] ページで、必要に応じてフォームに入力します。 完了したら、[開始] を選択 します

    [接続の種類] を選択します。

  3. [ 同期オプション] ページで、適切なオプションを選択して新しいユーザーを作成するか、既存のユーザーを同期します。 次に、[ファイルのアップロード] を選択して、Clever 形式の CSV ファイルをアップロードします。 アップロードしたら、必要に応じてページで選択を完了し、[ 次へ] を選択します。

    同期オプション。

    注:

    新しいユーザーを作成するためのオプションを使用して実行し、V2.1 CSV を採用する場合は、学校への移行の一環として V2.1 CSV 形式をサポートする準備に役立つツールをリリースしました。 ユーザーを作成する前にアンカー ID の更新に関するページを参照してください

    • [既存のユーザー ] - CSV ファイルに含まれる各学生と教師に対して、Microsoft 365 テナント内に作成されたユーザー アカウントが既にある場合は、このオプションを選択します。

    • [新しいユーザー ] - CSV ファイルに含まれる各学生と教師のユーザー アカウントを SDS で作成する場合は、このオプションを選択します。

    • [ファイルのアップロード] ボタン - 6 つの CSV ファイルをアップロードする場合に選択します。 SDS のアップロード時に、いくつかの簡単な検証テストを実行して、ファイルが正しく書式設定されていることを確認します。 検証に合格すると、ファイルが同期プロファイルにアップロードされます。

    • 学校のプロパティ - CSV ファイルをアップロードすると、School.csv に含まれる属性が自動的に選択されます。 ここで選択した属性が、School.csv に含まれているのと同じ属性であることを検証する必要があります。

    • セクションのプロパティ - CSV ファイルをアップロードすると、Student.csv に含まれる属性が自動的に選択されます。 ここで選択した属性が、School.csv に含まれているのと同じ属性であることを検証する必要があります。

    • チーム作成オプション – このボックスをオンにすると、同期された各クラスの Microsoft 365 グループとクラス チームの両方が SDS によって作成されます。 このチェック ボックスをオフのままにすると、SDS はMicrosoft 365 グループのみを作成します。

    • サポートされていない特殊文字を置き換える - このボックスをオンにすると、同期の実行中に SDS がサポートされていない特殊文字を自動的に置き換えることができます。 特殊文字は "_" に置き換えられ、そのオブジェクトの同期プロセス中にエラーが発生しなくなります。

    • クラス グループの表示名の同期オプション - このボックスをオンにすると、教師は最初の同期後にセクション表示名を制御でき、教師によって行われた Section DisplayName の変更が SDS によって上書きされるのを防ぐことができます。

    • 学生のアクセスの遅延 - このオプションを有効にすると、SDS がメンバーシップを同期する日付を設定し、学生が自分のクラスを表示できるようになります。 学生をすぐに同期するには、このオプションを無効にします。

    • 同期を停止する必要があるのはいつですか? - 通常は、学年または学期の終わりにこれを行う必要があります。 SDS がプロファイルの同期を停止したら、必要に応じて、このプロファイルに関連付けられているクラスをクリーンできます。

  4. [ 教師オプション ] ページで、適切な ID 照合オプションを選択し、教師のプロパティが選択されていることを確認してから、[ 次へ] を選択します。

    SDS チェック、正しい形式で属性とオプションを選択していることを確認します。 たとえば、UserPrincipalName と一致する場合は、UserPrincipalName (prefix@domain.com) の形式のソース ディレクトリ属性を選択する必要があります。または、適切な書式を確保するために、ソース ディレクトリ属性にドメインを追加することを選択する必要があります。 選択内容が一致を完了するための適切な形式でない場合は、ページに赤いエラーが表示されます。

    教師のオプション。

    • 主キー (ソース ディレクトリ) - このオプションは、SDS ID の照合に使用される CSV ファイルの teacher 属性です。 適切なソース ディレクトリ属性を選択し、教師の ID 一致設定を適切に構成する方法の詳細については、ID 照合ビデオをご覧ください。

    • 主キー (ターゲット ディレクトリ) - このオプションは、SDS ID の照合に使用Microsoft Entra IDのユーザー属性です。 適切なターゲット ディレクトリ属性を選択し、教師の ID 一致設定を適切に構成する方法の詳細については、ID 照合ビデオをご覧ください。

    • ドメイン (省略可能) - これは、選択したソース ディレクトリ属性に追加して教師 ID の照合を完了できる省略可能なドメイン値です。 UserPrincipalName または Mail 属性と一致する必要がある場合は、文字列にドメインが含まれている必要があります。 ソース属性には、既にドメインが含まれている必要があります。または、このドロップダウン メニューを使用して、ソース属性に適切なドメインを追加できます。

  5. [ 学生のオプション ] ページで、適切な ID 照合オプションを選択し、学生のプロパティが選択されていることを確認し、[ 次へ] を選択します。 SDS チェック、正しい形式で属性とオプションを選択していることを確認します。 たとえば、UserPrincipalName と一致する場合は、UserPrincipalName (prefix@domain.com) の形式のソース ディレクトリ属性を選択する必要があります。または、適切な書式を確保するために、ソース ディレクトリ属性にドメインを追加することを選択する必要があります。 選択内容が一致を完了するための適切な形式でない場合は、ページに赤いエラーが表示されます。

    学生のオプション。

    • 主キー (ソース ディレクトリ) - これは、SDS ID の照合に使用される CSV ファイルの student 属性です。 適切なソース ディレクトリ属性を選択し、教師の ID 一致設定を適切に構成する方法の詳細については、ID 照合ビデオをご覧ください。

    • 主キー (ターゲット ディレクトリ) - これは、SDS ID の照合に使用されるMicrosoft Entra IDのユーザー属性です。 適切なターゲット ディレクトリ属性を選択し、学生の ID 照合設定を適切に構成する方法の詳細については、ID 照合ビデオをご覧ください。

    • ドメイン (省略可能) - これは、選択したソース ディレクトリ属性に追加して学生 ID の照合を完了できる省略可能なドメイン値です。 UserPrincipalName または Mail 属性と一致する必要がある場合は、文字列にドメインが含まれている必要があります。 ソース属性には、既にドメインが含まれている必要があります。または、このドロップダウン メニューを使用して、ソース属性に適切なドメインを追加できます。

  6. [ レビュー ] ページで、適切な選択を行っていることを確認します。 追加の変更が必要ない場合は、[ プロファイルの作成] を選択します。 同期プロファイルを作成すると、SDS によって同期前検証プロセスが開始されます。 このプロセス中にエラーが見つかった場合は、同期再開ボタンをクリックして実際の同期プロセスを開始する前に、エラーを修正してファイルを再アップロードすることができます。 エラーを受け取り、更新しないことを選択した場合でも、エラーに対処せずに同期を再開できます。

    [確認] ページ。

同期プロファイルを設定した後の同期プロセスを自動化するために、 Microsoft Flow を使用して CSV ファイルを SDS にアップロードできます。 このオプションを使用すると、クラウドの UI を使用してアップロード プロセス全体を管理できます。これは、PowerShell スクリプトよりもはるかに簡単に使用できます。

ビデオ: 同期のソース属性とターゲット属性を一致させる方法

同期に一致するロジックの成功と失敗のさまざまな例については、ID 一致ビデオをwatchします。


SDS の概要

CSV V1 形式の CSV ファイルを使用して SDS をデプロイする方法

CSV V2 形式の CSV ファイルを使用して SDS をデプロイする方法

OneRoster CSV ファイルを使用して SDS をデプロイする方法

SDS エラー