パラメータ

本アクションを呼び出すイベントから、実行アクションのパラメータを指定することができます。

ダイアログ

■テキスト設定（ロガー（CSV）の場合）

▪ファイル名
ログを保存するファイル名を指定します。

▪拡張
ログ保存ファイル名の拡張設定です。
 

▪見出しを書き出す
ファイルの1行目に必ずファイルの見出しを書き出します。見出しに使われる文字列は、フィールド毎に設定したフィールド名です。

▪データを""で括る
データをダブルクォーテーションで括ります。

▪同名ファイル存在時
追加する：同名ファイルに追加書き込みします。通常はこちらの設定にします。
上書きする：古いファイルを削除し、新しいファイルを作成し新規に保存します。

▪フラッシュ設定
この設定は、複数のレコードをまとめてハードディスクに書き出すための機能で、長期運用の際などにハードディスクへの負担をできるだけ軽減したいというニーズに対しても有効な機能です。
１レコード毎に書き出しを行いたい場合、フラッシュ設定に「１」を指定します。この設定により、何らかの原因によって不意にPCの電源が切れた場合でも直前のデータまで確実に保存されます。また、ログファイルが外部から参照されるような場合でも、即座に最新のログが反映されます。ただし、１レコード毎にハードディスクへの書き込みが行われるため、ハードディスクへの負担が増えます。ハードディスクへの負担を軽減したい場合には、フラッシュの設定値を多めに設定してください。

■ログ詳細

▪データベースのメンテナンスを行う
詳しくは「DBのメンテナンス（自動削除）」を参照してください。
 

▪ログデータのキャッシュ
ログデータの最大キャッシュ数。キャッシュを利用することにより、正確なタイムスタンプのログが得られます。
データ収集で集められたログデータは、DBへ保存する前に一旦メモリ上のキャシュに保存されます。その後、随時DBへ保存されます。この仕組みにより、DBの負荷に影響されない安定したロギングが可能となります。
何らかの理由によりキャシュを利用したくない場合には、０を設定して下さい。なお、キャッシュ上に保存されている件数が設定値を超えた場合には、キャッシュのデータがDBに保存されるまで（キャッシュのデータ件数が設定値以下になるまで）待機します。

▪通信エラー発生時
通信エラーが発生したときのログの処理方法です。詳しくは「通信エラー発生時の設定」を参照してください。

▪定刻イベントの場合、スケジュールされた時刻を時刻フィールドに保存する
定刻イベントでデータログを行う場合、（たとえタイミングがずれたとしても）必ず定刻イベントのスケジュールと同じ時刻で時刻フィールドに対しログを行いたい場合、チェックを入れてください。
 

▪ＰＣの時刻が戻った時の処理（最終保存時刻より古いデータ保存要求があった時）
ＰＣの時刻合わせ等で時刻が戻された場合の処理です。詳細は「ＰＣの時刻が戻った時の処理」を参照してください。
 

■ヒストリカルデータサーバ

ロガーアクションはヒストリカルデータサーバ機能を持っています。「ヒストリカルデータサーバ」タブで設定する項目は自動的に判別されるため、通常は指定する必要はありません。この設定は、データ項目に「日付・時刻フィールド」が２つ以上含まれる場合に、どちらのフィールドを時系列として使用するのかを明示したい場合のみ指定して下さい。また、MSフィールドは、データベースにミリ秒のフィールドが存在するときのみ指定して下さい。MSフィールドを含めると、ヒストリカルトレンドグラフ上にミリ秒単位でグラフ表示が行えます。

■詳細設定

ロガーアクションの「処理が成功した時」と「処理が失敗した時」とは、ログデータがデータベースに正しく書き込まれたか否かを表すものです。この動作は、ログデータのキャッシュの設定内容によって以下のような動作となります。

•キャッシュの指定が0の時
データベースへのロギングが失敗した場合、「処理が失敗した時」のスクリプトが実行されます。

•キャッシュの指定が1以上の時
ログデータはキャッシュに保存されるため、この場合の処理は必ず成功になります（「処理が成功した時」のスクリプトが実行されます）。

■ODBC設定（ロガー(ODBC)の場合）

▪データソース・テーブル名
共通設定「ODBC設定」を参照ください。
データベースの選択で、「汎用」/「SQLServer」/「Oracle」/「MySQL」/「PosgreSQL」を選択します。汎用ではないデータベース製品を指定すると、それぞれのデータベース毎に処理が最適化され、各処理が高速化されます。

▪ODBCエラー時
ログを続行したい場合は、通常「データベースと再接続し、ログを続行する」を選択してください。

▪ODBCタイムアウト
ODBCとのタイムアウト待ち時間を指定します。

「詳細設定」タブでは、アクションの実行前などのタイミングでスクリプト（SC1）を実行したり、アクションの処理実行タイミングの調整（実行待ち時間の設定）を指定したりする事ができます。各アクションの詳細設定については「アクションの詳細設定タブの設定」を参照してください。

タグフィールド

タグの値を保存したいとき、タグフィールドを選択します。

▪タグ
ロギングを行いたいタグ名（例 U01.F01.T01）です。

▪キャッシュ値でログをとる
タグの値は、別途指定された「更新周期」でPLCから定期的に実デバイス値を読み込む事によって定期的に更新が行われます。この更新周期はロガーアクションの設定とは別のものです。
本項目にチェックを入れると、キャッシュ値によるロギングとなります。キャッシュ値のロギングでは、実デバイスの値ではなく、アクション実行時点のタグ値がロギングに使用されます。そのため、データ収集のための処理時間は非常に高速です。また、PLCとの通信はアクション実行の都度発生しないため、複数のロガーアクションを並列的に実行した場合でも安定したロギングが行えます。ただし、ログデータのタイムスタンプはタグの更新周期の範囲で過去のデータになります。
 
本項目のチェックを外すと、デバイス値によるロギングとなります。デバイス値によるロギングでは、ロガーアクションが実行される都度、PLCとの通信によってデータの収集を行います。その為、最もタイムスタンプが確実なデータを取得できます。単純にロガーアクション１つだけの処理しか行わない場合にはこの選択がベストです。
しかしながら、複数のロガーアクションで並列的にデバイス値を利用すると、処理タイミングによっては通信要求がバッティングしてしまい、後続の通信要求が待たされる場合があります。例えば、一定周期でログをとっていた場合などは、通信待ちにより定周期性が乱れる可能性があります。特別な理由がない限りは、キャッシュ値によるロギングを推奨します。

▪通信エラー時の処理
詳細は「通信エラー発生時の設定」を参照してください。

時刻フィールド

時刻の情報を保存したいとき、時刻フィールドを選択します。

▪コントロールパネルの設定を使用
OSの標準設定に従い時刻を作成します。0秒のとき秒が省略されます。0秒の時でも省略したくない時は、「フォーマットを指定する」を選択して「%Y%m%d %H%M%S」としてください。

▪フォーマットを指定する
時刻のフォーマットを指定します。

▪システムタイマーを使用する
1ms単位で増加するシステムタイマーの値（0～4294967295の値）です。4294967295を超えると0に戻ります。

▪「ms」を使用する
ms単位で時刻を取得したい場合に選択します。値は0～999でログされます。
通常の秒単位の時刻フィールドとmsのフィールド（計２つのフィールド）を組み合わせて使用すると、トレンドグラフにms単位で表示できます。

▪秒インデックスを保存する
同一秒内で記録されたデータにインデックスを付加する機能です。

定数フィールド

指定した値や空文字を保存したいとき、定数フィールドを選択します。

▪NULLを書き込む
何も書き込みません。

▪指定値を書き込む
指定された文字を書き込みます。

イベントフィールド

発生したイベントの情報を保存したいときイベントフィールドを選択します。

▪フィールドタイプ