次の方法で共有


ユーザー ID ルール

School Data Sync (SDS) を構成する場合は、ソース データ (API または CSV ファイル) からターゲット ディレクトリ内のユーザー オブジェクト (Microsoft Entra ID または Microsoft Entra ID) に学生とスタッフの ID を定義する必要があります。

スタッフロールと学生ロールの両方を選択して、ユーザー ID ルールオプションを選択します。

これらのルールは、SIS/SMS から MICROSOFT ENTRA ID への既存のユーザーの照合に使用されます。

重要

Microsoft 365 の [ユーザーの管理] フローを構成するときに、オプションが [ 一致しないユーザーの作成] にアクティブ化されている場合、これらのルールが使用されます。 ルール構成は、Microsoft Entra UserPrincipalName プロパティのコンストラクトを定義し、今後の実行が同じユーザーと一致するようにするために使用されます。

注:

ユーザー マッチングは受信フローで実行され、Microsoft Entra ID でユーザー オブジェクトを書き込んだり更新したりしません。 照合が実行され、Education データ レイクに格納されます。 詳細については、「 Microsoft 365 Manage Users with the match link forward with the outbound flow」を参照してください。

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

重要

ユーザーが複数の組織にも関連付けられている場合は、テナントで "Microsoft 365 ユーザーの管理" 送信フローが設定されている場合、Microsoft Entra ユーザー オブジェクトにロールを書き込む際の値を決定するためにも、次の値が使用されます。

ソースからの値: SIS/SMS からのデータに基づくユーザー値。 ルール構成では、選択した値を単純な文字列値として使用するか、空白を含まない英数字を使用します。 文字列値は、対応するユーザーを検索するために、選択したターゲットに含まれる正確な値と一致する必要があります。

  • 使用可能なソース オプションは次のとおりです

    • ユーザー名 (v1/v2.1 CSV および OneRoster API)
    • Email (v1/v2.1 CSV および OneRoster API)
    • ActiveDirectoryMatchId (v2.1 CSV)
  • 選択したソース オプションに @___domain 値を追加するドメイン (省略可能) の選択。

    警告

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

    注意

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

一致する属性: 一致Microsoft Entra ID の User プロパティ。

  • 使用可能なMicrosoft Entra ID の一致オプションは次のとおりです
    • UserPrincipalName
    • メール

ヒント

属性を一致させるにはUserPrincipalName または Mail (例: prefix@___domain) に、ソース データに含まれる@___domain値またはソース データに追加する必要があります。