リッチインターネット アプリケーション - Magic Software Enterprises

リッチインターネット
アプリケーションの
チュートリアル
Magic xpa

本 マニュアルに 記 載 の 内 容 は、 将 来 予 告 なしに 変 更 することがあります。これらの 情 報 について MSE(Magic Software Enterprises Ltd.)およ
び MSJ(Magic Software Japan K.K.)は、いかなる 責 任 も 負 いません。
本 マニュアルの 内 容 につきましては、 万 全 を 期 して 作 成 していますが、 万 一 誤 りや 不 正 確 な 記 述 があったとしても、MSE および MSJ はい
かなる 責 任 、 債 務 も 負 いません。
MSE および MSJ は、この 製 品 の 商 業 価 値 や 特 定 の 用 途 に 対 する 適 合 性 の 保 証 を 含 め、この 製 品 に 関 する 明 示 的 、あるいは 黙 示 的 な 保 証 は
一 切 していません。
本 マニュアルに 記 載 のソフトウェアは、 製 品 の 使 用 許 諾 契 約 書 に 記 載 の 条 件 に 同 意 をされたライセンス 所 有 者 に 対 してのみ 供 給 されるもの
です。 同 ライセンスの 許 可 する 条 件 のもとでのみ、 使 用 または 複 製 することが 許 されます。
当 該 ライセンスが 特 に 許 可 している 場 合 を 除 いては、いかなる 媒 体 へも 複 製 することはできません。ライセンス 所 有 者 自 身 の 個 人 使 用 目 的
で 行 う 場 合 を 除 き、MSE または MSJ の 書 面 による 事 前 の 許 可 なしでは、いかなる 条 件 下 でも、 本 マニュアルのいかなる 部 分 も、 電 子 的 、
機 械 的 、 撮 影 、 録 音 、その 他 のいかなる 手 段 によっても、コピー、 検 索 システムへの 記 憶 、 電 送 を 行 うことはできません。
サードパーティ 各 社 商 標 の 引 用 は、MSE および MSJ の 製 品 に 対 するコンパチビリティに 関 しての 情 報 提 供 のみを 目 的 としてなされるもの
です。
本 マニュアルにおいて、 説 明 のためにサンプルとして 引 用 されている 会 社 名 、 製 品 名 、 住 所 、 人 物 は、 特 に 断 り 書 きのないかぎり、すべて
架 空 のものであり、 実 在 のものについて 言 及 するものではありません。
Magic は Magic Software Japan K.K. の 登 録 商 標 です。
Magic xpa は Magic Software Enterprises Ltd. のイスラエルその 他 の 国 での 商 標 または 登 録 商 標 です。
Magic xpa Enterprise Studio、Magic xpa Enterprise Client、Magic xpa Enterprise Server および Magic xpa RIA Server は Magic
Software Japan K.K. の 商 標 です。
一 般 に、 会 社 名 、 製 品 名 は 各 社 の 商 標 または 登 録 商 標 です。
MSE および MSJ は、 本 製 品 の 使 用 またはその 使 用 によってもたらされる 結 果 に 関 する 保 証 や 告 知 は 一 切 していません。この 製 品 のもたら
す 結 果 およびパフォーマンスに 関 する 危 険 性 は、すべてユーザが 責 任 を 負 うものとします。
この 製 品 を 使 用 した 結 果 、または 使 用 不 可 能 な 結 果 生 じた 間 接 的 、 偶 発 的 、 副 次 的 な 損 害 ( 営 利 損 失 、 業 務 中 断 、 業 務 情 報 の 損 失 などの 損
害 も 含 む)に 関 し、 事 前 に 損 害 の 可 能 性 が 勧 告 されていた 場 合 であっても、MSE および MSJ、その 管 理 者 、 役 員 、 従 業 員 、 代 理 人 は、い
かなる 場 合 にも 一 切 責 任 を 負 いません。
Copyright 2014 Magic Software Enterprises Ltd.and Magic Software Japan K.K. All rights reserved.
2014 年 3 月 31 日

インタラクティブなリッチクライアントの 開 発 と 実 行
1 概 要
リッチクライアントとは 何 でしょうか? .....................................................................................................................1
何 故 リッチクライアントを 使 用 するのでしょうか? .................................................................................................1
2 リッチクライアントタスクの 作 成
リッチクライアントでの Hellow World ........................................................................................................................3
プログラムの 実 行 .............................................................................................................................................................4
既 存 の 知 識 を 利 用 する ....................................................................................................................................................................4
リッチクライアントの 照 会 リスト .................................................................................................................................4
色 とフォントの 使 用 .........................................................................................................................................................5
3 パフォーマンスについて
基 本 的 な 構 成 要 素 .............................................................................................................................................................6
データ 項 目 ........................................................................................................................................................................................7
関 数 ....................................................................................................................................................................................................7
ユーザ 定 義 関 数 ................................................................................................................................................................................7
式 ........................................................................................................................................................................................................7
データビュー .....................................................................................................................................................................8
範 囲 と 位 置 付 式 ................................................................................................................................................................................8
[ 代 入 ] 特 性 ......................................................................................................................................................................................9
[リンク]コマンド ..........................................................................................................................................................................9
タスクフローの 追 跡 .........................................................................................................................................................10
フォームとコントロール .................................................................................................................................................10
コントロールによる 他 の 問 題 ........................................................................................................................................................11
ロジックユニット .............................................................................................................................................................11
項 目 変 更 ...........................................................................................................................................................................................13
混 在 ...................................................................................................................................................................................................14
不 明 ....................................................................................................................................................................................................15
ロジックユニット 内 の 処 理 コマンド .............................................................................................................................15
イベント 実 行 ....................................................................................................................................................................................16
[コール] 処 理 コマンド ..................................................................................................................................................................17
リッチクライアントタスクの 設 定 .................................................................................................................................24
4 複 数 のタスクで 動 作
ウィンドウタイプ ............................................................................................................................................................................27
他 のプログラムを 呼 び 出 す .............................................................................................................................................27
呼 び 出 されたタスクの 初 期 化 ........................................................................................................................................................27
バッチタスクの 呼 び 出 し ................................................................................................................................................................27
コンテキスト 管 理 ............................................................................................................................................................................27
コンテキスト 非 稼 働 タイムアウト ................................................................................................................................................28
非 インタラクティブタスク .............................................................................................................................................29
サブフォーム .....................................................................................................................................................................29
サブフォームの 初 期 設 定 ................................................................................................................................................................29
サブフォームの 再 表 示 ....................................................................................................................................................................29
[タブサイクル] 特 性 ......................................................................................................................................................................30
[ 出 力 先 ] 特 性 ..................................................................................................................................................................................30
サブフォームの 終 了 ........................................................................................................................................................................31
フレーム .............................................................................................................................................................................31
フォームタイプ ................................................................................................................................................................................32
フレームの 接 続 先 ............................................................................................................................................................................32
フレーム 名 ........................................................................................................................................................................................33
プログラムの 呼 び 出 し ....................................................................................................................................................................33
トランザクション .............................................................................................................................................................33
トランザクション 開 始 ....................................................................................................................................................................34
トランザクションモード ................................................................................................................................................................34
なし ....................................................................................................................................................................................................34
i

インタラクティブなリッチクライアントの 開 発 と 実 行
新 規 の 遅 延 トランザクション ........................................................................................................................................................34
有 効 な 遅 延 トランザクション 内 ....................................................................................................................................................35
オンラインとリッチクライアントでのトランザクションモードの 比 較 ................................................................................35
5 リッチクライアントでの MDI
6 ブラウザコントロール
他 のアプリケーションへのアクセス .............................................................................................................................37
[ブラウザ]コントロール ...............................................................................................................................................37
ブラウザコントロール 特 性 .............................................................................................................................................38
ブラウザコントロールイベント .....................................................................................................................................38
ブラウザコントロール 関 数 .............................................................................................................................................38
PDF の 表 示 ........................................................................................................................................................................39
7 アプリケーションのモニタ
デバッガ .............................................................................................................................................................................41
サーバ 同 期 ........................................................................................................................................................................................41
クライアントの 異 常 終 了 .................................................................................................................................................41
ネットワーク 情 報 の 表 示 .................................................................................................................................................42
8 実 行 環 境
実 行 の 準 備 .........................................................................................................................................................................43
リッチクライアントモジュール ....................................................................................................................................................43
モジュール ........................................................................................................................................................................................44
リッチクライアントの 必 要 条 件 .....................................................................................................................................45
ClickOnce ...........................................................................................................................................................................................45
.NET マニフェストファイル ..........................................................................................................................................................45
Magic xpa のリッチクライアントインタフェースビルダ ..........................................................................................................45
マニフェストファイルの 保 護 ........................................................................................................................................................46
ユーザ 認 証 .........................................................................................................................................................................47
アプリケーションの 起 動 時 に 環 境 変 数 を 取 得 する ....................................................................................................................47
アプリケーションにパラメータを 渡 す ........................................................................................................................................47
9 オフラインアプリケーションの 開 発
10 モバイル 用 の RIA アプリケーションの 開 発
ii

リッチインターネットアプリケーションのチュートリアル
第 1 章 概 要
Magic の 最 初 のリリースから 今 日 まで、この 開 発 ツールは、 常 に 高 い 生 産 的 と 保 守 性 を 提 供 していました。これを 実 現 している
理 由 のうちの 1 つは、 製 品 の 設 計 (「1 つのコードを 複 数 の 方 法 で 利 用 する」パラダイム)に 組 み 入 れられます。この 方 法 は、モ
デルの 動 作 で 確 認 することができます。そこでは、1 つのモデルを 作 成 することで、 多 くの 異 なる 種 類 のデータソースとプログ
ラムの 作 成 時 に 使 用 することができます。データソースの 動 作 で 確 認 することもできます。データソースが 動 作 する 方 法 でそれ
を 参 照 することもできます。それが ISAM や SQL、メモリテーブルまたは XML であるかどうかに 関 わらず、データソースはプ
ログラムによって 同 じ 方 法 で 使 用 することができます。
開 発 者 は、コードの 再 利 用 がどのよう 行 われているかを 詳 細 を 知 ることなくこの 機 能 をりようすることができます。そしてより
短 い 期 間 に 学 習 することができます。プログラムコードは、OS や DBMS のどちらにも 依 存 していないため、プログラムはこの
どちらに 対 して 異 なるバージョンに 対 応 させることができます。
Web 向 けの 開 発 は、 常 にプログラミング 言 語 ( 例 えば、よく 利 用 される JavaScript など)の 習 得 が 必 要 となり、さらに Web ペー
ジの 設 計 に 関 する 知 識 も 必 要 となります。Magic では、すべて 同 じスタジオで 行 われ、アプリケーションのフロントエンドは、
他 のクライアント / サーバ 用 アプリケーションと 同 じ 方 法 で 設 計 することができます。
開 発 者 が 今 まで 使 用 していたのと 同 じ 生 産 的 な 開 発 ツールを 使 用 して、Web 向 用 の 技 術 にアクセスすることができます。
リッチクライアント・プログラミングは、 通 常 の Magic xpa のオンライン・プログラミングとよく 似 ています。そして、どれほ
ど 簡 単 にこの 新 技 術 を 使 用 できるか 分 かると 思 います。
それでは、 始 めましょう!
リッチクライアントとは 何 でしょうか?
アプリケーションをリッチクライアントにすることで、 共 通 のインターネットネットワークを 使 用 して 世 界 中 でアクセスするこ
とができる、Web アプリケーションになります。
Magic xpa はインターネット 対 応 のインタラクティブなアプリケーションを 迅 速 に 開 発 することができます。テーブルをもとに
簡 単 に 開 発 する 機 能 を 使 用 することで、アプリケーションの 実 行 環 境 やコンポーネント、およびロジックを 簡 単 に 定 義 すること
ができます。Java や JavaScript などのようなリッチクライアントのプログラミングに 関 する 知 識 もあまり 必 要 としません。Magic
xpa のリッチクライアント 開 発 機 能 では、 以 下 のことが 可 能 になります。
• 容 易 なフォーム 設 計 ……Magic xpa Enterprise Studio 上 でリッチクライアントタスクのフォームを 設 計 することが 可 能
な、 統 合 された[フォーム]エディタを 提 供 しています。 外 部 ツールは 必 要 ありません。
• クライアント / サーバ 間 のロジックの 切 り 分 けの 自 動 化 …… Magic xpa は 定 義 内 容 に 基 づいて、ロジックがサーバまた
はクライアントのどちらで 実 行 されるかを 自 動 的 に 決 定 します。
• ローカルなクライアント OS 環 境 との 対 話 機 能 …… リッチクライアントを 使 用 することで、ローカルな 環 境 変 数 の 読 み
込 みやローカルコマンドの 実 行 などローカル PC との 対 話 処 理 を 行 うことができます。
何 故 リッチクライアントを 使 用 するのでしょうか?
リッチクライアントの 実 行 機 能 には 以 下 のような 便 利 な 機 能 があります。
• シンクライアント …… リッチクライアントを 使 用 することで、クライアント 側 に 専 用 のソフトウェアをインストールす
る 必 要 がなくなります。サーバでクライアントで 必 要 なすべてのデータ、ロジック、およびフロー 管 理 モジュールを 提
供 します。アプリケーションのすべてのソフトウェア 要 素 はサーバ 側 に 存 在 します。これにより、 管 理 や 保 守 が 容 易 と
なり、 経 費 が 削 減 され 拡 張 性 が 向 上 します。
• ブラウザを 使 用 しない …… リッチクライアントプログラムはインターネット 環 境 で 実 行 しますが Web ブラウザを 必 要
としません( 最 初 の 起 動 時 のみ、InternetExploler または FireFox が 必 要 です)。
• OS のネイティブなルック & フィール …… リッチクライアントは、.NET ベースで 作 成 されており、クライアント OS に
基 づいたルック & フィールで 動 作 します。
• 複 雑 なプログラム…… リッチクライアント・プログラムは、 標 準 的 なインターネット 上 のブラウザ・プログラムより 複
雑 なものにすることができます。Magic xpa のオンライン・プログラムとほとんど 同 じように 動 作 します。
• プラットホームに 依 存 しない …… リッチクライアントは、.NET フレームワーク 上 で 動 作 します。これは、1 つの OS ま
たはバージョンに 依 存 しないことを 意 味 します。
• 堅 固 …… リッチクライアント・プログラムは、 高 いボリューム・トランザクションと 高 いリクエスト 量 を 処 理 すること
ができます。
1

リッチインターネットアプリケーションのチュートリアル
• コンテキスト 管 理 …… Magic xpa エンジンは、コンテキスト 管 理 機 能 を 各 ユーザに 提 供 するため、 各 ユーザに 対 して 独
立 したセッションを 維 持 します。これは、Magic xpa のオンライン 環 境 と 同 じように 動 作 します。
何 よりも、 大 きな 学 習 曲 線 を 必 要 とせずこの 機 能 を 得 ることができます。たとえ、 背 後 で 異 なる 機 能 を 実 現 していても、リッチ
クライアント・プログラムは、 通 常 の Magic xpa のオンライン・プログラムと 同 じように 動 作 するように 設 計 されています。
2

リッチインターネットアプリケーションのチュートリアル
第 2 章 リッチクライアントタスクの 作 成
リッチクライアント・タスクの 作 成 は、 非 常 に 簡 単 です。リッチクライアントの 特 性 のため、いくつかの 変 更 点 がありますが、
基 本 的 には、Magic xpa のオンラインプログラムで 使 用 する 場 合 と 同 じ 方 法 になります。
非 常 に 単 純 なリッチクライアント・タスクを 作 成 して、それがどのように 動 作 するかを 確 認 してみましょう。それから、より 複
雑 なプログラムへ 進 めることで、 今 までとの 違 いを 学 ぶことができます。
リッチクライアントでの Hellow World
古 典 的 な 単 純 なプログラム(Hellow World )から 始 めましょ
う。
新 しいプログラムを 作 成 してください
次 に、[タスクタイプ] 特 性 で「リッチクライアント」を 選
択 します。
これによって、プログラムはリッチクライアント・プログラ
ムとして 実 行 されます。
少 なくとも 一 つのデータ 項 目 を 定 義 します。
これはリッチクライアント・タスクになるため、メイン
フォームのデフォルトはリッチクライアント 表 示 になりま
す。
これは、リッチクライアント・プログラムで 使 用 される
フォームのタイプです。
次 に、[コントロール/ 項 目 ]パレットからテキストとデー
タ 項 目 をドラッグして、オンラインタスクと 同 じように
フォームを 作 成 してください。
次 に、オンラインタスクと 同 じようにこのプログラムを 実 行
します。
3

リッチインターネットアプリケーションのチュートリアル
プログラムの 実 行
実 行 すると、 図 のようなウィンドウが 表 示 されます。これを 見 て 以 下 のことに 気 づくと 思 います。
最 初 に、「Hellow World!」プログラムは、それ 自 身 が 独 立 したウインドウを 持 っています。MDI の 要 素 として 表 示 されません。
これはスタンドアロンの .NET プログラムで、Magic xpa の 実 行 エンジンによって 直 接 実 行 している 訳 ではありません。 現 在 、あ
なたの PC 上 で 実 行 していますが、インターネット 経 由 で 世 界 中 のどこからでも 実 行 させることができます。
しかし、それは Web ブラウザのウインドウで 動 作 している 訳 ではありません。プログラムは、HTML で 記 述 されてはいません。
これは .NET で 記 述 されています。そして、 実 行 するプラットホームに 対 応 した 標 準 的 なユーザインタフェースを 利 用 している
ことを 意 味 します。Hello World プログラムは、.NET フレームワークをサポートする 様 々なプラットホーム 上 で 実 行 させること
ができます。
これは 非 常 に 異 なる 実 行 環 境 です。そして、これを 正 しく 動 作 させるために 必 要 なことががいくつかあります。しかし、プログ
ラミングのほとんどは、 既 にご 存 知 の Magic xpa のプログラミングになります。
既 存 の 知 識 を 利 用 する
開 発 の 観 点 から、リッチクライアントの 利 点 は、プログラムがオンライン・タスクに 似 ていることです。 新 しいパラダイムを 学
ぶ 必 要 はなく、すでにある 技 術 が 非 常 に 役 に 立 ちます。
リッチクライアントの 照 会 リスト
次 に、もう 少 し 難 しくいリッチクライアント・プログラムを 作 成 してみましょう。このセクションでは、レコード 表 示 するため
の、ラインモードのプログラムを 作 成 します。
Ctrl+G を 押 下 して APG を 実 行 し、[オプション]で「リッチクライアント」を 選 択 します。
これで、プログラムを 実 行 すると、 全 ての 顧 客 リストが 表 示 されます。これは、リッチクライアントの .NET 環 境 で 動 作 します。
4

リッチインターネットアプリケーションのチュートリアル
タスクフローはどのように 動 作 するのでしょうか
このタスクが 動 作 する 場 合 、 何 が 起 きているかを 確 認 してみましょう。
実 際 は、「 顧 客 リスト」のクライアントプログラムはあなたのサーバ PC ではなく、どこか 別 の 場 所 で 実 行 するということを 心
にとめておいてください。それは、プログラムが 直 接 データベースにアクセスしないことを 意 味 します。また、 必 ずしも、Windows
環 境 で 実 行 している 訳 ではありません。しかし、リモートデスクトップのような「スクリーンスクラッパー」でもありません。
その 代 わりに、いくつかの 処 理 はクライアント 環 境 で 実 行 されて、サーバ 環 境 も 実 行 されます。これが 全 て 自 動 的 に 実 行 される
ため、 必 要 に 応 じてプログラムを 最 適 化 することができるように、 何 が 行 われているかを 知 っておくことが 重 要 です。
実 行 箇 所
説 明
処 理 設 定 サーバ 新 規 のコンテキストこのタスクに 対 応 して 作 成 されます。
タスク 前 サーバ クライアント・タスクが 実 行 される 前 に、サーバ 側 の Magic xpa エンジ
ンがデータベーステーブルをオープンし、 変 数 項 目 を 初 期 化 し、 範 囲 値
と 位 置 付 値 が 使 用 できるようにし、 最 初 のデータビューを 作 成 します。
クライアント・タスクは、まだ 開 始 されていません。 全 ての 処 理 コマン
ドはサーバで 実 行 されます。
ユーザ 操 作 クライアント/サーバ ユーザがタスクにアクセスする 間 、 処 理 を 実 行 して、データを 表 示 する
ために、.NET エンジンは 送 信 されたローカル XML を 使 用 して 動 作 し
ています。
しかし、 必 要 に 応 じて、いくつかの 処 理 はサーバでも 実 行 されます。
ユーザが 操 作 中 に、[レコード 前 ]と[レコード 後 ]は、オンライン・
タスクで 使 用 される 場 合 と 同 じ 基 準 で 実 行 されます。
レコード 群 がタスク 初 期 化 中 に 送 られるため、クライアントはサーバか
ら 毎 回 レコードを 取 得 する 必 要 はありません。
タスク 後 クライアント/サーバ リッチクライアント・タスクは、すでに 終 了 しています。 定 義 された 処
理 内 容 に 従 って、クライアントかサーバで 処 理 が 実 行 されます。[タス
ク 後 ]が 終 了 した 後 、そこで、タスクをクローズするためサーバへのア
クセスが 行 われます。
いくつかのロジックユニットの 扱 いについては、 第 3 章 「パフォーマンスについて」で 説 明 します。
色 とフォントの 使 用
Magic xpa で 通 常 に 行 うように、 色 とフォントを 使 用 することができます。 色 とフォントは、クライアント・プログラムに 渡 さ
れます。
このプログラムが 指 定 したフォントにアクセスされない 場 合 、OS が 表 示 するデフォルトフォントを 使 用 します。
異 なる OS 間 で 汎 用 的 に 使 用 される(または、 少 なくとも 将 来 的 にサポートされる)フォントを 選 ぶことによって、このような
問 題 を 回 避 することができます。
5

リッチインターネットアプリケーションのチュートリアル
第 3 章 パフォーマンスについて
リッチクライアントのパラダイムでは、 処 理 はサーバとクライアントで 分 担 されます。クライアント/サーバ 間 の 通 信 は、 圧 縮
された XML データでやり 取 りされます。この 通 信 バスはボトルネックとなる 場 合 があり、これによってプログラムのパフォー
マンスに 影 響 を 及 ぼすことになります。このため、 効 率 的 なプログラムを 作 成 するには、やり 取 りする 通 信 量 を 最 小 にする 必 要
があります。
たとえば、DBMS アクセスはサーバ 側 で 発 生 しますが、ユーザ 操 作 はクライアント 側 で 発 生 します。 理 想 的 には、 一 旦 データが
クライアントに 送 信 された 場 合 、レコードがコミットされる 準 備 ができるまで、ユーザはサーバーにアクセスすることなく
フィールドからフィールドにタブ 移 動 できるようにすることできます。しかし、[コントロール 後 ]で 評 価 される 条 件 内 で
DBExist() 関 数 が 使 用 されている 場 合 、ユーザによるタブ 移 動 が 行 われる 度 に、サーバへのアクセスが 発 生 します。これによっ
てユーザ 操 作 が 遅 くなります。
ただし、 何 ができて、 何 ができないか、または 何 が 効 率 的 かを 覚 えておく 必 要 はありません。このようなことを 明 らかにするた
めの Magic xpa では 明 示 することができるます。このセクションでは、それらのツールの 使 用 方 法 について 説 明 しています。
ノート
ログが 使 用 されると、 各 リクエスト 毎 にログが 書 き 込 まれるため、 多 くのリクエスト(バッチ 処 理 のような)
を 実 行 すると、パフォーマンスが 遅 くなるかもしれません。
以 下 の 内 容 で 説 明 しています。
• フォームとコントロール
• データビュー …… データビューは、タスクが 開 始 される 前 に 確 立 されます。そして、これはデータ 項 目 を 処 理 する 方 法
に 影 響 を 及 ぼすことができます。
• 関 数 …… 各 関 数 は、クライアント 側 またはサーバ 側 、ニュートラルに 分 かれます。
• 式 …… データビューと 関 数 の 実 行 箇 所 は、 式 の 実 行 箇 所 に 影 響 します。
• ロジックユニット …… ロジックユニットが 実 行 される 場 所 は、それがどこから 呼 び 出 されるか、または 使 用 される 処 理
コマンドや 式 に 依 存 します。
基 本 的 な 構 成 要 素
Magic xpa のタスクは、3 つの 基 本 的 なセクションで 構 築 されています。リッチクライアントタスクでは:
• データビューは、サーバ 上 で 構 築 されます。
• フォームは、ユーザ 操 作 で 利 用 されます。
• ロジックユニットによって、サーバ 側 で 実 行 されたり、クライアントで 実 行 されたり、 混 在 して 実 行 したりします。
これらについて 順 に 説 明 していきます。
しかし、データ 項 目 や 関 数 、ユーザ 関 数 、 式 は、これらのセクションの 全 てで 使 用 されています。
• データ 項 目 は、データビューで 宣 言 されます。 通 常 、これらはニュートラルですが、サーバ 側 で 処 理 されるものもあり
ます。
• 関 数 は、Magic xpa に 組 み 込 まれているもので、これらの 機 能 によってクライアント 側 かサーバ 側 、またはニュートラル
になります。
• ユーザ 関 数 は 開 発 者 によって 作 成 されます。 実 行 する 場 所 は、 使 用 する 処 理 コマンドと 変 数 に 依 存 します。
• 式 は、 上 記 の 項 目 を 使 用 して 構 築 されます。タスク 特 性 や、 範 囲 、 代 入 、 条 件 、コントロールとフォームで 使 用 される
ため、これらは 特 に 重 要 です。
このセクションでは、これらの 基 本 的 な 構 築 ブロックについて 説 明 しています。
6

リッチインターネットアプリケーションのチュートリアル
データ 項 目
データ 項 目 は、[データビュー]エディタで 定 義 されます。これらは 通 常 ニュートラルです。データビューはサーバ 上 で 構 築 さ
れますが、ユーザ 操 作 によって 値 は 変 更 されます。トランザクションがクローズされると、これらの 変 更 内 容 はクライアントで
保 存 され、 適 切 な 時 間 が 経 過 すると 保 存 のために 送 り 返 されます。
しかし、データ 項 目 によっては、クライアントで 変 更 される 度 に、サーバアクセスがすぐに 必 要 となります。このようなデータ
項 目 は、サーバ 側 項 目 と 呼 ばれています。 上 の 画 像 で 示 すように、これらのデータ 項 目 には、 上 図 のように 番 号 カラムで「S」
が 表 示 され、 色 分 けされます。
データ 項 目 がリンクの 範 囲 / 位 置 付 で 使 用 されている 場 合 、このようなことが 発 生 します。 変 項 目 の 値 が 変 更 される 度 に、 再 リ
ンクが 実 行 されます。このため、サーバへのアクセスが 発 生 します。 上 記 の 例 では、Customers のレコードに 対 するリンクで 使
用 される Customer Code があります。この Customer Code が 式 で 使 用 される 場 合 、その 式 はサーバ 側 で 実 行 されます。
リッチクライアント・プログラムで、データ・ビューにたくさんの 内 容 を 含 む BLOB 項 目 が 定 義 されている 場 合 、BLOB はサー
バとクライアントの 間 で( 他 の 全 ての 変 数 と 同 じように) 渡 されます。これによってプログラムが 遅 くなるかもしれません。
BLOB データを 使 用 しない 場 合 は、データビューに BLOB 項 目 を 定 義 しないことを 推 奨 します。または、それらがサーバ 側 で 使
用 されるのであれば、これらを 処 理 する 新 しいバッチタスクを 作 成 しなければなりません。
関 数
まず、 関 数 を 見 てみましょう。これらは 式 で 使 用 され
る 最 も 小 さな 構 成 要 素 です。そして、 式 がどちらで 実
行 されるかは 使 用 される 関 数 (とデータ 項 目 )に 依 存
します。 各 関 数 はクライアント 側 かサーバ 側 または、
ニュートラルになります。
関 数 の 一 覧 は、Magic xpa のリファレンスヘルプで 参
照 することができます。しかし、 関 数 を 選 択 する 際 、
関 数 一 覧 の 左 下 で 実 行 される 場 所 を 確 認 することがで
きます。
ここには、 以 下 のように 表 示 されます。
• サーバ
• クライアント
• クライアント & サーバ(すなわちニュートラル)
ユーザ 定 義 関 数
開 発 者 に 定 義 される 関 数 は、 使 用 される 場 所 と 関 数 内 に 含 まれる 処 理 によって 評 価 されます。 関 数 がそれを 使 用 する 式 と 同 じタ
スク 内 で 定 義 されている 場 合 は、 式 は 関 数 と 同 じ 場 所 で 実 行 されます。
関 数 がメインプログラムまたはコンポーネントで 定 義 されている 場 合 、それを 使 用 する 式 は、 実 行 場 所 が 未 定 として 設 定 されま
す。
ユーザ 定 義 関 数 には、クライアント 側 とサーバ 側 の 両 方 の 処 理 コマンドを 含 めることはできません。
式
式 は、 一 つ 以 上 の 関 数 とデータ 項 目 で 構 成 されています。 式 の 実 行 場 所 は、 関 数 とデータ 項 目 の 実 行 場 所 に 依 存 します。
7

リッチインターネットアプリケーションのチュートリアル
式 はクライアント 側 で 実 行 されるか、サーバ 側 か、ニュートラルかまたは 混 在 かで 分 類 されます。
• クライアント 側 の 式 は、クライアントでのみ 実 行 できます。
• サーバ 側 の 式 は、サーバ 上 でのみ 実 行 できます。
• しかし、ニュートラルな 式 は、どちらでも 実 行 することができます。これらは、 処 理 コマンドがサーバで 実 行 される 場
合 は、サーバ 側 で 処 理 され、 処 理 コマンドがクライアントで 実 行 される 場 合 は、クライアント 側 で 処 理 されます。
• 混 在 式 は、サーバ 側 とクライアント 側 の 要 因 が 含 まれています。
どのような 式 が 使 用 されているかを 把 握 しておくことが 重 要 です。 式 は、タスク 内 の 多 くの 異 なる 場 所 で 使 用 されています。 式
がサーバ 側 の 式 でクライアントで 評 価 される 場 所 で 使 用 されている 場 合 、 処 理 を 実 行 しようとすると、クライアントが 停 止 さ
れ、リクエストはサーバ 側 に 送 り 返 されます。 場 合 によっては、 構 文 チェッカーによってエラーが 表 示 されます。 動 作 する 場 合
もありますが、 遅 くなります。
式 は、 実 行 される 場 所 に 応 じて 番 号 カラムにマークが 表 示 されま
す。
• S = サーバ 側
• C = クライアント 側
• M = 混 在
• 空 白 = ニュートラル
式 は、 処 理 コマンドや 特 性 、 代 入 値 で 使 用 されるため、 知 っておく 必 要 があります。 式 が 実 行 される 場 所 に 合 った 使 い 方 がさ
れるように 確 認 してください。
データビュー
データビューは、サーバ 上 で 構 成 されます。 使 用 される 実 際 のレコードとフィールドは、クライアントに 送 信 される XML に 含
まれます。
しかし、 例 えば、リッチクライアントのデータビューに 影 響 を 及 ぼす 設 定 として 以 下 のものがあります。
• データ 項 目
• 範 囲 と 位 置 付
•[ 代 入 ] 特 性
•[リンク]コマンド
範 囲 と 位 置 付 式
範 囲 と 位 置 付 式 は( 代 入 式 と 同 じように)、クライアントで 評 価 されたり、サーバ 側 で 評 価 されたりします。したがって、 範 囲
と 位 置 付 で 使 用 される 式 は、ニュートラルである 必 要 があります。
たとえば、この 例 では、 範 囲 で MarkedTextGet() 関 数 を 使 用 しています。サーバ 側 の 特 性 でクライアント 側 関 数 を 使 用 している
ので、この 場 合 は 構 文 エラーになります。
8

リッチインターネットアプリケーションのチュートリアル
この 問 題 を 解 決 するには、 適 当 な 関 数 を 使 用 して 変 数 項 目 を 更 新 する 親 タスクを 作 成 します。 次 に、 直 接 その 変 数 を 参 照 するよ
うにするか、 範 囲 に 使 用 されるパラメータとして 渡 すことができます。
[ 代 入 ] 特 性
クライアント 側 の 式 を[ 代 入 ] 特 性 で 使 用 することはできません。[ 代 入 ] 特 性 にクライアント 側 の 式 を 使 用 する 必 要 がある 場
合 、[レコード 前 ]でこの 式 を 使 用 して 更 新 した 項 目 を 定 義 するようにしてください。
ノート
( 例 えば:タスクが 登 録 モードの 場 合 の 実 項 目 の[ 代 入 ] 特 性 のように )[ 代 入 ] 特 性 が 実 行 された 場 合 に、 常
にサーバへのアクセスが 発 生 するようであれば、サーバ 側 の 式 を 使 用 することは 可 能 ですが 推 奨 しません。
たとえば、この 例 では、3 つの 変 数 項 目 が 定 義 あり[ 代 入 ] 特 性 が 定 義 されています。
• 最 初 の 変 数 はニュートラルな 式 を 使 用 しています。このため、 左 側 にマークが 表 示 されていません。これは、 正 しい 使
い 方 です。
• 2 番 目 の[ 代 入 ] 特 性 には Menu() 関 数 が 使 用 されています。これはクライアント 側 の 式 になります。この 場 合 、 構 文 エ
ラーになります。
• 3 番 目 の[ 代 入 ] 式 には CallProg() 関 数 が 使 用 されています。これはサーバ 側 の 式 になります。この 場 合 も、 構 文 チェッ
クで 警 告 が 表 示 されます。
[ 代 入 ] 特 性 にクライアント 側 またはサーバ 側 の 式 を 使 用 する 必 要 がある 場 合 、 変 数 項 目 を 使 用 する 必 要 があります。
• サーバ 側 の 式 については、サーバへの 余 分 なアクセスを 避 けるために[タスク 前 ]で 変 数 を 更 新 をすることを 推 奨 します。
• クライアント 側 の 式 については、[レコード 前 ]で 更 新 してください。
新 しく 作 成 されたレコードの 初 期 値 を 設 定 する 場 合 は、[レコード 前 ]で 更 新 しなければなりません。その 際 、[ 条 件 ] 特 性 で
Stat(0,'C'MODE) を 設 定 してください。
[リンク]コマンド
[リンク]コマンドは 手 続 き 的 なコマンドではありませんが、サーバ 側 のコマンドです。これは、リンクが 再 計 算 されるたびに、
リッチクライアントが 新 しいリンクを 実 行 するためにサーバにアクセスすることを 意 味 します。
ノート
[リンク]コマンドによる 再 計 算 によって、リッチクライアント・モジュールは、サーバエンジンを 呼 び 出 し、
新 しいレコードを 取 得 します。これは、[リンク]コマンドを 多 用 するとサーバ 側 へのアクセス 負 荷 が 高 くなる
場 合 があることを 意 味 します。したがって、[リンク]コマンドの 使 用 を 制 限 することを 推 奨 します。 代 わりに
なります。
代 わりに[リンク 結 合 ]コマンドを 使 用 することもできます。この 場 合 、コマンドはメインソースに 定 義 され
たデータベースからデータを 取 得 されて、データのかたまりとして、リッチクライアント・モジュールに 送 ら
れます。
9

リッチインターネットアプリケーションのチュートリアル
タスクフローの 追 跡
以 上 のように、リッチクライアントの 処 理 コマンドは、ややシームレスになっています。ロジックが 実 行 している 箇 所 について
は、ユーザの 立 場 からは 簡 単 には 説 明 できません。
しかし、 開 発 者 としては、プログラムを 最 適 化 することができるように、これを 知 っておく 必 要 があります。
普 通 のオンライン・プログラミングで 使 用 する 場 合 とほぼ 同 じような 処 理 コマンドと 関 数 を 使 用 することができます。 大 部 分 の
ロジックは、クライアントで 実 行 されます。しかし、 一 部 はサーバで 実 行 されるものもあります。
クライアントで 何 が 実 行 しているかを 確 認 するには
ロジックユニットの 左 側 には、1 文 字 のコードが 表 示 されます。このコードは、 処 理 がどこで 実 行 するかについて 示 しています。
• S = サーバ
• C = クライアント
• M = 混 在
• U= 不 明
• E= エラー
• 空 白 = ニュートラル
ノート
コマンド 行 が 実 行 される 場 所 を 視 覚 的 に 表 示 するために 色 分 けされます。サーバで 実 行 される 行 は、 開 発 基 本
色 の #10 で 表 示 され、デフォルトではピンクになっています。ニュートラルな 行 は、 現 在 実 行 している 場 所 で
そのまま 実 行 されるため、 直 前 の 行 と 同 じ 色 になります。
処 理 コマンドの 実 行 条 件 が False に 設 定 されている 場 合 は、 実 行 されないため、 実 際 のフローは 異 なるかもしれ
ません。
フォームとコントロール
フォームとコントロールは、ユーザとの 対 話 用 で、クライアント 側 の 式 を 使 用 します。
ここでの 問 題 は、[コントロール 特 性 ]に 関 係 します。たとえば、コントロールが 表 示 されるかどうか、あるいは、 使 用 可 能 か
どうかを 制 御 したり、コントロールのフォントや 色 を 変 更 する 特 性 があります。これらの 特 性 を 式 を 使 用 して 設 定 する 場 合 、 式
は 絶 えず 再 評 価 されます。
サーバ 側 の 式 が 特 性 のどれか 1 つでも 使 用 されると、コントロールが 評 価 されたたびに、サーバへのアクセスが 発 生 してしまい
ます。したがって、コントロールにサーバ 側 の 式 を 使 用 することができません。このような 場 合 、 構 文 エラーが 発 生 します。
サーバ 側 の 式 は、"S" が 表 示 されます。
10

リッチインターネットアプリケーションのチュートリアル
サーバ 側 の 式 を 使 用 する
たとえば、この 例 では、CallProg() はサーバ 側 の 関 数
のため、クライアント 側 のコントロールの 特 性 では 使
用 できません。この 場 合 、 構 文 エラーが 発 生 します。
この 問 題 を 解 決 するには、 式 の 値 を 保 持 するために 変 数 項 目 を 使 用 して、[タスク 前 ]でそれを 更 新 するようにしてください。
[タスク 前 ]はサーバで 実 行 されるため、この 処 理 コマンドによってサーバへの 追 加 されたアクセスは 発 生 しません。
コントロールによる 他 の 問 題
サブフォーム
サブフォームを 使 用 している 場 合 、フォームに 関 する 別 の 問 題 があります。サブフォームを 使 用 すると、 第 4 章 「 複 数 のタスク
で 動 作 」で 説 明 しているように、サブフォームは 特 定 の 規 則 に 従 って 再 表 示 されます。
[テーブル]コントロール
表 データがある 場 合 、テーブルの 全 ての 行 がタスク 開 始 前 に 読 み 込 まれるように、タスクの[ビュー 事 前 読 込 ] 特 性 を 使 用 する
ことができます。ユーザがテーブルを 表 示 している 場 合 、この 設 定 によってサーバへのアクセス 回 数 が 最 小 になります。この 機
能 の 利 便 性 は、テーブルのサイズに 依 存 します。テーブルが 大 きすぎると、 最 初 の 読 み 込 み 時 間 が 大 きく、 不 便 になるかもしれ
ません。
[ツリー]コントロール
タスクが 開 始 される 前 に、サーバからツリーのすべてのレコードを 取 得 するために、[ツリー]コントロールの[ノード 事 前 読
込 ] 特 性 を 使 用 することができます。これによって、サーバへのアクセスを 最 小 にすることができます。しかし[テーブル]コ
ントロールと 同 様 に、データセットが 大 き 過 ぎる 場 合 、 最 初 の 読 み 込 み 時 間 が、より 速 いツリー 操 作 の 利 便 性 を 上 回 るかもしれ
ません。
ロジックユニット
すでにお 分 かりのように、ロジックユニットの 多 くは、どこで 実 行 されるかは、 処 理 コマンドに 依 存 します。しかし、ロジック
ユニットのいくつかは、 実 行 場 所 が 固 定 されています。
11

リッチインターネットアプリケーションのチュートリアル
タスク 前 - サーバ
タスクの 初 期 設 定 を 行 う 時 に、[タスク 前 ]が 実 行 されます。ここは、 純 粋 なサーバ 側 のロジックユニットです。そして、クラ
イアント 側 の 処 理 コマンドは、 実 行 されません。
クライアント・タスクが 開 始 される 前 に、サーバ 側 の Magic xpa エンジンは、データベーステーブルをオープンし、 変 数 項 目 を
初 期 化 して、 範 囲 と 位 置 付 値 を 使 用 して、 最 初 のデータビューを 作 成 します。
クライアント・タスクは、まだ 開 始 されていません。 処 理 コマンドは、サーバで 実 行 されます。
クライアント 側 のプログラムとデータビューのデータは、 小 さく、 暗 号 化 された XML データにパッケージ 化 されます。そして、
それはクライアント 側 にインターネット 経 由 で 送 られます。
[タスク 前 ](タスクの 初 期 化 段 階 )の 実 行 が、ほとんどがサーバ 側 での 実 行 されることを 知 っておいてください。これは、 初 期
化 段 階 では、リッチクライアントを 呼 び 出 す[コール] 処 理 コマンドが 以 下 のルールに 従 っていることを 意 味 しています。
すべての[コール] 処 理 コマンドは 指 定 された 時 間 に 実 行 されます、しかし、 呼 び 出 されたタスクのウィンドウは[タスク 前 ]
の 完 了 後 にクライアント 側 で 開 きます。 他 の 処 理 コマンドが 実 行 されたあとに、すべての[コール] 処 理 コマンドが 実 行 される
ことを 意 味 します。
クライアント 側 の 処 理 コマンドを 使 用 する
「タスク 前 ]は、 常 にサーバ 側 で 実 行 されるため、ここでクライアント 側 の 関 数 を 使 用 することができません。この 例 では、[タ
スク 前 ]でクライアント 側 の 関 数 (CtrlGoTo())を 使 用 しています。これは、 利 用 できません。
この 問 題 に 対 応 するには、サーバ 側 のロジックユニットで、[ウェイト] 特 性 を「No」に 設 定 した[イベント 実 行 ] 処 理 コマン
ドを 使 用 することです。この 場 合 、サーバ 側 のロジックユニットは、サーバで 実 行 されます。しかし、イベントそのものはクラ
イアントで 実 行 されます。
[タスク 前 ]で 実 行 箇 所 不 明 のイベント
[タスク 前 ]で[イベント 実 行 ] 処 理 コマンドを 使 用 するには 注 意 する 必 要 があります。イベントが 発 行 された 場 合 、 構 文 チェッ
カーはイベントがどこで 処 理 されるかを 必 ずしも 把 握 できません。「[タスク 前 ]で 実 行 箇 所 不 明 のイベント」(ページ 12)でこ
の 問 題 に 対 応 しています。
[タスク 後 ]
タスクが 終 了 する 際 、[タスク 後 ]ロジックユニットが 実 行 されます。これは、 定 義 された 処 理 コマンドによってサーバ 側 かク
ライアント 側 で 実 行 されます。
タスクの 呼 び 出 しはすでに 終 了 しているため、[タスク 後 ]から 呼 び 出 された 非 モーダルのフォームで 定 義 されたリッチクライ
アント・タスクは 表 示 されません。[タスク 後 ]ロジックユニットから 呼 び 出 されたリッチクライアントタスクは、サーバ 側 で
実 行 され、すぐに 終 了 します。つまり、タスクの[タスク 前 ]と[タスク 後 ]のロジックユニットは、サーバ 側 で 自 動 的 に 実 行
されます。
しかし、 呼 ばれたタスクが 並 行 起 動 の 場 合 、この 制 限 はありません。
12

リッチインターネットアプリケーションのチュートリアル
項 目 変 更
ユーザがレコードを 参 照 する 度 に、[ 項 目 変 更 ]ロジックユニットが 実 行 されます。ロジックユニットはニュートラルです。し
かし、この 中 にはサーバ 側 の 処 理 コマンドを 使 用 しないことを 推 奨 します。これによって、データ 項 目 が 変 更 されるたびに、
サーバにアクセスされることを 回 避 できます。
項 目 変 更 には、2 つの 段 階 があります。 再 計 算 とコントロールの 変 更 です。このため、サーバへのアクセスが 行 われると、この
例 のように、アクセスが 2 回 発 生 します。したがって、クライアント 側 またはニュートラルな 処 理 コマンドだけを 使 用 するよう
にしなければなりません。
コントロールとレコードレベル
[コントロール 前 / 後 ]と[レコード 前 / 後 ]は、オンライン・プログラムと 同 じ 規 則 に 従 って 動 作 します。ユーザがレコード
の 操 作 をしている 場 合 、[コントロール 前 / 後 ]と[レコード 前 / 後 ]はコントロールとレコードの 間 でユーザが 操 作 する 度 に
実 行 されます。この 種 の 操 作 は、クライアント 側 で 実 行 され、サーバ 側 での 操 作 を 必 要 としません。
したがって、[ 項 目 変 更 ]ロジックユニットのように、これらのロジックユニットは、クライアント 側 またはニュートラルな 処
理 コマンドのみを 定 義 するようにしてください。この 例 では、[レコード 前 ]と[コントロール 前 ]でサーバ 側 の 処 理 コマンド
が 定 義 されています。これらは、できれば、[タスク 前 ]に 移 動 してください。
エラーレベル
対 応 する DBMS エラーが 発 生 した 場 合 、エラーレベルのロジックユニットが 実 行 されます。このロジックユニットは、サーバ
で 実 行 されます。
確 認 ダイアログボックスを 表 示 するロールバックオプションは、リッチクライアントでは 実 行 されません。これは、ロールバッ
ク 関 数 の 最 初 のパラメータが 無 視 されることを 意 味 します。また、エラーイベントのメッセージ 特 性 も、 無 視 されます。
このため、ユーザにエラーを 表 示 させたい 場 合 は、 非 同 期 イベント(ウェイト =No)を 使 用 してください。[エラー]ロジック
ユニットの 終 了 後 、イベントが 実 行 される 要 因 となります。
エラー 処 理 の 詳 細 については、Magic xpa のリファレンスヘルプのエラー 処 理 のセクションを 参 照 してください。
システムとユーザイベント
システムイベントとユーザイベントに 対 するイベントロジックユニットがどこで 実 行 されるかは、 定 義 された 処 理 コマンドに 依
存 します。 簡 単 な 例 を 見 てみましょう。
13

リッチインターネットアプリケーションのチュートリアル
ニュートラル 側
どちらからでも 実 行 することができます。このようなロジックユニットは、ニュートラルとして 扱 われます。 呼 び 出 された 場 所
で 実 行 され、 相 手 側 と 通 信 する 必 要 がありません。[イベント]ロジックユニットの 行 番 号 にはコードは 表 示 されません。[ 項 目
更 新 ] 処 理 コマンドも、ニュートラルとして 扱 われます。これは、どちらからでも 実 行 することができます。
クライアント 側
次 に、[エラー] 処 理 コマンドが 追 加 されると、[イベント]ロジックユニットはクライアント 側 で 実 行 されるようになり、「C」
というコードが 表 示 されます。エンドユーザーにメッセージを 表 示 する 必 要 があるため、[エラー] 処 理 コマンドはクライアン
トでのみ 実 行 することができるからです。[ 項 目 更 新 ] 処 理 コマンドはニュートラルで、 呼 び 出 された 場 所 で 実 行 されます。[エ
ラー] 処 理 コマンドを 実 行 する 必 要 がある 場 合 、(すなわち、[エラー] 処 理 コマンドの 実 行 条 件 が True と 評 価 された 場 合 )、[エ
ラー] 処 理 コマンドはクライアントで 実 行 されます。
代 わりに、バッチタスクへの 呼 び 出 しが 追 加 されると、[イベント]ロジックユニットはサーバ 側 となり、「S」というコードが
表 示 されます。これは、バッチタスクが 常 にサーバで 実 行 されるからです。
混 在
しかし、2 つの 処 理 が 混 在 している 場 合 はどうなるでしょうか?
クライアント 側 とサーバ 側 の 両 方 の 処 理 コマンドが 使 用 された 場 合 、イベントは 混 在 しているものとして 扱 われ、「M」という
コードが 表 示 されます。クライアントとサーバ 間 の 通 信 によってタスクの 動 作 が 遅 くなる 可 能 性 があるため、 処 理 コマンドを 混
在 して 使 用 することはできるだけ 避 けてください。
14

リッチインターネットアプリケーションのチュートリアル
不 明
処 理 コマンドによっては、どちらで 実 行 されるか 判 らないものもあります。 例 えば、[イベント 実 行 ] 処 理 コマンドは、このタ
スクでは、 親 タスクか、メインプログラム、または、コンポーネントで 実 行 されるかもしれません
ロジックユニット 内 の 処 理 コマンド
各 処 理 コマンドは、サーバ 側 かクライアント 側 、またはニュートラルか 不 明 として 扱 われます。ニュートラルな 処 理 コマンド
は、サーバかクライアントのどちらかで 実 行 されます。
処 理 コマンド 実 行 場 所
エラー クライアント 常 にクライアントで 実 行
コール バッチ サーバ 常 にサーバで 実 行
[ 出 力 先 ] 特 性 を 使 用 クライアントへの 即 時 アクセスが、 現 在 サブフォーム
上 で 実 行 しているタスクを 閉 じるためにある 場 合 、 混
在 と 扱 われます。
[ウィンドウタイプ]が
「モーダル」
混 在
クライアントとサーバで 部 分 的 に 実 行 します。これは
タスクを 読 み 込 まむためにサーバにアクセスして、そ
れを 開 始 するためにクライアントに 制 御 が 移 ります。
そして、 呼 び 出 しタスクは 停 止 します。
[ウィンドウタイプ]が
「 非 モーダル」
サーバ
タスクを 読 み 込 むためにサーバにアクセスします。 次
に、 呼 び 出 されたタスクの 実 行 を 待 つことなく、 処 理
が 継 続 します。
外 部 コール UDP サーバ 処 理 の 一 部 はサーバ 側 で 実 行 されます。
Web サービス サーバ 処 理 の 一 部 はサーバ 側 で 実 行 されます。
OS コマンド 状 況 依 存 [ 実 行 ] 特 性 に 依 存 します。
COM なし サポートしていません。
アクション 状 況 依 存 評 価 される 処 理 に 依 存 します。
ブロック 状 況 依 存 ブロック 式 に 依 存 します。
項 目 更 新 状 況 依 存 更 新 されるデータ 項 目 と 項 目 で 使 用 される 式 に 依 存 し
ます。
イベント 実 行 状 況 依 存 発 行 されるイベントに 対 応 するロジックユニットに 依
存 します。
フォーム なし サポートしていません。
サーバ 側 でで 帳 票 出 力 処 理 を 実 行 して、 結 果 をクライ
アントに 表 示 することができます。
「PDF を 表 示 する」を 参 照 してください。
処 理 コマンドは、それらの 特 性 ( 例 えば、 条 件 )で 使 用 される 式 にも 影 響 します。
15

リッチインターネットアプリケーションのチュートリアル
イベント 実 行
ニュートラル
通 常 、Magic xpa は、[イベント 実 行 ] 処 理 コマンドがどこで 処 理 されるかを 見 分 けることができます。たとえば、この 例 では、
イベントはこのタスク 内 で 処 理 されます。F12 を 押 下 した 場 合 のロジックユニットはニュートラルで、[ 伝 播 ] 特 性 を「No」 設
定 すると、[イベント 実 行 ] 処 理 コマンドもニュートラルになります。
サーバ 側
しかし、F12 を 押 下 することで 実 行 されるロジックユニットがサーバ 側 である 場 合 、[イベント 実 行 ] 処 理 コマンドはサーバ 側
で 実 行 されます。この 場 合 、F11 に 対 するロジックユニットもサーバ 側 になります。
不 明
この 例 では、F12 に 対 応 するイベントロジックユニットは、タスク 内 に 存 在 していません。スタジオは、[イベント 実 行 ] 処 理
コマンドが 実 行 時 にどちらで 処 理 されるかを 判 断 できないため、 不 明 として 扱 われます。これは、 以 下 のような 場 合 において 発
生 します。
• イベントのロジックユニットが、 異 なるタスクに 定 義 されている 場 合 。 実 行 時 にどのタスクがイベントを 処 理 するかは
開 発 時 には 判 断 できません。このような 場 合 、 主 に 実 行 時 のタスクツリーに 依 存 します。
• 現 在 のタスクのイベントに 対 するロジックユニットは、[ 伝 播 ] 特 性 が「Yes」に 設 定 されている 場 合 。 実 行 中 は、タス
クがイベントをどこで 処 理 するかは、 開 発 時 には、 判 断 できません。この 場 合 も、 主 に 実 行 時 のタスクツリーに 依 存 し
ます。
[イベント 実 行 ] 処 理 コマンドでのメモ:
• [イベント 実 行 ] 処 理 コマンドの[ウェイト] 特 性 が「No」に 設 定 されている 場 合 、サーバ 側 の 処 理 コマン
ドの 定 義 行 内 の 一 部 でないならば、 全 てのイベントの 処 理 の 後 で 実 行 されるため、(どちらの 側 にも 即 時 に
アクセスが 発 生 しないため)それはニュートラルとして 扱 われます。
• サーバ 側 の 処 理 の 行 内 に[イベント 実 行 ] 処 理 コマンドが 含 まれている 場 合 、 実 行 時 にエラーが 発 生 する 場
合 があります。
16

リッチインターネットアプリケーションのチュートリアル
[タスク 前 ]の[イベント 実 行 ] 処 理 コマンド
[タスク 前 ]は、サーバ 側 で 常 に 実 行 されます。
[タスク 前 ]でクライアント 側 の 処 理 コマンドを 入 力 すると、エラーが 発 生 します。
サーバ 側 のロジックユニットには、クライアント 側 の 処 理 コマンドを 含 めることができません。[タスク 前 ]の 後 でこの 処 理 を
実 行 するために、[ウェイト] 特 性 を「No」に 設 定 することができます。
[タスク 前 ]に 不 明 の 処 理 コマンドが 定 義 されている 場 合 、 警 告 が 発 生 します。
不 明 の 処 理 コマンドがサーバ 側 のロジックユニットに 定 義 されていて、 実 行 時 にクライアント 側 で 評 価 されたる 場 合 、エラーが
発 生 する 点 に 注 意 してください。
その 際 、 不 明 の 処 理 コマンドが 本 当 はサーバ 側 であることを 確 認 するかどうかは、 開 発 者 に 依 存 します。
しかし、[イベント 実 行 ] 処 理 コマンドの[ウェイト] 特 性 を「No」に 設 定 することで 問 題 は 解 決 します。サーバ 側 のイベント
がサーバで 発 生 した 後 、クライアント 側 のイベントはクライアントで 発 生 します。
[コール] 処 理 コマンド
リッチクライアント・タスクは、オンライン・プログラムと 同 じような 方 法 で、 別 のリッチクライアント・タスクを 呼 び 出 すこ
とができます。その 際 、[コール] 処 理 コマンドを 使 用 して、パラメータを 渡 すことができます。 呼 び 出 されたプログラムは、
サブフォームまたはフレームセット 内 に 表 示 したり、 個 別 のウインドウを 表 示 して 実 行 したり、モーダルウィンドウを 表 示 して
実 行 したり、 並 行 に 実 行 されることもできます。
別 のリッチクライアント・タスクを 呼 び 出 す
リッチクライアント・タスクが 別 のリッチクライアントタスクを 呼 び 出 すとき、 混 在 処 理 として 扱 われます。サーバはタスクを
パッケージ 化 する 必 要 があります。そして、クライアントで 実 行 する 必 要 があります。
バッチタスク
バッチタスクは、サーバ 側 で 処 理 されます。このため 例 えば、 複 雑 な 帳 票 を 作 成 したい 場 合 、 帳 票 出 力 用 のバッチタスクはサー
バ 側 で 実 行 されます。 最 終 結 果 としての 帳 票 は、バッチタスクが 終 了 した 後 、クライアントで 表 示 させることができます。
17

リッチインターネットアプリケーションのチュートリアル
バッチタスクへの 呼 び 出 しは、 常 に 同 期 型 です。これは、クライアントはバッチタスクが 完 了 するまでの 待 つことを 意 味 してい
ます。リッチクライアントからバッチタスクを 呼 び 出 す 場 合 は、 開 始 と 停 止 を 行 うためのダイアログはサポートされません。
[タスク 前 ]の[コール] 処 理 コマンド
[タスク 前 ]からリッチクライアント・プログラムを 呼 び 出 そうとすると、エラーが 発 生 します。[タスク 前 ]では、クライアン
ト 側 のプログラムを 呼 び 出 すことができません。
しかし、「クライアント 側 の 処 理 コマンドを 使 用 する」(ページ 12)で 説 明 しているように、クライアント 上 でタスクが 開 始 さ
れた 時 点 で 実 行 されるプログラムを 呼 び 出 すようにするには、[イベント 実 行 ] 処 理 コマンドの[ウェイト] 特 性 を「No」に 設
定 して 使 用 することで 可 能 になります。
[コール OS] 処 理 コマンド
[コール OS] 処 理 コマンドは、 興 味 深 い 処 理 コマンドです。これは、OS のネイティブなコマンドを 呼 び 出 します。1 つの PC 上
で 実 行 している 場 合 は、 明 確 に 理 解 できるはずです。しかし、リッチクライアント 環 境 では、どの 様 な 意 味 を 持 つのでしょう
か。 実 際 は、クライアント、またはサーバ 上 で OS コマンドを 実 行 したいかもしれません。
どのような 環 境 でコマンドを 処 理 するかを 指 定 することは、 開 発 者 に 依 存 します。
サーバ 側 で 呼 び 出 す
ここでは、 簡 単 な OS コマンドとして、 現 在 のディレクトリを 表 示 し、それを 一 時 的 なファイルにリダイレクトする 例 を 示 して
います。ここでの 問 題 は、サーバ PC、または、クライアント PC のどちらのディレクトリを 表 示 するのでしょうか? これは、
[ 実 行 ] 特 性 を 設 定 することで 開 発 者 によって 制 御 できます。ここでは、サーバ 側 に 設 定 されています。これによって、この 処
理 コマンドはサーバ 側 の 処 理 コマンドとなります。
クライアント 側 で 呼 び 出 す
ここでは、 同 じ 処 理 コマンドが 定 義 されていますが、[ 実 行 ] 特 性 は「クライアント」と 設 定 されています。これによって、 処
理 コマンドはクライアント 側 で 実 行 されます。このコマンドが 実 行 された 場 合 、クライアント 側 のディレクトリが 表 示 されます。
18

リッチインターネットアプリケーションのチュートリアル
[コール OS] 処 理 コマンドの 用 途
クライアントまたはサーバ 上 で 実 行 している OS に 対 応 した[コール OS] 処 理 コマンドを 使 用 することができます。
上 記 の 例 では、 同 じコマンドは 実 行 されます。
dir > C: \Temp\Dir.txt
しかし、1 つのインスタンスでは、サーバ 側 のディレクトリが 表 示 され、 別 のインスタンスでは、クライアント 側 のディレクト
リが 表 示 されます。
OS にアクセスする Magic xpa の 関 数 もあります。このため、[コール OS] 処 理 コマンドで OS に 直 接 アクセスすることは 一 般 的
に 必 要 ではありません。たとえば、OS の 環 境 変 数 の 値 を 取 得 したい 場 合 は、OSEnvGet() 関 数 を 使 用 することができます。
OSEnvGet() 関 数 は、サーバ 環 境 変 数 を 取 得 します。この 関 数 のクライアント 版 (ClientOSEnvGet)は、クライアント 側 の 環 境 変
数 を 取 得 できます。 別 の 関 数 ペアとして、ファイル 情 報 ( 例 えば、FileInfo() と ClientFileInfo() にアクセスするものもあります。
[ブロック] 処 理 コマンド
[ブロック] 処 理 コマンドは、 条 件 式 の 内 容 に 基 づいてクライアント 側 またはサーバ 側 で 実 行 されます。
[ブロック] 処 理 コマンドの 最 適 化
[ブロック IF] 処 理 コマンドが 定 義 されている 場 合 、クライアント 側 とサーバ 側 をグループ 化 するようにしてください。True が
設 定 された 行 が 見 つかるまで、モジュールは 各 条 件 を 評 価 します。そして、True の 条 件 が 見 つからない 場 合 、この 例 のようにな
ります。
• #1. クライアント 側 で 実 行 されます。
• #4. サーバ 側 で 実 行 されます。
• #6. クライアント 側 で 実 行 されます。
• #8. サーバ 側 で 実 行 されます。
• #10. クライアントに 戻 ります。
19

リッチインターネットアプリケーションのチュートリアル
次 に、 行 を 入 れ 替 えることで、 以 下 のように 変 更 することができます。
• #1 と #4 は、クライアント 側 で 実 行 されます。
• #6 と #8 は、サーバ 側 で 実 行 されます。
• #10 で、クライアントに 戻 ります。
GetLang() 関 数 の 値 を 保 持 するために 変 数 を 使 用 して、これをさらに 最 適 化 することで、 二 度 も 実 行 する 必 要 がなくなります。
GetLang() が[タスク 前 ]で 実 行 させるようにすることで、ブロック 内 の 比 較 処 理 はクライアント 側 になります、バッチタスク
が 呼 び 出 されるまで、サーバへのアクセスは 必 要 なくなります。
ブロック Loop
上 図 のように 同 じループ 処 理 内 にサーバとクライアントの 両 方 の 処 理 が 混 在 して 定 義 すると、クライアントとサーバ 間 でのやり
取 りが 頻 繁 に 行 われるため、あまり 良 いことではありません。
[エラー] 処 理 コマンド
[エラー] 処 理 コマンドは、クライアント 側 の 処 理 コマンドです。ダイアログボックスや、ステータスバーにメッセージを 表 示
するために 使 用 することができます。
[ 表 示 ] 特 性 を「ライン」に 設 定 してメッセージを 表 示 させた 場 合 、SDI ウィンドウのステータスバーに 表 示 されます。SDI ウ
インドウを 使 用 していない 場 合 、メッセージは 表 示 されません。[ 表 示 ] 特 性 を「ボックス」に 設 定 した 場 合 、 普 通 のオンライ
ン・プログラムと 同 じようにメッセージボックスが 表 示 されます。
[エラー] 処 理 コマンドはクライアント 側 で 実 行 されるため、[タスク 前 ] 使 用 することはできません。
[ 項 目 更 新 ] 処 理 コマンド
[ 項 目 更 新 ] 処 理 コマンドはニュートラルです。 実 行 される 場 所 は、 使 用 されている 式 と 更 新 されているデータ 項 目 に 依 存 します。
[ 項 目 更 新 ] 処 理 コマンドの 実 行 場 所 は、 以 下 内 容 に 依 存 します。
• ロジックユニットが 実 行 される 場 所
• 更 新 式 で 使 用 される 関 数 とデータ 項 目
• 更 新 されるデータ 項 目 の 処 理 場 所
20

リッチインターネットアプリケーションのチュートリアル
[アクション] 処 理 コマンド
[アクション] 処 理 コマンドが 実 行 される 場 所 は、どのような 式 が 実 行 されるかに 依 存 します。 式 は、 複 数 の 関 数 とデータ 項 目
から 構 成 される 場 合 があります。 各 々がクライアント 側 であったりサーバ 側 、ニュートラルになります。
ニュートラル
ここでは、AddDate() 関 数 が 式 で 使 用 されています。この 関 数 は。ニュートラルです。このため、[アクション] 処 理 コマンドも
ニュートラルになります。
サーバ 側
しかし、FileDelete() 関 数 が 使 用 されると、 処 理 コマンドはサーバ 側 になります。FileDelete() は、サーバ 側 の 関 数 です。
クライアント 側
また、ClientFileDelete() 関 数 はクライアント 側 です。このため、[アクション] 処 理 コマンドはクライアント 側 になります。
エラー
クライアントとサーバ 側 の 関 数 またはデータ 項 目 を 結 合 する 式 を 作 成 することもできます。この 例 の 場 合 、[アクション] 処 理
コマンドによって 評 価 される 式 はエラーとして 扱 われ、「E」というコードが 表 示 されています。これは、 混 在 した 式 として 使 用
しているからです(「M」というコードが 表 示 されます)。 混 在 式 には、サーバで 実 行 される 関 数 (FileExist)とクライアントで
実 行 される 関 数 (ClientOSEnvGet)が 含 まれています。
21

リッチインターネットアプリケーションのチュートリアル
混 在 した 処 理
混 在 した 処 理 は、サーバ 側 の 処 理 コマンドまたは 式 が、クライアント 側 の 処 理 コマンドと 一 緒 に 使 用 されているものです。
このようなことが 発 生 する 要 因 には、 以 下 のものがあります。
• クライアント 側 の 処 理 コマンド([エラー] 処 理 コマンドのような)が、 処 理 コマンドの 特 性 ( 条 件 )の 一 部 にサーバ 側
の 関 数 を 使 用 している 場 合 ( 上 記 の F10 の[イベント]ロジックユニットを 参 照 )。
• サーバ 側 の 処 理 コマンドが、 特 性 ( 例 えば 条 件 )の 一 部 にクライアント 側 の 関 数 を 使 用 している 場 合 ( 上 記 の F11 の[イ
ベント]ロジックユニットを 参 照 )。
• 混 在 した 式 。 一 つの 式 に、クライアント 側 とサーバ 側 の 関 数 を 使 用 している 場 合 ( 上 記 の F12 の[イベント]ロジック
ユニットを 参 照 )
これらの 場 合 、 構 文 チェッカーによってエラーが 発 生 します。
この 種 のロジックを 実 装 するには、 複 数 の 処 理 コマンドを 使 用 して、 変 数 項 目 に 式 の 結 果 を 保 存 する 必 要 があります。 変 数 項 目
は、 同 じ 場 所 での 処 理 が 連 続 するように 最 も 有 効 な 場 所 で 更 新 する 必 要 があります。
この 例 では、 変 数 項 目 (v. 週 末 )を 使 用 しています。そして、[タスク 前 ]で CallProg() 関 数 を 使 用 して 更 新 しています。この 処
理 は、F10 の[イベント]ロジックユニット 内 で 使 用 されています。この 場 合 、クライアント 側 になります。
もう 一 つの 変 数 項 目 (v. クライアントのレポート)は、[レコード 前 ]で 更 新 されます。これは、F11 の[イベント]ロジック
ユニット 内 で 使 用 されています。この 場 合 、サーバ 側 になります。
22

リッチインターネットアプリケーションのチュートリアル
類 似 したロジックは、F12 の[イベント]ロジックユニット 内 で 使 用 される 混 在 式 でも 使 用 されています。 元 の 式 は 混 在 してお
り、「M」というコードが 表 示 されます。
修 正 した 式 は、ClientFileExist() 関 数 の 結 果 を[レコード 前 ](クライアント 側 で 処 理 される 場 所 であればどこでも 結 構 です)で
変 数 項 目 に 格 納 します。これによって、 式 はサーバ 側 となるため 動 作 します。
ノート
使 用 したい 関 数 がクライアント 側 かサーバ 側 、または 混 在 かが 分 からない 場 合 は、 関 数 一 覧 を 表 示 してくださ
い。 関 数 一 覧 の 左 下 に 表 示 されます。
グループ 処 理
混 在 した[イベント]ロジックユニットがある 場 合 、できる 限 りサーバ 側 の 処 理 コマンドとクライアント 側 の 処 理 コマンドをま
とめることが 最 良 です。これによって、ネットワーク 上 のトラフィックが 低 減 されます。
リッチクライアントでの 処 理 の 並 び 方 は 以 下 の 通 りです。
1. クライアント 側 を 開 始 (イベントが 発 行 された 時 、セッションが 開 始 された 場 所 )
2. GetLang() 関 数 で 変 数 項 目 更 を 更 新 (サーバ)
3. 警 告 を 表 示 (クライアントに 戻 ります)
4. プログラムの 呼 び 出 (サーバ)
5. プログラムの 表 示 (クライアントに 戻 ります)
この 場 合 、クライアントとサーバ 間 の 処 理 が 4 回 切 り 替 わります。
処 理 行 の 順 序 を 変 更 することで、この 切 り 替 えを 2 回 に 変 更 することができます。
1. 同 じようにクライアントを 開 始 します。クライアント 上 で 警 告 を 表 示 します。
2. サーバで GetLang() 関 数 を 実 行 します。サーバ 上 でプログラムを 呼 び 出 します。
3. プログラムを 表 示 するためクライアントに 戻 ります。
当 然 ですが、 可 能 な 最 適 化 の 順 序 は、プログラムのロジックに 依 存 します。
23

リッチインターネットアプリケーションのチュートリアル
リッチクライアントタスクの 設 定
ほとんどのリッチクライアントタスクの 設 定 は、オンラインタスクと 同 じように 行 うことができます。ただし、リッチクライア
ントタスクには 関 係 ない 設 定 もあります。また、リッチクライアントタスクにだけ 関 係 する 設 定 もあります。ここでは、これら
の 設 定 のいくつかについて 説 明 します。
メインフォーム:
通 常 のオンラインタスクと 同 様 に、 複 数 のフォームを
定 義 し、[メインフォーム] 特 性 を 使 用 して 実 行 時 に
表 示 されるフォーム 番 号 を 式 で 指 定 することができま
す。
アイコンファイル 名 :
通 常 のオンラインタスクと 同 様 に、リッチクライアン
ト・タスクで 表 示 されるアイコンを 定 義 することがで
きます。アイコンファイルが 定 義 されない 場 合 は、メ
インプログラムの[タスク 特 性 ]で 定 義 されるアイコ
ンが 表 示 されます。
トランザクションモード:
リッチクライアントタスクは、「W= 有 効 な 遅 延 トラ
ンザクション」( 上 位 タスクでオープンされているト
ランザクションを 利 用 する 場 合 )または「N= 新 規 の
トランザクション」(トランザクションが 既 にオープ
ンされていても、 別 のトランザクションを 新 規 にオー
プンしたい 場 合 )、および「N= なし」のみ 設 定 できま
す。
「トランザクション」のセクションで 詳 細 に 説 明 しま
す。
ビュー 事 前 読 込 :
この 特 性 は、 事 前 にデータビュー 全 体 を 取 得 するかど
うかを 定 義 します。 値 が「True」に 設 定 されると、
サーバはタスクの 初 期 設 定 中 にデータベースからすべ
ての 関 連 するレコードを 取 得 します。これは 小 さな
テーブルに 対 しては、 非 常 に 便 利 です。この 特 性 を
「True」に 設 定 した 場 合 、[チャンクサイズ] 特 性 の 値
をデータベースから 取 得 されたすべてのレコードを 保
持 する 上 で 十 分 なサイズに 設 定 することを 推 奨 しま
す。
24

リッチインターネットアプリケーションのチュートリアル
チャンクサイズ:
[チャンクサイズ( 式 )] 特 性 は、 追 加 レコードとして
クライアントに 渡 されるレコード 数 を 定 義 します。
例 えば、この 特 性 が「100」に 設 定 された 場 合 、アプ
リケーションサーバでタスクが 起 動 されると、 最 初 の
100 レコードがクライアントに 渡 されます。これに
よって、エンドユーザはローカル 上 で 最 初 の 100 のレ
コードを 参 照 することができるようになります。エン
ドユーザが、レコードの 与 えられた 範 囲 を 越 えてスク
ロールしようとすると、クライアントはサーバに 通 知
し、 追 加 の 100 レコードを 受 け 取 ります。
レコードの 集 まりは、レコードのローカルキャッシュ
としてクライアントに 蓄 積 されます。エンドユーザが
テーブルの 最 後 や 先 頭 に 移 動 すると、ローカルキャッ
シュは 消 去 され、キャッシュはレコードの 1 回 分 の
チャンク 数 のレコード 群 を 格 納 します。
ノート
チャンクサイズが 大 きすぎると、パフォーマンスが 低 下 する 可 能 性 があります。データが 転 送 される 度 に、 多
くのデータがサーバからクライアントに 渡 ります。
他 方 、レコード 長 が 大 きい 場 合 (たとえば、 大 きな BLOB 型 項 目 が 含 まれている 場 合 など)は、チャンクサイ
ズを 小 さくした 方 が 良 い 場 合 もあります。
クライアント 関 数
クライアント 側 のファイルやフォルダへのアクセス
リッチクライアントタスクでは、クライアント 側 にアクセスするための 専 用 の 関 数 を 使 用 することができます。
関 数 には、 以 下 のものがあります。
• ClientBlb2File
• ClientDirDlg
• ClientFile2Blb
• ClientFileCopy
• ClientFileDelete
• ClientFileExist
• ClientFileInfo
• ClientFileListGet
• ClientFileRename
• ClientFileSize
• ClientFileOpenDlg
• ClientFileSaveDlg
• ClientFileToServer
ローカルマシンの 環 境 変 数 の 取 得
クライアントマシンの 一 時 ディレクトリのような 環 境 情 報 を 取 得 する 必 要 があるかもしれません。 以 下 の 関 数 を 使 用 すること
で、このようなことが 可 能 になります。
25

リッチインターネットアプリケーションのチュートリアル
• ClientGetUniqueMachineID
• ClientOSEnvGet
セッション 情 報 を 取 得
現 在 のセッションに 関 する 情 報 を 取 得 する 場 合 、 以 下 の 関 数 を 使 用 することができます。
• ClientSessionStatisticsGet
26

リッチインターネットアプリケーションのチュートリアル
第 4 章 複 数 のタスクで 動 作
[コール] 処 理 コマンドを 使 用 してリッチクライアント・タスクから、 別 のプログラムを 呼 び 出 すことができます。 呼 び 出 すプ
ログラムは、リッチクライアントかバッチ・タスクである 必 要 があります。
オンライン・プログラミングで 使 用 するような 形 式 でプログラムを 呼 び 出 すことができます。
• 選 択 プログラム …… オンラインアプリケーションと 同 じように 使 用 することができます。
• モーダルウィンドウ …… そのウィンドウが 閉 じるまで 別 のウインドウにアクセスできなくなります。
• 並 行 タスク …… 呼 び 出 したタスクと 独 立 して 実 行 することができます。
サブフォームやフレームを 使 用 してプログラムを 暗 黙 的 に 呼 び 出 すこともできます。サブフォームまたはフレームは、[ 出 力 先 ]
特 性 を 使 用 することで 実 行 時 に、 異 なるプログラムを 表 示 させることもできます。
ウィンドウタイプ
実 行 時 に 異 なる 方 法 で 実 行 するタスクを 設 定 することができます。たとえば、サブフォームで 実 行 するタスクを 定 義 したり、ス
タンドアロンで 実 行 するタスクを 定 義 することができます。このうちのほとんどが、サブフォームでも 動 作 するため、 自 動 的 に
行 われます。
しかし、 異 なる[ウィンドウタイプ] 特 性 を 使 用 して 実 行 するタスクが 必 要 な 場 合 、そのタスクのために 2 つの 異 なるフォーム
を 準 備 する 必 要 があります。そして、どのフォームを 表 示 するかを[メインフォーム] 特 性 で 指 定 します。
他 のプログラムを 呼 び 出 す
呼 び 出 されたタスクの 初 期 化
[タスク 前 ]は、サーバ 側 で 常 に 実 行 されます。したがって、リッチクライアント・タスクまたはプログラムを 呼 び 出 す 場 合 、
サーバへのアクセスが 行 われる 間 、クライアントの 現 在 の 処 理 は 休 止 しなければなりません。 呼 び 出 されたタスクの[タスク
前 ]はサーバ 側 で 実 行 されます。そして、ウインドウはクライアントで 表 示 されます。
バッチタスクの 呼 び 出 し
リッチクライアントからバッチタスクを 呼 び 出 すことができます。バッチタスクが 終 了 するまでリッチクライアントの 処 理 は 休
止 します。
バッチタスクは 常 にサーバで 実 行 されます。たとえば、OS ファイルを 使 用 する 場 合 、 気 をつけておいてください。 入 出 力 ファ
イルは、サーバ PC 上 のファイルにアクセスします。 場 合 は、この 処 理 のための 関 数 があります。
リッチクライアントからバッチタスクを 呼 び 出 した 場 合 は、 開 始 / 終 了 のダイアログボックスはサポートされません。
コンテキスト 管 理
リッチクライアントタスクを 新 規 に 実 行 した 場 合 、 自 のコンテキストで 動 作 します。コンテキストは、タスクが 実 行 する 瞬 間 か
ら 終 了 する 瞬 間 までタスクの 状 態 を 記 録 します。 各 コンテキストには、 個 別 にユニークなコンテキスト ID が 割 り 当 てられます。
並 行 タスクを 開 始 すると、 新 しいコンテキスト ID を 持 ったコンテキストは 作 成 されます。 並 行 タスクの 子 タスクは、( 子 タスク
も 並 行 実 行 の 設 定 がされていない 限 り、 設 定 されている 場 合 は、さらにもう 一 つの 新 しいコンテキストが 割 り 当 てられます) 同
じコンテキストで 開 きます。
各 コンテキストは、 他 のコンテキストとは 独 立 しています。タスクツリーやデータベース・カーソル、SetParam() 関 数 によって
設 定 されるデータ、データ 操 作 ステートメントのすべては、コンテキストごとに 個 別 に 追 跡 されます。
Magic xpa は、 各 コンテキストの 動 作 を 追 跡 します。サーバは、 各 クライアントのリクエストを 属 しているコンテキストをもと
に 識 別 します。どのタスクまたはサブタスクが 開 いているか、データベースカーソルとデータ 操 作 ステートメントに 関 する 情 報
は、コンテキストごとに 全 て 維 持 されます。
ノート
27

リッチインターネットアプリケーションのチュートリアル
一 旦 、コンテキストが Magic xpa エンジンで 作 成 されると、クライアントからのすべてのリクエストは 常 に 同 じ
エンジンに 送 られます。
外 部 HTTP ロードバランサーを 使 用 した 場 合 、クライアントとサーバ 間 の 粘 着 性 (つまり、 各 クライアントか
ら 最 初 のリクエストが 作 成 された Web サーバへのダイレクトリクエストへのロードバランサー 機 能 )を 確 実 に
する 必 要 がります。。これをサポートするために、 各 RIA リクエストには、MgxpaRIAglobalUniqueSessionID と
いう 名 前 のヘッダが 含 まれます。このヘッダは、 特 定 のエンドユーザセッションの 各 HTTP リクエストに 同 じ
ユニークな 値 を 保 持 します。ヘッダには、 各 クライアント・インスタンスに 対 する 異 なるユニークな 値 が 含 ま
れています。 外 部 HTTP ロードバランサーは、 粘 着 性 をサポートするために、このヘッダを 使 用 することがで
きます。
コンテキスト 非 稼 働 タイムアウト
サーバ 側 で 保 持 されるコンテキスト 情 報 は、メモリリソースを 必 要 とします。たくさんのシステムリソースを 使 用 する 可 能 性 が
あるコンテキストを 保 持 する 場 合 、サーバの 負 荷 を 軽 減 するためコンテキストにタイムアウトを 設 定 することができます。
[コンテキスト 非 稼 働 タイムアウト]の 設 定 は、[オプション \ 設 定 \ 動 作 環 境 \ アプリケーションサーバ]にあります。この 設
定 は、クライアントが 非 稼 働 状 態 をチェックする 時 間 間 隔 を 指 定 します。「コンテキスト 非 稼 働 」とは、リッチクライアントタ
スクの 実 行 中 にクライアント / サーバ 間 のアクセスがない 状 態 を 意 味 します。
[コンテキスト 非 稼 働 タイムアウト]は、1/10 秒 単 位 で 設 定 します。デフォルト 値 は 36000(1 時 間 )です。
コンテキストがタイムアウトに 到 達 すると、コンテキストはサーバから 削 除 されます。このタイムアウトを 設 定 することで、 放
棄 されたコンテキストがサーバ 上 に 蓄 積 されることを 防 止 することができます。
リッチクライアントタスクが 開 発 モードで 実 行 された 場 合 、[コンテキスト 非 稼 働 タイムアウト]は 無 制 限 になります。
並 行 処 理
リッチクライアントタスクの 並 行 動 作 は、オンラインタスクとは 異 なります。リッチクライアントタスクは、その 親 タスクとそ
の 実 行 時 のタスクツリー 内 の 他 のすべてのタスクと 並 行 して 実 行 されます。この 例 では、タスク 1 はタスク 2 を 呼 び 出 していま
す。さらにタスク 3 を 呼 び 出 しています。しかし、 一 旦 すべてのタスクが 開 いた 場 合 、ユーザは 自 由 に 3 つのウインドウの 間 を
クリックすることができます。
しかし、 非 リッチクライアントのオンラインプログラムの 場 合 、サブフォームを 使 用 するか、[ウィンドウ 消 去 ] 特 性 を「No」
に 指 定 しない 限 り、タスク 2 をクリックするとタスク 3 は 自 動 的 に 停 止 します。この 点 については、ウインドウの 動 作 をよりオ
ンラインプログラムのようにしたいならば、モーダルに 設 定 することで 実 現 できます。これによって、 上 位 のタスクで 変 更 処 理
を 行 う 場 合 、まず 下 位 のタスクを 終 了 させることが 必 要 になります。
リッチクライアントと 非 リッチクライアントの 両 方 のタスクツリーでは、 最 上 位 のタスクを 閉 じると、 全 てのツリーを 閉 じま
す。この 例 では、タスク 1 を 閉 じると、タスク 2 とタスク 3 も 閉 じます。3 つの 全 てのタスクを 完 全 に 独 立 させたい 場 合 は、[ 並
行 実 行 ] 特 性 を「Yes」にしてください。しかし、この 場 合 は、 管 理 する 新 規 コンテキストが 作 成 されるため、この 機 能 は、 必
要 な 時 だけ 使 用 してください。
28

リッチインターネットアプリケーションのチュートリアル
非 インタラクティブタスク
バッチタスクはサーバ 上 で 実 行 されるため、リッチクライアントタスクを 呼 び 出 すことはできません。しかし、(インタラクティ
ブなタスクを 呼 び 出 すという 目 的 で) 時 々クライアント 側 でバッチ 処 理 を 実 行 させたいという 必 要 性 が 発 生 します。これは、[タ
スク 特 性 ] 内 の[インタラクティブ] 特 性 のチェックを 外 すことで 実 現 できます。
非 インタラクティブなリッチクライアントタスクは、ユーザの 入 力 処 理 を 待 たずに 自 動 的 にレコードを 処 理 し、メインソースの
すべてのレコード 処 理 を 終 了 するか、[タスク 終 了 ] 特 性 の 条 件 を 満 たした 場 合 にタスクが 終 了 されるという 点 を 除 いて、イン
タラクティブなリッチクライアントタスクと 同 じように 動 作 します。
サブフォーム
サブフォームは 2 つのタスクをマージすることができます。このため、 複 数 のタスクを 同 フォーム 上 で 実 行 させることができま
す。これは、 受 注 入 力 処 理 のように、テーブルを 表 示 するために 使 用 されます。
サブフォームを 追 加 する 方 法 は、オンラインタスクの 場 合 とほぼ 同 じです。サブフォームで 使 用 されるタスクは、リッチクライ
アントタスクでなければなりません。
サブフォームの 初 期 設 定
親 タスクが 開 始 されると、 親 タスクの[タスク 前 ]と[レコード 前 ]が 実 行 されます。
次 に、サブフォームの[タスク 前 ]が 実 行 されます。そして、[レコード 前 ]は 最 初 のレコードの 処 理 が 実 行 されます。
サブフォームの 再 表 示
リッチクライアントのサブフォームは、オンラインタスクと 同 じ 規 則 で 再 表 示 されます。[ 自 動 再 表 示 ] 特 性 が「Yes」に 設 定 さ
れ、パラメータが 渡 されると、サブフォームはパラメータの 値 が 変 更 される 度 に 自 動 的 に 再 表 示 されます。[サブフォーム 再 表
示 ]イベントは、サブフォームを 再 表 示 するために 使 用 することができます。
しかし、サブフォームを 再 表 示 しても[タスク 前 ]は 実 行 されません。[レコード 前 ]は、レコードが 再 度 読 み 込 まれることで
実 行 されます。
[ 非 表 示 の 再 表 示 ] 特 性
サブフォームには、[ 非 表 示 の 再 表 示 ] 特 性 があります。これは、サブフォームの 初 期 化 と 再 表 示 のタイミングを 制 御 します。
この 特 性 が「Yes」に 設 定 されると、サブフォームが 表 示 されているか 否 かに 関 わらず、 動 作 に 違 いはありません。これは、 以
下 のこと 意 味 しています:
• サブフォームタスクの 初 期 設 定 は、データビューの 最 初 のレコードの[レコード 前 ]の 後 で 実 行 されます。
• サブフォームの 再 表 示 は、[ 自 動 再 表 示 ] 特 性 や[サブフォーム 再 表 示 ]イベントによって 行 われます。
29

リッチインターネットアプリケーションのチュートリアル
この 特 性 が「No」に 設 定 されている 場 合 、サブフォームが 表 示 されていない 時 は、サブフォームタスクの 初 期 設 定 と 再 表 示 の
み 実 行 されます。これは、 以 下 のこと 意 味 しています:
• 各 サブフォームタスクを 実 行 する 前 に、その 可 視 性 がチェックされ、 表 示 されていない 場 合 、サブフォームタスクは 実
行 されず、 遅 延 されます。 一 旦 クライアントがサブフォームの 表 示 を 要 求 すると、サーバ 側 を 呼 び 出 し、サブフォーム
タスクは 初 めて 表 示 されます。
• サブフォームの[タスク 前 ]の 実 行 は、サブフォームが 表 示 されるまで 遅 延 されます。
• サブフォームの[ 可 視 ] 特 性 の 式 がクライアント 側 で 実 行 される 場 合 、タスクが 読 み 込 まれた 時 点 でサブフォームが 表
示 されます。
• サブフォームの 再 表 示 を 実 行 する 前 に、サブフォームの 可 視 状 態 がチェックされ、 表 示 されていない 場 合 、サブフォー
ムのデータは 再 表 示 されません。そして、 表 示 されるようになると、Magic xpa はサーバにアクセスし、サブフォームの
データを 再 表 示 します。
[タブサイクル] 特 性
サブフォームタスクには、[タブサイクル]があります。これは、サブフォームの 最 後 のパーク 可 能 なコントロールから TAB
キーを 押 下 した 場 合 の 動 作 を 定 義 します。
サブフォーム / フレームでの 連 続 するタスクの 動 作 は、そのタスク 内 の 特 性 で 決 定 され、 親 タスクでは 定 義 しません。
[ 出 力 先 ] 特 性
サブフォームは、 実 行 時 に 異 なるプログラムを 表 示 させることができます。
これは、[コール] 処 理 コマンドの[ 出 力 先 ]
特 性 を 使 用 することで 実 現 できます。
プログラムがサブフォームで 実 行 するように
呼 び 出 される 場 合 、プログラムは[ 出 力 先 ]
特 性 で 設 定 された 名 前 で 指 定 されたサブ
フォーム 上 で 実 行 されます。 別 のプログラム
を 同 じサブフォーム 上 で 実 行 するように 呼 び
出 された 場 合 、 最 初 のプログラムが 閉 じ、 呼
び 出 されたプログラムが 実 行 されます。
[ 出 力 先 ] 特 性 は、サブフォームまたはフレー
ムで 使 用 することができます。この 特 性 は、
[コントロール 名 ]または[フレーム 名 ]を 参
照 します。
混 在 処 理 のタスクを 呼 び 出 す 場 合 は、 注 意 が 必 要 です。サブタスクが 呼 び 出 される 場 合 は 常 に、サーバへのアクセスが 発 生 しま
す。この 例 のように[ 項 目 変 更 ]ロジックユニットを 使 用 した 場 合 、 呼 び 出 し 処 理 の 効 率 が 悪 くなる 旨 の 警 告 が 発 生 します。
30

リッチインターネットアプリケーションのチュートリアル
フレームを 使 用 した 場 合 もこの 技 術 を 使 用 するができます。
サブフォームの 終 了
リッチクライアントでサブフォーム 関 する 違 いは、サブフォームが 終 了 すると 親 タスクも 終 了 するということです。[ 終 了 ]イ
ベントが 発 行 されたり、ユーザがサブフォーム 内 で ESC キーを 押 下 すると、 親 タスクも 終 了 します。これは、フレームの 場 合
も 同 じです。ユーザが 下 位 タスクで ESC キーを 押 下 してもタスクが 終 了 しないようにするには、ESC キーに 対 する[イベント]
ロジックユニット 作 成 し、[ 伝 播 ] 特 性 を「No」に 設 定 することで 実 現 できます。
フレーム
より 洗 練 されたフォームを 作 成 するために、リッチクライアントのフレームセットを 使 用 することができます。これを 使 用 する
ことでタスクを 複 数 のセクションに 分 けることができます。そして、それぞれが 異 なるプログラムを 表 示 します。 各 フレームに
表 示 されるプログラムは、リッチクライアントのプログラムまたはサブタスクでなければなりません。
フレームは、サブフォームと 同 じように 動 作 します。しかし、フレームでは、ユーザが 仕 切 りバーをドラッグすることによっ
て、 簡 単 に 各 セクションの 大 きさを 変 更 することができます。
フレームはネストすることができ、さらにサブフォームやタブと 併 用 することで、より 複 雑 なユーザインタフェースを 作 成 する
ことができます。この 例 では、 左 側 のフレームでユーザーや 受 注 情 報 、 製 品 情 報 が 表 示 されるようにようにしています。 選 択 品
内 容 が 右 側 のフレームに 表 示 されます。
31

リッチインターネットアプリケーションのチュートリアル
フォームタイプ
リッチクライアント 用 のフレームを 作 成 するには、 最
初 にフォームの[インタフェースタイプ]で「リッチ
クライアントフレーム」を 選 択 する 必 要 があります。
次 に、フォームを 開 くと[フレーム]パレットが 表 示
されます。パレットをクリックすることで 使 用 したい
フォーマットを 選 択 することができます。ここでは、
2 つの 垂 直 フレームを 持 つフレームセットを 使 用 しま
す。
これらのフレームは、ネストさせることもできます。
このため、 実 行 時 には 6 種 類 以 上 の 組 み 合 わせで 表 示
させることができます。
フレームの 接 続 先
各 フレームは、プログラムまたは、サブタスクやフォームに
接 続 することができます。これはサブフォームの 場 合 と 同 じ
ように 動 作 させることができます。[パラメータ]や[ 自 動
再 表 示 ]の 特 性 を 使 用 することもできます。
現 在 のタスクからデータを 表 示 させたい 場 合 、「フォーム」
のタイプを 使 用 します。この 場 合 は、サブタスクを 呼 び 出 し
ません。
各 フレームで 何 を 表 示 させるかを 選 択 する 必 要 があります。 実 行 時 にフレームに 表 示 させる 内 容 を 変 更 させたい 場 合 、 何 も 表 示
させないダミーのタスクを 作 成 して、フォームから 呼 び 出 すようにしてください。
32

リッチインターネットアプリケーションのチュートリアル
フレーム 名
各 フレームは、フレーム 名 を 定 義 することができます。これは、 特 定 のフレームでプログラムを 表 示 するために 使 用 されます。
この 例 では、2 つのフレームがあります。 左 上 はメニューリストを 表 示 します。これは、フレーム 内 に 常 に 表 示 される 唯 一 のプ
ログラムです。 右 側 には、 何 も 表 示 されないダミープログラムを 呼 び 出 します。 実 行 時 には、メニューリストから 呼 び 出 されプ
ログラムをもとに、このフレームを 表 示 します。
プログラムの 呼 び 出 し
次 に、プログラムを 呼 び 出 すとき、どのフレームに 表 示 させるかを 指 定 します。ここでは、「ユーザー 表 示 」というプログラム
を「 右 側 」という 名 前 のフレームで 表 示 させるようにします。
トランザクション
リッチクライアント・プログラムは、 遅 延 トランザクションを 使 用 します。DBMS はサーバ 上 にあるのため、 物 理 トランザク
ションを 使 用 することができません。
Magic xpa は、 遅 延 トランザクションにデータの 変 更 内 容 を 保 存 し、トランザクションが 終 了 した 時 点 でコミットします。トラ
ンザクションがロールバックされると、 保 持 されたトランザクションは 廃 棄 されます。リッチクライアントのこの 動 作 は、オン
ラインプログラムの 場 合 と 同 じです。
しかし、リッチクライアントでトランザクションが 処 理 される 方 法 にはいくつかの 違 いがあります。このセクションでは、 類 似
点 と 違 いについて 説 明 しています。
33

リッチインターネットアプリケーションのチュートリアル
トランザクション 開 始
レコードを 更 新 しているか、 新 規 レコードを 作 成 しているか、レコードを 削 除 しているかどうかにかかわらず、リッチクライア
ントモジュールはデータのどのような 修 正 も 処 理 します。すべてのデータ 操 作 ステートメントは、リッチクライアントモジュー
ルによって 維 持 され、[トランザクション 開 始 ]の 設 定 に 基 づいてサーバーに 送 られます。
• レコード 前 の 前 …… 変 更 内 容 は、レコードレベルのトランザクション 内 のレコードを 終 了 した 後 にコミットされます。
• タスク 前 の 前 …… 変 更 内 容 は、タスクレベルのトランザクション 内 でタスクを 閉 じた 後 にコミットされます。
トランザクションモード
リッチクライアントで 使 用 することができるトランザクションモードは 以 下 の 通 りです。
• なし
• 新 規 の 遅 延 トランザクション
• 有 効 な 遅 延 トランザクション 内
なし
[トランザクションモード]が「なし」の 場 合 、トランザクションがオープンされません。
子 タスク 内 のトランザクションをまとめて、ラッピングされたトランザクションがオープンされることを 防 止 するために、デー
タの 保 存 処 理 が 行 われないタスク 上 でのみ 使 用 してください。メインのバックグラウンド 画 面 やバックグラウンドフレームを 作
成 する 場 合 、この 設 定 が 必 要 です。
新 規 の 遅 延 トランザクション
[トランザクションモード]が「 新 規 の 遅 延 トランザクション」に 設 定 された 場 合 、トランザクションが 親 タスクで 開 始 される
か 否 かに 関 わらず、 新 しいトランザクションが 開 始 されます。 親 のトランザクション 内 で 発 生 した 内 容 に 関 係 なく、 子 のトラン
ザクションは 子 タスクレベルでコミットされます。
もし、トランザクションが 開 始 されると:
• 新 しい 遅 延 トランザクションが 開 始 されます。
• トランザクションが 閉 じた 後 ( 呼 び 出 し 側 のトランザクションに 関 係 なく)、このトランザクションの 変 更 内 容 がコミッ
トされます。
• このトランザクションがまだ 開 いていても、 呼 び 出 し 側 のトランザクションを 閉 じることができます。 呼 び 出 し 側 のト
ランザクションを 閉 じても、このトランザクションは 影 響 しません。
• 新 しいトランザクションは、 独 自 のトランザクションキャッシュを 持 っています。トランザクションキャッシュは 共 有
できません。そして、このトランザクションで 行 われる 変 更 内 容 は、 他 のトランザクションで 参 照 することはできません。
34

リッチインターネットアプリケーションのチュートリアル
有 効 な 遅 延 トランザクション 内
[トランザクションモード]が「 有 効 な 遅 延 トランザクション 内 」の 場 合 、このトランザクションは 親 のトランザクションの 要
素 となります。
• トランザクションがすでに 開 始 される 場 合 、タスクはそのトランザクションの 要 素 です。
• トランザクションが 開 始 されていない 場 合 、 新 しい 遅 延 トランザクションが 開 始 されます。
親 タスクのトランザクションがロールバックされると、 子 トランザクションもロールバックされます。
1 つの 親 タスクが 子 タスクで 複 数 のトランザクションを 開 いていることになるため、 注 意 して 使 用 してください。もし、 一 度 に
タスクレベルでロールバックする 正 当 な 理 由 がない 限 り、 新 規 の 遅 延 トランザクションは、より 安 全 です。
オンラインとリッチクライアントでのトランザクションモードの 比 較
リッチクライアント オンライン 比 較
なし 物 理 /なし トランザクションはオープンしません。
新 規 遅 延 遅 延 親 レベルでは、 新 規 の 遅 延 トランザクションと 遅 延 トランザクション
は、 同 じように 動 作 します。 両 方 とも、 新 しいトランザクションを 開 き
ます。
ネスト 遅 延
子 タスクレベルでは、オンラインタスクでのネストされた 遅 延 トランザ
クションは、リッチクライアントでの 新 規 の 遅 延 トランザクションと 同
じように 動 作 します。
遅 延 内 遅 延 内 オンラインとリッチクライアントでは、 同 じように 動 作 します。 現 在 の
タスクのトランザクションは、 親 のトランザクションの 要 素 になりま
す。
物 理
物 理 トランザクションモードは、リッチクライアントにはありません。
トランザクションが 閉 じると、 遅 延 トランザクションは 物 理 的 なデータ
ベースにコミットされます。
35

リッチインターネットアプリケーションのチュートリアル
第 5 章 リッチクライアントでの MDI
以 下 のようにすることで、リッチクライアントアプリケーションで MDI 環 境 を 使 用 することができます。
1. メインプログラムに、フォームを 追 加 します。
2.[クラス]を「0」、[インターフェースタイプ]を「リッチクライアント 表 示 形 式 」に 設 定 します。
3. [フォーム 特 性 ]で、[プルダウンメニュー] 特 性 にリッチクライアント 専 用 のプルダウンメニューを 設 定 します。
MDI の 背 景 色 や 背 景 イメージ、またはグラデーションスタイルを 指 定 することもできます。
4.[プロジェクトの 実 行 タイプ] 特 性 を「リッチクライアント」に 設 定 します。
5. プログラムを MDI 内 に 表 示 させたい 場 合 は、[ウィンドウタイプ]を「MDI 調 整 」か「MDI 子 ウィンドウ」に 設 定 し
ます。
アプリケーションをテストするためにプログラム 上 で F7 を 押 下 するか、Ctrl+F7 を 押 下 してプロジェクトを 実 行 した 場 合 も、
MDI 環 境 で 動 作 します。
ノート
MDI 環 境 をメインプログラムに 定 義 すると、リッチクライアント・アプリケーションを 公 開 する 際 に、 開 始 プ
ログラム 名 を 指 定 する 必 要 が 無 くなります。
36

リッチインターネットアプリケーションのチュートリアル
第 6 章 ブラウザコントロール
他 のアプリケーションへのアクセス
リッチクライアント 環 境 で 動 作 する 場 合 、データはサーバに
あり、クライアントで 表 示 されます。しかし、 異 なるアプリ
ケーションを 使 用 しているクライアントにデータを 表 示 する
必 要 があるかもしれません。
たとえば、PDF や Excel のスプレッドシートで 帳 票 を 表 示 さ
せたい 場 合 があるかもしれません。
[ブラウザ]コントロール
これを 処 理 する 1 つの 方 法 が、[ブラウザ]コントロールの
使 用 です。このコントロールは、Microsoft の Internet Explorer
のように 動 作 します。
ヒント
ブラウザー 内 容 がコントロールのサイズより 大 き 過 ぎる 場 合 や、スクロールバーを 表 示 させたくない 場 合 、 以
下 のスタイルを 使 用 することができます。
body { margin:
0px;
overflow:hidden }
37

リッチインターネットアプリケーションのチュートリアル
ブラウザコントロール 特 性
[ブラウザ]コントロールには、 簡 単 な 特 性 があります。そのほとんどは、 他 のコントロールと 同 じように 使 用 します。[デー
タ] 特 性 は、Web ブラウザで 開 く Web サイトやファイルの URL を 格 納 する 文 字 型 項 目 を 指 定 します。
ブラウザコントロールイベント
[ブラウザ]コントロールは、「ブラウザステータス テキスト 変 更 」という 内 部 イベントを 発 行 させることができます。
[ブラウザ]コントロールによって 表 示 されているアプリケーションのステータスバー 内 のテキストが 変 更 されると、コントロー
ルはこのイベントを 発 行 します。このイベントは、Magic xpa 内 で 処 理 することができます。
このイベントに 対 するハンドラは 1 つのパラメータ(ステータスバーの 現 在 のテキスト)を 受 け 取 ることができます。
ノート
[ブラウザステータス テキスト 変 更 ]イベントによって、リッチクライアントモジュールはブラウザから 情 報
を 受 け 取 ることができます。
JavaScript を 使 用 してステータスバーの 値 を 変 更 することができ、それを 行 うことで、ブラウザ 側 で 表 示 する
データをリッチクライアントに 返 すことでができます。
ブラウザコントロール 関 数
リッチクライアントでは、コントロールに 表 示 させる 内 容 を 制 御 するための 関 数 を 使 用 することができます。
• BrowserSetContent …… コントロールに 表 示 させる 内 容 を 設 定 することができます。この 関 数 は、パラメータで 指 定 され
た 値 を 使 用 してコントロールを 更 新 するもので、URL によって 参 照 する 内 容 をもとにコントロールを 更 新 する 方 法 とは
異 なります。
• BrowserGetContent …… コントロールに 表 示 されている 内 容 を 取 得 します。この 関 数 は、BrowserSetContent 関 数 とともに
使 用 され、 内 容 を 取 得 し、テキストを 処 理 し、コントロールに 戻 すことができます。
• BrowserScriptExecute …… [ブラウザ]コントロールに 表 示 されるファイルに 定 義 されている VB Script や JavaScript の 関
数 を 実 行 します。
38

リッチインターネットアプリケーションのチュートリアル
PDF の 表 示
帳 票 を 作 成 する 場 合 に、この[ブラウザ]コントロールを 使 用 することができます。エンドユーザは、 帳 票 をクライアント 側 に
表 示 させたいはずです。しかし、Magic xpa のプリンタの 設 定 は、サーバ 側 のプリンタにしかアクセスできません。
クライアント 側 で 帳 票 を 表 示 させるためのソシューションは、[ブラウザ]コントロールを 使 用 し、PDF ファイルを 表 示 するた
めにこれを 拡 張 することです。このためには、 以 下 の 処 理 が 必 要 です。
サーバ 上 にファイルが 作 成 されるディレクトリを 作 成 しま
す。( 例 :D:\Pdf)
このディレクトリを 参 照 する Web サーバのエイリアス( 例 :
pdf)を 作 成 します。
これで、サーバ 上 の PDF に Web ブラウザでアクセスするこ
とができます。
帳 票 作 成 のバッチタスク 内 で、PDF を 作 成 するための 処 理 を 組 み 込 みます。Adobe Acrobat などのサードパーティ 製 の PDF
出 力 ツールを 使 用 して GUI 印 刷 出 力 の 内 容 を PDF に 変 換 するようにします。ファイル 名 は「d:\Pdf\report.pdf」と 設 定 し
ます。
PDF 出 力 ツールは、 指 定 したフォルダ 内 に 自 動 的 に PDF を 出 力 し、 出 力 結 果 を 表 示 しないように 指 定 できる 機 能 が 必 要 で
す。ファイル 名 は、[ 入 出 力 ファイル]テーブルの[ 名 前 ]カラムに 論 理 名 で 指 定 することで 動 的 に 指 定 できます。
ファイルを 表 示 させるリッチクライアントタスク 内 で、[ブ
ラウザ]コントロールを 定 義 します。
コントロールには、 以 下 の URL を 参 照 するように 指 定 しま
す。http://localhost/pdf/report.pdf
PDF ファイルの 作 成 タスクと 表 示 タスクを 順 番 に 実 行 します。
39

リッチインターネットアプリケーションのチュートリアル
ノート
PDF の 表 示 タスク 内 から 作 成 タスクを 実 行 しても、フォーム 内 の[ブラウザ]コントロールは 再 表 示 されませ
ん。ファイルの 作 成 後 に 表 示 タスクを 起 動 するようにタスクの 構 成 を 工 夫 してください。
40

リッチインターネットアプリケーションのチュートリアル
第 7 章 アプリケーションのモニタ
堅 牢 で 複 雑 なリッチクライアント・プログラムを 開 発 することができます。 複 雑 なロジックや 未 知 の 問 題 を 理 解 する 必 要 がある
場 合 、Magic xpa には、 作 業 を 支 援 するツールが 組 み 込 まれています。
デバッガ
Magic xpa には、 強 力 なデバッガとロギングシステムがあります。プログラムが 何 をしているかを 把 握 することができ、ブレイ
クポイントを 使 用 して 必 要 に 応 じてプログラムをで 停 止 させることができるため、リッチクライアントの 動 作 を 理 解 する 上 で 役
に 立 ちます。デバッガについての 詳 細 は、『マスタリング Magic xpa』を 参 照 してください。
リッチクライアントでデバッガーを 使 用 する 場 合 は、[ロギング] 設 定 の[クライアント 動 作 ]を「Yes」に 設 定 してください。
この 設 定 を 行 わない 場 合 、サーバの 動 作 のみ 参 照 できます。
アプリケーションが 配 備 された 後 は、リモート 環 境 でデバッガを 実 行 させることもできます。
サーバ 同 期
サーバ 側 のロギングを 行 うだけの 場 合 は、サーバ 側 の 処 理 コマンドがそのまま 出 力 されます。しかし、クライアント 側 の 内 容 を
ロギングする 場 合 は、アクティビティモニタで 参 照 するために 処 理 内 容 をサーバに 転 送 する 必 要 があります。
各 クライアントのコンテキストは、キャッシュメモリ 内 の 自 身 の 処 理 内 容 を 記 録 します。リッチクライアントモジュールは、 以
下 の 場 合 、サーバ 側 に 対 しクライアントの 処 理 内 容 を 消 去 させます。
• サーバに 対 する 次 のリッチクライアントモジュールのアクセスが 発 生 した 場 合
• ロジックユニットが 終 了 した 場 合 。 例 えば、[レコード 前 ]が 終 了 した 場 合 、リッチクライアントモジュールはサーバ 側
に 対 し 処 理 内 容 を 消 去 させます。
重 要
アプリケーションのデバッグを 行 うとパフォーマンスが 低 下 します。
デバッグ 機 能 を 止 めたい 場 合 は、[デバッグ]メニューの[デバッグモード]をクリックしてください。
クライアントの 異 常 終 了
クライアントが 異 常 終 了 する 場 合 が 時 々あります。このような 場 合 は、 最 後 の 処 理 内 容 が 記 録 されない 可 能 性 があります。 障 害
が 発 生 した 直 前 にどのような 処 理 が 実 行 されたか 理 解 する 必 要 があります。これらの 処 理 は、サーバ 上 には 格 納 されないため、
アクティビティモニターでは 参 照 できません。
クライアント 側 の 異 常 終 了 をデバッグするには:
1. HTML ファイルの "LogClientSequenceForActivityMonitor" フラグを「Yes」に 設 定 します。HTML ファイルは、リッチク
ライアントインタフェースビルダで 作 成 されます。フラグが「Yes」に 設 定 されると、クライアントの 動 作 がクライア
ント 側 のローカルログファイルとして 書 き 込 まれます。このログファイルは、サーバにまだ 送 信 されなかったすべての
情 報 が 含 まれています。ログファイルは、 各 イベントの 実 行 後 、またはアプリケーションの 終 了 時 に 後 削 除 されます。
41

リッチインターネットアプリケーションのチュートリアル
2. もう 一 度 アプリケーションを 起 動 します。Magic xpa は、 既 存 のログファイルをスキャンします。 異 常 終 了 時 にログ
ファイルが 見 つかると、これらをサーバに 送 信 します(そして、アクティビティモニターに 表 示 します)。
3. 異 常 終 了 が 発 生 すると、 他 の 全 ての 並 行 処 理 も 終 了 します(これらのログファイルは、 通 常 削 除 されます)。
4. アプリケーションを 再 開 してください。クライアントの 最 後 の 処 理 内 容 が 記 録 されたログファイルがサーバに 送 信 され
ます(そして、アクティビティモニターに 表 示 されます)。
5. アクティビティモニターは、クライアントログによって 更 新 されます。これで、 問 題 の 発 生 箇 所 を 確 認 することができ
ます。
ノート
アクティビティモニターの 行 は、サーバ 処 理 がピンクで、クライアント 処 理 が 白 で 色 分 けされます。
ネットワーク 情 報 の 表 示
[リッチクライアント 形 式 ]フォームでは、ステータスバーでネットワーク 状 態 を 表 示 することができます。ネットワーク 情 報
は、ステータスバーの 右 の 表 示 領 域 上 でマウスポインタをホバーリングさせることで 表 示 されます。プログラムが Magic xpa
Enterprise Studio から 実 行 された 場 合 、この 機 能 は 常 に 有 効 になります。プログラムが 実 行 エンジンで 実 行 する 場 合 は、アプリ
ケーションの 起 動 に 使 用 される HTML ファイルの DisplayStatisticInformation パラメータを 以 下 のように 修 正 することで 有 効 にな
ります。
42

リッチインターネットアプリケーションのチュートリアル
第 8 章 実 行 環 境
今 まで 説 明 してきたよう、リッチクライアント・アプリケーションを 作 成 して、テストするためには .NET についての 知 識 は 余
り 必 要 ではありません。しかし、アプリケーションをインストールしようとする 場 合 、 実 行 環 境 に 精 通 していることが 役 に 立 ち
ます。
リッチクライアントアプリケーションを 実 行 させる 場 合 、 外 部 に 公 開 する 必 要 のあるアプリケーションの 要 素 があると 同 時 に、
公 開 したくない 要 素 もあります。 従 って、Magic リッチクライアントアプリケーションに 対 して 安 全 な 環 境 を 構 築 する 上 で、ア
プリケーションの 要 素 は 以 下 の 二 つに 分 類 することができます。
• 内 部 向 けのリソースファイル……これらは、ECF、 基 本 色 定 義 、フォント 定 義 、ユーザ 定 義 、などの Magic エンジンが
アクセスするためだけに 必 要 なローカルファイルです。 内 部 ファイルは、Web サーバによってアクセス 可 能 にしないで、
プロジェクトフォルダ 内 のような ECF が 置 かれているフォルダ 付 近 に 配 置 してください。
• 外 部 向 けのリソースファイル……これらは、HTML やマニフェスト、PDF などのクライアント 側 でアクセスする 必 要 が
あるファイルです。 外 部 ファイルは、Web サーバを 経 由 してアクセススすることが 可 能 であり、Web サーバのエイリア
スや、リッチクライアントインタフェースビルダによって 作 成 されるアプリケーションの 公 開 エイリアスを 使 用 して 公
開 されます。
実 行 の 準 備
リッチクライアントの 実 行 モジュールが .NET Framework の 環 境 で 実 行 できるように、リッチクライアントアプリケーションを
デプロイする 必 要 があります。
リッチクライアントの 実 行 環 境 は、インターネット 環 境 で 実 行 されることを 意 図 しているため、 使 用 されているテクノロジを 理
解 しておくことを 推 奨 します。
リッチクライアントモジュール
すべてのタスク 情 報 とデータは、.NET モジュールを 使 用 して 処 理 され 実 行 されます。このモジュールは、 実 際 のクライアント
エンジンとして 実 行 されます。
リッチクライアントフォルダ
Magic xpa のインストール 処 理 によって、インストールフォルダ 内 に 以 下 の 3 つのサブフォルダを 作 成 します。
• Scripts …… インターネットリクエスタファイルが 格 納 されます。
• RIACache …… タスクやイメージ、メニューのためにキャッシュデータを 格 納 します。
• PublishedApplications …… HTML やマニフェストのような 公 開 する 必 要 のあるファイルの 格 納 先 です。
これらのフォルダは、インストールディレクトリ 内 に 作 成 されます。これらは、 次 のセクションで 説 明 する Web エイリアスで
管 理 されます。
Web エイリアス
Web エイリアスは、リッチクライアントアプリケーションを 実 行 するために 必 要 です。
• Magic2xScripts …… Scripts ディレクトリを 参 照 しています。
• Magic2xRIAApplications …… PublishedApplications ディレクトリ を 参 照 しています。
これらの 設 定 内 容 は、アプリケーションの 内 容 に 応 じて 変 更 することもできます。
動 作 環 境 設 定
リッチクライアントキャッシュの 位 置 は、 必 要 に 応 じて 変 更 することができます。この 設 定 は、Magic xpa の[ 動 作 環 境 ]ダイ
アログの[アプリケーションサーバ]タブで 行 うことができます。
• リッチクライアントキャッシュパス …… アプリケーションサーバがリッチクライアントのキャッシュファイルを 書 き
込 む 物 理 ディレクトリ(デフォルト:< インストールディレクトリ >\RIACache)を 指 定 します。
43

リッチインターネットアプリケーションのチュートリアル
モジュール
分 散 型 アプリケーション・アーキテクチャー:
Magic xpa によって 提 供 されます。
Web サーバ:
リモートクライアントからリクエストを 受 け 取 るために、Web サーバが 必 要 です。Web サーバは、Magic xpa サーバにリクエス
トを 送 ります。
インターネットリクエスタ:
クライアントと Magic xpa サーバの 間 を 仲 介 するモジュール。このモジュールは、サーバのプールで 1 つのアイドル 状 態 の Magic
サーバにリクエストとデータを 渡 すことができます。これによって 負 荷 を 分 散 します。
MRB(リクエストブローカ MRB):
Magic xpa サーバのプールを 維 持 します。Magic xpa は、リクエストブローカとして 知 られているミドルウェアエージェントを 提
供 します。MRB は、 利 用 可 能 なすべての Magic サーバエンジンを 処 理 して、インターネットリクエスタから 利 用 可 能 なサーバ
エンジンへの 各 リクエストを 指 示 します。MRB は、 様 々なフェールオーバーに 対 応 するため、ロードバランシング 機 能 やリカ
バリ 機 能 を 提 供 します。
Magic サーバ:
Magic xpa サーバは、インタラクティブなリッチクライアント・アプリケーション 環 境 の 中 心 にあります。これは、 実 際 の 実 行
時 単 位 で、 各 リクエストを 処 理 して、 受 け 取 った 各 タイプのリクエストに 対 応 した 全 てのアプリケーション・ロジックを 実 行 し
ます。Magic サーバは、MRB の 位 置 を 認 識 しており、それに 接 続 し、それ 自 体 でインターネットリクエスタを 利 用 できるよう
にする 必 要 があります。
Magic サーバエンジンは、 一 回 のエンジンプロセスを 使 用 して 複 数 のリクエストを 処 理 するように 設 計 されています。これは、
Magic xpa サーバエンジンがマルチスレッド 機 能 を 使 用 して 実 現 しています。
モジュールの 分 散
上 記 のモジュールは 同 じマシン 上 にインストールしたり、 異 なる OS を 使 用 した 異 なるマシン 上 に 分 散 させることもできます。
Magic xpa のインストール 処 理 とアプリケーションサーバによって、 必 要 なモジュールのインストールと 実 行 のための 環 境 設 定
は 自 動 的 に 行 われます。インターネットリクエスタは、クライアント 側 から 送 られるリクエストを 処 理 します。インタネットリ
クエスタは、Magic エンジンと 異 なる PC 上 に 置 くこともできます。
図 8-1 この 図 は、リッチクライアントがどのようにアプリケーションサーバと 通 信 し、どのよ
うに 返 り、 分 散 されている Magic xpa モジュール 間 でどのように 相 互 作 用 しているかを 表 して
います。
44

リッチインターネットアプリケーションのチュートリアル
リッチクライアントの 必 要 条 件
RIA アプリケーションは、クライアントに 以 下 のソフトウエアがインストールされることを 必 要 条 件 とします。
• .NET Framework …… Windows Vista SP1 以 上 の OS ではすでにインストールされています。 従 って、 改 めてインストール
する 必 要 はありません。
これらのインストールパッケージは、Magic xpa の PublishedAoApplications\RIA フォルダ 内 にコピーされており、これを 使 用
して 手 動 でインストールすることができます。
リッチクライアントインタフェースビルダによって 作 成 された HTML ファイルは、これらのインストール 処 理 を 簡 単 に 行 うこ
とができるように、ガイダンスを 表 示 しています。これについては、 後 で 説 明 します。
ノート
.NET フレームワーク V2.0 SP2 を 使 用 する 場 合 、 再 配 布 可 能 な Microsoft Visual C++ 2008 をインストールする 必
要 があります。Scripts\RIA フォルダ 内 の NetFx20SP2_x86.exe と VCRedist_x86.exe ファイルを 実 行 することに
よって、インストールすることができます。
.NET フレームワーク V3.5SP1 がインストールされている 場 合 は 不 要 です。
ClickOnce
ClickOnce は Microsoft 社 によって 開 発 されたテクノロジーで、Web から 直 接 .Net アプリケーションを 実 行 させることができま
す。このテクノロジーによって、クライアントアプリケーションをインターネットからだけだけでなくデスクトップ 環 境 からも
実 行 されることが 可 能 になります。
ClickOnce を 使 用 する 利 点 の 一 つは、(.NET Framework や MsHtmlSetup などの 必 要 条 件 を 除 き) 管 理 者 権 限 を 必 要 としないでア
プリケーションをインストールしたり、アップグレードできる 方 法 が 提 供 できることです。
注 意
Web サーバに、.NET のインストール 処 理 が 組 み 込 まれていない 場 合 、MIME タイプ 拡 張 を 定 義 する 必 要 があり
ます。
以 下 の 操 作 で 定 義 できます。
1. IIS を 開 きます。
2. Web サイトのプロパティを 開 きます。
3.[HTTP ヘッダー]タブをクリックします。
4.[MIME マップ]グループ 上 の[ファイルの 種 類 ]ボタンをクリックします。
5. ウィンドウが 開 いたら、[ 追 加 ]ボタンをクリックします。
6. 以 下 の 値 を 設 定 します。
拡 張 子
.manifest
.application
コンテンツの 種 類
application/x-ms-manifest
application/x-ms-application
.NET マニフェストファイル
アプリケーションを 実 行 するためのフレームワークが 得 られたら、アプリケーションをどのように 実 行 するかを 定 義 する 必 要 が
あります。つまり、Magic アプリケーションをどのように 認 識 し、 実 行 させるかを Click Once に 教 える 必 要 があります。これに
ついては、.NET のマニフェストファイルで 経 由 で 実 現 できます。ここには、Click Once の 起 動 メカニズムをどのように 組 み 込
むかを 定 義 する 記 述 が 含 まれています。
Magic xpa のリッチクライアントインタフェースビルダ
Magic xpa では、「リッチクライアントインタフェースビルダ」と 呼 ばれる、 簡 単 に .NET マニフェストファイルを 定 義 すること
ができるユーティリティを 提 供 しています。これは、プロジェクトを 開 いている 状 態 でプルダウンメニューから[オプション /
インタフェース ビルダー / リッチクライアント]を 選 択 することで 起 動 することができます。
45

リッチインターネットアプリケーションのチュートリアル
このユーティリティは、 必 要 な 手 順 をウィザード 形 式 で 示 しながら HTML とマニフェストファイルを 作 成 していくものです。こ
のウィザードでは、Click Once で 起 動 されるリッチクライアントモジュールの 名 前 を 指 定 します。1 つの Magic アプリケーショ
ンに 対 して 複 数 のリッチクライアントモジュールとマニフェストファイルを 定 義 することもできます。
ユーティリティ 内 で、リッチクライアントモジュールが 読 み 込 まれた 場 合 、 最 初 に 起 動 するプログラムを 指 定 します。 起 動 され
るプログラムは、[ 公 開 名 ]カラムと[ 外 部 ]カラムが 設 定 されていなければなりません。
リッチクライアントインタフェースビルダは、2つの 外 部 ファイルを 作 成 します。
• HTML ファイル …… クライアントでの Click Once の 有 効 性 をチェックし、 必 要 であればインストールします。ここに
は、 起 動 プログラムなどのいくつかのアプリケーション 実 行 環 境 などの XML 定 義 が 含 まれています。
• マニフェストファイル …… サーバパスなどのアプリケーション 環 境 が 含 まれています。
ノート
マニフェストファイルと HTML ファイルは、 常 に Web サーバ 上 の 同 じフォルダに 配 置 してください。
Magic エンジンをアップデートした 場 合 、マニフェストファイルを 必 ず 再 作 成 してください。
マニフェストファイルの 保 護
.NET のマニフェストファイルを 実 行 させるためには、 証 明 書 を 使 用 して 署 名 する 必 要 があります。これはリッチクライアント
インタフェースビルダを 使 用 する 際 に、 証 明 書 とそのパスワードを 指 定 することで 可 能 になります。
ノート
Magic xpa のインストール 時 に 提 供 されたテスト 用 の 証 明 書 (test.pfx)は、 発 行 元 が 確 認 できないため 運 用 環 境
では 使 用 しないことを 推 奨 します。 通 常 は、 発 行 元 が 確 認 できるような 特 定 機 関 の 証 明 書 を 使 用 してください。
マニフェストファイルの 変 更
インタフェースビルダで 作 成 されたマニフェストファイルは 署 名 されているため、テキストエディタで 変 更 すると 使 用 できなく
なります。 通 常 は、 運 用 環 境 を 元 にマニフェストファイルを 作 成 して 配 布 することを 推 奨 します。マニフェストファイルの 作 成
後 にファイルを 修 正 する 場 合 は、 修 正 後 にマニフェストファイルを 手 動 で 署 名 し 直 す 必 要 があります。
マニフェストファイルを 署 名 するには、Microsoft 社 が 提 供 しているツールユーティリティ(Mage.exe または、MageUI.exe)を
使 用 します。これは、.NET Framework の SDK に 同 梱 されているツールで、Microsoft 社 のサイトからダウンロードすることがで
きます。Mage.exe は、Magic xpa Enterprise Studio のインストールフォルダにもコピーされています。
マニフェストファイルの 変 更 は、 以 下 の 手 順 で 行 います。
1. テキストエディタでマニフェストファイルを 修 正 します。 以 下 の 行 以 外 は、 修 正 しないでください。
•
•
2. 以 下 のコマンドを 実 行 し、マニフェストファイルを 署 名 します。
mage -Sign xxx.application -Certfile text.pfx -Password test
• xxx.application ……マニフェストファイル 名
• text.pfx ……Magic xpa が 提 供 している 証 明 書 ファイル。Magic xpa Enterprise Studio のインストールフォルダ 内 の
Buiders\RC にコピーされています。 特 定 機 関 によって 発 行 された 証 明 書 がある 場 合 は、そのファイルを 指 定 してくだ
さい。
• test …… 証 明 書 でマニフェストに 署 名 する 場 合 に 使 用 するパスワード。Magic xpa が 提 供 している 証 明 書 ファイルを 使
用 する 場 合 は、「test」と 指 定 してください。 特 定 機 関 によって 発 行 された 証 明 書 を 使 用 する 場 合 は、その 証 明 書 用 のパ
スワードを 指 定 してください。
ノート
• html ファイルは、 署 名 する 必 要 がありません。
• ツールの 詳 細 説 明 は、Microsoft 社 の 以 下 のサイトを 参 照 してください。
http://msdn.microsoft.com/ja-jp/library/acz3y3te%28VS.80%29.aspx
46

リッチインターネットアプリケーションのチュートリアル
実 行 モード
リッチクライアント・アプリケーションを 正 しく 実 行 させるには、Magic エンジンの 実 行 モードを「バックグラウンド」に 設 定
する 必 要 があります。オンラインモードは、 開 発 環 境 でアプリケーションをデバッグする 際 に 使 用 してください。
初 期 プログラム
外 部 からプログラムを 呼 び 出 す 場 合 は、このプログラムの[ 外 部 ]カラムをチェックする 必 要 があります。
このプログラムのフォームは SDI として 定 義 することを 推 奨 します。
このプログラムが 起 動 されると、 新 しいコンテキストが 自 動 的 にオープンされ、その 後 のすべてのプログラムはそのタスクツ
リー 内 で 実 行 されます。
ノート
リッチクライアントの MDI を 使 用 する 場 合 は、 初 期 プログラムは 必 要 ありません。
アプリケーションの 実 行
アプリケーションをデプロイすると、URL を 指 定 して HTML ファイルを 開 くことでアクセスできます。URL を 指 定 してアプリ
ケーションをインストールする 処 理 は、PC 上 で 最 初 にアプリケーションを 実 行 する 場 合 のみ 必 要 です。 最 初 にアプリケーショ
ンを 起 動 する 際 に、ClickOnce はスタートメニューにアプリケーション 起 動 用 のショートカットを 作 成 します。 次 回 アプリケー
ションを 起 動 する 場 合 は、このショートカットをクリックするだけになります。 従 って、ClickOnce をスタートするために 初 期
起 動 時 のみ Web ブラウザを 利 用 します。
既 知 の Web ブラウザの 問 題
• Google Chrome …… このブラウザを 使 用 した 場 合 、ダウンロードエリアにマニフェストファイルをダウンロードするだ
けで、 実 行 させることはできません。
• Fire Fox …… このブラウザは、ClickOnce アプリケーションを 実 行 するためのアドオンが 提 供 されています
(https://addons.mozilla.org/en-US/firefox/addon/1608)。
他 の 既 知 の 問 題
ClickOnce は、 統 合 プロキシ 認 証 のみサポートしています。 基 本 認 証 、フォーム 認 証 等 はサポートしません。
ユーザ 認 証
ユーザー 認 証 は、オンライン 環 境 と 同 じように 実 装 されているため、 同 じように 扱 うことができます。
アプリケーションを 起 動 するとき、ユーザー 認 証 が 必 要 かどうかは 動 作 環 境 (MAGIC.INI)で 指 定 します。ログオンダイアログ
を 必 要 とする 場 合 、 実 行 エンジンは Magic xpa のログオンダイアログを 表 示 します。
アプリケーションの 起 動 時 に 環 境 変 数 を 取 得 する
アプリケーションの 起 動 時 に 環 境 変 数 を 取 得 する 場 合 は、HTML ファイル 内 の envvars パラメータに 環 境 変 数 を 指 定 することで
可 能 になります。この 設 定 は、リッチクライアントインタフェースビルダを 使 用 する 際 に 指 定 することができます。
これらの 環 境 変 数 はサーバに 送 られ、リッチクライアントモジュールがクライアント 側 で 読 み 込 まれる 前 に 取 得 することができ
ます(ClientOSEnvGet 関 数 とは 対 照 的 です)。この 方 法 を 使 用 することで、GetParam 関 数 で 環 境 変 数 を 取 得 し、それに 応 じた 初
期 設 定 処 理 を 行 うことができます。
アプリケーションにパラメータを 渡 す
起 動 時 の URL を 使 用 してリッチクライアントにパラメータを 渡 すことができます。このパラメータの 値 は、GetParam 関 数 を 使
用 することでアプリケーション 側 で 取 得 することができます。
例 えば、リッチクライアントアプリケーションを 以 下 の URL で 起 動 した 場 合 を 想 定 します。
http://server/Magic2xRIAApplications/projects/project.application?N1=v1&N2=v2
v1 の 値 は GetParam('N1') で、v2 の 値 は GetParam('N2') で 取 得 できます。 指 定 できる 値 は 文 字 データのみで、UTF-8 でエンコード
されます。このため 日 本 語 を 渡 す 場 合 は、アプリケーション 側 で UTF8toAnsi 関 数 を 使 用 して 変 換 する 必 要 があります。
47

リッチインターネットアプリケーションのチュートリアル
第 9 章 オフラインアプリケーションの 開 発
アプリケーションにオフライン 機 能 とローカル・データソースと 追 加 すると、アプリケーションの 性 能 を 向 上 させることがで
き、ネットワーク 上 のトラフィックを 減 らすことができます。
詳 細 は『オフラインアプリケーションの 開 発 』を 参 照 してください。
48

リッチインターネットアプリケーションのチュートリアル
第 10 章 モバイル 用 の RIA アプリケーションの 開 発
モバイル 端 末 からアプリケーションに 接 続 できたら 非 常 に 便 利 になります。モバイル 端 末 上 で 実 行 されるアプリケーションを 開
発 するために、RIA テクノロジーを 使 用 することができます。これによりデスクトップ 上 での RIA アプリケーションと 同 じルッ
ク&フィールを 持 つことができます。
詳 細 は、『モバイル RIA 開 発 者 ガイド』を 参 照 してください。
49