Exportar e importar configurações de busca personalizada

Como administrador global ou administrador do SharePoint no Microsoft 365, você pode exportar e importar configurações de configuração de pesquisa personalizadas entre locatários, coleções de sites e sites. As configurações que você exporta e importa incluem todas as regras de consulta personalizadas, fontes de resultado, tipos de resultado, modelos de classificação e configurações de pesquisa de site. Também é possível exportar configurações de configuração de pesquisa personalizadas de um aplicativo serviço Pesquisa e importar as configurações para locatários, coleções de sites ou sites. Você não pode exportar as configurações padrão.

Visão Geral

Ao exportar configurações de configuração de pesquisa personalizadas, o SharePoint cria um arquivo de configuração de pesquisa no formato XML. Este arquivo de configuração de pesquisa inclui todas as configurações de configuração de pesquisa personalizadas exportáveis no locatário, na coleção de sites ou no nível do site de onde você inicia a exportação. Um arquivo de configuração de pesquisa para uma coleção de sites não contém configurações de configuração de pesquisa dos sites individuais na coleção de sites.

Quando você importa um arquivo de configuração de pesquisa, o SharePoint cria e habilita cada configuração de pesquisa personalizada no locatário, coleção de sites ou site de onde você inicia a importação.

Esta tabela mostra as configurações que você pode exportar ou importar. Para cada configuração, você encontrará dependências em outras configurações de configuração de pesquisa personalizadas. Se as definições de configuração de pesquisa personalizadas dependerem de uma configuração existente em outro nível, por exemplo, se uma regra de consulta de site depender de uma fonte de resultados no nível do conjunto de sites, você deverá exportar e importar as configurações em todos os níveis relevantes.

Condições que podem fazer com que a importação falhe

Se o arquivo de configuração de pesquisa e o destino da importação tiverem configurações com o mesmo nome, a importação do arquivo falhará quando encontrar essa configuração. No entanto, há exceções:

• Se você reimportar um arquivo de configuração de pesquisa, as configurações que tiverem o mesmo nome nesse arquivo e no destino não farão com que a importação falhe.

• As propriedades gerenciadas com o mesmo nome não farão com que a importação falhe se as configurações individuais dessas propriedades forem iguais no arquivo de configuração de pesquisa e no destino.

• As propriedades gerenciadas com o mesmo nome não farão com que a importação falhe se os aliases e os mapeamentos para as propriedades rastreadas forem diferentes na propriedade gerenciada do arquivo de configuração de pesquisa e na propriedade gerenciada do destino. A importação adicionará os aliases e os mapeamentos da propriedade gerenciada do arquivo de configuração de pesquisa aos aliases e aos mapeamentos da propriedade gerenciada do destino.

Se o arquivo de configuração de pesquisa contiver nomes ou aliases de propriedades gerenciadas com caracteres inválidos, a importação falhará quando encontrar esse nome ou alias.

Os nomes ou os aliases de propriedades gerenciadas de um esquema de pesquisa devem ser exclusivos em um site ou no conjunto de sites pai. Isso significa que:

• Se o arquivo de configuração de pesquisa tiver uma propriedade gerenciada com o mesmo nome que o alias de uma propriedade gerenciada do site de destino ou do conjunto de sites pai desse site, a importação falhará.

• Se o arquivo de configuração de pesquisa tiver uma propriedade gerenciada com um alias que tenha o mesmo nome de uma propriedade gerenciada do site de destino ou do conjunto de sites pai desse site, a importação falhará.

Se a importação falhar, remova a condição que ocasionou a falha e reimporte o arquivo de configuração de pesquisa. Por exemplo, se a coluna Notas indicar que já existe uma regra de consulta com o mesmo nome que a regra de consulta que você está tentando importar, será necessário remover essa regra do destino ou do arquivo de importação e, em seguida, reimportar o arquivo. Confira Caracteres inválidos que fazem com que sua importação falhe mais tarde neste artigo.

Exportar configurações de configuração de pesquisa personalizadas de um locatário

1. Vá para Mais recursos no Centro de administração do SharePoint e entre com uma conta que tenha permissões de administrador para sua organização.

2. Em Pesquisar, selecione Abrir.

3. Selecione Exportar Configuração de Pesquisa.

4. Na caixa de diálogo, selecione Salvar.

Exportar definições de configuração de pesquisa personalizada de um site

1. No site, selecione Configurações Configurações selecione Configurações do site. Se você não vir as configurações do site, selecione Informações do site e selecione Exibir todas as configurações do site.

2. Na página Configurações do Site , na seção Pesquisa , selecione Exportação de Configuração.

3. Na caixa de diálogo, selecione Salvar.

Exportar definições de configuração de pesquisa personalizada de um conjunto de sites

1. No site, selecione Configurações Configurações selecione Configurações do site. Se você não vir as configurações do site, selecione Informações do site e selecione Exibir todas as configurações do site.

2. Na página Configurações do Site , na seção Administração de Coleção de Sites , selecione Exportação de Configuração de Pesquisa.

3. Na caixa de diálogo, selecione Salvar.

Importar configurações de configuração de pesquisa personalizadas para um locatário

1. Vá para Mais recursos no Centro de administração do SharePoint e entre com uma conta que tenha permissões de administrador para sua organização.

2. Em Pesquisar, selecione Abrir.

3. Na página Importar Configuração de Pesquisa , navegue até o arquivo que você deseja importar.

4. Selecione Importar.

5. Na página Lista de Configuração de Pesquisa, verifique o seguinte:

6. Se o arquivo de configuração de pesquisa importado aparece na lista e se o seu status é Importado com Êxito.

   Se o arquivo não tiver sido importado com êxito, a coluna Notas fornecerá mais detalhes sobre o que aconteceu.

7. A coluna Escopo mostra que as configurações importadas estão no nível certo, ou seja, no nível para o qual você pretendia importar o arquivo. Por exemplo, se você importasse suas configurações no nível da coleção do site em vez de no nível do site, veria essas informações na coluna Escopo . A coluna Escopo mostra em que nível as configurações de configuração de pesquisa foram habilitadas. Os níveis são: locatário (locatário), conjunto de sites (SPSite) ou nível do site (SPWeb).

Importar definições de configuração de pesquisa personalizada para um site

1. No site, selecione Configurações Configurações selecione Configurações do site. Se você não vir as configurações do site, selecione Informações do site e selecione Exibir todas as configurações do site.

2. Na página Configurações do Site , na seção Pesquisa , selecione Importação de Configuração.

3. Na página Importar Configuração de Pesquisa , navegue até o arquivo que você deseja importar.

4. Selecione Importar.

5. Na página Lista de Configuração de Pesquisa, verifique o seguinte:

6. Se o arquivo de configuração de pesquisa importado aparece na lista e se o seu status é Importado com Êxito.

   Se o arquivo não tiver sido importado com êxito, a coluna Notas fornecerá mais detalhes sobre o que aconteceu.

7. A coluna Escopo mostra que as configurações importadas estão no nível certo, ou seja, no nível para o qual você pretendia importar o arquivo. Por exemplo, se você importasse suas configurações no nível da coleção do site em vez de no nível do site, veria essas informações na coluna Escopo . A coluna Escopo mostra em que nível as configurações de configuração de pesquisa foram habilitadas. Os níveis são: locatário (locatário), conjunto de sites (SPSite) ou nível do site (SPWeb).

Importar definições de configuração de pesquisa personalizada de um conjunto de sites

1. No site, selecione Configurações Configurações selecione Configurações do site. Se você não vir as configurações do site, selecione Informações do site e selecione Exibir todas as configurações do site.

2. Na página Configurações do Site , na seção Administração de Coleção de Sites , selecione Importar Configuração de Pesquisa.

3. Na página Importar Configuração de Pesquisa , navegue até o arquivo que você deseja importar.

4. Selecione Importar.

5. Na página Lista de Configuração de Pesquisa, verifique o seguinte:

6. O arquivo de configuração de pesquisa importado está na lista e seu status é importado com êxito.

   Se o arquivo não tiver sido importado com êxito, a coluna Notas fornecerá mais detalhes sobre o que aconteceu.

7. A coluna Escopo mostra que as configurações importadas estão no nível certo, ou seja, no nível para o qual você pretendia importar o arquivo. Por exemplo, se você importasse suas configurações no nível da coleção do site em vez de no nível do site, veria essas informações na coluna Escopo . A coluna Escopo mostra em que nível as configurações de configuração de pesquisa foram habilitadas. Os níveis são: locatário (locatário), conjunto de sites (SPSite) ou nível do site (SPWeb).

Caracteres inválidos que causam falha na importação

Se as propriedades gerenciadas ou os aliases contiverem quaisquer dos caracteres listados, a importação do esquema de pesquisa personalizado que contém essas propriedades falhará.

Problema conhecido

Não é possível carregar a Lista de Configuração de Pesquisa

Ao importar arquivos de configuração de pesquisa para a página de configurações de pesquisa de administrador de locatário, você pode encontrar um problema que a Lista de Configuração de Pesquisa não pôde exibir corretamente e você pode receber um erro "Arquivo não encontrado".

Esse problema só impede que a interface do usuário exiba a lista de arquivos de configuração de pesquisa importados e não quebre a funcionalidade Importar . Sua configuração de pesquisa será importada corretamente.

Como não é possível marcar o status do arquivo de configuração de pesquisa importado da interface do usuário, você pode escolher uma maneira alternativa de acessar a lista, como a API do CSOM do SharePoint ou a API REST do SharePoint Online.

Não é possível importar o arquivo XML da configuração de pesquisa obsoleta

Se o arquivo de configuração de pesquisa tiver sido exportado há muito tempo, a importação poderá falhar.

Se o arquivo de configuração de pesquisa exportado estiver obsoleto, você deverá exportar uma nova configuração de pesquisa primeiro e usá-la para importar a lista de arquivos de configuração de pesquisa.