uniPaaS V1Plus 移行ガイド - Magic Software Enterprises

V9Plus 開 発 者 のための
uniPaaS V1Plus
移 行 ガイド
Enabling Business with Superior Technology

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

目 次
目 次 ...................................................................................... 3
1. はじめに................................................................................ 5
1.1. 本 書 の 目 的 .......................................................................... 5
1.2. 前 提 条 件 ............................................................................ 6
1.3. 本 書 で 使 う 表 記 ...................................................................... 7
2. 移 行 パス................................................................................ 8
2.1. V10 および uniPaaS V1からの 移 行 .................................................... 8
2.2. V10 以 前 のバージョンからの 移 行 ...................................................... 8
2.3. 移 行 のための 旧 バージョン............................................................ 9
3. V9Plusから 移 行 時 の 留 意 事 項 .............................................................. 11
3.1. V9よりの 関 数 の 変 更 .................................................................. 11
3.2. サポートされなくなった 機 能 .......................................................... 11
3.2.1. Web Online...................................................................... 11
3.2.2. HTMLフォーム.................................................................... 12
3.2.3. エディット コマンド ............................................................ 12
3.2.4. 動 作 環 境 ........................................................................ 12
3.3. 作 業 ディレクトリ.................................................................... 12
3.3.1. 作 業 ディレクトリの 変 更 .......................................................... 12
3.3.2. 既 定 義 の 論 理 名 .................................................................. 13
3.3.3. コンポーネントの 場 合 ............................................................ 13
3.4. RM 互 換 ロジックユニット.............................................................. 13
3.4.1. RM 互 換 ハンドラの 作 成 ............................................................ 13
3.4.2. 参 照 コマンド .................................................................. 14
3.4.3. データビューとの 同 期 ............................................................ 14
3.4.4. TAB 順 序 ........................................................................ 14
3.4.5. 行 間 の 移 動 ...................................................................... 14
3.4.6. コマンドの 定 義 .................................................................. 15
3.4.7. RM 互 換 ロジックユニットの 実 行 時 動 作 .............................................. 16
3.5. コマンドの 種 類 ...................................................................... 16
3.6. ファントムタスク.................................................................... 19
3.6.1. Ver 9.40J SP3 での 機 能 拡 張 とは?................................................ 19
3.6.2. 機 能 拡 張 の 波 及 と 対 応 方 法 ........................................................ 19
3.7. TAB 順 序 ............................................................................ 20
3.7.1. 自 動 / 手 動 TAB 順 序 の 設 定 ........................................................ 20
3.7.2. 手 動 TAB 順 序 .................................................................... 20
3.7.3. 自 動 TAB 順 序 .................................................................... 21
3.7.4. TAB 順 序 の 表 示 .................................................................. 21

3.8. GUI 特 性 の パーク カテゴリ.......................................................... 22
4. V9Plusでのリポジトリ 出 力 ................................................................ 23
4.1. リポジトリ 出 力 時 の 注 意 事 項 .......................................................... 23
4.2. リポジトリ 出 力 ファイルの 確 認 ........................................................ 23
5. 移 行 ユーティリティの 処 理 プロセス........................................................ 25
5.1. 移 行 処 理 の 内 容 ...................................................................... 25
5.2. ユーザ 定 義 イベントの 強 制 終 了 パラメータ.............................................. 26
5.3. パーキング 関 係 の 設 定 ................................................................ 27
5.4. 照 会 リンクの 移 行 .................................................................... 28
5.5. V9Plusコンバータのパラメータ........................................................ 30
5.6. ログファイル........................................................................ 30
6. GUI エンハンサ.......................................................................... 33
6.1. GUI エンハンサとは?................................................................ 33
6.2. GUI エンハンサの 利 用 方 法 ............................................................ 34
7. INI 変 換 ユーティリティ.................................................................. 36
7.1. INI 変 換 ユーティリティとは?........................................................ 36
7.2. INI 変 換 ユーティリティの 使 い 方 ...................................................... 37
8. 権 利 設 定 とセキュリティファイル.......................................................... 38
8.1. 権 利 設 定 の 変 更 ...................................................................... 38
8.2. セキュリティファイル................................................................ 38
9. ビルダデータコンバータ.................................................................. 40
10. dbMAGIC V8.2 からの 移 行 ................................................................ 41
10.1. V9Plus での 色 / フォントテーブル 変 換 は 不 要 .......................................... 41
10.2. テーブルのタイトルが 消 える........................................................ 42
11. トラブルシューティング................................................................ 44

1. はじめに
Magic uniPaaS V1Plus をお 使 いいただきまして、ありがとうございます。Magic uniPaaS V1Plus は、
高 い 生 産 性 と 保 守 性 を 誇 る Magic パラダイムの 歴 史 の 上 に、 最 新 のテクノロジを 融 合 して、マルチプ
ラットフォーム、マルチ DBMS、マルチパラダイムの 高 度 な RADD (Rapid Application Development
and Deployment)/ 複 合 アプリケーション (Composite Application) 開 発 ツールです。
Magic 製 品 により 実 現 されるシステム 形 態 は、スタンドアロンの 小 規 模 なものから 大 規 模 なクライアン
トサーバのオンラインシステム、およびサーバベースの Web アプリケーション、XML や Web サービス、
J2EE 対 応 アプリケーション(サーバ、クライアント 共 )、リッチクライアント (RIA、Rich Internet
Application)など、 非 常 に 広 範 囲 にわたります。
本 書 では、すでに Magic eBusiness Platform V9Plus をご 利 用 されている Magic 開 発 者 を 対 象 に、
Magic uniPaaS V1Plus での 新 機 能 をフォーカスして 解 説 するものです。
本 書 は、V9Plus から uniPaaS V1Plus へ 移 行 しようとする 読 者 を 対 象 に 書 かれています。
V10 や uniPaaS V1 (Ver 1.5)から uniPaaS V1Plus への 移 行 は、リポジトリ 出 力 ・ 入 力 によ
り 非 常 にスムースに 行 うことができますので、 本 書 では 必 要 最 小 限 の 事 項 のみに 限 って 説 明
しています。
Magic uniPaaS V1Plus の 新 機 能 は 多 岐 にわたるので、 本 書 の 限 られた 範 囲 では 基 本 的 な 機 能 紹 介 だけ
を 行 っています。より 詳 細 な 機 能 については、リファレンスマニュアル、 開 発 者 ガイド、 添 付 サンプ
ルアプリケーション、 弊 社 ホームページ (http://www.magicsoftware.co.jp) の 技 術 情 報 などを 参 照
されることをお 勧 めいたします。
1.1. 本 書 の 目 的
uniPaaS V1Plus では、 多 様 な 先 進 機 能 を 実 現 すると 同 時 に、 過 去 のバージョンとの 互 換 性 維 持 にも 努
めた 結 果 、V9 から uniPaaS V1Plus への 移 行 はたいへん 容 易 に 行 うことができるようになっています。
本 書 では、V10 以 前 の Magic バージョンから uniPaaS V1Plus へ 移 行 する 場 合 の 移 行 パス、 注 意 点 、 移
行 手 順 などについて 説 明 します。
本 章 の 内 容 の 詳 細 については、リファレンスマニュアルの 以 下 の 箇 所 を 参 考 にしてください
uniPaaS V1Plus へのマイグレーショ
ンの 詳 細
RM 互 換 レベル
作 業 ディレクトリ
権 利 設 定
内 部 イベント(アクション)
マイグレーション の 章
ロジックエディタ → ロジックユニット → RM 互 換
プロジェクトとアプリケーション → プロジェクト 開 発 → プ
ロジェクトディレクトリの 取 得
プロジェクトとアプリケーション → アプリケーション 実 行
認 証 システム → 実 行 /APG 権 利
Magic エンジン → エンジン 実 行 レベル → イベントレベル →
イベント 一 覧
1 章 はじめに 5

1.2. 前 提 条 件
本 書 の 読 者 は、 次 のような 前 提 条 件 を 満 たしていることが 必 要 です。
PC に 関 する 基 礎 知 識 ● テキストファイル、HTML ファイルを 参 照 ・ 作 成 するためのエディタの 使
い 方 を 知 っている。
● インストーラを 使 ってプログラムをインストール・アンインストールす
ることができる。
● Windows XP の 環 境 についての 基 本 的 な 知 識 を 持 っている。
Magic 開 発 に 関 する
知 識
データベースに 関 す
る 知 識
Web サービスに 関 す
る 知 識
XML に 関 する 知 識
1. Magic V9Plus を 使 って 6 ヶ 月 以 上 の 経 験 がある。
2. 以 下 の 話 題 について 基 本 的 な 知 識 がある。
● データベース
● Web サービス
● XML
3. 次 の 言 葉 を 良 く 理 解 している。
● DLL
● Unicode
● 関 数
● Windows コントロール
● 並 行 実 行
● コンテキスト
● イベント
● デバッガ
● ブレークポイント
● バージョン 管 理
● Java
次 のような、データベースに 関 する 基 本 的 な 知 識 がある。
● データベース
● テーブル
● 行 /レコード
● フィールド/カラム
● インデックス
● Datetime
● ストアド プロシージャ
次 のような Web サービスに 関 する 言 葉 を 理 解 している。
● UDDI
● WSDL
● RPC/ドキュメント 形 式
次 のような XML に 関 する 言 葉 を 理 解 している。
● XSD (スキーマ)
● 要 素
● 複 合 要 素
● 名 前 空 間
1 章 はじめに 6

1.3. 本 書 で 使 う 表 記
本 書 では、 次 のようなアイコンを 使 っています。
参 考 : 補 足 的 な 説 明 を 簡 単 に 記 述 します。
操 作 : Magic を 実 際 に 操 作 する 手 順 を 説 明 します。
TIPS: 知 っておくと 便 利 な 豆 知 識 を 紹 介 します。
注 意 : おちいりやすい 落 とし 穴 、 間 違 えやすい 事 柄 などを 示 します。
V9Plus との 比 較 : V9Plus との 差 異 点 を 対 照 して 説 明 します。
1 章 はじめに 7

2. 移 行 パス
移 行 の 手 順 は、もとのアプリケーションのバージョンにより、 以 下 のように 異 なります。
●
●
●
V10 あるいは uniPaaS V1 (Ver 1.5SP1x) のアプリケーション
V9Plus で、Ver 9.4SP6a あるいはそれ 以 降 のバージョンのアプリケーション
V9Plus Ver 9.4SP6a より 以 前 のバージョンのアプリケーション
以 下 に、それぞれについて 説 明 いたします。
2.1. V10および uniPaaS V1からの 移 行
V10 および uniPaaS V1 から uniPaaS V1Plus への 移 行 は、もとのバージョンの Studio でプロジェクト
をリポジトリ 出 力 し、uniPaaS Studio V1Plus でリポジトリ 入 力 することにより 行 います。
V10/uniPaaS V1からuniPaaS V1Plusへの 移 行
Magic Studio V10/
uniPaaS Studio V1
プロジェクト
uniPaaS Studio V1Plus
リポジトリ 入 出 力
Magic Studio V10/
uniPaaS Studio V1
リポジトリ 入 出 力
uniPaaS V1Plus
プロジェクト
V10/uniPaaS V1
リポジトリ 出 力 形 式
V10/uniPaaS V1 からの 移 行 時 、 新 機 能 の 追 加 や、 細 かな 動 作 変 更 などにより、 完 全 に 以 前
のバージョンと 同 じ 動 作 でない 場 合 があります。 詳 細 については、README などにより 確 認
してください。
V10 および uniPaaS V1 からの 移 行 は 通 常 スムーズに 行 くので、 本 書 ではこれ 以 上 の 詳 細 については 省
略 します。
2.2. V10 以 前 のバージョンからの 移 行
uniPaaS V1Plus のプロジェクトは XML をベースとするソース 形 式 ファイルなので、uniPaaS V1Plus へ
の 移 行 は、 過 去 のバージョンのリポジトリ 出 力 形 式 ファイルを、uniPaaS V1Plus 添 付 の V9Plus コン
2 章 移 行 パス 8

バータにより、uniPaaS V1Plus のプロジェクト 形 式 に 変 換 することにより 行 います。
ここで 注 意 が 必 要 なのは、V9Plus コンバータは、Ver 9.4SP6a およびそれ 以 降 のリポジトリ 出 力 形 式
ファイルのみを 入 力 とすることができることです。このため、 次 に 示 すように、 移 行 前 の MCF のバー
ジョンにより、 移 行 手 順 が 異 なります。
Ver9.4SP6a 以 前 のバージョンからuniPaaSへの 移 行
1 V9Plus
(V9.4SP6b)
2 V9 ~ V9Plus MCF
(V9.01 ~ V9.4SP3c)
3 V8.2MCF
4 旧 バージョンMCF
(V7.1 以 前 )
V9Plus
コンバータ
(uniPaaS V1 添 付 )
V9Plus 開 発 版
(V9.4SP6a)
リポジトリ 入 出 力
各 々のバージョン
の 開 発 版 で
リポジトリ 入 出 力
V8.2 開 発 版 で
リポジトリ 入 出 力
各 々のバージョン
の 開 発 版 で
リポジトリ 入 出 力
V9Plus
(V9.4SP6a)
リポジトリ 出 力 形 式
各 バージョン
リポジトリ 出 力 形 式
各 バージョン
リポジトリ 出 力 形 式
uniPaaS V1
プロジェクト
ケース 移 行 前 のバージョン 手 順
上 図 1
上 図 2
又 は 3
V9.4SP6a
およびそれ 以 降
1. V9Plus Ver 9.40J SP6a 以 降 で、アプリケーション 全 体
をリポジトリ 出 力 します。
2. その 後 、uniPaaS V1Plus 製 品 に 添 付 の V9Plus コンバータ
プログラムを 用 いて、uniPaaS V1Plus 形 式 のプロジェク
トに 変 換 します。
V8.2 ~ V 9.40J SP3c いったん V9Plus Ver 9.4J SP6a 以 降 に 移 行 した 上 で、 上 記
手 順 を 行 ってください。
上 図 4 V4 ~ V7 まず V8.2 に 移 行 し、 更 に V9Plus Ver 9.4J SP6a 以 降 に 移
行 した 上 で、 上 記 手 順 を 行 ってください。
2.3. 移 行 のための 旧 バージョン
上 記 のように、V9Plus Ver9.4SP6a より 以 前 のバージョンから uniPaaS V1Plus にアプリケーション
を 移 行 するには、V9Plus Ver9.4SP6a、あるいは、V8.2 が 必 要 となります。Magic uniPaaS V1Plus 製
品 には、 開 発 者 の 移 行 の 便 のために、V9Plus Ver9.4SP6a および V8.2K4SP2 の 簡 易 版 が 同 梱 されてい
ます。
2 章 移 行 パス 9

注 意 : これらのバージョンは、 移 行 目 的 のためだけに 提 供 されますので、 次 のような 制 限
があります。
基 本 的 に、リポジトリ 入 力 と 出 力 を 行 うためにだけ 利 用 します。
開 発 ・ 実 行 機 能 も 利 用 できますが、 移 行 の 確 認 と 最 小 限 必 要 な 修 正 のためにだけ 利 用 してくださ
い。アプリケーション 単 純 移 行 の 目 的 を 超 える、 新 しいアプリケーション 開 発 や 新 しい 機 能 の 追
加 のために 利 用 することは 認 められていません。
Web 機 能 実 行 のためのモジュール 類 (MRB、リクエスタ、ブラウザクライアントモジュール 等 )の
インストール・ 設 定 は 行 われません。
実 運 用 環 境 で 利 用 することは 認 められません。
使 用 権 は、ご 購 入 になった uniPaaS Studio V1 製 品 に 準 ずるものとし、 特 定 の PC1 台 にのみイン
ストール 可 能 です。
2 章 移 行 パス 10

3. V9Plusから 移 行 時 の 留 意 事 項
uniPaaS V1Plus への 移 行 を 容 易 にするため、V9Plus の 開 発 版 で、アプリケーションを 見 直 しておき
ましょう。 本 章 では、V9Plus アプリケーションを uniPaaS V1Plus に 移 行 する 場 合 に 考 慮 すべき 事 項 に
ついて、 主 要 なものを 説 明 します。
3.1. V9よりの 関 数 の 変 更
サポートされなくなった 関 数 : 以 下 の 関 数 は、uniPaaS V1 ではサポートされなくなりま
した。V9Plus で 予 め 削 除 しておくか、あるいは 別 の 方 法 に 変 更 してください。
DSTR3 ISTR EVAL TSTR3 EuroCnv
DVAL3 IVAL RVAL TVAL3 EuroDel
ESTR LSTR RSTR VAL3 EuroGet
FLOW3 LVAL STR3 Pref EuroSet
EuroUpd
関 数 名 の 変 更 : 以 下 の 関 数 は、uniPaaS V1 で 名 前 が 変 わりました。
V9Plus での 名 前 uniPaaS V1 での 名 前 V9Plus での 名 前 uniPaaS V1 での 名 前
IOCopy FileCopy ASC ASCIIVal
IODel FileDelete CHR ASCIIChr
IOExist FileExist MaxMagic WinMaximize
IORen FileRename MinMagic WinMinimize
IOSize FileSize ResMagic WinRestore
CtrlName LastClicked MTblSet1 MTblSet
名 前 の 変 更 された 関 数 は、V9Plus コンバータ(V9Plus よりのマイグレーションユーティリ
ティ)が 自 動 的 に 改 名 します。V9Plus コンバータについては、 第 5 章 「 移 行 ユーティリ
ティの 処 理 プロセス」で 説 明 します。
3.2. サポートされなくなった 機 能
uniPaaS V1Plus でサポートされなくなった 以 下 のような 機 能 については、V9Plus で 予 め 削 除 しておく
か、あるいは 別 の 方 法 に 変 更 しておくことをお 勧 めします。
3.2.1. Web Online
uniPaaS V1Plus では、Web Online の 機 能 はサポートされなくなりました。V9Plus コンバータは、
WebOnline 関 係 のフォームはすべて 削 除 します。 従 って、このフォームを 参 照 している データ 出 力 コ
3 章 V9Plusから 移 行 時 の 留 意 事 項 11

マンドはシンタックスエラー となります。
3.2.2. HTMLフォーム
uniPaaS V1Plus では、インターフェースタイプが HTML のフォームをサポートしなくなりました。
V9Plus コンバータは、HTML フォームを 削 除 し、HTML フォームを 参 照 しているデータ 出 力 コマンドでは、
フォーム 番 号 が 0 となります。
これに 関 連 して、 以 下 のような 変 更 がなされています。
項 目 やモデルで、スタイル セクション 中 の HTML 形 式 特 性 が 削 除 されています。
モデルリポジトリでは、HTML 形 式 のクラスが 削 除 されています。
アプリケーション 特 性 では、インターネット 開 発 ファイルルート 特 性 が 削 除 されています。
APG では、インターネット オプションが 削 除 されています。
HTML マージ 形 式 は、 単 に マージ 形 式 と 改 名 しました。
3.2.3. エディット コマンド
エディット コマンドはサポートされなくなりました。V9Plus コンバータは、エディット コマンドを
OS コマンド タイプの 外 部 コール コマンドに 変 更 します。
3.2.4. 動 作 環 境
動 作 環 境 テーブルに 関 しては、 次 のような 変 更 があります。
マルチユーザ アクセス (マルチユーザ(M) タブ) は 削 除 されました。uniPaaS V1Plus では 常 に
マルチユーザアクセス = Yes の 動 作 をします。
Euro 関 係 の 機 能 が 削 除 されたことに 伴 い、 通 貨 変 換 ファイル ( 外 部 参 照 (E) タブ) が 削 除 されま
した。また、CTL 特 性 の 基 準 通 貨 および 通 貨 変 換 ファイル 特 性 が 削 除 されました。
Java のブラウザクライアント アプレットはサポートされなくなったので、アプリケーション
サーバ (N) タブのブラウザクライアント 方 式 パラメータが 削 除 されました。
3.3. 作 業 ディレクトリ
3.3.1. 作 業 ディレクトリの 変 更
uniPaaS V1Plus では、 実 行 時 の 作 業 ディレクトリが V9Plus と 異 なりますので、 注 意 が 必 要 です。
V9Plus では、アプリケーション 実 行 時 の 作 業 ディレクトリは、 実 行 エンジン mgrntw.exe を 起 動 した
ときの 作 業 ディレクトリでした。 起 動 時 作 業 ディレクトリはショートカットのプロパティなどで 設 定
することができます。
uniPaaS V1Plus では、プロジェクトファイル (.edp ファイル)、あるいはキャビネットファイル(.ecf
ファイル)のあるフォルダが 作 業 フォルダとなります。(プロジェクト/キャビネットファイルオープン
時 に 変 更 されます)。
この 変 更 のため、 相 対 パスを 指 定 して IO ファイルや Pervasive テーブルをオープンする 場 合 には、 異
なる 場 所 を 参 照 するようになる 可 能 性 があるので 注 意 が 必 要 です。 一 般 的 に 言 って、ファイル 名 を 指
定 する 場 合 、プログラムの 中 では 論 理 名 を 使 い、 論 理 名 テーブル 上 では 絶 対 パスで 定 義 するのが 一 番
トラブルが 少 ないといえます。
同 様 のことが、MAGIC.INI ファイル 中 の 他 の 設 定 についても 言 えます。
3 章 V9Plusから 移 行 時 の 留 意 事 項 12

3.3.2. 既 定 義 の 論 理 名
uniPaaS V1Plus では、Magic をインストールしたディレクトリと、 現 在 の 作 業 ディレクトリを 示 す 論
理 名 がエンジンで 定 義 されています。
論 理 名
対 応 する 実 行 名
EngineDir uniPaaS の 実 行 エンジン uniRTE.exe が 存 在 するディレクトリ 名 。
WorkingDir 作 業 ディレクトリ 名 。
これらの 論 理 名 は、Magic のエンジンで 自 動 的 に 定 義 されるので、 論 理 名 テーブルで 定 義 す
る 必 要 はありません。 論 理 名 テーブルで 定 義 したとしても 無 視 されます。
3.3.3. コンポーネントの 場 合
複 数 のコンポーネントからなるアプリケーションの 場 合 、 作 業 ディレクトリは 一 番 最 初 にオープンさ
れたキャビネットファイルの 存 在 するディレクトリとなります。これは、コンポーネント 中 のテーブ
ルやプログラムが 呼 び 出 され 実 行 されている 場 合 にも 変 わることはありません。
このため、コンポーネントとして 使 われている 場 合 には、「キャビネットファイルの 存 在 するディレ
クトリが、 作 業 ディレクトリになる」という 仮 定 は 成 り 立 たなくなります。キャビネットファイルを
基 準 として 相 対 パスでファイル 名 を 指 定 している 場 合 には、 単 体 のテストでは 正 しく 動 くが、コン
ポーネントとした 場 合 に 間 違 った 場 所 を 参 照 する、ということになってしまいますので、 注 意 してく
ださい。
3.4. RM 互 換 ロジックユニット
V9Plus のレコードメインには、データビューの 定 義 とともにロジックを 設 定 することができましたが
、uniPaaS V1Plus ではレコードメインがなくなり、データビューの 定 義 はデータビュー エディタで、
ロジックの 記 述 はロジックエディタで 行 うようになりました。
V9Plus でレコードメインにロジックを 記 述 していた 場 合 には、V9Plus コンバータは、レコードメイン
互 換 (RM 互 換 )という 特 殊 なハンドラをロジックエディタに 作 成 します。
3.4.1. RM 互 換 ハンドラの 作 成
V9Plusよりの 移 行
V9Plus コンバータは、V9Plus のアプリケーションを 変 換 中 に、レコードメインにロジックの 書 かれた
プログラムがあると、uniPaaS V1Plus で RM 互 換 ハンドラを 生 成 します。レコードメインにロジック
のないプログラムには、RM 互 換 ハンドラを 作 成 しません。
バッチタスクやブラウザクライアントタスクには、もともとレコードメインにロジックを 書 くことが
できないので、uniPaaS V1Plus に 変 換 する 際 にも RM 互 換 ハンドラが 作 成 されることはありません。
セレクトコマンドの 条 件 式
V9Plus で、セレクトコマンドに 設 定 されている 条 件 は、カーソルのパーキングを 制 御 しますが、
uniPaaS V1Plus に 変 換 されたプログラムでは、 対 応 するコントロールの パーキング 関 係 の 特 性 に 反
映 されます。
3 章 V9Plusから 移 行 時 の 留 意 事 項 13

パーキングについての 詳 細 は、5.3 パーキング 関 係 の 設 定 を 参 照 してください。
3.4.2. 参 照 コマンド
V9Plus では、レコードメインでデータ 項 目 の 定 義 にセレクトコマンドを 使 い、ロジックをその 間 に 記
述 することができました。
uniPaaS V1Plus での RM 互 換 ハンドラでは、セレクト コマンドの 変 わりに、データビュー エディタで
定 義 された 項 目 を 参 照 する 参 照 コマンドが 使 われます。
V9Plus でレコードメインに 定 義 してあったロジック (コールコマンド、エラーコマンド、 項 目 更 新 コ
マンドなど)は、uniPaaS V1Plus の RM 互 換 ハンドラでは、 参 照 コマンドの 間 に 挿 入 されます。
3.4.3. データビューとの 同 期
参 照 コマンドは、データビューでの 定 義 と 自 動 的 に 同 期 し、 開 発 者 が 参 照 コマンドを 追 加 ・ 削 除 ・
修 正 することはできません。
また、 次 のような 性 質 があります。
データビューでの 項 目 定 義 に 従 って 自 動 的 に 作 成 ・ 削 除 されます。
定 義 内 容 (データ 型 、 書 式 、 名 前 など)は、 表 示 専 用 です。
順 序 もデータビューでの 順 序 に 従 ったものです。
データビューでの 項 目 定 義 が 追 加 ・ 削 除 ・ 変 更 、あるいは 順 序 の 変 更 がされると、 参 照 もそれ
に 従 って 自 動 的 に 追 加 ・ 削 除 ・ 変 更 されます。
3.4.4. TAB 順 序
RM 互 換 ハンドラがあるタスクでは、V9Plus での TAB 順 序 と 同 じ 動 作 をさせるため、TAB 順 序 について
は、 次 のようになります。
自 動 TAB 順 序 は 無 効 化 されます。
コントロールの TAB 順 序 特 性 は 無 効 化 されます。
TAB 順 序 は、 項 目 がデータビューで 定 義 されている 順 序 になります。
3.4.5. 行 間 の 移 動
データビュー エディタと、ロジック エディタの RM 互 換 レベルの 相 互 参 照 関 係 は、マウスクリックで
簡 単 に 移 動 することができます。
3 章 V9Plusから 移 行 時 の 留 意 事 項 14

RM 互 換 レベルの 参 照 コマンドから、 対 応 するデータ
ビュー 定 義 に 移 動 するには・・・
1. RM 互 換 レベルの 参 照 コマンドにカーソルを 起 きます。
2. 右 クリックでコンテキストメニューを 開 き、 定 義 に 移 動 を 選 択 し
ます。
3. データビュー エディタに 移 り、 対 応 する 項 目 定 義 の 行 にカーソル
が 移 動 します。
逆 に、データビュー エディタ 上 での 項 目 定 義 の 行 か
ら、 対 応 する RM 互 換 ハンドラの 参 照 コマンドに 移
動 するには ・・・
1. データビュー エディタで、 項 目 を 定 義 するコマンド (C=カ
ラム、V= 変 数 、P=パラメータ) にカーソルを 置 きます。
2. 右 クリックでコンテキストメニューを 開 き、 参 照 に 移 動 を
選 択 します。
3. ロジックエディタに 移 動 し、 対 応 する 参 照 コマンドの 行 に
カーソルが 移 動 します。
定 義 に 移 動 、 参 照 に 移 動 は、メニュー 編 集 (E) → クイックアクセス(Q) のサブメニュー
からも 選 択 することができます。
3.4.6. コマンドの 定 義
V9Plus のレコードメイン 中 の
ロジックは、uniPaaS V1Plus
の RM 互 換 ハンドラに 移 行 され
ます。
ただし、すべてのオペレーショ
ンが RM 互 換 ハンドラ 中 で 定
義 できるわけではありません。 以 下 のような 制 限 に 留 意 してください。
ブロック コマンドの While オプション (V9Plus の Loop オプション) は 利 用 できません。
変 数 宣 言 (V9Plus のセレクト 変 数 コマンド) は 利 用 できません。
エラー コマンドの R= 復 帰 オプションは 利 用 できません。
3 章 V9Plusから 移 行 時 の 留 意 事 項 15

また、 他 のハンドラ 中 のコマンドと 違 い、RM 互 換 ハンドラのコマンドには 次 のようにフローモード と
フロー 方 向 のパラメータがあります。 これらは、V9Plus でのフローの 設 定 と 同 じ 意 味 です。
フローモード:
● S= 通 常
● F= 高 速
● C= 両 用
● B= 前 置
● A= 後 置
フロー 方 向 :
● F= 前 方
● B= 広 報
● C= 両 方 向
3.4.7. RM 互 換 ロジックユニットの 実 行 時 動 作
RM 互 換 ハンドラは、V9Plus におけるレコードメインのように 動 作 します。すなわち、カーソルがコン
トロールから 別 のコントロールに 移 動 するときには、RM 互 換 ハンドラ 中 の 対 応 する 参 照 コマンドの
間 に 定 義 されたロジックが、 条 件 やフロー 定 義 に 従 って 実 行 されます。
参 照 コマンドは ブロック コマンドで 囲 んで 条 件 付 けすることもできます。この 場 合 には、カーソル
は、コントロール 特 性 の パーキング 関 係 の 設 定 と、ブロックコマンドの 条 件 とをあわせた 条 件 に 従 っ
て、パーキングの 可 ・ 不 可 が 決 定 されます。
3.5. コマンドの 種 類
uniPaaS V1 のコマンドは、V9Plus と 基 本 的 に 同 じですが、 概 念 的 に 整 理 されています。
V9Plus 以 前 のコマンド uniPaaS V1 のコマンド 補 足
コメント コメント 変 更 なし
項 目 更 新 項 目 更 新 変 更 なし
コール (プログラム、サブタスク、
式 、 公 開 名 、リモート)
コール (UDP, Web サービス、COM)、
OS コマンド
コール
外 部 コール
アクション アクション 変 更 なし
ブロック、
ブロック 終 了
ブロック
エラー エラー 変 更 なし
uniPaaS V1 のコールコマンドは、
Magic プログラムを 呼 び 出 す 場 合 に
使 う
Magic 以 外 のものを 呼 び 出 す 場 合 に
使 う。
V9Plus 以 前 の ブロック 終 了 は、ブ
ロック の End タイプとなった。
データ 入 力 、データ 出 力 フォーム フォーム コマンドのタイプとして、
入 力 、 出 力 を 指 定 するようになった
3 章 V9Plusから 移 行 時 の 留 意 事 項 16

イベント 実 行 イベント 実 行 変 更 なし
セレクト 変 数 項 目 イベントハンドラ、 項 目 変 更 ハンド
ラで、パラメータやローカル 変 数 を
定 義 する 場 合 に 用 いる。
セレクト (カラム、 変 数 、パラメー
タ)
(データビュー)
データビュー エディタで、カラム、
変 数 、パラメータとして 定 義 する。
リンク (データビュー) データビュー エディタで、リンクコ
マンドとして 定 義 する。
エディット ( 対 応 なし) 廃 止
コール と 外 部 コール コマンド
uniPaaS V1 では、コール と 外 部 コール という 2 種 類 のコマンドが
あります。
●
コール コマンドは、 他 の Magic プログラムを 呼 び 出 す 場 合 に 使
います。コール コマンドのタイプとしては、 以 下 のものがあり
ます。
P=プログラム
S=サブタスク
同 一 プロジェクト、あるいはコンポーネント 中
の 他 のプログラムを 呼 び 出 します。
自 分 の 下 に 定 義 されているサブタスクを 呼 び 出
します。
E= 式 プログラム 番 号 を 数 値 型 で 指 定 してプログラム
を 呼 び 出 します。
N= 公 開 名 コンポーネントリポジトリに 定 義 されていない
コンポーネントを、プロジェクトファイル 名 と
プログラムの 公 開 名 を 直 接 指 定 することにより
、 呼 び 出 します。
R=リモート
リモートマシン 上 で 動 作 している、Magic アプリ
ケーションサーバ 上 のプログラムを、MRB のサー
ビス 名 とプログラムの 公 開 名 を 指 定 することに
より 呼 び 出 します。
3 章 V9Plusから 移 行 時 の 留 意 事 項 17

外 部 コール コマンドは、Magic 以 外 のモジュールを 呼 び 出 す 場
合 に 使 います。これには、 以 下 のものが 該 当 します。
COM
OS コマンド
UDP
Web サービス
Web サービス
ライト
.NET
COM モジュールを 呼 び 出 します。ActiveX 型 の
変 数 と、メソッド 名 を 指 定 します。(リッチク
ライアントタスクでは 利 用 できません)
OS レベルで 実 行 する 実 行 可 能 モジュール
(EXE や BAT ファイル) を 実 行 します。
DLL として 定 義 された 外 部 ユーザ 定 義 関 数 を
実 行 します。DLL のファイル 名 と、 公 開 され
ている 関 数 名 を 指 定 します。
Web サービスとして 公 開 されているサービス
を 呼 び 出 します。Web サービスのインフラと
して、Systinet を 使 います。
Web サービスのインフラとして、Easycom を 使
います。
.NET のスクリプトを 実 行 します。(リッチク
ライアントタスクでだけ 利 用 できます。)
ブロック コマンド
ブロックコマンドは 基 本 的 に V9Plus と 同 じですが、 細 かな 変 更 があ
ります。
●
●
V9Plus の ブロック ループ は、ブロック While と 名 前 が 変 わ
りました。
V9Plus の ブロック 終 了 コマンドは、ブロック End となりま
した。
フォーム コマンド
V9Plus の データ 入 力 とデータ 出 力 コマンドは、uniPaaS V1 では
フォーム という 一 つのコマンドになりました。フォーム コマンドの
タイプとして、 入 力 か 出 力 かを 指 定 するようになっています。
V9Plus の セレクト コマンド
V9Plus の セレクト コマンドは、いくつかの 機 能 を 持 っていましたが、uniPaaS V1 では 次 のように 整
理 されています。
3 章 V9Plusから 移 行 時 の 留 意 事 項 18

V9Plus のセレクトコマンドの 機 能
レコードメインで、 実 項 目 、 変 数
項 目 、パラメータ 項 目 を 定 義 する
イベントハンドラ 内 で、イベント
のパラメータ、あるいはハンドラ
内 でのみ 用 いる 変 数 項 目 を 定 義 す
る。
利 用 場 所
データビュー 画 面
ロジック エディタの、イベン
トハンドラ
uniPaaS V1
方 法
C=カラム、V= 変 数 、P=パラメー
タ 行 として 定 義 する。
項 目 コマンドとして 定 義 する。
(uniPaaS V1 新 機 能 ) 項 目 変 更 ハンドラ 項 目 コマンドとして、パラメー
タなどを 定 義 する。
3.6. ファントムタスク
ファントムタスクとは、タスク 特 性 の「ウィンドウのクローズ」を No に 設 定 して、タスクが 終 了 し
た 後 も 画 面 が 表 示 され 続 けるタスクです。オンラインの 1:N のタスクでよく 使 われる 手 法 です。
Ver 9.40J SP3 において、Magic のイベントドリブンアーキテクチャとの 親 和 性 を 向 上 させるため、マ
ウスによるタスク 間 のフォーカスの 移 動 方 法 が 拡 張 されました。この 機 能 拡 張 は uniPaaS V1Plus でも
有 効 です。
その 結 果 、Ver 9.40J SP3 よりも 古 いバージョンからアプリケーションを uniPaaS V1Plus に 移 行 する
場 合 、この 機 能 拡 張 の 影 響 を 検 討 し、 必 要 ならばプログラムの 修 正 が 必 要 になります。
3.6.1. Ver 9.40J SP3での 機 能 拡 張 とは?
Ver 9.40J SP3 より 以 前 のバージョンでは、マウスクリックによりファントムタスクにフォーカスを 移
動 するには、レコードメインにファントムタスクの 呼 び 出 しのためのコールコマンドが 定 義 されてい
る 必 要 がありました。この 場 合 、 親 タスクにカーソルがある 状 態 でファントムタスク( 子 タスク)をク
リックすると、 現 在 止 まっているカーソルに 対 応 する 項 目 のセレクトコマンドから、そのコールコマ
ンドまでの 間 のコマンドが 高 速 モードで 実 行 され、コールコマンドが 実 行 されて 子 タスクに 制 御 が 移
ります。
Ver 9.40J SP3 からは、レコードメインだけでなく、 他 のハンドラレベル(コントロール 前 処 理 / 後 処 理 、
イベントハンドラなど)にコールコマンドが 定 義 されている 場 合 でも、ファントムタスク 呼 び 出 しのた
めに 使 われるようになりました。この 場 合 、 親 タスクにカーソルがある 状 態 でファントムタスク( 子 タ
スク)をマウスでクリックすると、 親 タスクの
1. レコードメイン
2. 有 効 なイベントハンドラ( 下 から 上 に 向 けて)
の 順 に、ファントムタスク 呼 び 出 しのコールコマンドがあるかを 検 索 します。 見 つかったら、 現 在
フォーカスのある 項 目 から、そのコールコマンドまでの 間 に 定 義 されているコマンドは、 当 該 イベン
トハンドラ 中 で 定 義 されているものも 含 め、 実 行 されるようになります。
3.6.2. 機 能 拡 張 の 波 及 と 対 応 方 法
この 機 能 拡 張 の 波 及 効 果 として、Ver 9.40J SP1a およびそれ 以 前 の 旧 バージョンから 移 行 を 行 うと、
プログラムの 構 造 によっては、この 機 能 拡 張 によって、ファントムタスクにカーソルが 移 動 してほし
くないときに 移 動 してしまう、という 現 象 が 起 こる 可 能 性 があります。
このような 場 合 には、 次 のようにファントムタスクを 呼 び 出 すコールコマンドに 条 件 付 けを 行 い、 不
要 なときにコールコマンドが 実 行 されないように、プログラムを 修 正 してください。
● コントロール 後 処 理 でファントムタスクを 呼 び 出 している 場 合 、コールコマンドに Level(0) =
'CS_コントロール 名 ' というような 条 件 を 付 けてください。
3 章 V9Plusから 移 行 時 の 留 意 事 項 19

●
プッシュボタンのイベントハンドラでファントムタスクを 呼 び 出 している 場 合 には、
LastClicked ()='ボタンのコントロール 名 ' という 条 件 を 付 けてください。
3.7. TAB 順 序
V9Plus までは、オンラインフォーム 上 のカーソルの TAB 順 序 ( 移 動 順 序 )は、レコードメインでのセレ
クトコマンドの 順 番 に 従 っていました。
uniPaaS V1 では、データビューエディタでの 項 目 の 定 義 順 序 と、オンラインフォーム 上 での TAB 順 序
とは 関 係 がなくなり、 次 のいずれかの 方 法 により TAB 順 序 が 決 められます。
手 動 TAB 順 序
自 動 TAB 順 序
3.7.1. 自 動 / 手 動 TAB 順 序 の 設 定
自 動 タブ/ 手 動 タブは、フォームエディタを 開 いて、 描 画 (R) → 表 示 順 (O) → 自 動 TAB 順 序 (B) メ
ニュー、あるいは コマンド パレットの 自 動 TAB 順 序 ボタンによりトグルさせることができます。
3.7.2. 手 動 TAB 順 序
手 動 タブ 順 序 では、コントロール 特 性 として TAB 順 序 という 数 値 型 の 特 性 があり、ここに 設 定 されて
いる 値 が 小 さいものから 大 きなものへ、カーソルが 移 動 していきます。
手 動 タブ 順 序 のモードでは、TAB 順 序 特 性 を 開 発 者 が 設 定 できます。TAB 順 序 の 値 を 開 発 者 が 変 更 し
た 場 合 には、Magic は 他 のコントロールの TAB 順 序 を 自 動 的 に 裁 番 しなおします。
3 章 V9Plusから 移 行 時 の 留 意 事 項 20

TAB 順 序 特 性 の 値 は、 式 で 設 定 することもできます。 式 で 設 定 した 場 合 には、すべてのコントロール
の 式 が 評 価 され、ソートされ、 値 の 小 さい 順 に TAB 順 序 が 決 まります。
3.7.3. 自 動 TAB 順 序
自 動 タブ 順 序 では、フォーム 上 のコントロールを、 次 の 順 序 で 移 動 します。
1. 画 面 上 で 上 にあるコントロールから、 下 にあるコントロールへ。
2. 水 平 位 置 が 同 じ 複 数 のコントロールがある 場 合 には、 左 から 右 へ。
これは 通 常 の 場 合 、 画 面 操 作 上 、もっとも 自 然 なカーソルの 動 きとなります。
3.7.4. TAB 順 序 の 表 示
TAB 順 序 は、 描 画 (R) → 表 示 順 (O) → TAB 順 序 表 示 (S) メニュー、あるいは コマンド パレットの
TAB 順 序 表 示 ボタンで 表 示 させることができます。
3 章 V9Plusから 移 行 時 の 留 意 事 項 21

3.8. GUI 特 性 の パーク カテゴリ
GUI コントロールには、パーク というカテゴリが 新 たに
設 定 されました。
ここには、 次 のようなコントロール 特 性 があります。
特 性 説 明 モデルリポジトリにある
か?
TAB 順 序
パーキング 可
TAB で 移 動
TAB 移 動 方 向
手 動 TAB 順 序 の 場 合 、カーソルの 移 動 する 順 序 を 数 値 で 設
定 します。 実 行 時 には、 値 の 小 さい 順 にカーソルが 移 動 し
ます。
自 動 TAB 順 序 の 場 合 には、 無 効 化 され、 開 発 者 は 設 定 でき
ません。この 場 合 には、 値 として、 自 動 的 に 生 成 された
TAB 順 序 の 値 が 設 定 されます。
カーソルがこのコントロールにパークすることができるか
を 設 定 します。
Yes の 場 合 には、パーク 可 能 です。No の 場 合 には、TAB
キー、マウスクリックに 関 わらず、パークすることはでき
ません。
TAB キーによりカーソルを 動 かす 場 合 に、カーソルがこの
コントロールにパークするかを 設 定 します。
Yes の 場 合 には、パークします。No の 場 合 にはパークしま
せん。
いずれの 場 合 にも、ユーザはマウスクリックによってカー
ソルをパークさせることは 可 能 です。
TAB キーによりカーソルを 動 かす 場 合 、カーソルの 動 く 方
向 によりパークの 可 否 を 設 定 した 場 合 に 設 定 します。
F= 前 方 のみ の 場 合 には、 順 方 向 で 動 くときのみパークし
ます。
C= 後 方 のみ の 場 合 には、 逆 方 向 で 動 くときのみパークし
ます。
B= 両 方 向 の 場 合 (デフォルト)には、いずれの 場 合 もパー
クします。
なし
あり
あり
あり
3 章 V9Plusから 移 行 時 の 留 意 事 項 22

4. V9Plusでのリポジトリ 出 力
準 備 作 業 が 終 わったら、V9Plus でアプリケーションをリポジトリ 出 力 します。
4.1. リポジトリ 出 力 時 の 注 意 事 項
重 要 : リポジトリ 出 力 に 際 しては、 以 下 の 項 目 が 必 須 となりますので、 必 ず 確 認 してくだ
さい。
V9Plus のバージョンは、9.4S6a あ
るいはそれ 以 上 であること。
それより 以 前 のバージョンでリ
ポジトリ 出 力 をしたものは、
V9Plus コンバータで 受 け 付 けま
せん。
V9Plus のバージョンは、ヘルプ
→ Magic 情 報 メニューで 確 認
することができます。
CONST ファイルとして、mgconstw.jp2
を 使 っていること。
使 用 している CONST ファイルは、 設
定 → 動 作 環 境 メニューで 外 部 参
照 タブを 開 くと 確 認 できます。
CONST ファイルの 設 定 を 変 更 した 後
は、Magic をいったん 終 了 して 再 起
動 してください。
これ 以 外 の CONST ファイルを 利 用 し
ている 場 合 には、アプリケーションで 使 っているアクション 名 が 正 しく 変 換 されない 場 合 があり
ます。
4.2. リポジトリ 出 力 ファイルの 確 認
リポジトリ 出 力 ファイルがすでにある 場 合 、 上 の 注 意 事 項 に 従 ってリポジトリ 出 力 がなされたかどう
か 確 認 したい 場 合 には、 次 の 点 をチェックしましょう。
Magicバージョンの 確 認
リポジトリ 出 力 をした Magic のバージョンは、リポジトリ 出 力
ファイルの 先 頭 に 記 録 されます。 右 図 にあるように、キーワード
VRSN= の 値 が 940.06 以 上 であれば OK です。それ 以 下 の 場 合 に
は、V9Plus Ver 9.4SP6a 以 降 のバージョンで、リポジトリ 入 力 ・
出 力 が 必 要 です。
VRSN=940.06
APPLICATION=Y
MODEL=Y
TABLE=Y
PROGRAM=Y
MAIN_PROGRAM=Y
4 章 V9Plusでのリポジトリ 出 力 23

CONSTファイルの 確 認
リポジトリ 出 力 時 に 使 った CONST ファイルが 何 であったかは、アクション 名 を 調 べてチェックするこ
とができます。リポジトリ 出 力 ファイルをテキストエディタなどで 開 き、「’ACT」 をキーワードと
して 文 字 列 検 索 してみてください。アクションを 使 っているアプリケーションならば、いくつかヒッ
トすると 思 います。 例 えば、 以 下 のように 使 われているでしょう。
EXP="1",
EXP="KbGet (1)=' 終 了 'ACT OR KbGet (1)='キャンセル(C)'ACT",
EXP="Flow ('C')",
ここで 出 力 される ACT のリテラル 名 は、CONST により 違 っています。 以 下 にいくつかの 代 表 的 なアク
ションを 示 します。
mgconstw.jp2 の 場 合
( 正 しい)
mgconstw.jpn の 場 合
( 正 しくない)
mgconst.eng の 場 合
( 正 しくない)
' 終 了 'ACT 'E: 終 了 'ACT 'Exit'ACT
'キャンセル(C)'ACT 'C: 取 消 'ACT 'Cancel'ACT
'クローズ(C)'ACT 'C:クローズ'ACT 'Close'ACT
' 次 項 目 'ACT ' 次 項 目 'ACT 'Next Field'ACT
'ズーム(Z)'ACT 'ズーム'ACT 'Zoom'ACT
アクション 名 をチェックして、 正 しく mgconstw.jp2 で 出 力 されているかを 確 認 してください。
4 章 V9Plusでのリポジトリ 出 力 24

5. 移 行 ユーティリティの 処 理 プロセス
前 節 の 内 容 に 従 って、V9Plus でアプリケーションの 修 正 を 行 った 後 、リポジトリ 出 力 を 行 います。そ
の 後 、uniPaaS V1Plus が 提 供 する V9Plus コンバータにより、uniPaaS V1Plus が 読 み 込 めるプロ
ジェクトファイルを 作 成 します。
5.1. 移 行 処 理 の 内 容
ここでは、V9Plus コンバータが 実 行 する 処 理 を 簡 単 に 説 明 します。
項 目
説 明
タスクレイヤー メインテーブルとデータリンクの 定 義 などは、データビューエディタに 移 動
します。
タスクのロジック 部 分 は、ロジックエディタに 移 動 します。
タスクのフォームは、フォームエディタにまとめます。
DB テーブル
タスク/レコー
ドレベルのハン
ドラ
レコードメイン
中 のロジック
コマンド
リンク 照 会 の
確 認 オプショ
ン
コントロール 変
更 ハンドラ
強 制 終 了 =レ
コード のイベ
ント
パーキング 設 定
DB テーブルでの 追 加 テーブルは、データビュー エディタの 宣 言 コマンドに 移 動
されます。
V9Plus のレコード 前 処 理 、 後 処 理 、タスク 前 処 理 ・ 後 処 理 は、ロジック エディタ
の、それぞれ 対 応 するハンドラに 配 置 されます。
V9Plus でレコードメインで 定 義 されていたロジックは、ロジックエディタの RM 互
換 レベルに 移 動 させられます。
V9Plus のコマンドは uniPaaS V1Plus のコマンドと 1 対 1 に 対 応 していません。コ
マンド 体 系 の 違 いについては、3.5「コマンドの 種 類 」 を 参 照 してください。
リンク 照 会 では、リンクが 失 敗 した 場 合 にエラーメッセージを 出 す 確 認 オプ
ションがありましたが、uniPaaS V1Plus ではこの 機 能 はサポートされていません。
V9Plus コンバータは、 確 認 が Yes のリンク 照 会 コマンドを、リンク 照 会 コマン
ドと エラー コマンドとに 分 けます。
V9Plus でのコントロール 変 更 は、uniPaaS V1Plus では 項 目 変 更 ハンドラに 置 き
換 えられます。
もし 同 一 のコントロールに 対 してコントロール 変 更 ハンドラが 定 義 されており、 異
なる 条 件 付 けがされている 場 合 には、 同 等 の 動 作 を 行 うように 変 換 します。
もし 同 一 の 項 目 が 異 なるフォームに 配 置 されており、それぞれのコントロールにそ
れぞれのコントロール 変 更 ハンドラが 定 義 されていた 場 合 には、MainDisplay() 関
数 (V10 からの 新 関 数 )により 条 件 付 けがされます。
コントロールでの 変 更 以 外 の 変 更 によるハンドラの 実 行 を 防 止 するため、ハンドラ
の 内 容 はブロックコマンドを 使 い、「 変 更 理 由 パラメータ = 0」という 条 件 付 け
がされます。
ユーザ 定 義 イベントで、 強 制 終 了 パラメータが レコード となっていたイベント
は、レコード 更 新 前 に 変 更 されます。 強 制 終 了 パラメータについては、5.2 ユー
ザ 定 義 イベントの 強 制 終 了 パラメータ を 参 照 してください。
オンラインプログラムで、あるコントロールのカーソルのパークについての 設 定 は
、V9Plus では セレクト コマンドの 条 件 式 やフロー 設 定 により 決 定 されていまし
た。
5 章 移 行 ユーティリティの 処 理 プロセス 25

uniPaaS V1Plus では、セレクトコマンドの 条 件 、というものがなくなったので、コ
ントロールの 特 性 としてパーキング 関 係 の 設 定 を 行 うようになりました。
パーキングについて 詳 しくは、5.3「パーキング 関 係 の 設 定 」 および 、3.7「TAB
順 序 」を 参 照 してください。
関 数 名 の 変 更
リテラル
特 性 の 削 除
メモ 型 データ
コール Web サー
ビスコマンド
Unicode
uniPaaS V1Plus ではいくつかの 組 み 込 み 関 数 で 名 前 の 変 更 がありました。(3.1「V9
よりの 関 数 の 変 更 」を 参 照 。)
V9Plus コンバータでは、これらの 関 数 が 式 中 で 使 われている 場 合 、 自 動 的 に 名 前 を
変 更 します。
uniPaaS V1Plus では、 以 下 のリテラルの 記 号 が 変 更 になりました。
ACT → EVENT
KEY → INDEX
FILE → DSOURCE
V9Plus コンバータは、これらのリテラル 記 号 を 変 更 します。
uniPaaS V1Plus では EURO 関 係 の 機 能 はサポートされないので、EURO 関 係 の 特 性 は
すべて 削 除 されます。V9Plus コンバータは、EURO 関 係 のパラメータを 削 除 した 場
合 、その 旨 エラーメッセージをログに 記 録 します。
メモ 型 データはサポートされなくなりました。メモ 型 は、 文 字 型 に 変 換 され、デー
タの 互 換 性 を 維 持 するため、 記 憶 形 式 は String Memo あるいは Magic Memo に 設
定 されます。
Web サービスのフレームワークが uniPaaS V1Plus では 完 全 に 変 わるため、プログラ
ム 上 は V9Plus と 互 換 性 がありません。V9Plus で コール Web サービス が 使 われて
いる 場 合 、V9Plus コンバータは、 空 の 外 部 コール Web サービス コマンドに 変 換
します。 開 発 者 は、uniPaaS V1Plus に 移 行 後 、Web サービス 呼 び 出 しを 再 定 義 しな
くてはなりません。
uniPaaS V1Plus は Unicode をサポートするようになりました。V9Plus の 以 下 のオブ
ジェクトは、 自 動 的 に Unicode に 変 換 されます。
Unicode 文 字 を 格 納 するカラムのデータ 型 ( 文 字 型 から Unicode 型 に 変 換 )
メニューのエントリ テキスト
ヘルプ・ツールチップの 文 字 列
値 として 文 字 型 の 式 が 設 定 されているコントロールのデータ 型 ( 文 字 型 から
Unicode 型 に 変 換 )
プロパティシートに 設 定 される 種 々の 文 字 列
5.2. ユーザ 定 義 イベントの 強 制 終 了 パラメータ
V9Plus では、ユーザ 定 義 イベントの 強 制 終 了 パラメータには、
N=なし
E= 編 集
C=コントロール
R=レコード
という 4 つの 選 択 肢 がありました。
uniPaaS V1Plus では、R=レコード の 動 作 をより 正 確 に 表 現 するため、R=レコード 更 新 前 と 改 名 され
、また、あらたなオプションとして、P=レコード 更 新 後 が 追 加 されました。
5 章 移 行 ユーティリティの 処 理 プロセス 26

次 表 は、 強 制 終 了 パラメータ として R=レコード 更 新 前 あるいは P=レコード 更 新 後 となっている 場
合 に、 実 行 エンジンの 実 行 順 序 を 示 したものです。
# R=レコード 更 新 前 に 設 定 されている 場 合 P=レコード 更 新 後 の 場 合
1. コントロール 検 証 コントロール 検 証
2. コントロール 後 処 理 コントロール 後 処 理
3. レコード 後 処 理 レコード 後 処 理
4. [ユーザイベントのハンドラの 処 理 ]
5. レコード 更 新 レコード 更 新
6. レコード 前 処 理 ( 次 のレコードサイクルの 開
始 )
レコード 前 処 理 ( 次 のレコードサイクルの 開 始 )
7. [ユーザイベントのハンドラの 処 理 ]
8. コントロール 前 処 理 コントロール 前 処 理
これからわかるように、R=レコード 更 新 前 (V9Plus でのレコード) の 場 合 には、ユーザイベントのハ
ンドラが 実 行 されるタイミングでは、まだレコード 更 新 処 理 が 行 われておらず、 現 在 のレコードの 変
更 内 容 はまだ DBMS に 書 き 込 まれていません。
一 方 、P=レコード 更 新 後 の 場 合 には、ユーザイベントのハンドラはレコード 更 新 の 後 で 実 行 されるの
で、DBMS に 現 在 のレコードの 変 更 内 容 が 書 き 出 された 後 となります。
5.3. パーキング 関 係 の 設 定
オンラインプログラムで、あるコントロールのカーソルのパークについての 設 定 は、V9Plus では セレ
クト コマンドの 条 件 式 やフロー 設 定 により 決 定 されていました。 下 図 は、V9Plus でのレコードメイ
ンの 画 面 です。
uniPaaS V1Plus では、セレクトコマンドの 条 件 、というものが
なくなったので、コントロールの 特 性 としてパーキング 関 係 の
設 定 を 行 うようになりました。
以 下 のパーキング 関 連 のパラメータが、V9Plus コンバータによ
り、uniPaaS V1Plus の 対 応 するコントロール 特 性 に 設 定 されま
す。これらの 詳 細 については、3.7 TAB 順 序 を 参 照 してくださ
い。
5 章 移 行 ユーティリティの 処 理 プロセス 27

項 目 V9Plus uniPaaS V1Plus
パークの 可 ・ 不 可 セレクトコマンドの 条 件 で 制 御 コントロール 特 性 の パーキング 可 によ
り 制 御
TAB 移 動 方 向 による
パークの 可 ・ 不 可
TAB 順 序
セレクト コマンドの フロー パラ
メータで 設 定
レコードメインでのセレクトコマン
ドの 定 義 順
コントロール 特 性 の TAB 移 動 方 向 パラ
メータにより 設 定
コントロール 特 性 の TAB 順 序 パラメー
タにより 制 御 。
モードとして、 自 動 TAB 順 序 と 手 動
TAB 順 序 とがあります。
5.4. 照 会 リンクの 移 行
V9Plus では、Q= 照 会 リンクコマン
ドで 確 認 特 性 が Yes の 場 合 、リ
ンクが 成 功 するかどうかがチェック
され、リンクに 失 敗 した 場 合 には、
「レコードが 見 つかりません:
テーブル 名 」 というエラーメッ
セージが 出 て、フローはそこで 中 断
されました。( 右 図 )
これは 簡 便 な 機 能 ではありましたが
、エラーメッセージが 固 定 されて、
結 局 はリンク 結 果 を 格 納 する 論 理 型
変 数 とエラーコマンドとを 使 って、
プログラムで 対 応 する、ということ
が 多 くありました。
V9Plus での、 照 会 リンク ( 確 認 特 性 )
このようなことから、uniPaaS V1Plus では、リンクコマンドの 確 認 特 性 を 廃 止 しました。V9Plus か
らの 移 行 時 に 同 じ 動 作 をさせるために、V9Plus コンバータでは、 照 会 リンクコマンドを 次 のような 形
で 変 換 します。
1. リンク 結 果 を 格 納 する 論 理 型 変 数 を 追 加 します。 ( 以 下 の 説 明 では、RC_LNK_1 という 名 前 で 呼 び
ます)
2. リンクコマンドでは、 戻 り 値 特 性 で、 変 数 RC_LNK_1 を 設 定 します。
3. ロジックエディタの RM 互 換 レベルで、RC_LNK_1 の 直 後 にエラーコマンドを 追 加 します。 条 件 と
して、NOT(RC_LNK_1) とします。
5 章 移 行 ユーティリティの 処 理 プロセス 28

データビューエディタ
ロジックエディタ
V9Plus コンバータでは、V9Plus での 動 きとなるべく 同 じにするために、RM 互 換 レベルにエ
ラーコマンドを 入 れていますが、 新 しくタスクを 定 義 する 場 合 には、RM 互 換 レベルではな
く、コントロールレベルのハンドラ (コントロール 後 処 理 、あるいはコントロール 検 証 ハン
ドラ)にチェックロジックを 入 れるのが 適 当 です。
このやりかたでは、データビューに 論 理 型 の 変 数 が、リンクコマンドの 個 数 分 だけ 新 たに 追
加 されます。このため、 以 下 のような 条 件 の 場 合 、このプログラムにパラメータが 正 しく 渡
らなくなってしまうことがあります。
パラメータを、P=パラメータ ではなく、V= 変 数 で 渡 している。(V8.2 およびそれ 以 前 のプログラ
ムではこのようにしているので、V8.2 などから 移 行 するアプリケーションでは 要 注 意 です)
パラメータとして 使 っている V= 変 数 コマンドが、 照 会 リンクコマンドよりも 後 ろに 定 義 されて
いる。
このふたつの 条 件 がそろった 場 合 には、パラメータとして 使 っている V= 変 数 コマンドよりも 前 に、
リンク 結 果 を 格 納 する 論 理 型 変 数 が 定 義 されることになるので、パラメータの 順 序 が 変 わってしまい
ます。その 結 果 、パラメータが 正 しく 渡 らなくなることになります。
この 問 題 の 解 決 方 法 は、パラメータを P=パラメータ で 定 義 しなおすことです。こうすれば、リンク
結 果 を 格 納 する 論 理 型 変 数 がどこに 定 義 されていても、 正 しくパラメータと 変 数 が 区 別 されるので、
順 序 が 変 わってしまうことはありません。
5 章 移 行 ユーティリティの 処 理 プロセス 29

5.5. V9Plusコンバータのパラメータ
V9Plus コンバータは、コマンドラインのプログラムで、v9converter.exe という 名 前 で Magic をイン
ストールしたディレクトリにあります。
V9Plus コンバータは、 以 下 のようなパラメータを 受 け 付 けます。
パラメータ 必 須 ? 意 味
-Export 必 須 変 換 元 である V9Plus のリポジトリ 出 力 ファイル 名 を 指 定 します。
-Project 必 須 変 換 結 果 である uniPaaS V1Plus のプロジェクトファイルを 格 納 するディレク
トリ 名 をフルパス 名 で 指 定 します。もしこの 位 置 にすでに uniPaaS V1Plus プ
ロジェクトファイルが 存 在 していたら、 変 換 処 理 は 実 行 されず、 警 告 メッ
セージが 表 示 されます。
-LANG 必 須 言 語 パラメータを 設 定 します。 日 本 語 の 場 合 には、-LANG=JPN と 指 定 してく
ださい。
-LOCALS 必 須 国 ・ 地 域 に 固 有 な、パラメータを 指 定 します。 日 本 語 の 場 合 には、
-LOCALS=J,./:
と 指 定 してください。
文 字 の 意 味 は、 左 から、 日 付 モード(J)、 数 値 の 3 桁 区 切 り 文 字 (,)、 小 数 点
文 字 (.)、 日 付 セパレータ(/)、 時 刻 セパレータ(:) です。
-LOG 任 意 変 換 プロセスのログファイル 名 を 指 定 します。
-PREFIX 任 意 V9Plus のアプリケーションの 識 別 子 (2 文 字 ) を 指 定 します。テーブルリポ
ジトリで、テーブル 名 が 指 定 されていないテーブルのデフォルト 名 を 決 める
ために 使 います。
下 記 は、V9Plus コンバータを 利 用 する 例 です。( 実 際 には 行 を 分 けず、1 行 で 記 述 します)
”C:\Program Files\uniPaaS\Studio V1Plus\Projects\v9converter.exe”
-LANG=JPN -LOCALS=J,./:
-EXPORT=D:\Magic\Project\Petshop\PetShop.exp
-PROJECT=D:\Magic\Project\Petshop -PREFIX=DM
注 意 : -LANG および –LOCALS パラメータは、 日 本 語 環 境 では 必 須 です。
-LANG および –LOCALS パラメータをつけなくとも 変 換 プロセスは 一 見 正 常 終 了 するように 見 えます。
しかし、CONST 設 定 、 日 付 形 式 の 設 定 などが、 日 本 語 環 境 での 設 定 と 異 なった 状 態 で 変 換 されるため、
日 付 定 数 やイベントなどが 正 しく 変 換 されません。
5.6. ログファイル
V9Plus コンバータは、 変 換 処 理 の 過 程 での 種 々の 報 告 ・ 警 告 ・エラーメッセージを 出 力 します。これ
らはすべてコマンドライン 画 面 上 にも 表 示 されますが、ログファイルにも 記 録 されます。
ログファイルは、v9converter.exe へのコマンドラインパラメータ –LOG= で 指 定 します。このパラ
メータを 指 定 しない 場 合 には、デフォルトとして、 作 業 ディレクトリの 下 に、 (プロジェクト
名 )_cnv.log という 名 前 で 格 納 されます。
5 章 移 行 ユーティリティの 処 理 プロセス 30

以 下 は、V9Plus のペットショップデモを 変 換 したときのログの 例 です。
-+> Migrating table ‘ 制 御 ファイル’.
Attribute of field ‘ 顧 客 へのメッセージ’ changed from ‘Memo’ to ‘Alpha’
-+> Migrating table ‘ 顧 客 ファイル’.
Attribute of field ‘メモ’ changed from ‘Memo’ to ‘Alpha’
-+> Migrating table ‘ 商 品 ファイル’.
-+> Migrating table ‘ 受 注 ファイル’.
-+> Migrating table ‘ 受 注 明 細 ファイル’.
Processing task ‘メインプログラム’.
Task ‘メインプログラム’ migrated successfully.
Processing task ‘‘.
Task ‘‘ migrated successfully.
-+> Migrating table ‘ 制 御 ファイル’.
Attribute of field ‘ 顧 客 へのメッセージ’ changed from ‘Memo’ to ‘Alpha’
-+> Migrating table ‘ 顧 客 ファイル’.
Attribute of field ‘メモ’ changed from ‘Memo’ to ‘Alpha’
-+> Migrating table ‘ 商 品 ファイル’.
-+> Migrating table ‘ 受 注 ファイル’.
-+> Migrating table ‘ 受 注 明 細 ファイル’.
Processing task ‘メインプログラム’.
Task ‘メインプログラム’ migrated successfully.
Processing task ‘‘.
Task ‘‘ migrated successfully.
Processing task ‘ 制 御 ファイル 更 新 ONL’.
Task ‘ 制 御 ファイル 更 新 ONL’ migrated successfully.
( 途 中 省 略 )
Processing task ‘ 照 会 - 受 注 明 細 ファイル’.
Task ‘ 照 会 - 受 注 明 細 ファイル’ migrated successfully.
----> Internet development file root has been removed in this version.
----> Base Currency support has been removed in this version.
Saving application, please wait.
Application saved.
Conversion completed successfully.
Note:
1. Following functions have been renamed:
MINMagic() => WINMinimize()
MAXMagic() => WINMaximize()
ResMagic() => WinRestore()
Asc() => ASCIIVal()
CHR() => ASCIIChr()
CtrlName() => LastClicked()
Sys() => AppName()
IOExist() => FileExist()
IOSize() => FileSize()
IODel() => FileDelete()
IORen() => FileRename()
IOCopy() => FileCopy()
2. The ‘Check object list’ACT & ‘Save As MFF’ACT actions are deprecated.
3. The ‘HTML’ interface type for forms is deprecated.
4. Inheritance of the following GUI display table control properties is broken:
5 章 移 行 ユーティリティの 処 理 プロセス 31

‘Style’, ‘Table in Window’, ‘Row Highlight style’, ‘Border Style’,
‘Bottom Position Interval’, ‘Line Divider’ and ‘Column Divider’.
5. Inheritance of the all ‘Style’ properties of a blob field is broken.
5 章 移 行 ユーティリティの 処 理 プロセス 32

6. GUIエンハンサ
6.1. GUIエンハンサとは?
V9Plus コンバータを 使 って uniPaaS V1Plus の
プロジェクトを 作 れば、uniPaaS V1Plus で 動
くアプリケーションとなります。ここで、XP
テーマが 有 効 になっていれば、V9Plus のアプ
リケーションが、 自 動 的 に XP テーマ 対 応 の
ユーザインターフェースとなります。( 右 図 )
このユーザインターフェースでは、 確 かに、エ
ディットコントロールやボタンコントロールが
XP テーマ 対 応 になっているものの、テーブル
コントロールなどは V9Plus のままです。
uniPaaS V1Plus の GUI 機 能 を 生 かしきっている
とはいえません。
uniPaaS V1Plus に 移 行 直 後 の 画 面
V9Plus から 移 行 してきたアプリケーションが
簡 単 に uniPaaS V1Plus の GUI の 新 機 能 を 利 用
できるように、アプリケーション 全 体 の GUI 設
定 を 一 括 して uniPaaS V1Plus に 最 適 なものに
変 更 する GUI エンハンサ ウィザードが 用 意 さ
れています。
このユーティリティは、まず、オンライン
フォーム 上 のコントロールを、すべて Windows
スタイルにします。そして、ユーザの 指 定 によ
り、 以 下 の 設 定 をさせることができます。
● テーブルの 交 互 表 示 色 特 性
● テーブルの 区 切 り 特 性
● テーブルの カラムの 区 切 り 線 特 性
● 平 面 コントロールを uniPaaS V1Plus のス
タイルに 変 更
右 図 は、 上 のプログラムに GUI エンハンサを 適
用 後 、 一 部 手 作 業 で 手 直 しをした 画 面 です。
テーブルが Windows スタイルになっているのが
わかります。
GUI エンハンサ 適 用 後 、 一 部 手 作 業 で 修 正 した 画 面
6 章 GUIエンハンサ 33

6.2. GUIエンハンサの 利 用 方 法
GUI エンハンサを 利 用 するには・・・
1. スタートメニューから
uniPaaS Studio V1
→ マイグレーション
→ GUI エンハンサユーティリティ
を 選 びます。
2. 変 換 を 行 いたいプロジェクトのプロジェ
クトファイルを 指 定 します。
このとき 同 時 に、 実 行 時 の 基 本 色 定 義
ファイルも 指 定 します。
デフォルトでは、Magic uniPaaS V1Plus
に 添 付 されている、 実 行 時 基 本 色 定 義
ファイルとなります。
指 定 したら 次 へ(N) ボタンを 押 します。
3. 修 正 項 目 を 選 択 することができます。 選
択 肢 としては、 以 下 のような 項 目 をオ
ン/オフできます。
すべての GUI 表 示 テーブルの[ 交 互 表
示 色 ] 特 性 を 設 定
すべての GUI 表 示 テーブルの[ 区 切
り] 特 性 を 設 定
すべての GUI 表 示 テーブルの[カラム
の 区 切 り 線 ] 特 性 を 設 定
平 面 コントロールを uniPaaS V1Plus
用 のスタイルに 変 更
指 定 したら 次 へ(N) ボタンを 押 します。
6 章 GUIエンハンサ 34

4. 設 定 内 容 を 確 認 するダイアログが 表 示 さ
れます。 表 示 内 容 を 確 認 し、 正 しければ
次 へ(N) ボタンを 押 します。 処 理 が 開 始
されます。
まちがっているものがあれば、 戻 る(B)
ボタンを 押 して、 設 定 しなおします。
5. 処 理 が 終 了 すれば、 最 終 画 面 が 表 示 され
ます。
ここで、 今 変 換 したプロジェクトを
uniPaaS Studio で 開 きたい 場 合 には、
プロジェクトの 実 行 ボタンを 押 します。
別 のプロジェクトを 変 換 処 理 したい 場 合
には、 別 のプロジェクトを 修 正 ボタン
を 押 して、2 から 続 けます。
何 もせずに 終 了 する 場 合 には、 終 了 ボタ
ン(F) を 押 します。
6 章 GUIエンハンサ 35

7. INI 変 換 ユーティリティ
7.1. INI 変 換 ユーティリティとは?
MAGIC.INI ファイルには、 論 理 名 、データベース 定 義 、プリンタ 定 義 、その 他 のアプリケーションの
実 行 環 境 が 数 多 く 定 義 されています。アプリケーションをマイグレーションする 場 合 、アプリケー
ション 自 体 だけでなく、MAGIC.INI に 定 義 されている 環 境 設 定 も 正 しく 移 行 しなければなりません。
しかし、V9Plus と uniPaaS V1Plus とでは、MAGIC.INI の 定 義 形 式 が 異 なっているため、V9Plus で
使 っていた MAGIC.INI をそのまま uniPaaS V1Plus で 使 うことはできません。
ひとつひとつを 手 作 業 で 定 義 しなおす 手 間 を 省 くために、uniPaaS Studio V1 では V9Plus 形 式 の INI
ファイルを uniPaaS V1Plus 形 式 に 変 換 するユーティリティを 提 供 しています。これが INI 変 換 ユー
ティリティです。
INI 変 換 ユーティリティは、V9Plus の INI ファイルを 読 み 込 み、uniPaaS V1Plus の 標 準 INI ファイル
とマージするような 形 で 処 理 を 行 います。このため、ユーティリティには 次 のようなパラメータを 入
力 します。
パラメータ 方 向 例 (デフォルトで Magic をインストールした 時 の 値 )
V9Plus のインストール
ディレクトリ
V9Plus 形 式 の MAGIC.INI
ファイル
uniPaaS V1Plus 形 式 の 標 準
MAGIC.INI ファイル
入 力
入 力
入 力
C:\Program Files\Magic\eDeveloperPlus
C:\Program Files\Magic\eDeveloperPlus\Magic.ini
C:\Program Files\Magic\eDeveloperPlus\Magic.ini
新 規 Magic.INI ファイル 出 力 C:\Program Files\Magic\eDeveloperPlus\MagicNew.ini
7 章 INI 変 換 ユーティリティ 36

7.2. INI 変 換 ユーティリティの 使 い 方
1. INI 変 換 ユーティリティは、
スタート メニュー
→ uniPaaS Studio V1Plus
→ マイグレーション
→ INI 変 換 ユーティリティ
で 起 動 します。
2. 最 初 の ようこそ 画 面 が 出 ます。
次 へ(N) を 押 します。
3. パラメータを 入 力 します。
V9Plus のインストールディレクトリ
V9Plus 形 式 の MAGIC.INI ファイル
uniPaaS V1Plus 形 式 の 標 準 MAGIC.INI ファイ
ル
新 規 Magic.INI ファイル
入 力 し 終 わったら、 実 行 (R) を 押 します。
4. 正 常 に 終 わったら、 右 のようなメッセージが
出 ます。
7 章 INI 変 換 ユーティリティ 37

8. 権 利 設 定 とセキュリティファイル
8.1. 権 利 設 定 の 変 更
V9Plusでの 権 利 設 定
V9Plus までは、Magic のセキュリティ 機 能 を
使 って、 開 発 時 あるいは 実 行 時 に 有 効 な 権 利
を、リポジトリ 単 位 、プログラム 単 位 で 設 定
することができました。 権 利 の 設 定 は 権 利 設
定 ダイアログ( 右 図 )で 行 い、ここでは 次 のよ
うな 権 利 を 設 定 することができました。
権 利 設 定 内 容 開 発 時 / 実 行 時 ?
照 会 権 利
修 正 権 利
削 除 権 利
登 録 権 利
開 発 時 権 利
実 行 /APG 権 利 テーブルリポジトリでは 開 発 時 権 利 。
プログラムリポジトリでは 実 行 時 権 利 。
uniPaaS V1Plusでの 権 利 設 定
uniPaaS V1Plus では、 実 行 時 の 権 利 設 定 は
V9Plus と 同 じですが、 開 発 時 にはセキュリ
ティをかけることができなくなりました。
uniPaaS V1Plus の 開 発 はプロジェクトベー
スの XML ソースファイルを 使 って 開 発 するの
ですが、XML ソースファイルは 通 常 のテキストファイルであるため、 特 定 の 開 発 者 には 開 示 し、 別 の 開
発 者 には 隠 蔽 する、ということができないからです。このため、V9Plus から 移 行 する 場 合 、 次 のよう
になります。
権 利 設 定 ダイアログには、 実 行 /APG 権 利 だけが 残 ります。その 他 の 権 利 は 削 除 されます。
権 利 設 定 ダイアログは、プログラムリポジトリでだけ 開 くことができます。
実 行 /APG 権 利 では、プログラムの 実 行 または 実 行 不 可 という 基 本 的 な 設 定 しかできません。これ 以 上
の 細 かなセキュリティ 制 御 を 行 いたい 場 合 には、Rights 関 数 と User 関 数 を 使 ってプログラムで 制 御 す
るようにします。
8.2. セキュリティファイル
uniPaaS V1Plus ではセキュリティファイル(SUPPORT\usr_std.jpn など)の 内 部 構 造 が 変 わりましたの
で、V9Plus で 使 っていたセキュリティファイルの 内 容 を 継 続 して 使 用 したい 場 合 は、uniPaaS Studio
V1 で 提 供 されているユーティリティ usrupd.exe を 利 用 して、セキュリティファイルを 変 換 する 必 要
8 章 権 利 設 定 とセキュリティファイル 38

があります。
usrupd.exe は uniPaaS V1Plus のインストールディレクトリにあるコマンドラインツールです。 使 い
方 はコマンドプロンプトを 開 き、uniPaaS V1Plus のインストールディレクトリに 移 動 してから、 次 の
形 式 で 実 行 します。
usrupd
次 は、 実 行 例 です。(usrupd コマンドのパラメータは、1 行 で 書 きます)
C:\>cd "\Program Files\uniPaaS\Studio V1Plus"
C:\Program Files\uniPaaS\Studio V1Plus\usrupd "c:\Program Files\uniPaaS\Studio V1Plus
\Support\usr_std.jpn" support\usr_v9plus.jpn
8 章 権 利 設 定 とセキュリティファイル 39

9. ビルダデータコンバータ
V9Plus には、Magic, COM、Web サービス、EJB などのビルダ ユーティリティがありました。
uniPaaS V1Plus でもこれらのユーティリティは 提 供 されていますが、 設 定 データ (Magic コンポーネ
ントの 設 定 など)の 形 式 が 異 なるため、そのままでは 流 用 することができません。
uniPaaS V1Plus のビルダ ユーティリティを 使 う 際 に、 設 定 を 最 初 からやりなおす 手 間 を 避 けるため、
V9Plus のビルダ ユーティリティの 内 容 を uniPaaS V1Plus のユーティリティのフォーマットに 変 換
する ビルダ データ コンバータ が 提 供 されています。
ビルダ データ コンバータでデータコンバートするには・・・
1. スタートメニューから 起 動 し
ます。
2. ウィザードが 起 動 されるので、ウィ
ザードの 指 示 に 従 って 処 理 してく
ださい。
9 章 ビルダデータコンバータ 40

10. dbMAGIC V8.2からの 移 行
dbMAGIC V8.2 およびそれ 以 前 のバージョンから uniPaaS V1Plus に 移 行 しようとしたとき、2.2V で
すでに 説 明 したように、 直 接 移 行 することはできないので、V8.2 → V9.4SP6a → V9Plus コンバータ
というステップを 踏 んで 移 行 することになります。
ここでは、V8.2 あるいはそれ 以 前 のバージョンから 移 行 する 場 合 の 若 干 のヒントを 紹 介 します。
10.1. V9Plusでの 色 /フォントテーブル 変 換 は 不 要
V8.2 と V9Plus を 比 較 したとき、V9Plus では 色 テーブルやフォントテーブルに 変 更 があり、1~100 番
までがシステム 予 約 の 番 号 となったため、V8.2 での 色 /フォントテーブルをそのまま 使 うことができな
くなりました。そのため、V9Plus に 移 行 する 際 には、V9Plus 開 発 版 に 添 付 されている 色 ・フォントテー
ブル 変 換 ユーティリティを 使 って 変 換 しなければなりませんでした。
V8.2 のアプリケーションを uniPaaS
V1Plus に 移 行 する 際 には、いったん
V9Plus を 経 由 して 移 行 するのですが、
V9Plus でアプリケーションを 利 用 する 予
定 がない 場 合 には、 色 ・フォントテーブ
ルの 変 換 は 不 要 になります。これは、
uniPaaS V1Plus では 色 、フォント、キー
ボード 割 付 テーブルが、 開 発 用 、 実 行 用 、
内 部 用 と 用 途 によって 別 々に 定 義 できる
ようになったからです。このため、アプ
リケーション 実 行 時 用 の 色 ・フォントテー
ブルとして、V8.2 で 使 っていた 色 ・フォ
ント 定 義 ファイルをそのまま 設 定 するこ
とができるようになります。このときで
も、uniPaaS V1Plus での 開 発 時 の 画 面 には 全 く 影 響 を 与 えることがありません。
この 場 合 、 色 ・フォントテーブルは、アプリケーション 特 性 ダイアログの 外 部 参 照 ファイル(E) タ
ブにパラメータに 設 定 しておくのがよいでしょう。
10 章 dbMAGIC V8.2からの 移 行 41

10.2. テーブルのタイトルが 消 える
V8.2 のテーブルコントロールでは、タイトルは
テキストコントロールで 実 現 されていました。
右 図 は V8.2 で 実 行 している 画 面 ですが、 明 細 の
子 タスクで 表 示 しているテーブルコントロール
のタイトル ( 明 細 番 号 、 商 品 番 号 、 商 品 タイ
プ・・・)は、すべて、それぞれ 別 々のテキスト
コントロールであり、テーブルコントロールと
は 親 子 関 係 を 持 って 結 合 されています。
V8.2 での 画 面
このようにして 作 成 されているプログラムを
V9Plus を 経 由 して uniPaaS V1Plus に 移 行 し、
さらに GUI エンハンサを 適 用 すると、テーブル
は Windows スタイルのものに 変 換 されます。こ
のときにプログラムを 実 行 してみると、 右 図 に
見 るように、 明 細 テーブルのタイトルが 消 えて
しまっています。
uniPaaS V1Plus での 画 面 (GUI エンハンサ 実 行 後 )
実 際 には、タイトルはテキストコントロールと
して 残 っていますが、これらのテキストコント
ロールはテーブルコントロールの 背 面 に 隠 れて
しまっているために 表 示 されない、というのが
真 相 です。
試 しに、uniPaaS V1Plus のフォームエディタを
開 いて、テーブルコントロールを 選 択 してみる
と、 右 図 に 見 るように、タイトルのところにテ
キストコントロールが 存 在 するのが 確 認 できま
す。ただし、 背 面 にあるので 見 ることができま
せん。
uniPaaS V1Plus フォームエディタ 上 でテーブルコ
ントロールを 選 択
10 章 dbMAGIC V8.2からの 移 行 42

この 問 題 に 対 しては、 自 動 的 に 解 決 する 方 法 は
ありません。uniPaaS V1Plus のフォームエディ
タ 上 で、 各 カラムを 選 択 してカラムの タイトル
特 性 にタイトルをひとつひとつ 入 力 していって
ください。
10 章 dbMAGIC V8.2からの 移 行 43

11. トラブルシューティング
v9Plus コンバータ 実 行 中 に 発 生 するエラーの 代 表 的 なものは、 以 下 のものがあります。
現 象 : エラーメッセージ Missing Mandatory Parameters が 出 る。
原 因 :
対 応 :
-EXPORT と –PROJECT パラメータは 必 須 です。V9Plus コンバータ 実 行 時 にこのパラメータ
を 指 定 しなかった 場 合 にこのエラーが 出 力 されます。
これらのパラメータを 指 定 します。
現 象 : エラーメッセージ Invalid Export File が 出 る。
原 因 :
対 応 :
V9Plus のリポジトリ 出 力 ファイルの 形 式 が、V9Plus コンバータで 処 理 できるものでなかっ
た 場 合 に 出 ます。V9Plus コンバータは、 最 初 にリポジトリ 出 力 ファイルのバージョンを
チェックし、Ver 9.40J SP6 以 降 の 開 発 版 でリポジトリ 出 力 したもののみ、 処 理 します。
MCF を V9Plus Ver 9.40J SP6 以 上 の 開 発 版 でリポジトリ 出 力 して 再 度 実 行 してください。
現 象 : エラーメッセージ Project Directory Already Exists が 出 る。
原 因 :
対 応 :
-PROJECT パラメータで 指 定 したディレクトリに、プロジェクトファイルがすでに 存 在 して
いる 場 合 に 出 ます。
別 のディレクトリを 指 定 するか、 既 存 のプロジェクトが 不 要 であれば 削 除 してから 再 実 行
してください。
現 象 :
原 因 :
内 部 イベントのリテラルが 消 えてしまう。(''EVENT という 形 になってしまう)。
V9 よりのマイグレーション 時 に ACT が 消 えてしまう 問 題 は、ほとんどの 場 合 、V9Plus でリ
ポジトリ 出 力 時 に mgconstw.jp2 を 使 っていない 場 合 に 起 こります。4.1 リポジトリ 出 力 時
の 注 意 事 項 を 参 照 してください。また、V9Converter 実 行 時 のパラメータを 正 しく 設 定 し
ていない 場 合 、 同 じ 問 題 が 起 こります。
対 応 : V9Plus でリポジトリ 出 力 をするときには、mgconstw.jp2 を 使 ったかどうかを 確 認 して
ください。 不 明 の 場 合 には、4.2 リポジトリ 出 力 ファイルの 確 認 を 参 照 してチェック
してください。もし mgconstw.jp2 を 使 っていない 場 合 には、mgconstw.jp2 を 使 って
再 度 リポジトリ 出 力 してください。
v9converter.exe 実 行 時 に、パラメータ「-LANG=JPN -LOCALS=J,./: 」が 抜 けてい
ないことを 確 認 して、 再 度 実 行 してください。
現 象 :
原 因 :
対 応 :
実 行 時 、プッシュボタンやキーなどが 効 かない。
カーソルの 動 きがおかしい。
内 部 イベント(アクション)が、 移 行 時 に 消 えてしまっていることが 考 えられます。
プログラムを 開 いて、 内 部 イベントが ''EVENT などとなってしまっていないかを 確 認 して
ください。もしそうなっていたら、 上 の「 内 部 イベントのリテラルが 消 えてしまう。」の
項 に 従 って 対 応 してください。
11 章 トラブルシューティング 44

現 象 :
原 因 :
対 応 :
パラメータが 正 しく 渡 らないプログラムがある。
パラメータを 受 け 取 る 場 合 に、P=パラメータでではなく、V= 変 数 で 受 け 取 っていて、かつ
照 会 リンクを 使 っているプログラムで 起 こることがあります。 詳 細 は、5.4 照 会 リンクの 移
行 を 参 照 してください。
パラメータは P=パラメータ で 受 け 取 るようにしてください。
現 象 : 右 図 のように、チェックボックスの 表 示 が 乱 れる (チェックボックスの 上 にテ
キストの 一 部 が 重 複 して 表 示 されているように 表 示 される)
原 因 :
対 応 :
チェックボックスにラベル(テキスト 特 性 )が 設 定 されていて、このテキストが 隠 れるよう
に 幅 を 狭 めている 場 合 、V9Plus では 表 示 されませんでしたが、uniPaaS V1Plus ではこれが
前 面 に 現 れるようになり、このような 表 示 になります。
ラベルを 表 示 する 必 要 がない 場 合 には、テキスト 特 性 を 削 除 してください。
現 象 :
原 因 :
対 応 :
GUI エンハンサ 適 用 後 、テーブルコントロールのタイトルが 消 えてしまう。
V8.2 あるいはそれ 以 前 のバージョンから 移 行 してきた 場 合 、テーブルコントロールのタイ
トルはテキストコントロールとして 定 義 されていますが、Windows スタイルのテーブルコン
トロールが 前 面 に 表 示 されるので、タイトルのテキストコントロールが 隠 れて 見 えなくな
るのが 原 因 です。10 dbMAGIC V8.2 からの 移 行 を 参 照 してください。
タイトルは、カラム タイトル 特 性 で 設 定 するように 修 正 してください。
現 象 :
原 因 :
対 応 :
移 行 後 、データソースリポジトリで 定 義 されている SQL テーブル (Oracle、MS-SQL、DB2UDB
など)のカラムの 格 納 形 式 特 性 が 変 わり、データを 正 しくアクセスできなくなる。( 例 :
ZString が String に 変 わってしまうなど)
移 行 中 にリポジトリ 入 力 をする 際 に、 必 要 なデータベース 定 義 がされていないために、
Default Database をもとにした 格 納 形 式 のデフォルトにリセットされてしまうためです。
移 行 中 に 利 用 する V9Plus や V8.2 開 発 版 では、リポジトリ 入 力 を 行 うに 先 立 って、アプリ
ケーションが 利 用 しているデータベースをデータベーステーブルに 定 義 してください。こ
れは、そのバージョンでは 実 行 を 行 わない 場 合 にも 必 要 です。
11 章 トラブルシューティング 45

V9Plus 開 発 者 のための
Magic uniPaaS V1Plus 移 行 ガイド
Copyright © 2009, Magic Software Japan K.K.,
All rights reserved.
第 1 版
発 行
2009 年 10 月 6 日
〒151-0053 東 京 都 渋 谷 区 代 々 木 三 丁 目 二 十 五 番 地 三 号
あいおい 損 保 新 宿 ビル 14 階
マジック ソフトウェア・ジャパン ( 株 )
http://www.magicsoftware.co.jp/
11 章 トラブルシューティング 46