ChartDataProvider (英語)

ChartDataProviderコンポーネントを使用して、グラフ作成コントロールのデータを提供します。

ChartDataProviderコンポーネントは、MVCコントローラーに要求を行うことでデータを提供します。サーバー上のMVCコントローラーのURLを指定し、クエリ パラメーターを指定できます。また、日付範囲と時間解像度にフィルターを設定することもできます。時間分解能にフィルタを設定すると、日付はフィルタに従ってグループ化されます (日、週、月など)。

ChartDataProviderコンポーネントは、MVCコントローラーからすぐにデータを取得しません。ChartDataProviderコンポーネントにMVCコントローラーを呼び出すように指示する必要があります。

getData関数を使用して、MVCコントローラーにデータを要求します (たとえば、次のようにPageCode)。

var requestOptions =

{

parameters: "",

onSuccess: this.getDataCallback,

url: "/api/sitecore/speakcharting/chart/Data"

;

this.ChartDataProvider.viewModel.getData(requestOptions);

urlフィールドは、プロパティとしても設定できます (DataUrl)。コードとプロパティの両方で設定した場合、ChartDataProviderコンポーネントはコードで設定した値を使用します。parametersフィールドはオプションであり、空のままにしておくことができます。

ChartDataProviderコンポーネントがデータを正常に受信したときに呼び出す関数は、onSuccessを使用して指定できます。

MVCコントローラーは自分で実装する必要があります。 ChartDataProviderコンポーネントは、MVCコントローラーがデータをJSONオブジェクトとして返すことを想定しています。このJSONオブジェクトでは、次のプロパティが必須です。

"data":{

"dataSet":{

“data”: …

次の例は、有効なJSONオブジェクトを示しています。

{

"totalRecordCount":0,

"messages":

{

"id":100,

"messageType":"info",

"text":"Contact most likely to buy during next visit."

}

,

"pageNumber":1,

"pageSize":5,

"sorting":

{

"direction":"asc",

"field":"channel"

},

{

"direction":"asc",

"field":"device"

}

,

"filter":

,

"data":{

"dataSet":{

"visits":

{

"Channel":10,

"IsCampaign":true,

"Device":"",

"Location":"Copenhagen, Hovedstaden, Denmark",

"Value":"1024",

"PageViews":18,

"VisitDuration":"01:07:00",

"Recency":"2.00:00:00",

"StartDateTime":"2013-11-08T22:30:29.2274325Z",

"UserAgent":"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko)"

}

},

"localization":{

"fields":

{

"field":"channel",

"translations":{

"40":"RSS",

"0":"Unknown",

"15":"Search Engine - Organic Branded",

"20":"Direct",

"50":"Email",

"10":"Search Engine - Organic",

"90":"Paid",

"36":"Referred - Analyst",

"31":"Referred - Blog",

"34":"Referred - Community",

"33":"Referred - Conversations",

"32":"Referred - News",

"30":"Referred - Other",

"35":"Referred - Wiki"

}

}

}

}

}