タイムライン
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
タイムラインコントロールはイベントのタイムラインを表示します。これらのイベントはコントロールのDataプロパティで指定します。このコントロールで使うべきプロパティはDataプロパティだけです。
コントロールはイベントオブジェクトの配列を含むJavaScriptオブジェクトとしてデータを期待します。このデータをコントロールに渡す方法はいくつかあります:
- Dataプロパティをデータソースにバインドできます。このデータソースは自分で作成しなければなりません。
- PageCode JavaScriptでデータを構成し、このデータをコントロールに渡すことができます: app.Timeline1.set("data", data)。
タイムラインはこう見えます:
ユーザーはタイムラインをドラッグして他の期間を確認でき、スクロールでズームイン・ズームアウト(時間解像度の変更)や、タッチスクリーンデバイスのタッチイベントを使って タイムライン コントロールと操作することも可能です。
タイムラインには以下の部分が含まれています:
- タイムライン上部の赤いバーは Era バーです。例えば、連絡先のステータスが「Anonymous」から「Customer」に変わるなど、新しい時代が始まる重要なイベントを示すために使います。 タイムライン コントロールは、赤いバーのすぐ下にEraTextプロパティで指定したテキストを表示します。
- タイムラインは通常のイベントを垂直スティックで表現します。これらのイベントの画像を指定することができます。もし指定すると、 タイムライン コントロールがスティックの上にこの画像(例えば手)を表示します。
- 定量化可能なイベントは棒グラフで表されます。持続時間(Duration)、エンゲージメントバリュー(EngagementValue)、マネーバリュー(MonetaryValue)のバーがあります。バーの高さは現在見える他のバーとの相対的なものです。これらのイベントに対して画像を指定することができます。もし指定すると、 タイムライン コントロールの下部(例えば電話)にこの画像が表示されます。
データフォーマット
タイムラインコントロールにはJavaScriptオブジェクトの配列としてデータを提供する必要があります:
{ "dataSet":{ "journey": } }
ここで、journeyはイベントオブジェクトの配列です。これはイベントオブジェクトの例です:
{ "TimelineEventId": "8724ff0e-24e2-4980-a63c-ca3c07d39fff", "EventType": "Quantifiable", "ImageUrl": "phone.png", "DateTime": "2011-01-01T09:`04
`", "Duration": 13945000, "EngagementValue": 982, "MonetaryValue": 2067, "EraText": "Anonymous", "IndicatorImagePath1": "", "IndicatorImagePath2": "" },イベントの場は以下の表に示されます。
名称
概要
タイムラインイベントID
イベントのID。
イベントタイプ
Normal、 Quantifiable、または EraChange。上記の説明を参照してください。
画像URL(画像URL)
イベントの画像を指し示しています。上記の説明を参照してください。
デートタイム
イベントをタイムライン上のどこに配置すべきかを示します
期間
EventTypeが Quantifiableの場合、棒グラフのバーの一つとして表現される数値値。
エンゲージメントバリュー
EventTypeが Quantifiableの場合、棒グラフのバーの一つとして表現される数値値。
貨幣価値
EventTypeが Quantifiableの場合、棒グラフのバーの一つとして表現される数値値。
時代テキスト
EventTypeがEraChangeされたときにコントロール上部のEraバーに表示されるテキスト。
インジケーターイメージパス1
画像を指し示します。使用の場合、 タイムライン コントロールがバーの横に画像を表示し、イベントに関する視覚的な情報を提供します。
IndicatorImagePath2
画像を指し示します。使用の場合、 タイムライン コントロールがバーの横に画像を表示し、イベントに関する視覚的な情報を提供します。
追加のフィールドを追加して、好きな名前で呼ぶこともできます。 タイムライン コントロールはそのようなフィールドを無視します。
いくつかの重要な方法と性質
イベントのIDをselectSegmentIdメソッドに渡すことで、特定のイベントを選択できます:
app.Timeline1.viewModel.selectSegmentId("6ecb6136-aee4-4fa7-8b1d-1d3bf3e0f59b");
イベントを選択したら、次のイベントに移動できます:
app.Timeline1.viewModel.selectPreviousSegment(); app.Timeline1.viewModel.selectNextSegment();
現在選択されているイベントは以下の方法で取得できます:
app.Timeline1.get("selectedSegment")