Partager via

Rapports de CsActiveUser

  • Article

Les URI REST CsActiveUser * fournissent des utilisateurs actifs Lync Online résumé des statistiques sur le nombre de Office 365 pendant la période du rapport. Pour être comptées, chaque utilisateur doit ont été consigné dans et en utilisant les ressources d'égal à égal ou d'une conférence durant la période du rapport. Il existe quatre rapports qui utilisent la même structure globale et diffèrent uniquement dans l'intervalle de temps pendant laquelle ils synthétisent les données : quotidienne, hebdomadaire, mensuelle et annuelle. Par souci de simplicité, les quatre rapports sont détaillées dans cette rubrique.

Dernière modification : jeudi 17 septembre 2015

S’applique à : Office 365

URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserYearly[?ODATA options]

Champs

Les champs suivants peuvent être spécifiés dans les options de requête de ODATA2 $select, $filter et $orderby . Tous les champs sont renvoyés si aucune option $select n'est fournie.

Nom

WCF Type *

Type EDM *

[In/Out] ** Description

Exemples de valeurs

Ajouté dans la version de service

ActiveUsers

long

Edm.Int64

[In/Out] Le nombre d'utilisateurs actifs pendant la période du rapport. Pour être inclus, chaque utilisateur doit avoir ouvert une session Lync Online et utilisé des ressources audio ou vidéos pendant la période du rapport.

1042

2013-V1

Date

System.DateTime

Edm.DateTime

[In/Out] La date de fin et l'heure de la période de rapport. Pour plus d'informations sur les périodes de rapports, consultez les sections suivantes.

Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] Numéro d'index de l'enregistrement du rapport.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] Le GUID de l'organisation.

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

string

Edm.String

[In/Out] Le nom de l'organisation.

example.onmicrosoft.com

2013-V1

* WCF Type fait référence au type de données .NET Framework affecté au champ lorsque vous créez une référence de Service Windows Communication Framework (WCF) dans Visual Studio. Le Type EDM fait référence aux types ADO.NET Entity Data Model (EDM) renvoyées dans les rapports au format Atom.

** [In/Out]: pour plus d'informations, consultez les paramètres d'entrée et sortie colonnes section d'état.

Notes

Pour être inclus dans les nombres signalés d'utilisateurs actifs, l'utilisateur de l'organisation doit participer sessions ou des conférences connectés au compte d'utilisateur organisation Office 365, à partir d'un ordinateur qui exécute le client Lync. De même, les participants de « invité » ne sont pas inclus dans les données du rapport.

Participants à la conférence qui ont été participer via des appareils mobiles tels que les téléphones ou les tablettes ne sont pas inclus dans le rapport. Pour cette raison, tous les participants à une conférence utilisent des périphériques mobiles, cette conférence n'apparaît pas dans le rapport.

Les heures de conférence renvoyés comprennent le temps passé dans uniquement les conférences qui ont été organisées par un utilisateur de votre organisation. Étant donné que différents plans Lync Online peut ne pas incluent la possibilité d'organiser des conférences, mais il peut conserver la possibilité d'y participer, le nombre de conférences organisées au sein de ce client pouvant retourner facilement toujours zéro.

Chaque entrée dans le rapport comprend plusieurs champs de métadonnées. Pour plus d'informations, voir Les métadonnées renvoyées par le service web de création de rapports Office 365.

Les quatre types de rapports diffèrent uniquement dans la quantité de temps qui couvre chaque entrée de rapport. L'heure indiquée dans le champ de Date représente la fin de la période de temps. Dates et heures sont indiquées dans le fuseau horaire spécifié dans l'en-tête de X-timezone obtenir le protocole HTTPS. Si aucun fuseau horaire n'est spécifié, l'heure UTC est utilisée. Les durées indiquées sont calculés de la manière suivante.

Nom du rapport

Calcul de la période de temps

Tous les jours (CsActiveUserDaily)

Le jour de création de rapports commence à minuit précisément (00: 00:00) et se termine juste avant minuit (23.59:59.9999...) sur ce même jour. Le dernier jour indiqué sera au dernier jour pour lequel les données sont disponibles et n'inclut pas le jour actuel. Date et heure renvoyée dans le champ Date représente la fin de la journée création de rapports.

Toutes les semaines (CsActiveUserWeekly)

La création de rapports commence à minuit précisément (00: 00:00), au plus tôt le dimanche et se termine juste avant le samedi soir suivant à minuit (23:59:59.9999...). L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de cette semaine de création de rapports.

Tous les mois (CsActiveUserMonthly)

Le mois de déclaration commence à minuit précisément (00: 00:00) sur le premier jour du mois et se termine juste avant le dernier jour du calendrier de ce mois à minuit (23.59:59.9999...). L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de ce mois de création de rapports.

Par année (CsActiveUserYearly)

L'exercice comptable commence à minuit précisément (00: 00:00) sur le 1er janvier de cette année civile et se termine juste avant minuit (23.59:59.9999...) le 31 décembre de cette même année civile. L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de ce mois de création de rapports.

Exemples

La paire de demande et réponse suivante montre comment récupérer un rapport qui répertorie le nombre d'utilisateurs actifs de Lync par semaine.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserWeekly?
    $select=Date,ActiveUsers&
    $format=Json

{
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-05T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-05T00%3A00%3A00')",
                    "type":"TenantReporting.CsActiveUserReport"
                  },
                "Date":"\/Date(1367712000000)\/",
                "ActiveUsers":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-12T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-12T00%3A00%3A00')",
                    "type":"TenantReporting.CsActiveUserReport"
                  },
                "Date":"\/Date(1368316800000)\/",
                "ActiveUsers":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-19T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserWeekly(datetime'2013-05-19T00%3A00%3A00')",
                    "type":"TenantReporting.CsActiveUserReport"
                  },
                "Date":"\/Date(1368921600000)\/",
                "ActiveUsers":"3"
              }
          ]
      }
  }

La paire de demande et la réponse suivante montre comment récupérer le nombre de tous les jours d'utilisateurs Lync actifs, pour les jours entre le premier mai et le 15 mai 2013, dans l'ordre chronologique inverse. Cette requête demande le décompte Date et ActiveUsers et demande les informations au format Atom. Sauts de ligne ont été ajoutés à la demande et de réponse pour plus de clarté.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserDaily?
  $select=Date,ActiveUsersCount&
  $filter=Date%20ge%20datetime'2013-05-01T00:00:00'%20and%20Date%20le%20datetime'2013-05-15T00:00:00'&
  $orderby=Date%20desc&
  $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom" 
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsActiveUserDaily</id>
  <title type="text">CsActiveUserDaily</title>
  <updated>2013-06-25T19:01:23Z</updated>
  <link rel="self" title="CsActiveUserDaily" href="CsActiveUserDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserDaily(datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsActiveUserReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T19:01:23Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:ActiveUsers m:type="Edm.Int64">5</d:ActiveUsersCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserDaily(datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsActiveUserReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T19:01:23Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:ActiveUsers m:type="Edm.Int64">5</d:ActiveUsersCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsActiveUserDaily(datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsActiveUserReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T19:01:23Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:ActiveUsers m:type="Edm.Int64">5</d:ActiveUsersCount>
      </m:properties>
    </content>
  </entry>
</feed>

Paramètres d'entrée et de colonnes de sortie de l'état

Les indicateurs [In/Out] dans la table champs ont les significations suivantes :

  • Les champs marqués [In] dans les champs de table sont principalement destinés à être utilisés dans $filter=, $orderby= et autres options de requête qui restreignent les entrées renvoie le rapport. Les champs marqués [In] dans les champs de table peut être inclus à l'option $select= et ils s'affichent dans les entrées de rapport, mais ils ne contiendront aucune donnée utile.

  • Les champs marqués [In/Out] dans les champs de table peut être utilisée dans les options de ($filter= et $orderby=) de restriction de l'entrée et de sélection de la colonne ($select=). Lorsque vous incluez un de ces champs dans l'option $select= , ils apparaissent dans les entrées de rapport et contient des données utiles lorsqu'elle est disponible.

Compatibilité

Les rapports de CsActiveUserDaily, CsActiveUserWeekly, CsActiveUserMonthly et CsActiveUserYearly ont été introduites dans Service Office 365 version 2013-V1. Pour plus d'informations sur le contrôle de version, consultez la rubrique Contrôle de version dans le service web de création de rapports Office 365.

Applets de commande PowerShell correspondant

Les rapports CsActiveUser * retourne les mêmes informations que l'applet de commande Get-CsActiveUserReportWindows PowerShell. 

Autorisations

Le compte que vous accédez aux rapports du doit disposer d'autorisations d'administration dans cette organisation Office 365. Si le rapport est présent dans le document de description de service et le document $metadata renvoyé à l'utilisateur, ils disposent des autorisations nécessaires pour récupérer les données à partir du service web REST. Ce rapport oblige l'utilisateur à affecter au rôle de destinataires en affichage seul. Dans la structure des autorisations Office 365 par défaut, les utilisateurs disposant des autorisations d'administrateur suivantes peuvent accéder à ce rapport : administrateur, administrateur général, le mot de passe et administrateur de facturation, administrateur de service, administrateur de gestion des utilisateurs.

Disponibilité, persistance et la granularité des données

Informations disponibles par le biais de ces rapports peuvent être séparées en périodes d'une journée, commençant à minuit du fuseau horaire signalé par l'application appelante dans l'en-tête de X-timezone HTTP.

Les informations de ce rapport sont disponibles pour une période d'un an, ou jusqu'à ce que l'abonnement est annulé.

Les événements peuvent être retardées par jusqu'à 24 heures avant qu'ils s'affichent dans un rapport.