SPUsageReportType Enumeration
Specifies the type of information returned in a usage report for a SharePoint site.
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No
Syntax
'Declaration
Public Enumeration SPUsageReportType
'Usage
Dim instance As SPUsageReportType
public enum SPUsageReportType
Members
Member name | Description | |
---|---|---|
url | Indicates URLs of pages that are visited or of pages for lists that are updated. Discussions about a page are counted as hits on that page. | |
user | Indicates users who visited the site. | |
os | Indicates the operating system used on the client computer. All usage data refers specifically to visits from referring URLs that are external to the site. | |
browser | Indicates the type of Web browser used to visit the SharePoint site. All usage data refers specifically to visits from referring URLs that are external to the site. | |
refUrl | Indicates external URLs through which users navigated to the SharePoint site. |
Remarks
In usage reports created by using one of the GetUsageData methods of the SPWeb class, the SPUsageReportType enumeration is used together with the SPUsagePeriodType enumeration to define the information returned. The following tables show the column names and describe the values returned for different combinations of report types and period types.
The period type is lastMonth and the report type is browser, os, refUrl, or user.
Column Name |
Browser, OS, Referrer URL, or User |
Total Hits |
Recent Month |
Most Recent Day |
Most Recent Day Hits |
Description |
The name and version of the browser, the name of the operating system, the absolute URL of the external site, or the user name (in other words, DOMAIN\User). |
The total number of times a document has been accessed on the site.* |
The total number of hits for the last 31 days.* |
The most recent day that the document has been hit.* |
The total number of hits on the most recent day.* |
The period type is day and the report type is browser, os, refUrl, or user.
Column Name |
Browser, OS, Referrer URL, or User |
Names for columns 1 to 32 are the month and day in the format mm dd. |
Description |
The name and version of the browser, the name of the operating system, the absolute URL of the external site, or the user name (in other words, DOMAIN\User). |
Hits on that day.* |
The period type is lastMonth and the report type is url.
Column Name |
Page |
Folder |
Total Hits |
Recent Month |
Most Recent Day |
Most Recent Day Hits |
Description |
The name of the page or file that was hit or List update when a list is updated. |
The site-relative path of the page or file, excluding the name. |
The total number of hits. |
The total number of hits for the last 31 days. |
The date the page or file was most recently accessed. |
The total number of hits for the most recent day. |
The period type is day and the report type is url.
Column Name |
Page |
Folder |
Names for columns 1 to 32 are the month and day in the format mm dd. |
Description |
The name of the page or file that was hit or List update when a list is updated. |
The site-relative path of the page or file, excluding the name. |
Hits on that day. |
* For Browser and OS, "hits" are replaced with "visits," which refer specifically to cases where a user has navigated to the site from a referring URL that is external to the site.