Partilhar via


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.
  • 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.

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.

Exemplos de PnP

Aplicável a

  • Office 365 Multilocatário (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local