Condividi tramite

Definire il mapping attestazioni personalizzato per l'integrazione di SharePoint basata su server

  • Articolo

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Per l'integrazione basata su server di SharePoint, Microsoft Dynamics CRM Online utilizza le attestazioni per autenticare e autorizzare gli utenti di Dynamics 365 per l'accesso ai documenti archiviati in SharePoint. Per ulteriori informazioni sull'autenticazione basata sulle attestazioni, vedi Identità basata sulle attestazioni in SharePoint 2013.

Per impostazione predefinita, CRM Online utilizza i seguenti mapping di attestazioni per l'integrazione con SharePoint:

  • SharePoint Online: NameId (PUID)

  • SharePoint locale: SMTP (e-mail)

Puoi utilizzare l'entità UserMapping per specificare i mapping di attestazione personalizzati in Dynamics 365 per utilizzare un valore diverso da quello predefinito utilizzato da CRM Online per autenticare e autorizzare gli utenti di Dynamics 365 in SharePoint. Ad esempio, puoi scegliere di utilizzare il cognome e il nome dell'utente anziché l'indirizzo e-mail per autenticare gli utenti di Dynamics 365 in SharePoint. I mapping di attestazione personalizzati sono utilizzati in genere per l'integrazione con SharePoint locale. I mapping di attestazioni personalizzati sovrascrivono i mapping di attestazione predefiniti utilizzati da Dynamics 365. Puoi definire più mapping di attestazione personalizzati in Dynamics 365. Per impostazione predefinita, solo gli utenti con il ruolo di amministratore di sistema dispongono dell'accesso all'entità UserMapping.

Nota

Per le organizzazioni di Microsoft Dynamics CRM Online, questa funzionalità è disponibile solo se nell'organizzazione è stato eseguito l'Aggiornamento 1 di Dynamics CRM Online 2015. Questa funzionalità non è disponibile per Dynamics CRM (locale).

Per definire un mapping di attestazione personalizzato in Dynamics 365, crea un record di entità UserMapping e specifica i valori degli attributi elencati nella tabella seguente.

Attributo

Valore

Descrizione

UserMapping.PartnerApplicationType

  • 0: SharePoint

  • 1: Solo per uso interno.

Tipo di applicazione partner per cui il mapping di attestazione deve essere usato. Nella versione corrente, solo 0 (SharePoint) è supportato.

UserMapping.SystemUserAttributeName

Valore Stringa

Nome logico dell'attributo dell'entità SystemUser (utente) da cui verrà utilizzato il valore per le attestazioni.

Nota

Se l'attributo utilizzato per il mapping di attestazione personalizzato non contiene alcun valore, il mapping di attestazione predefinito viene utilizzato da Dynamics 365. Ad esempio, se si sceglie di utilizzare il nome dell'utente come attributo per il mapping di attestazione personalizzato e il nome dell'utente non è presente, Dynamics 365 utilizzerà il mapping di attestazione predefinito (PUID o indirizzo e-mail).

UserMapping.ClaimType

Valore Stringa

Specificare il tipo di attestazione da inviare a SharePoint. Per un elenco dei tipi di attestazione, vedi Membri ClaimTypes.

Nota

L'elenco di tipi di attestazioni a cui si fa riferimento è solo per riferimento. Tutti i tipi di attestazione elencati potrebbero non essere supportati da SharePoint oppure potrebbero non contenere tutti i tipi di attestazione supportati da SharePoint.

Il seguente codice di esempio illustra come definire un mapping di attestazione personalizzato utilizzando l'entità UserMapping.

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

Nota

Ogni istanza dell'entità UserMapping con valori validi sostituirà i mapping di attestazione predefiniti utilizzato da CRM Online.

Per impostazione predefinita, SharePoint supporta i seguenti tipi di attestazione: NameId (PUID), SMTP (indirizzo e-mail) e UPN (nome dell'entità utente). Se utilizzi una richiesta diversa da quelle supportate per impostazione predefinita da SharePoint, devi anche creare i corrispondenti mapping del tipo di attestazione in SharePoint.Ulteriori informazioni:New-SPClaimTypeMapping

Vedere anche

Metodi e messaggi dell'entità UserMapping
Integrare Microsoft Dynamics CRM 2015 con SharePoint

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright