Manipulação de perfis de usuário no modelo de Suplemento do SharePoint
A abordagem que você adota para executar operações DE CRUD (Criar, Ler, Atualizar e Excluir) no serviço de perfil de usuário é diferente no novo modelo de Suplemento do SharePoint do que era com Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total) /Farm Solution, as operações DO CRUD do UPS foram executadas com o código do modelo de objeto do lado do servidor do SharePoint ou o serviço Web perfil de usuário e implantadas via Farm Solutions.
Em um cenário de modelo de suplemento do SharePoint, as operações DO CRUD do UPS são executadas com o CSOM (modelo de objeto do lado do cliente) ou o serviço Web perfil de usuário.
Diretrizes de alto nível
Como regra geral, recomendamos as diretrizes de alto nível a seguir para executar operações de CRUD do UPS.
- A tabela a seguir descreve quais tipos de operações têm suporte em ambientes Office 365 e locais do SharePoint para as APIs do CSOM e do Serviço Web de Perfil de Usuário.
Operação | API | Local | Office 365 |
---|---|---|---|
LER | CSOM | Com suporte | Com suporte |
CREATE | CSOM | Não suportado | Com suporte |
UPDATE | CSOM | Não suportado | Com suporte |
DELETE | CSOM | Não suportado | Com suporte |
LER | Serviço Web de Perfil de Usuário | Com suporte | Não suportado |
CREATE | Serviço Web de Perfil de Usuário | Com suporte | Não suportado |
UPDATE | Serviço Web de Perfil de Usuário | Com suporte | Não Suportado |
DELETE | Serviço Web de Perfil de Usuário | Com suporte | Não Suportado |
- Normalmente, você não implantará um Suplemento em um locatário do SharePoint para lidar com a cópia ou sincronização de dados UPS. Normalmente, o Suplemento assume a forma de um aplicativo de console em execução como uma tarefa agendada ou um serviço de nuvem de longa execução, como um Trabalho Web do Azure.
- Consulte os trabalhos de temporizador remoto (Receita de Modelo de Suplemento do SharePoint) para obter mais informações sobre essas tecnologias e como usá-las no modelo de suplemento do SharePoint.
- Não há suporte para o uso da autenticação AppOnly para operações de serviço do Perfil de Usuário.
- Execute o código CSOM com uma conta que tenha as permissões apropriadas para executar operações DO CRUD do UPS.
- Ao sincronizar o Active Directory com o serviço de perfil de usuário, alguns atributos são sincronizados por padrão.
- Os mapeamentos de propriedade de perfil de usuário padrão no SharePoint Server 2013 (artigo do TechNet) contém uma lista dos atributos sincronizados por padrão.
- Se você precisar sincronizar atributos adicionais, precisará criar uma ferramenta personalizada usando uma das abordagens descritas neste artigo.
Opções para copiar e sincronizar dados UPS
Você tem algumas opções para copiar e sincronizar dados UPS.
- No local
- Copiar banco de dados
- Usar o Serviço Web de Perfil de Usuário para copiar dados
- Usar o Serviço Web de Perfil de Usuário para sincronizar dados
- Office 365
- Usar o CSOM para copiar dados
- Usar o CSOM para sincronizar dados
Local – copiar banco de dados
Se você tiver um ambiente local do SharePoint, poderá copiar o banco de dados UPS de um farm para outro para replicar rapidamente atributos.
Quando isso é apropriado?
Quando você tem um ambiente local do SharePoint e está executando uma cópia unidirecional de atributos de perfil, essa é uma boa opção porque pode ser implementada de forma rápida e fácil sem escrever nenhum código.
Local – Usar o Serviço Web de Perfil de Usuário para copiar dados
Se você tiver um ambiente local do SharePoint, poderá usar o Serviço Web de Perfil de Usuário para copiar dados UPS de um farm para outro.
Quando isso é apropriado?
Quando você tem um ambiente local do SharePoint e está copiando dados UPS entre duas ou mais fazendas do SharePoint, essa é uma boa opção porque oferece a flexibilidade de copiar os dados UPS de um farm para outro.
Introdução
O exemplo a seguir demonstra como executar operações DO CRUD do UPS com o Serviço Web de Perfil de Usuário.
Local – Usar o Serviço Web de Perfil de Usuário para sincronizar dados
Se você tiver um ambiente local do SharePoint, poderá usar o Serviço Web de Perfil de Usuário para sincronizar dados UPS entre fazendas.
Quando isso é apropriado?
Quando você tem um ambiente local do SharePoint e está sincronizando dados UPS entre duas ou mais fazendas do SharePoint, essa é uma boa opção porque oferece a flexibilidade para executar a sincronização verdadeira e incluir quantas fontes quiser.
Introdução
O Core.UserProfilePropertyUpdater (Exemplo O365 PnP) demonstra como executar operações DO CRUD do UPS com o Serviço Web de Perfil de Usuário.
O Core.MMSSync (Exemplo de PnP O365) demonstra como criar uma ferramenta de sincronização para dados de MMS (Serviço de Metadados Gerenciados). Embora esse exemplo se concentre nas APIs do MMS, o padrão geral usado para sincronização também pode ser aplicado aos dados UPS.
Office 365 - Usar o CSOM para copiar dados
Se você tiver um ambiente Office 365 SharePoint, poderá usar o CSOM para copiar dados UPS de um locatário para outro.
Quando isso é apropriado?
Quando você tem um ambiente Office 365 e está copiando dados UPS entre dois ou mais locatários do SharePoint, essa é uma boa opção porque oferece a flexibilidade de copiar os dados UPS de um locatário para outro.
Introdução
O UserProfile.Manipulation.CSOM (Exemplo O365 PnP) demonstra como executar operações DO CRUD do UPS com o CSOM.
O CSOM do perfil de usuário para leitura e atualizações (O365 PnP Video) orienta você pelo UserProfile.Manipulation.CSOM (Exemplo de PnP O365).
Office 365 - Usar o CSOM para sincronizar dados
Quando você tem uma Office 365 ambiente do SharePoint e está sincronizando dados UPS entre dois ou mais locatários, essa é uma boa opção porque oferece a flexibilidade para executar a sincronização verdadeira e incluir quantas fontes quiser.
Quando isso é apropriado?
Quando você tem um ambiente Office 365 e está sincronizando dados UPS entre dois ou mais locatários do SharePoint, essa é uma boa opção porque oferece a flexibilidade para executar a sincronização verdadeira e incluir quantas fontes quiser.
Introdução
O Core.UserProfiles.Sync (Exemplo O365 PnP) demonstra como criar uma ferramenta de sincronização para dados do serviço de perfil de usuário.
Ambientes híbridos
Em um cenário em que você tem ambientes locais e Office 365 o SharePoint e as Informações de Perfil de Usuário precisam ser mantidos em ambos os ambientes, você pode usar uma combinação do Serviço Web de Perfil de Usuário e do CSOM para fornecer a capacidade de executar operações cud em dados UPS.
Links relacionados
- CSOM do perfil de usuário para leitura e atualizações (Vídeo PnP do O365)
- Trabalhos de temporizador remoto (Receita de modelo de suplemento do SharePoint)
- Mapeamentos de propriedades de perfil de usuário padrão no SharePoint Server 2013 (artigo do TechNet)
- Artigos de diretrizes em https://aka.ms/OfficeDevPnPGuidance
- Referências no MSDN em https://aka.ms/OfficeDevPnPMSDN
- Vídeos em https://aka.ms/OfficeDevPnPVideos
Exemplos de PnP
- Core.UserProfilePropertyUpdater (Amostra O365 PnP)
- Core.MMSSync (Exemplo de PnP O365)
- UserProfile.Manipulation.CSOM (exemplo O365 PnP)
- Core.UserProfiles.Sync (exemplo O365 PnP)
- Exemplos e conteúdo no Microsoft 365 Patterns and Practices (PnP)
Aplicável a
- Office 365 Multilocatário (MT)
- Office 365 dedicado (D)
- SharePoint 2013 local