サーバー ベースの SharePoint 統合に対するユーザー定義要求のマッピングの定義

  • [アーティクル]

 

公開日: 2016年11月

対象: Dynamics CRM 2015

SharePoint とのサーバーベースの統合の場合、Microsoft Dynamics CRM Online は、SharePoint に格納されているドキュメントにアクセスする Dynamics 365 ユーザーを、クレームを使用して、認証して許可します。 クレームベース認証の詳細については、SharePoint 2013 でのクレームベースの ID を参照してください。

既定では、CRM Online は、SharePoint との統合に次のマッピングを使用します。

  • SharePoint Online: NameId (PUID)

  • SharePoint 設置型: SMTP (E-mail)

CRM Online で使用される規定値以外の値を使用して、SharePoint で Dynamics 365 ユーザーを認証および承認するために、Dynamics 365 でのユーザー定義の要求のマッピングの指定に UserMapping エンティティを使用できます。 たとえば、"E-mail" の代わりにユーザーの "名" と "姓" を使用することを選択して、SharePoint で Dynamics 365 のユーザーを認証できます。 ユーザー定義の要求のマッピングは、通常、SharePoint 設置型との統合に使用されます。 ユーザー定義の要求のマッピングは、Dynamics 365 によって使用される既定の要求のマッピングを上書きします。 複数のユーザー定義の要求のマッピングを Dynamics 365 で定義できます。 既定では、システム管理者ロールを持つユーザーのみが、UserMapping エンティティにアクセスできます。

注意

Microsoft Dynamics CRM Online 組織の場合、この機能は、組織が Dynamics CRM Online 2015 更新プログラム 1 に更新されている場合にのみ使用できます。 この機能は内部設置型の Dynamics CRM では使用できません。

ユーザー定義の要求のマッピングを Dynamics 365 で定義するには、UserMapping エンティティ レコードを作成し、次の表に示す属性値を指定します。

属性

値

説明

UserMapping.PartnerApplicationType

  • 0: SharePoint

  • 1: 内部のみで使用

この要求のマッピングが使用されるパートナー アプリケーションの種類です。 現在のリリースでは、0 (SharePoint) のみがサポートされます。

UserMapping.SystemUserAttributeName

文字列値

SystemUser (ユーザー) エンティティ内の属性の論理名。そのエンティティ内のクレームの値が使用されます。

注意

ユーザー定義の要求のマッピングに使用される属性に値が含まれていない場合、既定の要求のマッピングが Dynamics 365 によって使用されます。 たとえば、ユーザー定義の要求のマッピングに、属性としてユーザーの名の使用を選択した場合、ユーザーの名が見つからないときは、Dynamics 365 は既定の要求のマッピング (PUID または E-mail) を使用します。

UserMapping.ClaimType

文字列値

SharePoint に送信する要求の種類を指定します。 要求の種類の一覧については、「ClaimTypes のメンバー」を参照してください。

注意

参照されるクレームの種類の一覧は、参考のためです。 ここに記載した要求の種類のすべてが SharePoint によってサポートされているとは限らず、また SharePoint によってサポートされているすべての要求の種類を含んでるとは限りません。

次のサンプル コードは、UserMapping エンティティを使用して、ユーザー定義の要求のマッピングを定義する方法を示しています。

UserMapping customMapping = new UserMapping
{
   PartnerApplicationType = new OptionSetValue(0),
   SystemUserAttributeName = "personalemailaddress",
   ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);

注意

有効な値を持つ UserMapping エンティティのインスタンスは、CRM Online によって使用される既定のマッピングを上書きします。

既定では、SharePoint は、NameId (PUID)、SMTP (E-mail)、および UPN (ユーザー プリンシパル名) の要求の種類をサポートします。SharePoint で既定でサポートされている以外の種類の要求を渡す場合は、対応する要求の種類のマッピングを SharePoint で作成する必要もあります。詳細:New-SPClaimTypeMapping

関連項目

UserMapping エンティティのメッセージおよびメソッド
Microsoft Dynamics CRM 2015 を SharePoint と統合

© 2017 Microsoft. All rights reserved. 著作権