Compartilhar via

Mapeamento de termos durante a transformação de página

  • Artigo

O mapeamento de termos é o mecanismo que converte os termos de metadados gerenciados no ambiente de origem para um termo aplicável no ambiente de destino. Os casos em que o mapeamento de termos se aplica são:

  • Você está fazendo transformações do SharePoint local para o SharePoint Online
  • Você está fazendo uma transformação entre sites (por exemplo, do portal clássico de publicação para uma intranet moderna) no SharePoint Online

O mapeamento de termos não será usado quando:

  • A origem e o destino estiverem apontando para a mesma ID de conjunto de termos
  • Quando você estiver fazendo uma transformação in-loco (a página de origem e de destino estão no mesmo site)

Como funciona o mapeamento de termos

O mapeamento de termos tentará encontrar automaticamente o termo equivalente no SharePoint Online para o termo usado na página de origem, e isso poderá ser feito de duas maneiras:

  • Mapeamento automático: o mapeamento de termos tentará localizar um termo equivalente, verificando se o mesmo grupo de termos, conjunto de termos e caminho de termo pode ser encontrado no repositório de termos de destino
  • Mapeamento personalizado com base em um arquivo: ao usar um arquivo de mapeamento, você pode especificar um termo de destino para determinado termo de origem

Desativar o mapeamento automático

Se você não quiser que o mapeamento de termos aconteça, poderá desabilitá-lo por meio do sinalizador -SkipTermStoreMapping no PnP PowerShell ou por meio do atributo SkipTermStoreMapping dos objetos de configuração de transformação de página .Net (PageTransformationInformation e PublishingPageTransformationInformation).

Mapeamento de termos personalizado

Se você não gostar ou não conseguir usar o mapeamento automático de termos, existe a opção de especificar um arquivo de mapeamento de termos. Um arquivo de mapeamento de termos é um arquivo CSV simples que mostra um termo de origem e um termo de destino, como mostrado no trecho de código abaixo

SourceTermGroup|SourceTermSet|SourceTerm,TargetTermGroup|TargetTermSet|TargetTerm
SourceTermGroup|SourceTermSet|SourceTerm|SourceChildTerm1|SourceChildTerm2,TargetTermGroup|TargetTermSet|TargetTerm|TargetChildTerm1|TargetChildTerm2
f0b1b6aa-b00b-4198-b8dd-ef4393e3ad05,fec05391-6a39-4ad5-a2a1-a01020d94efd

Observação:

  • você pode escolher um mapeamento baseado em um caminho (uma cadeia de caracteres delimitada por| de rótulos de termo) ou definir o mapeamento com base nas IDs dos termos de origem e de destino
  • Se você estiver fazendo transformações a partir do SharePoint 2010, será preciso especificar PADRÃO como o nome do grupo de termos de origem

Criar o arquivo de mapeamento é a primeira etapa. Para usá-lo, você precisa especificar o arquivo por meio do parâmetro TermMappingFile no cmdlet ConvertTo-PnPPage se estiver usando o PnP PowerShell. Se você estiver usando o .Net, poderá especificar o arquivo por meio do TermMappingFile atributo dos objetos de configuração de transformação de página do .Net (PageTransformationInformation e PublishingPageTransformationInformation).