Getting Started - Magic Software DEVNET Japan - Magic Software ...

第 11 章 - ハンドラ
1 . はじめに
Magic uniPaaS のイベントハンドラは、 特 定 のイベントが 発 動 されたときに 実 行 される、 一 連 のコマンドによって 構 成 され
ます。
Magic uniPaaS には 次 のようなハンドラがあります。
• 内 部 イベント 用 ハンドラ …… Magic エンジンに 組 込 まれたハンドラで、Magic uniPaaS 内 部 イベントを 処 理 します。たと
えば、 内 部 イベント[ 次 行 ]のハンドラは、 現 在 のレコードから 次 のレコードにカーソルを 移 動 させます。
• 組 込 みイベント 用 ハンドラ …… Magic エンジンに 組 込 まれたハンドラで、 第 9 章 で 学 んだ 異 なるタスクレベルに 適 用 さ
れる Magic エンジンの 実 行 ルールを 実 行 します。
• ユーザ 定 義 イベント 用 ハンドラ …… 開 発 者 が 作 成 するハンドラで、[イベント]ロジックユニットとして 定 義 します。
本 章 では[イベント]ロジックユニットによるユーザ 定 義 イベントの 処 理 と、[イベント]ロジックユニットの 実 行 がどの
ように 行 われるかを 学 びます。
[イベント]ロジックユニット
[イベント]ロジックユニットは、イベントに 対 応 した 実 際 の 処 理 を 行 なう、ハンドラを 定 義 します。
[イベント]ロジックユニットは、プロジェクト 実 行 中 に 対 応 イベントが 発 動 されたときにのみ 実 行 されます。
[イベント]ロジックユニットは 異 なるタイプのイベントに 対 応 しています。
• ユーザ 定 義 イベント …… 開 発 者 によってユーザ 定 義 イベントテーブルに 登 録 されたイベント。
• Magic uniPaaS 内 部 イベント …… 通 常 は Magic uniPaaS が 管 理 するイベントに 対 しても、 開 発 者 は 新 規 に、または 追 加 の
ハンドラを 作 成 できます。
• システムイベント …… キー 入 力 の 組 合 わせによって 発 動 されるイベント。
• タイマーイベント …… 定 義 された 時 間 間 隔 で 発 動 されるイベント。
• 式 イベント …… 定 義 された 式 が 'True' と 評 価 された 時 に 発 動 されるイベント。
• エラーイベント …… データベースに 関 連 したエラーが 発 生 したときに 発 動 されるイベント。
• ActiveX イベント …… COM オブジェクトから 発 動 されるイベントですが、 本 コースでは 扱 いません。
• .Netイベント …… リッチクライアントタスクでのみ 有 効 な .Net オブジェクトから 発 動 されるイベントです。 本 コースで
は 扱 いません。
イベントロジックユニットに 設 定 するパラメータ
タイプ イベント 名 コントロール 名 スコープ 条 件
E= イベント 処 理 するイベント 名 イベントを 割 当 てるコントロール 名 イベントのスコープ 実 行 条 件 ( 式 )
イベント 名 は 次 のようにして 取 得 します。
1. ここからズームして[イベント]ダイアログを 開 きます。
2. [イベントタイプ]をドロップダウンリストから 選 択 します。
3. [イベント] 欄 からズームしてイベント 一 覧 から、 該 当 するイベント 名 を 選 択 します。
コントロール 名 は 次 のようにして 取 得 します。
1. 直 接 コントロール 名 を 入 力 する。
2. ここからズームしてコントロール 一 覧 を 開 き、 選 択 する。
イベントのスコープは 次 の 二 つです。
• タスク …… イベントがそのタスク 実 行 中 に 発 動 された 場 合 のみハンドラが 実 行 されます。
• サブツリー …… イベントがそのタスクか、またはサブタスク 実 行 中 に 発 動 された 場 合 にハンドラが 実 行 されます。
Getting Started 153
Magic uniPaaS V1Plus