Compartir a través de

Informes de CsActiveUser

  • Artículo

Los URI de REST CsActiveUser * proporcionan estadísticas de resumen sobre el número de Office 365 Lync Online usuarios activos durante el período del informe. Para contar, cada usuario debe se ha iniciado sesión y el uso de los recursos de punto a punto o conferencia durante el período del informe. Existen cuatro 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, mensual y anual. Por motivos de simplicidad, en este tema se detallan los cuatro 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/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]

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

ActiveUsers

long

Edm.Int64

[In/Out] El número de usuarios activos durante el período del informe. Para ser incluidas, cada usuario debe haber iniciado sesión Lync Online y ha utilizado recursos de audio o vídeos durante el período del informe.

1042

2013-V1

Date

System.DateTime

Edm.DateTime

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

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 números de informes de usuarios activos, el usuario de la organización debe asistir a sesiones o las conferencias que se haya iniciado sesión en la cuenta de usuario de organización de Office 365, desde un equipo que ejecuta al cliente de Lync. De forma similar, los participantes de "Invitado" no se incluyen en los datos del informe.

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 el informe. 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 tiempos de conferencia que se devuelve incluyen el tiempo dedicado en sólo las conferencias que se han organizado por un usuario de la organización. 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 cuatro 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 (CsActiveUserDaily)

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 (CsActiveUserWeekly)

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 (CsActiveUserMonthly)

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.

Anual (CsActiveUserYearly)

El año de notificación que se inicia en la medianoche con precisión (00: 00:00) el 1 de enero de ese año natural y termina justo antes de medianoche (23.59:59.9999...) el 31 de diciembre de ese mismo año de calendario. 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 que incluya el número de usuarios activos de Lync por semana.

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"
              }
          ]
      }
  }

El par de solicitud y respuesta siguiente muestra cómo recuperar el recuento de usuarios activos de Lync, diario para los días entre el primero y el 15 de mayo de 2013, en orden cronológico inverso. Esta consulta solicita el recuento de Date y ActiveUsers y solicita la información en formato Atom. Saltos de línea se agregaron a la solicitud y respuesta para mayor claridad.

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>

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 CsActiveUserDaily, CsActiveUserWeekly, CsActiveUserMonthly y CsActiveUserYearly 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 CsActiveUser * devuelven la misma información que el cmdlet de Get-CsActiveUserReportWindows 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.