Compartir a través de

Informes de CsAVConferenceTime

  • Artículo

Los URI de REST CsAVConferenceTime * proporcionan estadísticas de resumen acerca de la cantidad de tiempo que dedicaban a los usuarios registrados en las conferencias de Lync Online de Office 365 que incluyen audio o vídeo. Existen tres informes que use la misma estructura general y a continuación, sólo se diferencian en el intervalo de tiempo durante los cuales resumen los datos: diaria, semanal y mensual. Por motivos de simplicidad, en este uno tema se detallan los tres informes.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

URI de 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]

Campos

Los siguientes campos pueden especificarse en las opciones de consulta de ODATA2 $select, $filter y $orderby . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos.

Nombre

Tipo WCF *

Tipo EDM *

[In/Out] ** descripción

Valores de ejemplo

Agregado en la versión de servicio

AVConferenceMinutes

long

Edm.Int64

[In/Out] El número de minutos empleado en las conferencias de audio en los informes de período que termina en el valor de fecha.

3330

2013-V1

Date

System.DateTime

Edm.DateTime

[In/Out] La fecha de finalización y la hora del período de notificación. Consulte las siguientes secciones para obtener más información acerca de los períodos de informes.

Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] El número de índice del registro del informe.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] El GUID de la organización.

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

2013-V1

TenantName

string

Edm.String

[In/Out] El nombre de la organización.

example.onmicrosoft.com

2013-V1

* Tipo WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio de Windows Communications Framework (WCF) en Visual Studio. El tipo de EDM hace referencia a los tipos de ADO.NET Entity Data Model (EDM) devueltos en los informes con formato Atom.

** [In/Out]: para obtener más información, vea los parámetros de entrada y salida columnas sección informe.

Comentarios

Para ser incluido en los recursos de conferencia reportados utilizados, como mínimo un participante debe participaron como su cuenta de usuario de la organización de Office 365.

Los participantes de la conferencia que se han asistir a través de dispositivos móviles como teléfonos o tabletas no se incluyen en los recuentos de hora de notificación. Por este motivo, si todos los participantes en una conferencia de uso de dispositivos móviles, que conferencia no se muestra en el informe.

Los recuentos de conferencia devueltos incluyen sólo las conferencias que se han organizado por un usuario de la organización. Cada conferencia se cuenta como una sola por categoría, independientemente del número de usuarios o invitados que participan. Debido a distintos planes de Lync Online no pueden incluir la capacidad de organizar conferencias, pero aún pueden tener la capacidad de participar en ellas, el número de las conferencias organizadas dentro de esa inquilino pudo haberse siempre devuelven cero.

Cada entrada en el informe incluye varios campos de metadatos. Para obtener más información, vea Metadatos comunes devueltos por el servicio web de informes de Office 365.

Los tres tipos de informe difieren sólo en la cantidad de tiempo que cubre de cada entrada del informe. El tiempo que se indica en el campo fecha representa el final del período de tiempo. Las fechas y horas se muestran en la zona horaria especificada en el encabezado de X-timezone HTTPS GET. Si no se especifica ninguna zona horaria, se usa la hora UTC. Informa de las duraciones de tiempo se calcula de la manera siguiente.

Nombre del informe

Cálculo de período de tiempo

Diaria (CsAVConferenceTimeDaily)

El día de presentación de informes se inicia en la medianoche con precisión (00: 00:00) y finaliza justo antes de medianoche (23.59:59.9999...) en ese mismo día. El último día que se notifiquen será el último día completo para la que los datos están disponibles y no incluirá el día actual. La fecha y hora devuelto en el campo Date representa el final de ese día informes.

Semanal (CsAVConferenceTimeWeekly)

La semana informes comienza a medianoche con precisión (00: 00:00), los primeros domingo y finaliza justo antes de medianoche (23:59:59.9999...) en la siguiente sábado por la noche. La entrada recientemente reportada es uno que incluya el día actual y, por lo tanto, normalmente se extienden más allá de cuando se solicita el informe. La fecha y hora devuelto en el campo Date representa el final de esa semana informes.

Mensual (CsAVConferenceTimeMonthly)

El mes informes se inicia en la medianoche con precisión (00: 00:00) en el primer día del mes y los extremos justo antes de medianoche (23.59:59.9999...) en el último día de calendario de ese mes. La entrada recientemente reportada es uno que incluya el día actual y, por lo tanto, normalmente se extienden más allá de cuando se solicita el informe. La fecha y hora devuelto en el campo Date representa el final de ese mes del informe.

Ejemplos

El par de solicitud y respuesta siguiente muestra cómo recuperar un informe de actividad de conferencia AV por mes en formato JSON. La opción de consulta $select solicita solo la fecha y el número de minutos. Tenga en cuenta que se devolvió informe solo un punto de datos para el 1 º de mayo de 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"
              }            
          ]        
      }    
  }

El par de solicitud y respuesta siguiente muestra cómo recuperar el recuento diario de minutos de conferencia AV usado, en los 14 días anteriores, en orden cronológico inverso. Al igual que la consulta anterior, éste solicita solo el recuento de Date y AVConferenceMinutes y solicita la información en formato Atom. El informe devuelve una entrada para cada día que contiene datos, por lo que en este caso la $top restricción se aplica a la última 14 "días que tienen datos", que no es necesariamente el mismo que la última 14 días. Para restringir el período del informe a una hora específica, use la opción de consulta $filter . Tenga en cuenta que los saltos de línea se agregaron a la solicitud y respuesta para mayor claridad.

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>

Parámetros de entrada y salida columnas de informe

Los indicadores de [In/Out] en la tabla campos tienen los significados siguientes:

  • Campos marcados [In] en los campos de tabla principalmente están diseñados para su uso en $filter=, $orderby= y otras opciones de consulta que restringen las entradas que se devuelve el informe. Campos marcados [In] en los campos de tabla puede ser incluyen la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.

  • Campos marcados [In/Out] en los campos de tabla puede utilizarse en Opciones de ($filter= y $orderby=) de la restricción de entrada y de selección de columna ($select=). Cuando uno de estos campos se incluye en la opción $select= , aparecerán en las entradas de informe y va a contener datos útiles cuando esté disponible.

Compatibilidad

Los informes de CsAVConferenceTimeDaily, CsAVConferenceTimeWeekly y CsAVConferenceTimeMonthly se introdujeron en Versión 2013-V1 del servicio de Office 365. Para obtener más información acerca de las versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de PowerShell correspondientes

Los informes de CsAVConferenceTime * devuelven la misma información que el cmdlet de Get-CsAVConferenceTimeReportWindows PowerShell. 

Permisos

La cuenta de tener acceso a los informes de debe tener permisos administrativos en esa organización Office 365. Si el informe está presente en el documento de descripción de servicio y el documento $metadata devuelve al usuario, a continuación, disponen de permisos para recuperar los datos desde el servicio web REST. Este informe requiere que el usuario que se asignará a la función de los destinatarios con permiso de vista. En la estructura de permisos Office 365 de forma predeterminada, los usuarios con los siguientes permisos de administrador pueden tener acceso a este informe: administrador del usuario, administrador global, Administrador de contraseñas, Administrador de servicio y Administrador de facturación.

Disponibilidad, la persistencia y la granularidad de datos

Información disponible a través de estos informes puede dividirse en períodos de un día, comienza a medianoche de la zona horaria que notifica la aplicación de llamada en el encabezado de X-timezone HTTP.

La información de este informe está disponible durante un período de un año, o hasta que se cancele la suscripción.

Los eventos se pueden retrasar por 24 horas antes de que aparezcan en un informe.