Condividi tramite

Configurare i suggerimenti e i tipi di evento di uso in SharePoint Server

  • Articolo

 

**Si applica a:**SharePoint Server 2013, SharePoint Server 2016

**Ultima modifica dell'argomento:**2017-09-11

Eventi di uso consentono di tenere traccia di interazione degli utenti a elementi del sito. Gli elementi possono essere documenti, siti o gli elementi del catalogo. Quando un utente interagisce con un elemento del sito, SharePoint Server generano un evento di uso per questa azione. Ad esempio, se si desidera monitorare la frequenza con cui viene visualizzato un elemento di catalogo da un telefono cellulare, è possibile tenere traccia questa attività.

In questo articolo viene descritto come creare tipi di evento di uso personalizzati e come aggiungere il codice per registrare tali eventi in modo da poterli elaborare mediante il componente di elaborazione analisi.

È possibile usare i dati generati dagli eventi di uso per mostrare gli elementi consigliati o più popolari del sito. In questo articolo viene inoltre illustrato come influenzare le modalità di visualizzazione degli elementi consigliati modificando il livello di importanza di uno specifico tipo di evento di uso. Per altre informazioni, vedere la sezione Pianificare le analisi di utilizzo, gli eventi di uso e gli elementi consigliati in Pianificare la ricerca per i siti di pubblicazione intersito in SharePoint Server 2016.

È possibile visualizzare le statistiche per tutti i tipi di eventi di uso nei report Tendenze popolarità ed Elementi più popolari. Per altre informazioni, vedere Visualizzare i report di utilizzo in SharePoint Server.

Contenuto dell'articolo:

  • Creare un tipo di evento di uso personalizzato

  • Registrare un evento di uso personalizzato

  • Registrare un evento di uso predefinito

  • Modificare il livello di importanza di un tipo di evento di uso

  • Modificare il periodo di tempo recente per un tipo di evento di uso

  • Abilitare e disabilitare la registrazione di eventi di uso di utenti anonimi

  • Ottenere GUID SiteId e GUID WebId di un sito

Creare un tipo di evento di uso personalizzato

Esistono tre tipi di eventi di uso predefinito in SharePoint Server. È possibile creare fino a dodici tipi di eventi di uso personalizzato utilizzando Microsoft PowerShell.

Per creare un tipo di evento di uso personalizzato

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To get a site at the root site collection level:
$Site = Get-SPSite "https://localhost"

# To get a site below the root site collection level:
$Site = Get-SPSite "https://localhost/sites/<SiteName>"

# To create a custom usage event type:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$EventGuid = [Guid]::NewGuid()
$EventName = "<EventTypeName>"
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$newEventType = $tenantConfig.RegisterEventType($EventGuid, $EventName, "")
$tenantConfig.Update($SSP)

    Dove:

    • <SiteName> corrisponde al nome del sito per cui si desidera creare un evento di uso personalizzato.

    • <EventTypeName> è il nome del nuovo tipo di evento di uso personalizzato da creare, ad esempio, BuyEventType.

    Questa procedura consente di creare un GUID casuale per il tipo di evento di uso. Usare questo GUID quando si aggiunge il codice per la registrazione dell'evento di uso personalizzato, come descritto in Registrare un evento di uso personalizzato.

    Importante

    Affinché un tipo di evento di uso personalizzato venga reso disponibile nel sistema possono essere necessarie fino a tre ore. Per accelerare il processo è in alternativa possibile riavviare il servizio Timer di SharePoint.

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Registrare un evento di uso personalizzato

Dopo aver creato un tipo di evento di uso personalizzato, come descritto in Creare un tipo di evento di uso personalizzato, è necessario aggiungere il codice nella posizione in cui l'evento si verifica, ad esempio al caricamento di una pagina o al clic dell'utente su un collegamento o un pulsante. Questi dati vengono quindi inviati al componente di elaborazione analisi nel quale vengono registrati ed elaborati.

Se si utilizza la pubblicazione intersito, in cui si mostra il contenuto del catalogo su un sito di pubblicazione, è necessario registrare l'evento all'URL dell'elemento indicizzato ed eseguire l'override di alcune impostazioni del sito. Se ad esempio si dispone di un catalogo in un sito di creazione pubblicato in un sito di pubblicazione, quando un utente interagisce con un articolo del catalogo nel sito di pubblicazione l'evento di uso deve essere registrato per l'elemento nel sito di creazione. Inoltre, il codice aggiunto per registrare l'evento di uso deve sostituire i valori di SiteId e WebId del sito di pubblicazione con quelli del sito di creazione.

Per aggiungere codice per registrare un evento di uso personalizzato

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

  4. In un editor HTML, aprire il file in cui deve essere registrato l'evento di uso personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto, e aggiungere il codice seguente:

    window.Log<CustomUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        var eventGuid = new SP.Guid("<GUID>");
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent(spClientContext, eventGuid, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

    • <CustomUsageEventType> è il nome dell'evento personalizzato, ad esempio BuyEventType.

    • <GUID> è l'ID numerico del tipo di evento di uso, ad esempio 4e605543-63cf-4b5f-aab6-99a10b8fb257.

  5. In un editor HTML, aprire il file che fa riferimento all'evento di uso personalizzato e aggiungere il codice seguente:

    # The example below shows how a custom usage event type is referred to when a button is clicked: 
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>')"></button>

    Dove:

    • <CustomUsageEventType> è il nome del tipo di evento personalizzato.

    • <URL> è l'URL completo dell'elemento in cui registrare l'evento di uso, ad esempio, https://contoso.com/faq.

Per aggiungere codice per registrare un evento di uso personalizzato e l'override delle impostazioni del sito

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

  4. In un editor HTML, aprire il file in cui deve essere registrato l'evento di uso personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto. Nell'esempio seguente viene illustrato come eseguire l'override dei valori correnti di SiteId, WebId e UserId.

    window.Log<CustomUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      var eventGuid = new SP.Guid("<GUID>");
SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent2(spClientContext, eventGuid, url, webIdGuid, siteIdGuid, spUser);
      spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

    Dove:

    • <CustomUsageEventType> è il nome del tipo di evento personalizzato, ad esempio BuyEventType.

    • <GUID> è l'ID numerico del tipo di evento di uso, ad esempio 4e605543-63cf-4b5f-aab6-99a10b8fb257.

  5. In un editor HTML, aprire il file che fa riferimento al tipo di evento di uso personalizzato e aggiungere il codice seguente:

    # The example below shows how a custom usage event type is referred to when the \"Buy!\" button is clicked:
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">Buy!</button>

    Dove:

    • <CustomUsageEventType> è il nome del tipo di evento personalizzato, ad esempio BuyEventType.

    • <URL> è l'URL presente nella proprietà gestita OriginalPath.

    • <SiteId GUID> è il GUID SiteId del sito di creazione e modifica. Per informazioni su come ottenere il GUID SiteId, vedere Ottenere GUID SiteId e GUID WebId di un sito.

    • <WebId GUID> è il GUID WebId del sito di creazione e modifica. Per informazioni su come ottenere il GUID WebId, vedere Ottenere GUID SiteId e GUID WebId di un sito.

    • <UserName><UserName> può essere un ID di cookie usato per identificare gli utenti in un sito con utenti anonimi.

Registrare un evento di uso predefinito

Se si desidera aggiungere codice che fa riferimento a un tipo di evento di uso predefinito, ad esempio le visualizzazioni, è necessario aggiungere codice nella posizione in cui l'evento si verifica.

Se si utilizza la pubblicazione intersito che mostra il contenuto del catalogo su un sito di pubblicazione, è necessario registrare l'evento all'URL dell'elemento indicizzato ed eseguire l'override di alcune impostazioni del sito. Se ad esempio si dispone di un catalogo in un sito di creazione pubblicato in un sito di pubblicazione, quando un utente interagisce con un articolo del catalogo nel sito di pubblicazione l'evento di uso deve essere registrato per l'elemento nel sito di creazione. Inoltre, il codice aggiunto per registrare l'evento di uso deve sostituire i valori di SiteId e WebId del sito di pubblicazione con quelli del sito di creazione.

Per aggiungere codice per registrare un evento di uso predefinito

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

  4. In un editor HTML, aprire il file in cui deve essere registrato l'evento di uso personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto, e aggiungere il codice seguente:

    window.Log<DefaultUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

    Dove:

    • <DefaultUsageEventType> è il nome del tipo di evento di uso predefinito, ad esempio Visualizzazioni.

    • <EventTypeId> è l'ID numerico del tipo di evento di uso, ad esempio 1.

  5. In un editor HTML, aprire il file che fa riferimento all'evento di uso predefinito e aggiungere il codice seguente:

    # The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')">

    Dove:

    • <DefaultUsageEventType> è il nome del tipo di evento di uso predefinito, ad esempio Visualizzazioni.

    • <URL> è l'URL completo dell'elemento in cui registrare l'evento di uso, ad esempio, https://contoso.com/careers.

  6. Salvare il file.

Per aggiungere codice per registrare un evento di uso predefinito e ignorare le impostazioni del sito

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

  4. In un editor HTML, aprire il file in cui deve essere registrato l'evento di uso personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto. Nell'esempio seguente viene illustrato come eseguire l'override dei valori correnti di SiteId, WebId e UserId.

    window.Log<DefaultUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url, webIdGuid, siteIdGuid, spUser);
spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

    Dove:

    • <DefaultUsageEventType> è il nome del tipo di evento predefinito, ad esempio Visualizzazioni.

    • <EventTypeId> è l'ID numerico del tipo di evento di uso, ad esempio 1.

  5. In un editor HTML, aprire il file che fa riferimento al tipo di evento di uso predefinito e aggiungere il codice seguente:

    # The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">

    Dove:

    • <DefaultUsageEventType> è il nome del tipo di evento predefinito, ad esempio Visualizzazioni.

    • <URL> è l'URL rilevato nella proprietà gestita OriginalPath.

    • <SiteId GUID> è il GUID SiteId del sito di creazione e modifica. Per informazioni su come ottenere il GUID SiteId, vedere Ottenere GUID SiteId e GUID WebId di un sito.

    • <WebId GUID> è il GUID WebId del sito di creazione e modifica. Per informazioni su come ottenere il GUID WebId, vedere Ottenere GUID SiteId e GUID WebId di un sito.

    • <UserName><UserName> può ad esempio essere un ID di cookie usato per identificare gli utenti in un sito con utenti anonimi.

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Modificare il livello di importanza di un tipo di evento di uso

La proprietà RecommendationWeight del tipo di evento di uso corrisponde a un valore numerico indicante il livello di importanza di un tipo di evento di uso rispetto ad altri tipi di eventi di uso utilizzati nel calcolo degli elementi consigliati. Il tipo di evento di uso Visualizzazioni presenta per RecommendationWeight il valore preconfigurato 1. Gli altri tipi di evento di uso predefiniti, Recommendations displayed e Recommendations clicked e tutti i tipi di eventi di uso personalizzati presentano un valore di RecommendationWeight pari a 0. Per aumentare l'importanza di un tipo di evento di uso nel calcolo degli elementi consigliati, modificare il valore del parametro RecommendationWeight. Il livello di importanza più elevato disponibile è 10.

Per modificare il livello di importanza di un tipo di evento di uso

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To change the importance level of a usage event type:
$event.RecommendationWeight = <RecommendationWeightNumber>
$tenantConfig.Update($SSP)

# To verify the changed importance level for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

    Dove:

    • <EventTypeId> è l'ID numerico del tipo di evento di uso per il quale si desidera modificare il peso, ad esempio 256.

    • <RecommendationWeightNumber> è il livello di importanza da applicare al tipo di evento di uso, ad esempio 4.

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Modificare il periodo di tempo recente per un tipo di evento di uso

La proprietà RecentPopularityTimeframe del tipo di evento di uso è un valore numerico che definisce il periodo di tempo Recente nel report Elementi più popolari. Il report Elementi più popolari mostra gli elementi più popolari per tipo di evento di uso per tutti gli elementi in una raccolta o un elenco, ad esempio gli elementi più visualizzati. Il report può essere ordinati in base ai periodi di tempo Recente o Sempre. Per impostazione predefinita, il periodo di tempo Recente è impostato sugli ultimi 14 giorni per ogni evento di uso. È possibile modificare questo valore impostandolo su un periodo di tempo compreso tra uno e 14 giorni.

Per modificare il periodo di tempo recente per un tipo di evento di uso

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To change the Recent time span for a usage event type:
$event.RecentPopularityTimeFrame = <TimeFrame>
$tenantConfig.Update($SSP)

# To verify the changed Recent time frame for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

    Dove:

    • <EventTypeId> è l'ID numerico del tipo di evento di uso per il quale si desidera cambiare l'intervallo di tempo Recente, ad esempio 256.

    • <TimeFrame> è l'intervallo di tempo Recente da applicare al tipo di evento di uso, ad esempio 7.

    Nota

    Il sistema aggiorna le modifiche al periodo di tempo Recente solo dopo l'esecuzione del processo timer di analisi dell'uso.

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Abilitare e disabilitare la registrazione di eventi di uso di utenti anonimi

Gli utenti che esplorano i contenuti di un sito senza essere connessi a un account sono definiti utenti anonimi. Per la registrazione degli utenti anonimi è disponibile solo il tipo di evento Visualizzazioni. Per impostazione predefinita, la registrazione di eventi di uso personalizzati è disabilitata per gli utenti anonimi.

Per abilitare la registrazione di eventi di uso di utenti anonimi

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To enable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::AllowAnonymousWrite
$tenantConfig.Update($SSP)

# To verify that the logging of anonymous users has been enabled, i.e. that the Options property is set to AllowAnonymousWrite:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

    Dove:

    • <EventTypeId> è l'ID numerico del tipo di evento di uso da abilitare per la registrazione di utenti anonimi, ad esempio 256.

Per disabilitare la registrazione di eventi di uso di utenti anonimi

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To disable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::None
$tenantConfig.Update($SSP)

# To verify that logging of anonymous users has been disabled, i.e. that the Options property is set to None:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)

    Dove:

    • <EventTypeId> è l'ID numerico del tipo di evento di uso da disabilitare per la registrazione di utenti anonimi, ad esempio 256.

    Nota

    Per il tipo di evento di uso predefinito Visualizzazioni, non è possibile disabilitare la registrazione di utenti anonimi.

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

Ottenere GUID SiteId e GUID WebId di un sito

Per ottenere il GUID SiteId e il GUID WebId di un sito, è possibile usare i seguenti comandi di PowerShell.

Per ottenere GUID SiteId e GUID WebId di un sito

  1. Verificare di essere membri dei ruoli e dei gruppi seguenti:

    • Ruolo predefinito del server securityadmin nell'istanza di SQL Server.

    • Ruolo predefinito del database db_owner in tutti i database da aggiornare.

    • Gruppo Administrators nel server in cui si eseguono i cmdlet di PowerShell.

    • Aggiungere le appartenenze necessarie oltre ai livelli minimi sopra indicati.

    Un amministratore può utilizzare il cmdlet Add-SPShellAdmin per concedere le autorizzazioni per l'utilizzo dei cmdlet di SharePoint Server.

    Nota

    Se non si dispone delle autorizzazioni, richiederle all'amministratore dell'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

  2. Avviare SharePoint Management Shell.

  3. Al prompt dei comandi di PowerShell digitare il comando seguente:

    # To get the SiteId GUID and the WebId GUID for a root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.RootWeb
$site.id
$web.id

# To get the WebId GUID for a site below the root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.OpenWeb("<SubSiteLocation>")
$web.id

    Dove:

Nota

Per l'esecuzione di attività amministrative dalla riga di comando è consigliabile utilizzare Windows PowerShell. Lo strumento da riga di comando Stsadm è deprecato, ma è stato incluso per garantire la compatibilità con le versioni precedenti del prodotto.

See also

Come visualizzare elementi consigliati ed elementi popolari in un sito di SharePoint Server 2013https://blogs.technet.com/b/tothesharepoint/archive/2014/01/15/how-to-display-recommendations-and-popular-items-on-a-sharepoint-server-2013-site.aspx

Visualizzare i report di utilizzo in SharePoint Server