CsActiveUser * 報告

發行項
11/14/2016

CsActiveUser * REST Uri 提供摘要Office 365數目統計資料 Lync Online 的作用中使用者在報告期間。若要計算，每位使用者必須有已登入並在報告期間使用的對等或會議的資源。有四個報表，使用相同的整體結構和只能在他們掌控彙總資料的時間間隔之間的差異：每天、每週、每月及每年。為了簡化，四個報表詳細說明這一個主題。

前次修改時間: 2015年9月17日

適用於: Office 365

REST Uri

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]

欄位

您可以指定下列欄位中$select、 $filter及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。

名稱	WCF 類型 *	EDM 類型 *	[以/照] * * 描述	範例值	新增服務版本
ActiveUsers	Long	Edm.Int64	[納入/剔除]在報告期間的作用中使用者數。若要包含在內，每位使用者必須已登入 Lync Online 和具有報告期間，使用音訊或視訊資源。	1042	2013-V1
Date	System.DateTime	Edm.DateTime	[納入/剔除]結束日期與時間的報表期間。如需時程表期間的詳細資訊，請參閱下列各節。	簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間	2013-V1
ID	Long	Edm.Int64	[納入/剔除]報表記錄的索引編號。	72	2013-V1
TenantGuid	System.guid	Edm.Guid	[納入/剔除]組織的 GUID。	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	string	Edm.String	[納入/剔除]組織名稱。	example.onmicrosoft.com	2013-V1

* WCF 類型參照Visual Studio中建立 Windows Communications Framework (WCF) 服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。

* * [納入/剔除]：如需詳細資訊，請參閱在輸入參數並報告輸出欄] 區段中。

備註

要包含在作用中使用者的報告數字，組織使用者必須參加工作階段或會議登入 Office 365 組織的使用者帳戶，從執行 Lync 用戶端電腦。同樣地，「來賓」參與者並不包含在報告資料。

會議參與者所參加透過電話或平板電腦等行動裝置並不包含在報表中。此原因，如果所有參與者在會議中的都使用的行動裝置、會議不會在報表中顯示。

傳回的會議時間包含所組織的使用者所召集的會議中所花費的時間。因為不同 Lync Online 計劃可能不包含能夠召集會議，但可能仍有能力參與它們，組織內的租用戶的會議數目可能遇到了一律會傳回零。

在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊，請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。

四個報表類型不同只能隨著每個報告項目涵蓋的時間。Date 功能變數中報告的時間代表期結束的時間。日期及時間報告中的 HTTPS 取得X-timezone標頭中指定的時區。如果未不指定任何時區，則會使用 UTC 時間。時間持續報告以下列方式計算。

報表名稱	時間週期計算
每日() CsActiveUserDaily	報告每天午夜精準地啟動 (00:00:00) 結束之前在同一天的午夜 (23.59:59.9999...)。報告的最後一天就資料有可用的最後一個完整天因此將不會包含目前的日期。日期及時間Date ] 欄位中傳回代表該報表天結束。
每週() CsActiveUserWeekly	報表週午夜精準地啟動 (00:00:00)、早期在星期日結束之前在下列星期六晚上午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報告的週的結尾。
每月() CsActiveUserMonthly	報表的月份午夜精準地啟動 (00:00:00) 上的第一天的月和結束之前在該月的最後一個行事曆天的午夜 (23.59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。
每年() CsActiveUserYearly	報表年份午夜精準地啟動 (00:00:00) 年 1 月 1 日該行事曆年度和結束的之前在該相同的月曆年 12 月 31 午夜 (23.59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。

範例

下列的要求及回應配對示範如何擷取此報告會列出作用中的 Lync 使用者每週數。

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

下列的要求及回應配對示範如何擷取年 5 月第一個與 2013 年 5 月 15 日之間的天數的作用中的 Lync 使用者的每日計數反向先後順序。此查詢要求Date和ActiveUsers計數及要求 Atom 格式中的資訊。分行符號已新增至要求及回應以利檢視。

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>

輸入參數並報告輸出欄

在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義：

欄位中表格主要用於$filter=、 $orderby=及其他查詢選項限制報表會傳回的項目中的欄位中標示為 [中]。在欄位標示為 [In 包含$select= ] 選項，可以是資料表欄位和其出現在報表項目但他們會包含任何的有用資料。
欄位標記 [納入/剔除] 欄選取範圍 ($select=) 和項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項，將會出現在報表項目，且可用時將會包含有用的資料。

相容性

Office 365 service version 2013-V1中所引進的 CsActiveUserDaily、 CsActiveUserWeekly、 CsActiveUserMonthly 及 CsActiveUserYearly 報告。如需版本設定的詳細資訊，請參閱在「 Office 365 報告」 web 服務的版本控制。

對應的 PowerShell cmdlet

CsActiveUser * 報告傳回資訊與Get-csactiveuserreport Windows PowerShell指令程式相同。

權限

存取從報表的帳戶必須該Office 365組織中有系統管理權限。如果報表是出現在服務描述文件及 $metadata 傳回給使用者，他們會有從 REST web 服務擷取資料的權限。這份報告要求使用者指派給「僅檢視收件者」角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告：帳務管理員、全域管理員、密碼管理員、服務管理員及使用者管理管理員。

資料精確度、保存及可用性

透過這些報告提供的資訊可分為單日期間從時區 HTTP X-timezone標頭中呼叫的應用程式所報告的午夜十二點開始。

針對此報表之資訊的一年以上，或取消訂閱直到一段。

事件可能最多它們顯示在報表中前 24 小時的延遲。

共用方式為

CsActiveUser * 報告

REST Uri

欄位

備註

範例

輸入參數並報告輸出欄

相容性

對應的 PowerShell cmdlet

權限

資料精確度、保存及可用性

其他資源

共用方式為

CsActiveUser * 報告

REST Uri

欄位

備註

範例

輸入參數並報告輸出欄

相容性

對應的 PowerShell cmdlet

權限

資料精確度、 保存及可用性

其他資源

資料精確度、保存及可用性