定義 SharePoint 伺服器架構整合的自訂宣告對應

 

發行︰ 2016年11月

適用於： Dynamics CRM 2015

針對與 SharePoint 的伺服器架構整合，Microsoft Dynamics CRM Online 會使用宣告來驗證並授權 Dynamics 365 使用者存取儲存在 SharePoint 中的文件。 如需宣告型驗證的詳細資訊，請參閱 SharePoint 2013 中的宣告型身分識別。

根據預設，CRM Online 使用下列宣告對應與 SharePoint 整合：

• SharePoint Online：NameId (PUID)

• SharePoint 內部部署：SMTP (電子郵件)

您可以使用 UserMapping 實體指定 Dynamics 365 中的自訂宣告對應使用另一個值，而不要使用 CRM Online 用來在 SharePoint 中驗證和授權 Dynamics 365 使用者的預設值。 例如，您可以選擇使用使用者的「姓氏」和「名字」，而不使用「電子郵件」來驗證 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 或電子郵件)。
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 (電子郵件) 和 UPN (使用者主體名稱)。 如果您傳遞 SharePoint 預設支援的宣告以外的任何其他類型的宣告，則必須在 SharePoint 中建立對應的宣告類型對應。其他資訊：New-SPClaimTypeMapping

另請參閱

UserMapping 實體訊息和方法
整合 Microsoft Dynamics CRM 2015 與 SharePoint

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權