Exportar e importar configurações de busca personalizada
Como Administrador do SharePoint e superior no Microsoft 365, pode exportar e importar definições de configuração de pesquisa personalizadas entre inquilinos, coleções de sites e sites. As definições que exportar e importar incluem todas as regras de consulta personalizadas, origens de resultados, tipos de resultados, modelos de classificação e definições de pesquisa de sites. Também é possível exportar definições de configuração de pesquisa personalizadas a partir de uma aplicação de serviço de Pesquisa e importar as definições para inquilinos, coleções de sites ou sites. Não pode exportar as predefinições de configuração.
Visão Geral
Quando exporta definições de configuração de pesquisa personalizadas, o SharePoint cria um ficheiro de configuração de pesquisa no formato XML. Este ficheiro de configuração de pesquisa inclui todas as definições de configuração de pesquisa personalizada exportáveis ao nível do inquilino, da coleção de sites ou do site a partir do qual inicia a exportação. Um ficheiro de configuração de pesquisa para uma coleção de sites não contém definições de configuração de pesquisa dos sites individuais na coleção de sites.
Quando importa um ficheiro de configuração de pesquisa, o SharePoint cria e ativa cada definição de configuração de pesquisa personalizada no inquilino, coleção de sites ou site a partir do qual inicia a importação.
Esta tabela mostra as definições que pode exportar ou importar. Para cada definição, encontrará dependências noutras definiçõ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.
| Definição de configuração de pesquisa personalizada | Dependência de outras definições de configuração de pesquisa personalizadas |
|---|---|
| Regras da consulta. Incluem blocos de resultados, resultados promovidos e segmentos do usuário. | Origens de resultados, tipos de resultados, esquema de pesquisa, modelo de classificação. |
| Fontes de resultado | Esquema de pesquisa |
| Tipos de resultado | Esquema de pesquisa, fontes de resultado, modelos de exibição |
| Esquema de pesquisa | Nenhum |
| Modelo de classificação | Esquema de pesquisa |
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, existem 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á.
Observação
Quaisquer definições de pesquisa personalizadas que tenham sido criadas e ativadas pelo SharePoint antes da importação falhar, permanecem ativadas.
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. Veja Carateres inválidos que causam a falha da importação mais à frente neste artigo.
Exportar definições de configuração de pesquisa personalizadas de um inquilino
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.
Observação
Se você tiver o Office 365 operado pela 21Vianet (China), entre no centro de administração do Microsoft 365, navegue até o centro de administração do SharePoint e abra a página Mais recursos.
Em Procurar, selecione Abrir.
Selecione Exportar Configuração de Pesquisa.
Na caixa de diálogo, selecione Guardar.
Exportar definições de configuração de pesquisa personalizada de um site
No site, selecione Definições
, em seguida, selecione Definições do site. Se não vir Definições do site, selecione Informações do site e, em seguida, selecione Ver todas as definições do site.Na página Definições do Site , na secção Pesquisa , selecione Exportação de Configuração.
Na caixa de diálogo, selecione Guardar.
Exportar definições de configuração de pesquisa personalizada de um conjunto de sites
No site, selecione Definições
, em seguida, selecione Definições do site. Se não vir Definições do site, selecione Informações do site e, em seguida, selecione Ver todas as definições do site.Na página Definições do Site , na secção Administração de Coleções de Sites , selecione Exportar Configuração de Pesquisa.
Na caixa de diálogo, selecione Guardar.
Importar definições de configuração de pesquisa personalizadas para um inquilino
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.
Observação
Se você tiver o Office 365 operado pela 21Vianet (China), entre no centro de administração do Microsoft 365, navegue até o centro de administração do SharePoint e abra a página Mais recursos.
Em Procurar, selecione Abrir.
Na página Configuração da Pesquisa de Importação , navegue para o ficheiro que pretende importar.
Selecione Importar.
Na página Lista de Configuração de Pesquisa, verifique o seguinte:
Se o arquivo de configuração de pesquisa importado aparece na lista e se o seu status é Importado com Êxito.
Se o ficheiro não tiver sido importado com êxito, a coluna Notas fornece mais detalhes sobre o que aconteceu.
A coluna Âmbito mostra que as definições que importou estão no nível certo, ou seja, no nível para o qual pretendia importar o ficheiro. Por exemplo, se importasse as definições ao nível da coleção de sites em vez de ao nível do site, veria estas informações na coluna Âmbito . A coluna Âmbito mostra em que nível as definições de configuração de pesquisa foram ativadas. Os níveis são: inquilino (Inquilino), coleção de sites (SPSite) ou nível do site (SPWeb).
Importar definições de configuração de pesquisa personalizada para um site
No site, selecione Definições
, em seguida, selecione Definições do site. Se não vir Definições do site, selecione Informações do site e, em seguida, selecione Ver todas as definições do site.Na página Definições do Site , na secção Pesquisa , selecione Importação de Configuração.
Na página Configuração da Pesquisa de Importação , navegue para o ficheiro que pretende importar.
Selecione Importar.
Na página Lista de Configuração de Pesquisa, verifique o seguinte:
Se o arquivo de configuração de pesquisa importado aparece na lista e se o seu status é Importado com Êxito.
Se o ficheiro não tiver sido importado com êxito, a coluna Notas fornece mais detalhes sobre o que aconteceu.
A coluna Âmbito mostra que as definições que importou estão no nível certo, ou seja, no nível para o qual pretendia importar o ficheiro. Por exemplo, se importasse as definições ao nível da coleção de sites em vez de ao nível do site, veria estas informações na coluna Âmbito . A coluna Âmbito mostra em que nível as definições de configuração de pesquisa foram ativadas. Os níveis são: inquilino (Inquilino), coleção de sites (SPSite) ou nível do site (SPWeb).
Importar definições de configuração de pesquisa personalizada de um conjunto de sites
No site, selecione Definições
, em seguida, selecione Definições do site. Se não vir Definições do site, selecione Informações do site e, em seguida, selecione Ver todas as definições do site.Na página Definições do Site , na secção Administração de Coleções de Sites , selecione Importar Configuração de Pesquisa.
Na página Configuração da Pesquisa de Importação , navegue para o ficheiro que pretende importar.
Selecione Importar.
Na página Lista de Configuração de Pesquisa, verifique o seguinte:
O ficheiro de configuração de pesquisa que importou está na lista e o respetivo estado é Importado Com Êxito.
Se o ficheiro não tiver sido importado com êxito, a coluna Notas fornece mais detalhes sobre o que aconteceu.
A coluna Âmbito mostra que as definições que importou estão no nível certo, ou seja, no nível para o qual pretendia importar o ficheiro. Por exemplo, se importasse as definições ao nível da coleção de sites em vez de ao nível do site, veria estas informações na coluna Âmbito . A coluna Âmbito mostra em que nível as definições de configuração de pesquisa foram ativadas. Os níveis são: inquilino (Inquilino), coleção de sites (SPSite) ou nível do site (SPWeb).
Carateres inválidos que causam a falha da 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á.
| Caractere | Nome |
|---|---|
| espaço | |
| : | dois pontos |
| ; | ponto e vírgula |
| , | vírgula |
| ( | abre parênteses |
| ) | fecha parênteses |
| [ | abre colchetes |
| ] | fecha colchetes |
| { | abre chaves |
| } | fecha chaves |
| % | porcento |
| $ | sinal de dólar |
| _ | sublinhado |
| + | sinal de mais |
| ! | ponto de exclamação |
| * | asterisco |
| = | sinal de igual |
| & | E comercial |
| ? | sinal de interrogação |
| @ | arroba |
| # | jogo da velha |
| \ | barra invertida |
| ~ | til |
| < | colchetes de abertura |
| > | colchetes de fechamento |
| | | barra vertical |
| ` | acento crase |
| ^ | acento circunflexo |
| ' | sequência de saída |
| " | sequência de saída |
Problema conhecido
Não é possível carregar a Lista de Configuração de Pesquisa
Ao importar ficheiros de configuração de pesquisa para a página de definições de pesquisa de administrador inquilino, poderá deparar-se com um problema em que a Lista de Configuração de Pesquisa não foi apresentada corretamente e poderá receber um erro "Ficheiro não encontrado".
Este problema apenas impede a IU de apresentar a lista de ficheiros de configuração de pesquisa que importou e não interromperia a funcionalidade Importar . A configuração de pesquisa será importada corretamente.
Uma vez que não consegue verificar o estado do ficheiro de configuração de pesquisa que importou da IU, pode escolher uma forma alternativa de aceder à lista, como a API CSOM do SharePoint ou a API REST do SharePoint Online.
Não é possível importar o ficheiro XML de configuração de pesquisa obsoleta
Se o ficheiro de configuração de pesquisa tiver sido exportado há muito tempo, a importação poderá falhar.
Se o ficheiro de configuração de pesquisa exportada estiver obsoleto, primeiro deve exportar uma nova configuração de pesquisa e, em seguida, utilizá-la para importar a lista de ficheiros de configuração de pesquisa.