ユーザーフック

ユーザーフックはluaスクリプトとして組み込まれ、管理者の操作を自動化することで Dr.Web Server の特定のタスクのより早い実行を可能にします。

ユーザーフックの実行を設定するには

1.Control Center のメインメニュー内で 管理 を選択します。

2.開いたウィンドウのコントロールメニュー内で ユーザーフック を選択します。ユーザーフックの設定を行うためのウィンドウが開きます。

フックツリー

フックの階層的リストはツリー状になっています。ツリーのノードはフックのグループおよびそれらに含まれるユーザーフックです。

フックツリーには以下のグループがプリインストールされています：

•Examples of the hooks—あらゆるユーザーフックのテンプレートが含まれています。これらのテンプレートを基にして、カスタムのユーザーフックを作成することができます。

•IBM Tivoli integration—IBM Tivoliシステムとの統合に使用するユーザーフックのテンプレートが含まれています。

ツリーエレメントのアイコンはエレメントの種類や状態によって異なります（下の表参照）。

フックツリー内のエレメントのアイコン

フックツリーの管理

フックツリー内のオブジェクトを管理するには、ツールバーの以下の項目を使用します：

- フックツリーにエレメントを追加するためのドロップダウンリストです：

フックを追加—新しいユーザーフックを追加します。

フックグループを追加—フックを中に含ませるための新しいユーザーグループを追加します。

選択したオブジェクトの削除—フックツリー内で選択されたユーザーフックまたはフックグループを削除します。

フックの実行を有効にする—フックエディタ内で フックの実行を有効にする にチェックを入れた場合と同じアクションが実行されます。フックの有効化 を参照してください。

フックの実行を無効にする—フックエディタ内で フックの実行を有効にする のチェックを外した場合と同じアクションが実行されます。フックの有効化 を参照してください。

フックグループの管理

新しいグループを作成するには

1.ツールバーで、 → フックグループを追加 を選択します。

2.表示されたウィンドウで以下のパラメータを設定しください：

•このグループ内に含まれるフックを有効化するには フックの実行を有効にする にチェックを入れてください（フックの有効化 参照）。

•グループ名 フィールドで、作成するグループに任意の名前を指定してください。

3.保存をクリックします。

グループの順番を変更するには：

1.フックツリー内でフックグループをドラッグ＆ドロップし、必要な順番に並び替えてください。

2.グループの順番を変えると、フックが実行される順番が自動的に変更されます（フックツリーの一番上にあるグループのフックが最初に実行されます）。

フックを別のグループに移動する：

1.フックツリー内で、移動するフックを選択してください。

2.開いたプロパティウィンドウの 親グループ ドロップダウンリストから、フックの移動先になるグループを選択してください。

3.保存をクリックします。

フックの管理

新しいフックを作成：

1.ツールバーで、 → フックグループを追加 を選択します。

2.表示されたウィンドウで以下のパラメータを設定しください：

•作成するフックを有効化するには フックの実行を有効にする にチェックを入れます。フックの有効化 を参照してください。

•親グループ ドロップダウンリストから、作成するフックを置くグループを選択してください。後で、他のグループにフックを移動させることができます（上記 参照）。

•フック ドロップダウンリストからフックの種類を選択してください。フックの種類によって、フックを呼び出すアクションが決定されます。

•フックテキスト フィールドで、フックが呼び出された際に実行されるluaスクリプトを入力してください。
フックの情報 サブセクションには、フックを呼び出すアクション、該当するフックに対して Server データベースを使用可能かどうかという情報、そして該当するフックの種類における入力パラメータと戻り値のリストが含まれています。

3.保存をクリックします。

フックの編集：

1.フックツリー内で、編集するフックを選択してください。

2.ウィンドウ右側に、この手順のプロパティペインが自動的に開きます。Hook パラメータ（このパラメータはフックを呼び出すアクションを決定し、フックが作成された後に編集することができません）を除き、フックの作成時に指定した全てのパラメータを編集することができます。

3.保存をクリックします。

フックの有効化

フックおよびフックグループの有効化は、該当するイベントに応じてフックが実行されるかどうかを決定します。

フックまたはフックグループを有効化：

1.フックツリー内で、有効化するフックまたはフックグループを選択してください。

2.以下のアクションのうちいずれか1つを実行します：

•ツールバーで フックの実行を有効にする をクリックします。

•ウィンドウ右側にある、選択したオブジェクトのプロパティペインで フックの実行を有効にする にチェックを入れてください（チェックが入っていない場合）。保存 をクリックします。

フックの有効化の特徴：

該当するイベントに応じてフックを実行するには、以下の条件を満たしている必要があります：

a)フック自体が有効化されている。

b)フックを含んでいるグループが有効化されている。