30日間の無料評価版をお試しいただけます。

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

概要

ページトップ
以下の項目では、DashXML とYellowfinコンテンツを使用して開発されたダッシュボードコンテンツのサンプルについて説明しています。使用可能な各ウィジェットタイプ、XML内での設定方法、カスタムCSSを使用したスタイルの適用方法について、取り上げています。

注意：これはあくまで、独自のダッシュボード要求に対応するために、DashXMLフレームワークの使用方法を把握するガイドにすぎません。

主要なXMLウィジェットタイプは、以下の通りに構成されています。

<application-definition>
    <sourcefilter></sourcefilter>
    <dashboard>
        <text></text>
        <exportlist>
            <export><export>
        </exportlist>
        <filter>
            <options>
                <summary><summary>
            </options>
        </filter>
        <report>
            <modal>
                <subcontent></subcontent>
            </modal>
            <filterMap></filterMap>
        </report>
        <modal>
            <subcontent></subcontent>
        </modal>
        <customhtml>
            <replacements></replacements>
        </customhtml>
        <subtab>
            <options>
                <subcontent></subcontent>
                <summary></summary>
            </options>
        <subtab>
    </dashboard>
</application-definition>

すべてのXML構造は、ウィジェットXMLのページで説明されています。

ダッシュボードウィジェット

ページトップ
ダッシュボードウィジェットは、ダッシュボードを製作する際に、各ページのコンテンツを定義するために使用されます。ダッシュボードは、表示、呼び出し、ページ上で使用、の他のすべてのウィジェットを持っています。ダッシュボードには、独自のCSSクラスによってスタイルが適用されたレポートを、必要な数だけ含めることができ、ダッシュボード全体にそのスタイルを適用することもできます。

出力の例

要素の例

<dashboard>

子要素値説明
id1

XML内でタブを特定するために使用するユニークな数字です。この数字は、タブを特定するために、URL内でも使用します。例えば、idが1の場合、URLは以下のようになります。

http://localhost:7171/DashboardPortal/dashboard.jsp?id=1

filter

 タブ上で使用するフィルターの詳細が含まれます。このシナリオでは、ダッシュボードコンテンツを制御する日付フィルターです。より詳細な情報は、日付を参照してください。

exportlist

 ダッシュボード、または個別のレポート上で使用されるすべてのエクスポートボタンの詳細が含まれます。より詳細な情報は、エクスポートボタンウィジェットを参照してください。

report

 タブ上に表示する単一レポートに関する情報が含まれます。より詳細な情報は、グラフを参照してください。

XMLの例

<application-definition>
    <dashboard>
        <id>1</id>
         
        <!-- Year Filters -->
        <filter>
            <sync>true</sync>
            <datatype>DATE</datatype>
            <name>dateFilter</name>
            <operator>BETWEEN</operator>
            <styleClass>topFilter</styleClass>
            <options>
                <title>All Time</title>
                <value>1900-01-01\|2100-01-01</value>
                <defaultOption>true</defaultOption>
            </options>
            <options>
                <title>Year</title>
                <typeCode>PREDEF</typeCode>
                <value>YEARTODATE</value>
            </options>
            <options>
                <title>Month</title>
                <typeCode>PREDEF</typeCode>
                <value>MONTHTODATE</value>
            </options>
            <options>
                <title>Custom</title>
                <prompt>true</prompt>
            </options>
        </filter>    
         
        <!-- Export Buttons (Print, PDF, XLS) -->
        <exportlist>
            <export>
                <styleClass>printExport</styleClass>
                <exporttype>PRINT</exporttype>
            </export>
            <export>
                <styleClass>pdfExport</styleClass>
                <exporttype>PDF</exporttype>
            </export>
        </exportlist>    
             
        <!-- Canvas Chart -->
        <report>
            <display>CHART</display>
            <uuid>898e21f9-5acd-4b03-943c-25feca2c23c2</uuid>
            <styleClass>canvasChart</styleClass>
            <filterMap>
                <filterUUID>071367c9-9cad-46c6-94d8-f4821c61d90e</filterUUID>
                <mapToFilter>dateFilter</mapToFilter>
            </filterMap>
        </report>    
 
    </dashboard>
    <!-- End of the Example -->  
</application-definition>

 

サブタブウィジェット

ページトップ
サブタブウィジェットは、単一のダッシュボード定義内で、コンテンツの異なる項目間を行き来するために使用します。これは、標準的なYellowfinインターフェイス内でサブタブがどのように機能するのか、と同様です。ボタンやドロップダウンリストを使用してタブを切り替えることで、ユーザーはスクリーン上に異なるコンテンツを表示することができます。

出力の例

要素の例

<subtab>

子要素値説明

styleClass

 

コンポーネントにスタイリングを適用するために使用する、CSSクラス名が含まれます。

name

 XML内で参照するためのサブタブの名前です。

options

 サブタブ内で表示されるコンテンツやレポートを定義するためのノードが含まれます。<options> ノードの説明を参照してください。

 

<options>

子要素値説明

title

Booking Stats

サブタブを選択するためのテキストラベルです。（レポートのサブタブセット間を切り替えるために使用します）

description

Email, Phone, and Website

サブタブのサブタブタイトルの下部に表示される説明文です。

icon

<![CDATA[<div class="subtabBookingIcon"></div>]]>

サブタブボタン内のアイコンを含む参照先を含めます。例：

< ! [ CDATA [ < div class = "subtabBookingIcon" > < / div > ] ] >

XMLの例

<!-- Start of Sub Tabs -->
<subtab>
    <styleClass>subTabs</styleClass>
    <name>Ski Team</name>
     
    <!-- Booking Stats Tab -->
    <options>
        <prompt>false</prompt>
        <title>Booking Stats</title>
        <description>Email, Phone, and Website</description>
        <icon><![CDATA[<div class="subtabBookingIcon"></div>]]></icon>
        <subcontent>
            <styleClass>subTabOne</styleClass>
            <name>Booking Stats</name>
             
            <!-- Canvas Chart -->
            <report>
                <display>CHART</display>
                <uuid>898e21f9-5acd-4b03-943c-25feca2c23c2</uuid>
                <styleClass>canvasChart</styleClass>
                <filterMap>
                    <filterUUID>071367c9-9cad-46c6-94d8-f4821c61d90e</filterUUID>
                    <mapToFilter>dateFilter</mapToFilter>
                </filterMap>
            </report>    
            <!-- Line Chart -->
            <report>
                <display>CHART</display>
                <title>Athlete Bookings over Time</title>
                <uuid>d1f779fb-7dbf-42e2-8e6a-bc7dc84ae04f</uuid>
                <styleClass>fullWidthChart</styleClass>
                <filterMap>
                    <filterUUID>a0bfc7f6-1550-4f4d-a3c5-031b20c1a942</filterUUID>
                    <mapToFilter>dateFilter</mapToFilter>
                </filterMap>
            </report>                    
        </subcontent>
    </options>
     
    <!-- Athletes Tab -->
    <options>
        <prompt>false</prompt>
        <title>Athletes</title>
        <description>Demographic &amp; Sales</description>
        <icon><![CDATA[<div class="subtabAthletesIcon"></div>]]></icon>
        <subcontent>
            <!-- Content Removed For Simplification -->      
             
        </subcontent>
    </options>
     
    <!-- Ski Camps Tab -->
    <options>
        <prompt>false</prompt>
        <title>Ski Camps</title>
        <description>Stats for each Site</description>
        <icon><![CDATA[<div class="subtabSkiCampsIcon"></div>]]></icon>
        <subcontent>
        <!-- Content Removed For Simplification -->
             
        </subcontent>
    </options>
</subtab>

CSSの例

/* sub tabs */
.subTabs {
    clear: both;
}
/* Sub Tab Button Selectors */
.subTabSelection {
    width: 228px;
    display: table;
    border-collapse: separate;
    table-layout: fixed;
    overflow: hidden;
    position: fixed;
    left: 0px;
    top: 127px;
    border-spacing: 0px 1px;
    background-color: #CCCCCC;
}
.subTabSelection .subTabSelector {
    display: table-row;
    background: #F9F9F9;
    cursor: pointer;
    position: relative;
}
.subTabSelection .subTabMain {
    height: 55px;
    overflow: hidden;
    position: relative;
    padding: 20px 10px;
}
.subTabSelection  .selected {
    background: #FFFFFF;
}
.subTabSelection  .selected  div{
    color: #393737;
}
.subTabSelection .subTabTitle {
    color: #393737;
    font-size: 20px;
    font-family: sourceSansPro, sans-serif;
    padding-left: 55px;
    padding-top: 3px
}
.subTabSelection .subTabDesc{
    color: #393737;
    font-size: 13px;
    line-height: 22px;
    padding-left: 55px;
}
.subTabSelection .subTabSummary {
    color: #393737;
    font-size: 18px;
    font-weight: bold;
}
.subTabSelection .subTabIcon {
    position: absolute;
    top: 20px;
    left: 5px;
    width: 55px;
    text-align: center;
}
.subTabSelection .subtabBookingIcon{
    background-image: url("../images/booking.png");
    height: 55px;
    width: 55px;
}
 
.subTabSelection .subtabAthletesIcon{
    background-image: url("../images/athlete.png");
    height: 55px;
    width: 55px;
}
 
.subTabSelection .subtabSkiCampsIcon{
    background-image: url("../images/camp.png");
    height: 55px;
    width: 55px;
}
.subTabSelector.selected .subtabBookingIcon{
    background-image: url("../images/bookingSelected.png");
    height: 55px;
    width: 55px;
}
 
.subTabSelector.selected .subtabAthletesIcon{
    background-image: url("../images/athleteSelected.png");
    height: 55px;
    width: 55px;
}
 
.subTabSelector.selected .subtabSkiCampsIcon{
    background-image: url("../images/campSelected.png");
    height: 55px;
    width: 55px;
}

テキストウィジェット

ページトップ
ダッシュボードのタイトルは、<text> XMLウィジェットを使用して実装することができます。これを実行するためには単純に、タイトルとして表示するテキストを含める必要があり、このテキストのスタイリングに使用するためのCSSクラス名も必要です。

出力の例

要素の例

 <text>

子要素値説明

styleClass

dashboardTitle

コンポーネントにスタイリングを適用するために使用する、CSSクラス名を含めます。

text

Ski Team Dashboardタイトル、説明、または他の用途として、ダッシュボード上に表示するテキストを含めます。

XMLの例

<!-- Dashboard Title Text -->      
<text>
    <styleClass>dashboardTitle</styleClass>
    <text>Ski Team Dashboard</text>
</text>

CSSの例

.dashboardTitle {
    color: #393737;
    font-size: 40px;
    float: left;
}

エクスポートボタンウィジェット

ページトップ
エクスポートボタンは、<exportlist> XMLウィジェットを使用することで、ダッシュボードやレポートを様々な書式でエクスポートすることができます。ここでは、どのエクスポート書式を使用可能にし、どのレポートをエクスポートするのか定義をする必要があります（XLS形式を使用している場合）。

出力の例

要素の例

<exportlist>

子要素値説明

export

 

ダッシュボードタブ上に表示する、エクスポートボタンを定義するノードを含めます。この例では、印刷、PDF、XLSボタンを表示しています。<filterMap> ノード説明を参照してください。

 

<export> (Print)

子要素値説明

styleClass

printExport

コンポーネントにスタイリングを適用するために使用する、CSSクラス名を含めます。この例では、各ボタンが異なるアイコンを持っているため、エクスポートの種類ごとにユニークなクラス子要素を使用しています。

exporttype

PRINT

ブラウザの印刷機能が、ダッシュボード全体を印刷するために呼び出すように指定しています。

 

<export> (PDF)

子要素値説明

styleClass 

pdfExport

コンポーネントにスタイリングを適用するために使用する、CSSクラス名を含めます。この例では、各ボタンが異なるアイコンを持っているため、エクスポートの種類ごとにユニークなクラスを使用しています。

exporttype 

PDF現在のダッシュボードが、PDF形式でエクスポートするように指定しています。

 

<export> (XLS)

子要素値説明

styleClass 

xlsExport

コンポーネントにスタイリングを適用するために使用する、CSSクラス名を含めます。この例では、各ボタンが異なるアイコンを持っているため、エクスポートの種類ごとにユニークなクラスを使用しています。

exporttype 

XLS単一レポートを、XLS形式でエクスポートするように指定しています。

reportuuid

39f8f49f-124b-4b36-a7f6-2f1ed9724c53XLS形式でエクスポートするレポートのUUIDです。

XMLの例

<!-- Export Buttons (Print, PDF, XLS) -->
<exportlist>
    <export>
        <styleClass>printExport</styleClass>
        <exporttype>PRINT</exporttype>
    </export>
    <export>
        <styleClass>pdfExport</styleClass>
        <exporttype>PDF</exporttype>
    </export>
    <export>
        <styleClass>xlsExport</styleClass>
        <exporttype>XLS</exporttype>
        <reportuuid>39f8f49f-124b-4b36-a7f6-2f1ed9724c53</reportuuid
    </export>
</exportlist>

CSSの例

/* Export Buttons */
.exportList {
    display: table;
    padding: 0px 15px;
    margin: 20px 0px 20px 0px;
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    font-size: 18px;
    color: #364149;
}
.exportLink {
    padding-right: 10px;
    cursor: pointer;
    display: table-cell;
}
.printExport:before {
    content: "\f02f";
}
.pdfExport:before {
    content: "\f1c1";
}
.xlsExport:before {
    content: "\f1c3";
}

フィルターウィジェット

ページトップ

日付

これらは、 <filter> XMLウィジェットを使用して実装することができます。各フィルターウィジェットは、定義されるオプションが最低でも一つ必要であり、ユーザーが適用する値を選択することができます。ここでフィルターを指定する方法には、4つのオプションがあります。カスタム、年、月、すべての時間です。年、月、すべての時間フィルターは、事前に定義された日付範囲を使用して設定されており、一方カスタムオプションは、ユーザーがカスタム範囲を特定できるようにするために、ユーザープロンプトとして特定されています。

出力の例

要素の例

<filter>

子要素値説明

sync

true

この設定をtrueにすると、このフィルターの値を他のダッシュボードに渡すことを許可することになります。

datatype

DATE

フィルターオプションを適用するために、日付タイプを返す必要がある。ということを指定しています。

name

dateFilter

値を受け取るレポート上で使用する<filterMap> ノードを識別するために使用しているフィルターの名前を含めます。

operator

BETWEEN

フィルターの演算子を指定します。これは、フィルターの値を渡したいレポート内で使用されている演算子と互換性がなければなりません。

BETWEENは、2つの値が想定されています。このオプションは、「〜の間」や「〜の間でない」に限らず、レポートに定義された演算子を使用する必要があります。

styleClass

topFilter

コンポーネントにスタイリングを適用するために使用する、CSSクラス名を含めます。

options

 コンテンツの表示と、考え得る値を定義するためのノードを含めます。ユーザーに表示される各オプションは、独自の<option>ノードを持つ必要があります。この例では、年、月、カスタムオプションを使用しています。<options>ノードの説明を参照してください。

 

<options> (Custom)

子要素値説明

title

Custom

フィルターに表示するラベルです。表示するテキスト名に適用されます。

prompt

true

このオプションを指定することで、ユーザーが値を入力できるようにします。事前に定義された値は持ちません。この例では、プロンプトを使用しているので、<value> ノードのために値を提供する必要はありません。フィルターが日付として定義されているため、ユーザーには日付選択カレンダーが表示されます。（これには、CSSを使用してスタイルを適用することができます）

 

<options> (Year)

子要素値説明

title

Year

フィルターに表示するラベルです。表示するテキスト名に適用されます。

typecode

PREDEF 

このオプションには、定義された日付範囲で、あらかじめ定義された値をフィルターに使用することを定義します。それから、<value> ノード内で、どの定義を使用するのか特定する必要があります。

value

YEARTODATE 

YEARTODATEは、現在の年の最初の日付から、現在の日付、という事前に定義された日付範囲を使用します。

 

<options> (Month)

子要素値説明

title

Month

フィルターに表示するラベルです。表示するテキスト名に適用されます。

typecode

PREDEF 

このオプションには、定義された日付範囲で、あらかじめ定義された値をフィルターに使用することを定義します。それから、<value> ノード内で、どの定義を使用するのか特定する必要があります。

value

MONTHTODATEMONTHTODATEは、現在の月の最初の日付から、現在の日付という事前に定義された日付範囲を使用します。

 

<options> (All Time)

子要素値説明

title

All Time

フィルターに表示するラベルです。表示するテキスト名に適用されます。

value

1900-01-01\|2100-01-01 ここでは、データセット内のすべてのデータを効果的に包括するために、日付範囲の設定を1900年1月1日から2100年1月1日までにとして定義しています。

defaultOption

true

ダッシュボードのデフォルト選択のオプションを指定します。デフォルトととして設定することができるのは、ひとつの<option> ノードのみで、残りはfalseにするか、このノードを省略します。

XMLの例

<!-- Year Filters -->
<filter>
    <sync>true</sync>
    <datatype>DATE</datatype>
    <name>dateFilter</name>
    <operator>BETWEEN</operator>
    <styleClass>topFilter</styleClass>
    <options>
        <title>All Time</title>
        <value>1900-01-01\|2100-01-01</value>
        <defaultOption>true</defaultOption>
    </options>
    <options>
        <title>Year</title>
        <typeCode>PREDEF</typeCode>
        <value>YEARTODATE</value>
    </options>
    <options>
        <title>Month</title>
        <typeCode>PREDEF</typeCode>
        <value>MONTHTODATE</value>
    </options>
    <options>
        <title>Custom</title>
        <prompt>true</prompt>
    </options>
</filter>

CSSの例

* Date Filters */
.topFilter {
    height: 24px;
    line-height: 24px;
    padding-top: 14px;
}
 
.topFilter .filterOption {
    text-align: center;
    float: right;
    color: #393737;
    cursor: pointer;
    width: 70px;
    margin-left: 5px;
    font-weight: bold;
}
 
.topFilter .selected {
    background-color: #393737;
    color: #FFFFFF;
}
 
.topFilter .filterOption .customEntry {
    background-color : #393737;
    color: #FFFFFF;
    position: absolute;
    overflow: hidden;
    z-index: 100;
    margin-top: 5px;
    width: 115px;
}
 
.topFilter .filterOption .customEntry  input{
    background-color : #FFFFFF;
    border: 0px;
    font-family: sourceSansPro, sans-serif;
    font-size: 14px;
    color: #393737;
    height: 24px;
    width: 70px;
    line-height: 24px;
    margin: 12px 12px 0px 12px;
    padding: 0px 10px;
    text-align: center;
}
 
 
/* Date Entry */
.submitCustom {
    float: left;
    line-height: normal;
    margin: 10px 3px 10px 12px;
}
 
.cancelCustom {
    float: right;
    line-height: normal;
    margin: 10px 12px 10px 3px;
}
 
/* Date Picker */
.ui-datepicker {
    background-color : #FFFFFF;
    border: 1px solid #393737;
    color: #393737;
    font-family: sourceSansPro, sans-serif;
    font-size: 14px;
    margin-top: 5px;
}
 
.ui-datepicker a{
    color: #393737;
}
 
.ui-datepicker .ui-datepicker-prev {
    left: 10px;
    top: 6px;
}
 
.ui-datepicker .ui-datepicker-next {
    right: 10px;
    top: 6px;
}
 
.ui-datepicker .ui-datepicker-prev:before {
    content: "\f104";
    color: #393737;
    display: inline-flex;
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    font-size: 18px;
    cursor: pointer;
}
 
.ui-datepicker .ui-datepicker-next:before {
    content: "\f105";
    color: #393737;
    display: inline-flex;
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    font-size: 18px;
    cursor: pointer;
}
 
.ui-datepicker .ui-datepicker-prev-hover:before {
    content: "\f104";
    color: #393737;
    display: inline-flex;
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    font-size: 18px;
    cursor: pointer;
}
.ui-datepicker .ui-datepicker-next-hover:before {
    content: "\f105";
    color: #393737;
    display: inline-flex;
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    font-size: 18px;
    cursor: pointer;
    text-align: right;
}
 
.ui-datepicker .ui-datepicker-prev-hover {
    left: 10px;
    top: 6px;
}
 
.ui-datepicker .ui-datepicker-next {
    text-align: right;
}
 
.ui-datepicker .ui-datepicker-next-hover {
    right: 10px;
    top: 6px;
    text-align: right;
}

ボタン

フィルターウィジェットは、ユーザーが選択可能なフィルターの値を表示するために使用するオプションです。各オプションには、タイトル、説明、アイコン、集計値を表示することができ、タイトル以外の表示は任意です。

出力の例

 

レポートウィジェット

ページトップ

モーダルウィンドウウィジェット

ページトップ

カスタムHTMLウィジェット

ページトップ

  • No labels