ファイルトリガー

オペレーション名

ファイルトリガー

機能概要

ファイルトリガーは、監視対象ファイルの新規作成・更新・削除イベント発生時にスクリプトを実行するトリガー機能です。

監視イベントの種類

ファイルの新規作成時

監視対象ファイルが新規に作成された場合に発火するトリガーです。

発火イメージ

トリガー発火前
トリガー発火タイミング

ファイルのタイムスタンプ更新時

監視対象ファイルが上書き・更新された場合に発火するトリガーです。

発火イメージ

トリガー発火前
トリガー発火タイミング

ファイルの削除時

監視対象ファイルが削除された場合に発火するトリガーです。

発火イメージ

トリガー発火前
トリガー発火タイミング

プロパティ

ファイルトリガーの設定

項目名	内容	備考
トリガー名	トリガーの名前を入力します。
監視イベント	トリガーで監視するイベントを選択します。 [ファイルの新規作成時]:(デフォルト) [ファイルのタイムスタンプ更新時]: [ファイルの削除時]:
すでに監視ファイルが存在していた場合実行する	すでに監視ファイルが存在していた場合にトリガーが発火するかどうかを選択します。 [チェックあり]: SkyOnDemand Server起動時やトリガーの登録/有効時にファイルが存在していた場合、トリガーが発火します。 [チェックなし]:(デフォルト) SkyOnDemand Server起動時やトリガーの登録/有効時にファイルが存在していた場合、トリガーが発火しません。	[監視イベント]に[ファイルの新規作成時]を選択した場合、有効になります。
監視ファイル	監視対象となるファイルのパスを入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	ファイルパスは絶対パスで指定してください。ディレクトリを監視対象にする場合は、[ディレクトリを監視対象とする]にチェックを入れてください。パス区切り文字「/」およびワイルドカード「」以外のSkyOnDemandファイルシステムの使用禁止文字は使用できません。ファイル名の指定には、ワイルドカード(「」(アスタリスク)のみ)が使用できます。
監視ファイル	参照するファイルシステムを選択します。 [SkyOnDemandファイルシステム]:(デフォルト) SkyOnDemand独自のファイルシステムを参照します。 [サーバローカルファイルシステム]: SkyOnDemand Serverが稼働しているOSのファイルシステムを参照します。	ファイルシステムについては、「SkyOnDemandファイルシステム」を参照してください。
ディレクトリを監視対象とする	[チェックあり]: [監視ファイル]で指定したディレクトリを監視対象とします。 [チェックなし]:(デフォルト) [監視ファイル]で指定したファイルを監視対象とします。
監視間隔(秒)	監視を行う間隔を秒単位で入力します。	デフォルト値は「10」です。
終了時オプション	実行スクリプト終了時のオプションを選択します。 [監視ファイルは削除しない]:(デフォルト) スクリプトの実行終了時に監視ファイルを削除しません。 [監視ファイルを削除する]: スクリプトの実行の正常終了/異常終了に関わらず、監視ファイルを削除します。 [正常終了時のみ監視ファイルを削除する]: スクリプトの実行が正常終了した場合のみ、監視ファイルを削除します。

実行内容の設定

項目名	内容	備考
トリガー所有者	作成するトリガーの所有者を選択します。	管理者権限を持ったユーザのみ選択できます。 (一般ユーザは自分以外を選択することはできません。)
実行ユーザ名	[スクリプト]で指定したスクリプトを実行するユーザを選択します。
パスワード	[実行ユーザ名]で指定したユーザに対応したパスワードを入力します。
サービス	トリガーで実行するスクリプトを含むサービスを選択します。	サービスとして登録されたプロジェクトが表示されます。
スクリプト	トリガーで実行するスクリプトを選択します。	[サービス]で指定したサービス内のスクリプトが表示されます。
スクリプト引数	[スクリプト]で指定したスクリプトに設定されているスクリプト入力変数が表示されます。	スクリプト出力変数は表示されません。スクリプトにスクリプト入力変数を設定し、使用する方法については、「入出力変数について」を参照してください。
スクリプト引数/変数名	スクリプト変数名が表示されます。	編集はできません。
スクリプト引数/型	スクリプト変数の型が表示されます。	編集はできません。
スクリプト引数/値	スクリプト変数の値を入力します。	[高度な操作]ウィンドウからトリガー変数および環境変数を指定できます。

実行オプションの設定

実行オプションの設定については、「実行オプションの設定」を参照してください。

トリガー変数

ファイルトリガーでは、トリガー変数から監視対象のファイルについての情報を取得することができます。
トリガー変数は、実行スクリプトのスクリプト入力変数の設定します。

トリガー変数名	値	内容	備考
ファイルパス	trigger.filepath	監視対象のファイルパスです。	指定例:${trigger.filepath}
ファイル名	trigger.filename	監視対象のファイル名です。	指定例:${trigger.filename}

仕様制限

[監視間隔(秒)]で指定した秒数以内に、複数のイベントが発生した場合、変化を検知できない場合があります。

例:[監視間隔(秒)]が「10」秒で、10秒以内にファイルが新規作成され、そのファイルが削除された場合
```
 トリガーの監視    監視                                                  監視
                    *----------------*----------------*-------------------*
 イベント                             新規作成         削除
```
上記の場合、監視間隔内で作成されたファイルの検知はできません。

監視を開始するタイミングは、トリガーを有効にした約1秒後となります。

監視ファイルのタイムスタンプが「0」(1970年1月1日0時0分0秒、GMT)で取得された場合、削除されたとみなします。

主な例外

ありません。

注意事項

トリガーの登録後、トリガーに設定されているサービスやスクリプトの状態が変更された場合(サービス名・スクリプト名の変更や、スクリプト変数の追加・削除など)、登録済みのトリガーにその変更は反映されません。
対象のトリガーのプロパティ設定ダイアログを開き、サービスやスクリプトの再選択を行ったあと[完了]ボタンを押下して再登録してください。

監視対象ファイルのイベントを検知するタイミングは、対象のファイルが存在するファイルシステムが、ファイルの新規作成・更新・削除を検知する仕様に依存します。
特に、サイズの大きいファイルに関しては、ファイルシステムによってイベントを検知するタイミングが大きく異なるため、ファイルに対する処理が終了する前にトリガーが発火することがあります。
イベント検知の動作を検証の上、使用することを推奨します。