イベント履歴
■ コントロール外観
■ 説明
デバイスのデータ変化アラーム設定で発生したアラームをアラーム履歴データベースから取得して、リストで表示するコントロールです。データ変化アラームの履歴はイベント履歴と言います。
日付と時刻を設定することで、その日付と時刻のイベント履歴を取得します。
表示するイベント履歴の期間を、部品上部のコンボボックスから選択します。選択できる項目は、本日、過去７日間、今週、時間指定です。
「本日」を選択すると、本日中に発生したイベント履歴を取得します。
「過去７日間」を選択すると、本日から過去7日間のイベント履歴を取得します。
「今週」を選択すると、日曜日の0時0分から本日までのイベント履歴を取得します。
「時間指定」を選択すると開始時間ボタンが表示されます。開始時間ボタンを押すと日付と時刻の設定が行えます。設定した日付と時刻から現在までのイベント履歴を取得します。
その他、詳細プロパティから、履歴の数によりページ分割を行う等の設定ができます。
イベント名称の末尾に*がある場合、デバイスから再送されてきたデータで検知されたアラームとなります。
□ フィルターダイアログ
部品の右上のフィルターボタンを押すことで、フィルター設定ダイアログボックスを表示することができます。
フィルター設定ダイアログボックスでは、表示するイベント名称と設備区分を設定できます。
□ csvダウンロードボタン
csvダウンロードボタンを押すことで、指定した日付範囲のイベント履歴をcsvファイルとしてダウンロードすることができます。但し、「開始時間」で日付を指定した場合に、開始日一日のイベントをダウンロードになります。
□ カラム名をクリックすることでリストのデータをソートする
リストヘッダーで列名をクリックすると、選択した列の内容に従ってリスト内のデータをソートすることができます。
■ イベント
このコントロールで使用できるイベントの一覧です。
| イベント名 | 値 | 説明 |
|---|---|---|
| !onTimeChange | string value |
表示期間を変更したときに発生するイベントです。 変数リンクに設定された変数に対し、1970年からの経過時間（ミリ秒）を用いて以下のフォーマットで出力します。 "開始時間","終了時間" |
■ プロパティ
このコントロールで使用できるプロパティの一覧です。
各コントロール共通のプロパティについては、共通項目ページをご参照ください。
| プロパティ名 | デフォルト値 | 説明 |
|---|---|---|
| BeginEndTime | 本日“0:00,23:59”の1970年からの経過時間（ミリ秒） |
取得開始時間と終了時間を1970年からの経過時間（ミリ秒）を用いて以下のフォーマットで設定が行えます。設定した日付と時刻のイベント履歴を取得します。 "開始時間","終了時間" 終了時間を設定しない場合、現在時刻が自動的に設定されます。 カレンダー部品の!onSelectイベントを利用して指定するのがお勧めです。 |
| bFireWhenTimeChanged | false | このコントロールのマウス/タッチによる操作以外の要因でBeginEndTimeの値が変わった場合に、!onTimeChangeイベントを発生させるかどうかを設定します。 |
■ 関数
このコントロールで使用できる関数の一覧です。
各コントロール共通の関数については、共通項目ページをご参照ください。
JavaScript入力領域において、this + ".関数名"と入力し、使用できます。
| 関数名 | 引数 | 戻り値 | 説明 |
|---|---|---|---|
| getBeginEndTime | - | string value |
取得開始時間と終了時間の1970年からの経過時間（ミリ秒）を以下のフォーマットで取得します。 "開始時間","終了時間" |
| setBeginEndTime | string value | - |
取得開始時間と終了時間を1970年からの経過時間（ミリ秒）を用いて以下のフォーマットで設定します。 "開始時間","終了時間" 終了時間を設定しない場合、現在時刻が自動的に設定されます。 指定できるのは分単位までです。 |
■ 詳細プロパティ
イベント履歴の詳細プロパティでは、表示形式や内容に関して設定できます。
□ タイトル文字色
タイトル文字の描画色を設定します。デフォルト値は"#607B8B"です。
□ タイトル背景色
タイトル背景の描画色を設定します。デフォルト値は"#FFC125"です。
□ 毎ページアイテム数
１ページに表示するアイテム数を設定します。
□ キャッシュページ
追加で取得するページ数を設定します。取得データ数は、デフォルトの３ページ+キャッシュページの設定値となります。
□ 自動更新周期
自動更新を行う周期を設定します。
□ 設備区分を表示
設備区分を表示するかどうかを設定します。デフォルト値は"有効"で、表示です。
□ 削除ボタンを表示
このプロパティを有効にすると、ユーザが管理者権限の場合のみ、部品に削除ボタンを表示します。