Manipulação de MMS no modelo de suplemento do SharePoint

Importante

Os suplementos do SharePoint atingiram o fim da vida útil no SharePoint Online em 2 de abril de 2026. Os suplementos hospedados no SharePoint e hospedados pelo provedor foram desativados e não funcionam mais no SharePoint Online, incluindo nuvens governamentais. As diretrizes de desenvolvimento, implantação e uso de suplementos são mantidas para referência histórica e para cenários aplicáveis do Servidor do SharePoint, não para novas soluções do SharePoint Online.

Os suplementos do Servidor do SharePoint implantados por meio de um catálogo de aplicativos local não são desativados por essa alteração. A aquisição de Suplementos do SharePoint do marketplace público terminou em 2 de abril de 2026 para o Servidor do SharePoint.

Essa desativação não desativa APIs REST do SharePoint, CSOM, JSOM ou SPFx (Estrutura do SharePoint). Para o SharePoint Online, use SPFx para extensões de interface do usuário e o Microsoft Entra ID para autenticação para aplicativos externos. Consulte o anúncio de desativação e as diretrizes de migração de suplemento.

A abordagem adotada para executar operações CRUD (Criar, Ler, Atualizar e Excluir) no MMS (Serviço de Metadados Gerenciados) é diferente no novo modelo de Suplemento do SharePoint do que era com o Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total)/Solução de Farm, as operações MMS CRUD foram executadas com o código de modelo de objeto do lado do servidor do SharePoint e implantadas por meio de Soluções de Farm.

Em um cenário de modelo de suplemento do SharePoint, as operações MMS CRUD são executadas com o modelo de objeto do lado do cliente (CSOM).

O CSOM fornece todas as operações necessárias para replicar e sincronizar dados no MMS.

Diretrizes de alto nível

Como regra geral, recomendamos as seguintes diretrizes de alto nível para executar operações MMS CRUD.

  • As operações MMS CRUD devem ser implementadas com o modelo de objeto do lado do cliente.
  • Execute o código CSOM com uma conta que tenha as permissões apropriadas para executar operações MMS CRUD.
  • Ao sincronizar conjuntos de termos, use a classe ChangeInformation porque ela tem um desempenho melhor do que usar GetAllTerms e enumerar os termos sempre que você quiser sincronizar.

Opções para copiar e sincronizar dados MMS

Você tem algumas opções para copiar e sincronizar dados MMS.

  • No local
    • Copiar banco de dados
    • Usar o CSOM para copiar dados
    • Usar o CSOM 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 SharePoint local, poderá copiar o banco de dados MMS de um farm para outro para replicar os termos rapidamente.

Quando isso é apropriado?

Quando você tem um ambiente do SharePoint local e está executando uma cópia unidirecional dos termos, essa é uma boa opção, pois pode ser implementada de forma rápida e fácil sem escrever nenhum código.

Local & O365 – Usar o CSOM para copiar dados

Se você tiver um ambiente local ou do Office 365 SharePoint, poderá usar o CSOM para copiar dados MMS de um farm/locatário para outro. Você pode incluir farms locais e do Office 365 com essa abordagem.

Quando isso é apropriado?

Quando você tem um SharePoint ou Office 365 local ou um ambiente híbrido e está copiando dados MMS entre dois ou mais farms/locações do SharePoint, essa é uma boa opção porque oferece a flexibilidade de copiar os dados MMS de um farm para outro.

Introdução

O exemplo a seguir demonstra como executar operações CRUD do MMS.

Local & O365 – Usar o CSOM para sincronizar dados

Se você tiver um ambiente SharePoint local, poderá usar o CSOM para sincronizar dados MMS entre farms. Você pode incluir farms/locações locais e do Office 365 com essa abordagem.

Quando isso é apropriado?

Quando você tem um SharePoint ou Office 365 local ou um ambiente híbrido e está sincronizando dados MMS entre dois ou mais farms/locações do SharePoint, essa é uma boa opção porque oferece a flexibilidade de executar a sincronização verdadeira e incluir quantas fontes desejar.

Introdução

O exemplo a seguir demonstra como criar uma ferramenta de sincronização para dados MMS.

Exemplos de PnP

Aplicável a

  • Office 365 multilocatário (MT)
  • Office 365 dedicado (D) parcialmente
  • SharePoint 2013 local, parcialmente

Os padrões para dedicado e local são idênticos às técnicas de modelo de suplemento, mas há diferenças nas possíveis tecnologias que podem ser usadas.

  • Última atualização a