Configurer des recommandations et des types d'événements de l'utilisation de SharePoint Server

S’APPLIQUE À :  yes-img-13 2013  yes-img-16 2016  yes-img-19 2019  yes-img-se Subscription Edition  no-img-sop SharePoint in Microsoft 365

Usage events enable you to track how users interact with items on your site. Items can be documents, sites, or catalog items. Lorsqu’un utilisateur interagit avec un élément sur votre site, SharePoint Server génère un événement Actions utilisateur pour cette action. For example, if you want to monitor how often a catalog item is viewed from a mobile phone, you can track this activity.

Cet article décrit comment créer des types d'événement d'utilisation personnalisé et comment ajouter du code dans le but d'enregistrer des événements d'utilisation personnalisés et permettre leur traitement à l'aide du composant de traitement d'analyse.

Vous pouvez utiliser les données générées par les événements d'utilisation pour afficher des recommandations ou des éléments populaires sur votre site. Cet article explique aussi comment influencer le mode d'affichage des recommandations en modifiant le niveau d'importance d'un type d'événement d'utilisation en particulier. Pour plus d’informations, voir « Planifier l’analyse de l’utilisation, les événements d’utilisation et les recommandations » dans Plan search for cross-site publishing sites in SharePoint Server 2016.

Vous pouvez dévoiler les statistiques de tous les types d'événement d'utilisation dans les rapports Tendances de popularité et Éléments les plus populaires. Pour plus d'informations, voir Affichage des rapports d'utilisation dans SharePoint Server.

Créer un type d’événement d’utilisation personnalisé

Il existe trois types d’événement d’utilisation par défaut dans SharePoint Server. Vous pouvez créer jusqu’à douze types d’événements d’utilisation personnalisés à l’aide de Microsoft PowerShell.

Pour créer un type d’événement d’utilisation personnalisé

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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)

Où :

  • <SiteName> est le nom du site pour lequel vous souhaitez créer un événement d’utilisation personnalisé.

  • <EventTypeName> est le nom du nouveau type d'événement d'utilisation personnalisé que vous cherchez à créer (par exemple, BuyEventType ).

    Cette procédure crée un GUID au hasard pour le type d'événement d'utilisation personnalisé. Utilisez ce GUID au moment d'ajouter du code pour enregistrer l'événement d'utilisation personnalisé comme le décrit la section Enregistrer un événement d'utilisation personnalisé.

    Important

    Trois heures maximum peuvent s'écouler avant que le type d'événement d'utilisation ne soit disponible dans le système. Cependant, pour accélérer le processus, vous pouvez également redémarrer le service du minuteur SharePoint.

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Enregistrer un événement d’utilisation personnalisé

Après avoir créé un type d'événement d'utilisation personnalisé (voir la section Créer un type d'événement d'utilisation personnalisé), vous devez ajouter un code à l'endroit même où survient l'événement (par exemple, lors du chargement d'une page ou lorsqu'un utilisateur clique sur un lien ou un bouton). Ces données sont ensuite transmises au composant de traitement d'analyse où elles sont enregistrées et traitées.

Si vous utilisez la publication intersites qui consiste à afficher le contenu d'un catalogue sur un site de publication, vous devez enregistrer l'événement d'utilisation dans l'URL de l'élément indexé et remplacer certains paramètres du site. Par exemple, si vous disposez sur un site de création d'un catalogue que vous avez publié sur un site de publication, quand un utilisateur exploite un élément du catalogue sur le site de publication, cet événement d'utilisation doit être enregistré dans l'élément sur le site de création. De plus, le code que vous ajoutez dans le but d'enregistrer l'événement d'utilisation doit remplacer les propriétés SiteId et WebId du site de publication et accepter à la place les propriétés SiteId et WebId du site de création.

Pour ajouter du code pour enregistrer un événement d’utilisation personnalisé

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

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

  1. Dans un éditeur HTML, ouvrez le fichier dans lequel l'événement d'utilisation personnalisé doit être enregistré (par exemple un modèle d'affichage pour un composant WebPart de recherche de contenu) et ajoutez le code suivant :
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 est le nom de l'événement personnalisé (par exemple, BuyEventType ).

  • GUID est l’ID numérique du type d’événement d’utilisation ( par exemple, 4e605543-63cf-4b5f-aab6-99a10b8fb257).

  1. Dans un éditeur HTML, ouvrez le fichier qui se rapporte à l'événement d'utilisation personnalisé et ajoutez le code suivant :
# 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>

Où :

  • <CustomUsageEventType> est le nom du type d’événement personnalisé.

  • <URL> est l'URL complète de l'élément dans lequel l'événement d'utilisation est à enregistrer (par exemple, http://contoso.com/faq ).

Pour ajouter du code pour enregistrer un événement d’utilisation personnalisé et remplacer les paramètres du site

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

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

  1. Dans un éditeur HTML, ouvrez le fichier dans lequel l'événement d'utilisation personnalisé doit être enregistré (par exemple, un modèle d'affichage pour un composant WebPart de recherche de contenu). L'exemple qui suit montre comment remplacer les valeurs SiteId, WebId et UserId actuelles.
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");
}

Où :

  • <CustomUsageEventType> est le nom du type d'événement personnalisé (par exemple, BuyEventType ).

  • <GUID> est l’ID numérique du type d’événement d’utilisation ( par exemple, 4e605543-63cf-4b5f-aab6-99a10b8fb257 ).

  1. Dans un éditeur HTML, ouvrez le fichier qui se rapporte au type d'événement d'utilisation personnalisé et ajoutez le code suivant :
# 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>

Où :

  • <CustomUsageEventType> est le nom du type d’événement personnalisé ( par exemple, BuyEventType).

  • <URL> est l’URL trouvée dans la propriété gérée OriginalPath.

  • <SiteId GUID> est le GUID SiteId du site de création. Pour plus d'informations sur l'obtention du GUID SiteId, voir Obtenir le GUID SiteId et le GUID WebId pour un site.

  • <WebId GUID> est le GUID WebId du site de création. Pour plus d'informations sur l'obtention du GUID WebId, voir Obtenir le GUID SiteId et le GUID WebId pour un site.

  • <UserName> peut être un ID de cookie utilisé pour identifier les utilisateurs sur un site qui a des utilisateurs anonymes.

Enregistrer un événement d’utilisation par défaut

Pour ajouter du code qui se rapporte à un type d'événement d'utilisation par défaut (par exemple, des affichages), vous devez ajouter du code à l'endroit même où l'événement se produit.

Si vous utilisez la publication intersites qui dévoile le contenu d'un catalogue sur un site de publication, vous devez enregistrer l'événement d'utilisation dans l'URL de l'élément indexé et remplacer certains paramètres du site. Par exemple, si vous disposez sur un site de création d'un catalogue que vous avez publié sur un site de publication, quand un utilisateur exploite un élément du catalogue sur le site de publication, cet événement d'utilisation doit être enregistré dans l'élément sur le site de création. De plus, le code que vous ajoutez dans le but d'enregistrer l'événement d'utilisation doit remplacer les propriétés SiteId et WebId du site de publication et accepter à la place les propriétés SiteId et WebId du site de création.

Pour ajouter du code pour enregistrer un événement d’utilisation par défaut

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

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

  1. Dans un éditeur HTML, ouvrez le fichier dans lequel l'événement d'utilisation personnalisé doit être enregistré, par exemple un modèle d'affichage pour un composant WebPart de recherche de contenu, et ajoutez le code suivant :
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");
}

Où :

  • <DefaultUsageEventType> est le nom du type d’événement d’utilisation par défaut , par exemple, Views.

  • <EventTypeId> est l’ID numérique du type d’événement d’utilisation (par exemple, 1).

  1. Dans un éditeur HTML, ouvrez le fichier qui se rapporte à l'événement d'utilisation par défaut et ajoutez le code suivant :
# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')"> 

Où :

  • <DefaultUsageEventType> est le nom du type d'événement d'utilisation par défaut (par exemple, Affichages ).

  • <URL> est l’URL complète de l’élément auquel l’événement d’utilisation doit être enregistré, par exemple, http://contoso.com/careers

  1. Enregistrez le fichier.

Pour ajouter du code pour enregistrer un événement d’utilisation par défaut et remplacer les paramètres du site

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

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

  1. Dans un éditeur HTML, ouvrez le fichier dans lequel l'événement d'utilisation personnalisé doit être enregistré, par exemple un modèle d'affichage pour un composant WebPart de recherche de contenu. L'exemple qui suit montre comment remplacer les propriétés SiteId, WebId et UserId actuelles.
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");
}

Où :

  • <DefaultUsageEventType> est le nom du type d'événement par défaut (par exemple, Affichages ).

  • <EventTypeId> est l'ID numérique du type d'événement d'utilisation (par exemple, 1 ).

  1. Dans un éditeur HTML, ouvrez le fichier qui se rapporte au type d'événement d'utilisation par défaut et ajoutez le code suivant :
# 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>')">

Où :

  • <DefaultUsageEventType> est le nom du type d'événement par défaut (par exemple, Affichages ).

  • <URL> est l'URL dans la propriété gérée OriginalPath .

  • <SiteId GUID> est le GUID SiteId du site de création. Pour plus d'informations sur l'obtention du GUID SiteId, voir Obtenir le GUID SiteId et le GUID WebId pour un site.

  • <WebId GUID> est le GUID WebId du site de création. Pour plus d'informations sur l'obtention du GUID WebId, voir Obtenir le GUID SiteId et le GUID WebId pour un site.

  • <UserName> peut être un ID de cookie utilisé pour identifier les utilisateurs sur un site qui a des utilisateurs anonymes, par exemple.

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Changer le niveau d’importance d’un type d’événement d’utilisation

La propriété de type d'événement d'utilisation RecommendationWeight est une valeur numérique qui indique le niveau d'importance d'un type d'événement d'utilisation en comparaison à d'autres types d'événement d'utilisation employés dans le calcul des recommandations. Le type d'événement d'utilisation par défaut Affichages dispose d'une valeur RecommendationWeight préconfigurée et définie sur 1. Les autres types d'événement d'utilisation par défaut ( Affichages en tant que recommendation, Clics en tant que recommandation et l'ensemble des types d'événement d'utilisation personnalisé) ont une valeur RecommendationWeight définie sur 0. Pour augmenter l'importance d'un type d'événement d'utilisation dans le calcul des recommandations, changez la valeur du paramètre RecommendationWeight. Le niveau d'importance disponible le plus élevé est 10.

Pour modifier le niveau d’importance d’un type d’événement d’utilisation

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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

Où :

  • <EventTypeId> est l’ID numérique du type d’événement d’utilisation pour lequel vous souhaitez modifier le poids (par exemple, 256).

  • <RecommendationWeightNumber> est le niveau d’importance que vous souhaitez appliquer au type d’événement utilisateur ( par exemple, 4.

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Modifier le critère de temps Récent pour un type d’événement d’utilisation

La propriété de type d'événement d'utilisation RecentPopularityTimeframe est une valeur numérique qui définit le critère de temps Récent dans le rapport Éléments les plus populaires. Ce rapport dévoile les éléments les plus populaires par type d'événement d'utilisation pour tous les éléments d'une bibliothèque ou d'une liste. Le rapport peut être trié selon les critères de temps Récent ou Toujours. Par défaut, le critère de temps Récent est défini sur les 14 derniers jours de chaque événement d'utilisation. Vous pouvez changer ce paramètre avec une période allant de un à 14 jours.

Pour modifier la période Récent pour un type d’événement d’utilisation

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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

Où :

  • <EventTypeId>est l’ID numérique du type d’événement d’utilisation pour lequel vous souhaitez modifier la période récent ( par exemple, 256 .

  • <TimeFrame> est la nouvelle période récent que vous souhaitez appliquer au type d’événement utilisateur ( par exemple, 7.

    Notes

    Le système met à jour toutes les modifications apportées au critère de temps Récent uniquement après exécution de la tâche du minuteur d'analyse d'utilisation.

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Activer et désactiver la journalisation des événements d’utilisation des utilisateurs anonymes

Les utilisateurs qui explorent le contenu d'un site sans se connecter sont appelés « utilisateurs anonymes ». Seul le type d'événement Affichages est activé pour la journalisation des utilisateurs anonymes. Par défaut, la journalisation des événements d'utilisation personnalisés est désactivée dans le cas des utilisateurs anonymes.

Pour activer la journalisation des événements d’utilisation des utilisateurs anonymes

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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

Où :

  • <EventTypeId> est l’ID numérique du type d’événement d’utilisation que vous souhaitez activer pour la journalisation des utilisateurs anonymes , par exemple, 256.

Pour désactiver la journalisation des événements d’utilisation des utilisateurs anonymes

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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)

Où :

  • <EventTypeId> est l’ID numérique du type d’événement d’utilisation que vous souhaitez désactiver pour la journalisation des utilisateurs anonymes , par exemple, 256.

    Notes

    Pour le type d'événement d'utilisation par défaut Affichages , la journalisation des utilisateurs anonymes est impossible.

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Obtenir le GUID SiteId et le GUID WebId pour un site

Vous pouvez utiliser les commandes PowerShell suivantes pour obtenir le GUID SiteId et le GUID WebId pour un site.

Pour obtenir le GUID SiteId et le GUID WebId pour un site

  1. Vérifiez que vous êtes membre :
  • du rôle serveur fixe securityadmin sur l'instance SQL Server.

  • du rôle de base de données fixe db_owner sur toutes les bases de données à mettre à jour ;

  • du groupe Administrateurs sur le serveur sur lequel vous exécutez les applets de commande PowerShell.

  • Ajoutez les appartenances qui sont nécessaires au-delà des minima décrits ci-dessus.

    Un administrateur peut utiliser la cmdlet Add-SPShellAdmin pour accorder les autorisations d'utilisation des cmdlets SharePoint Server.

    Notes

    Si vous ne disposez pas des autorisations, contactez votre administrateur d'installation ou votre administrateur SQL Server afin de les demander. Pour plus d'informations sur les autorisations PowerShell, voir Add-SPShellAdmin.

  1. Démarrez SharePoint Management Shell.

  2. À partir de l’invite de commandes PowerShell, entrez la commande suivante :

# 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

Où :

Notes

Nous vous recommandons d'utiliser Windows PowerShell pour les tâches d'administration en ligne de commande. L'outil en ligne de commande Stsadm a été abandonné, mais il est inclus pour assurer la compatibilité avec les versions précédentes.

Voir aussi

Concepts

Affichage des rapports d’utilisation dans SharePoint Server

Autres ressources

Comment afficher les recommandations et les éléments populaires sur un site SharePoint Server 2013