Отчеты о CsConference *

  • Статья

Коды URI REST CsConference * предоставляют обобщенные сведения о число Office 365 конференций Lync Online. Число конференций, обнаруженных включает в себя только те организованы вошедшего в систему членом клиента. Существует три отчеты, которые отличаются только в интервал времени, через который они сведение данных и использовать же Общая структура: день, неделю и месяц. Для простоты в этой теме описаны три отчета.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceMonthly[?ODATA options]

Поля

В $select, $filterи $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.

Имя

WCF тип *

Тип EDM *

[В/Out] ** описание

Пример значения

Добавлено в версию обновления

ApplicationSharingConferences

long

Edm.Int64

[In/Out] Число приложений, общий доступ к конференции во время периода отчета.

1042

2013-V1

AVConferences

long

Edm.Int64

[In/Out] Номер аудио/видео конференций в отчетах.

Lync 2013

2013-V1

Date

System.DateTime

Edm.DateTime

[In/Out] Дата и время окончания отчетного периода. В следующих разделах Дополнительные сведения о отчетных периодов.

Краткий формат даты (например, 03/10/2013) или Дата и время в кавычки (например, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] Номер индекса записи отчета.

72

2013-V1

IMConferences

long

Edm.Int64

Число конференций обмен мгновенными сообщениями в отчетного периода.

14

2013-V1

TelephonyConferences

long

Edm.Int64

Число конференций телефонии в отчетного периода.

204

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] GUID организации.

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

2013-V1

TenantName

строка

Edm.String

[In/Out] Имя организации.

example.onmicrosoft.com

2013-V1

TotalConferences

long

Edm.Int64

Число конференций всех типов в отчетного периода.

12587

2013-V1

WebConferences

long

Edm.Int64

Число веб-конференции в отчетного периода.

5

2013-V1

* Тип WCF относится к типу данных .NET Framework, назначенный в поле при создании ссылки на службу Windows Communications Framework (WCF) в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** [In/Out]: для получения дополнительных сведений см входные параметры и сообщить о раздел столбцы выходные данные.

Замечания

Должны быть включены в переданные количество конференций, по крайней мере один участник необходимо участвовали в качестве учетной записи пользователя организации Office 365.

Участников конференции, у которых конференции с помощью мобильных устройств, например телефонов или планшетных компьютеров не включаются в отчет. По этой причине, если всех участников конференции использование мобильных устройств, что конференции, не отображаются в отчете.

Конференции число возвращаемых включать только конференций, которые были организованы пользователей организации. Каждой конференции учитывается только после по категориям, независимо от количества пользователей или Гости, участвовать. Так как различные планы Lync Online не могут содержать возможность организации конференций, но по-прежнему могут иметь возможность принимать участие в их, номер конференции, созданные в рамках этого клиента всегда легко может вернуть 0.

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Три типа отчетов отличаются только за время, описывающую каждой записи отчета. Время, указанная в поле Дата представляет окончания периода времени. Сообщает значения даты и времени в часовом поясе, указанном в заголовке X-timezone получить HTTPS. Если часовой пояс не указан, то используется время в формате UTC. Время, длительность, обнаруженных рассчитываются как указано в следующей таблице.

Имя отчета

Период времени вычисления

Ежедневно (CsConferenceDaily)

Работы с отчетами день начинается точно полночь (00:00) и заканчивающейся только что до полуночи (23.59:59.9999) в тот же день. Последний день, обнаруженных будет последнего полного дня, для которого данные недоступны и не будут включены в текущий день. Дата и время возвращаются в поле Date представляет конца дня работы с отчетами.

Еженедельно (CsConferenceWeekly)

Начала работы с отчетами недели в точно полночь (00:00) преждевременного в воскресенье и заканчивается перед полночь (23:59:59.9999) на следующих ночь суббота. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет конец данную неделю отчетов.

Ежемесячно (CsConferenceMonthly)

Работы с отчетами месяца начинается точно полночь (00:00) на первый день месяца и заканчивается перед полночь (23.59:59.9999) в последний календарный день месяца. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца.

Примеры

Следующий запрос и ответ пары показано, как получить отчет об активности конференции по месяцам в формате JSON.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceMonthly?$format=Json

{
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        CsConferenceMonthly(datetime'2013-05-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        CsConferenceMonthly(datetime'2013-05-31T00%3A00%3A00')",
                    "type":"TenantReporting.CsConferenceReport"
                  },
                "ID":"24984",
                "Date":"\/Date(1369958400000)\/",
                "TenantGuid":"b4225608-d90a-4289-a458-bc69587bc613",
                "TenantName":"ExampleTenantName",
                "TotalConferences":"19",
                "AVConferences":"12",
                "IMConferences":"13",
                "ApplicationSharingConferences":"4",
                "WebConferences":"15",
                "TelephonyConferences":"0"
              }
          ]
      } 
  }

Следующий запрос и ответ пары показано, как получить ежедневное число конференций (в обратном порядке-порядке), в формате Atom. Поскольку отчет возвращает данные только конференций фактически возникновения, при запросе записей «N», с помощью параметра $top дней, отчет возвращает последние N дней, которым пришлось конференций. Это не обязательно содержит то же, как получение «прошедшие N календаря дней». Помните, которые были добавлены символы перевода строки запроса и ответа для наглядности.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsConferenceDaily?
    $select=Date,TotalConferences,AVConferences,IMConferences,ApplicationSharingConferences,WebConferences,TelephonyConferences&
    $top=10&
    $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/CsConferenceDaily</id>
  <title type="text">CsConferenceDaily</title>
  <updated>2013-07-08T20:48:10Z</updated>
  <link rel="self" title="CsConferenceDaily" href="CsConferenceDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily(datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsConferenceReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T20:48:10Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:TotalConferences m:type="Edm.Int64">6</d:TotalConferences>
        <d:AVConferences m:type="Edm.Int64">5</d:AVConferences>
        <d:IMConferences m:type="Edm.Int64">4</d:IMConferences>
        <d:ApplicationSharingConferences m:type="Edm.Int64">3</d:ApplicationSharingConferences>
        <d:WebConferences m:type="Edm.Int64">6</d:WebConferences>
        <d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily
      (datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsConferenceReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T20:48:10Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:TotalConferences m:type="Edm.Int64">10</d:TotalConferences>
        <d:AVConferences m:type="Edm.Int64">7</d:AVConferences>
        <d:IMConferences m:type="Edm.Int64">6</d:IMConferences>
        <d:ApplicationSharingConferences m:type="Edm.Int64">1</d:ApplicationSharingConferences>
        <d:WebConferences m:type="Edm.Int64">8</d:WebConferences>
        <d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsConferenceDaily
      (datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsConferenceReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T20:48:10Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:TotalConferences m:type="Edm.Int64">3</d:TotalConferences>
        <d:AVConferences m:type="Edm.Int64">0</d:AVConferences>
        <d:IMConferences m:type="Edm.Int64">3</d:IMConferences>
        <d:ApplicationSharingConferences m:type="Edm.Int64">0</d:ApplicationSharingConferences>
        <d:WebConferences m:type="Edm.Int64">1</d:WebConferences>
        <d:TelephonyConferences m:type="Edm.Int64">0</d:TelephonyConferences>
      </m:properties>
    </content>
  </entry>
</feed>

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

  • Поля, отмеченные [In] в поля в таблице в основном предназначены для использования в $filter=, $orderby= и другие параметры запроса, ограничивающие вводимых данных в отчете. Поля, отмеченные [In] в поля в таблице может быть включен параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

  • Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении одно из этих полей в параметре $select= , они будут отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчеты о CsConferenceDaily, CsConferenceWeekly и CsConferenceMonthly были представлены в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями можно Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлеты PowerShell

Отчеты о CsConference * возвращать те же данные в командлет Get-CsConferenceReportWindows PowerShell. 

Разрешения

Учетная запись для доступа к отчетов из требуются права администратора в организации, Office 365. При наличии в документ описания службы и возвращается пользователю $metadata документа отчета они имеют разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями.

Степень детализации данных, сохранение состояния и доступности

Информация, доступная через этих отчетов можно разделить на один день периодов, начиная с полуночи часовой пояс, вызывающему приложению в заголовке HTTP X-timezone .

Сведения для этого отчета можно найти в течение одного года или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.