Informes de CsP2PSession

Artículo
11/14/2016

Los URI de REST CsP2PSession * proporcionan resumen estadísticas sobre el número de sesiones de punto a punto de Office 365 Lync Online. 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/CsP2PSessionDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionMonthly[?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
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
P2PApplicationSharingSessions	long	Edm.Int64	[In/Out] El número de sesiones durante el período del informe de uso compartido de aplicaciones de punto a punto (P2P).	182	2013-V1
P2PAudioSessions	long	Edm.Int64	[In/Out] El número de sesiones de audio P2P durante el período del informe.	12	2013-V1
P2PFileTransferSessions	long	Edm.Int64	[In/Out] El número de sesiones de transferencia de archivos P2P durante el período del informe.	42	2013-V1
P2PIMSessions	long	Edm.Int64	[In/Out] El número de sesiones de mensajería instantánea de P2P durante el período del informe.	142	2013-V1
P2PVideoSessions	long	Edm.Int64	[In/Out] El número de sesiones de vídeo P2P durante el período del informe.	1562	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
TotalP2PSessions	long	Edm.Int64	El número de sesiones de P2P de todos los tipos en el período del informe.	12587	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 sesiones, como mínimo un participante debe han participado en la sesión como su cuenta de usuario de la organización de Office 365.

Los participantes de la sesión 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 sesión se encuentran en dispositivos móviles, esa sesión no se mostrará en el informe.

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 (CsP2PSessionDaily)	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 (CsP2PSessionWeekly)	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 (CsP2PSessionMonthly)	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 del grupo por día en formato JSON. Saltos de línea se agregaron a la solicitud y respuesta para mayor claridad.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,P2PVideoSessions,
    P2PApplicationSharingSessions,P2PFileTransferSessions&
  $format=Json

 {
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368144000000)\/",
                "TotalP2PSessions":"23",
                "P2PIMSessions":"12",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"1",
                "P2PApplicationSharingSessions":"2",
                "P2PFileTransferSessions":"1"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368403200000)\/",
                "TotalP2PSessions":"42",
                "P2PIMSessions":"16",
                "P2PAudioSessions":"18",
                "P2PVideoSessions":"7",
                "P2PApplicationSharingSessions":"3",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368489600000)\/",
                "TotalP2PSessions":"38",
                "P2PIMSessions":"18",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"3",
                "P2PApplicationSharingSessions":"7",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369180800000)\/",
                "TotalP2PSessions":"3",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"2"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369353600000)\/",
                "TotalP2PSessions":"2",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"1"
              }
          ]
      }
  }

El par de solicitud y respuesta siguiente muestra cómo recuperar el número de sesiones que se produjo cada día entre 20 de mayo y el 25 de mayo. Esta consulta 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/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,
    P2PVideoSessions,P2PApplicationSharingSessions,
    P2PFileTransferSessions&
  $filter=Date%20ge%20datetime'2013-05-20T00:00:00'%20and%20Date%20lt%20datetime'2013-05-26T00:00:00'&
  $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/CsP2PSessionDaily</id>
  <title type="text">CsP2PSessionDaily</title>
  <updated>2013-06-25T20:36:14Z</updated>
  <link rel="self" title="CsP2PSessionDaily" href="CsP2PSessionDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-22T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">3</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">2</d:P2PFileTransferSessions>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-24T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">2</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">1</d:P2PFileTransferSessions>
      </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 CsP2PSessionDaily, CsP2PSessionWeekly y CsP2PSessionMonthly 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 CsP2PSession * devuelven la misma información que el cmdlet de Get-CsP2PSessionReportWindows 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.

Compartir a través de