<< Click to Display Table of Contents >> マニュアル > サーバ作成ガイド > アクション編 > アクションリファレンス > サマリアクション(ロギング/集計/日報) > サマリアクションの設定ファイルとフォルダ構成 > タグフィールドマスタ |
タグフィールドマスタの定義
タグフィールドマスタ(fieldmaster_tag.csv)は、ロギング対象とするタグを定義するCSV形式のテキストファイルです。サマリアクションを使用する場合、開発者は本マスタファイルを必ず定義す必要があります。また、サマリマスタのルートログセクションのTagFieldMasterプロパティに、タグフィールドマスタのパス名を指定する必要があります。
タグフィールドマスタは1つのタグフィールドにつき1行で構成されます。例えば1000個のタグフィールドを扱いたい場合、タグフィールドマスタは1000行で構成されます。以下はタグフィールドマスタの設定例です。
タグフィールドマスタ(設定例)
[Name], |
[Tag], |
[DataType], |
[DecimalNum1], |
[SummaryType1], |
[SummaryParam1], |
C000, |
U01.F01.T000, |
standard, |
0, |
AVERAGE, |
, |
C001, |
U01.F01.T001, |
standard, |
0, |
AVERAGE, |
, |
C001, |
U01.F01.T002 |
standard, |
0, |
ADDINGCOUNT, |
"1000000,IGNOREZERO" |
ヘッダ名 |
説明 |
||||||||||||||||||||||||||||
[Name] |
フィールド名。サマリレポートやヒストリカルトレンドグラフなどから参照するときに使用する名前。名前が重複しないように設定して下さい。[Name]列を省略すると、[Tag]列がフィールド名として扱われます。 |
||||||||||||||||||||||||||||
[Tag] (必須) |
ログの対象となるタグパスです。 |
||||||||||||||||||||||||||||
[Comment] |
任意のコメントを含めることができます。 |
||||||||||||||||||||||||||||
[DataType] |
データの種別です。省略するとすべて"standard"として扱われます。 standard : 通常のデータ powerfactor00 : 力率 -0 ~ 1 ~ +0 powerfactor05 : 力率 -0.5 ~ 1 ~ +0.5 powerfactor00p : 力率 -0 ~ 100 ~ +0 powerfactor05p : 力率 -50 ~ 100 ~ +50 timesec : 秒(「時:分:秒」で表現されます) timemin : 分(「時:分」で表現されます) |
||||||||||||||||||||||||||||
[DecimalNum1] ~ [DecimalNum{n}] |
小数点桁数の指定です。 0以上 : 小数点桁数 -1もしくはなにも指定しない : 小数点桁数の指定無し |
||||||||||||||||||||||||||||
[SummaryType1] ~ [SummaryType{n}] |
集計方法の指定です。以下から選択します。タグ毎に集計方法を指定したい時に必須です。
|
||||||||||||||||||||||||||||
[SummaryParam1] ~ [SummaryParam{n}] |
集計方法に対するパラメータ。現在指定する必要があるのは積算カウンタ値(ADDINGCOUNT)のみです。集計方法として積算カウンタ値を利用しない場合は[SummaryParam]列は省略できます。
ADDINGCOUNTパラメータ書式 : CounterBorder [,IGNOREZERO] [,IGNOREOVERMAX:最大値] CounterBorder : 境界値(カウンタの最大値+カウンタの増分単位) IGNOREZERO : IGNOREZEROを指定すると0が無視される IGNOREOVERMAX:最大値 : 最大値以上変化した場合、無視する
例)境界値は以下のように設定します。 カウンタが0~99999かつ、1ずつカウントアップされる場合、「100000」とします。 カウンタの増分が小数の場合は次の様に設定します。例えば、カウンタの最大値が999.9かつ、カウンタの増分が0.1の場合、「1000」を指定します。
例)0を無視したい場合以下のように指定します。 100000, IGNOREZERO
※IGNOREZEROは予期せぬ0を受け取った場合、積算カウンタ値が1周分大きくなってしまうことを避けるためのパラメータです。0の時には積算カウンタ値は一時的には増分されませんが、次回の値が1以上に変化したとき0の分も増分します。
例)1000以上変化した場合、異常値として判別し無視する場合 100000,IGNOREOVERMAX:1000
|
||||||||||||||||||||||||||||
[TermOfValidity] |
ログを保存する有効期間の設定です。保存するタグ毎に有効期間書式番号、もしくは有効期間書式を指定します。有効期間外の時、ログを空値にする。何も指定しないとすべての期間が有効になります。有効期間書式番号はサマリマスタの[COMMON]で設定します。また書式についてもサマリマスタの[COMMON]のTermOfValidityDefinitionを参照して下さい。 |
||||||||||||||||||||||||||||
[ReportHeader1] ~ [ReportHeader{n}] |
レポートに設定するデフォルトのヘッダ文字列です。デフォルトのヘッダ文字をあらかじめ指定しておきたい場合利用します。実際のレポートのヘッダ文字列はレポートマスターファイル(summary_reportmaster.txt)に保存されます。 |
||||||||||||||||||||||||||||
[UserParam1] ~ [UserParam{n}] |
ユーザが自由に利用できるパラメータ文字列です。サマリレポートグリットコントロールのGetFieldMasterInfoメソッドでブラウザ側から取得できます。 |
以下は、サマリアクションのログ機能のみを利用する場合のタグフィールドマスターファイル最小構成です。
[Tag] U01.F01.T000 U01.F01.T001 U01.F01.T002
上例は[Name]列が省略されているため、ヒストリカルトレンドグラフなどクライアントから参照する際は、[Tag]列の定義内容を[Name]列として参照されます。
|
ルートログを複数定義する場合、タグフィールドマスタをそれぞれのルートログ用に分けて設定することができます。例えば、高速用ログと低速用ログを別々に取得したい場合、それぞれ別々のタグフィールドマスターファイルを定義することができます。タグフィールドマスターファイルのパスはサマリマスターファイルのルートログセクションと集計ログセクションのTagFieldMasterプロパティで指定します
例) [RAW1] TagFieldMaster=summary_fieldmaster_tag1.csv ... [RAW2] TagFieldMaster=summary_fieldmaster_tag2.csv ...
|
運用開始後にタグフィールドマスタを修正した場合、修正内容を適用するためには、Panel Serverをいったんオフラインにして、再びオンラインにする必要があります。
|