Condividi tramite


Aggiungere e configurare Web part di elementi consigliati e popolari in SharePoint Server

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

L'articolo precedente di questa serie, Modificare il modello di visualizzazione della web part Ricerca contenuto e usare Windows PowerShell per avviare l'analisi dell'utilizzo in SharePoint Server, ha spiegato come modificare la piattaforma CSWP per registrare l'evento di utilizzo Visualizzazioni e come usare Microsoft PowerShell per avviare l'analisi dell'utilizzo.

Nota

Gli esempi di questa serie si basano sulla distribuzione di SharePoint Server locale.

Andare alla pagina in cui si desidera aggiungere la web part Elementi consigliati. Nello scenario Contoso, aggiungere la web part Elementi consigliati alla pagina degli elementi del catalogo. Ecco come si esegue questa operazione:

  1. Selezionare la paginaModifica> dal menu Impostazioni.

  2. Nell'area web part in cui si desidera aggiungere la web part, scegliere Aggiungi web part.

  3. Nell'elenco Categorie, selezionare Contenuto basato sulla ricerca.

  4. Nell'elenco Parti, selezionare Elementi consigliati, quindi Aggiungi.

Nello scenario Contoso, verrà illustrata la web part Elementi consigliati sotto la web part Ricerca contenuto.

Web part Elementi consigliati aggiunta

Informazioni sulla proprietà gestita recommendedfor

In un precedente articolo di blog è stata illustrata la proprietà gestita UsageAnalyticsId usata dall'analisi dell'utilizzo per specificare come calcolare le raccomandazioni tra i singoli elementi . Vedere Informazioni sulla proprietà gestita UsageAnalyticsID. Il risultato di questo calcolo viene inviato alla proprietà gestita recommendedfor. La web part Elementi consigliati utilizza la proprietà gestita recommendedfor per eseguire una query per elementi consigliati. Non è necessario conoscere questa proprietà gestita quando si configura la web part Elementi consigliati. Per comprendere il funzionamento della query nella piattaforma RIWP, è importante tenere presente il valore consigliatoper la proprietà gestita.

La configurazione di una web part Elementi consigliati deve essere eseguita in una pagina di dettagli dell'elemento in cui vengono generati elementi consigliati. Ricordare l'articolo precedente di questa serie, quando alcuni colleghi sono stati invitati a un messaggio "Perché è necessario simulare la generazione di eventi di utilizzo delle visualizzazioni". Al click party, i colleghi fanno clic su elementi specifici in modo da generare raccomandazioni. Nello scenario Contoso, aggiungere la web part Elementi consigliati a una pagina dei dettagli dell'elemento in cui vengono generati elementi consigliati mediante i clic dei collaboratori.

Ecco la procedura per configurare la web part Elementi consigliati:

  1. Selezionare la paginaModifica> dal menu Impostazioni.

  2. Nella piattaforma RIWP selezionare il menu della web part -->Modifica web part.

    Modifica WP

  3. Nel riquadro degli strumenti della Web Part, selezionare Cambia query. Questa opzione apre una finestra di dialogo.

  4. Nella finestra di dialogo Compila query selezionare quanto segue:

  • Nella sezione Ottenere gli elementi consigliati per selezionare Un token dall'URL, quindi selezionare il valore dell’URL da cui si desidera ottenere elementi consigliati. Nello scenario Contoso, ottenere indicazioni da {URL.Token.2} (numero).

  • Nella sezione Limita in base all'app, selezionare Specifica un URL, quindi immettere l'URL del catalogo.

    Query web part Elementi con tag

Si potrebbe pensare "OK, che era facile, ma che cosa significa in realtà?" Comprendere questo processo può essere un po' difficile. Contenuto della sezione:

  • Un token dall'URL indica che si desidera ottenere elementi consigliati per un valore utilizzato nell'URL.

  • {URL. Token.2} è una variabile di query che rappresenta il secondo valore nell'URL contando da destra a sinistra. Ad esempio, nell'URL https://www.contoso.com/computers/desktops/5637145799/5637146352la variabile di query {URLToken.2} rappresenta il valore 5637145799. Tenere presente che quando è stato connesso il sito di pubblicazione al catalogo (vedere Fase 5: Connettere il sito di pubblicazione a un catalogo in SharePoint Server), è stato specificato che il valore di Numero di gruppo deve essere usato come secondo dell'ultimo valore nell'URL della pagina dell'elemento del catalogo. Ciò significa che la variabile di query {URL. Token.2} rappresenta il valore di Numero di gruppo. Inoltre, è stato eseguito il mapping Modificare il mapping della proprietà gestita UsageAnalyticsID in modo che il calcolo dell'analisi dell'utilizzo sia basato sul numero di gruppo.

  • Specifica un URL indica di specificare il sito dal quale ottenere elementi consigliati, in questo caso il sito di creazione.

    Da queste impostazioni, tuttavia, non è chiaro quale proprietà gestita viene usata nella query. Pertanto, per visualizzare ulteriori informazioni sulla query, selezionare TEST. La query eseguita dalla web part viene visualizzata nella sezione Testo query .

    Testo query

Se si suddivide la query, si ottengono i componenti seguenti:

  • recommendedfor è la proprietà gestita che viene utilizzata nella query.

  • I due punti : significa "contiene".

  • 5637145799 è il valore della variabile di query {URL.Token.2}, che è un valore Numero gruppo.

  • path:"http://ib-perf-8/sites/catalog" è l'URL del sito di creazione.

  • (IsDocument: contentclass OR "True": "STS_ListItem") consente di limitare i risultati della ricerca verso il basso solo per documenti o elementi elenco.

    Combinando tutte queste informazioni, è possibile comprendere che la query indica quanto segue:

    Dall’URL del sito di creazione, cercare il documento o gli elementi elenco in cui il valore della proprietà gestita recommendedfor contiene il valore attualmente utilizzato come secondo valore nell'URL, contando da destra a sinistra.

    Ora sappiamo cosa significa la query. Ma non abbiamo finito con la configurazione. Nella sezione ANTEPRIMA RISULTATI DI RICERCA è possibile notare che vengono visualizzati tutti gli elementi di un gruppo di prodotti, ad esempio tutti i tasti SV Keyboard E10 (si noti che hanno tutti lo stesso valore per Numero gruppo nell'URL).

    Elementi consigliati

    Tutti gli elementi del gruppo di prodotti vengono visualizzati perché il calcolo dell'analisi dell'utilizzo viene eseguito a livello di gruppo. Tenere presente che in Modificare il modello di visualizzazione della web part Ricerca contenuto e usare Windows PowerShell per avviare l'analisi dell'utilizzo in SharePoint Server è stato eseguito il mapping di UsageAnalyticsId a ows_ProductCatalogGroupNumber. Tuttavia, si vuole visualizzare solo un elemento per ogni gruppo di prodotti, operazione che può essere eseguita raggruppando i risultati della ricerca.

    Per raggruppare i risultati della ricerca, seguire questa procedura:

  1. Selezionare CRITERI DI AFFINAMENTO--> Altro.

    Visualizzazione di altre informazioni

  2. Dal menu Raggruppa per, selezionare Mostra tutte le proprietà.

    Visualizzazione di tutte le proprietà

  3. Si vuole visualizzare un solo elemento per ogni gruppo di prodotti. Di conseguenza, si seleziona ProductCatalogGroupNumberOWSTEXT (proprietà gestita di Numero di gruppo). Si vuole visualizzare solo un elemento per ogni gruppo. Pertanto, il valore in Mostra risultati è1.

    Raggruppamento per numero di gruppo

    Nell' ANTEPRIMA DEI RISULTATI DELLA RICERCA, è ora possibile visualizzare un solo elemento per gruppo di prodotti.

    Un elemento per Groeu

  4. Selezionare OK per salvare le modifiche.

  5. Nel riquadro degli strumenti della Web Part, nel campo Numero di elementi da visualizzare, immettere il numero di elementi che si desidera visualizzare nella Web Part.

    Numero di elementi da visualizzare

  6. Selezionare OK e salvare la pagina.

    Nella pagina Elementi del catalogo, vengono ora mostrati gli elementi consigliati, anche se non soddisfacenti.

    Elementi consigliati visualizzati

Analogamente a quanto avviene per la web part Ricerca contenuto, si utilizzano modelli di visualizzazione per controllare la modalità di visualizzazione di una web part Elementi consigliati. In Passaggio 11: Caricare e applicare i modelli di visualizzazione per la web part Ricerca contenuto in SharePoint Server viene illustrato come caricare e applicare i modelli di visualizzazione alla web part Ricerca contenuto. È possibile eseguire la stessa operazione per la web part Elementi consigliati. Il modello di visualizzazione usato dalla piattaforma RIWP contiene codice importante che registra i due eventi di utilizzo: Raccomandazione visualizzata e Raccomandazione selezionata.

In Un'introduzione alle raccomandazioni e agli elementi più diffusi in SharePoint Server sono stati illustrati i tre eventi di utilizzo predefiniti in SharePoint Server. Gli eventi di uso Elementi consigliati visualizzati ed Elementi consigliati selezionati vengono utilizzati per registrare statistiche su come gli utenti visualizzatori interagiscono con il contenuto di un sito Web. Quando un elemento viene visualizzato come elemento consigliato, viene registrato un evento di uso Elemento consigliato visualizzato. Quando un elemento viene selezionato quando visualizzato come elemento consigliato, viene registrato un evento di uso Elementi consigliati selezionati. Più avanti in questo articolo verrà illustrato come visualizzare tali statistiche.

In Modificare il modello di visualizzazione della web part Ricerca contenuto e usare Windows PowerShell per avviare Analisi utilizzo in SharePoint Server, è stato modificato il modello di visualizzazione CSWP per registrare l'evento di utilizzo Visualizzazioni. La registrazione degli eventi di uso Elementi consigliati visualizzati ed Elementi consigliati selezionati viene eseguita nella web part Elementi consigliati. Il modello di visualizzazione predefinito utilizzato dalla web part Elementi consigliati è Item_RecommendationsClickLogging. Questo modello di visualizzazione contiene le due funzioni LogRecsViewToEventStore e LogRecsClickToEventStore. Gli eventi di uso Elementi consigliati visualizzati ed Elementi consigliati selezionati vengono registrati dalle due funzioni.

Visualizzazione record registrazione

Clic record registrazione

Quando si modifica il modello di visualizzazione della web part Elementi consigliati, è necessario copiare il file Item_RecommendationsClickLogging, cambiare la versione copiata e applicarla alla web part Elementi consigliati. In questo modo, non è necessario preoccuparsi di aggiungere codice nello stesso modo in cui è stato aggiunto alla web part Ricerca contenuto.

Dopo aver applicato il modello di visualizzazione modificato per la web part Elementi consigliati, gli elementi consigliati vengono visualizzati correttamente.

Modello visualizzazione elementi consigliati applicato

È possibile visualizzare gli elementi più popolari, i più visualizzati, all'interno del catalogo, aggiungendo una web part Elementi più popolari a una pagina di categoria. È importante comprendere che quando si aggiunge una piattaforma PIWP alla pagina del catalogo, la piattaforma PIWP visualizzerà automaticamente gli elementi più visualizzati all'interno di ogni categoria. Ad esempio, se un visitatore visita la categoria Fotocamere, la web part Elementi più popolari mostrerà gli elementi più visualizzati all'interno della categoria Fotocamere. Se un visitatore visita la categoria Videocamere, la web part Elementi più popolari mostrerà gli elementi più visualizzati all'interno della categoria Videocamere.

Per aggiungere una web part Elementi più popolari, andare alla pagina in cui si desidera aggiungere la web part Elementi più popolari. Nello scenario Contoso, verrà aggiunta una web part Elementi più popolari alla pagina di categoria. Seguire questa procedura:

  1. Selezionare la paginaModifica> dal menu Impostazioni.

  2. Nell'area web part in cui si desidera aggiungere la web part, scegliere Aggiungi web part.

  3. Nell'elenco Categorie, selezionare Contenuto basato sulla ricerca.

  4. Nell'elenco Parti, selezionare Elementi più popolari, quindi Aggiungi.

Nello scenario Contoso, verrà illustrata la web part Elementi più popolari sotto la web part Ricerca contenuto.

Elementi popolari aggiunti

  1. Selezionare la paginaModifica> dal menu Impostazioni.

  2. Nella piattaforma PIWP selezionare il menu web part -->Modifica web part.

    Modifica PIWP

  3. Nel riquadro degli strumenti della Web Part, selezionare Cambia query. Questa opzione apre una finestra di dialogo.

  4. Nella sezione Limita in base all'app, selezionare Specifica un URL, quindi immettere l'URL del sito di creazione.

  5. Nella sezione del tag Limita in base a, selezionare Limita in base ai termini di navigazione corrente e figlio.

    Non verranno visualizzati risultati nella sezione ANTEPRIMA DEI RISULTATI DELLA RICERCA. Per quale motivo?

    Nessun risultato popolare 2

    Per visualizzare ulteriori informazioni sulla query emessa dalla web part Elementi più popolari, selezionare TEST. Nella scheda TEST è possibile visualizzare il testo Query.

    Testo query web part Elementi popolari

Il testo della query indica quanto segue:

  • path:"http://ib-perf-8/sites/catalog" è l'URL del sito di creazione.

  • owstaxIdMetadataAllTagsInfo è la proprietà gestita che viene utilizzata nella query.

  • I due punti : significa "contiene".

  • 91eb9f0d-3e5a-41a8-8487-78dfe234ca7c è il GUID della categoria corrente. In questo esempio, la categoria corrente è Fotocamere.

  • (IsDocument: contentclass OR "True": "STS_ListItem") consente di limitare i risultati della ricerca verso il basso solo per documenti o elementi elenco.

    Se queste informazioni vengono messe insieme, la query fornisce le informazioni seguenti:

    Dall’URL del sito di creazione, cercare il documento o gli elementi elenco in cui il valore della proprietà gestita owstaxIdMetadataAllTagsInfo contiene il GUID della categoria di navigazione corrente o un elemento figlio della navigazione corrente.

    Un'informazione importante che è possibile vedere nel testo della query è che la web part Elementi più popolari utilizza la proprietà gestita owstaxIdMetadataAllTagsInfo nella relativa query. È possibile modificare la query nella web part Elementi più popolari per utilizzare un'altra proprietà gestita. Ciò significa che per il corretto funzionamento della query nella piattaforma PIWP, la proprietà gestita owstaxIdMetadataAllTagsInfo deve includere il valore della proprietà gestita usata per guidare lo spostamento gestito. Per altre informazioni, vedere Fase 8: Assegnare una pagina categoria e una pagina di elementi del catalogo a un termine in SharePoint Server. Nello scenario Contoso, la proprietà gestita che guida l’esplorazione gestita è owstaxIdProductCatalogItemCategory. È necessario eseguire il mapping della proprietà sottoposta a ricerca per indicizzazione di owstaxIdProductCatalogItemCategory alla proprietà gestita owstaxIdMetadataAllTagsInfo .

    In Modificare il modello di visualizzazione della web part Ricerca contenuto e usare Windows PowerShell per avviare l'analisi di utilizzo in SharePoint Server viene illustrato come trasformare una proprietà sottoposta a ricerca per indicizzazione in una proprietà gestita.

    Importante

    È necessario eseguire il mapping nel sito di creazione.

    Nello scenario Contoso, la proprietà owstaxIdMetadataAllTagsInfo correttamente trasformata è analoga a quanto segue:

    Nuovo mapping

    Dopo aver modificato il mapping della proprietà, è necessario avviare una ricerca per indicizzazione completa, come illustrato in Fase 4: Configurare la ricerca e abilitare la ricerca per indicizzazione del contenuto del catalogo in SharePoint Server.

    Esiste una cosa importante che non è possibile visualizzare nel testo della query ed è la modalità di ordinamento dei risultati della ricerca. La web part Elementi più popolari ordina i risultati della ricerca in ordine decrescente nella proprietà gestita ViewsRecent. Per impostazione predefinita, la proprietà gestita ViewsRecent contiene il numero di visualizzazioni di un elemento negli ultimi 14 giorni. Più avanti in questa serie verrà illustrato come modificare questo intervallo di tempo, ad esempio negli ultimi 7 giorni. Questo comportamento predefinito della proprietà significa che la query eseguita dalla piattaforma PIWP eseguirà le attività seguenti:

    Dall’URL del sito di creazione, cercare il documento o gli elementi elenco in cui il valore della proprietà gestita owstaxIdMetadataAllTagsInfo contiene il GUID della categoria di navigazione corrente o un elemento figlio della navigazione corrente. Ordinare i risultati della ricerca in ordine decrescente delle visualizzazioni per gli ultimi 14 giorni.

    Al termine della ricerca per indicizzazione completa, i risultati verranno visualizzati nella web part.

    Elementi popolari restituiti

  1. Selezionare OK per salvare le modifiche e salvare la pagina.

    Elementi popolari visualizzati

    Per visualizzare correttamente gli elementi più popolari, è possibile applicare un modello di visualizzazione nello stesso modo in cui è stato applicato nella web part Ricerca contenuto. Per ulteriori informazioni, vedere Passaggio 11: Caricare e applicare i modelli di visualizzazione per la web part Ricerca contenuto in SharePoint Server.

    Per verificare che la web part Elementi più popolari funzioni correttamente, visualizzare la sezione Fotocamere. In questa pagina, viene visualizzata la maggior parte degli elementi visualizzati nella categoria Fotocamere.

    Fotocamere elementi popolari

    Quando si visualizza la categoria Videocamere, vengono mostrati gli elementi più visualizzati all'interno della categoria Videocamere.

    Videocamere elementi popolari

    La web part Elementi più popolari funziona correttamente. Ottimo!

    A questo punto si è in grado di configurare la web part Elementi consigliati e la web part Elementi più popolari. Quando si eseguono queste attività, si dovrebbe accedere al proprio account.

    Utente connesso

Nell'articolo successivo di questa serie verrà illustrato il funzionamento di tutte queste configurazioni se il sito Web include solo utenti anonimi, ovvero utenti che non hanno effettuato l'accesso.

Successivi articoli di questa serie

Utilizzare elementi consigliati e popolari sui siti Web con utenti anonimi in SharePoint Server