ファイルトリガーガイド

オペレーション名

ファイルトリガー

機能概要

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

Standalone版では使用できません。

監視イベントの種類

ファイルの新規作成時

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

発火イメージ

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

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

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

発火イメージ

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

ファイルの削除時

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

発火イメージ

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

プロパティ

ファイルトリガーの設定

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

実行内容の設定

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

実行オプションの設定

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

トリガー変数

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

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

主な例外

特にありません。

注意事項

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

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