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

SI APPLICA A:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

Gli eventi di utilizzo consentono di tenere traccia del modo in cui gli utenti interagiscono con gli elementi nel sito. Gli elementi possono essere documenti, siti o elementi del catalogo. Quando un utente interagisce con un elemento nel sito, SharePoint Server genera un evento di utilizzo per questa azione. Ad esempio, se si vuole monitorare la frequenza di visualizzazione di un elemento del catalogo da un telefono cellulare, è possibile tenere traccia di questa attività.

Questo articolo descrive come creare tipi di evento di utilizzo personalizzati e come aggiungere codice per registrare eventi di utilizzo personalizzati in modo che possano essere elaborati dal componente di elaborazione dell'analisi.

È possibile usare i dati generati dagli eventi di utilizzo per visualizzare raccomandazioni o elementi popolari nel sito. Questo articolo illustra anche come influenzare il modo in cui vengono visualizzate le raccomandazioni modificando il livello di importanza per un tipo di evento di utilizzo specifico. Per altre informazioni, vedere "Pianificare l'analisi dell'utilizzo, gli eventi di utilizzo e le raccomandazioni" in Pianificare la ricerca di siti di pubblicazione tra siti in SharePoint Server 2016.

È possibile visualizzare le statistiche per tutti i tipi di evento di utilizzo nei report Tendenze popolarità e Elementi più popolari. Per ulteriori informazioni, vedere View usage reports in SharePoint Server.

Creare un tipo di evento di utilizzo personalizzato

In SharePoint Server sono disponibili tre tipi di evento di utilizzo predefiniti. È possibile creare fino a 12 tipi di evento di utilizzo personalizzati usando Microsoft PowerShell.

Per creare un tipo di evento di utilizzo 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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

# To get a site at the root site collection level:
$Site = Get-SPSite "http://localhost"
# To get a site below the root site collection level:
$Site = Get-SPSite "http://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> è il nome del sito per il quale si vuole creare un evento di utilizzo personalizzato.

• <EventTypeName> è il nome del nuovo tipo di evento di utilizzo personalizzato che si desidera creare, ad esempio BuyEventType .

  Questa procedura crea un GUID casuale per il tipo di evento di utilizzo. Usare questo GUID quando si aggiunge codice per registrare l'evento di utilizzo personalizzato, come descritto in Registrare un evento di utilizzo personalizzato.

  Importante

  La disponibilità di un tipo di evento di utilizzo personalizzato nel sistema può richiedere fino a tre ore. Tuttavia, per velocizzare il processo, è possibile riavviare in alternativa il servizio Timer di SharePoint.

Nota

[!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 utilizzo personalizzato

Dopo aver creato un tipo di evento di utilizzo personalizzato, come descritto in Creare un tipo di evento di utilizzo personalizzato, è necessario aggiungere codice alla posizione in cui si verifica l'evento, ad esempio quando viene caricata una pagina o quando un utente fa clic su un collegamento o un pulsante. Questi dati vengono quindi inviati al componente di elaborazione dell'analisi, in cui vengono registrati ed elaborati.

Se si usa la pubblicazione tra siti, in cui si mostra il contenuto del catalogo in un sito di pubblicazione, è necessario registrare l'evento di utilizzo nell'URL dell'elemento indicizzato ed eseguire l'override di alcune impostazioni del sito. Ad esempio, se si dispone di un catalogo in un sito di creazione pubblicato in un sito di pubblicazione, quando un utente interagisce con un elemento del catalogo nel sito di pubblicazione, questo evento di utilizzo deve essere registrato nell'elemento nel sito di creazione. Inoltre, il codice aggiunto per registrare l'evento di utilizzo deve eseguire l'override di SiteId e WebId del sito di pubblicazione e deve essere sostituito con SiteId e WebId del sito di creazione.

Per aggiungere codice per registrare un evento di utilizzo 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo 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 utilizzo, ad esempio 4e605543-63cf-4b5f-aab6-99a10b8fb257.

5. In un editor HTML aprire il file che fa riferimento all'evento di utilizzo 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 a cui deve essere registrato l'evento di utilizzo, https://contoso.com/faqad esempio .

Per aggiungere codice per registrare un evento di utilizzo personalizzato ed eseguire 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto. Nell'esempio seguente viene illustrato come eseguire l'override di SiteId, WebId e UserId correnti.

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 utilizzo, ad esempio 4e605543-63cf-4b5f-aab6-99a10b8fb257 .

5. In un editor HTML aprire il file che fa riferimento al tipo di evento di utilizzo 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 trovato nella proprietà gestita OriginalPath.

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

• <Guid> WebId è il GUID WebId del sito di creazione. Per informazioni su come ottenere il GUID WebId, vedere Get SiteId GUID and WebId GUID for a site (Ottenere il GUID di SiteId e il GUID WebId per un sito).

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

Registrare un evento di utilizzo predefinito

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

Se si usa la pubblicazione tra siti, che mostra il contenuto del catalogo in un sito di pubblicazione, è necessario registrare l'evento di utilizzo nell'URL dell'elemento indicizzato ed eseguire l'override di alcune impostazioni del sito. Ad esempio, se si dispone di un catalogo in un sito di creazione pubblicato in un sito di pubblicazione, quando un utente interagisce con un elemento del catalogo nel sito di pubblicazione, questo evento di utilizzo deve essere registrato nell'elemento nel sito di creazione. Inoltre, il codice aggiunto per registrare l'evento di utilizzo deve eseguire l'override di SiteId e WebId del sito di pubblicazione e deve essere sostituito con SiteId e WebId del sito di creazione.

Per aggiungere codice per registrare un evento di utilizzo 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo 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 utilizzo predefinito, ad esempio Views.

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

5. In un editor HTML aprire il file che fa riferimento all'evento di utilizzo 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 utilizzo predefinito, ad esempio Views .

• <URL> è l'URL completo dell'elemento a cui deve essere registrato l'evento di utilizzo, https://contoso.com/careersad esempio .

6. Salvare il file.

Per aggiungere codice per registrare un evento di utilizzo predefinito ed eseguire 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo personalizzato, ad esempio un modello di visualizzazione per una web part Ricerca contenuto. L'esempio seguente illustra come eseguire l'override di SiteId, WebId e UserId correnti.

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 Views .

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

5. In un editor HTML aprire il file che fa riferimento al tipo di evento di utilizzo 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 Views .

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

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

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

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

Nota

[!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 utilizzo

La proprietà del tipo di evento di utilizzo , RecommendationWeight, è un valore numerico che mostra il livello di importanza di un tipo di evento di utilizzo rispetto ad altri tipi di evento di utilizzo usati nel calcolo delle raccomandazioni. Il tipo di evento di utilizzo predefinito Visualizzazioni ha un valore RecommendationWeight preconfigurato pari a 1. Gli altri tipi di evento di utilizzo predefiniti, i consigli visualizzati e i consigli su cui è stato fatto clic e tutti i tipi di evento di utilizzo personalizzati hanno un valore RecommendationWeight pari a 0. Per aumentare l'importanza di un tipo di evento di utilizzo nel calcolo delle raccomandazioni, modificare il valore del parametro RecommendationWeight . Il livello di importanza più alto disponibile è 10.

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

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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo per il quale si vuole modificare il peso, ad esempio 256.

• <RecommendationWeightNumber> è il livello di importanza che si vuole applicare al tipo di evento utente, ad esempio 4.

Nota

[!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 utilizzo

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

Per modificare il periodo di tempo Recente per un tipo di evento di utilizzo

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

  [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo per il quale si vuole modificare l'intervallo di tempo Recenti , ad esempio 256.

• <TimeFrame> è il nuovo intervallo di tempo recente che si vuole applicare al tipo di evento utente, ad esempio 7.

  Nota

  Il sistema aggiorna tutte le modifiche apportate al periodo di tempo Recente solo dopo l'esecuzione del processo timer di Analisi dell'utilizzo.

Nota

[!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 degli eventi di utilizzo degli utenti anonimi

Gli utenti che esplorano il contenuto di un sito senza essere connessi a un account sono noti come utenti anonimi. Solo il tipo di evento Views è abilitato per la registrazione di utenti anonimi. Per impostazione predefinita, la registrazione degli eventi di utilizzo personalizzati è disabilitata per gli utenti anonimi.

Per abilitare la registrazione degli eventi di utilizzo degli 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, contattare l'amministratore del programma di installazione o SQL Server amministratore per richiedere le autorizzazioni. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo che si vuole abilitare per la registrazione di utenti anonimi, ad esempio 256.

Per disabilitare la registrazione degli eventi di utilizzo degli 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

  [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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 utilizzo che si vuole disabilitare per la registrazione di utenti anonimi, ad esempio 256.

  Nota

  Per il tipo di evento di utilizzo predefinito Views , non è possibile disabilitare la registrazione degli utenti anonimi.

Nota

[!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 il GUID SiteId e il GUID WebId per un sito

È possibile usare i comandi di PowerShell seguenti per ottenere il GUID SiteId e il GUID WebId per un sito.

Per ottenere il GUID SiteId e il GUID WebId per 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

  [!NOTA] Se non si dispone delle autorizzazioni, richiederle all'amministratore per l'installazione o all'amministratore di SQL Server. Per altre informazioni sulle autorizzazioni di PowerShell, vedere Add-SPShellAdmin.

2. Avviare Management Shell di SharePoint.

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:

• <RootSiteURL> è l'URL del sito radice di cui si desidera ottenere il GUID SiteId e il GUID WebId, https://contoso.com/sites/catalogad esempio .

• <SubSiteLocation> è il resto del percorso URL del sito secondario dopo l'URL del sito radice. Ad esempio, se l'URL del sito radice è https://contoso.com/sites/catalog e l'URL del sito secondario è https://contoso.com/sites/catalog/products, digitare i prodotti per questo segnaposto.

Nota

[!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.

Vedere anche

Concetti

Visualizzare i report sull'uso in SharePoint Server

Ulteriori risorse

Come visualizzare raccomandazioni ed elementi comuni in un sito di SharePoint Server 2013