# アラームマスタのフォーマット

マニュアル > サーバ作成ガイド > アクション編 > アクションの機能解説 > アラームサーバ > # アラームマスタのフォーマット |

アラームマスタのフォーマット

１）基本設定

•マスターファイル
アラームマスタは、アラーム条件が記述されたテキストファイル（CSV）です。テキストエディタやExcel等で作成、編集します。ここではマスターファイルのパスを指定します。

•タグアクセスパス
タグアクセスパスを指定すると、アラームマスタ内で使われる全てのタグ名の頭の文字列を省略できます。例えば、アクセスパスを「U01.F01.」とした場合、「(U01.F01.M0000 || U01.F01.M0001) && U01.F01.M0002」という発生条件は、頭の「U01.F01.」を省略して「(M0000 || M0001) && M0002」となります。

•タグダイレクトパスマーク
タグアクセスパスを指定すると、アクセスパス文字列がタグ名の頭に必ず付加されます。ある特定のタグのみアクセスパス文字列を付加したくない場合、タグダイレクトパスマークをタグ名の頭に付加します。
例）_U01!Alive
また、アクセスパスを「U01.F01.」とした場合、U02～をアラーム条件に含めたい場合などにも利用できます。

•簡易フォーマットを使用する
マスターファイルのフォーマットは通常フォーマットと簡易フォーマットの2種類あります。簡易フォーマットを使用する場合、「簡易フォーマットを使用する」をチェックします。簡易フォーマットはマスターファイルを簡潔に定義できるメリットがありますが、下記のデメリットがあります。特に理由がなければ通常フォーマットの使用を推奨します。
簡易フォーマットのデメリット：
・アラームメールの定義ができない
・タグコメントフィールドを定義できない

| Ver4.0Rev5以前のバージョンでは、簡易フォーマットしか定義することができませんでした。Rev6以降、アラームメール、タグコメントフィールドなどの機能が拡張され、通常フォーマット（新フォーマット）と簡易フォーマット（旧フォーマット）の2つのフォーマットが定義できるようになりました。

| アラームサーバーにタグアクセスパスを設定した場合、システムプロパティタグ（U01!Aliveなど）をそのままアラーム条件に含めることができません。タグアクセスパスを設定した状態でシステムプロパティタグをアラームに含めたい場合には、先頭にグダイレクトパスマークを付加します。グダイレクトパスマークであるのデフォルトは「_」（アンダーバー）です。 例）'_U01!Alive' == FALSE 「U01!Alive」などのシステムプロパティタグについては、「PLC通信エラーをアラーム監視する」を参照してください。

| タグアクセスパスを利用する場合、スタティックタグと混在できないため注意が必要です。合わせてユニットが分かれる場合は、タグアクセスパスは使用できないため、合わせて注意してください。

２）通常フォーマット

通常フォーマットの仕様は以下のとおりです。１行目はタイトル、２行目はフィールド名で３行目以降に各アラームの定義を行います。

1行目 | タイトル。分かりやすいように自由に文字を記述できます。
2行目 | フィールド名。フィールドのタイプを指定する。
3行目以降 | 各アラームの定義。

例）

アラームID,発生復帰,確認,発生条件,コメント0,コメント1,コメント2 | ←タイトル行
[ALARMID],[RECOVER],[ACK],[ONCONDITION],[CM0],[CM1],[CM2] | ←フィールド名
0,n,n,U01.F01.M0000,M0が異常です。,Line1,1 | ←アラームの定義
1,n,n,U01.F01.M0001,M1が異常です。,Line1,1
2,n,y,U01.F01.M0002,M2が異常です。,Line1,2

フィールド名の指定では、あらかじめ定められた文字列を大括弧（[]）で囲んで指定します。アラームマスタで使用可能なフィールド名は以下のとおりです。

フィールド名 | 解説
[ALARMID] | アラームIDはアラーム毎に割り振られるインデックス（文字）です。アラームIDは、アラームを識別するための番号（文字）で、様々な場面で利用されます。アラーム毎に一意に付加される番号（文字）のため、エラーコードのようなイメージで利用することができます。アラームIDに数値を割り当てるかわりに、タグ名などの文字を割り当てておくと、後からアラームを挿入、追加したい場合、重複しているかどうかを気にせずアラームマスタに定義できるので便利です。 また、本フィールドを省略した場合、0から始まる連番が自動的にIDとして付与されます。ただし、注意点として、アラームサーバーの運用以降にアラームマスタの途中に新たなアラームを挿入してしまうと、挿入したアラーム以降のアラームIDがずれてしまい、過去のアラームデータとの整合性が保てなくなる可能性があります。自動ID付与の状態のままで新しいアラームを追加したい場合は、必ずアラームマスタの末尾に追加してください。
[RECOVER] | 「発生・復帰」の有り／無しを、“y”か“n”で定義します。有りにすると、アラームの発生時と復帰時に別々のアラームイベントを発生させることができます。本フィールドを省略した場合、すべて「y」になります。
[ACK] | 「確認」の有り／無しを、“y”か“n”で定義します。有りにすると、画面からアラームの確認操作が行えます。本フィールドを省略した場合、すべて「y」になります。
[ONCONDITION] | アラームの発生条件です。本フィールドは必須定義です。例えば、TAG01がONしたときアラームを発生させたい場合、「TAG01」と記述します。又、発生条件として式を記述することもできます。 例えば「TAG01 * 2 > 10 || TAG02」のように条件を式で記述できます。 尚、アラームの発生条件にPLCとの通信エラーを含めることができます。定義の方法については「PLC通信エラーをアラーム監視する」を参照してください。
[OFFCONDITION] | アラーム復帰条件を任意に記述します。ここで指定した条件がFALSEになった時にアラームが復帰します。省略すると発生条件のFALSEで復帰とみなします。 例えば、発生条件をTAG01 > 10 復帰条件を TAG01 > 5とした場合、値が10以上になったときにアラームが発生し、５以下になるまでアラームは復帰しません。
[ONTIMER] | アラーム発生までのタイマです（秒）。指定した時間の間継続してONの時、アラーム発生とします。待ち時間以内に、発生条件が解除されるとアラームは発生しません。特に発生待ちタイマが必要ない場合は、本フィールドを省略します。
[OFFTIMER] | アラーム復帰までのタイマです（秒）。指定した時間の間継続してOFFの時、アラーム復帰とします。待ち時間以内に、復帰条件が解除されるとアラームは発生しません。特に復帰待ちタイマが必要ない場合は、本フィールドを省略します。
[OUTPUTTAG0:xxx] ～ [OUTPUTTAGn:xxx] | アラームの状態をタグにリンクしたい場合に設定します。xxxの部分には出力したいフィールド名を指定します。演算式を記述することもできます。 フィールド名については「フィールド名について」を参照してください、また、演算式構文については「演算式構文」を参照してください。 また、OUTPUTTAG0:xxx、OUTPUTTAG1:xxx、OUTPUTTAG2:xxx とすることにより複数のアラームの状態を別々のタグに出力できます。 例）[OUTPUTTAG0:[CM0]] 例）[OUTPUTTAG0:[STATE]] 例）[OUTPUTTAG0:[CONDID2]] 例）[OUTPUTTAG0:[ACK]] 例）[OUTPUTTAG0:[RECOVER]] 例）[OUTPUTTAG0:[STATE] + ":" + [CONDID2]] (注意1） [OUTPUTTAG0:CM0]などとすると、発生したときのコメントをタグに書き込めます。 例えばHIHI/HI/LO/LOLOなど同一AlarmIdにて複数の発生条件が設定されている場合、CM0の列にアラームのレベル値を入れておき、アラームの状態をタグとリンクさせることができます。ただしこのような場合、注意点が１点あります。アラーム復帰時は、コメントとしてとるべき値がないため、前回発生したときの状態の値が保持されます。復帰したときに0にしたい場合は下記のような記述にして下さい。 [OUTPUTTAG0:{[RECOVER]}{0},{default}{[CM0]}] ※上記の例のようにアラームのレベル値をタグに出力したい場合、 [OUTPUTTAG0:[STATE]]でも代用可能です。 (注意2) 出力するタグはPLCのタグにもリンクが可能ですが、アラームが大量発生した時にアラームの処理が遅くなるため、通常はメモリタグを作成し出力タグとして定義して下さい。
[MAIL] | アラームメールを送信したい場合、本フィールドを設定します。 アラームは発生、復帰、確認、変化と様々なタイミングがあります。どのタイミングでメールを送信したいかを[MAIL]フィールドで設定します。[MAIL]フィールドではアラーム毎に下記のキーワードを組み合わせて設定します。
キーワード | メール送信のタイミング
all | すべてのタイミングでメールを送信する。
new | アラームが発生した時メールを送信する。
recover | アラームが復帰した時メールを送信する。
ack | アラームが確認された時メールを送信する。
change | アラームが変化した時（LOLOからLOに変化した等）メールを送信する。
複数のタイミングで発生したい場合は、キーワードをスペース文字で区切りながら列挙します。例えばアラームが発生及び復帰したときメールを送信したい場合「new recover」になります。逆にメールを送信したくないアラームの場合は何も記述ません。 詳しくは「アラームメールを送信する」を参照して下さい。
[CM0] ～ [CMn] | 文字コメントです。コメントは必要なだけ自由に設定できます。
[CM0:TAG]　～ [CMn:TAG] | タグコメントには、アラーム発生時に任意のタグ値をコメントとして含めることができます。タグコメントは必要なだけ自由に設定できます。番号には文字コメントと重複する番号を指定することはできません。尚、タグコメントを使用する場合には、アラームマスタでの定義の他に、アラームサーバーアクション「保存項目」タブからタグコメント列を保存項目に追加してやる必要があります。詳しくは、本書中「タグの値をアラームコメントに含める」を参照して下さい。

| [ONCONDITION]はアラームマスタで必須の設定になります。それ以外のフィールドは、もし必要なければアラームマスタに記述する必要はありません。記述がない場合は、デフォルトの設定が採用されます。例えば、[ALARMID]のフィールドが無い場合、自動でIDが0から割り振られます。

| フィールドの順番は自由です。例えば、[ALARMID]を必ず左端に記述する必要があるわけではなく、先に[RECOVER]の列を記述してもかまいません。

| コメントなどの文字中に「,」を使用するときは、ダブルクォーテーションで囲みます（※Excelを使用している場合、「,」を使用すると自動的に保存時にダブルクォーテーションで囲まれます）。 例） 0,n,n,U01.F01.M0000,"M0が異常です。, 重要度[高]",Line1,1

下記は通常フォーマットで作成した、アラームマスタファイルの例です。

アラームID, | 発生条件, | コメント０, | コメント１, | コメント２
[ALARMID], | [ONCONDITION], | [CM0], | [CM1], | [CM2]
1, | M0, | ポンプ異常。, | Group1, | 1
2, | D0 > 10, | 高温異常。, | Group1, | 2
3, | M1, | モータ異常。, | Group2, | 1
4, | M2 && M3, | 水位異常。, | Group2, | 1
5, | D1> 80, | HIHIを超えました。, | Group3, | 2
5, | D1 > 60, | HIを超えました。, | Group3, | 2
5, | D0 < 20, | LOLOを超えました。, | Group3, | 2
5, | D0 < 40, | LOを超えました。, | Group3, | 2

アラームID 1では、発生条件としてM0を設定しています。M0がONになった時、このアラームは発生となります。

アラームID 4では、発生条件としてM2 && M3を設定しています。これは、M2とM3が両方ともONの時のみアラーム発生となります。その他、「M2 || M3」や「（M2 || M3）&& M4」などの複雑な条件を記述することもできます。

アラームID 5では1つのアラームに対し、4つの条件を定義しています（このように、複数行で定義することもできます）。4つの条件の内、どの条件を充たしてもアラームが発生します。このようなアラーム設定では、初回のアラーム発生から復帰までの間に他のアラーム条件を検出した場合、アラームタイプが“変化”のアラームレコードが作成されます。例えば、D1が58から62に変化した時に、アラームタイプは“発生”となります。その後、アラームが復帰することなくD1が80を越えた場合、アラームタイプが“変化”のアラームレコードが作成されます。この動作により、サマリ画面の表示では、「HIを超えました」というメッセージ表示が「HIHIを超えました」というメッセージに更新が行われます。アラーム履歴では、"new"（発生）、"recover"（復帰）、"ack"（確認）と同様に"change"（変化）というアラームタイプのレコードが追加されます。

| 使用できるオペレータ及び関数については「演算式構文」に基づきます。

| 「発生復帰無し」、「確認無し」として定義されたアラーム（このようなアラームを「イベントタイプ」と呼びます）は、アラームサマリ画面には表示されません。

| 「発生復帰無し」、「確認無し」のアラームでは、Panel Serverをオフラインからオンラインにした時、デバイスのアラーム条件が既にONになっていた場合、オンラインの直後にアラームが生成されます。同様に、デバイスのアラーム条件がONを保持したまま、再びPanel Serverをオンライン→オフライン→オンラインとすると、再びアラームが発生します。これは、イベントタイプのアラームが復帰情報を持たないからであり、正常な動作です。もし、Panel Serverをオンラインにする度にアラームが生成されてしまうのを防ぎたい場合は、発生復帰を有りとしてアラームを定義してください。この場合は、Panel Server側の設定を発生復帰有りアラームとしておき、Panel Browser側のアラーム画面で復帰を知らせるアラームの情報を非表示にすることで、イベント表示と同等の画面を作成することができます。

３）簡易フォーマット

簡易フォーマットを使用する場合、「簡易フォーマットを使用する」をチェックします。

各コンボボックス（アラームID、発生・復帰など）でフォーマットを決定します。アラームマスタでは、コンボボックスの選択に従い、下記の順番にカンマで区切って記述します。必要のないフィールドは、記述しません。コメントは必要な数の列を自由にアラームマスタ側に記述します。

フィールド | 解説
アラームID | 「マスターファイルで指定する」を選択した場合、必須。
発生・復帰 | 「マスターファイルで指定する」を選択した場合、必須。
確認 | 「マスターファイルで指定する」を選択した場合、必須。
発生待ちタイマ | 「マスターファイルで指定する」を選択した場合、必須。
復帰待ちタイマ | 「マスターファイルで指定する」を選択した場合、必須。
発生条件 | 必須。
復帰条件 | 「マスターファイルで指定する」を選択した場合、必須。
コメント0 | 自由。
コメント1 | 自由。
コメント2 | 自由。
… | …

例１）

すべて「マスターファイルで指定する」を選択し、コメントが2つ必要な場合、下記がアラームマスタのフォーマットになります。

「アラームID, 発生・復帰, 確認, 発生待ちタイマ, 復帰待ちタイマ, 発生条件, 復帰条件, コメント0, コメント1」

例２）

「アラームID」のみ「マスターファイルで指定する」を選択した場合で、コメントが１つ必要な場合、下記がアラームマスタのフォーマットになります。

「アラームID, 発生条件, コメント0」

見出し（１行目）を無視する

アラームマスタには１行目に見出しを含めることができます。マスタに見出しを含める場合には、このチェックを有効にしてください。

▪アラームID
アラームIDはアラーム毎に割り振られるインデックス番号（文字）です。アラームIDは、アラームを識別するための番号（文字）で、様々な場面で利用されます。アラーム毎に一意に付加される番号（文字）のため、エラーコードのようなイメージで利用することができます。
「マスターファイルで指定する」を選択した場合は、アラームIDとして自由な番号（文字）で割り振ることができます。この番号（文字）は、0から割り振る必要はなく、また連続である必要もありません。ただし、重複した番号（文字）は指定できません。アラームサーバーの運用が開始された後、アラームの編集、追加、挿入は可能ですが、IDの変更はできません。アラームIDに数値を割り当てるかわりに、タグ名などの文字を割り当てておくと、後からアラームを挿入、追加したい場合、重複しているかどうかを気にせずアラームマスタに定義できるので便利です。
「自動で割り振る」を選択すると、自動的にIDが割り振られ、マスターファイルにIDを指定する必要がなくなります。但し、アラームサーバーの運用以降にアラームマスタの途中に新たなアラームを挿入してしまうと、挿入したアラーム以降のアラームIDがずれてしまい、過去のアラームデータとの整合性が保てなくなる可能性があります。自動ID付与の状態のままで新しいアラームを追加したい場合は、必ずアラームマスタの末尾に追加してください。

▪発生・復帰
「マスターファイルで指定する」を選択すると、アラーム毎に発生・復帰が必要かどうかをマスターファイルで指定ができます。マスターファイルでは、発生・復帰が必要な場合は「y」、必要がない場合は「n」を指定します。
「発生・復帰が有りのアラームとする」を選択すると、すべてのアラームは発生・復帰有りとみなされ、マスターファイルに指定する必要がなくなります。
「発生・復帰が無しのアラームとする」を選択すると、すべてのアラームは発生・復帰無しとみなされ、マスターファイルに指定する必要がなくなります。

▪確認
「マスターファイルで指定する」を選択すると、アラーム毎に確認が必要かどうかをマスターファイルで指定ができます。マスターファイルでは、確認が必要な場合は「y」、必要がない場合は「n」を指定します。
「確認が有りのアラームとする」を選択すると、すべてのアラームは確認有りとみなされます。マスターファイルに指定する必要はありません。同様に、「確認が無しのアラームとする」を選択すると、すべてのアラームは確認無しとみなされます。この場合もマスターファイルに指定する必要はありません。

▪復帰条件
アラーム復帰条件を任意に指定することができます。ここで指定した条件がFALSEになった時にアラームが復帰します。例えば、発生条件をTAG01 > 10 復帰条件を TAG01 > 5とした場合、値が10以上になったときにアラームが発生し、５以下になるまでアラームは復帰しません。
「マスターファイルで指定する」を選択すると、アラーム毎に復帰条件をマスターファイル側で指定できます。「復帰条件を指定しない」を選択すると、発生条件の逆の条件を復帰とみなされ、この場合はマスターファイルで指定する必要はありません。

▪発生待ちタイマ
発生待ちタイマを指定すると、発生条件が待ち時間だけ保持し続けた場合のみ、アラームが発生します。待ち時間以内に、発生条件が解除されるとアラームは発生しません。
「マスターファイルで指定する」を選択すると、アラーム毎に発生待ちタイマをマスターファイル側で指定できます。時間の単位は秒で指定します。
「発生待ちタイマを指定しない」を選択するとこの設定を省略したものとみなし、この場合はマスターファイルに指定する必要はありません。

▪復帰待ちタイマ
復帰待ちタイマを指定すると、復帰条件が待ち時間だけ保持し続けた場合のみ、アラーム発生が発生します。待ち時間以内に、復帰条件が解除されるとアラームは発生しません。「マスターファイルで指定する」を選択すると、アラーム毎に復帰待ちタイマをマスターファイルで指定できます。時間の単位は秒で指定します。「復帰待ちタイマを指定しない」を選択すると、マスターファイルに指定する必要がなくなります。

以下は、簡易フォーマットでのアラームマスタの作成例です。すべてのアラームで、「発生・復帰」、「確認」があり、コメントとして、「メッセージ」「グループ」「重要度」の列を設けています。

アラームサーバー側の設定：

簡易フォーマット | チェック
見出し | 有り
アラームID | 「マスターファイルで指定する」を選択。
発生・復帰 | 「発生・復帰があるアラームとする」を選択。
確認 | 「確認があるアラームとする」を選択。
復帰条件 | 「復帰条件を指定しない」を選択。
発生待ちタイマ | 「発生待ちタイマを指定しない」を選択。
復帰待ちタイマ | 「復帰待ちタイマを指定しない」を選択。

アラームマスタファイルの例：

アラームID, | 発生条件, | コメント０, | コメント１, | コメント２
1, | M0, | ポンプ異常。, | Group1, | 1
2, | D0 > 10, | 高温異常。, | Group1, | 2
3, | M1, | モータ異常。, | Group2, | 1
4, | M2 && M3, | 水位異常。, | Group2, | 1
5, | D1> 80, | HIHIを超えました。, | Group3, | 2
5, | D1 > 60, | HIを超えました。, | Group3, | 2
5, | D0 < 20, | LOLOを超えました。, | Group3, | 2
5, | D0 < 40, | LOを超えました。, | Group3, | 2

アラームID 1では、発生条件としてM0を設定しています。M0がONになった時、このアラームは発生となります。

アラームID 4では、発生条件としてM2 && M3を設定しています。これは、M2とM3が両方ともONの時のみアラーム発生となります。その他、「M2 || M3」や「（M2 || M3）&& M4」などの複雑な条件を記述することもできます。使用できるオペレータや関数は「演算式構文」に基づきます。

アラームID 5では1つのアラームに対し、4つの条件を定義しています（このように、複数行で定義することもできます）。4つの条件の内、どの条件を充たしてもアラームが発生します。このようなアラーム設定では、初回のアラーム発生から復帰までの間に他のアラーム条件を検出した場合、アラームタイプが“変化”のアラームレコードが作成されます。例えば、D1が58から62に変化した時に、アラームタイプは“発生”となります。その後、アラームが復帰することなくD1が80を越えた場合、アラームタイプが“"変化”のアラームレコードが作成されます。この動作により、サマリ画面の表示では、「HIを超えました」というメッセージ表示が「HIHIを超えました」というメッセージに更新が行われます。アラーム履歴では、"new"（発生）、"recover"（復帰）、"ack"（確認）と同様に"change"（変化）というアラームタイプのレコードが追加されます。