Rapports de CsAVConferenceTime

Article
11/14/2016

Les URI REST CsAVConferenceTime * fournissent un résumé des statistiques sur la quantité de temps passées par les utilisateurs connectés à des conférences Lync Online Office 365 inclus audio ou vidéo. Il existe trois 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 et mensuelle. Par souci de simplicité, les trois 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/CsAVConferenceTimeDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeMonthly[?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
AVConferenceMinutes	long	Edm.Int64	[In/Out] Le nombre de minutes consacrées à des conférences a/v dans la création de rapports période se termine par la valeur de Date.	3330	2013-V1
Date	System.DateTime	Edm.DateTime	[In/Out] La date de fin et l'heure de la période de rapport. Consultez les sections suivantes pour plus d'informations sur les périodes de rapports.	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 ressources de conférence signalée utilisés, au moins un participant doit ont participé en tant que compte d'utilisateur leur organisation Office 365.

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 les comptes de l'heure du 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.

Le nombre de conférences renvoyé inclut uniquement les conférences qui ont été organisées par un utilisateur de votre organisation. Chaque conférence est comptabilisée uniquement une seule fois par catégorie, quel que soit le nombre d'utilisateurs ou les invités qui participent. É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 trois 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 (CsAVConferenceTimeDaily)	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 (CsAVConferenceTimeWeekly)	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 (CsAVConferenceTimeMonthly)	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.

Exemples

La paire de demande et réponse suivante montre comment récupérer un rapport des activités de conférence a/v par mois au format JSON. L'option de requête $select demande simplement la Date et le nombre de minutes. Sachez que point de données qu'un rapport a été renvoyée, pour le 1er mai 2013.

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

  {
    "d":
      {
        "results":
          [            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeMonthly
                        (datetime'2013-05-01T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeMonthly
                        (datetime'2013-05-01T00%3A00%3A00')",
                    "type":"TenantReporting.CsAVConferenceTimeReport"
                  },
                "Date":"\/Date(1367366400000)\/",
                "AVConferenceMinutes":"37"
              }            
          ]        
      }    
  }

La paire de demande et réponse suivante montre comment récupérer le nombre de tous les jours de minutes de conférence a/v utilisé, 14 jours précédents, dans l'ordre inverse-chronologique. Comme la requête précédente, cette commande demande uniquement le nombre de Date et AVConferenceMinutes et demande les informations au format Atom. Le rapport renvoie une entrée pour chaque jour qui contient des données, afin que, dans ce cas, le $top restriction s'applique au dernier 14 « jours contenant des données », qui n'est pas nécessairement identique aux dernière pendant 14 jours calendrier. Pour restreindre la période de rapport à un moment spécifique, utilisez l'option de requête $filter . Sachez que les 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/CsAVConferenceTimeDaily?
  $select=Date,TenantName,AVConferenceMinutes&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'%20and%20
    Date%20lt%20datetime'2013-06-26T00: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/CsAVConferenceTimeDaily</id>
  <title type="text">CsAVConferenceTimeDaily</title>
  <updated>2013-07-08T23:41:28Z</updated>
  <link rel="self" title="CsAVConferenceTimeDaily" href="CsAVConferenceTimeDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">13</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">24</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">93</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-05T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-05T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">165</d:AVConferenceMinutes>
      </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 CsAVConferenceTimeDaily, CsAVConferenceTimeWeekly et CsAVConferenceTimeMonthly 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 CsAVConferenceTime * retourne les mêmes informations que l'applet de commande Get-CsAVConferenceTimeReportWindows 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.

Partager via