オープンパラメータ

<< Click to Display Table of Contents >>

マニュアル > ライブラリ リファレンス > 画面ライブラリ > 画面ライブラリリファレンス > トレンドグラフ >

オープンパラメータ

トレンドグラフのオープンパラメータ

 

hint

オープンパラメータを利用した画面ライブラリの呼び出し方法については、「画面ライブラリのオープンパラメータについて」を参照してください。

 

本画面ライブラリには、以下のオープンパラメータが用意されています。

 

名称

パラメータ

説明

設定ボタンの表示非表示

IsConfig

 

設定ボタンの表示/非表示を指定します。

 

TRUE

 

設定ボタンを表示した状態で画面を開きます。

FALSE

 

設定ボタンを非表示にした状態で画面を開きます。

 

表示状態保持の有効無効

EnabledSaveConfig

設定メニューの「表示状態を保持」の有効/無効を指定します。

 

TRUE

 

当該メニューアイテムを有効な状態にします。

FALSE

 

当該メニューアイテムを無効にします。

 

attention

ModeパラメータにSEARCHまたはFILTERを指定して独自のペンを表示する場合は、本パラメータをFALSEとして呼び出すようにしてください。

 

 

リアルタイム更新

 

 

IsRealTime

 

トレンドグラフをリアルタイム表示するか否かを指定します。

 

TRUE

 

リアルタイム表示を有効にした状態で画面を開きます。

FALSE

 

リアルタイム表示を無効にした状態で画面を開きます。

 

選択方式

Mode

パラメータの選択方式のモードを文字列で指定します。省略すると「SELECT」として動作します。詳細については本ページ下部の「Modeパラメータの指定方法」を参照してください。

 

SELECT

 

通常のトレンド画面表示として画面を開き、GroupName、PenName、DataSourceパラメータで指定された条件に該当するグループ、ペンが選択された状態で表示します。

SEARCH

 

グループコンボボックスの先頭に「(INFO)」という一時的なグループを生成し、GroupName、PenName、DataSourceパラメータで指定された条件に該当するペンを当該グループに追加して表示します。その他のグループは通常どおり表示されます。尚、本モードを指定してトレンドグラフ画面を開くと、設定メニューの「ペン設定」の呼び出しは無効となります。

FILTER

 

グループコンボボックスに「(INFO)」という一時的なグループを1つのみ生成し、GroupName、PenName、DataSourceパラメータで指定された条件に該当するペンを当該グループに追加して表示します。その他のグループは表示されません。尚、本モードを指定してトレンドグラフ画面を開くと、設定メニューの「ペン設定」の呼び出しは無効となります。

 

attention

本パラメータにSEARCHまたはFILTERを指定して独自のペンを表示する場合は、EnabledSaveConfigパラメータをFALSEとして呼び出すようにしてください。

 

 

グループ名

GroupName

 

グラフに表示したいグループ名を文字列で指定します。本パラメータは上記のModeパラメータと組み合わせて使用します。詳細については本ページ下部の「Modeパラメータの指定方法」を参照してください。尚、DataSourceパラメータを指定した場合は本パラメータは無視されます。

 

1つのグループのみを指定したい場合は、以下のように記述します(※グループ名称は例です)。

 

"GroupName:group01"

 

複数のグループを指定したい場合は、カンマ区切りで以下のように記述します。

 

"GroupName:group01,group02,group03"

 

ペン名

PenName

 

グラフに表示したいペン名を文字列で指定します。本パラメータは上記のModeパラメータと組み合わせて使用します。詳細については本ページ下部の「Modeパラメータの指定方法」を参照してください。尚、DataSourceパラメータを指定した場合は本パラメータは無視されます。

 

1つのペンのみを指定したい場合は、以下のように記述します(※ペン名称は例です)。

 

"PenName:pen01"

 

複数のペンを指定したい場合は、カンマ区切りで以下のように記述します。

 

"PenName:pen01,pen02,pen03"

 

データソース名

DataSource

グラフに表示したいデータソース名(データソースパス)を文字列で指定します。指定されたデータソース名に基づいてペン設定情報を検索し、該当する全てのペンをグラフに表示します。本パラメータを使用する場合、指定されたデータソースに該当するペン情報がペン設定として登録されている必要があります。本パラメータはModeパラメータと組み合わせて使用します。詳細については本ページ下部の「Modeパラメータの指定方法」を参照してください。尚、本パラメータを指定した場合、GroupName、PenNameは無視されます。

 

1つのデータソースのみを指定したい場合は、以下のように記述します(※データソース名は例です)。

 

"DataSource:T01" ・・・ ロガーアクションなどの例

"DataSource:Summary.RAW::T001" ・・・ サマリアクションの例

 

複数のデータソースを指定したい場合は、カンマ区切りで以下のように記述します。

 

"DataSource:T01,T02,T03" ・・・ ロガーアクションなどの例

"DataSource:Summary.RAW::T001,Summary.RAW::T002,Summary.RAW::T003" ・・・ サマリアクションの例

 

フィルター時カラー

FilterColor

 

Modeパラメータに「FILTER」を指定した場合に、ペンの表示色をRGB書式の文字列で指定することができます。FILTER以外のモードが指定された場合、本パラメータは無視されます。

 

以下のように1つのみを指定すると、全てのペンの色が同じ色で表示されます。

 

"FilterColor:#FF0000"

 

以下のように複数の色をカンマ区切りで指定すると、AddPenされる順に色を指定することができます。

 

"FilterColor:#FF0000,#00FF00"

 

以下のように「ペン名称:色書式」の組み合わせで指定すると、ペン名称毎に色を指定することができます。

 

"FilterColor:ペン1:#FF0000,ペン2:#00FF00,ペン3:#FF0000"

 

開始時刻

StartDate

 

グラフの表示期間の開始日時を指定します。画面ライブラリの _DeteTimeFormat カスタムプロパティに設定されている日時書式に従った書式で指定してください。

本パラメータが指定されていない場合、EndDateで指定された日時およびTimeSpanで指定された秒数から開始日時を求めて表示します。

終了時刻

EndDate

 

グラフの表示期間の終了日時を指定します。画面ライブラリの _DeteTimeFormat カスタムプロパティに設定されている日時書式に従った書式で指定してください。

本パラメータが指定されていない場合、StartDateで指定された日時およびTimeSpanで指定された秒数から終了日時を求めて表示します。

グラフ表示スパン

TimeSpan

 

グラフ表示のタイムスパンを秒数で指定します。本パラメータが指定されていない場合は、該当するペングループに設定されているタイムスパンの設定に従います。

ペンリスト表示

IsGridDisplay

 

画面の下部に配置されているペンリスト(ペングリッド)の表示/非表示を指定します。

 

TRUE

 

ペンリストを表示した状態で画面を開きます。

FALSE

 

ペンロストを非表示にします。

 

ヘッダー表示

IsHeader

 

画面の上部に配置されている各種操作UI(コンボボックス、エディットボックス、ボタンなど)の表示/非表示を指定します。

 

TRUE

 

画面上部の各種操作UIを表示した状態で画面を開きます。

FALSE

 

画面上部の各種操作UIを非表示にします。

 

ライブラリユニーク名

LibraryUniqueName

 

同じ画面ライブラリを複数同時に登録するような場合に、本パラメータに識別子を指定します。指定する識別子はシステム全体でユニークな名前となるように設定する必要があります。

 

 

Modeパラメータの指定方法

Modeパラメータの設定内容により、GroupName、PenName、DateSourceパラメータを指定した際の各種動作は以下のようになります。

 

Modeパラメータの設定値

動作

SELECT

 

通常のトレンド画面表示として画面を開き、パラメータで指定された条件に該当するグループおよびペンが選択された状態で表示します。

 

グループコンボボックス

 

トレンドのペン設定に登録されている全てのグループをコンボボックスのアイテムに設定し、GroupNameパラメータで指定されたグループが選択された状態にします。GroupNameパラメータに何も指定されていない場合、先頭のグループが選択された状態となります。

ペンコンボボックス

 

該当するグループの全てのペンをコンボボックスのアイテムに設定し、PenNameパラメータで指定されたペンが選択された状態にします。PenNameパラメータに何も指定されていない場合、先頭のペンが選択された状態となります。

GroupNameパラメータ

 

表示時に選択状態とするグループ名を指定します。尚、パラメータに複数のグループ名が指定されていた場合、先頭で指定されたグループ名が選択状態となり、2つ目以降は無視されます。

PenNameパラメータ

 

表示時に選択状態とするペン名を指定します。尚、パラメータに複数のペン名が指定されていた場合、先頭で指定されたペンが選択状態となり、2つ目以降は無視されます。

DataSourceパラメータ

 

表示時に選択状態とするペンのデータソース名を指定します。尚、パラメータに複数のデータソース名が指定されていた場合、先頭で指定されたデータソースに該当するペンが選択状態となり、2つ目以降は無視されます。

 

SEARCH

 

グループコンボボックスの先頭に「(INFO)」という一時的なグループを生成し、GroupName、PenName、DataSourceパラメータで指定された条件に該当するペンを当該グループに追加して表示します。その他のグループは通常どおり表示されます。

 

グループコンボボックス

 

先頭に「(INFO)」という一時的なグループを生成して該当する全てのペンをまとめて表示します。その他のグループも通常どおり表示します。

ペンコンボボックス

 

条件に該当するペンを、[グループ名][ペン名]の書式でINFOグループに追加して表示します。その他のグループについては通常どおりペン名のみを表示します。

GroupName/PenNameパラメータ

 

グループ名とペン名を指定します。

 


GroupName

指定なし

GroupName

指定あり

PenName

指定なし

INFOグループに1本もペンが追加されていない状態で画面を開きます。

指定されたグループに登録されている全てのペンをINFOグループに追加して画面を開きます。

PenName

指定あり

指定されたペン名に該当するペンをINFOグループに追加して画面を開きます。

 

尚、複数のグループに同じ名前のペンが重複して登録されている場合は、ペン設定で先に登録されているペンを1本のみ表示します。

以下の条件に該当するペンをINFOグループに追加して画面を開きます。

 

GroupNameとPenNameが同数の場合

 

例)

GroupName:グループ1,グループ2,グループ3

PenName:pen1,pen1,pen5

INFOグループの内容:

  [グループ1][pen1]

  [グループ2][pen1]

  [グループ3][pen5]

 

GroupNameとPenNameの数が異なる場合

 

例)

GroupName:グループ1,グループ2

PenName:pen1,pen1,pen4,pen5

INFOグループの内容:

  [グループ1][pen1]

  [グループ2][pen1]

  [グループ1][pen4]

  [グループ2][pen5]

 

例)

GroupName:グループ1,グループ2

PenName:pen1,pen1,pen4,pen5,pen8

INFOグループの内容:

  [グループ1][pen1]

  [グループ2][pen1]

  [グループ1][pen4]

  [グループ2][pen5]

  [グループ1][pen8]

 

例)

GroupName:グループ1

PenName:pen1,pen2,pen4,pen5

INFOグループの内容:

  [グループ1][pen1]

  [グループ1][pen2]

  [グループ1][pen4]

  [グループ1][pen5]

 

例)

GroupName:グループ1,グループ2,グループ3

PenName:pen1

INFOグループの内容:

  [グループ1][pen1]

  [グループ2][pen1]

  [グループ3][pen1]

 

 

DataSourceパラメータ

 

トレンドのペン設定に登録されているペン情報のうち、指定されたデータソースに該当するペンをグラフに表示します。データソースがサマリアクションの場合は、データソース名の集計セクションの部分(RAW、DAY、MONTH、YEARなど)をワイルドカードに置き換えてあいまい検索を行い、該当するペンを表示します。複数のペンが該当する場合は、もっとも優先度の高い該当するペンのみを表示状態とし、他のペンは非表示の状態(トレンド画面下部のペンリストで「表示」のチェックを外した状態)で画面を開きます。尚、優先度の判定では、データソース名が完全に一致しているものが優先され、その他はペン設定の登録順に優先されます。

 

FILTER

 

グループコンボボックスに「(INFO)」という一時的なグループを1つのみ生成し、GroupName、PenName、DataSourceパラメータで指定された条件に該当するペンを当該グループに追加して表示します。その他のグループは表示されません。

 

グループコンボボックス

 

「(INFO)」という一時的なグループのみが表示されます。その他のグループは表示されません。

 

ペンコンボボックス

 

条件に該当するペンを、[グループ名][ペン名]の書式でINFOグループに追加して表示します。

GroupName/PenNameパラメータ

 

グループ名とペン名を指定します。指定方法と動作はSEARCHと同様です。

DataSourceパラメータ

 

トレンドのペン設定に登録されているペン情報のうち、指定されたデータソースと完全に一致するペンをグラフに表示します。尚、複数のペンが該当する場合は、ペン設定で先に登録されているペンが採用されます。