Partager via

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

  • Article

S’APPLIQUE À :oui-img-132013 oui-img-162016 oui-img-192019 oui-img-seÉdition d’abonnement no-img-sopSharePoint dans 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 d’utilisation 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, consultez « Planifier l’analyse de l’utilisation, les événements d’utilisation et les recommandations » dans Recherche de plans pour les sites de publication intersites dans 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énements d’utilisation par défaut dans SharePoint Server. Vous pouvez créer jusqu’à 12 types d’événements d’utilisation personnalisée à 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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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ée que vous souhaitez 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é.

    Importante

    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

[!REMARQUE] 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é

Une fois que vous avez créé un type d’événement d’utilisation personnalisé, comme décrit dans Créer un type d’événement d’utilisation personnalisé, vous devez ajouter du code à l’endroit où l’événement se produit, par exemple, lorsqu’une page se charge ou lorsqu’un utilisateur clique sur un lien ou un bouton. Ces données sont ensuite envoyées au composant de traitement analytique, où elles sont enregistrées et traitées.

Si vous utilisez la publication intersites, où vous affichez le contenu du catalogue sur un site de publication, vous devez enregistrer l’événement d’utilisation sur 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ée

  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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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ée doit être journalisé( par exemple, un modèle d’affichage pour un composant WebPart recherche de contenu, puis 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 doit être journalisé, par exemple. https://contoso.com/faq

Pour ajouter du code pour enregistrer un événement d’utilisation personnalisée et remplacer les paramètres de 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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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ée doit être journalisé, par exemple, un modèle d’affichage pour un composant WebPart 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 détecté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.

  • <Guid WebId> 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 qui sert à identifier des utilisateurs sur un site qui accueille des utilisateurs anonymes.

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

Si vous souhaitez ajouter du code qui fait référence à un type d’événement d’utilisation par défaut(par exemple, des vues), vous devez ajouter du code à l’endroit où l’événement se produit.

Si vous utilisez la publication intersites, qui affiche le contenu du catalogue sur un site de publication, vous devez enregistrer l’événement d’utilisation sur 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 afin d’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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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ée doit être journalisé( par exemple, un modèle d’affichage pour un composant WebPart recherche de contenu, puis 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 Views .

  • <URL> est l’URL complète de l’élément dans lequel l’événement d’utilisation doit être journalisé, par exemple. https://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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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ée doit être journalisé, par exemple, un modèle d’affichage pour un composant WebPart Recherche de contenu. L’exemple ci-dessous montre comment remplacer le SiteId, le WebId et l’UserId actuels.
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 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 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 Views .

  • <URL> est l’URL de la propriété managé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.

  • <Guid WebId> 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, par exemple, être un ID de cookie qui sert à identifier des utilisateurs sur un site qui accueille des utilisateurs anonymes.

Notes

[!REMARQUE] 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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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 la pondération, par exemple 256.

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

Notes

[!REMARQUE] 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. Le rapport Éléments les plus populaires affiche 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, par exemple, les éléments les plus consultés dans une bibliothèque ou 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 remplacer cette valeur par une période comprise entre un et 14 jours.

Pour modifier la période récente 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 ;

  • 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

    [!REMARQUE] 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, consultez 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écente , par exemple 256.

  • <TimeFrame> est la nouvelle période récente 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

[!REMARQUE] 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 ;

  • 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 n’avez pas d’autorisations, contactez votre administrateur d’installation ou l’administrateur SQL Server pour demander des autorisations. Pour plus d’informations sur les autorisations PowerShell, consultez 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 ;

  • 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

    [!REMARQUE] 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, consultez 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 Views , vous ne pouvez pas désactiver la journalisation des utilisateurs anonymes.

Notes

[!REMARQUE] 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 d’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 ;

  • 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

    [!REMARQUE] 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, consultez 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ù :

  • <RootSiteURL> est l’URL du site racine que vous souhaitez obtenir le GUID SiteId et le GUID WebId de , par exemple. https://contoso.com/sites/catalog

  • <SubSiteLocation> est le reste du chemin de l'URL vers le sous-site après l'URL du site racine. Par exemple, si votre URL de site racine est https://contoso.com/sites/catalog et que votre URL de sous-site est https://contoso.com/sites/catalog/products, tapez products pour cet espace réservé.

Notes

[!REMARQUE] 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