<back to all web services

MapDataRequest

The following routes are available for this service:
All Verbs/RestApi/Sitefinity/Analytics/GetMapData
All Verbs/RestApi/GetMapData
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class MetricItemDTO:
    name: Optional[str] = None
    display_name: Optional[str] = None
    value: float = 0.0
    unit: Optional[str] = None
    denominator_metric_name: Optional[str] = None
    nominator_metric_name: Optional[str] = None
    show_in_selector: bool = False


class Dimension(str, Enum):
    BROWSER = 'Browser'
    BROWSER_VERSION = 'BrowserVersion'
    CITY = 'City'
    CONTINENT = 'Continent'
    VISIT_COUNT = 'VisitCount'
    COUNTRY = 'Country'
    DATE = 'Date'
    DAY = 'Day'
    DAYS_SINCE_LAST_SESSION = 'DaysSinceLastSession'
    FLASH_VERSION = 'FlashVersion'
    HOSTNAME = 'Hostname'
    HOUR = 'Hour'
    DEVICE_CATEGORY = 'DeviceCategory'
    JAVA_ENABLED = 'JavaEnabled'
    LANGUAGE = 'Language'
    LATITUDE = 'Latitude'
    LONGITUDE = 'Longitude'
    MONTH = 'Month'
    NETWORK_DOMAIN = 'NetworkDomain'
    NETWORK_LOCATION = 'NetworkLocation'
    PAGE_DEPTH = 'PageDepth'
    OPERATING_SYSTEM = 'OperatingSystem'
    OPERATING_SYSTEM_VERSION = 'OperatingSystemVersion'
    REGION = 'Region'
    SCREEN_COLORS = 'ScreenColors'
    SCREEN_RESOLUTION = 'ScreenResolution'
    SUB_CONTINENT = 'SubContinent'
    USER_DEFINED_VALUE = 'UserDefinedValue'
    USER_TYPE = 'UserType'
    WEEK = 'Week'
    YEAR = 'Year'
    AD_CONTENT = 'AdContent'
    AD_GROUP = 'AdGroup'
    AD_SLOT = 'AdSlot'
    CAMPAIGN = 'Campaign'
    KEYWORD = 'Keyword'
    MEDIUM = 'Medium'
    REFERRAL_PATH = 'ReferralPath'
    SOURCE = 'Source'
    EXIT_PAGE_PATH = 'ExitPagePath'
    LANDING_PAGE_PATH = 'LandingPagePath'
    PAGE_PATH = 'PagePath'
    PAGE_TITLE = 'PageTitle'
    AFFILIATION = 'Affiliation'
    DAYS_TO_TRANSACTION = 'DaysToTransaction'
    PRODUCT_CATEGORY = 'ProductCategory'
    PRODUCT_NAME = 'ProductName'
    PRODUCT_SKU = 'ProductSku'
    TRANSACTION_ID = 'TransactionId'
    SEARCH_CATEGORY = 'SearchCategory'
    SEARCH_DESTINATION_PAGE = 'SearchDestinationPage'
    SEARCH_KEYWORD = 'SearchKeyword'
    SEARCH_KEYWORD_REFINEMENT = 'SearchKeywordRefinement'
    SEARCH_START_PAGE = 'SearchStartPage'
    SEARCH_USED = 'SearchUsed'
    EVENT_CATEGORY = 'EventCategory'
    EVENT_ACTION = 'EventAction'
    EVENT_LABEL = 'EventLabel'


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class MapDataRequest:
    dashboard_id: Optional[str] = None
    related_dashboard_id: Optional[str] = None
    metrics: Optional[List[MetricItemDTO]] = None
    filter: Optional[str] = None
    dimension: Optional[Dimension] = None
    js_start_date: Optional[str] = None
    js_end_date: Optional[str] = None
    selected_metric: Optional[str] = None
    region: Optional[str] = None
    site_id: Optional[str] = None
    start_date: datetime.datetime = datetime.datetime(1, 1, 1)
    end_date: datetime.datetime = datetime.datetime(1, 1, 1)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DimensionItem:
    value: Optional[str] = None
    name: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class SingleSerie:
    main_metric: Optional[MetricItemDTO] = None
    category_format: Optional[str] = None
    batch: bool = False
    is_category: bool = False
    series_name: Optional[str] = None
    series_dimensions: Optional[List[DimensionItem]] = None
    related_dimension: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DashBoardControl:
    control_type: Optional[str] = None
    attributes: Optional[Dict[str, str]] = None
    placeholder_id: Optional[str] = None
    display_name: Optional[str] = None
    series: Optional[List[SingleSerie]] = None
    dimension_name: Optional[str] = None
    related_dimension: Optional[List[str]] = None
    sortby_field: Optional[str] = None
    sort_asc: bool = False


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class KendoItem:
    category: Optional[str] = None
    values: Optional[Dict[str, float]] = None
    group: Optional[str] = None
    tooltip: Optional[str] = None
    dimensions: Optional[Dict[str, str]] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class GetDashboardData:
    controls: Optional[List[DashBoardControl]] = None
    layout_template_name: Optional[str] = None
    group_by: Optional[str] = None
    metric_names: Optional[List[MetricItemDTO]] = None
    error_message: Optional[str] = None
    needs_grouping: bool = False
    is_drill_down: bool = False
    date_items: Optional[List[KendoItem]] = None
    non_date_items: Optional[List[KendoItem]] = None
    totals_item: Optional[KendoItem] = None
    map_data_table: Optional[List[str]] = None
    is_map_request: bool = False
    series_sources: Optional[Dict[str, List[str]]] = None
    status_code: int = 0
    suppress_multiple_series: bool = False

Python MapDataRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /RestApi/Sitefinity/Analytics/GetMapData HTTP/1.1 
Host: www.asg.com.au 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<MapDataRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Infrastructure.Services.ServiceStackServices.Model">
  <DashboardId>00000000-0000-0000-0000-000000000000</DashboardId>
  <Dimension>Browser</Dimension>
  <Filter>String</Filter>
  <Metrics xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:MetricItemDTO>
      <d2p1:DenominatorMetricName>String</d2p1:DenominatorMetricName>
      <d2p1:DisplayName>String</d2p1:DisplayName>
      <d2p1:Name>String</d2p1:Name>
      <d2p1:NominatorMetricName>String</d2p1:NominatorMetricName>
      <d2p1:ShowInSelector>false</d2p1:ShowInSelector>
      <d2p1:Unit>String</d2p1:Unit>
      <d2p1:Value>0</d2p1:Value>
    </d2p1:MetricItemDTO>
  </Metrics>
  <Region>String</Region>
  <RelatedDashboardId>00000000-0000-0000-0000-000000000000</RelatedDashboardId>
  <SelectedMetric>String</SelectedMetric>
  <SiteId>00000000-0000-0000-0000-000000000000</SiteId>
  <jsEndDate>String</jsEndDate>
  <jsStartDate>String</jsStartDate>
</MapDataRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetDashboardData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Infrastructure.Services.ServiceStackServices.Model">
  <Controls xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:DashBoardControl>
      <d2p1:ControlType>String</d2p1:ControlType>
      <d2p1:DimensionName>String</d2p1:DimensionName>
      <d2p1:DisplayName>String</d2p1:DisplayName>
      <d2p1:PlaceholderId>String</d2p1:PlaceholderId>
      <d2p1:RelatedDimension xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>String</d4p1:string>
      </d2p1:RelatedDimension>
      <d2p1:Series>
        <d2p1:SingleSerie>
          <d2p1:Batch>false</d2p1:Batch>
          <d2p1:CategoryFormat>String</d2p1:CategoryFormat>
          <d2p1:IsCategory>false</d2p1:IsCategory>
          <d2p1:MainMetric>
            <d2p1:DenominatorMetricName>String</d2p1:DenominatorMetricName>
            <d2p1:DisplayName>String</d2p1:DisplayName>
            <d2p1:Name>String</d2p1:Name>
            <d2p1:NominatorMetricName>String</d2p1:NominatorMetricName>
            <d2p1:ShowInSelector>false</d2p1:ShowInSelector>
            <d2p1:Unit>String</d2p1:Unit>
            <d2p1:Value>0</d2p1:Value>
          </d2p1:MainMetric>
          <d2p1:RelatedDimension>String</d2p1:RelatedDimension>
          <d2p1:SeriesDimensions>
            <d2p1:DimensionItem i:nil="true" />
          </d2p1:SeriesDimensions>
          <d2p1:SeriesName>String</d2p1:SeriesName>
        </d2p1:SingleSerie>
      </d2p1:Series>
      <d2p1:SortAsc>false</d2p1:SortAsc>
      <d2p1:SortbyField>String</d2p1:SortbyField>
      <d2p1:attributes xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </d2p1:attributes>
    </d2p1:DashBoardControl>
  </Controls>
  <DateItems xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:KendoItem>
      <d2p1:Dimensions xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </d2p1:Dimensions>
      <d2p1:category>String</d2p1:category>
      <d2p1:group>String</d2p1:group>
      <d2p1:tooltip>String</d2p1:tooltip>
      <d2p1:values xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringdouble>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>0</d4p1:Value>
        </d4p1:KeyValueOfstringdouble>
      </d2p1:values>
    </d2p1:KendoItem>
  </DateItems>
  <ErrorMessage>String</ErrorMessage>
  <GroupBy>String</GroupBy>
  <IsDrillDown>false</IsDrillDown>
  <IsMapRequest>false</IsMapRequest>
  <LayoutTemplateName>String</LayoutTemplateName>
  <MapDataTable xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:ArrayOfstring>
      <d2p1:string>String</d2p1:string>
    </d2p1:ArrayOfstring>
  </MapDataTable>
  <MetricNames xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:MetricItemDTO>
      <d2p1:DenominatorMetricName>String</d2p1:DenominatorMetricName>
      <d2p1:DisplayName>String</d2p1:DisplayName>
      <d2p1:Name>String</d2p1:Name>
      <d2p1:NominatorMetricName>String</d2p1:NominatorMetricName>
      <d2p1:ShowInSelector>false</d2p1:ShowInSelector>
      <d2p1:Unit>String</d2p1:Unit>
      <d2p1:Value>0</d2p1:Value>
    </d2p1:MetricItemDTO>
  </MetricNames>
  <NeedsGrouping>false</NeedsGrouping>
  <NonDateItems xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:KendoItem>
      <d2p1:Dimensions xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </d2p1:Dimensions>
      <d2p1:category>String</d2p1:category>
      <d2p1:group>String</d2p1:group>
      <d2p1:tooltip>String</d2p1:tooltip>
      <d2p1:values xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringdouble>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>0</d4p1:Value>
        </d4p1:KeyValueOfstringdouble>
      </d2p1:values>
    </d2p1:KendoItem>
  </NonDateItems>
  <SeriesSources xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringArrayOfstringty7Ep6D1>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>
        <d2p1:string>String</d2p1:string>
      </d2p1:Value>
    </d2p1:KeyValueOfstringArrayOfstringty7Ep6D1>
  </SeriesSources>
  <StatusCode>0</StatusCode>
  <SuppressMultipleSeries>false</SuppressMultipleSeries>
  <TotalsItem xmlns:d2p1="http://schemas.datacontract.org/2004/07/Telerik.Sitefinity.Analytics.Server.Core.Domain.DTO">
    <d2p1:Dimensions xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Dimensions>
    <d2p1:category>String</d2p1:category>
    <d2p1:group>String</d2p1:group>
    <d2p1:tooltip>String</d2p1:tooltip>
    <d2p1:values xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringdouble>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>0</d3p1:Value>
      </d3p1:KeyValueOfstringdouble>
    </d2p1:values>
  </TotalsItem>
</GetDashboardData>