Creare una pagina dei risultati di ricerca personalizzata in SharePoint OnlineCreate a custom search results page in SharePoint Online

Uno dei modi per personalizzare l'esperienza di ricerca in SharePoint consiste nel creare una pagina dei risultati di ricerca personalizzata per un sito.One way to customize the search experience in SharePoint is to create a custom search results page for a site. In questo modo è possibile utilizzare una pagina creata, anziché quella predefinita nella pagina dei risultati di ricerca di Microsoft.This allows you to use a page that you created, rather than the default in Microsoft Search results page. In questo modo si ottiene una maggiore flessibilità per l'aspetto dei risultati di ricerca per gli utenti.This gives you more flexibility on how the search results experience looks for your users.

Nota

Per apportare modifiche alla pagina dei risultati di Microsoft Search predefinita disponibile per impostazione predefinita, vedere personalizzare la pagina dei risultati di ricerca.To make changes to the default Microsoft Search results page that is available by default, please see Customize the search results page.

Con una pagina dei risultati personalizzata è possibile creare una nuova pagina che può essere utilizzata per controllare il layout e la struttura dei risultati della ricerca per supportare le esigenze dell'organizzazione.With a custom results page you can create a new page that can be used to control the layout and design of search results to support your organization's needs. È possibile utilizzare tutte le web part predefinite, le web part di ricerca di origine aperta provenienti da modelli e procedure di SharePoint, nonché tutte le web part personalizzate che possono essere state sviluppate con SharePoint Framework.You can use any built-in web parts, open-source search web parts from SharePoint Patterns and Practices community, as well as any custom web parts that you may have developed using SharePoint Framework.

Configurare una pagina dei risultatiConfigure a results page

Per configurare una pagina dei risultati personalizzata in SharePoint Online, eseguire la procedura seguente:To configure a custom results page in SharePoint Online follow the steps below:

  1. Passare al sito in cui si desidera configurare una pagina dei risultati personalizzata e passare a impostazioni sito > impostazioni raccolta siti > impostazioni di ricerca.Browse to the site where you would like to configure a custom results page and go to Site Settings > Site Collection Settings > Search Settings.

  2. Nelle impostazioni di ricerca, cancellare la selezione dall' utilizzo delle stesse impostazioni della pagina dei risultati dell'elemento padre, scegliere Invia query a una pagina dei risultati personalizzatae specificare un valore per l' URL della pagina dei risultati:.In Search Settings, clear selection from Use the same results page settings as my parent, choose Send queries to a custom results page, and provide a value for Results page URL:.Quindi, salvare le modifiche. Then, save your changes. L'URL utilizzato in questo articolo dovrebbe essere relativo alla pagina che è stata creata per essere utilizzata come pagina dei risultati personalizzata.The URL you use here should be for the page that you created to use as your custom results page.

Nota

La pagina dei risultati personalizzata deve trovarsi nello stesso dominio del sito, ma non deve trovarsi nella stessa raccolta siti.The custom results page needs to be on the same domain as your site, but it does not have to be in the same site collection.  

In alternativa, è possibile utilizzare il comando set-PnPSearchSettings di PowerShell di SharePoint PNP per impostare il valore anziché utilizzare la pagina Impostazioni sito.Alternatively, you can use the Set-PnPSearchSettings SharePoint PnP PowerShell command to set the value instead of using the Site Settings page.

Una volta impostato, la pagina dei risultati di ricerca personalizzata viene visualizzata quando si esegue una ricerca utilizzando la casella di ricerca di Microsoft visualizzata nella barra di spostamento nella parte superiore della pagina e viene utilizzata quando si immette la ricerca dalle pagine del sito o dalla Home page del sito.Once set, the custom search results page is displayed when you search using the Microsoft Search box that appears in the navigation bar on top of the page and is used when you enter search from site pages or the home page of the site. Non viene utilizzato quando si esegue la ricerca all'interno di un elenco, una raccolta o la pagina contenuto del sito.It is not used when you are searching within a list, library, or the site contents page. È possibile utilizzare il collegamento per espandere la ricerca dai risultati della ricerca in elenchi e raccolte per accedere alla pagina dei risultati personalizzata.You may use the link to expand your search from search results in lists and libraries to get to the custom results page.

Modificare il layout della pagina dei risultati personalizzataChange the layout of your custom results page

È possibile utilizzare un layout di pagina denominato HeaderlessSearchResults per rendere la pagina dei risultati di ricerca più vicina alla nostra esperienza nei risultati della ricerca in box.A page layout named HeaderlessSearchResults can be used to make the search results page appear closer to our out of box search results experience.Questo nuovo layout può essere attivo solo per le pagine che sono impostate come pagina dei risultati di ricerca personalizzata. This new layout can only be active for the pages that are set to be the custom search results page.

Per impostare il layout di pagina, è possibile utilizzare il comando set-PnPClientSidePageSharePoint PNP PowerShell con-LayoutType HeaderlessSearchResults.To set the page layout, you can use the Set-PnPClientSidePageSharePoint PnP PowerShell command with -LayoutType HeaderlessSearchResults.

Utilizzare le estensioni di query di SharePoint FrameworkUse SharePoint Framework Query extensions

Le pagine dei risultati di ricerca personalizzati possono anche avvalersi dell' estensione di query di SharePoint Framework per modificare la query prima che venga inviata al motore di ricerca.Custom search results pages can also make use of the SharePoint Framework Query Extension to modify the query before it gets sent to the search engine.

Risorse aggiuntiveAdditional resources

Per ulteriori informazioni sulla pagina dei risultati personalizzati, vedere la sessione di personalizzazione e sviluppo di ignite 2019 Search.To learn more about custom results page, check out our Ignite 2019 Search Customization and Development session.

Per i progetti open source, per iniziare a usare le API di Microsoft Search e altri esempi di personalizzazione ed estensibilità, visitare Microsoft Search su GitHub.For open source projects, getting started with our Microsoft Search APIs, and more customization and extensibility samples, visit Microsoft Search on GitHub.