Comments
Description
Transcript
サクラメントのポップラジオ局
開発者ガイド Release 9.1B © 2002, 2003 Unify Corporation. All rights reserved. Sacramento California, USA No part of this tutorial may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise without the prior written consent of Unify Corporation. Unify Corporation makes no representations or warranties with respect to the contents of this document and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Further, Unify Corporation reserves the right to revise this document and to make changes from time to time in its content without being obligated to notify any person of such revisions or changes. The Software described in this document is furnished under a Software License Agreement. The Software may be used or copied only in accordance with the terms of the license agreement. It is against the law to copy the Software on tape, disk, or any other medium for any purpose other than that described in the license agreement. The Unify Corporation Documentation Group values and appreciates any comments you may have concerning our documents. Please address comments to: Documentation Group Unify Corporation 2101 Arena Blvd. Suite 100 Sacramento, CA 95834-1922 (800) 468-6276 or (800) 468-6343; 916-928-6400 FAX (916) 928-6401 UNIFY, ACCELL, VISION, DataServer, and the Unify Logo are registered trademarks of Unify Corporation. Unify NXJ is a trademark of Unify Corporation. UNIX is a registered trademark of The Open Group in the United States and other countries. Borland is a registered trademark of Borland Software Corporation. BEA WebLogic is a registered trademark of BEA Systems, Inc. IBM and WebSphere are trademarks or registered trademarks of International Business Machines Corporation. The X Window System is a product of the Massachusetts Institute of Technology. SYBASE is a registered trademark, and SQL Server, DB_Library, and Open Server are trademarks of Sybase, Inc. INFORMIX is a registered trademark of a subsidiary of IBM. ORACLE is a registered trademark of Oracle Corporation. Sun is a registered trademark, and SunView, Sun_3, Sun_4, X11/NeWS, SunOS, PC_NFS, and Open Windows are trademarks of Sun Microsystems. All SPARC trademarks are trademarks or registered trademarks of SPARC International, Inc. SPARCstation is licensed exclusively to Sun Microsystems, Inc. Microsoft, MS, and Windows are registered trademarks of Microsoft. All other products or services mentioned herein may be registered trademarks, trademarks, or service marks of their respective manufacturers, companies, or organizations. 目次 1. は じ めに 1 Unify ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ーム と は ?. . . . . . . . . . . . . . . . . . . . 1 開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 実行時環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 NXJ ア プ リ ケーシ ョ ン と は ?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 ユーザ イ ン タ フ ェ ース : ア プ リ ケーシ ョ ンの フ ォ ーム . . . . . . . . . . . . . . . . . 4 ビ ジネスルール : ア プ リ ケーシ ョ ンのビ ジネス ロ ジ ッ ク . . . . . . . . . . . . . . . 7 ア プ リ ケーシ ョ ンのデー タ ソ ース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 ア プ リ ケーシ ョ ンの概要 : 開始か ら 終了ま で . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 タ ス ク 1 : ア プ リ ケーシ ョ ンの設計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 タ ス ク 2 : デザイ ン セ ン タ でのプ ロ ジ ェ ク ト 作成 . . . . . . . . . . . . . . . . . . . . . . 9 タ ス ク 3 : ア プ リ ケーシ ョ ン フ ォ ームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 9 タ ス ク 4 : フ ォ ームの関係を設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 タ ス ク 5 : ア プ リ ケーシ ョ ンのテ ス ト と デバ ッ グ . . . . . . . . . . . . . . . . . . . . . 10 タ ス ク 6 : 組み込み フ ィ ール ド の動作を最適化 . . . . . . . . . . . . . . . . . . . . . . . 10 タ ス ク 7 : フ ォ ームのレ イ アウ ト と 外観を カ ス タ マ イ ズ . . . . . . . . . . . . . . . 11 タ ス ク 8 : ビ ジネスルールの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 タ ス ク 9 : ア プ リ ケーシ ョ ンパ ッ ケージの フ ァ イルを収集 . . . . . . . . . . . . . 12 タ ス ク 10 : セキ ュ リ テ ィ の追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 タ ス ク 11 : NXJ コ ン ト ロールセ ン タ の メ ニ ュ ー ア ク セス を定義. . . . . . . . 12 タ ス ク 12 : ア プ リ ケーシ ョ ン パ ッ ケージの作成 . . . . . . . . . . . . . . . . . . . . . 12 タ ス ク 13 : ア プ リ ケーシ ョ ンパ ッ ケージの配備 . . . . . . . . . . . . . . . . . . . . . . 13 タ ス ク 14 : ア プ リ ケーシ ョ ンが利用で き る こ と をユーザに通知 . . . . . . . . 13 NXJ™ 2. デザイ ン セ ン タ の使い方 デザイ ン セ ン タ の起動 と 終了 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NXJ デザイ ン セ ン タ メ イ ン ウ イ ン ド ウ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ブ ラ ウザパネル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ン テ ン ト パネル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . メ ッ セージパネル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ス テー タ ス ラ イ ン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 14 15 16 24 25 26 I デザイ ン セ ン タ のカ ス タ マ イ ズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 全般的な動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ス ク リ プ ト エデ ィ タ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . キーボー ド シ ョ ー ト カ ッ ト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . レ イ アウ ト パネル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ン ト ロールセ ン タ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. プ ロ ジ ェ ク ト の設定 26 27 27 28 29 30 32 プロジ ェ ク ト とは ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト の格納方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト の開始 と 終了 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト の開始 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト の終了 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト のイ ンポー ト と エ ク スポー ト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 全般プ ロパテ ィ の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ク ラ スパスの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 追加デー タ ベース コ ネ ク シ ョ ンの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロ ジ ェ ク ト 環境のカ ス タ マ イ ズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ロ ケールの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 32 35 38 38 39 40 40 41 42 43 43 表示通貨を選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 4. フ ォ ームの作成 と フ ォ ームの関連性 絶対位置 と テーブルベースの位置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 絶対位置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . テーブルベースの位置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ス タ イルの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームのス タ イルを選択 : シ ン グルオ カ レ ン ス と マルチオ カ レ ン ス . . . . . 単一デー タ ビ ュ ー フ ォ ームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 方法 1 : 複数のデ フ ォ ル ト フ ォ ームを作成する . . . . . . . . . . . . . . . . . . . . . . . 方法 2 : デ フ ォ ル ト フ ォ ームを 1 つ作成する . . . . . . . . . . . . . . . . . . . . . . . . . 方法 3 : 手動で フ ォ ームを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 複数デー タ ビ ュ ー フ ォ ームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . マ ス タ / 詳細の関係 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tab Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . その他のデー タ ビ ュ ーを作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unify NXJ 開発者ガ イ ド 45 45 46 46 46 47 48 49 50 51 52 52 56 57 II レ イ アウ ト パネルを使 っ た フ ォ ームのレ イ アウ ト . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームのプ レ ビ ュ ーを表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Form プ ロパテ ィ の設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . グ リ ッ ド に吸着 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ン ト ロールの整列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . JSP ソ ースの編集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの組み込み動作を カ ス タ マ イ ズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . デー タ ベース操作を許可 し ない . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 初期デー タ ビ ュ ー モー ド を あ ら か じ め設定する . . . . . . . . . . . . . . . . . . . . . ク エ リ の条件を設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 自動検索の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ト ラ ンザ ク シ ョ ンの自動 コ ミ ッ ト 設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . レ コ ー ド 追加後に フ ォ ームを ク リ ア . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . エ ン ト リ ポ イ ン ト フ ォ ームの指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . メ ニ ュ ー定義を指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 次 フ ォ ームの指定方法 と 、 ト ラ ンザ ク シ ョ ン と ロ ッ ク に関する情報 . . . . . . . Unify NXJ ト ラ ンザ ク シ ョ ン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ト ラ ンザ ク シ ョ ン モー ド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . デー タ 一貫性レ ベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 次 フ ォ ーム選択ダ イ ア ロ グの使い方 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ズーム フ ォ ームの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ズーム フ ォ ームの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの外観を カ ス タ マ イ ズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの高 さ と 幅 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの境界線 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの前景色 と 背景色 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの Wallpaper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームのヘ ッ ダ、 ツールバー、 フ ッ タ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. コ ン ト ロールの使い方 コ ン ト ロールの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ン ト ロールの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ン ト ロールのサイ ズ変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . フ ォ ームの フ ィ ール ド コ ン ト ロールの順序を指定する . . . . . . . . . . . . . . . . . . . コ ン ト ロール プ ロパテ ィ を設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . プ ロパテ ィ の値を継承 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unify NXJ 開発者ガ イ ド 59 62 63 63 64 64 64 65 66 67 69 70 70 70 72 74 76 77 80 81 82 83 84 85 85 85 86 86 88 88 89 91 92 93 94 III コ ン ト ロールの Visual プ ロパテ ィ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Background (背景色) と Foreground (前景色) . . . . . . . . . . . . . . . . . . . . . . . . 95 Border Color 、 Width、 Style (境界線の色、 幅、 ス タ イル) . . . . . . . . . . . . . 95 フ ォ ン ト のフ ァ ミ リ と サイ ズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 オブ ジ ェ ク ト の高 さ と 幅 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 コ ン ト ロールの位置 (上 と 左) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 ツールチ ッ プ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Interactive プ ロパテ ィ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 FYI メ ッ セージ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 イ ベ ン ト セ ク シ ョ ンの即時実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Stop For Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Updateable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Field-Level Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Text Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Auto Accept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Case Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Display Justify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Field Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Database プ ロパテ ィ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 自動検索操作の指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Control Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Database Column Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Database Column Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Target Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 General プ ロパテ ィ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 MultiValued . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Text Field と Text Area フ ィ ール ド コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . 122 ア プ リ ケーシ ョ ン 情報 フ ィ ール ド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Checkbox コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Radio Button コ ン ト ロール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Listbox コ ン ト ロール と Dropdown Listbox コ ン ト ロール . . . . . . . . . . . . . . . . . 129 ラ ベル と Styled Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ス タ イル バーの使い方 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ラ ベル と Styled Text ボ ッ ク スの編集モー ド . . . . . . . . . . . . . . . . . . . . . . . . . 135 Unify NXJ 開発者ガ イ ド IV Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Button コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tab Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Line と Group Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Link コ ン ト ロール. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . イ ン ラ イ ン フ レ ーム コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 繰 り 返 し 領域 コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 繰 り 返 し 領域のス タ イルを変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table と 繰 り 返 し 領域 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. Look and Feel のカ ス タ マ イ ズ 136 138 139 140 140 141 142 144 145 147 147 149 Look and Feel と は ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . look & feel 定義の指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 定義済みのツールバー フ ォ ーマ ッ ト の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 横方向、 イ メ ージあ り . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 縦方向、 イ メ ージあ り . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 横方向、 テキス ト のみ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 縦方向、 テキス ト のみ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ズーム フ ォ ームのツールバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 定義済みのツールバー フ ォ ーマ ッ ト の選択手順 . . . . . . . . . . . . . . . . . . . . . ス タ イル定義の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 150 150 150 151 151 152 152 152 153 コ マ ン ド キーマ ッ ピ ン グの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 7. static content フ ァ イルの追加 158 HTML お よび JSP フ ァ イルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 8. セキ ュ リ テ ィ の設定 と 管理 160 ユーザ と グループ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . セキ ュ リ テ ィ の対象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ア ク セス コ ン ト ロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . すべてのユーザ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 認証 さ れたユーザのみ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unify NXJ 開発者ガ イ ド 160 160 161 161 161 V ア ク セス コ ン ト ロールの指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Static Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 9. 実行 と パ ッ ケージ ング 165 実行 コ マ ン ド : コ ンパイル、 Make、 配備 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . コ ンパイルフ ェ ーズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Make フ ェ ーズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 配備 フ ェ ーズ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . テス ト のヒ ン ト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 166 167 168 168 ア プ リ ケーシ ョ ンのパ ッ ケージ ン グ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 A. プ ロパテ ィ の概要 171 Unify NXJ 開発者ガ イ ド VI は じ めに 1 Unify NXJ™ ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ーム と は ? Unify NXJ ビ ジ ネス ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ームは、 従来のビ ジ ネ ス ア プ リ ケーシ ョ ン開発者にはよ く 知 ら れてい る J2EE プ ラ ッ ト フ ォ ームを使用 し て数多 く の イ ン タ ラ ク テ ィ ブ な新 し い Web ア プ リ ケーシ ョ ン を自動的に作成 / 管理する統 合ビ ジ ネス ア プ リ ケーシ ョ ン環境です。 Unify NXJ は、 既存の基幹系シ ス テムを、 顧客、 パー ト ナー、 従業員に高度に イ ン タ ラ ク テ ィ ブ で動的な セル フ サービ ス機能を提供 し たい と 考え る企業に特に適 し ています。 Unify NXJ に よ り 、 ビ ジ ネス ア プ リ ケーシ ョ ン開発者は、 洗練 さ れた Web 対応エ ン タ プ ラ イ ズア プ リ ケーシ ョ ン を配布する ために J2EE プ ラ ッ ト フ ォ ー ムの使用を す ぐ に開始す る こ と が可能です。 開発環境 • NXJ デザ イ ン セ ン タ ア プ リ ケーシ ョ ンのデザ イ ン、 開発、 メ ン テナ ン ス、 テ ス ト を行 う ための統 合開発環境。 • ア プ リ ケーシ ョ ン コ ン ポーネ ン ト フ レ ームワー ク 開発ア プ リ ケーシ ョ ンのユーザ イ ン タ フ ェ ースオ ブ ジ ェ ク ト を作成す る ため に使用 さ れる既製の カ ス タ マ イ ズの行い易い コ ン ポーネ ン ト 。 • jBiz ビ ジ ネス言語 ア プ リ ケーシ ョ ン オ ブ ジ ェ ク ト の管理を行 う ために作 ら れた ビ ジネ ス プ ロ グ ラ ミ ン グ言語 と コ ンパ イ ラ 。 jBiz 言語は、 埋め込み Java 文を完全にサポー ト。 1 1 実行時環境 • NXJ コ ン ト ロ ールセ ン タ NXJ ア プ リ ケーシ ョ ン と 関連す る リ ソ ース を管理す る動的な メ ニ ュ ー形式シ ス テム。 コ ン ト ロ ールセ ン タ は、 特に NXJ セキ ュ リ テ ィ シ ス テムを統合 し た 専用の Web ア プ リ ケーシ ョ ン です。 • NXJ イ ン タ ラ ク シ ョ ンサーバ Java ア プ リ ケーシ ョ ンサーバ と 連動 し て NXJ ア プ リ ケーシ ョ ン を調整 し ま す。 • セキ ュ リ テ ィ シ ス テム どのユーザがア プ リ ケーシ ョ ン を実行で き、 デー タ の検索 / 更新がで き るか を コ ン ト ロ ールす る拡張性のあ る ア ク セ ス コ ン ト ロ ールシ ス テム。 • 管理シ ス テム NXJ コ ン ト ロ ールセ ン タ と ア ク セ ス を提供す る リ ソ ース を管理す る集中管理 シ ス テム。 NXJ ア プ リ ケーシ ョ ン と は ? NXJ ア プ リ ケーシ ョ ンは Java ベースのビ ジ ネス ア プ リ ケーシ ョ ン であ り 、 実際の ビ ジネ ス上の問題を扱 う ソ フ ト ウ ェ ア ソ リ ュ ーシ ョ ン です。 NXJ ア プ リ ケーシ ョ ンが解決す る問題 と は、 デー タ の表示 と 管理を中心においてい る こ と です。 例え ば、 NXJ ア プ リ ケーシ ョ ン に よ っ て経費に関す る デー タ を業界標準のデー タ ベー ス で一括管理 し てい る企業の経費報告書や、 標準的な Web ブ ラ ウザを使 っ て経費 報告書を提出する世界中の従業員を管理す る こ と がで き ます。 Unify NXJ 開発者ガ イ ド 2 1 HT T P NXJ Interaction Server Web ブ ラ ウザ HT HT HT TP T TP Web ブ ラ ウザ Web ブ ラ ウザ P Web ブ ラ ウザ デー タ ソ ース NXJ ア プ リ ケーシ ョ ン では、 フ ォ ームを基本的なユーザ イ ン タ フ ェ ース と し て使 用 し ます。 フ ォ ームは動的な Web ページ と し て動作 し ます。 フ ォ ームは、 デー タ ソ ース と の関連を定義す る ビ ジネ スルールの元で動作 し ます。 例えば、 従業員が フ ォ ームを通 じ て経費報告書を提出す る と 、 ビ ジ ネ スルールが適用 さ れ、 フ ォ ー ムに入力 さ れた従業員 ID が従業員テーブルで定義 さ れてい る実際の従業員の ID であ るかど う かが確認 さ れます。 If adding, then call... If deleting, then... If adding, then call... If searching, then... If invalid ID, then... ユーザ イ ン タ フ ェ ース ビ ジネスルール Unify NXJ 開発者ガ イ ド Table: Employees デー タ ソ ース 3 1 ユーザ イ ン タ フ ェ ース : ア プ リ ケーシ ョ ンのフ ォ ーム 実行時、 NXJ ア プ リ ケーシ ョ ンの フ ォ ームは Web ページ (厳密には JSP ページ) に表示 さ れます。 JSP コ ー ド は、 NXJ デザ イ ン セ ン タ で指定 し た フ ォ ーム と フ レ ー ムワー ク コ ン ポーネ ン ト のグ ラ フ ィ カルな設計に基づいて、 NXJ ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ームで自動的に作成 さ れます。 以下の図は実行時の NXJ ア プ リ ケーシ ョ ン フ ォ ームの主要領域です。 ヘッダ ツールバー 次レ コ ー ド フ ォ ーム本体 フッタ JSP ページ では、 あ ら か じ め定義 さ れてい る Unify NXJ ヘ ッ ダ、 ツ ールバー、 フ ッ タ で フ ォ ームが組み立て ら れます。 ツ ールバーには コ マ ン ド ボ タ ンがあ り 、 ユー ザは こ のボ タ ン を ク リ ッ ク し て フ ォ ーム内を移動 し た り デー タ ベース を操作す る こ と が可能です。 ま たデー タ 間を移動する こ と も で き ます。 例えば、 上の図の右 Unify NXJ 開発者ガ イ ド 4 1 矢印ボ タ ン を ク リ ッ ク す る と 次レ コ ー ド が表示 さ れます。 こ の例では、 次レ コ ー ド は タ ーゲ ッ ト テーブル ( こ の フ ォ ームに関連付け ら れてい る テーブル) にあ る 次の経費要求レ コ ー ド です。 ヘ ッ ダ と フ ッ タ には、 NXJ イ ン タ ラ ク シ ョ ンサーバやア プ リ ケーシ ョ ンか ら 報告 さ れた、 ア プ リ ケーシ ョ ンのス テー タ スに関する情報が表示 さ れます。 NXJ ア プ リ ケーシ ョ ン フ ォ ームは イ ン タ ラ ク テ ィ ブ です。 例えば、 タ ーゲ ッ ト テーブルを検索す る場合、 ユーザは フ ォ ームの フ ィ ール ド 制御に検索基準を入力 し 、 ツ ール バーの 検索 ボ タ ン を ク リ ッ ク し て検索 コ マ ン ド を発行 し ます。 > 1/1/2002 こ の フ ィ ール ド で 2002 年以降に設定 さ れてい る全レ コ ー ド を検索する と い う 検 索条件 こ の検索 コ マ ン ド は NXJ イ ン タ ラ ク シ ョ ンサーバで SQL SELECT 文に変換 さ れ、 デー タ ベースに対 し て実行 さ れま す。 選択 さ れた レ コ ー ド は、 対応す る フ ィ ール ド 制御に各 列のデー タ が入 っ た状態で フ ォ ームに返 さ れます。 通常、 NXJ ア プ リ ケーシ ョ ン には複数の フ ォ ームがあ り ます。 どの フ ォ ームの セ ッ ト も 入力 フ ォ ームか ら 開始 し ます。 ユーザは、 ツ ールバーの 戻る ボ タ ンや 次へ ボ タ ン を使 っ て、 ア プ リ ケーシ ョ ンの他の有効な フ ォ ームに連続的に移動で き ます。 次へ 戻る 次へ 戻る 次へ 戻る ア プ リ ケーシ ョ ン に よ っ ては、 非連続的な方法で フ ォ ーム を実行する こ と も で き ます。 フ ォ ームに複数の次 フ ォ ームがあ る場合、 ユーザは実行す る タ ス ク に基づ く メ ニ ュ ーか ら 次 フ ォ ーム を選択 し ます。 Unify NXJ 開発者ガ イ ド 5 1 フ ォ ーム #1 次 フ ォ ーム 1. タ ス ク 1 2. タ ス ク 2 3. タ ス ク 3 フ ォ ーム #2 次 フ ォ ーム 選択 メ ニ ュ ー フ ォ ーム #3 NXJ ア プ リ ケーシ ョ ン にズーム フ ォ ーム を含む こ と も で き ます。 ズーム フ ォ ーム と は、 ユーザが フ ォ ーム使用中にデー タ 値を検索で き る フ ォ ームです。 例えば、 ズーム フ ォ ームの有効な部門 リ ス ト か ら 呼び出 し た フ ォ ームに、 部門 ID を戻す こ と がで き ます。 ズーム フ ォ ームには部門の値の リ ス ト があ り 、 こ こ で選択 さ れた 値が元の フ ォ ームの該当 フ ィ ール ド 制御に戻 さ れます。 次へ 戻る 次へ 次へ 戻る 戻る 戻 る Unify NXJ 開発者ガ イ ド ズ | ム 6 1 ビ ジネスルール : ア プ リ ケーシ ョ ンのビ ジネス ロ ジ ッ ク ビ ジネ スルールは、 注文の合計額を計算す る と い っ た特定の タ ス ク を実行す る関 数のよ う な も のです。 ビ ジ ネスルールは、 NXJ ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ー ムの コ ン ポーネ ン ト フ レ ームワー ク を拡張 し て、 カ ス タ マ イ ズが可能な ロ ジ ッ ク を提供 し ます。 例えば、 チ ュ ー ト リ アルのア プ リ ケーシ ョ ンの場合、 ユーザは XRequest フ ォ ーム を使 っ て経費報告書に新 し い経費項目を追加 し ます。 こ の経費項目はデー タ ベー スのレ コ ー ド であ り 、 他のレ コ ー ド と 同様に識別す る ためにユニー ク なキーであ る こ と が必要です。 ユーザはユニー ク なキー を指定で き ないので、 ビ ジネ スルー ルに よ っ て新 し い レ コ ー ド にキー を割 り 当て ます。 ビ ジネ スルールは jBiz ビ ジネ ス言語を使 っ て作成 し ます。 jBiz では、 埋め込み SQL 文を使用す る こ と がで き ます。 有効な経費キー (NUM) を タ ーゲ ッ ト テーブ ル (NEXT_NUMBER) か ら 新 し く 得る ための jBiz 文は以下の と お り です。 private int getNextNum(String type) throws java.sql.SQLException, com.unify.nxj.mgr.datatypes.NXJNullValueException, com.unify.nxj.mgr.dataConnection.NXJDataConnectionException { int result=0; EXEC SQL SELECT NUM FROM ROFIDA.NEXT_NUMBER WHERE NTYPE= :type INTO result; EXEC SQL UPDATE ROFIDA.NEXT_NUMBER SET NUM= :result + 1 WHERE NTYPE=:type; return result; } NXJ ア プ リ ケーシ ョ ンは イ ベ ン ト 駆動で実行 さ れます。 つま り 、 ア プ リ ケーシ ョ ン実行中に発生す る イ ベ ン ト に よ っ て、 その イ ベ ン ト の コ ー ド セ ク シ ョ ンの文が 実行 さ れます。 getNextNum ビ ジ ネ スルールは、 新規の経費要求に対 し て呼び出 さ れます。 そのビ ジネ スルールを書 く イ ベ ン ト セ ク シ ョ ンは ON CLEAR TO ADD と 呼ばれ、 こ こ に記述 さ れる文はユーザが新規レ コ ー ド を追加す る準備 と し て、 フ ォ ームを ク リ アにする ために新規 ボ タ ン を ク リ ッ ク す る と 実行 さ れます。 以下 のよ う な jBiz 文にな り ます。 ON CLEAR TO ADD throws java.sql.SQLException, com.unify.nxj.mgr.datatypes.NXJNullValueException, Unify NXJ 開発者ガ イ ド 7 1 com.unify.nxj.mgr.dataConnection.NXJDataConnectionException { REPORT_ID = getNextNum( “XREPORT” ); } ア プ リ ケーシ ョ ンの他の フ ォ ームス ク リ プ ト を使 っ て、 こ のビ ジネ スルールを呼 び出す こ と も で き ます。 イ ベ ン ト と jBiz の詳細については、 『Unify NXJ jBiz 言語ガ イ ド 』 を参照 し て く だ さ い。 ア プ リ ケーシ ョ ンのデー タ ソ ース 一般的に NXJ ア プ リ ケーシ ョ ンのデー タ ソ ースはデー タ ベース であ り 、 Java DataBase Connectivity (JDBC) で接続 さ れます。 フ ォ ームの各 フ ィ ール ド コ ン ト ロ ールは、 デー タ ベースの列にマ ッ プす る こ と が で き ます。 通常、 フ ォ ームの フ ィ ール ド コ ン ト ロ ールの集ま り は、 同 じ デー タ ベース テーブルの列にマ ッ プ さ れます。 こ のよ う な フ ィ ール ド コ ン ト ロ ールの集 ま り を デー タ ビ ュ ー と 呼びます。 同 じ デー タ ソ ース エ レ メ ン ト (特定のテーブル) を参照 し ています。 フ ォ ームには任意の数のデー タ ビ ュ ー を含める こ と も 、 ま っ た く 含めない こ と も で き ます。 サポー ト さ れてい る デー タ ベースベ ン ダーについては、 NXJ の ReadMe フ ァ イル を参照 し て く だ さ い。 ア プ リ ケーシ ョ ンの概要 : 開始から終了ま で こ のセ ク シ ョ ン では、 NXJ ア プ リ ケーシ ョ ンの設計か ら 配備ま での タ ス ク と 、 マ ニ ュ アルでの参照先を説明 し ます。 タ ス ク 1 : ア プ リ ケーシ ョ ンの設計 ア プ リ ケーシ ョ ンの構築は NXJ デザ イ ン セ ン タ で行いますが、 プ ロ ト タ イ プ を作 成す る前にア プ リ ケーシ ョ ン設計の全体像を明確に し てお く 必要があ り ます。 Unify NXJ 開発者ガ イ ド 8 1 こ の段階で、 ア プ リ ケーシ ョ ン で ア ク セ スす る リ レ ーシ ョ ナルデー タ ベース マネ ジ メ ン ト シ ス テム (RDBMS) のデー タ モデル、 必要な フ ォ ーム数 と フ ォ ームに含 める デー タ ビ ュ ー、 必要な ビ ジネ スルールを明確に し ます。 タ ス ク 2 : デザイ ン セ ン タ でのプ ロ ジ ェ ク ト 作成 ア プ リ ケーシ ョ ン コ ン ポーネ ン ト の設計、 開発、 テ ス ト 、 メ ン テナ ン スは、 NXJ デザ イ ン セ ン タ の所定の プ ロ ジ ェ ク ト で行います。 ア プ リ ケーシ ョ ンが実行時に デー タ ベースにア ク セ スする必要があ る場合は、 NXJ デザ イ ン セ ン タ で も デー タ ベースにア ク セ スする必要があ り ます。 プ ロ ジ ェ ク ト 作成時にデー タ ベース コ ネ ク シ ョ ン を設定 し 、 指定 し ます。 プ ロ ジ ェ ク ト の作成については、 35 ページの 「プ ロ ジ ェ ク ト の作成」 を参照 し て く だ さ い。 タ ス ク 3 : ア プ リ ケーシ ョ ン フ ォ ームの作成 NXJ デザ イ ン セ ン タ では、 グ ラ フ ィ カルな レ イ アウ ト ツ ール と プ ロパテ ィ の設定 を使 っ て、 フ ォ ームのレ イ アウ ト と フ レ ームワー ク コ ン ポーネ ン ト が表示 さ れ、 こ れを使用 し ます。 Unify NXJ では、 フ ォ ームの JSP 版を透過的に作成 し 管理 し ま す。 どのよ う な フ ォ ーム を作成するかは、 フ ォ ーム上のデー タ ビ ュ ーの数に よ っ て異 な り ます。 その フ ォ ームの種類には、 以下のよ う な も のがあ り ます。 • 単一のデー タ ビ ュ ー フ ォ ーム • 複数のデー タ ビ ュ ー フ ォ ーム フ ォ ームの作成については、 45 ページの 「 フ ォ ームの作成 と フ ォ ームの関連性」 を参照 し て く だ さ い。 タ ス ク 4 : フ ォ ームの関係を設定 ユーザがア プ リ ケーシ ョ ン フ ォ ーム間を移動する方法を定義 し ます。 具体的には、 次 フ ォ ームの名前 と 、 それぞれの フ ォ ームで利用で き る ズーム フ ォ ーム を指定 し ます。 エ ン ト リ ポ イ ン ト フ ォ ーム と し て、 少な く と も 1 つの フ ォ ームを指定す る 必要があ り ます。 Unify NXJ 開発者ガ イ ド 9 1 フ ォ ーム と 次 フ ォ ームやズーム フ ォ ームの関係を指定す る時点で、 適用する ト ラ ンザ ク シ ョ ン モー ド と デー タ 一貫性レ ベル も 指定で き ます。 こ れに よ り 、 ア プ リ ケーシ ョ ン と デー タ ソ ースの並行処理制御が可能にな り ます。 フ ォ ームの関係、 ト ラ ンザ ク シ ョ ン モー ド 、 デー タ 一貫性レ ベルの指定について は、 74 ページの 「次 フ ォ ームの指定方法 と 、 ト ラ ンザ ク シ ョ ン と ロ ッ ク に関する 情報」 を参照 し て く だ さ い。 タ ス ク 5 : ア プ リ ケーシ ョ ンのテ ス ト と デバ ッ グ ア プ リ ケーシ ョ ンの フ ォ ームが作成 さ れれば、 プ レ ビ ュ ー し て テ ス ト す る こ と が で き ます。 フ ォ ーム を プ レ ビ ュ ーする には、 レ イ アウ ト > プ レ ビ ュ ー を選択 し ま す。 JSP 版の フ ォ ームが Web ブ ラ ウザに表示 さ れますが、 機能は利用で き ません。 フ ォ ームの機能を テ ス ト する には、 プ ロ ジ ェ ク ト > 実行 を選択 し ます。 フ ォ ーム を コ ンパ イル し てパ ッ ケージ ン グ し 、 NXJ コ ン ト ロ ールセ ン タ に配備す る と 、 エ ン ト リ フ ォ ームが Web ブ ラ ウザに表示 さ れます。 フ ォ ーム間を移動する と NXJ イ ン タ ラ ク シ ョ ンサーバで フ ォ ームが実行 さ れます。 プ ロ ジ ェ ク ト で予期 し ない結果が表示 さ れた ら 、 NXJ デバ ッ ガ を使 っ て指定 し た 箇所で プ ロ ジ ェ ク ト の実行を イ ン タ ラ ク テ ィ ブ に停止す るか、 フ ォ ームス ク リ プ ト の各行を検査 し て原因を突き止めます。 テ ス ト と パ ッ ケージ ン グについては、 165 ページの 「実行 と パ ッ ケージ ン グ」 を参 照 し て く だ さ い。 タ ス ク 6 : 組み込みフ ィ ール ド の動作を最適化 フ ォ ーム と フ ィ ール ド コ ン ト ロ ールには カ ス タ マ イ ズ可能な動作が組み込まれて お り 、 プ ロパテ ィ で指定 さ れています。 フ ォ ーム と コ ン ト ロ ールのプ ロパテ ィ テーブルを確認 し 、 必要に応 じ て設定を変更 し ます。 ただ し 、 変更に よ る影響を テ ス ト し てか ら 実行 し て く だ さ い ( タ ス ク 5 を参照)。 フ ィ ール ド コ ン ト ロ ールのプ ロパテ ィ の設定については、 88 ページの 「 コ ン ト ロ ールの使い方」 を参照 し て く だ さ い。 フ ォ ームのプ ロパテ ィ の設定については、 64 ページの 「 フ ォ ームの組み込み動作 を カ ス タ マ イ ズ」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 10 1 タ ス ク 7 : フ ォ ームのレ イ アウ ト と 外観を カ ス タ マ イ ズ ア プ リ ケーシ ョ ンの基本機能を定義 し た ら 、 外観を変更 し ます。 必要に応 じ て フ ィ ール ド コ ン ト ロ ールを再構成 し 、 イ メ ージ、 リ ン ク 、 ボ ッ ク ス を追加 し ます。 フ ォ ームのテキス ト には、 ス タ イル定義が使用で き ます。 こ のス タ イル定義は、 ア プ リ ケーシ ョ ンの任意のページに適用で き ます。 ア プ リ ケーシ ョ ン で有効な look & feel 定義であれば、 背景、 ツ ールバーのス タ イ ル、 コ マ ン ド キーのマ ッ ピ ン グ、 その他のユーザ イ ン タ フ ェ ース属性が制御で き ます。 Unify NXJ のデ フ ォ ル ト の look and feel がア プ リ ケーシ ョ ン に適 し ていない こ と も あ り ます。 その場合は、 プ リ フ ァ レ ン スに基づ き簡単に カ ス タ マ イ ズで き ます。 フ ォ ームの壁紙や背景の色 と い っ たその他の視覚エ レ メ ン ト は、 視覚プ ロパテ ィ のグループ と ス タ イルバー を使 っ て変更で き ます。 プ レ ビ ュ ー コ マ ン ド を使 う と 、 結果を す ぐ に確認で き ます ( タ ス ク 5 を参照)。 フ ォ ームの外観については、 84 ページの 「 フ ォ ームの外観を カ ス タ マ イ ズ」 を参 照 し て く だ さ い。 look and feel の カ ス タ マ イ ズについては、 149 ページの 「Look and Feel の カ ス タ マ イ ズ」 を参照 し て く だ さ い。 タ ス ク 8 : ビ ジネスルールの追加 ア プ リ ケーシ ョ ンの フ ォ ーム と フ ィ ール ド コ ン ト ロ ールに、 そのア プ リ ケーシ ョ ンの基本的な ビ ジネ ス ロ ジ ッ ク を用意 し ます。 フ ォ ームス ク リ プ ト に ビ ジ ネス ルールを記述する と 、 こ のビ ジネ ス ロ ジ ッ ク を さ ら に詳 し く 定義で き ます。 ま た、 ユーザが使用する コ マ ン ド も 定義で き ます。 jBiz を使 っ て ビ ジ ネ スルールを作成す る方法については、 『Unify NXJ jBiz 言語ガ イ ド 』 を参照 し て く だ さ い。 ビ ジネ スルールを テ ス ト する には、 フ ォ ーム を実行 し て ア ク シ ョ ン を実行 し ます ( タ ス ク 5 を参照)。 Unify NXJ 開発者ガ イ ド 11 1 タ ス ク 9 : ア プ リ ケーシ ョ ンパ ッ ケージのフ ァ イルを収集 ア プ リ ケーシ ョ ン には、 NXJ デザ イ ン セ ン タ 以外で作成 し た フ ァ イルを含める こ と がで き ます。 例えば イ メ ージ、 HTML、 JSP ページ、 PDF、 Java ソ ース、 jar フ ァ イル、 その他の static content フ ァ イルです。 こ れ ら の フ ァ イルを プ ロ ジ ェ ク ト に 追加 し て、 フ ォ ームか ら ア ク セ ス で き る よ う に し ます。 フ ォ ームを実行 し て、 こ れ ら の フ ァ イルにア ク セ ス で き るかど う かを テ ス ト し ま す。 ア プ リ ケーシ ョ ン に static content フ ァ イルを含める方法については、 158 ページの 「static content フ ァ イルの追加」 を参照 し て く だ さ い。 タ ス ク 10 : セキ ュ リ テ ィ の追加 ア プ リ ケーシ ョ ン ロ ジ ッ ク を すべて定義 し テ ス ト を し た ら 、 ア ク セ ス コ ン ト ロ ー ルを追加 し ます。 ア ク セ ス コ ン ト ロ ールを追加す る には、 ア プ リ ケーシ ョ ン実行 時のユーザ コ ミ ュ ニ テ ィ 情報が必要です。 ユーザ コ ミ ュ ニ テ ィ は、 Java ア プ リ ケーシ ョ ンサーバで定義 し ます。 セキ ュ リ テ ィ については、 160 ページの 「セキ ュ リ テ ィ の設定 と 管理」 を参照 し て く だ さ い。 タ ス ク 11 : NXJ コ ン ト ロールセ ン タ の メ ニ ュ ー ア ク セス を定義 ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト (ユーザに最初に表示 さ れる フ ォ ーム) に は、 NXJ コ ン ト ロ ールセ ン タ ビ ュ ーの メ ニ ュ ー項目が関連づけ ら れています。 ア プ リ ケーシ ョ ン には、 少な く と も 1 つのエ ン ト リ ポ イ ン ト フ ォ ームが必要です。 メ ニ ュ ーア ク セ スについては、 70 ページの 「エ ン ト リ ポ イ ン ト フ ォ ームの指定」 を参照 し て く だ さ い。 タ ス ク 12 : ア プ リ ケーシ ョ ン パ ッ ケージの作成 ア プ リ ケーシ ョ ンが配備で き る状態にな っ た場合、 すべて Make コ マ ン ド を使 っ て ア プ リ ケーシ ョ ンパ ッ ケージ を作成 し ます。 実行 コ マ ン ド も ま た、 ア プ リ ケー シ ョ ンパ ッ ケージ を作成 し ます。 Unify NXJ 開発者ガ イ ド 12 1 ア プ リ ケーシ ョ ンパ ッ ケージの作成については、 165 ページの 「実行 と パ ッ ケージ ン グ」 を参照 し て く だ さ い。 タ ス ク 13 : ア プ リ ケーシ ョ ンパ ッ ケージの配備 コ ン ト ロ ールセ ン タ 管理者は、 NXJ コ ン ト ロ ールセ ン タ の配備ウ ィ ザー ド を使 っ て ア プ リ ケーシ ョ ン を配備 し ます。 配備中、 デー タ ソ ース定義は実行時のデー タ ソ ース定義にマ ッ プ さ れます。 ア プ リ ケーシ ョ ンは、 1 つあ る いは複数の コ ン ト ロ ールセ ン タ の メ ニ ュ ーか ら ア ク セ ス さ れるか、 あ る いはス タ ン ド ア ロ ン ア プ リ ケーシ ョ ン と し て ア ク セ ス さ れます。 WebSphere 4.x を お使いの場合は、 WebSphere ア プ リ ケーシ ョ ン ア セ ン ブ リ ツ ール と 管理者 コ ン ソ ールを使 っ て ア プ リ ケーシ ョ ンパ ッ ケージ を配備する必要があ り ます。 配備に関す る情報については、 『Unify NXJ 管理者ガ イ ド 』 を参照 し て く だ さ い。 タ ス ク 14 : ア プ リ ケーシ ョ ンが利用で き る こ と をユーザに通知 ユーザに以下の内容を通知 し ます。 • ア プ リ ケーシ ョ ンへのア ク セ ス方法 (ア プ リ ケーシ ョ ン を起動で き る メ ニ ュ ー名 と メ ニ ュ ー項目) • ア プ リ ケーシ ョ ンの使用権限を持つユーザ • ツ ールバーの コ マ ン ド の意味 『Unify NXJ ユーザーズガ イ ド 』 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 13 デザイ ン セ ン タ の使い方 2 こ の章では NXJ デザ イ ン セ ン タ の領域 と 、 こ の領域を使 っ て NXJ ア プ リ ケーシ ョ ンのプ ロ ト タ イ プ を作成、 開発、 テ ス ト す る方法について説明 し ます。 ま た、 プ ロ グ ラ ミ ン グ手法に合 う よ う に NXJ デザ イ ン セ ン タ を カ ス タ マ イ ズする方法 も 説 明 し ます。 デザイ ン セ ン タ の起動 と 終了 Windows でデザ イ ン セ ン タ を起動す る には、 ス タ ー ト > プ ロ グ ラ ム >Unify NXJ> デザ イ ン セ ン タ を選択 し ます。 デザ イ ン セ ン タ メ イ ン ウ イ ン ド ウが表示 さ れます。 デザ イ ン セ ン タ を終了す る には、 NXJ デザ イ ン セ ン タ ウ ィ ン ド ウの メ ニ ュ ーバー で、 フ ァ イル > 終了 を選択 し ます。 14 2 NXJ デザイ ン セ ン タ メ イ ンウ イ ン ド ウ ア プ リ ケーシ ョ ンの開発 タ ス ク は、 すべて NXJ デザ イ ン セ ン タ の メ イ ン ウ ィ ン ド ウで開始 さ れます。 以下の図にウ ィ ン ド ウの主要領域を示 し ます。 ブ ラ ウザパネル ツールバー メ ニ ュ ーバー ス テー タ ス ラ イ ン ス タ イルバー コ ン コ ン ト ロールパレ ッ ト コ ン テ ン ト パネル メ ッ セージパネル 以下のセ ク シ ョ ン では、 こ れ ら のウ ィ ン ド ウ領域について説明 し ます。 Unify NXJ 開発者ガ イ ド 15 2 ブ ラ ウザパネル ブ ラ ウザパネルは メ イ ン ウ ィ ン ド ウの左側にあ り 、 以下のア プ リ ケーシ ョ ン コ ン ポーネ ン ト の 4 つのビ ュ ー を管理 し ます。 • プロジ ェ ク ト ビ ュー • プ ロパテ ィ ビ ュ ー • イベン ト ビ ュー • デバ ッ ガー ビ ュ ー 次のセ ク シ ョ ン では、 ブ ラ ウザパネルのそれぞれのビ ュ ーについて説明 し ます。 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ー プ ロ ジ ェ ク ト ビ ュ ーには、 プ ロ ジ ェ ク ト の全オ ブ ジ ェ ク ト の名前が リ ス ト さ れます。 プ ロ ジ ェ ク ト ビ ュ ーは プ ロ ジ ェ ク ト タ ブ を ク リ ッ ク す る と 表示 さ れます。 オ ブ ジ ェ ク ト はアル フ ァ ベ ッ ト 順にな っ てお り 、 カ テ ゴ リ ご と に以下のよ う な フ ォ ルダに分かれています。 プロジ ェ ク ト ビ ュー • Classes フ ォ ルダ。 フ ォ ーム と 、 ア プ リ ケーシ ョ ン全体で使用する ビ ジ ネ スルール と が格納 さ れ ます。 エ ン ト リ ポ イ ン ト の フ ォ ームの記号は非 エ ン ト リ ポ イ ン ト の記号 と は異な り ます。 • Connections フ ォ ルダ。 プ ロ ジ ェ ク ト に定義 し たデー タ ベース コ ネ ク シ ョ ンが 格納 さ れます。 • Control Center Menus フ ォ ルダ。 ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト を定義 し た メ ニ ュ ー定義が格納 さ れます。 メ ニ ュ ー定義は、 コ ン ト ロ ールセ ン タ の ア プ リ ケーシ ョ ン にア ク セ スす る メ ニ ュ ー を作成す る ための も のです。 • Look and Feels フ ォ ルダ。 プ ロ ジ ェ ク ト で作成 し た look & feel 定義が、 デ フ ォ ル ト の look & feel 定義 と と も に格納 さ れます。 プ ロ ジ ェ ク ト のデ フ ォ ル ト の look & feel 定義の記号は他の look & feel 定義の記号 と は異な り ます。 • Static Content フ ォ ルダ。 ア プ リ ケーシ ョ ン に含めた static content フ ァ イルが 格納 さ れます。 static content フ ァ イルには PDF、 HTML、 JSP な どがあ り ま す。 Unify NXJ 開発者ガ イ ド 16 2 プ ロ ジ ェ ク ト ビ ュ ーでオ ブ ジ ェ ク ト を ク リ ッ ク す る と 、 オ ブ ジ ェ ク ト が開き、 オ ブ ジ ェ ク ト の タ イ プ に適 し た エデ ィ タ で コ ン テ ン ト パネルに表示 さ れます。 ただ し static content フ ァ イルの タ イ プ に よ っ ては、 NXJ デザ イ ン セ ン タ で編集で き な い こ と があ り ます。 ブ ラ ウザパネルに フ ォ ー カ スがあ る と きは、 キーボー ド の↑、 ↓、 Home、 End を 使 っ てオ ブ ジ ェ ク ト 間を移動で き ます。 各 フ ォ ルダは、 選択す る と 開き ます。 プ ロ ジ ェ ク ト ビ ュ ー を開 く と きはプ ラ ス記号を、 閉 じ る と きはマ イ ナス記号を ク リ ッ ク し ます。 プ ロ ジ ェ ク ト でオ ブ ジ ェ ク ト を作成す る と 、 該当す る フ ォ ルダに自動的に割 り 当 て ら れます。 オ ブ ジ ェ ク ト を別の フ ォ ルダに移動す る こ と はで き ません。 ユーザが コ ン テ ン ツ を組織化す るのを助け る ために、 フ ォ ルダの中にサブ フ ォ ル ダ を作成で き ます。 サブ フ ォ ルダ を作成す る には、 フ ォ ルダの メ ニ ュ ー選択で表 示 さ れる フ ォ ルダ ア イ コ ン で右 ク リ ッ ク し ます。 ブ ラ ウザ パネルのプ ロパテ ィ ビ ュ ー プ ロパテ ィ ビ ュ ーには、 レ イ アウ ト パネルで選択 し た フ ォ ームや フ ォ ーム コ ン ト ロ ールの名前 と 値、 ま たは HTML エデ ィ タ のページ エ レ メ ン ト のプ ロパテ ィ の名 前 と 値が リ ス ト さ れます。 プ ロパテ ィ は、 デー タ ベースやセキ ュ リ テ ィ な どのよ う に機能に よ っ て分類 さ れています。 リ ス ト さ れる プ ロパテ ィ は、 Web レ イ アウ ト や HTML エデ ィ タ で選択 し た内容に よ っ て異な り ます。 そのオ ブ ジ ェ ク ト でサ ポー ト さ れてい る プ ロパテ ィ だけがプ ロパテ ィ ビ ュ ー に表示 さ れます。 プ ロパテ ィ ビ ュ ー 複数のオ ブ ジ ェ ク ト が選択 さ れてい る場合は、 共通の プ ロパテ ィ だけが表示 さ れ、 複数の コ ン ト ロ ールに効 率的に プ ロパテ ィ を割 り 当て る こ と がで き ます。 例え ば、 フ ォ ームの複数の フ ィ ール ド コ ン ト ロ ールの背景 色を変更 し たい場合、 レ イ アウ ト パネルのオ ブ ジ ェ ク ト を選択 し て背景 プ ロパテ ィ を変更す る と 、 新 し い背 景色がそれぞれの フ ィ ール ド コ ン ト ロ ールに適用 さ れ ます。 Unify NXJ 開発者ガ イ ド 17 2 プ ロパテ ィ を デ フ ォ ル ト 値に戻すには、 Value の列を右 ク リ ッ ク し て、 デ フ ォ ル ト 値に設定を選択 し ます。 プ ロパテ ィ を リ セ ッ ト ブ ラ ウザパネルの イ ベ ン ト ビ ュ ー イ ベ ン ト ビ ュ ーでは フ ォ ームス ク リ プ ト の概略や、 現在ス ク リ プ ト エデ ィ タ で編 集 し てい る グ ロ ーバル (全体的) な ビ ジ ネスルールがわか り ます。 イ ベ ン ト パネ ルを使 っ て フ ォ ームス ク リ プ ト に新規 イ ベ ン ト セ ク シ ョ ン を追加する こ と も で き ます。 イ ベ ン ト ビ ュ ー を表示す る には イ ベ ン ト タ ブ を ク リ ッ ク し ます。 イベン ト ビ ュー 利用で き る イ ベ ン ト セ ク シ ョ ン を表示する ド ロ ッ プ ダウ ン リ ス ト ス ク リ プ ト エデ ィ タ Unify NXJ 開発者ガ イ ド 18 2 フ ォ ームの場合、 フ ォ ーム と デー タ ビ ュ ーの名前が表示 さ れ、 フ ォ ームの フ ィ ー ル ド コ ン ト ロ ール名が表示 さ れます。 グ ロ ーバル (全体的) な ビ ジ ネ スルールの場合、 ルールの名称 と ロ ー カル関数が 表示 さ れます。 ユーザは、 イ ベ ン ト ビ ュ ー を使 っ て大き な フ ァ イル内を移動す る こ と がで き ます。 イ ベ ン ト ビ ュ ーのエ ン ト リ を選択す る と 、 ス ク リ プ ト エデ ィ タ がス ク ロ ール し て 該当する行に移動 し 、 エ ン ト リ がハ イ ラ イ ト さ れます。 ス ク リ プ ト エデ ィ タ の内容を変更す る と 、 イ ベ ン ト ビ ュ ーが更新 さ れます。 ブ ラ ウザパネルのデバ ッ ガービ ュ ー デバ ッ ガー ビ ュ ーは、 NXJ デバ ッ ガの実行時にだけ使用で き ます。 デバ ッ ガ タ ブ は、 NXJ デバ ッ ガ を起動 し た と き にだけ表示 さ れます。 デバ ッ ガ タ ブ を ク リ ッ ク する と デバ ッ ガー ビ ュ ーが表示 さ れます。 ア プ リ ケー シ ョ ン実行時に変数の値やプ ロパテ ィ が変更 さ れる と 、 デバ ッ ガービ ュ ーに表示 さ れます。 ま た、 デバ ッ ガービ ュ ー を使 っ て、 実行時のブ レ ー ク ポ イ ン ト にて、 こ れ ら の値を設定する こ と も で き ます。 Unify NXJ 開発者ガ イ ド 19 2 メ ニ ュ ーバー、 ツ ールバー、 コ ン ト ロ ール パレ ッ ト 、 ス タ イル バー デザ イ ン セ ン タ メ イ ン ウ イ ン ド ウの上部には、 メ ニ ュ ーバー、 ツ ールバー、 コ ン ト ロ ールパレ ッ ト 、 ス タ イルバーが配置 さ れています。 メ ニ ュ ーバー ツ ールバー コ ン ト ロ ール パレ ッ ト ス タ イルバー NXJ デザ イ ン セ ン タ の メ ニ ュ ーバーには、 ア プ リ ケーシ ョ ンの開発 と テ ス ト に使 用す る コ マ ン ド が用意 さ れています。 メ ニ ュ ーバーの下にはツ ールバーがあ り 、 よ く 使用する コ マ ン ド のボ タ ンが用意 さ れています。 コ ン テ ン ト パネルのエデ ィ タ で使用で き ないボ タ ンはス テ ィ ッ プ ル表示 さ れています。 ツ ールバーのボ タ ン と 対応す る メ ニ ュ ー項目を表 2-1 に示 し ます。 コ ン ト ロ ールパレ ッ ト には、 レ イ アウ ト パネルの フ ォ ームに配置する コ ン ト ロ ー ルが用意 さ れています。 コ ン ト ロ ールパレ ッ ト のシ ン ボルについては、 表 2-2 を 参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 20 2 ス タ イルバーはツ ールバーの下にあ り 、 レ イ アウ ト パネルの styled text コ ン ト ロ ー ルや他の コ ン ト ロ ールに フ ォ ン ト やス タ イルを適用する と き に使用 し ます。 コ ン テ ン ト パネルのエデ ィ タ で使用で き ないス タ イルバーはス テ ィ ッ プル表示 さ れて います。 表 2-1 ボタ ン NXJ デザ イ ン セ ン タ のツールバーのボ タ ン ( 1 / 3 ) 対応す る メ ニ ュ ー項目 説明 フ ァ イル > 新規 新規オブ ジ ェ ク ト パレ ッ ト が起動する。 こ のパレ ッ ト で、 プ ロ ジ ェ ク ト に追加する オブ ジ ェ ク ト の名前 を設定 し 、 タ イ プ を指定する。 フ ァ イル > 開 く フ ァ イル選択が起動する。 表示 さ れる フ ァ イルシ ス テムか ら 、 開 く フ ァ イルを指定する。 フ ァ イル > 保存 コ ン テ ン ト パネルで編集中のオブ ジ ェ ク ト を保存す る。 フ ァ イル > 閉 じ る コ ン テ ン ト パネルのア ク テ ィ ブ な編集セ ッ シ ョ ン を 閉 じ る。 編集セ ッ シ ョ ン に関連付け ら れてい る フ ァ イルが変更 さ れた場合は、 変更を保存するかど う か を たずねる メ ッ セージが表示 さ れる 編集 > 切 り 取 り 選択 し たオブ ジ ェ ク ト を編集セ ッ シ ョ ン ウ ィ ン ド ウ か ら NXJ デザイ ン セ ン タ の ク リ ッ プボー ド に移動す る。 編集 > コ ピー 選択 し たオブ ジ ェ ク ト を編集セ ッ シ ョ ン ウ ィ ン ド ウ か ら NXJ デザイ ン セ ン タ の ク リ ッ プボー ド に コ ピー する。 同 じ NXJ デザ イ ン セ ン タ のセ ッ シ ョ ン で貼 り 付け コ マ ン ド を使用する と 、 こ のオブ ジ ェ ク ト が編 集セ ッ シ ョ ン ウ ィ ン ド ウに配置 さ れる。 編集 > 貼 り 付け 最後に切 り 取 っ たオブ ジ ェ ク ト や コ ピー し たオブ ジ ェ ク ト を現在の編集セ ッ シ ョ ン ウ ィ ン ド ウに貼 り 付け る。 検索 > 検索 検索ダ イ ア ロ グが起動する。 ア ク テ ィ ブ な編集セ ッ シ ョ ン ウ ィ ン ド ウで文字列が検索で き る。 イ ンデン ト 解除 ス ク リ プ ト エデ ィ タ や HTML エデ ィ タ で選択 し た行 のイ ンデン ト を 1 つ解除する。 イ ンデン ト ス ク リ プ ト エデ ィ タ や HTML エデ ィ タ で選択 し た行 に イ ンデン ト を 1 つ追加する。 Unify NXJ 開発者ガ イ ド 21 2 表 2-1 ボタ ン NXJ デザ イ ン セ ン タ のツールバーのボ タ ン ( 2 / 3 ) 対応す る メ ニ ュ ー項目 説明 対応する括弧 ス ク リ プ ト エデ ィ タ で、 現在の カ ー ソ ル位置の最 も 近 く にあ る対応する括弧を検索する。 プレビ ュー Web ブ ラ ウザで、 フ ォ ームの JSP 版を表示する。 プロジ ェ ク ト > 変更分のみ Make こ のデザ イ ン セ ン タ セ ッ シ ョ ン で Make を実行 し た 後で変更 し た プ ロ ジ ェ ク ト の全 フ ァ イルに Make を 実行する。 プロジ ェ ク ト > デー タ ベース ウ イザー ド デー タ ベースウ イザー ド を起動する。 プ ロ ジ ェ ク ト > 実行 プ ロ ジ ェ ク ト を Make し 、 NXJ コ ン ト ロールセ ン タ に配備 し て実行する。 1 つの フ ォ ームを実行する に は、 ツールバーボ タ ンの ド ロ ッ プ ダウ ン リ ス ト か ら フ ォ ームを選択する。 デバ ッ グ > 開始 プ ロ ジ ェ ク ト の NXJ デバ ッ ガー を起動する。 ブ レ ー ク ポ イ ン ト が出現する ま で ア プ リ ケーシ ョ ンが実行 さ れる。 1 つの フ ォ ームをデバ ッ ク する には、 ツー ルバーボ タ ンの ド ロ ッ プ ダウ ン リ ス ト か ら フ ォ ーム を選択する。 デバ ッ グ を続け る NXJ デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 ブ レ ー ク ポ イ ン ト で停止 し た後に実行を継続する。 実行 > ブ レー クポイ ン ト の ON/OFF NXJ デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 ブ レ ー ク ポ イ ン ト の ON/OFF を ス ク リ プ ト エデ ィ タ ウ ィ ン ド ウの現在の行で切 り 換え る。 つま り 、 ブ レ ー ク ポ イ ン ト がない場合はブ レ ー ク ポ イ ン ト を設 定 し 、 ブ レ ー ク ポ イ ン ト があ る場合は削除する。 実行 > ス テ ッ プオーバー NXJ デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 メ ソ ッ ド 呼び出 し を スキ ッ プ し て次の jBiz 文ま で実行 する。 Unify NXJ 開発者ガ イ ド 22 2 表 2-1 NXJ デザ イ ン セ ン タ のツールバーのボ タ ン ( 3 / 3 ) 対応す る メ ニ ュ ー項目 ボタ ン 説明 実行 > ス テ ッ プ イ ン デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 次の jBiz 文ま で実行する。 実行 > ス テ ッ プ アウ ト NXJ デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 現在 の イ ベ ン ト セ ク シ ョ ンやビ ジネスルールの最後ま で 実行する。 実行 > デバ ッ グの中止 NXJ デバ ッ ガが動作 し てい る プ ロ ジ ェ ク ト で、 ア プ リ ケーシ ョ ン と Unify NXJ デバ ッ ガの実行を中止す る。 NXJ 以下の表には、 コ ン ト ロ ールパレ ッ ト で使用する シ ン ボルが示 さ れています。 表 2-2 シ ン ボル NXJ デザイ ン セ ン タ の コ ン ト ロール パレ ッ ト に用意 さ れてい る シ ンボル コ ン ト ロール シ ン ボル コ ン ト ロール シ ン ボル コ ン ト ロ ール Box Button Checkbox Data view Dropdown listbox Dynamic text field Image Image button Internal frame Label Line Link Listbox Radio group Repeating area Styled text box Tab set Table Text field Tab Text area コ ン ト ロ ールの詳細については、 88 ページの 「 コ ン ト ロ ールの使い方」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 23 2 コ ン テ ン ト パネル コ ン テ ン ト パネルは メ イ ン ウ ィ ン ド ウの右側部分で、 NXJ デザ イ ン セ ン タ の主要 な作業領域です。 コ ン テ ン ト パネルは、 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで 選択 し たオ ブ ジ ェ ク ト が表示 さ れます。 オ ブ ジ ェ ク ト は適切な エデ ィ タ で表示 さ れます。 コ ン テ ン ト パネルは、 編集中の各オ ブ ジ ェ ク ト の編集セ ッ シ ョ ンがあ り ます。 デ フ ォ ル ト では、 編集セ ッ シ ョ ンが最大化 さ れてお り 、 編集ウ ィ ン ド ウが最上部に あ り ます。 編集セ ッ シ ョ ンの並べ方を変更す る には、 ウ ィ ン ド ウ > タ イ ト ル ま た は ウ ィ ン ド ウ > カ スケー ド コ マ ン ド を使用 し ます。 ブ ラ ウザパネルを非表示にする と 、 コ ン テ ン ト パネルを さ ら に大き く 表示す る こ と がで き ます。 ブ ラ ウザパネルの表示 / 非表示を切 り 換え る には、 表示 > ブ ラ ウ ザ コ マ ン ド を選択 し ます。 注 – ユーザプ ロ フ ァ イルには、 デザ イ ン セ ン タ で作業する場合のプ リ フ ァ レ ン ス に関する情報が含まれています。 ユーザが NXJ デザ イ ン セ ン タ を起動す る たびに、 ブ ラ ウザパネル、 コ ン テ ン ト パネル、 メ ッ セージパネルは前回の NXJ デザ イ ン セ ン タ のセ ッ シ ョ ン で使用 し た も のが保存 さ れ、 同 じ よ う に表示 さ れます。 Unify NXJ 開発者ガ イ ド 24 2 1 つのオ ブ ジ ェ ク ト で複数のエデ ィ タ を使用す る こ と がで き ます。 その場合、 エ デ ィ タ は コ ン テ ン ト パネル下部の タ ブ で区別 し ます。 例えば、 ブ ラ ウザパネルで フ ォ ームを選択す る と 、 コ ン テ ン ト パネルにはレ イ アウ ト パネル、 ス ク リ プ ト エ デ ィ タ 、 JSP エデ ィ タ が表示 さ れます。 フ ォ ームの エデ ィ タ を 選択する タ ブ その フ ォ ームの JSP コ ー ド を編集する場合は、 JSP ソ ース タ ブ を ク リ ッ ク す る と JSP エデ ィ タ に切 り 替わ り ます。 ス ク リ プ ト を編集す る場合は、 jBiz ソ ース タ ブ を ク リ ッ ク す る と ス ク リ プ ト エデ ィ タ に切 り 替わ り ます。 注 – フ ォ ームには Web レ イ アウ ト 、 JSP コ ー ド 、 フ ォ ームス ク リ プ ト の 3 つの ビ ュ ーがあ り ますが、 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーに登録 さ れてい るの は 1 つだけです。 メ ッ セージパネル メ ッ セージパネルは、 NXJ デザ イ ン セ ン タ の情報を表示 し ます。 例えば、 以下の よ う な情報が表示 さ れます。 Unify NXJ 開発者ガ イ ド 25 2 • 検索結果 タ ブ を ク リ ッ ク する と 、 プ ロ ジ ェ ク ト でのグ ロ ーバル検索の結果が 表示 さ れます。 • コ ンパ イ ラ タ ブ を ク リ ッ ク す る と Make コ マ ン ド の結果が表示 さ れます。 メ ッ セージパネルを非表示にす る には、 表示 > メ ッ セージ コ マ ン ド を選択 し ま す。 メ ッ セージパネルに結果が表示 さ れる コ マ ン ド を実行する と 、 パネルが非表 示の場合で も パネルが開き、 結果が表示 さ れます。 ス テー タ ス ラ イ ン ス テー タ ス ラ イ ンは、 メ イ ン ウ ィ ン ド ウ下部にあ る 1 行の部分です。 ス ク リ プ ト エデ ィ タ で検索 > 検索を実行する と 、 ス テー タ ス ラ イ ン に結果が表示 さ れます。 ス テー タ ス ラ イ ン には、 ス ク リ プ ト の カ ー ソ ル位置の行番号か文字のど ち ら かが 表示 さ れます。 デザイ ン セ ン タ のカ ス タ マ イ ズ 自分に適 し た ス タ イルで ア プ リ ケーシ ョ ン を開発で き る よ う にデザ イ ン セ ン タ で の作業方法を変更する こ と がで き ます。 カ ス タ マ イ ズは、 すべてデザ イ ン セ ン タ オ プ シ ョ ン ダ イ ア ロ グで行います。 ダ イ ア ロ グにア ク セ スする には、 編集 > オ プ シ ョ ン を選択 し ます。 以下の カ テ ゴ リ が カ ス タ マ イ ズで き ます。 • 全般的な動作 • ス ク リ プ ト エデ ィ タ • キーボー ド シ ョ ー ト カ ッ ト • レ イ アウ ト パネル • コ ン ト ロ ールセ ン タ 注 – デザ イ ン セ ン タ を起動する と きはいつ も 、 前回のセ ッ シ ョ ン でオ プ シ ョ ン ダ イ ア ロ グに設定 し た内容がア ク テ ィ ブにな っ ています。 Unify NXJ 開発者ガ イ ド 26 2 全般的な動作 全般パネルでは、 デザ イ ン セ ン タ の さ ま ざ ま なオ プ シ ョ ンが指定で き ます。 • オ ブ ジ ェ ク ト の完全削除や削除を確認する チ ェ ッ ク ボ ッ ク ス。 デ フ ォ ル ト は、 はい (チ ェ ッ ク ボ ッ ク ス を設定) です。 • 実行 コ マ ン ド 動作中の コ ンパ イルエ ラ ー を無視す る チ ェ ッ ク ボ ッ ク ス。 デ フ ォ ル ト は、 いいえ (チ ェ ッ ク ボ ッ ク ス を ク リ ア) です。 コ ンパ イルエ ラ ーがあ っ て も ア プ リ ケーシ ョ ン を実行 さ せたい場合は、 こ の チ ェ ッ ク ボ ッ ク ス を設定 し ます。 その場合は、 コ ンパ イルエ ラ ーがないプ ロ ジ ェ ク ト の フ ォ ームだけが実行 さ れます。 ど ち ら かを エ ン ト リ ポ イ ン ト フ ォ ームに指定 し ます。 • 最後に閉 じ た プ ロ ジ ェ ク ト の数を指定 し 、 フ ァ イル メ ニ ュ ーに表示 し ます。 デ フ ォ ル ト は 5 です。 • 最後に閉 じ た フ ァ イルの数を指定 し 、 フ ァ イル メ ニ ュ ーに表示 し ます。 デ フ ォ ル ト は 5 です。 • プ リ ン タ のオ プ シ ョ ン。 印刷に使用す る フ ォ ン ト フ ァ ミ リ と フ ォ ン ト サ イ ズ、 お よ び行番号を印刷するかど う かを チ ェ ッ ク ボ ッ ク ス で指定 し ます。 デ フ ォ ル ト の フ ォ ン ト フ ァ ミ リ は Arial、 サ イ ズは 8 ポ イ ン ト で、 行番号を印刷 し ます。 ス ク リ プ ト エデ ィ タ エデ ィ タ パネルでは、 ス ク リ プ ト エデ ィ タ と HTML エデ ィ タ のプ リ フ ァ レ ン ス を 以下のよ う に指定 し ます。 • リ ス ト の各エ レ メ ン ト のデ フ ォ ル ト 色。 まず リ ス ト ボ ッ ク ス で エ レ メ ン ト タ イ プ を選択 し 、 次に色見本を ク リ ッ ク し て そのエ レ メ ン ト の色を指定 し ま す。 デ フ ォ ル ト のエ レ メ ン ト は、 以下の と お り です。 • コメント • 定数 • 区切 り 文字 • 識別子 • キーワー ド • 文字列 Unify NXJ 開発者ガ イ ド 27 2 • エデ ィ タ で使用す る デ フ ォ ル ト の フ ォ ン ト 。 フ ォ ン ト ボ ッ ク スの ド ロ ッ プ ダ ウ ン リ ス ト か ら フ ォ ン ト と フ ォ ン ト サ イ ズ を選択 し ます。 Unify NXJ のデ フ ォ ル ト は Monospaced 12 ポ イ ン ト です。 • デ フ ォ ル ト の タ ブサ イ ズ。 Unify NXJ のデ フ ォ ル ト は 8 です。 • デ フ ォ ル ト のシ フ ト 幅。 Unify NXJ のデ フ ォ ル ト は 4 です。 • デ フ ォ ル ト の自動 イ ン デ ン ト 機能。 ス ク リ プ ト エデ ィ タ は フ ォ ームス ク リ プ ト の作成に使用 し ます。 『Unify NXJ jBiz 言語ガ イ ド 』 の第 2 章 「ス ク リ プ ト エデ ィ タ の使い方」 を参照 し て く だ さ い。 キーボー ド シ ョ ー ト カ ッ ト NXJ デザ イ ン セ ン タ では、 さ ま ざ ま な コ マ ン ド のキーボー ド シ ョ ー ト カ ッ ト が使 用で き ます。 NXJ デザ イ ン セ ン タ には、 デ フ ォ ル ト のシ ョ ー ト カ ッ ト があ り ます。 ユーザが独自にキーボー ド シ ョ ー ト カ ッ ト を指定す る こ と も で き ます。 キーボー ド シ ョ ー ト カ ッ ト を確認 し た り 表示 し た り する には、 デザ イ ン セ ン タ オ プ シ ョ ン ダ イ ア ロ グのキーボー ド タ ブ を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 28 2 リ ス ト を ス ク ロ ール し て、 確認ま たは変更 し たい コ マ ン ド を検索 し ます。 キーボー ド シ ョ ー ト カ ッ ト には、 フ ァ ン ク シ ョ ン キー を使用す るか、 識別子 と な る コ ン ト ロ ールキー (Ctrl) と 組み合わせて使用 し ます。 Alt キーや Shift キー も 識 別子 と し て使用で き ます。 Esc キー と BackSpace キーは使用で き ません。 使用で き る キーについては、 155 ページの 「 コ マ ン ド キーマ ッ ピ ン グの変更」 を参照 し て く だ さ い。 Keystroke 列で入力 し たキーは、 BackSpace キー を使 う と 削除で き ます。 注 – 入力 し たキーは書式化 さ れた文字列 と し て表示 さ れます。 例えば、 Ctrl キー と “g” を同時に押す と 、 キース ト ロ ー ク 列には “Ctrl-G” と 表示 さ れます。 レ イ アウ ト パネル レ イ アウ ト パネルでは、 以下のオ プ シ ョ ンが指定で き ます。 • グ リ ッ ド の表示 / 非表示を指定す る チ ェ ッ ク ボ ッ ク ス。 デ フ ォ ル ト は、 グ リ ッ ド な し です。 • フ ォ ーム コ ン ト ロ ールを グ リ ッ ド 境界線に吸着 さ せるかど う かを指定す る チ ェ ッ ク ボ ッ ク ス。 デ フ ォ ル ト では、 吸着の設定はあ り ません。 • グ リ ッ ド 間隔を ピ ク セル単位で指定。 グ リ ッ ド 表示が選択 さ れてい る場合 は、 8 ∼ 100 が有効です。 グ リ ッ ド 表示が選択 さ れていない場合は、 1 ∼ 100 が有効です。 デ フ ォ ル ト は 16 です。 • 実行時に、 フ ォ ームの フ ィ ール ド コ ン ト ロ ールが左か ら 右、 上か ら 下の順に 移動するかど う かを指定する チ ェ ッ ク ボ ッ ク ス。 デ フ ォ ル ト では、 こ の チ ェ ッ ク ボ ッ ク スは設定 さ れています。 フ ィ ール ド 順 と は、 ユーザが次 フ ィ ール ド コ マ ン ド (デ フ ォ ル ト では タ ブ キーにマ ッ プ) を発行す る と き に フ ォ ー カ ス を受け る フ ィ ール ド の順番で す。 こ のオ プ シ ョ ン を指定 し なければ、 フ ィ ール ド コ ン ト ロ ール順は フ ィ ール ド コ ン ト ロ ールダ イ ア ロ グで指定 し た順にな り ます。 フ ィ ール ド コ ン ト ロ ール ダ イ ア ロ グは、 レ イ アウ ト > フ ィ ール ド 順 を選択する と 利用で き ます。 Unify NXJ 開発者ガ イ ド 29 2 コ ン ト ロールセ ン タ NXJ デザ イ ン セ ン タ で使用する コ ン ト ロ ールセ ン タ を構成する ために、 コ ン ト ロ ールセ ン タ パネルを使用 し ます。 NXJ デザ イ ン セ ン タ か ら NXJ ア プ リ ケーシ ョ ン を実行、 ま たはデバ ッ グする ために、 コ ン ト ロ ールセ ン タ は Java ア プ リ ケー シ ョ ンサーバ上に配備 さ れ、 ア ク セ ス可能 と な っ てい る必要があ り ます。 NXJ デ バ ッ ガ を使用する場合、 デバ ッ グサーバ も ま た Java ア プ リ ケーシ ョ ンサーバで ア ク セ ス可能 と な っ てい る必要があ り ます。 (デバ ッ グサーバは、 コ ン ト ロ ールセ ン タ が配備 さ れるサーバ と は異な る JVM モー ド で実行 し ます。) Unify NXJ を イ ン ス ト ールする と き、 通常は コ ン ト ロ ールセ ン タ が配備 さ れるサー バ と 、 デバ ッ グサーバが起動 し ます。 ま た、 コ ン ト ロ ールセ ン タ を配備、 削除、 更新は ccmanage ユーテ ィ リ テ ィ を使用 し て行 う こ と も で き ます。 ccmanage につ いての詳細は、 『Unify NXJ 管理者ガ イ ド 』 の付録 A を参照 し て く だ さ い。 コ ン ト ロ ールセ ン タ パネルを使 っ て、 以下の情報を構成 し ます。 • コ ン ト ロ ールセ ン タ : ド ロ ッ プ ダウ ン リ ス ト か ら コ ン ト ロ ールセ ン タ の名称 を選択 し ます。 ホ ス ト 上で利用可能なすべての コ ン ト ロ ールセ ン タ が、 リ ス ト 上に表示 さ れます。 • デバ ッ グサーバ :NXJ デバ ッ ガが使用す るサーバ。 ド ロ ッ プ ダウ ン リ ス ト か ら サーバ名を選択 し ます。 サーバ名は、 Java ア プ リ ケーシ ョ ンサーバのベ ン ダに よ っ て異な り ます。 Unify eWave の場合、 名称は <host>: デバ ッ グです。 こ こ での <host> はサーバが実行 し てい る ホ ス ト 名です。 WebLogic と Borland の場合、 名称は “UnifyDebug” です。 • 認証 : コ ン ト ロ ールセ ン タ が配備 さ れる Java ア プ リ ケーシ ョ ンサーバのロ グ イ ン情報です。 コ ン ト ロ ールセ ン タ を使用す る ためには、 Java ア プ リ ケーシ ョ ンサーバで ア プ リ ケーシ ョ ン を配備す る ためのパー ミ ッ シ ョ ン を持つユーザで なければな り ません。 さ ら に、 コ ン ト ロ ールセ ン タ 管理者ロ ールのユーザで なければな り ません。 Java ア プ リ ケーシ ョ ンサーバへのア ク セ スが必要な場合、 NXJ デ ザ イ ン セ ン タ は こ こ で提供 さ れる認証を使用 し ます。 認証が有効で ない場 合、 必要に応 じ て認証の入力す る ためのプ ロ ン プ ト が表示 さ れます。 デ フ ォ ル ト では、 Java ア プ リ ケーシ ョ ンサーバのデ フ ォ ル ト の管理の認証が こ のパネルに表示 さ れます。 • Unify eWave Engine の場合、 “admin” ユーザでパスワー ド は “admin” で す。 • Borland Enterprise サーバの場合、 “admin” ユーザでパスワー ド は “admin” です。 Unify NXJ 開発者ガ イ ド 30 2 • BEA WebLogic の場合、 フ ィ ール ド は空白です。 注 – コ ン ト ロ ールセ ン タ は、 IBM WebSphere Java ア プ リ ケーシ ョ ンサーバではサ ポー ト さ れていません。 コ ン ト ロ ールセ ン タ のユーザについての詳細は、 『Unify NXJ 管理者ガ イ ド 』 の 「セキ ュ リ テ ィ 」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 31 プ ロ ジ ェ ク ト の設定 3 プロジ ェ ク ト とは ? ア プ リ ケーシ ョ ンは、 NXJ デザ イ ン セ ン タ の プ ロ ジ ェ ク ト で管理 し ます。 規模の 大き いア プ リ ケーシ ョ ンは、 複数のプ ロ ジ ェ ク ト で管理す る こ と も で き ます。 プ ロ ジ ェ ク ト には、 以下のよ う な ア プ リ ケーシ ョ ン コ ン ポーネ ン ト があ り ます。 • ク ラ ス : フ ォ ーム、 追加 Java フ ァ イル、 グ ロ ーバルビ ジ ネ スルール • メ ニ ュ ー定義 • Look & Feel 定義 • static content フ ァ イル ま た、 プ ロ ジ ェ ク ト にはア プ リ ケーシ ョ ンの実行環境を定義す る以下のよ う な情 報 も 含まれています。 • デー タ ベース コ ネ ク シ ョ ン • ク ラ スパス定義 フ ァ イル メ ニ ュ ーの同 じ 名前の コ マ ン ド を使用す る こ と で、 プ ロ ジ ェ ク ト を開 く 、 保存、 閉 じ る こ と がで き ます。 各プ ロ ジ ェ ク ト は、 プ ロ ジ ェ ク ト プ ロパテ ィ ダ イ ア ロ グで確認 し た り 、 変更で き る一連のプ ロパテ ィ を持 っ ています。 詳細につい ては、 40 ページの 「全般プ ロパテ ィ の設定」 を参照 し て く だ さ い。 プ ロ ジ ェ ク ト の格納方法 プ ロ ジ ェ ク ト は、 一連の フ ァ イルで構成 さ れています。 その フ ァ イルの中で も 、 プ ロ ジ ェ ク ト 定義 フ ァ イルはその他のプ ロ ジ ェ ク ト フ ァ イルを追跡す る ために使 用 さ れます。 プ ロ ジ ェ ク ト 定義 フ ァ イルの拡張子は .prj です。 32 3 プ ロ ジ ェ ク ト を作成する と き には、 プ ロ ジ ェ ク ト 定義 フ ァ イルの名前 と プ ロ ジ ェ ク ト フ ァ イルのプ ロ ジ ェ ク ト デ ィ レ ク ト リ を指定 し ます。 オ ブ ジ ェ ク ト ( ク ラ ス、 static content フ ァ イル、 接続あ る いは、 look and feel 定義) が追加 さ れた り 、 プ ロ ジ ェ ク ト か ら 削除 さ れる たびに、 プ ロ ジ ェ ク ト 定義 フ ァ イ ルのバ ッ ク ア ッ プが作成 さ れて上書き さ れます。 バ ッ ク ア ッ プ フ ァ イルの名前 と デ ィ レ ク ト リ はプ ロ ジ ェ ク ト 定義 フ ァ イル と 同 じ ですが、 拡張子は .bak です。 以下に my_project と い う プ ロ ジ ェ ク ト のデ ィ レ ク ト リ 構造を示 し ます。 NXJ Work projects my_project sources Classes LookandFeels .jsp .laf output Menus .mnu StaticContent .rpt .fx .html Connections .cn .txt .fj .prj .gif webNXJ Unify NXJ 開発者ガ イ ド my_project.ear web-app 33 3 以下の表は、 プ ロ ジ ェ ク ト デ ィ レ ク ト リ に格納 さ れる オ ブ ジ ェ ク ト の タ イ プの リ ス ト です。 表 3-1 プ ロ ジ ェ ク ト デ ィ レ ク ト リ の内容 サブデ ィ レ ク ト リ 内容 sources/Classes プ ロ ジ ェ ク ト に設定 し た全 コ ン ポーネ ン ト の フ ァ イル。 フ ォ ーム (Web レ イ アウ ト ) : .jsp フ ァ イル フ ォ ーム ( フ ォ ーム ス ク リ プ ト ) : .fj フ ァ イル フ ォ ーム (プ ロパテ ィ 設定) : .fx フ ァ イル グ ロ ーバル ビ ジネス ルール : .fj フ ァ イル Java: .java sources/LookandFeels Look & Feel 定義 : .laf sources/Menus メ ニ ュ ー定義 : .mnu sources/StaticContent 何 も 変更 さ れずにプ ロ ジ ェ ク ト に イ ン ポー ト さ れ る フ ァ イル。 .txt、 .rpt、 .gif な ど。 プ ロ ジ ェ ク ト プ ロパテ ィ フ ァ イル も こ こ に保存 さ れます。 プ ロパ テ ィ フ ァ イルは、 ア プ リ ケーシ ョ ン を ロ ー カ ラ イ ズするのに使われます。 ロ ー カ ラ イ ズに関する詳 細は、 NXJ ド キ ュ メ ン ト Web ページ を参照 し て く だ さ い。 http://www.unify.com/products/nxj/documentation/supp lemental/index.htm sources/Connections プ ロ ジ ェ ク ト で使用するデー タ ベースへの接続 : .cn フ ァ イル output Make 操作に よ っ て作成 さ れる最 も 重要な フ ァ イ ル。 ア プ リ ケーシ ョ ンパ ッ ケージ EAR フ ァ イル :.ear 注 – フ ォ ームは 3 つのテキス ト フ ァ イルで表示 さ れます。 フ ォ ームス ク リ プ ト フ ァ イル、 Web レ イ アウ ト フ ァ イル、 お よ びプ ロパテ ィ 設定があ る拡張属性 フ ァ イルです。 NXJ デザ イ ン セ ン タ の コ マ ン ド は、 こ の 3 つの フ ァ イルを 1 つの単位 と し て処理 し ます。 別々に保存する と サー ド パーテ ィ のレ イ アウ ト ツ ールやテキ ス ト エデ ィ タ で利用で き ます。 Unify NXJ 開発者ガ イ ド 34 3 プ ロ ジ ェ ク ト の作成 プ ロ ジ ェ ク ト を作成する には、 新規プ ロ ジ ェ ク ト ウ イザー ド を使 っ て新規プ ロ ジ ェ ク ト を作成 し 、 プ ロ ジ ェ ク ト 名 と 保存先のデ ィ レ ク ト リ を指定 し ます。 デ ィ レ ク ト リ の容量 と ア ク セ ス権を確認 し てお き ます。 • フ ォ ームが 25 あ る プ ロ ジ ェ ク ト の場合、 お よ そ 10 MB 必要です。 イ メ ージ が多ければ さ ら に多 く の容量が必要です。 • プ ロ ジ ェ ク ト の読み込み / 書き込みがで き る権限はデ ィ レ ク ト リ のパー ミ ッ シ ョ ン で設定 し ます。 NXJ デザ イ ン セ ン タ では、 ユーザ認証は行いません。 プ ロ ジ ェ ク ト は、 関連す る デー タ ベース コ ネ ク シ ョ ンがい く つかあ り ます。 NXJ デザ イ ン セ ン タ は、 デー タ ベースにア ク セ ス を し て、 フ ォ ーム と デー タ ベース テーブルの列にマ ッ プ さ れる フ ィ ール ド コ ン ト ロ ールの定義を行います。 プ ロ ジ ェ ク ト は、 以下のス テ ッ プ で作成 し ます。 1. NXJ デザ イ ン セ ン タ で、 フ ァ イル > 新規プ ロ ジ ェ ク ト ... を選択 し 、 新規プ ロ ジ ェ ク ト ウ ィ ザー ド を起動 し ます。 2. 最初のパネルで、 プ ロ ジ ェ ク ト 名 と 作成先のデ ィ レ ク ト リ を入力 し ます。 デ フ ォ ル ト では、プ ロ ジ ェ ク ト は NXJ 作業デ ィ レ ク ト リ の “projects” と い う 名 前のサブデ ィ レ ク ト リ に作成 さ れます。 作業デ ィ レ ク ト リ は、 Unify NXJ の イ ン ス ト ール時に指定 さ れた も のです。 Windows のデ フ ォ ル ト の NXJ 作業デ ィ レ ク ト リ は、 以下の と お り です。 <System Root>\Unify\NXJWork 3. 次へ ボ タ ン を ク リ ッ ク し ます。 デ フ ォ ル ト デー タ ベース接続 パネルが表示 さ れます。 Unify NXJ 開発者ガ イ ド 35 3 こ のパネルは、 プ ロ ジ ェ ク ト のデ フ ォ ル ト デー タ ベース接続を構成 し ます。 デ フ ォ ル ト デー タ ベース接続を指定 し ない場合は、 パネルの フ ィ ール ド には 何 も 入力せずに 完了 ボ タ ン を ク リ ッ ク し ます。 その後は、 接続は Connection プ ロパテ ィ を使 っ て、 フ ォ ーム レ ベルに指定する こ と がで き ます。 デ フ ォ ル ト コ ネ ク シ ョ ン を定義する ために、 パネルの フ ィ ール ド に以下の情 報を追加 し ます。 名称 : デー タ ベース コ ネ ク シ ョ ンの名前。 タ イ プ : 接続先のデー タ ベースの RDBMS タ イ プ。 ド ロ ッ プ ダウ ン リ ス ト か ら タ イ プ を選択 し ます。 DataServer、 Oracle、 Microsoft SQL Server、 Sybase、 DB2、 その他の JDBC デー タ ベースか ら 選択で き ます。 Jar/Zip フ ァ イル : JDBC ド ラ イバが含まれてい る Jar フ ァ イルま たは Zip フ ァ イルを指定 し ます。 Unify NXJ は、 最 も よ く 使用 さ れる デー タ ベースに 適応する Jar フ ァ イルを含んでいます。 File Choose を使 っ て フ ァ イルを指定 するか、 フ ィ ール ド に フ ァ イル名 と パス を入力 し ます。 Jar/Zip フ ァ イル名 と その場所については、 表 3-2 「デー タ ベース固有の接続情報」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 36 3 デー タ ベース タ イ プ で それ以外の JDBC デー タ ベース を指定す る場合は、 そ のデー タ ベース ド ラ イバの Jar フ ァ イル、 ま たは Zip フ ァ イルのデ ィ レ ク ト リ を指定 し ます。 ユーザ と パスワー ド : NXJ デザ イ ン セ ン タ か ら デー タ ベースにア ク セ スす る ためのユーザ名 と パスワー ド 。 実行時に使用する デー タ ソ ース : ア プ リ ケーシ ョ ン を配備する と 、 設計時の コ ネ ク シ ョ ンが、 実行時にデー タ ソ ースにマ ッ プ さ れます。 こ の時、 デ フ ォ ル ト の実行時に使用する デ フ ォ ル ト のデー タ ソ ース を接続に設定する こ と が で き ます。 ド ロ ッ プ ダウ ン リ ス ト か ら 名前を選択す るか、 フ ィ ール ド に名前 を入力 し ます。 NXJ コ ン ト ロ ールセ ン タ で ア プ リ ケーシ ョ ン を配備する と 、 こ のマ ッ ピ ン グはオーバ ラ イ ド する こ と がで き ます。 プ ロパテ ィ : 各 タ イ プのデー タ ベースには、 その位置を指定する 1 組のプ ロ パテ ィ があ り ます。 以下の表は、 各デー タ ベース タ イ プのプ ロパテ ィ の説明 です。 表 3-2 デー タ ベース固有の接続情報 デー タ ベー スタ イプ Jar ま たは Zip File の位置 プ ロパテ ィ DataServer <NXJHome>\lib\jdbcDrivers\Si mbaJDBC.jar Host: デー タ ベース を含むホス ト 名。 Port: デー タ ベースが リ ス ニ ン グ し て い る ポー ト 。 DSN: デー タ ソ ース名 Oracle <NXJHome>lib\jdbcDrivers\clas ses12.zip Host: デー タ ベース を含むホス ト 名。 Port: デー タ ベースが リ ス ニ ン グ し て い る ポー ト 。 SID: デー タ ベースのシ ス テム ID. Sybase <NXJHome>\lib\jdbcDrivers\jco nn2.jar Host: デー タ ベース を含むホス ト 名。 Port: デー タ ベースが リ ス ニ ン グ し て い る ポー ト 。 Microsoft SQL Server <NXJHome>\lib\jdbcDrivers\jtds -0.5.jar Host: デー タ ベース を含むホス ト 名。 Port: デー タ ベースが リ ス ニ ン グ し て い る ポー ト 。 DB2 <SQLLIB>\java\db2java.zip 1 Database Name: デー タ ベース名。 1 <SQLLIB> と は DB2 がイ ン ス ト ール さ れた場所です。 Unify NXJ は、 こ の Zip フ ァ イルを含んでいませ ん。 4. テ ス ト ボ タ ン を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 37 3 デー タ ベースに正 し く ア ク セ ス で き る と 、 メ ッ セージパネルに メ ッ セージが 表示 さ れます。 それ以外の場合は、 パネルに入力 し た内容を再確認 し ます。 5. 完了 ボ タ ン を ク リ ッ ク し ます。 新規プ ロ ジ ェ ク ト が、 NXJ デザ イ ン セ ン タ で作成 さ れて開き ます。 プ ロ ジ ェ ク ト デ ィ レ ク ト リ フ ィ ール ド で指定 し た場所に プ ロ ジ ェ ク ト デ ィ レ ク ト リ が 作成 さ れます。 接続の設定例については、 『Unify NXJ チ ュ ー ト リ アル』 の第 2 章 「チ ュ ー ト リ ア ル初期設定」 を参照 し て く だ さ い。 注 – 開いてい る プ ロ ジ ェ ク ト が使用 し てい る接続に関連する デー タ ベースのス キーマ を変更 し た場合には、 接続を リ フ レ ッ シ ュ し て新 し いスキーマ情報を取得 し なければな り ません。 接続を リ フ レ ッ シ ュ する には、 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで接続名を選択 し 、 右 ク リ ッ ク を し て メ ニ ュ ーか ら リ フ レ ッ シ ュ を選択 し ます。 接続は、 NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの jBiz NXJDataConnection オ ブ ジ ェ ク ト を使 っ て実行時にア ク セ ス で き ます。 プ ロ ジ ェ ク ト の開始 と 終了 プ ロ ジ ェ ク ト を開いた り 、 閉 じ る と き には、 フ ァ イル メ ニ ュ ーのプ ロ ジ ェ ク ト を 開 く コ マ ン ド と プ ロ ジ ェ ク ト を閉 じ る コ マ ン ド を使用 し ます。 プ ロ ジ ェ ク ト の開始 NXJ デザ イ ン セ ン タ では、 どんな と き で も 1 つのプ ロ ジ ェ ク ト のみを開 く こ と が で き ます。 プ ロ ジ ェ ク ト が現在開いてい る場合は、 閉 じ る こ と がで き ます。 プ ロ ジ ェ ク ト を開 く には、 以下のス テ ッ プの と お り です。 1. フ ァ イル > プ ロ ジ ェ ク ト を開 く を選択 し ます。 初めてデザ イ ン セ ン タ を開始 し た り 、 実行す る場合、 プ ロ ジ ェ ク ト フ ォ ルダ か ら 、 プ ロ ジ ェ ク ト を開 く ダ イ ア ロ グが表示 さ れます。 その後の同 じ セ ッ シ ョ ンのプ ロ ジ ェ ク ト を開 く コ マ ン ド では、 最後に開かれたデ ィ レ ク ト リ が デ フ ォ ル ト にな り ます。 Unify NXJ 開発者ガ イ ド 38 3 2. 開き たい プ ロ ジ ェ ク ト (.prj) フ ァ イルを含む フ ォ ルダ を ブ ラ ウズ し ます。 プ ロ ジ ェ ク ト フ ォ ルダの リ ス ト が表示 さ れます。 3. タ ーゲ ッ ト プ ロ ジ ェ ク ト を含むプ ロ ジ ェ ク ト フ ォ ルダ を ダ ブル ク リ ッ ク し ま す。 ソ ース フ ォ ルダ と プ ロ ジ ェ ク ト <filename.prj> が表示 さ れます。 過去に作成 し た プ ロ ジ ェ ク ト を再度開 く 場合には、 出力デ ィ レ ク ト リ も 表示 さ れます。 4. .prj フ ァ イル名を ダ ブル ク リ ッ ク し ます。 プ ロ ジ ェ ク ト が、 NXJ デザ イ ン セ ン タ で開き ます。 プ ロ ジ ェ ク ト の終了 プ ロ ジ ェ ク ト を閉 じ る コ マ ン ド は、 すべてのチ ャ イル ド ウ ィ ン ド ウ を閉 じ て、 プ ロ ジ ェ ク ト パネルを空に リ セ ッ ト し ます。 チ ャ イル ド ウ ィ ン ド ウのいずれかがそ の と き ま だ変更を保存 し ていない場合には、 デザ イ ン セ ン タ は、 変更を保存 し て いない最初の フ ァ イル名で、 はい / すべてはい / いいえ / すべていいえ / 取消ポ ッ プ ア ッ プ を表示 し ます。 1. フ ァ イル > フ ァ イルを閉 じ る を選択 し ます。 デ フ ォ ル ト の フ ォ ームを作成す る よ う に プ ロ ジ ェ ク ト レ ベルで変更を し た場 合、 こ れ ら は自動的に保存 さ れます。 保存 し ていない フ ォ ームに変更を し た 場合、 以下に示す よ う な変更の保存ダ イ ア ロ グが表示 さ れます。 • はい ボ タ ン を ク リ ッ ク す る場合、 変更は保存 さ れます。 ま だ変更を保存 し ていない次の フ ァ イルが表示 さ れます。 変更を保存 し ていない フ ァ イルがな く な る と 、 ダ イ ア ロ グは閉 じ ます。 • すべてはい ボ タ ン を ク リ ッ ク す る場合、 残 っ てい る すべての変更が保存 さ れます。 Unify NXJ 開発者ガ イ ド 39 3 • いいえ ボ タ ン を ク リ ッ ク する場合、 デザ イ ン セ ン タ は変更を無視 し て、 変更を保存 し ていない次の フ ァ イルを表示 し ます。 • すべていいえ ボ タ ン を ク リ ッ ク する場合、 ダ イ ア ロ グ と プ ロ ジ ェ ク ト は 残 っ てい る変更を保存せずに閉 じ ら れます。 • 取消 ボ タ ン を ク リ ッ ク す る場合、 ダ イ ア ロ グは閉 じ ら れます。 プ ロ ジ ェ ク ト は開いた ま ま です。 プ ロ ジ ェ ク ト が開いてい る場合にのみ、 プ ロ ジ ェ ク ト を閉 じ る コ マ ン ド は有効で す。 プ ロ ジ ェ ク ト のイ ンポー ト と エ ク スポー ト Unify NXJ のチーム開発機能を使 っ て、 プ ロ ジ ェ ク ト の イ ン ポー ト と エ ク スポー ト がで き ます。 詳細については、 http://www.unify.com/products/nxj/documentation/supplemental/index.htm で NXJ ド キ ュ メ ン ト を参照 し て く だ さ い。 全般プ ロパテ ィ の設定 メ ニ ュ ーバーで、 プ ロ ジ ェ ク ト > プ ロパテ ィ を選択す る と 、 プ ロ ジ ェ ク ト プ ロパ テ ィ パネルが表示 さ れます。 こ のパネルの最初の タ ブは全般パネルで、 以下の こ と を設定す る場合に使用 し ます。 • ア プ リ ケーシ ョ ンパ ッ ケージ保存先 : .ear フ ァ イル (生成 さ れた ア プ リ ケー シ ョ ンパ ッ ケージ) の場所を指定す る読み込み専用 フ ィ ール ド 。 • 生成する JSP の文字 コ ー ド セ ッ ト : NXJ イ ン タ ラ ク シ ョ ンサーバで使用す る 文字セ ッ ト 。 ISO と 他の文字セ ッ ト の ド ロ ッ プ ダウ ン リ ス ト か ら 選択 し ます。 • 終了 URL : EXIT 操作を実行 し た と き に表示 さ れる ページの URL。 例えば、 デ フ ォ ル ト の NXJ ツ ールバーで Exit App ボ タ ン を ク リ ッ ク する と 、 NXJ で 用意 さ れてい る次の図のよ う なデ フ ォ ル ト の “exit.html” ページが表示 さ れま す。 Unify NXJ 開発者ガ イ ド 40 3 通常、 こ のページはア プ リ ケーシ ョ ンのエ ン ト リ フ ォ ームにな っ てお り 、 ユーザは別のア プ リ ケーシ ョ ン タ ス ク を選択で き ます。 ポー タ ブルな ア プ リ ケーシ ョ ン にする には、 相対 URL を指定 し ます。 例えば、 “XREQUEST” や “Static_Content/HTML/myExit.html” のよ う な フ ォ ーム名を入力 し ます。 <http://MyHost:8088/myControlCenter/packages/tutorial/XREPORT> のよ う に絶 対 URL を指定する と 、 こ のパ ッ ケージ を別の NXJ コ ン ト ロ ールセ ン タ やホ ス ト に配備 し た場合は指定 し たページが表示 さ れません。 • デ フ ォ ル ト で ロ ー カ ラ イ ズ : チ ェ ッ ク ボ ッ ク スが設定 さ れてい る場合は、 プ ロ ジ ェ ク ト のすべての フ ォ ームがロ ー カ ラ イ ズ さ れます。 デ フ ォ ル ト では、 チ ェ ッ ク ボ ッ ク スは ク リ ア です。 ロ ー カ ラ イ ズに関 し ての詳細は、 以下の URL の NXJ ド キ ュ メ ン ト を参照 し て く だ さ い。 http://www.unify.com/products/nxj/documentation/supplemental/index.htm. ク ラ スパスの設定 ア プ リ ケーシ ョ ン で JDBC ド ラ イバ以外のサー ド パーテ ィ ク ラ ス を使用する場合、 NXJ デザ イ ン セ ン タ で こ れ ら の ク ラ ス を使用で き る よ う に設定 し てお く 必要があ り ます。 例えば、 地理情報シ ス テム (GIS) な どのサー ド パーテ ィ Java コ ン ポー ネ ン ト を プ ロ ジ ェ ク ト の ク ラ スパスに含めて設定す る必要があ り ます。 プ ロ ジ ェ ク ト の ク ラ スパス を設定す る ス テ ッ プは、 以下の と お り です。 1. プ ロ ジ ェ ク ト > プ ロパテ ィ を選択 し 、 プ ロパテ ィ ダ イ ア ロ グ を開き ます。 2. ク ラ スパス タ ブ を ク リ ッ ク し て ク ラ スパス パネルを表示 し ます。 3. 追加 ボ タ ン を ク リ ッ ク し て、 空の ク ラ スパス エ ン ト リ を新 し く 作成 し ます。 Unify NXJ 開発者ガ イ ド 41 3 4. ク ラ スパスの列に、 ク ラ スパスに追加する Jar フ ァ イルのパス と 名前を入力 し ます。 フ ァ イルの 選択 ボ タ ン で Jar フ ァ イルのデ ィ レ ク ト リ を指定する こ と も で き ます。 5. ア プ リ ケーシ ョ ン作成時に Jar フ ァ イルを ア プ リ ケーシ ョ ンパ ッ ケージに コ ピ ーする場合は、 WAR に含める チ ェ ッ ク ボ ッ ク ス を設定 し ます。 実行時にア プ リ ケーシ ョ ンパ ッ ケージが .jar フ ァ イルを使用する場合には、 ア プ リ ケーシ ョ ンパ ッ ケージはその .jar フ ァ イルが必要です。 ま た他の メ ソ ッ ド の Java ア プ リ ケーシ ョ ンサーバでは、 その .jar フ ァ イルは利用で き ま せん。 6. エ ン ト リ を削除す る場合は、 行を選択 し て 削除 ボ タ ン を ク リ ッ ク し ます。 7. OK ボ タ ン を ク リ ッ ク し ます。 追加デー タ ベース コ ネ ク シ ョ ンの設定 ア プ リ ケーシ ョ ン で必要なデー タ ベース コ ネ ク シ ョ ンが、 新規プ ロ ジ ェ ク ト ウ イ ザー ド 中に指定 さ れていない場合には、 フ ォ ームを開発す る前に作成す る必要が あ り ます。 新規デー タ ベース コ ネ ク シ ョ ン を作成す る ス テ ッ プは、 以下の と お り です。 1. フ ァ イル > 新規 を選択 し 、 新規オ ブ ジ ェ ク ト ダ イ ア ロ グ を開き ます。 2. デー タ ベース コ ネ ク シ ョ ン記号を ク リ ッ ク し 、 名称 フ ィ ール ド に接続名を入 力 し ます。 デー タ ベース コ ネ ク シ ョ ン ダ イ ア ロ グが表示 さ れます。 新規プ ロ ジ ェ ク ト の作成で説明 さ れてい る通 り に必要な情報を フ ィ ール ド に 入力 し ます。 35 ページの 「プ ロ ジ ェ ク ト の作成」 を参照 し て く だ さ い。 3. こ の コ ネ ク シ ョ ン を プ ロ ジ ェ ク ト のデ フ ォ ル ト コ ネ ク シ ョ ン にす る場合、 “ こ の コ ネ ク シ ョ ン を デ フ ォ ル ト にす る ” チ ェ ッ ク ボ ッ ク ス を設定 し ます。 プ ロ ジ ェ ク ト でデ フ ォ ル ト の コ ネ ク シ ョ ン にする こ と がで き るのは、 1 つの コ ネ ク シ ョ ン だけです。 デ フ ォル ト コネクシ ョ ン シ ン ボル ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーでは、 デ フ ォ ル ト コ ネ ク シ ョ ンは、 右のシ ン ボルで表示 さ れています。 4. テ ス ト ボ タ ン を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 42 3 デー タ ベースのア ク セ スが成功する と 、 メ ッ セージパネルには メ ッ セージが 表示 さ れます。 そ う で ない場合は、 パネルに入力 し た値を再確認 し ます。 5. OK ボ タ ン を ク リ ッ ク し ます。 注 – オープ ン中のプ ロ ジ ェ ク ト の コ ネ ク シ ョ ン に関連する デー タ ベースのスキー マ を変更 し た場合には、 コ ネ ク シ ョ ン を リ フ レ ッ シ ュ し て、 新規のスキーマ情報 を獲得する必要があ り ます。 コ ネ ク シ ョ ン を リ フ レ ッ シ ュ する には、 ブ ラ ウザパ ネルのプ ロ ジ ェ ク ト ビ ュ ーで、 コ ネ ク シ ョ ン名を選択 し 、 右 ク リ ッ ク し て、 表示 を更新を選択 し ます。 プ ロ ジ ェ ク ト 環境のカ ス タ マ イ ズ それぞれのプ ロ ジ ェ ク ト には、 そのプ ロ ジ ェ ク ト に適 し た環境を定義す る環境設 定があ り ます。 設定で き るのは、 以下の項目です。 • プ ロ ジ ェ ク ト の Look & Feel 定義 • Static Content フ ァ イルへのア ク セ ス タ イ プ : • 匿名ユーザを許可 • 認証 さ れたユーザを許可 プ ロパテ ィ を設定する ス テ ッ プは、 以下の と お り です。 1. プ ロ ジ ェ ク ト > プ ロパテ ィ を選択 し 、 プ ロ ジ ェ ク ト プ ロパテ ィ ダ イ ア ロ グ を 開き ます。 2. 環境 タ ブ を ク リ ッ ク し て、 環境 パネルを表示 し ます。 3. プ リ フ ァ レ ン ス を変更 し ます。 4. OK ボ タ ン を ク リ ッ ク し ます。 ロ ケールの設定 こ のパネルに、 プ ロ ジ ェ ク ト で使用す る ロ ケールを入力 し ます。 1. ロ ケール フ ィ ール ド に ロ ケールを入力 し ます。 Unify NXJ 開発者ガ イ ド 43 3 デ フ ォ ル ト は en_US です。 Javadoc のロ ケールの リ ス ト については http://java.sun.com/j2se/1.3/ja/docs/ja/api/java/util/Locale.html を参照 し て く だ さ い。 2. 追加 ボ タ ン を ク リ ッ ク し ます。 3. OK ボ タ ン を ク リ ッ ク し ます。 NXJ ア プ リ ケーシ ョ ンのロ ー カ ラ イ ズに関す る詳細については、 http://www.unify.com/products/nxj/documentation/supplemental/index.htm を参照 し て く だ さ い。 表示通貨を選択 こ のパネルでは、 Amount デー タ の表示に使用する通貨記号 と 表示単位を指定 し ま す。 デ フ ォ ル ト では、 通貨表示形式は Java ア プ リ ケーシ ョ ンサーバで有効な ロ ケールの設定に よ り 決定 さ れます。 1. サーバのロ ケールの設定には依存 し ないで通貨記号を指定 し たい場合は、 シ ン ボルを指定する ラ ジ オ ボ タ ン を ク リ ッ ク し ます。 デ フ ォ ル ト では、 サーバのロ ケールを使用 ラ ジオ ボ タ ンが設定 さ れていま す。 2. 通貨記号を入力 し ます。 通貨記号には文字列を使用 し ます。 文字列には、 %、 ^、 x、 \\、 \^、 \% 以外 の文字が使用で き ます。 例えば、 Amount デー タ を ユー ロ建てに し たい場合は、 こ の フ ィ ール ド に € と 入力 し ます。 3. 通貨表示単位を入力 し ます。 通貨表示単位は、 小数点以下の桁数です。 デ フ ォ ル ト の通貨表示単位は 2 で す。 4. OK ボ タ ン を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 44 フ ォ ームの作成 と フ ォ ーム の関連性 4 こ の章では、 フ ォ ームの作成方法 と 、 フ ォ ームの動作や外観を カ ス タ マ イ ズす る 方法を説明 し ます。 カ ス タ マ イ ズが必要な動作の 1 つに、 ア プ リ ケーシ ョ ン中の 他の フ ォ ーム と の関連があ り ます。 例えば、 次 フ ォ ームやズーム フ ォ ームです。 フ ォ ームの作成方法は、 その フ ォ ームのデー タ ビ ュ ーに よ っ て異な り ます。 フ ォ ームには、 デー タ ビ ュ ーが全 く ない場合、 1 つだけあ る場合、 複数あ る場合が あ り ます。 デー タ ビ ュ ー と は、 フ ォ ームの コ ン ト ロ ールに よ り 検索 し た り 、 変更 し た り で き る デー タ ソ ース です。 通常、 デー タ ビ ュ ーはデー タ ベースのテーブル です。 デー タ ビ ュ ーがない フ ォ ームは、 フ ォ ームス ク リ プ ト や、 Web ページへの リ ン ク か ら デー タ を提供 し ます。 あ る いは、 フ ォ ーム自身の静的テキス ト を提供 し ます。 フ ォ ームを作成す る前に、 以下の こ と を決めてお く 必要があ り ます。 • 絶対位置、 テーブルベースの位置のど ち ら を使用す るか • シ ン グルオ カ レ ン ス、 ま たはマルチオ カ レ ン スのど ち ら で、 レ コ ー ド を表示 するか 絶対位置 と テーブルベースの位置 Web ページは、 通常は位置指定のない HTML エ レ メ ン ト を表示 し ます。 Web ブ ラ ウザは、 HTML エ レ メ ン ト を上か ら 下、 左か ら 右の順に表示 し ます。 実際のレ イ アウ ト は、 Web ブ ラ ウザのウ ィ ン ド ウのサ イ ズに よ っ て異な り ます。 ウ ィ ン ド ウ 幅が広ければ全て 1 行に表示 さ れます し 、 ウ ィ ン ド ウ幅が足 り なければ複数行に 分けて表示 さ れます。 し か し Unify NXJ で生成 さ れる JSP ページ では位置指定を 使用 し ています。 Unify NXJ には次の 2 種類の位置があ り ます。 • 絶対位置 • テーブルベースの位置 45 4 絶対位置 フ ォ ームの コ ン ト ロ ールに対 し て絶対位置を使用す る と 、 各 フ ィ ール ド のサ イ ズ と 位置を ピ ク セルで指定する特別な HTML 属性が使用 さ れます。 JSP では、 コ ン テ ナ コ ン ト ロ ールが フ ォ ーム、 タ ブ、 ボ ッ ク ス、 繰 り 返 し 領域、 デー タ ビ ュ ーの どれであ っ て も 、 コ ン ト ロ ールに左上か ら の絶対サ イ ズ と 位置が指定 さ れます。 サ イ ズ と 位置は NXJ デザ イ ン セ ン タ で計算 さ れ、 ユーザはレ イ アウ ト パネルの WYSIWYG 画面を使 う だけで コ ン ト ロ ールを配置で き ます。 テーブルベースのレ イ アウ ト よ り も ず っ と 簡単ですが、 こ の方法ではブ ラ ウザの サ イ ズ を変更 し て も フ ィ ール ド のレ イ アウ ト は変更 さ れません。 テーブルベースの位置 テーブルベースの位置では、 まずレ イ アウ ト パネルに テーブルを作成 し 、 次に テーブルのセルに コ ン ト ロ ールを配置 し ます。 テーブルベースの位置では、 配置 場所を細か く 指定する こ と がで き ます。 テーブルには境界線があ り ますが、 ユー ザに テーブルは表示 さ れません。 し か し 、 フ ィ ール ド は、 テーブルのセルのサ イ ズに応 じ て きれいに配置する こ と がで き ます。 ま た、 ブ ラ ウザのサ イ ズ を変更す る と レ イ アウ ト は自動的に調整 さ れます。 し か し 、 密集 し た フ ォ ームではテーブ ルを ネ ス ト さ せる必要があ り 、 複雑にな るので、 ページ作成は絶対位置の場合よ り も 大変にな り ます。 フ ィ ール ド に絶対レ イ アウ ト を使用す る場合は、 キーボー ド の矢印キーで コ ン ト ロールを ド ラ ッ グ し て移動する こ と がで き ます。 テーブルベースのレ イ アウ ト で は、 テーブルのセルを新 し いサ イ ズ と 位置ま で ク リ ッ ク & ド ラ ッ グ し てサ イ ズ と 配置を変更 し ます。 サ イ ズ を変更す る場合は、 テーブルの行か列を選択 し 、 列の 端を ド ラ ッ グ し ます。 メ ニ ュ ーバーのレ イ アウ ト には、 セルの結合や分割の コ マ ン ド があ り 、 さ ら に複雑な レ イ アウ ト が作成で き ます。 ス タ イルの選択 フ ォ ームを作成す る と き に、 絶対位置かテーブルベースの位置かを指定で き ます。 デ フ ォ ル ト では、 絶対位置が使用 さ れます。 Unify NXJ 開発者ガ イ ド 46 4 フ ォ ームのス タ イルを選択 : シ ングルオ カ レ ン ス と マルチオ カ レ ン ス シ ン グルオ カ レ ン ス フ ォ ームでは、 一度に 1 つのレ コ ー ド のみが表示 さ れます。 表示 さ れるのは現在のレ コ ー ド です。 シ ン グルオ カ レ ン ス フ ォ ームで他のレ コ ー ド を表示す る には、 Next Record のよ う な レ コ ー ド を操作す る コ マ ン ド を発行 し ま す。 1 つのシ ン グルオ カ レ ン ス フ ォ ームでは、 1 つのレ コ ー ド のみを表示 し ます。 例えば、 注文書の最初の行のみが表示 さ れます。 マルチオ カ レ ン ス フ ォ ームには一度に複数のレ コ ー ド が表示 さ れ、 レ コ ー ド ご と に移動する こ と も セ ッ ト ご と に移動す る こ と も で き ます。 1 つのマルチオ カ レ ン ス フ ォ ームでは、 レ コ ー ド のセ ッ ト が一度に表示で き ます。 例えば、 注文書の複数 行が表示で き ます。 マルチオ カ レ ン ス フ ォ ームのレ コ ー ド は、 繰 り 返 し 領域 コ ン ト ロ ールに表示 さ れ ます。 (繰 り 返 し 領域 コ ン ト ロ ールの外にあ る コ ン ト ロ ールは繰 り 返 し さ れませ ん。) 繰 り 返 し 領域 コ ン ト ロ ールには、 フ ィ ール ド と リ ス ト ボ ッ ク ス と い う 2 つの タ イ プがあ り ます。 フ ィ ール ド タ イ プの繰 り 返 し 領域では、 ラ ベルの下に個別の フ ィ ール ド が表示 さ れます。 フ ィ ール ド :個別のテキス ト フ ィ ール ド コ ン ト ロール と ラ ベルの集ま り Unify NXJ 開発者ガ イ ド 47 4 リ ス ト ボ ッ ク ス : 個別のテキス ト フ ィ ール ド コ ン ト ロール と ラ ベル リス ト ボッ クス テキス ト フ ィ ール ド リ ス ト ボ ッ ク スの繰 り 返 し 領域には、 リ ス ト ボ ッ ク ス コ ン ト ロ ール と テキス ト フ ィ ール ド コ ン ト ロ ール と い う 2 種類の フ ィ ール ド コ ン ト ロ ールがあ り ま す。 リ ス ト ボ ッ ク ス コ ン ト ロ ールには繰 り 返す行が表示 さ れてお り 、 リ ス ト ボ ッ ク スの下のテキス ト フ ィ ール ド コ ン ト ロ ールには、 現在 リ ス ト ボ ッ ク ス で選択 さ れてい る行のデー タ が表示 さ れています。 リ ス ト ボ ッ ク スに表示 さ れる行は読み込み専用です。 リ ス ト ボ ッ ク スの選択セ ッ ト を ス ク ロ ールす る と 、 テキス ト フ ィ ール ド の表 示 も 自動的に変わ り ます。 繰 り 返 し 領域は、 マルチオ カ レ ン ス フ ォ ーム を作成する と デ フ ォ ル ト で作成 さ れ ます。 繰 り 返 し 領域の作成についての詳細は、 145 ページの 「繰 り 返 し 領域 コ ン ト ロ ール」 を参照 し て く だ さ い。 単一デー タ ビ ュ ー フ ォ ームの作成 単一デー タ ビ ュ ーの フ ォ ームを作成す る には、 以下の 3 つの方法があ り ます。 方法 1 : 複数のデ フ ォ ル ト フ ォ ーム を作成す る 方法 2 : デ フ ォ ル ト フ ォ ーム を 1 つ作成する 方法 3 : 空の フ ォ ーム を作成す る Unify NXJ 開発者ガ イ ド 48 4 方法 1 : 複数のデ フ ォル ト フ ォ ームを作成する こ の方法を使用す る と 、 デー タ ベースのテーブルに基づ く フ ォ ームのセ ッ ト を自 動的に生成する こ と がで き ます。 それぞれの フ ォ ームには、 タ ーゲ ッ ト テーブル の列に基づ く フ ィ ール ド コ ン ト ロ ール と ラ ベルが自動的に作成 さ れます。 デ フ ォ ル ト では、 フ ォ ームは以下のス テ ッ プ で作成 し ます。 1. フ ァ イル > デ フ ォ ル ト フ ォ ームの作成 を選択 し ます。 2. デー タ ベースのロ グ イ ン フ ォ ームが表示 さ れた ら 、 ユーザ名 と パスワー ド を 入力 し ます。 操作を続け る ためには、 デー タ ベースへのア ク セ ス権が必要です。 3. デー タ ベース コ ネ ク シ ョ ンパネルの接続 ド ロ ッ プ ダウ ン リ ス ト で、 デー タ ソ ース接続を選択 し ます。 リ ス ト にあ る コ ネ ク シ ョ ン名は、 カ レ ン ト のプ ロ ジ ェ ク ト で定義 さ れた も の です。 リ ス ト に必要 と す る コ ネ ク シ ョ ンがない場合は、 操作を続け る前に定 義す る必要があ り ます。 42 ページの 「追加デー タ ベース コ ネ ク シ ョ ンの設 定」 を参照 し て く だ さ い。 4. ほ と んどの フ ォ ーム を絶対位置に配置する場合は、 絶対位置に配置 チ ェ ッ ク ボ ッ ク ス を設定 し た ま まに し てお き ます。 絶対位置に配置 し ない場合は、 絶 対位置に配置 チ ェ ッ ク ボ ッ ク ス を ク リ ア し ます。 こ の設定は フ ォ ーム を作成 し た後で も 変更で き ます。 絶対位置についての詳 細は、 45 ページの 「絶対位置 と テーブルベースの位置」 を参照 し て く だ さ い。 5. 次へ ボ タ ン を ク リ ッ ク し ます。 6. フ ォ ームを生成 し たいすべてのテーブルに関 し て、 チ ェ ッ ク ボ ッ ク ス を設定 し ます。 7. 生成する フ ォ ームご と に、 シ ン グルオ カ レ ン ス (1 つのレ コ ー ド だけ を表示) と マルチオ カ レ ン ス (一連のレ コ ー ド を表示) のス タ イルを選択 し ます。 フ ォ ームのス タ イルについては、 47 ページの 「 フ ォ ームのス タ イルを選択 : シ ン グルオ カ レ ン ス と マルチオ カ レ ン ス」 を参照 し て く だ さ い。 8. 完了 ボ タ ン を ク リ ッ ク し ます。 デー タ ベースウ イザー ド は、 フ ォ ーム と コ ン ト ロ ールを生成 し 、 デ フ ォ ル ト の名前を割 り 当て ます。 Unify NXJ 開発者ガ イ ド 49 4 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで新 し い フ ォ ームの リ ス ト を確認 し ま す。 生成 さ れたそれぞれの フ ォ ームには、 フ ォ ームの タ ーゲ ッ ト テーブルの すべての列の フ ィ ール ド コ ン ト ロ ール と ラ ベルが表示 さ れます。 オ ブ ジ ェ ク ト のプ ロパテ ィ は、 デー タ ベースの内容に基づいて設定 さ れま す。 例えば、 各 フ ィ ール ド コ ン ト ロ ールの Data Type プ ロパテ ィ は、 タ ー ゲ ッ ト 列のデー タ タ イ プに設定 さ れます。 方法 2 : デ フ ォル ト フ ォ ームを 1 つ作成する こ の方法を使用す る と 、 生成 し た フ ォ ームに タ ーゲ ッ ト テーブルに基づ く フ ィ ー ル ド コ ン ト ロ ール と ラ ベルを自動的に割 り 当て る こ と がで き ます。 フ ィ ール ド コ ン ト ロールを作成する列 と 、 フ ォ ームで表示する順番を選択で き ます。 1. フ ァ イル > 新規 を選択 し ます。 2. 新規オ ブ ジ ェ ク ト パネルで フ ォ ームを選択 し 、 フ ォ ームの 名前を入力 し ます。 Form シ ン ボル 3. OK ボ タ ン を ク リ ッ ク し ます。 新 し い フ ォ ームがレ イ アウ ト パネルに表示 さ れます。 4. デー タ ベース ウ イザー ド シ ン ボルを ク リ ッ ク し ます。 デー タ ベースオ プ シ ョ ンパネルが表示 さ れます。 Database Wizard シ ン ボル 5. 接続、 テーブル、 フ ォ ームのス タ イルを選択 し ます。 既存の コ ネ ク シ ョ ン名、 ま たは “<inherit>” キーワー ド を選 択す る こ と がで き ます。 必要 と する コ ネ ク シ ョ ンが リ ス ト にない場合は、 操作を続け る前に定義する必要があ り ます。 42 ページの 「追 加デー タ ベース コ ネ ク シ ョ ンの設定」 を参照 し て く だ さ い。 “<inherit>” を選択 し た場合、 フ ォ ームに関連 し た コ ネ ク シ ョ ンは以下のよ う に決定 さ れます。 • NXJ デザ イ ン セ ン タ では、 フ ォ ームで使用 さ れる コ ネ ク シ ョ ンは、 カ レ ン ト のデ フ ォ ル ト コ ネ ク シ ョ ン と な り ます。 デ フ ォ ル ト コ ネ ク シ ョ ン に ついての詳細は、 42 ページの 「追加デー タ ベース コ ネ ク シ ョ ンの設定」 を参照 し て く だ さ い。 • 実行時に、 フ ォ ームで使用 さ れる コ ネ ク シ ョ ンは、 親 フ ォ ームに関連 し た コ ネ ク シ ョ ン です。 フ ォ ームがエ ン ト リ フ ォ ームで親 フ ォ ームがない 場合、 フ ォ ームで使用 さ れる コ ネ ク シ ョ ンは、 ア プ リ ケーシ ョ ンパ ッ ケージが作成 さ れた と き に使用 さ れたデ フ ォ ル ト コ ネ ク シ ョ ン です。 Unify NXJ 開発者ガ イ ド 50 4 フ ォ ームで使用 さ れる コ ネ ク シ ョ ン名は、 ア プ リ ケーシ ョ ンが配備 さ れ る と き に実際のデー タ ソ ースにマ ッ プ さ れます。 配備、 ア プ リ ケーシ ョ ン についての詳細は、 『Unify NXJ 管理者ガ イ ド 』 の 「ア プ リ ケーシ ョ ン の配備 と 管理」 を参照 し て く だ さ い。 フ ォ ームのス タ イルは、 単一のレ コ ー ド が表示 さ れる シ ン グルオ カ レ ン ス、 ま たは複数のレ コ ー ド が表示 さ れる マルチオ カ レ ン スのど ち ら かです。 フ ォ ームス タ イルの説明については、 47 ページの 「 フ ォ ームのス タ イルを選 択 : シ ン グルオ カ レ ン ス と マルチオ カ レ ン ス」 を参照 し て く だ さ い。 6. 次へ ボ タ ン を ク リ ッ ク し ます。 7. デ フ ォ ル ト フ ィ ール ド パネルの左向き矢印ボ タ ン と 右向き矢印ボ タ ン で、 含 む フ ィ ール ド と 除外 フ ィ ール ド を移動 し ます。 上向き矢印ボ タ ン と 下向 き矢 印ボ タ ン で、 フ ォ ームの フ ィ ール ド 順を指定 し ます。 8. 完了 ボ タ ン を ク リ ッ ク し ます。 デー タ ベースウ イザー ド は、 フ ォ ーム と コ ン ト ロ ールを生成 し 、 デ フ ォ ル ト の名前を割 り 当て ます。 テキス ト フ ィ ール ド コ ン ト ロ ール と ラ ベルは、 フ ォ ーム上に配置 さ れて レ イ アウ ト パネルで表示 さ れます。 レ イ アウ ト パネ ルの フ ォ ームに、 テキス ト フ ィ ール ド コ ン ト ロ ール と ラ ベルが表示 さ れま す。 コ ン ト ロ ールのために プ ロパテ ィ を再確認 し て、 必要であれば変更す る こ と がで き ます。 方法 3 : 手動で フ ォ ームを作成する こ の方法を使用す る と 、 空の フ ォ ームに フ ィ ール ド コ ン ト ロ ール と ラ ベルを個別 に追加する こ と がで き ます。 タ ーゲ ッ ト テーブルがあ る空の フ ォ ームは、 以下の ス テ ッ プ で作成 し ます。 1. フ ァ イル > 新規 を選択 し ます。 2. 新規オ ブ ジ ェ ク ト パネルで フ ォ ームを選択 し 、 フ ォ ームの名 前を入力 し ます。 Form シ ン ボル 3. OK ボ タ ン を ク リ ッ ク し ます。 新 し い フ ォ ームがレ イ アウ ト パネルに表示 さ れます。 4. ブ ラ ウザパネルのプ ロパテ ィ タ ブ を選択 し ます。 5. Connection プ ロパテ ィ の値の フ ィ ール ド で、 フ ォ ームで使用す る コ ネ ク シ ョ ン名を選択 し ます。 Unify NXJ 開発者ガ イ ド 51 4 コ ネ ク シ ョ ン名 と フ ォ ームス タ イルを選択 し ます。 50 ページの 「方法 2 : デ フ ォ ル ト フ ォ ームを 1 つ作成す る」 のス テ ッ プ 5 の説明を参照 し て く だ さ い。 6. Target Table プ ロパテ ィ の値 フ ィ ール ド で、 フ ォ ームの タ ーゲ ッ ト テーブルを 示すテーブルを選択 し ます。 7. 88 ページの 「 コ ン ト ロ ールの使い方」 に記述す る よ う に、 フ ォ ームに フ ィ ー ル ド コ ン ト ロ ール と 他の コ ン ト ロ ールを追加 し ます。 フ ォ ームに追加す る テキス ト フ ィ ール ド を設定す る ための 1 つの重要な プ ロ パテ ィ は、 Target Field プ ロパテ ィ です。 こ のプ ロパテ ィ は、 タ ーゲ ッ ト テー ブル固有の列に フ ィ ール ド コ ン ト ロ ールを マ ッ プ し ます。 複数デー タ ビ ュ ー フ ォ ームの作成 複数デー タ ビ ュ ーがあ る フ ォ ームには、 別の タ ーゲ ッ ト テーブルを マ ッ プす る領 域があ り ます。 フ ォ ームには、 い く つで も デー タ ビ ュ ー を含める こ と がで き ます。 フ ォ ーム自身が最初のデー タ ビ ュ ー と し て動作 し ます。 フ ォ ームで複数のデー タ ビ ュ ー を使用するのには、 以下のよ う な理由があ り ます。 • マ ス タ / 詳細の関係が表示で き る • タ ブ ご と に別のデー タ ビ ュ ー を表示す る tab control が使用で き る マス タ / 詳細の関係 マ ス タ / 詳細関係に よ り 、 2 つのデー タ ビ ュ ー間のプ ラ イ マ リ キー / 外部キーの関 係が適用 さ れます。 マ ス タ デー タ ビ ュ ーの タ ーゲ ッ ト テーブルにあ る 1 つ、 ま た は複数の列がプ ラ イ マ リ キー を構成 し ています。 詳細デー タ ビ ュ ーの タ ーゲ ッ ト テーブルには、 同 じ 数のデー タ タ イ プに適応 し た列があ り 、 外部キー と し て構成 さ れています。 プ ラ イ マ リ キー列が必ず し も フ ォ ームの フ ィ ール ド コ ン ト ロ ール と い う わけではあ り ません。 プ ラ イ マ リ キー列は、 詳細デー タ ビ ュ ーの選択セ ッ ト の作成に使用 さ れています。 Unify NXJ 開発者ガ イ ド 52 4 次のス ク リ ーン シ ョ ッ ト は、 マ ス タ フ ォ ーム、 プ ラ イ マ リ キー、 外部キーがどの よ う に関連 し てい るかを示す例です。 REPORT_ID フ ィ ー ル ド コ ン ト ロールが マ ス タ (プ ラ イ マ リ ) キーにマ ッ プ さ れてい る。 フ ォ ームはマ ス タ ビ ュ ーであ る。 デー タ ビ ュ ーには REPORT_ID が 10101 であ る全項目の選択 セ ッ ト が表示 さ れて お り 、 詳細 (外部) キーがマ ッ ピ ン グ さ れてい る。 フ ォ ームで こ のよ う な関連付け を設定する前に、 以下の点を確認 し ます。 • マ ス タ ビ ュ ー : マ ス タ 機能を持つ フ ォ ームやデー タ ビ ュ ーです。 • マ ス タ キー : マ ス タ キー を構成する マ ス タ ビ ュ ーの タ ーゲ ッ ト テーブルにあ る列です。 • 詳細キー : 詳細キー を構成す る詳細デー タ ビ ュ ーの タ ーゲ ッ ト テーブルにあ る列です。 マ ス タ / 詳細の関係は、 以下のス テ ッ プ で作成 し ます。 1. 48 ページの 「単一デー タ ビ ュ ー フ ォ ームの作成」 で説明 し た方法のいずれか を使 っ て、 マ ス タ 機能を持つ フ ォ ーム を作成 し ます。 Unify NXJ 開発者ガ イ ド 53 4 2. フ ォ ームに新 し いデー タ ビ ュ ー を配置 し ます。 まず、 コ ン ト ロ ールパレ ッ ト でデー タ ビ ュ ーシ ン ボルを ク リ ッ ク し 、 次に レ イ アウ ト パネルに配置 し ます。 Data View シ ン ボル こ れに よ り 、 詳細デー タ ビ ュ ーの機能を持つ よ う にな り ます。 デザ イ ン セ ン タ では、 タ ブ、 テーブル、 グループボ ッ ク ス コ ン ト ロ ール以外 の コ ン ト ロ ールの ト ッ プには、 新 し いデー タ ビ ュ ー を配置で き ません。 デー タ ベースウ イザー ド が表示 さ れます。 3. 最初のパネルで、 新 し いデー タ ビ ュ ーに以下の内容を指定 し ます。 使用する コ ネ ク シ ョ ン と テーブル、 ス タ イル と レ イ アウ ト のオ プ シ ョ ン。 コ ネ ク シ ョ ンの指定に関する詳細は、 49 ページの 「方法 1 : 複数のデ フ ォ ル ト フ ォ ームを作成する」 のス テ ッ プ 3 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 54 4 4. 次のパネルでは、 マ ス タ / 詳細ビ ュ ー、 マ ス タ キー、 詳細キーのオ プ シ ョ ン を指定 し ます。 マ ス タ / 詳細が必要なければ、 こ のパネルを スキ ッ プする ために 次へ ボ タ ン を ク リ ッ ク し ます。 複数の列名の場合は、 セ ミ コ ロ ン で区切 り ます。 5. 含む / 除外の列で、 デー タ ビ ュ ーの フ ィ ール ド を指定 し ます。 6. 完了 ボ タ ン を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 55 4 Tab Controls tab control は、 タ ブ付 きの索引 カ ー ド のセ ッ ト に似た外見を し ています。 ユーザが タ ブ を ク リ ッ ク す る と 、 その タ ブの tab insert が最前列に表示 さ れます。 ユーザが タ ブ を ク リ ッ ク す る と 最前列にな る。 それぞれの tab insert に は独自のデー タ ビ ュ ー があ る。 tab control を使 う と 、 異な っ た タ ーゲ ッ ト テーブルか ら の関連する デー タ グループ を効果的に表示で き ます。 例えば、 ア カ ウ ン ト の各 カ テ ゴ リ に タ ブ付きのズーム フ ォ ームを作成 し 、 各 タ ブ リ ス ト にユーザの選択内容を表示 し て、 呼び出 し 元 フ ォ ームに返す こ と がで き ます。 デー タ ビ ュ ー を す く む tab control を作成する ス テ ッ プは、 以下の と お り です。 1. 48 ページの 「単一デー タ ビ ュ ー フ ォ ームの作成」 で説明 し た方法のいずれ かを使 っ て、 tab control を持つ フ ォ ームを作成 し ます。 2. レ イ アウ ト パネルで フ ォ ームを開き ます。 3. フ ォ ームに tab control を配置 し ます。 a. コ ン ト ロ ールパレ ッ ト で tab control のシ ン ボルを ク リ ッ ク し ます。 b. フ ォ ーム上で、 tab control を配置する場所を ク リ ッ ク し ます。 Tab Control シ ンボル NXJ デザ イ ン セ ン タ では、 他の コ ン ト ロ ールの ト ッ プに 新 し い tab control を配置す る こ と はで き ませんが、 既存の tab insert のオ ブ ジ ェ ク ト に、 コ ン ト ロ ールを配置す る こ と はで き ます。 フ ォ ームに配置す る と き に、 tab control を ク リ ッ ク し て ド ラ ッ グす る と サ イ ズ を変更で き ます。 ま たは、 配置後にサ イ ズ を変更する こ と がで き ます。 Unify NXJ 開発者ガ イ ド 56 4 4. tab control に tab insert を配置 し ます。 tab insert は、 コ ン ト ロ ールパレ ッ ト の tab insert シ ン ボルを ク リ ッ ク し 、 レ イ アウ ト パネルの tab control を ク リ ッ ク し て配置 し ま す。 複数の tab insert を配置す る場合は、 tab insert シ ン ボルを ダ ブル ク リ ッ ク し ます。 Tab Insert シ ン ボル 必要に応 じ て tab insert を追加 し ます。 5. tab insert に新 し いデー タ ビ ュ ー を配置 し ます。 新 し いデー タ ビ ュ ーは、 コ ン ト ロ ールパレ ッ ト のデー タ ビ ュ ーシ ン ボルを ク リ ッ ク し 、 次に レ イ アウ ト パ ネルの tab insert を ク リ ッ ク し て配置 し ます。 フ ォ ームの場合 と 同 じ よ う に タ ブ に コ ン ト ロ ールを追加 し ます。 6. tab insert ご と にス テ ッ プ 4 と 5 を繰 り 返 し ます。 tab control についての詳細は、 140 ページの 「Tab Controls」 を参照 し て く だ さ い。 その他のデー タ ビ ュ ーを作成 デー タ ビ ュ ーは、 フ ォ ーム と 異な る タ ーゲ ッ ト テーブルに関連付け ら れてい る フ ォ ームの領域です。 フ ォ ームに タ ーゲ ッ ト テーブルがあれば、 フ ォ ームに自動 的に最初のデー タ ビ ュ ーが表示 さ れます。 デー タ ビ ュ ーの フ ィ ール ド コ ン ト ロ ー ルには、 デー タ ビ ュ ーの タ ーゲ ッ ト テーブルが使用 さ れます。 フ ォ ームに複数のデー タ ビ ュ ーがあ る場合、 デー タ ビ ュ ー間にマ ス タ / 詳細の関係 を設定で き ます。 詳細は、 52 ページの 「マ ス タ / 詳細の関係」 を参照 し て く だ さ い。 マ ス タ / 詳細の関係を設定 し ない場合は、 以下のス テ ッ プ でデー タ ビ ュ ー を作 成 し ます。 1. レ イ アウ ト パネルで フ ォ ームを開き ます。 Data View シ ン ボル 2. フ ォ ームにデー タ ビ ュ ー を配置 し ます。 a. コ ン ト ロ ールパレ ッ ト でデー タ ビ ュ ーシ ン ボルを ク リ ッ ク し ます。 b. レ イ アウ ト パネルの フ ォ ームで、 デー タ ビ ュ ー を配置す る場所を ク リ ッ ク し ます。 デー タ ベースウ イザー ド が表示 さ れます。 Unify NXJ 開発者ガ イ ド 57 4 3. ウ ィ ザー ド の指定パネルで, 以下のよ う な操作を行います。 全般パネル : コ ネ ク シ ョ ン名 と タ ーゲ ッ ト テーブル名を選択 し ます。 コ ネ ク シ ョ ン名の指定に関する詳細は、 50 ページの 「方法 2 : デ フ ォ ル ト フ ォ ーム を 1 つ作成す る」 のス テ ッ プ 5 を参照 し て く だ さ い。 マ ス タ / 詳細パネル : デー タ ビ ュ ーのマ ス タ / 詳細 プ ロパテ ィ を選択 し ます。 デ フ ォ ル ト フ ィ ール ド パネル : デー タ ビ ュ ーで作成する デ フ ォ ル ト の フ ィ ー ル ド コ ン ト ロ ールを指定 し ます。 パネルに必要な こ と を すべて設定 し 、 その他のプ ロパテ ィ はブ ラ ウザパネル のプ ロパテ ィ ビ ュ ーで設定 し ます。 デー タ ビ ュ ーでは、 フ ォ ームがサポー ト す る Visual プ ロパテ ィ 、 Access Control プ ロパテ ィ 、 Database プ ロパテ ィ がサポー ト さ れます。 デー タ ビ ュ ー には、 1 つの追加プ ロパテ ィ と し て、 デー タ ビ ュ ーの名称であ る Name プ ロ パテ ィ があ り ます。 Unify NXJ 開発者ガ イ ド 58 4 レ イ アウ ト パネルを使っ た フ ォ ームのレ イ アウ ト レ イ アウ ト パネルを使用 し て、 オープ ン さ れてい る フ ォ ーム を設計 し ます。 フ ォ ームがオープ ン さ れていない場合は、 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ー で フ ォ ーム名を ク リ ッ ク し て フ ォ ーム を開き ます。 フ ォ ームは、 コ ン テ ン ト パネルのレ イ アウ ト パネルに表示 さ れます (レ イ アウ ト パネルは、 Web レ イ アウ ト タ ブ を ク リ ッ ク する と 前面に表示 さ れます)。 レ イ アウ ト パネルには、 フ ォ ームの WYSISYG 画面があ り 、 Unify NXJ ツ ール バー、 ヘ ッ ダ、 フ ッ タ フ レ ームセ ッ ト は表示 さ れていませんが、 実行時には フ ォ ームの上下に フ レ ームで表示 さ れます。 1. パレ ッ ト か ら コ ン ト ロールの タ イ プ を 選択 2. 指定する場所を ク リ ッ ク する レ イ アウ ト パネルを使用 し て、 フ ォ ーム上の コ ン ト ロ ール配置を簡単に開発す る こ と がで き ます。 多 く の場合、 フ ォ ーム レ イ アウ ト を作成する順番は重要ではあ り ません。 以下に、 一般的な タ ス ク と 実行方法を示 し ます。 • フ ォ ームに新 し い コ ン ト ロ ールを追加する には、 パレ ッ ト で コ ン ト ロ ール タ イ プ を選択 し て レ イ アウ ト パネルで配置す る場所を ク リ ッ ク す るか、 配置す る場所を ク リ ッ ク し て ド ラ ッ グ し ます。 Unify NXJ 開発者ガ イ ド 59 4 同 じ タ イ プのオ ブ ジ ェ ク ト を複数配置する場合は、 コ ン ト ロールパレ ッ ト の項目を ダ ブル ク リ ッ ク し ます。 パレ ッ ト の コ ン ト ロ ール タ イ プ を も う 一度 ク リ ッ ク す る と 選択が解 除 さ れます。 ま たはポ イ ン タ ツ ールを ク リ ッ ク し て も 選択 が解除 さ れます。 Pointer Tool フ ォ ームのバ ッ ク グ ラ ウ ン ド に コ ン ト ロ ールを配置する場合は、 絶対位置が 使用 さ れます。 JSP では、 コ ン テ ナ コ ン ト ロ ールが フ ォ ーム、 タ ブ、 ボ ッ ク ス、 繰 り 返 し 領域、 デー タ ビ ュ ーのどれであ っ て も 、 左上か ら の絶対サ イ ズ と 位置が指定 さ れます。 テーブルベースの位置にす る には、 まずテーブルを 作成 し 、 次に テーブルのセルに コ ン ト ロ ールを配置 し ます。 • フ ィ ール ド コ ン ト ロ ールを別の フ ィ ール ド コ ン ト ロ ールに変換す る には、 レ イ アウ ト > 変更 コ マ ン ド を使用 し ます。 フ ィ ール ド コ ン ト ロ ールには、 テ キス ト フ ィ ール ド 、 テキス ト 領域、 ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス、 リ ス ト ボ ッ ク ス、 チ ェ ッ ク ボ ッ ク ス、 ラ ジ オグループの 6 種類があ り 、 どの フ ィ ー ル ド コ ン ト ロ ール も 別の フ ィ ール ド コ ン ト ロ ールに変更す る こ と がで き ま す。 • フ ォ ームレ イ アウ ト の コ ン ト ロ ールを選択す る には、 カ ー ソ ルを コ ン ト ロ ー ルに置いた ま ま、 左マウスボ タ ン を ク リ ッ ク し ます。 オ ブ ジ ェ ク ト を連続 し て選択する には、 Ctrl キー を押 し なが ら 次のオ ブ ジ ェ ク ト を ク リ ッ ク し ます。 フ ォ ームを選択す る には、 フ ォ ームのバ ッ ク グ ラ ウ ン ド を ク リ ッ ク し ます。 • 隣接する オ ブ ジ ェ ク ト を ま と めて選択する には、 オ ブ ジ ェ ク ト がすべて選択 さ れる ま で ク リ ッ ク ア ン ド ド ラ ッ グ し ます。 • オ ブ ジ ェ ク ト のサ イ ズ を変更す る には、 対象 と な る オ ブ ジ ェ ク ト を選択 し て grabbers のどれかを ド ラ ッ グ し ま す。 grabbers は、 サ イ ズが変更で き る オ ブ ジ ェ ク ト の境 界線上にだけ表示 さ れます。 チ ェ ッ ク ボ ッ ク スのよ う に、 サ イ ズが変更で き ない コ ン ト ロ ール も あ り ます。 Grabbers • フ ォ ームのサ イ ズ を変更する には、 対象 と な る フ ォ ーム を選択 し て grabbers を ド ラ ッ グ し ます。 ま たは、 フ ォ ーム > プ ロパテ ィ パネ ル を選択 し 、 Width と Height のプ ロパテ ィ を変更 し て、 フ ォ ームのサ イ ズ を 変更する こ と も で き ます。 • コ ン ト ロ ールを コ ピ ー、 切 り 取 り 、 完全に削除す る には、 ツ ールバーの コ マ ン ド を使 う か、 キーボー ド の Ctrl-C コ マ ン ド 、 Ctrl-X コ マ ン ド 、 ま たは Del キー を使います。 Unify NXJ 開発者ガ イ ド 60 4 • コ ン ト ロ ールを移動する には、 対象 と な る コ ン ト ロ ールを選択 し て ド ラ ッ グ するか矢印キーで移動 し ます。 複数のオ ブ ジ ェ ク ト を選択 し てい る場合は、 ド ラ ッ グす る と 選択 し たオ ブ ジ ェ ク ト がすべて移動 し ます。 ド ラ ッ グ中は、 カ ー ソ ルの形状が ド ラ ッ グ時の形状に変わ り ます。 • フ ォ ームを コ ピ ーする には、 ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで フ ォ ー ム名を右 ク リ ッ ク し て コ ピ ー を選択 し ます。 ブ ラ ウザパネルの ク ラ ス フ ォ ル ダ を ク リ ッ ク し て マウス を右 ク リ ッ ク し 、 貼 り 付け を選択 し ます。 • オ ブ ジ ェ ク ト を コ ピ ーす る には、 対象 と な る オ ブ ジ ェ ク ト を選択 し 、 編集 > コ ピ ー を選択 し ます。 オ ブ ジ ェ ク ト を配置す る場所を ク リ ッ ク し ます。 マウ ス を右 ク リ ッ ク し て、 貼 り 付け を選択 し ます。 Unify NXJ 開発者ガ イ ド 61 4 フ ォ ームのプ レ ビ ュ ーを表示 レ イ アウ ト > プ レ ビ ュ ー コ マ ン ド を選択 し 、 実行時、 JSP 版では フ ォ ームがどの よ う に表示 さ れるかを確認 し ます。 JSP 版で表示 さ れる フ ォ ームは、 レ イ アウ ト パネル版での表示 と は少 し 異な り ます。 こ れは フ ォ ン ト やオ ブ ジ ェ ク ト の描画方 法が異な る ためです。 描画方法は Web ブ ラ ウザの種類に よ っ て も 異な り ます。 こ のため、 Web ブ ラ ウザで表示する フ ォ ーム も ブ ラ ウザに よ っ て少 し ずつ異な り ま す。 レ イ アウ ト パネル の フ ォ ーム フ ォ ームのプ レ ビ ュ ー Unify NXJ 開発者ガ イ ド 62 4 プ レ ビ ュ ー コ マ ン ド は、 ホ ス ト のデ フ ォ ル ト Web ブ ラ ウザを使用 し ます。 プ レ ビ ュ ーでは、 NXJ ヘ ッ ダ、 フ ッ タ 、 ツ ールバー を含んでいません。 プ レ ビ ュ ー コ マ ン ド は、 プ ロ ジ ェ ク ト の表示状態を確認す る ための コ マ ン ド です。 フ ォ ームを テ ス ト する には、 実行 コ マ ン ド を使用 し ます。 165 ページの 「実行 と パ ッ ケージ ン グ」 を参照 し て く だ さ い。 Form プ ロパテ ィ の設定 レ イ アウ ト パネルでの作業中に、 ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ー を使 っ て、 フ ォ ームを表示 し た り プ ロパテ ィ の設定を変更す る こ と がで き ます。 レ イ アウ ト パネルの フ ォ ームで背景を ク リ ッ ク し て、 プ ロパテ ィ ビ ュ ーで フ ォ ー ムのプ ロパテ ィ を確認で き ます。 プ ロパテ ィ 名の右にあ る セルの値を ク リ ッ ク し て値を変更で き ます。 例えば、 フ ォ ームの高 さ を変更す る には、 Height プ ロパ テ ィ に ピ ク セル数を入力 し ます。 プ ロパテ ィ を デ フ ォ ル ト 値に戻すには、 右 ク リ ッ ク し てデ フ ォ ル ト 値に設定を選 択 し ます。 すべてのプ ロパテ ィ にデ フ ォ ル ト 値があ る と い う わけではあ り ません。 Form プ ロパテ ィ の説明に関 し ては、 64 ページの 「 フ ォ ームの組み込み動作を カ ス タ マ イ ズ」 を参照 し て く だ さ い。 グ リ ッ ド に吸着 フ ォ ームで絶対位置が使用 さ れていれば、 レ イ アウ ト パネルのオ プ シ ョ ン を使 っ て フ ォ ーム コ ン ト ロ ールの配置を グ リ ッ ド 線に揃え る こ と がで き ます。 グ リ ッ ド に吸着オ プ シ ョ ン と グ リ ッ ド のサ イ ズは、 デザ イ ン セ ン タ オ プ シ ョ ン ダ イ ア ロ グ で指定 し ます。 こ のダ イ ア ロ グにア ク セ スす る には、 編集 > オ プ シ ョ ン > レ イ ア ウ ト を選択 し ます。 グ リ ッ ド に吸着オ プ シ ョ ンは、 テーブル内は使用不可にな っ ています。 テーブルの外では、 オ ブ ジ ェ ク ト を グ リ ッ ド に吸着で き ます。 グ リ ッ ド に吸着が有効な場合、 コ ン ト ロ ールを移動 し た り サ イ ズ を変更する と 、 位置が近 く のグ リ ッ ド 線に合わせて移動 し ます。 Unify NXJ 開発者ガ イ ド 63 4 コ ン ト ロールの整列 レ イ アウ ト > 整列 コ マ ン ド で、 複数の コ ン ト ロ ールを整列 さ せる こ と がで き ま す。 コ マ ン ド には以下の も のがあ り ます。 • 左 • 右 • 上 • 下 間隔を調整する には、 以下のレ イ アウ ト コ マ ン ド を使用 し ます。 • 水平方向の間隔 • 垂直方向の間隔 JSP ソ ースの編集 JSP 版で表示 し た フ ォ ームを編集す る には、 フ ォ ームを選択 し 、 コ ン テ ン ト パネル の JSP ソ ース タ ブ を ク リ ッ ク し ます。 JSP ソ ース コ ー ド が、 レ イ アウ ト パネルに表 示 さ れます。 JSP ソ ース を変更する と Web レ イ アウ ト が自動的に変更 さ れ、 Web レ イ アウ ト を 変更する と JSP ソ ースが自動的に変更 さ れます。 注 – JSP 版を変更する場合は、 JSP に よ る開発の知識が必要です。 ま た、 JSP コ ー ド が有効であ るかど う かを十分に確認する必要があ り ます。 フ ォ ームの組み込み動作を カ ス タ マ イ ズ フ ォ ームには、 動作が組み込まれています。 こ の動作は、 以下の カ ス タ マ イ ズ を 使 っ て変更で き ます。 • デー タ ベース操作を許可 し ない • 初期 フ ォ ームモー ド を あ ら か じ め設定する • dynamic query の提供 Unify NXJ 開発者ガ イ ド 64 4 • 自動検索の設定 • ト ラ ンザ ク シ ョ ンの自動 コ ミ ッ ト 設定 • レ コ ー ド 追加後に フ ォ ーム を ク リ ア • 検索レ コ ー ド 数の指定 • フ ィ ール ド での ク リ ッ ク 許可 フ ォ ームプ ロパテ ィ の動作を カ ス タ マ イ ズす る方法については、 後のセ ク シ ョ ン で説明 し ます。 デー タ ベース操作を許可 し ない フ ォ ームのユーザに、 特定のデー タ ベース操作を実行す る こ と を許可 し ない よ う に指定する こ と がで き ます。 デ フ ォ ル ト では、 フ ォ ームのユーザはすべてのデー タ ベース操作を実行で き ます。 フ ォ ームのデー タ ベース操作を コ ン ト ロ ールす る ために、 以下のプ ロパテ ィ を使用 し ます。 • Add Allowed フ ォ ームま たはデー タ ビ ュ ーか ら 実行 さ れる ADD 操作を許可 し ないために、 こ のチ ェ ッ ク ボ ッ ク ス を ク リ ア し ます。 こ のプ ロパテ ィ は、 NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの jBiz addAllowed プ ロパテ ィ を使 っ て jBiz ス ク リ プ ト で設定で き ます。 • Delete Allowed フ ォ ームま たはデー タ ビ ュ ーか ら実行 さ れる DELETE 操作を許可 し ないため に、 こ のチ ェ ッ ク ボ ッ ク ス を ク リ アに し ます。 • こ のプ ロパテ ィ は、 NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの jBiz deleteAllowed プ ロパテ ィ を使 っ て jBiz ス ク リ プ ト で設定で き ま す。 • Find Allowed フ ォ ームま たはデー タ ビ ュ ーか ら実行 さ れる FIND 操作を許可 し ないために、 こ のチ ェ ッ ク ボ ッ ク ス を ク リ アに し ます。 Unify NXJ 開発者ガ イ ド 65 4 こ のプ ロパテ ィ は、 NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの jBiz findAllowed プ ロパテ ィ を使 っ て jBiz ス ク リ プ ト で設定で き ます。 • Update Allowed フ ォ ームま たはデー タ ビ ュ ーか ら実行 さ れる UPDATE 操作を許可 し ないため に、 こ のチ ェ ッ ク ボ ッ ク ス を ク リ アに し ます。 こ のプ ロパテ ィ は、 NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの jBiz updateAllowed プ ロパテ ィ を使 っ て jBiz ス ク リ プ ト で設定で き ま す。 初期デー タ ビ ュ ー モー ド を あ ら か じ め設定する デー タ ビ ュ ーモー ド には 2 つのモー ド があ り 、 ど ち ら か 1 つだけが設定 さ れます。 • find モー ド 。 ユーザは タ ーゲ ッ ト テーブルに問い合わせる こ と がで き ます。 • add/update/delete モー ド 。 ユーザは タ ーゲ ッ ト テーブルのレ コ ー ド を追加 / 更 新 / 削除で き ます。 ユーザは、 いつで も デー タ ビ ュ ーモー ド を変更で き ます。 デ フ ォ ル ト では、 タ ー ゲ ッ ト テーブルがあ る デー タ ビ ュ ーに関 し ては、 初期のデー タ ビ ュ ーモー ド は find モー ド です。 タ ーゲ ッ ト テーブルがないデー タ ビ ュ ーのデ フ ォ ル ト は、 add/update/delete モー ド です。 デー タ ビ ュ ーに タ ーゲ ッ ト テーブルがあ り 、 ユーザが検索よ り も 追加 / 更新 / 削除 を行 う 方が多い場合は、 初期のデー タ ビ ュ ーモー ド を add/update/delete モー ド に指 定す る こ と がで き ます。 その場合は、 Add Mode プ ロパテ ィ で、 開始のチ ェ ッ ク ボ ッ ク ス を設定 し ます。 フ ォ ームモー ド を あ ら か じ め設定 し てお く と 、 デー タ ビ ュ ー を その設定が反映 さ れた状態で使用す る こ と が可能 と な るので、 デー タ ビ ュ ーモー ド を個別に設定する手間が省けます。 Unify NXJ 開発者ガ イ ド 66 4 ク エ リ の条件を設定 ユーザが FIND を発行する と 、 Unify NXJ ア プ リ ケーシ ョ ン に よ り SQL ク エ リ が作 成 さ れます。 こ の ク エ リ は、 実行時に入力 さ れた検索条件に基づいた も のであ る か、 デザ イ ン セ ン タ の SQL Optional Condition プ ロパテ ィ 、 SQL Order By プ ロパ テ ィ で指定 さ れた も のです。 SQL SELECT 文は、 使用す る RDBMS の必要条件に基づいて、 NXJ イ ン タ ラ ク シ ョ ンサーバで準備 さ れ、 実行時に構築 さ れます。 Unify NXJ イ ン タ ラ ク シ ョ ンサーバは検索条件を使 っ て、 以下の構文に似た SQL SELECT 文を作成 し ます。 SELECT columns FROM table WHERE sql_optional_condition ORDER BY sql_order_by_clause ; 表 4-1 SQL ク エ リ のブ ロ ッ ク を作成 ( 1 / 3 ) ク エ リ 変数 説明 columns フ ォ ームの フ ィ ール ド コ ン ト ロールにマ ッ プ さ れた タ ーゲ ッ ト 列。 タ ーゲ ッ ト 列についての詳細は、 120 ページの 「Target Field」 を参照 し て く だ さ い。 table Target Table プ ロパテ ィ で指定 さ れた値。 Unify NXJ 開発者ガ イ ド 67 4 表 4-1 SQL ク エ リ のブ ロ ッ ク を作成 ( 2 / 3 ) ク エ リ 変数 sql_optional_condition 説明 Sql Optional Condition プ ロパテ ィ で指定 し た値。 Unify NXJ デ ザ イ ン セ ン タ には、 オプ シ ョ ンの条件を作成する ダ イ ア ロ グ が用意 さ れています。 Sql Optional Condition プ ロパテ ィ の ... ボ タ ン を ク リ ッ ク する と ダ イ ア ロ グが開き ます。 ダ イ ア ロ グ上部のテキス ト 領域で、 where 句を作成 し ます。 テキス ト 領域下部のボ タ ン で テキス ト ビ ュ ーに 2 項演算子や 単項演算子を挿入 し ます。 貼 り 付け ボ タ ン を ク リ ッ ク する と ク リ ッ プボー ド の内容が貼 り 付け ら れます。 ダ イ ア ロ グ下部のス ク ロール リ ス ト には、 タ ーゲ ッ ト テーブ ルの列がすべて表示 さ れています。 リ ス ト の項目を ダ ブル ク リ ッ ク する と 、 テキス ト フ ィ ール ド の現在のキ ャ レ ッ ト (^) の場所に列の名前が追加 さ れます。 Unify NXJ 開発者ガ イ ド 68 4 表 4-1 SQL ク エ リ のブ ロ ッ ク を作成 ( 3 / 3 ) ク エ リ 変数 sql_order_by_clause 説明 Sql Order By Clause プ ロパテ ィ で指定 し た値。 Unify NXJ デザ イ ン セ ン タ には、 句の順序を並べ替え る ダ イ ア ロ グが用意 さ れています。 Sql Order By Clause プ ロパテ ィ の ... ボ タ ン を ク リ ッ ク する と ダ イ ア ロ グが開き ます。 ダ イ ア ロ グ右側の リ ス ト には、 タ ーゲ ッ ト テーブルの列がす べて表示 さ れています。 ク エ リ の句の順序は、 以下の方法で 指定 し ます。 1. 列を選択する 2. 左右の矢印を ク リ ッ ク し て列を移動する 3. 上下の矢印を ク リ ッ ク し て、 列の位置を並べ替え る 複数の列を選択する場合は、 Shift キー を押 し なが ら ク リ ッ ク するか、 Ctrl キーを押 し なが ら ク リ ッ ク し ます。 自動検索の設定 タ ーゲ ッ ト テーブルがあ る フ ォ ームでは、 実行時に フ ォ ームが表示 さ れる と き、 ユーザが query-by-form コ マ ン ド を発行 し な く て も 、 検索操作を自動的に実行する よ う に設定で き ます。 自動検索を指定す る には、 Auto Find チ ェ ッ ク ボ ッ ク ス を設定 し ます。 ク エ リ は、 Sql Optional Condition プ ロパテ ィ 、 Sql Order By プ ロパテ ィ に よ っ て指定 さ れま す。 Unify NXJ 開発者ガ イ ド 69 4 ト ラ ンザク シ ョ ンの自動コ ミ ッ ト 設定 タ ーゲ ッ ト テーブルがあ る フ ォ ームで、 Auto Commit チ ェ ッ ク ボ ッ ク ス を設定す る と 、 NXJ イ ン タ ラ ク シ ョ ンサーバに よ り 、 イ ン タ ラ ク テ ィ ブ なデー タ ベース操 作 (追加、 更新、 削除) を正 し く 実行 し た後、 ト ラ ンザ ク シ ョ ンの コ ミ ッ ト を実 行す る よ う に指定で き ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは ク リ アに な っ ていて、 イ ン タ ラ ク テ ィ ブ なデー タ ベース操作は自動 コ ミ ッ ト さ れません。 コ ミ ッ ト についての詳細は、 77 ページの 「 ト ラ ンザ ク シ ョ ン モー ド 」 を参照 し て く だ さ い。 Auto Commit プ ロパテ ィ は、 プ ロパテ ィ の Form グループにあ り ます。 レ コ ー ド 追加後に フ ォ ームを ク リ ア ユーザがレ コ ー ド を次々 と 追加する場合には、 テーブルに新規レ コ ー ド が追加 さ れた後、 タ ーゲ ッ ト テーブルがあ る フ ォ ームの フ ィ ール ド コ ン ト ロ ールを ク リ ア にす る こ と がで き ます。 こ の動作を指定す る には、 Clear After Add プ ロパテ ィ の チ ェ ッ ク ボ ッ ク ス を設定 し ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは ク リ アにな っ ています。 チ ェ ッ ク ボ ッ ク ス を設定 し ていない場合、 ユーザが CLEAR TO ADD コ マ ン ド を実 行す る “New” コ マ ン ド を使 っ て フ ォ ーム を ク リ ア で き ます。 こ のプ ロパテ ィ を設 定す る と 、 コ マ ン ド は自動的に実行 さ れます。 Clear After Add プ ロパテ ィ は、 プ ロパテ ィ の Database グループにあ り ます。 エ ン ト リ ポ イ ン ト フ ォ ームの指定 ア プ リ ケーシ ョ ン には、 エ ン ト リ ポ イ ン ト フ ォ ームが少な く と も 1 つ必要です。 エ ン ト リ ポ イ ン ト フ ォ ームは、 ア プ リ ケーシ ョ ン でユーザに最初に表示 さ れる フ ォ ームです。 オ ブ ジ ェ ク ト がエ ン ト リ ポ イ ン ト に指定 さ れた場合は、 以下のよ う に動作 し ます。 • URL が指定 さ れたオ ブ ジ ェ ク ト の場合は、 ブ ラ ウザで表示 さ れます。 • NXJ コ ン ト ロ ールセ ン タ の メ ニ ュ ーに表示 さ れます。 エ ン ト リ ポ イ ン ト を定義する場合は、 以下の項目を指定 し ます。 Unify NXJ 開発者ガ イ ド 70 4 • ア ク セ ス コ ン ト ロ ール • メ ニ ュ ー項目 ラ ベル • 初期 メ ニ ュ ー フ ォ ームを エ ン ト リ ポ イ ン ト フ ォ ームに設定 し て、 メ ニ ュ ー定義を指定する には、 以下のス テ ッ プ に従います。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで フ ォ ーム名を右 ク リ ッ ク し 、 ポ ッ プ ア ッ プ メ ニ ュ ー を表示 し ます。 2. エ ン ト リ ポ イ ン ト の追加を ク リ ッ ク し ます。 エ ン ト リ ポ イ ン ト ダ イ ア ロ グが表示 さ れます。 3. プ ロパテ ィ パネルで、 以下の内容を入力 し ます。 a. 説明 フ ィ ール ド : エ ン ト リ ポ イ ン ト の説明。 必要に応 じ て を入力 し ます。 コ ン ト ロ ールセ ン タ 管理者は こ の説明を参考に し て、 メ ニ ュ ー項目に こ のエ ン ト リ ポ イ ン ト があ る メ ニ ュ ー を管理 し ます。 b. デ フ ォ ル ト ラ ベル フ ィ ール ド : ク ラ イ ア ン ト のブ ラ ウザのロ ケールに一 致す る ロ ケール対応 ラ ベルがない場合に、 コ ン ト ロ ールセ ン タ が使用す る デ フ ォ ル ト の メ ニ ュ ー ラ ベルです。 Unify NXJ 開発者ガ イ ド 71 4 ア プ リ ケーシ ョ ンが配備 さ れる と き に、 コ ン ト ロ ールセ ン タ 管理者は こ の メ ニ ュ ー項目の ラ ベルを変更で き ます。 『Unify NXJ 管理者ガ イ ド 』 を 参照 し て く だ さ い。 c. ア ク セ ス タ イ プ フ ィ ール ド : エ ン ト リ ポ イ ン ト のア ク セ ス コ ン ト ロ ール タ イ プ を選択 し ます。 オ プ シ ョ ンは、 “ すべてのユーザ ” と “ 認証 さ れた ユーザのみ ” です。 ア ク セ ス コ ン ト ロ ール タ イ プ についての詳細は、 160 ページの 「セキ ュ リ テ ィ の設定 と 管理」 を参照 し て く だ さ い。 d. ア プ リ ケーシ ョ ンのデ フ ォ ル ト メ ニ ュ ーにエ ン ト リ ポ イ ン ト を表示 さ せ ない場合は、 チ ェ ッ ク ボ ッ ク ス を ク リ アす るか、 配置先の メ ニ ュ ー を変 更 し ます。 エ ン ト リ フ ォ ームに表示 し たい メ ニ ュ ーが リ ス ト にない場合は、 下の 「 メ ニ ュ ー定義を指定」 の説明に従 っ て、 メ ニ ュ ー を定義 し て く だ さ い。 4. ロ ケール対応 ラ ベルパネルに、 ロ ケール対応 ラ ベルを追加 し ます。 ロ ケールの列のエデ ィ タ は、 ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス形式にな っ てお り 、 構成 さ れてい る ロ ケールが表示 さ れます。 5. エ ン ト リ ポ イ ン ト 名パネルでデ フ ォ ル ト を適用す るか、 チ ェ ッ ク ボ ッ ク ス を 設定 し て フ ォ ームのエ ン ト リ ポ イ ン ト 名を入力 し ます。 6. OK ボ タ ン を ク リ ッ ク し ます。 注 – 既存のエ ン ト リ ポ イ ン ト を削除する には、 ブ ラ ウザウ ィ ン ド ウのプ ロ ジ ェ ク ト ビ ュ ーでオ ブ ジ ェ ク ト を選択 し て右 ク リ ッ ク し 、 エ ン ト リ ポ イ ン ト を削除を選 択 し ます。 こ の フ ォ ームには、 その後はア プ リ ケーシ ョ ンの別の フ ォ ームか ら の ア ク セ スが可能にな り ます。 メ ニ ュ ー定義を指定 エ ン ト リ ポ イ ン ト を定義する と 、 エ ン ト リ ポ イ ン ト を表示する NXJ コ ン ト ロ ール セ ン タ の メ ニ ュ ー を定義で き ます。 デ フ ォ ル ト では、 ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト は、 NXJ コ ン ト ロ ールセ ン タ のア プ リ ケーシ ョ ン メ ニ ュ ーに表示 さ れ ます。 異な る メ ニ ュ ー定義を指定する と 、 NXJ コ ン ト ロ ールセ ン タ が必要に応 じ て っ て メ ニ ュ ー を作成 し ます。 例えば、 プ ロ ジ ェ ク ト に “ オーダー ” と 呼ばれる メ ニ ュ ー 定義があ っ て、“ オーダー作成” と “ オーダー取 り 消 し ” と い う エ ン ト リ があ る場合に Unify NXJ 開発者ガ イ ド 72 4 は、 オーダー と い う メ ニ ュ ーがあ るかど う かが コ ン ト ロ ールセ ン タ で チ ェ ッ ク さ れます。 メ ニ ュ ーがあれば既存の メ ニ ュ ーに、 こ の メ ニ ュ ー項目が追加 さ れます が、 ない場合は新 し く 作成 さ れます。 メ ニ ュ ー定義を設定する ス テ ッ プは、 以下の と お り です。 1. フ ァ イル > 新規 を選択 し ます。 2. 新規オ ブ ジ ェ ク ト パネルで メ ニ ュ ー を選択 し 、 メ ニ ュ ーの 名前を入力 し ます。 Menu シ ン ボル こ れが、 ア プ リ ケーシ ョ ンが配備 さ れた後の コ ン ト ロ ール セ ン タ の メ ニ ュ ー名にな り ます ( メ ニ ュ ーがない場合に は、 コ ン ト ロ ールセ ン タ が作成 し ます)。 3. OK ボ タ ン を ク リ ッ ク し ます。 メ ニ ュ ー属性ダ イ ア ロ グが表示 さ れます。 4. “ メ ニ ュ ー項目 ” タ ブ を ク リ ッ ク し ます。 5. プ ロパテ ィ パネルで、 以下のス テ ッ プ を実行 し ます。 a. コ ン ト ロ ールセ ン タ 管理者がわか り やすい よ う に説明を つけてお く 場合 には、 説明 フ ィ ール ド に メ ニ ュ ーの内容を入力 し ます。 b. デ フ ォ ル ト ラ ベル名を入力す るか、 新規オ ブ ジ ェ ク ト パネルで指定 し た デ フ ォ ル ト の ラ ベル名を適用 し ます。 Unify NXJ 開発者ガ イ ド 73 4 c. ド ロ ッ プ ダウ ン リ ス ト か ら ア ク セ ス タ イ プ を選択 し ます。 6. ロ ケール対応パネルを ク リ ッ ク し 、 ロ ケールを区別する ラ ベルを追加 し ま す。 7. メ ニ ュ ー項目 タ ブ を ク リ ッ ク し ます。 メ ニ ュ ー項目パネルが表示 さ れます。 a. 追加 ボ タ ン を ク リ ッ ク し て、 新 し いエ ン ト リ を作成 し ます。 こ こ では、 メ ニ ュ ー項目を指定 し なが ら メ ニ ュ ー を作成 し ます。 作成す る メ ニ ュ ーの各項目がエ ン ト リ ポ イ ン ト にな り ます。 b. ド ロ ッ プ ダウ ン リ ス ト よ り 、 メ ニ ュ ー項目の type を空の行に指定 し ま す。 Form と Menu のオ プ シ ョ ンがあ り ます。 c. 名称の列の ド ロ ッ プ ダウ ン リ ス ト か ら 、 メ ニ ュ ーに追加す る項目の名前 を Name の列に選択 し ます。 ド ロ ッ プ ダウ ン リ ス ト には、 タ イ プの列で指定 し た エ ン ト リ ポ イ ン ト の 名前がすべて含まれています。 エ ン ト リ ポ イ ン ト は、 メ ニ ュ ーに追加す る前に定義 し てお く 必要があ り ます。 8. 上下の矢印 ボ タ ン を使 っ て、 リ ス ト の メ ニ ュ ー項目の順番を変更 し ます。 こ のダ イ ア ロ グ表示 さ れる順番で、 コ ン ト ロ ールセ ン タ の メ ニ ュ ーに メ ニ ュ ー項目が表示 さ れます。 9. OK ボ タ ン を ク リ ッ ク し ます。 次フ ォ ームの指定方法 と 、 ト ラ ンザク シ ョ ン と ロ ッ ク に関する情報 ア プ リ ケーシ ョ ンの各 フ ォ ームで、 ア ク セ スが可能な フ ォ ームを指定す る必要が あ り ます。 こ れに よ っ て、 Unify NXJ イ ン タ ラ ク シ ョ ンサーバは、 ユーザに正 し い 順序で フ ォ ームを表示 し ます。 こ れ ら の フ ォ ームを 次 フ ォ ーム と いいます。 ユー ザは、 NEXT_FORM コ マ ン ド が発行 さ れる と 次の フ ォ ームにア ク セ ス し ます。 NEXT_FORM コ マ ン ド は、 デ フ ォ ル ト ツ ールバーの 進む ボ タ ン を ク リ ッ ク す る と 発行 さ れます。 以下の図は、 あ る ア プ リ ケーシ ョ ン での次 フ ォ ームの関係を示 し た例です。 Unify NXJ 開発者ガ イ ド 74 4 Entry A B C1 C2 C3 ユーザはエ ン ト リ フ ォ ームか ら 開始 し 、 実行する タ ス ク に従 っ て次の フ ォ ーム を 選択 し ます。 タ ス ク A の場合は フ ォ ーム A を、 タ ス ク B の場合は フ ォ ーム B を、 タ ス ク C の最初の タ ス ク の場合は フ ォ ーム C1 を選択 し ます。 タ ス ク C には さ ら に 2 つの フ ォ ームがあ り 、 フ ォ ーム C1 の次は フ ォ ーム C2、 フ ォ ーム C2 の次は フ ォ ーム C3 が用意 さ れています。 フ ォ ーム C3 の次の フ ォ ームは、 エ ン ト リ フ ォ ームです。 ユーザは、 こ のよ う にパ ス を移動 し て タ ス ク の開始点に戻 り 、 必要に応 じ て タ ス ク を再実行 し ます。 例え ば、 オーダー タ ス ク を作成する場合であれば、 別のオーダーが簡単に作成で き ま す。 PREVIOUS_FORM コ マ ン ド を使 う と 、 ユーザは開始 フ ォ ームに戻る こ と がで き ま す。 上記の例では、 ユーザが現在 C3 にい る と すれば、 PREVIOUS_FORM コ マ ン ド を 3 回発行する と 、 エ ン ト リ フ ォ ームに戻る こ と がで き ます。 Unify NXJ 開発者ガ イ ド 75 4 フ ォ ームに複数の次 フ ォ ームがあ る場合、 ユーザ が Next Form コ マ ン ド を発行する と 、 NXJ イ ン タ ラ ク シ ョ ンサーバに よ り 次 フ ォ ーム選択ダ イ ア ロ グが表示 さ れます。 ユーザは、 こ のダ イ ア ロ グに番号を入力 し て次の フ ォ ームを選択 し 、 チ ェ ッ ク マー ク ボ タ ン を ク リ ッ ク し ます。 ま たは、 マウスや矢印キーで フ ォ ームを選択 し てハ イ ラ イ ト さ せて、 Enter キー を押すかチ ェ ッ ク マー ク ボ タ ン を ク リ ッ ク し ま す。 ( “X” ボ タ ン を ク リ ッ ク する と 、 ダ イ ア ロ グ が取 り 消 さ れます。) 次 フ ォ ームに条件を設定する こ と も で き ます。 フ ォ ームス ク リ プ ト で定義 さ れた特定の jBiz 条件が実行時に true であ る場合にの み、 条件付の次 フ ォ ームが次 フ ォ ーム と し て表示 さ れます。 こ う する と 、 どの条 件付の次 フ ォ ーム も 、 true の条件で次 フ ォ ーム選択ダ イ ア ロ グの リ ス ト に表示 さ れ ます。 条件を設定する方法についての詳細は、 『Unify NXJ jBiz 言語ガ イ ド 』 を参照 し て く だ さ い。 注 – ア ク セ ス で き る フ ォ ーム タ イ プ には、 こ の他に ズーム フ ォ ームがあ り ます。 ズーム フ ォ ームの関係 (お よ び ト ラ ンザ ク シ ョ ン コ ン ト ロ ール) は、 こ のセ ク シ ョ ンのス テ ッ プ では指定で き ません。 82 ページの 「ズーム フ ォ ームの作成」 を 参照 し て く だ さ い。 Unify NXJ ト ラ ンザク シ ョ ン NXJ ア プ リ ケーシ ョ ン では、 実行時に イ ン タ ラ ク シ ョ ンサーバで実行 さ れる ア ク シ ョ ンは、 ト ラ ンザ ク シ ョ ン と い う グループに分類 さ れます。 ト ラ ンザ ク シ ョ ン に よ り 並行処理制御が可能 と な り 、 ア プ リ ケーシ ョ ンの完全性を損な う こ と な く 、 複数のア プ リ ケーシ ョ ン ユーザがア プ リ ケーシ ョ ン デー タ を共有で き ます。 ユーザがア プ リ ケーシ ョ ンのエ ン ト リ フ ォ ームにア ク セ スする と 、 ト ラ ンザ ク シ ョ ンが自動的に開始 さ れます。 イ ン タ ラ ク シ ョ ンサーバは、 以下の内容に基づ いて ト ラ ンザ ク シ ョ ンの処理方法を決定 し ます。 • 次 フ ォ ームの Auto Commit プ ロパテ ィ の値 (70 ページの 「エ ン ト リ ポ イ ン ト フ ォ ームの指定」 を参照 し て く だ さ い) Unify NXJ 開発者ガ イ ド 76 4 • 次 フ ォ ーム選択ダ イ ア ロ グの次 フ ォ ームに指定 し た ト ラ ンザ ク シ ョ ン モー ド ( こ の後のセ ク シ ョ ン を参照 し て く だ さ い) • 次 フ ォ ーム選択ダ イ ア ロ グの次 フ ォ ームに指定 し たデー タ 一貫性レ ベル ( こ の後のセ ク シ ョ ン を参照 し て く だ さ い) • 次 フ ォ ームの jBiz ス ク リ プ ト の ト ラ ンザ ク シ ョ ン処理文 (『Unify NXJ jBiz 言 語ガ イ ド 』 を参照 し て く だ さ い) ト ラ ンザク シ ョ ン モー ド 以下の 3 つの ト ラ ンザ ク シ ョ ン モー ド があ り ます。 • Start • Continue • Restart ユーザがア プ リ ケーシ ョ ン実行時にた ど る フ ォ ーム間のパス を考慮 し て、 フ ォ ー ムに ト ラ ンザ ク シ ョ ン モー ド を どのよ う に指定す るべきかを考え ます。 ユーザが 実行時に フ ォ ームを移動する と 、 フ ォ ームス タ ッ ク が生成 さ れます。 フ ォ ームス タ ッ ク は、 ア プ リ ケーシ ョ ン を作成す る場合の重要な概念です。 フ ォ ームス タ ッ ク 上のどの フ ォ ームに も jBiz 変数のよ う なデー タ があ り 、 そのス タ ッ ク 上の他の フ ォ ームで利用で き ます。 フ ォ ームス ク リ プ ト では、 こ のデー タ を参照 し た り 使 用す る こ と が可能です。 ま た、 フ ォ ームス タ ッ ク では、 PREVIOUS_FORM コ マ ン ド で ア ク セ ス さ れる フ ォ ーム も 決定 さ れます。 Unify NXJ 開発者ガ イ ド 77 4 例に示すア プ リ ケーシ ョ ン では、 タ ス ク C を実行 し たユーザは 4 つの フ ォ ームの フ ォ ームス タ ッ ク を作成 し ます。 Entry A B C1 Entry C1 C2 C2 C3 C3 こ のセ ッ シ ョ ンの フ ォ ーム ス タ ッ ク ト ラ ンザ ク シ ョ ン モー ド は フ ォ ームス タ ッ ク 上で動作 し 、 次 フ ォ ームに移動す る ト ラ ンザ ク シ ョ ン ポ イ ン ト で、 ア プ リ ケーシ ョ ン デー タ を コ ン ト ロ ール し ます。 それぞれの ト ラ ンザ ク シ ョ ン モー ド は、 以下のセ ク シ ョ ン で説明する よ う に、 関 連す る デー タ ベース ト ラ ンザ ク シ ョ ン と ロ ッ ク に影響を与え ます。 Start ト ラ ンザ ク シ ョ ン モー ド 次 フ ォ ームで新規 タ ス ク を開始 し ます。 イ ン タ ラ ク シ ョ ンサーバでは、 以下の こ と を実行 し ます。 • 現在の ト ラ ンザ ク シ ョ ン を コ ミ ッ ト す る • 現在の ト ラ ンザ ク シ ョ ンが持つ ロ ッ ク を すべて解除する フ ォ ームス タ ッ ク を エ ン ト リ フ ォ ームに戻す) Unify NXJ 開発者ガ イ ド 78 4 • 指定 し た次 フ ォ ーム を ア ク テ ィ ブ にす る ( フ ォ ームス タ ッ ク に追加す る) • 指定 し た次 フ ォ ームで新規 ト ラ ンザ ク シ ョ ン を開始する • 指定 し た次 フ ォ ームの実行を開始す る Continue ト ラ ンザ ク シ ョ ン モー ド 次 フ ォ ームで現在の タ ス ク を継続 し ます。 イ ン タ ラ ク シ ョ ンサーバに よ り 、 以下 が実行 さ れます。 • 指定 し た次 フ ォ ーム を ア ク テ ィ ブ にす る ( フ ォ ームス タ ッ ク に追加す る) • 指定 し た次 フ ォ ームの実行を開始す る イ ン タ ラ ク シ ョ ンサーバは、 指定 し た次 フ ォ ー こ のセ ッ シ ョ ンの フ ォ ームス タ ッ ク ムを実行す る場合 も 現在の ト ラ ンザ ク シ ョ ン を 継続 し ます。 取得 さ れた ロ ッ ク はすべて保持 さ Entry れます。 C1 フ ォ ームス タ ッ ク の例では、 フ ォ ーム C2、 C3 の ト ラ ンザ ク シ ョ ン モー ド は Continue に設定 さ れています。 Continue C2 Continue C3 こ れ ら の フ ォ ームは同 じ タ ス ク の一部なので、 フ ォ ームス タ ッ ク は 4 つの フ ォ ーム を すべて含 んでいます。 Restart ト ラ ンザ ク シ ョ ン モー ド カ レ ン ト フ ォ ームス タ ッ ク 上の フ ォ ーム を非ア ク テ ィ ブに し 、 指定 し た フ ォ ーム のみに戻 し ます。 イ ン タ ラ ク シ ョ ンサーバに よ り 、 以下が実行 さ れます。 • 現在の ト ラ ンザ ク シ ョ ン を コ ミ ッ ト す る • 現在の ト ラ ンザ ク シ ョ ンが保持する ロ ッ ク を すべて解除す る Unify NXJ 開発者ガ イ ド 79 4 • フ ォ ームス タ ッ ク の フ ォ ームを削除 し て指 こ のセ ッ シ ョ ンの フ ォ ーム ス タ ッ ク 定 し た フ ォ ームに戻 し 、 エ ン ト リ フ ォ ーム Entry には戻 さ ない。 ( こ の例のア プ リ ケーシ ョ ン では、 指定 し た フ ォ ームはエ ン ト リ C1 フ ォ ーム と な っ ています。) 指定 し た C2 フ ォ ームが現在の フ ォ ームス タ ッ ク にない 場合は、 ユーザは実行時にエ ラ ー を受け取 Restart C3 る • 指定 し た次 フ ォ ームで新規 ト ラ ンザ ク シ ョ ン を開始す る • 指定 し た次 フ ォ ームの実行を再開す る Restart ト ラ ンザ ク シ ョ ン モー ド がよ く 使用 さ れるのは、 ユーザが タ ス ク を終了 し た後で、 ア プ リ ケーシ ョ ン で開始 フ ォ ームの メ ニ ュ ー (A、 B、 C1) を再表示す る 場合です。 こ の例では、 エ ン ト リ フ ォ ームは C3 フ ォ ームの次 フ ォ ームです。 次 フ ォ ームであ る エ ン ト リ フ ォ ームの ト ラ ンザ ク シ ョ ン モー ド は、 Restart モー ド に設定 さ れてい ます。 デー タ 一貫性レベル デー タ 一貫性レ ベルは、 選択セ ッ ト 中にあ る タ ーゲ ッ ト テーブルの行のロ ッ ク を 管理する方法を指定 し ます。 選択セ ッ ト と は、 “ 検索 ” (FIND) コ マ ン ド 条件で検 索 さ れた タ ーゲ ッ ト テーブルの行のセ ッ ト です。 すべてのア プ リ ケーシ ョ ン において、 デー タ 一貫性レ ベルは以下の通 り です。 • None 選択セ ッ ト の行には、 共有ロ ッ ク があ り ません。 共有ロ ッ ク は、 複数のユー ザが読み取 り 可能ですが、 どのユーザ も 変更はで き ません。 選択セ ッ ト の現 在のレ コ ー ド で更新や削除 操作を要求 さ れる と 、 イ ン タ ラ ク シ ョ ンサーバは ロ ッ ク を要求 し なが ら デー タ ベース行を再度読み取 り 、 同時変更を検出 し ま す。 ロ ッ ク の衝突が検出 さ れる と 、 ユーザにエ ラ ーが報告 さ れます。 行が正 常に更新 / 削除 さ れる と 、 排他的ロ ッ ク が適用 さ れます。 排他的ロ ッ ク と は、 現在のユーザだけが読み込み / 変更が可能な ロ ッ ク です。 Unify NXJ 開発者ガ イ ド 80 4 次フ ォ ーム選択ダ イ ア ログの使い方 ト ラ ンザ ク シ ョ ン モー ド と デー タ 一貫性レ ベルを指定 し て次 フ ォ ームを設定す る ス テ ッ プは、 以下の と お り です。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで フ ォ ーム名を ク リ ッ ク し 、 フ ォ ーム を開き ます。 2. プ ロパテ ィ タ ブ を ク リ ッ ク し て、 ブ ラ ウザパネルで プ ロパテ ィ ビ ュ ー を開き ます。 3. Next Form List プ ロパテ ィ の値の列を ク リ ッ ク し ます。 次 フ ォ ーム選択ダ イ ア ロ グが表示 さ れます。 4. 現在の フ ォ ームの次 フ ォ ームにな る フ ォ ーム を選択 し 、 除外の列か ら 含むの 列に移動 し ます。 除外の列には、 現在プ ロ ジ ェ ク ト で定義 さ れてい る全 フ ォ ーム と < 終了 > が リ ス ト さ れています。 フ ォ ーム を移動する には、 フ ォ ーム を選択 し て右ま た は左の矢印を ク リ ッ ク し ます。 実行時に次 フ ォ ーム選択ダ イ ア ロ グに表示 さ れる テキス ト は、 フ ォ ームの Menu Label プ ロパテ ィ で指定 し ます。 こ のダ イ ア ロ グに表示 さ れる フ ォ ーム 名は、 プ ロパテ ィ > メ ニ ュ ー ラ ベル がブ ラ ン ク であ る場合は使用で き ます。 < 終了 > オ プ シ ョ ンは、次 フ ォ ーム選択ダ イ ア ロ グの “ ア プ リ ケーシ ョ ンの終 了 ” オ プ シ ョ ン です。 こ のオ プ シ ョ ン を選択する と 、 ア プ リ ケーシ ョ ンが終了 し ます。 実行時に ツ ールバーで ア プ リ ケーシ ョ ンの終了 ボ タ ン を ク リ ッ ク し て ア プ リ ケーシ ョ ン を終了す るの と 同 じ 機能です。 Unify NXJ 開発者ガ イ ド 81 4 5. 実行時の条件に基づいた次 フ ォ ームのみにす る場合、 条件付チ ェ ッ ク ボ ッ ク ス を設定 し ます。 条件付チ ェ ッ ク ボ ッ ク ス を設定する と 、 evaluateNextFormCondition メ ソ ッ ド が呼び出 さ れ、 フ ォ ームを次 フ ォ ーム メ ニ ュ ーに含めるかど う かが決定 さ れ ます。 こ の メ ソ ッ ド は、 フ ォ ームス ク リ プ ト で jBiz 文を使 っ て作成 し ます。 詳細に ついては 『Unify NXJ jBiz 言語ガ イ ド 』 を参照 し て く だ さ い。 6. 含まれる フ ォ ームの順番は、 行を選択 し て ダ イ ア ロ グの上下の矢印を ク リ ッ ク す る と 変更で き ます。 こ こ で指定する順序で、 実行時に Choose Next Form メ ニ ュ ーで表示 さ れま す。 7. 含むの列の各 フ ォ ームについて、 ト ラ ンザ ク シ ョ ン モー ド と デー タ 一貫性レ ベルを指定 し ます。 ト ラ ンザ ク シ ョ ン モー ド は、 ド ロ ッ プ ダウ ン リ ス ト か ら 選択 し ます。 使用で き る ト ラ ンザ ク シ ョ ン モー ド は、 Start、 Continue、 Restart です。 デ フ ォ ル ト の ト ラ ンザ ク シ ョ ン モー ド は Continue です。 デー タ 一貫性レ ベルは、 None に設定 し ます。 8. OK ボ タ ン を ク リ ッ ク し て ダ イ ア ロ グ を閉 じ る と 、 変更が適用 さ れます。 次 フ ォ ーム リ ス ト は、 プ ロパテ ィ テーブルに一連の フ ォ ーム名 と し て表示 さ れま す。 フ ォ ーム名 と ト ラ ンザ ク シ ョ ン モー ド は、 名称の列か値の列を ク リ ッ ク す る と 表示 さ れます ズーム フ ォ ームの作成 ズームには強力な機能があ り 、 ユーザはズーム フ ォ ームの内容を表示 し て、 呼び 出 し 元の フ ォ ームにデー タ を戻す こ と がで き ます。 ユーザは、 現在の フ ォ ームの 内容を閉 じ ずにデー タ をル ッ ク ア ッ プ し て検索で き るので、 効率が高ま り ます。 ユーザが こ の機能を使 う には、 現在の フ ォ ーム上でズーム可能な フ ィ ール ド に カ ー ソ ルを移動 し て、 NXJ ツ ールバーの ズーム ボ タ ン を ク リ ッ ク し ます。 ズーム フ ォ ームに、 部品番号な どの関連情報が表示 さ れます。 ユーザが こ れを選択 し て 戻る ボ タ ン を ク リ ッ ク す る と 、 フ ォ ーム フ ィ ール ド にデー タ が返 さ れます。 ズー ムに よ り 余分なキー入力を省略で き るので、 ユーザの入力エ ラ ー を減 ら す こ と が で き ます。 ユーザは、 取消 ボ タ ン を ク リ ッ ク し て、 ズーム操作を キ ャ ン セルす る こ と も で き ます。 Unify NXJ 開発者ガ イ ド 82 4 ズーム フ ォ ームの設定 ズーム フ ォ ームを設定す る ス テ ッ プは、 以下の と お り です。 1. レ イ アウ ト パネルで、 呼び出 し フ ォ ーム と な る フ ォ ームを開き ます。 2. フ ォ ーム上で、 ズーム可能にす る フ ィ ール ド コ ン ト ロ ールを選択 し ます。 ユーザが ZOOM コ マ ン ド を発行する と き、 こ の フ ィ ール ド コ ン ト ロ ールが ズーム フ ォ ームにア ク セ ス し ます。 3. ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ーで、 Zoom Form プ ロパテ ィ のズーム フ ォ ーム名を選択 し ます。 Zoom Form プ ロパテ ィ は、 プ ロパテ ィ の Zoom グループにあ り ます。 値の列 の下向 き矢印を ク リ ッ ク する と 、 既存の フ ォ ーム名の リ ス ト が表示 さ れま す。 フ ォ ーム名が表示 さ れない場合は、 フ ォ ーム名を入力 し ます。 4. ユーザにズーム フ ォ ームの値の返却を可能にする場合は、 Return Values Into プ ロパテ ィ に値を設定 し ます。 Return Values Into プ ロパテ ィ は、 プ ロパテ ィ のズームグループ にあ り ます。 複数の値があ る場合は、 セ ミ コ ロ ン で区切 り ます。 スペースは使用 し ないで く だ さ い。 5. ズーム フ ォ ームの フ ォ ームモー ド を選択 し ます。 Zoom Active Mode プ ロパテ ィ は、 プ ロパテ ィ の Zoom グループにあ り ます。 以下のよ う なオ プ シ ョ ンがあ り ます。 • Find : 検索モー ド のみ • Add/Update : 追加 / 更新モー ド のみ • Both : ユーザは実行時に ど ち ら のモー ド かを選択す る こ と がで き ます。 デ フ ォ ル ト は Both です。 6. Zoom Consistency プ ロパテ ィ のオ プ シ ョ ン を選択 し て、 ズーム フ ォ ームの整 合性モー ド を指定 し ます。 Zoom Consistency プ ロパテ ィ は、 プ ロパテ ィ の Zoom グループ にあ り ます。 以下のよ う なオ プ シ ョ ンがあ り ます。 • Inherit • No consistency デ フ ォ ル ト のデー タ 一貫性レ ベルは、 Inherit です。 Unify NXJ 開発者ガ イ ド 83 4 デ フ ォ ル ト のデー タ 一貫性レ ベルは、 Inherit です。 整合性モー ド の選択につ いての詳細は、 80 ページの 「デー タ 一貫性レ ベル」 を参照 し て く だ さ い。 フ ォ ームの外観を カ ス タ マ イ ズ フ ォ ームのデ フ ォ ル ト の外観は、 以下の図 と お り です。 フ ォ ームの外観は、 以下 の フ ォ ームプ ロパテ ィ で変更で き ます。 Background color ま たは background Height Foreground color Width Unify NXJ 開発者ガ イ ド 84 4 フ ォ ームの高 さ と 幅 フ ォ ームの Height と Width プ ロパテ ィ で、 フ ォ ームの高 さ と 幅を ピ ク セルで指定 し ます。 フ ォ ームの Height と Width プ ロパテ ィ は、 プ ロパテ ィ の Visual グループにあ り ま す。 デ フ ォ ル ト の高 さ は 500 ピ ク セル、 幅は 900 ピ ク セルです。 フ ォ ームの境界線 Visual プ ロパテ ィ で、 以下の内容を指定 し ます。 • Border-width : フ ォ ームの境界線の幅 (ピ ク セル)。 0 か ら 10 の間で指定 し ま す。 • Border-style : 境界線のス タ イル。 Dashed、 Dotted、 Groove、 Inset、 None、 Outset、 Ridge、 Solid か ら 選択 し ます。 • Border-color : 境界線の色。 設定方法は次のセ ク シ ョ ン で説明 さ れています。 フ ォ ームの前景色 と 背景色 Background と は、 フ ォ ームの背景色です。 デ フ ォ ル ト の背景色はか ら し 色 (#fleacc) です。 Foreground と は、 フ ォ ームの前景色です。 デ フ ォ ル ト の前景色は 黒です。 異な る前景色や背景色を指定 し た り 、 背景を透過にする場合は、 デザ イ ン セ ン タ の色の選択を使用 し ます。 以下のス テ ッ プに従 っ て く だ さ い。 1. デザ イ ン セ ン タ メ イ ン ウ イ ン ド ウで、 ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ーに ア ク セ ス し ます。 2. ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ーで Foreground プ ロパ テ ィ 、 ま たは Background プ ロパテ ィ の値の Chooser ボ タ ン を ク リ ッ ク し ます。 Chooser ボ タ ン こ れ ら のプ ロパテ ィ は、 プ ロパテ ィ の Visual グループ にあ り ます。 Chooser ボ タ ン を使用可能にす る場合は、 値の列を ク リ ッ ク する必 要があ り ます。 Unify NXJ 開発者ガ イ ド 85 4 前景色の選択ダ イ ア ロ グ、 ま たは背景色のダ イ ア ロ グが表示 さ れます。 こ の ダ イ ア ロ グには背景色を選択す る ための 2 つの方法 と 、 背景を透過にす る た めの 1 つの方法があ り ます。 • サン プル : 色の見本です。 色見本を ク リ ッ ク する と 選択 し た色が リ セ ッ ト さ れ、 テキス ト フ ィ ール ド が更新 さ れます。 右側の領域に、 最近使用 し た色見本が表示 さ れます。 • RGB : RGB 値を指定する ためのパネルです。 テキス ト フ ィ ール ド に入力 するか、 ス ラ イ ダ を移動 さ せて値を指定 し ます。 パネルの下にあ る テキス ト フ ィ ール ド には、 RGB 値の入力見本が表示 さ れま す。 RGB 値を指定する テキス ト フ ィ ール ド には #rrggbb 形式の文字列か、 HTML でサポー ト さ れてい る色の名前を入力 し ます。 3. OK ボ タ ン を ク リ ッ ク し て ダ イ ア ロ グ を閉 じ る と 、 背景色への変更が適用 さ れます。 4. 透過 ボ タ ン を ク リ ッ ク す る と 背景を透過にで き ます。 レ イ アウ ト パネルの前景色を選択す る と 、 現在の背景色はサン プル フ ィ ール ド の 背景にな り 、 前景色は選択 し た色で表示 さ れます。 レ イ アウ ト パネルの背景色を選択す る と 、 現在の前景色はサン プル フ ィ ール ド の 前景にな り 、 背景色は選択 し た色で表示 さ れます。 フ ォ ームの Wallpaper Wallpaper は フ ォ ームの背景 イ メ ージ で、 オ プ シ ョ ン で指定 し ます。 デ フ ォ ル ト で は、 フ ォ ームには Wallpaper があ り ません。 フ ォ ームの Wallpaper を指定す る には、 Wallpaper プ ロパテ ィ に フ ァ イル名を入力 し ます。 Wallpaper プ ロパテ ィ は、 プ ロパテ ィ の Visual グループにあ り ます。 壁紙 フ ァ イルは、 フ ァ イル選択で表示で き ます。 Wallpaper プ ロパテ ィ を設定す る と 、 フ ォ ームの背景色を上書き し ます。 フ ォ ームのヘ ッ ダ、 ツールバー、 フ ッ タ こ れ ら のプ ロパテ ィ を使 う と 、 Unify NXJ の フ ォ ームに用意 さ れてい る ヘ ッ ダ、 メ ニ ュ ー、 フ ッ タ の コ ン ポーネ ン ト がオーバー ラ イ ド さ れます。 新 し いヘ ッ ダ、 ツ ールバー、 フ ッ タ は、 プ ロ ジ ェ ク ト の現在の look & feel 定義で定義 し ます。 Unify NXJ 開発者ガ イ ド 86 4 使用する ア プ リ ケーシ ョ ンの look & feel 定義については、 149 ページの 「Look and Feel の カ ス タ マ イ ズ」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 87 コ ン ト ロールの使い方 5 こ の章では、 ア プ リ ケーシ ョ ン開発に関連す る以下の タ ス ク について説明 し ます。 • 新規 コ ン ト ロ ールの作成 • フ ォ ームの フ ィ ール ド コ ン ト ロ ールの並べ替え • コ ン ト ロ ールの外観の カ ス タ マ イ ズ • コ ン ト ロ ールの動作の カ ス タ マ イ ズ コ ン ト ロールの概要 コ ン ト ロ ール と は、 フ ォ ームに配置で き る オ ブ ジ ェ ク ト です。 以下の表に コ ン ト ロ ール と 、 コ ン ト ロ ールが属す る カ テ ゴ リ を示 し ます。 表 5-1 コ ン ト ロールのカ テ ゴ リ ( 1 / 2 ) カテゴ リ コ ン ト ロ ール 説明 フ ィ ール ド コ ン ト ロール Text field Text area Checkbox Dropdown list Listbox Radio group 情報を表示、 ま たは適用する。 タ ーゲ ッ ト フ ィ ール ド コ ン ト ロール と は、 デー タ ベースの列にマ ッ プ さ れた フ ィ ール ド コ ン ト ロールであ る。 非 タ ーゲ ッ ト フ ィ ー ル ド コ ン ト ロールは、 フ ォ ームス ク リ プ ト の変数にマ ッ プ さ れる。 ボタ ン コ ン ト ロール Button Image button ユーザがボ タ ン を ク リ ッ ク する と 、 コ マ ン ド が実行 さ れる。 ア ク シ ョ ン には、 NXJ で用意 さ れた コ マ ン ド に よ る も の と 、 開発者が定義 し た コ マ ン ド に よ る も のがあ る。 静的テキス ト コ ン ト ロール Label Styled text 設計時に定義 し た テキス ト が表示 さ れ る。 実行時には変更 さ れない。 Dynamic text コ ン ト ロール Dynamic text 実行時に実行 さ れる jBiz 式に よ り 、 生成 さ れた テキス ト を表示する。 88 5 表 5-1 コ ン ト ロールのカ テ ゴ リ ( 2 / 2 ) カテゴ リ コ ン ト ロ ール 説明 装飾 コ ン ト ロール Group box Image Line フ ォ ームや コ ン ト ロールに関連する グ ループに視覚効果を与え て使いやす く す る。 リンク コ ン ト ロール Hyperlink Inline frame URL への リ ン ク や、 static content フ ァ イ ルを提供する。 他の コ ン ト ロールの コ ン テナ Repeating area Tab Table 他の コ ン ト ロールを グループ化する。 フ ォ ームの複数のレ コ ー ド を表示する場 合は、 繰 り 返 し 領域が使用 さ れる。 コ ン ト ロールの作成 フ ォ ームには、 フ ォ ーム作成時にデ フ ォ ル ト で作成 さ れた組み込み式の フ ィ ール ド コ ン ト ロ ールが含まれてい る こ と があ り ます。 以下の方法で、 コ ン ト ロ ールを さ ら に追加で き ます。 • コ ン ト ロ ールパレ ッ ト で コ ン ト ロ ールのシ ン ボルを選択す る。 23 ページの 「NXJ デザ イ ン セ ン タ の コ ン ト ロ ール パレ ッ ト に用意 さ れてい る シ ン ボル」 を参照 し て く だ さ い。 • コ ン ト ロ ールを配置する場所で、 レ イ アウ ト パネルの フ ォ ームを ク リ ッ ク す る。 NXJ デザ イ ン セ ン タ では、 別の コ ン ト ロ ールの上に コ ン ト ロ ールを配置 する こ と はで き ません。 ただ し 、 グループボ ッ ク ス、 タ ブ、 テーブルな どの コ ン テ ナ コ ン ト ロ ールには配置で き ます。 Unify NXJ 開発者ガ イ ド 89 5 1. パレ ッ ト か ら コ ン ト ロールの タ イ プ を 2. 指定する場所を ク リ ッ ク する 選択 3. 必要に応 じ て名前を変更する コ ン ト ロ ールの作成時にサ イ ズ を指定する には、 作成 し たい位置で マウス を ク リ ッ ク し 、 十字型 カ ー ソ ルを ド ラ ッ グ し ます。 意図するサ イ ズにな っ た と き に、 マ ウス ボ タ ン を離す と コ ン ト ロ ールが作成 さ れます。 チ ェ ッ ク ボ ッ ク スのよ う に、 サ イ ズが変更で き ない コ ン ト ロ ール も あ り ます。 レ イ アウ ト パネルの フ ォ ームに コ ン ト ロ ールを作成する と 、 NXJ デザ イ ン セ ン タ で コ ン ト ロ ールが追加 さ れ、 選択状態にな り ます。 grabbers が有効な場合は、 grabber が表示 さ れます。 snap-to-grid プ リ フ ァ レ ン スが指定 さ れてい る場合、 コ ン ト ロ ールは最 も 近いグ リ ッ ド 座標の カ ー ソ ル位置に合わせて移動 さ れます。 NXJ デザ イ ン セ ン タ は、 コ ン ト ロ ールにユニー ク な名前で作成 し ます。 Name プ ロ パテ ィ の値を変更する と 、 コ ン ト ロ ール名が変更で き ます。 Name プ ロパテ ィ は、 プ ロパテ ィ の General グループにあ り ます。 Unify NXJ 開発者ガ イ ド 90 5 他のレ イ アウ ト パネル セ ッ シ ョ ンか ら 、 コ ン ト ロ ールを コ ピ ーで き ます。 レ イ アウ ト > 変更 コ マ ン ド を使 う と 、 フ ィ ール ド コ ン ト ロ ールを他の フ ィ ール ド コ ン ト ロ ール タ イ プ に変更で き ます。 コ ン ト ロールのサイ ズ変更 コ ン ト ロ ールのサ イ ズ を変更す る には、 コ ン ト ロ ールを選択 し 、 意図す るサ イ ズにな る ま で grabbers を ド ラ ッ グ し ます。 コ ン ト ロ ール上に表示 さ れる grabbers の数に よ っ て、 コ ン ト ロ ールの幅、 高 さ 、 幅 と 高 さ のどれが変更で き るのか、 どれ も 変更で き ないのかが判断で き ます。 Grabbers 各 コ ン ト ロ ールはあ る タ イ プの コ ン テナの中、 つま り フ ォ ームか他の コ ン ト ロ ー ル (繰 り 返 し 領域な ど) の中で し かサ イ ズが変更で き ません。 コ ン ト ロ ールのサ イ ズが コ ン テ ナ をはみ出すよ う にす る こ と はで き ません。 NXJ デザ イ ン セ ン タ は、 サ イ ズの変更後、 コ ン ト ロ ールのサ イ ズ を少 し だけ調整 し ます。 こ れは、 コ ン ト ロ ールのサ イ ズが HTML 属性 (テキス ト 領域の行属性な ど) で定義 さ れ、 フ ォ ン ト サ イ ズに よ り 行が奇数にな る場合に発生 し ます。 複数の コ ン ト ロ ールのサ イ ズ を、 同時に変更する こ と はで き ません。 Unify NXJ 開発者ガ イ ド 91 5 フ ォ ームのフ ィ ール ド コ ン ト ロールの順序を指定する 実行時に、 カ ー ソ ルが フ ィ ール ド コ ン ト ロ ール間を移動す る順序を指定で き ます。 入力が必要な フ ィ ール ド コ ン ト ロ ールに カ ー ソ ルが移動 し 、 ユーザは こ の順序に 従 っ て フ ォ ーム内を移動 し ます。 カ ー ソ ルが移動す る順序は、 デ フ ォ ル ト では左 上か ら 始ま り 、 左か ら 右、 上か ら 下 と 続き ます。 以下の図は、 フ ォ ーム上の フ ィ ー ル ド コ ン ト ロ ール間で カ ー ソ ルが移動する デ フ ォ ル ト の順序を示 し ています。 1 2 3 4 5 6 7 8 異な る フ ィ ール ド 間移動順序が必要な フ ォ ームの場合、 フ ィ ール ド 順ダ イ ア ロ グ で指定する こ と がで き ます。 こ のダ イ ア ロ グ を使 っ て、 フ ィ ール ド 順を設定す る ス テ ッ プは、 以下の と お り です。 1. 必要に応 じ て、 デザ イ ン セ ン タ オ プ シ ョ ン ダ イ ア ロ グの標準の フ ィ ール ド 順 を使用チ ェ ッ ク ボ ッ ク ス を ク リ ア し ます。 標準の フ ィ ール ド 順を使用オ プ シ ョ ンが設定 さ れてい る場合、 デ フ ォ ル ト 以 外の フ ィ ール ド 順は指定で き ません。 デザ イ ン セ ン タ オ プ シ ョ ン ダ イ ア ロ グにア ク セ スす る には、 編集 > オ プ シ ョ ン を選択 し ます。 レ イ アウ ト パネルで、 標準の フ ィ ール ド 順を使用 チ ェ ッ ク ボ ッ ク スが設定 さ れてい る場合は、 ク リ ア し ます。 Unify NXJ 開発者ガ イ ド 92 5 2. レ イ アウ ト > フ ィ ール ド 順 を選択 し ます。 フ ィ ール ド オーダーダ イ ア ロ グ フ ィ ール ド 順ダ イ ア ロ グが表示 さ れます。 ダ イ ア ロ グには、 現在の フ ォ ームで使用 さ れて い る フ ィ ール ド コ ン ト ロ ールの名前がすべて表 示 さ れています。 画面 フ ィ ール ド 配列にマ ッ プ さ れてい る フ ィ ール ド コ ン ト ロ ールは、 一次元 配列か二次元配列かに よ っ て name[row] ま たは name[row, col] で表示 さ れます。 上向き / 下向 きの矢印を使 っ て、 選択 し た フ ィ ール ド コ ン ト ロ ールを リ ス ト 内で上下に移 動 さ せます。 リ ス ト の最初にあ る フ ィ ール ド コ ン ト ロ ールが、 移動時に も 最初の フ ィ ール ド コ ン ト ロ ールにな り ます。 フ ィ ール ド コ ン ト ロ ールの順序を デ フ ォ ル ト に 戻 し て左か ら 右、 上か ら 下にす る には、 デ フ ォ ル ト ボ タ ン を ク リ ッ ク し ます。 3. OK ボ タ ン を ク リ ッ ク し ます。 コ ン ト ロール プ ロパテ ィ を設定 プ ロパテ ィ を変更す る こ と に よ り 、 コ ン ト ロ ールのデ フ ォ ル ト の動作 と 外観を変 更で き ます。 それぞれの コ ン ト ロ ールには、 1 つま たは複数の関連する プ ロパテ ィ のグループがあ り ます。 コ ン ト ロ ールのプ ロパテ ィ を利用す る には、 レ イ アウ ト パ ネルで コ ン ト ロ ールを選択 し て、 ブ ラ ウザパネルのプ ロパ テ ィ ビ ュ ー を開き ます。 プ ロパテ ィ を変更す る には、 その プ ロパテ ィ の値の列を ク リ ッ ク し ます。 値の列の省略記号 ボ タ ン (...) を ク リ ッ ク す る と 別のダ イ ア ロ グが開き、 ダ イ ア ロ グで そのプ ロパテ ィ の値を入力で き ます。 複数の コ ン ト ロ ールを選択する と 、 プ ロパテ ィ の設定は、 選択 し た全ての コ ン ト ロ ールに対 し て共通で行われます。 プ ロパテ ィ を変更す る と 、 その変更は選択 し た全ての コ ン ト ロ ールに適用 さ れます。 Unify NXJ 開発者ガ イ ド 93 5 注 – jBiz フ ォ ームス ク リ プ ト を使 っ て、 実行時に プ ロパテ ィ を設定す る こ と も で き ます。 こ の場合、 ユーザ入力や他の実行時の動作に基づいて、 コ ン ト ロ ールの 動作を変更で き ます。 コ ン ト ロ ールに適用 さ れる プ ロパテ ィ の概要については、 171 ページの付録 A 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 プ ロパテ ィ の値を継承 コ ン ト ロ ールは、 プ ロパテ ィ の値を現在のス タ イルや、 フ ォ ームやデー タ ビ ュ ー な どの コ ン テ ナか ら 継承 し ます。 例えば、 ラ ベルは フ ォ ームか ら その フ ォ ン ト を 継承 し ます。 プ ロパテ ィ ビ ュ ーでは、 継承 さ れた値は通常の フ ォ ン ト で表示 さ れます。 コ ン ト ロ ールで明示的に設定 さ れた値は、 斜体で表示 さ れます。 継承 さ れた値に 戻すには、 値を右 ク リ ッ ク し てデ フ ォ ル ト 値に設定 を選択 し ます。 コ ン ト ロールの Visual プ ロパテ ィ コ ン ト ロ ールの外観は、 プ ロパテ ィ の Visual グループ で定義 し ます。 以下のセ ク シ ョ ン では、 Visual プ ロパテ ィ について説明 し ます。 ま た、 Visual プ ロパテ ィ を他 の コ ン ト ロ ールに関連付け る方法 も 説明 し ます。 注 – 注 : Visual プ ロパテ ィ は、 ス タ イル定義を使用 し て設定で き ます。 ス タ イル 定義は、 プ ロ ジ ェ ク ト の look & feel 定義で管理 さ れています。 149 ページの 「Look and Feel の カ ス タ マ イ ズ」 を参照 し て く だ さ い。 通常、 こ のセ ク シ ョ ン で説明す る Visual プ ロパテ ィ の設定は、 look & feel 定義で 設定 し た ス タ イルを オーバー ラ イ ド し ます。 Unify NXJ 開発者ガ イ ド 94 5 Background (背景色) と Foreground (前景色) 全ての コ ン ト ロ ールには、 背景色があ り ます。 一部の コ ン ト ロ ールでは、 部分的 に前景色 も 使用 さ れています。 例えば、 テキス ト フ ィ ール ド やボ タ ン ラ ベルのテ キス ト には、 前景色が使用で き ます。 背景色は Background プ ロパテ ィ で指定 し ます。 背景色を選択する には、 色の選択を使用 し ます。 色の選択に ア ク セ スす る には、 Background プ ロパテ ィ の値の列を ク リ ッ ク し て、 選択 ボ タ ン を ク リ ッ ク し ます。 . Chooser ボ タ ン 色の選択ダ イ ア ロ グで、 サン プルの色見本を ク リ ッ ク す るか、 RGB パネルを使用 し て色の名前を入力 し 、 OK ボ タ ン を ク リ ッ ク し ます。 Foreground プ ロパテ ィ で も 同 じ 方法を使 っ て、 コ ン ト ロ ールの前景色を指定 し ま す。 Border Color 、 Width、Style (境界線の色、 幅、 ス タ イル) 全ての コ ン ト ロ ールには境界線があ り ますが、 中にはデ フ ォ ル ト 幅が 0 ピ ク セル の境界線 も あ り ます。 その場合、 画面では確認で き ません。 境界線の色は、 Border Color プ ロパテ ィ で指定 し ます。 境界線の色は、 前述の Background プ ロパテ ィ で説明 し た色の選択 ダ イ ア ロ グで指定 し ます。 デ フ ォ ル ト は黒です。 境界線のス タ イルは、 Border Style プ ロパテ ィ で指定 し ます。 値の列の ド ロ ッ プ ダ ウ ン リ ス ト か ら 、 none, dotted, dashed, solid, double, groove, ridge, inset, outset のいず れかのオ プ シ ョ ンが選択で き ます。 デザ イ ン セ ン タ と 実行時の境界線の外観を次に示 し ます。 Unify NXJ 開発者ガ イ ド 95 5 デザ イ ン セ ン タ の境界線見本 s 実行時の境界線見本 境界線のピ ク セル幅は、 Border Width プ ロパテ ィ で指定 し ます。 デ フ ォ ル ト は、 コ ン ト ロ ールの タ イ プ に よ っ て異な り 、 0 ピ ク セルま たは 1 ピ ク セルです。 テーブルの場合は、 境界線のス タ イルを None に設定 し て境界線を削除 し 、 フ ォ ー ムの コ ン ト ロ ールの位置を テーブルレ イ アウ ト に基づいて指定す る こ と がで き ま す。 フ ォ ン ト のフ ァ ミ リ と サイ ズ テキス ト を使用す る コ ン ト ロ ールでは、 テキス ト に使用す る フ ォ ン ト の フ ァ ミ リ と サ イ ズ を指定で き ます。 フ ォ ン ト の フ ァ ミ リ は、 Font Family プ ロパテ ィ で指定 し ます。 値の列の ド ロ ッ プ ダウ ン リ ス ト で フ ァ ミ リ 名を選択 し ます。 デ フ ォ ル ト は、 Java で指定 さ れます。 ド ロ ッ プ ダウ ン リ ス ト には、 シ ス テムに イ ン ス ト ール さ れてい る フ ォ ン ト が表示 さ れます。 フ ォ ン ト のサ イ ズは、 Font Size プ ロパテ ィ で指定 し ます。 値の列の ド ロ ッ プ ダウ ン リ ス ト でサ イ ズ を選択 し ます。 Unify NXJ 開発者ガ イ ド 96 5 オブ ジ ェ ク ト の高 さ と 幅 フ ォ ームのオ ブ ジ ェ ク ト のサ イ ズは、 Height と Width プ ロパテ ィ で指定 し ます。 こ の方法を使 う と 、 grabbers でオ ブ ジ ェ ク ト の寸法を指定す る よ り も 正確に指定で き ます。 オ ブ ジ ェ ク ト には、 テキス ト フ ィ ール ド な どのよ う に高 さ が指定で き な いオ ブ ジ ェ ク ト も の も あ り ます。 テキス ト オ ブ ジ ェ ク ト の高 さ は、 フ ォ ン ト サ イ ズで指定 し ます。 コ ン ト ロールの位置 (上 と 左) フ ォ ームの コ ン ト ロ ールの位置を確認、 ま たは変更する ために Top プ ロパテ ィ と Left プ ロパテ ィ を使用 し ます。 プ ロパテ ィ の値はピ ク セルの数で表 し た も ので、 フ ォ ームやグループボ ッ ク ス を取 り 囲む コ ン テ ナの一番上、 ま たは左上か ら の相 対位置です。 こ のよ う に場所を指定す る と 、 コ ン ト ロ ールの位置を ド ラ ッ グ& ド ロ ッ プ し て指定す る よ り も 正確に指定で き ます。 ツールチ ッ プ ツールチ ッ プ と は、 実行時に カ ー ソ ルを コ ン ト ロ ー ルに置 く と 表示 さ れる小 さ なポ ッ プ ア ッ プウ ィ ン ド ウの説明文で、 右の図に示すよ う に、 コ ン ト ロ ール の内容を説明 し 、 ユーザを援助する ために使用 さ れ ます。 ボ タ ン上のツールチ ッ プ Press to submit your order. ツ ールチ ッ プ を追加する には、 Tooltip プ ロパテ ィ に テキス ト を入力 し ます。 実行時に、 ツ ールチ ッ プはア ク テ ィ ブ なウ ィ ン ド ウにだけ表示 さ れます。 カ ー ソ ルを コ ン ト ロ ールに 1 秒置 く と 、 ツ ールチ ッ プが表示 さ れます。 次のツ ールチ ッ プはす ぐ に表示 さ れます (つま り 1 秒待た な く て も 表示 さ れます)。 ツ ールチ ッ プ は、 コ ン ト ロ ール領域の外に カ ー ソ ルを移動するか 5 秒す る と 表示が消え ます。 デ フ ォ ル ト では、 ツ ールチ ッ プ には値がな く 、 利用可能な状態にな っ ています。 Unify NXJ 開発者ガ イ ド 97 5 Size Text Field コ ン ト ロ ールでは、 ウ ィ ン ド ウで表示 さ れる文字数を よ り 正確に定義す る ために、 ま たは参照す る ために Size プ ロパテ ィ を使用で き ます。 デー タ 入力で 承認 さ れる文字数は、 個々のプ ロパテ ィ に よ っ て決ま り ます。 117 ページの 「Field Length」 を参照 し て く だ さ い。 Size プ ロパテ ィ は、 残 り の フ ィ ー ド コ ン ト ロ ールに利用で き ません。 Interactive プ ロパテ ィ プ ロパテ ィ の Interactive グループは、 実行時のア プ リ ケーシ ョ ンのユーザ と コ ン ト ロ ール と の イ ン タ ラ ク テ ィ ブ機能に関す る プ ロパテ ィ です。 FYI メ ッ セージ こ のプ ロパテ ィ は、 実行時に フ ィ ール ド コ ン ト ロ ールに フ ォ ー カ スが移る と 表示 さ れる情報 メ ッ セージ を指定 し ます。 メ ッ セージは、 fyi_message ア プ リ ケーシ ョ ン情報 フ ィ ール ド に表示 さ れます。 Unify NXJ に よ っ て提供 さ れる デ フ ォ ル ト の look & feel 定義で、 fyi_message ア プ リ ケーシ ョ ン情報 フ ィ ール ド は、 フ ッ タ フ レ ームセ ッ ト の左端に表示 さ れます。 FYI メ ッ セージ表示領域 Unify NXJ 開発者ガ イ ド 98 5 カ ス タ ム フ ッ タ や、 ヘ ッ タ 、 ま たは フ ォ ーム上の別の場所に fyi_message ア プ リ ケーシ ョ ン情報 フ ィ ール ド を置 く こ と も で き ます。 122 ページの 「Text Field と Text Area フ ィ ール ド コ ン ト ロ ール」 を参照 し て く だ さ い。 メ ッ セージ テキス ト の最長は、 80 文字です。 ア プ リ ケーシ ョ ン情報 フ ィ ール ド の テキス ト の特性を変更す る こ と はで き ません。 注 – ア プ リ ケーシ ョ ン ユーザに、 フ ィ ール ド レ ベル情報を提供する ために、 ツ ー ルチ ッ プ を使用す る こ と も で き ます。 97 ページの 「ツ ールチ ッ プ」 を参照 し て く だ さ い。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの fyiMessage プ jBiz ロパテ ィ を使用す る こ と で、 実行時に設定す る こ と がで き ます。 詳細 については、 ヘルプ >Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 NXJ フ ォ ームのすべてのテキス ト のよ う に、 fyi_message ア プ リ ケーシ ョ ン情報 フ ィ ール ド のテキス ト は、 ロ ー カ ラ イ ズ可能です。 詳細に関 し ては、 以下の URL を参照 し て く だ さ い。 http://www.unify.com/products/nxj/documentation/supplemental/index.htm. イ ベン ト セ ク シ ョ ンの即時実行 フ ィ ール ド コ ン ト ロ ールがユーザにア ク セ ス さ れるか変更 さ れた場合に、 強制的 に jBiz フ ォ ームス ク リ プ ト 中の フ ィ ール ド レ ベル イ ベ ン ト セ ク シ ョ ン を実行す る には、 こ のチ ェ ッ ク ボ ッ ク ス を設定 し ます。 デ フ ォ ル ト では、 NXJ イ ン タ ラ ク シ ョ ンサーバは一度に 1 つの フ ィ ール ド ではな く 、 一括で フ ィ ール ド レ ベル イ ベ ン ト セ ク シ ョ ン を実行 し ます。 デ フ ォ ル ト では、 フ ィ ール ド コ ン ト ロ ール入力処理は一括で扱われます。 一括処 理す る と 、 ユーザに よ る フ ィ ール ド 間移動 と は異な る順序で フ ィ ール ド イ ベ ン ト セ ク シ ョ ンが実行 さ れる、 ま たは、 フ ィ ール ド に入力 さ れた中間の値が フ ィ ール ド に割 り 当て ら れないな どの問題が発生す る場合があ り ます。 ア プ リ ケーシ ョ ン は、 値が フ ィ ール ド に割 り 当て ら れる順序に依存せず、 そ し て一時的な中間の値 の割 り 当てに依存 し ない限 り 、 一括処理はパ フ ォ ーマ ン ス面で優れています。 実 行時には、 Web ブ ラ ウザ と NXJ イ ン タ ラ ク シ ョ ンサーバ間の各通信は、 パ フ ォ ー マ ン ス上の問題を引き起 こ す原因 と な り ます。 Unify NXJ 開発者ガ イ ド 99 5 Immediate プ ロパテ ィ が設定 さ れてい る場合、 以下の イ ベ ン ト セ ク シ ョ ンが実行 さ れます。 • Text Field コ ン ト ロ ール と Text Area コ ン ト ロ ールでは、 ユーザが フ ォ ー カ ス を他の コ ン ト ロ ールに移動 さ せる と ( コ ン ト ロ ールの値が変更 さ れた と 仮定 する)、 WHEN VALUE CHANGES イ ベ ン ト セ ク シ ョ ン と ON DATA ACCEPT イ ベ ン ト セ ク シ ョ ンが実行 さ れます。 • チ ェ ッ ク ボ ッ ク ス、 ラ ジオグループ、 リ ス ト ボ ッ ク ス と ド ロ ッ プ ダウ ン リ ス ト では、 ユーザが コ ン ト ロ ールの値を変更す る と 、 WHEN VALUE CHANGES イ ベ ン ト セ ク シ ョ ン と ON DATA ACCEPT イ ベ ン ト セ ク シ ョ ンが 実行 さ れます。 フ ィ ール ド レ ベル イ ベ ン ト セ ク シ ョ ンの実行 フ ロ ーについての詳細は、 『Unify NXJ jBiz 言語ガ イ ド 』 の第 5 章の 「次 フ ィ ール ド に移動」、 「前 フ ィ ール ド に移 動」、 「ユーザ入力の処理」 を参照 し て く だ さ い。 Required Required チ ェ ッ ク ボ ッ ク ス を設定する と 、 ユーザは実行時に こ の コ ン ト ロ ールに 値を入力す る必要があ り ます。 通常、 タ ーゲ ッ ト テーブルの更新に必要なすべてのデー タ の収集を確実にす る た めに、 Required プ ロパテ ィ を使用 し ます。 タ ーゲ ッ ト テーブルに関連す る行を追 加す る前に、 ユーザは Required チ ェ ッ ク ボ ッ ク スが設定 さ れてい る すべての コ ン ト ロ ールに値を入力する必要があ り ます。 フ ィ ール ド コ ン ト ロ ールの Required チ ェ ッ ク ボ ッ ク ス を設定する場合、 ユーザに 入力が必要な フ ィ ール ド のデー タ タ イ プ を説明す る ための FYI メ ッ セージ、 あ る いはツ ールチ ッ プ を指定する こ と も で き ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは ク リ アにな っ ています。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの Required プ ロ jBiz パテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 100 5 Stop For Input こ のチ ェ ッ ク ボ ッ ク ス を設定す る と 、 実行時に こ の コ ン ト ロ ールで カ ー ソ ルが止 ま り ます。 こ のチ ェ ッ ク ボ ッ ク スが ク リ アの場合は、 ユーザが フ ォ ームの コ ン ト ロ ールを移動する と き に、 イ ン タ ラ ク シ ョ ンサーバは、 こ の コ ン ト ロ ールを ス キ ッ プ さ せます。 こ の機能に よ り 、 更新や追加に必要な フ ィ ール ド コ ン ト ロ ール だけ を タ ブ で移動で き るので、 ユーザは フ ォ ームに素速 く デー タ を入力で き ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは設定 さ れています。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの stopForInput プ jBiz ロパテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 注 – 各 フ ォ ームにおいて、 少な く と も 1 つの フ ィ ール ド コ ン ト ロ ールの Stop For Input チ ェ ッ ク ボ ッ ク ス を設定 し てお く 必要があ り ます。 設定 さ れていない場合、 NXJ イ ン タ ラ ク シ ョ ンサーバは自動的に次 フ ォ ーム操作を行います。 『Unify NXJ jBiz 言語ガ イ ド 』 の第 5 章 「ア プ リ ケーシ ョ ンの実行」 で 「 フ ィ ール ド 位置」 を 参照 し て く だ さ い。 Updateable こ のチ ェ ッ ク ボ ッ ク ス を設定す る と 、 ユーザは フ ィ ール ド コ ン ト ロ ールの値を編 集 し て更新で き ます。 ク リ アの場合、 フ ィ ール ド コ ン ト ロ ールは表示 さ れて も 編 集で き ません。 こ のプ ロパテ ィ は、 ユーザが タ ーゲ ッ ト テーブルを更新可能であ るかど う かに関 し ては、 作用 し ません。 こ の動作は、 フ ォ ームの Access Control プ ロパテ ィ で管理 さ れます。 65 ページの 「デー タ ベース操作を許可 し ない」 を参照 し て く だ さ い。 こ のチ ェ ッ ク ボ ッ ク スが ク リ ア で、 Stop for Input チ ェ ッ ク ボ ッ ク スが設定 さ れて い る場合、 フ ィ ール ド コ ン ト ロ ールでの停止、 フ ィ ール ド コ ン ト ロ ールの内容を ス ク ロ ール、 他の フ ォ ームにズームで き ますが、 フ ィ ール ド コ ン ト ロ ールの内容 は変更で き ません。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは設定 さ れています。 Unify NXJ 開発者ガ イ ド 101 5 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの Updateable プ ロ jBiz パテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Field-Level Help Help URL プ ロパテ ィ は、 フ ィ ール ド コ ン ト ロ ールに関連する HTML フ ァ イルを 指定 し ます。 こ の HTML フ ァ イルは、 NXJ イ ン タ ラ ク シ ョ ンサーバに よ っ て、 ヘ ルプ コ マ ン ド が実行 さ れる と ( フ ィ ール ド コ ン ト ロ ールが フ ォ ー カ ス を持つ場合) 表示 さ れます。 HTML フ ァ イル名を入力す る には選択 ボ タ ン を使用 し 、 フ ァ イルシ ス テム中の HTML フ ァ イルを指定 し ます。 指定 さ れた HTML フ ァ イルが、 カ レ ン ト プ ロ ジ ェ ク ト の Static Content フ ォ ルダに存在 し ない場合、 その フ ォ ルダに追加 さ れます。 以下のいずれかの方法で、 ア プ リ ケーシ ョ ン ユーザにヘルプ コ マ ン ド を提供す る こ と がで き ます。 • フ ォ ームのボ タ ン にヘルプ コ マ ン ド を関連 さ せ、 ボ タ ンの タ イ ト ルを “ ヘル プ ” に変更するか、 ま たは他の適切な用語に変更する。 • ヘルプ コ マ ン ド にマ ッ プ さ れる ビル ト イ ン ヘルプ ボ タ ンのあ る ア プ リ ケー シ ョ ンの NXJ デ フ ォ ル ト ツ ールバー を含む。 デ フ ォ ル ト では、 HTML フ ァ イルは別々の Web ブ ラ ウザ ウ ィ ン ド ウで表示 さ れま す。 同 じ フ ォ ームの Inline Frame コ ン ト ロ ールに、 HTML フ ァ イルを表示 さ せる よ う にする こ と も で き ます。 こ れを行 う には、 “unifyHelp” と い う 名前の Inline Frame コ ン ト ロ ールを作成 し ます。 例えば、 NXJ チ ュ ー ト リ アルア プ リ ケーシ ョ ンの従 業員情報 フ ォ ームで、 各 フ ィ ール ド の Help URL プ ロパテ ィ に、 フ ォ ームを使用す る方法について記述する HTML フ ァ イルを設定する こ と がで き ます。 Unify NXJ 開発者ガ イ ド 102 5 ヘルプ ボ タ ン HTML フ ァ イルで、ヘルプ情報を含む イ ン ラ イ ン フ レ ーム こ のプ ロパテ ィ は、 実行時に設定す る こ と はで き ませんが、 jBiz を jBiz 使 っ て URL を動的に開 く こ と がで き ます。 NXJSession フ ァ ウ ン デー シ ョ ン ク ラ スの openURL メ ソ ッ ド を参照 し て く だ さ い。 Text Properties Text プ ロパテ ィ と は、 フ ィ ール ド コ ン ト ロ ールの内容の フ ォ ーマ ッ ト や動作に関 連す る プ ロパテ ィ です。 タ ーゲ ッ ト フ ィ ール ド コ ン ト ロ ールの場合は、 フ ィ ール ド コ ン ト ロ ールが表示す る デー タ の フ ォ ーマ ッ ト や動作のプ ロパテ ィ です。 Unify NXJ 開発者ガ イ ド 103 5 Auto Accept こ のチ ェ ッ ク ボ ッ ク ス を設定す る と 、 要求 さ れた長 さ のデー タ が実行時に フ ィ ー ル ド コ ン ト ロ ールに入力 さ れる と 、 NXJ イ ン タ ラ ク シ ョ ンサーバが自動的に次の フ ィ ール ド コ ン ト ロ ールに カ ー ソ ルを移動 し ます。 こ の機能に よ り 、 フ ォ ーム内 の次の フ ィ ール ド に移送する ために、 Tab キーや Next Field コ マ ン ド を使 う 必要が ないため、 ユーザが フ ォ ームにデー タ を素速 く 入力で き ます。 コ ン ト ロ ールに必要な長 さ は、 Field Length プ ロパテ ィ で設定 し ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは ク リ アにな っ ています。 検索モー ド の フ ォ ームでは、 こ のプ ロパテ ィ は無視 さ れます。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの autoAccept プ ロ jBiz パテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Case Conversion こ のプ ロパテ ィ に よ り 、 フ ィ ール ド コ ン ト ロ ールのテキス ト を、 全て大文字ま た は全て小文字に変換するか、 入力状態のま まにす るかを指定 し ます。 こ のプ ロパ テ ィ は、 フ ィ ール ド コ ン ト ロ ールのデー タ タ イ プが文字列の場合にのみ有効です。 こ のプ ロパテ ィ は、 どのよ う なデー タ を タ ーゲ ッ ト テーブルに保存 さ せるか と い う こ と には作用 し ません。 単に、 フ ォ ーム上に どのよ う に表示す るかを指定 し ま す。 ド ロ ッ プ ダウ ン リ ス ト か ら Upper (大文字)、 Lower (小文字)、 None (大文字小文 字変換な し ) のどれかを選択 し ます。 デ フ ォ ル ト では、 caseConversion プ ロパテ ィ は None です。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの caseConversion jBiz プ ロパテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 104 5 Display Format こ の Display Format プ ロパテ ィ は、 NXJ Amount, Float, Date, Time あ る いは DateTime の値に使用 さ れます。 Display Format プ ロパテ ィ は、 値のテ ン プ レ ー ト のよ う な働き を す る特別な文字のパ タ ーン に よ り 構成 さ れます。 こ のパ タ ー ン に は、 ブ ラ ン ク 、 小数点、 通貨記号 と い っ た特別な文字、 あ る いは数字が値の各桁 で どのよ う に印字 さ れるかを指定す る特殊文字が含まれます。 例えば、 12345.67 と い う 値の Amount デー タ を Display Format パ タ ー ン に よ り 、 次のよ う に印字する こ と がで き ます。 $ 12,345.67 表示 フ ォ ーマ ッ ト は、 実際の数値の値には影響はな く 、 単に表示形式を指定 し ま す。 注 – フ ィ ール ド の幅を指定する Size プ ロパテ ィ は、 こ の format パ タ ーン で編集 さ れたデー タ の値が十分表示で き る幅にな っ てい る よ う 注意 し て く だ さ い。 幅は、 フ ォ ーマ ッ ト パ タ ーン に よ り 、 自動的に調整 さ れる こ と はあ り ません。 下記のセ ク シ ョ ン では、 Amount, Float, Date/Time の値の format パ タ ーン について 記述 し ます。 有効なユーザ入力の format パ タ ーン について も 、 各セ ク シ ョ ン で記 述 さ れています。 Numeric 値に、 Display Format プ ロパテ ィ は使用す る こ と がで き ません。 Numeric 値を表示す る場合、 Unify NXJ は、 以下のデ フ ォ ル ト の表示 フ ォ ーマ ッ ト パ タ ーン を使用 し ます。 -###################& パ タ ーン文字は、 表 5-2 に記述 さ れています。 表 5-2 Numeric 値の表示 フ ォ ーマ ッ ト 文字 文字 表示結果 # こ の位置に数字があ る場合は、 その数字が出力 さ れます。 それ以外の場合は、 何 も 出力 さ れません。 & こ の位置に数字があ る場合は、 その数字が出力 さ れます。 それ以外の場合は、 0 (ゼロ) が出力 さ れます。 - 負の値であ る場合、 こ の位置にマ イ ナス記号を出力 し ます。 それ以外の場合は、 何 も 出力 さ れません。 Unify NXJ 開発者ガ イ ド 105 5 以下は、 表示 さ れた Numeric 値の例です。 0 123456 -123456 ユーザが、 実行時に フ ィ ール ド コ ン ト ロ ールに Numeric 値を入力す る場合、 値は マ イ ナス記号、 ま たはプ ラ ス記号を含む こ と がで き、 コ ン マのよ う な区切 り 文字 を含む こ と がで き ます。 検索モー ド で入力 し た値が小数点を含む場合、 小数点よ り 右にあ る数字は無視 さ れます。 add/update/delete モー ド では、 ユーザは小数点の あ る数字を入力す る こ と はで き ません。 注 – 表示 フ ォ ーマ ッ ト は、 特にア プ リ ケーシ ョ ンのロ ー カ ラ イ ズにおいて重要で す。 NXJ ア プ リ ケーシ ョ ンのロ ー カ ラ イ ズに関 し ては、 以下の URL にあ る NXJ ド キ ュ メ ン ト を参照 し て く だ さ い。 http://www.unify.com/products/nxj/documentation/supplemental/index.htm. Amount 値 Amount 値に表示 フ ォ ーマ ッ ト を指定す る場合は、 一般的に、 小数点 (ピ リ オ)、 ま たはグループ区切 り 文字 (カ ン マ) の場所の指定を含みます。 小数点お よ びグ ループ区切 り 文字は、 locale に依存 し ます。 $ 12,345.67 locale が en_US の場合の小数点 locale が en_US の場合のグループ区切 り € 123.456,78 locale が de( ド イ ツ)の場合の小数点 locale が de( ド イ ツ)の場合のグループ区切 り Unify NXJ 開発者ガ イ ド 106 5 以下の表は、 表示 フ ォ ーマ ッ ト のパ タ ーン で指定す る文字を説明 し ています。 表 5-3 Amount 値の表示 フ ォ ーマ ッ ト 文字 文字 表示結果 # こ の位置に数字があ る場合は、 その数字が出力 さ れます。 それ以外の場合は、 ブ ラ ン ク が出力 さ れます。 こ の記号が小数点よ り も 左にあ る場合には、 フ ィ ー ル ド の左部分は、 ブ ラ ン ク がパデ ィ ン グ さ れます。 こ の記号が小数点よ り 右に あ る場合には、 0 (ゼロ) でパデ ィ ン グ さ れます。 & こ の位置に数字があ る場合は、 その数字が出力 さ れます。 それ以外の場合は 0 (ゼロ) が出力 さ れます。 こ の場合は、 右か左が 0 (ゼロ) でパデ ィ ン グ さ れま す。 * こ の位置に数字があ る場合は、 その数字が出力 さ れます。 それ以外の場合は * (ア ス タ リ ス ク ) が出力 さ れます。 値の左側を * (ア ス タ リ ス ク ) でパデ ィ ン グ する場合に使用で き ます。 + 右の端か ら 始めて左に順次移動 し なが ら 、 その桁に数字があれば数字を出力 し 、 数字が無ければ正の値であればプ ラ ス記号、 負の値であればマ イ ナス記号を出 力 し ます。 すでにプ ラ スあ る いはマ イ ナス記号が出力 さ れてい る場合は、 ス ペースが出力 さ れます。 こ の記号は、 パ タ ーンの左端か右端のど ち ら かに表示 さ れます。 両方に表示 さ れる こ と はあ り ません。 - 右の端か ら 始めて左に順次移動 し なが ら 、 その桁に数字があれば数字を出力 し 、 数字が無ければ、 負の値であればマ イ ナス記号を出力 し ます。 すでにマ イ ナス 記号が出力 さ れてい る場合は、 スペースが出力 さ れます。 こ の記号は、 パ タ ー ンの左端か右端のど ち ら かに表示 さ れます。 両方に表示 さ れる こ と はあ り ませ ん。 ( こ の位置に数字があ る場合は、 その数字が出力 さ れます。 数字が負の値であれ ば、 左括弧を出力 し ます。 すでに左括弧が出力 さ れてい る場合は、 スペースが 出力 さ れます。 右括弧 ( ) ) が必ず同 じ フ ォ ーマ ッ ト パ タ ーン で、 使われなけれ ばな り ません。 ) 数字が負の値の場合、 こ の位置に右括弧が出力 さ れます。 左括弧 ( ( ) が必ず同 じ フ ォ ーマ ッ ト パ タ ーン で、 使われなければな り ません。 Unify NXJ 開発者ガ イ ド 107 5 文字 . 表示結果 こ の位置に ロー カ ラ イ ズ さ れた小数点を出力 し ます。 小数点の後の数字の桁数 は、 こ のプ ロ ジ ェ ク ト で有効な Currency Scale プ ロパテ ィ 設定に対応 し てい る必 要があ り ます。 44 ページの 「表示通貨を選択」 を参照 し て く だ さ い。 , 数字が こ の位置よ り 左にあ る場合には、 こ の位置にグループ区切 り 文字を出力 し ます。 それ以外の場合は、 パ タ ーン で使用 さ れる補填文字のア ス タ リ ス ク (*) かスペース (#) が出力 さ れます。 $ 右の端か ら 始めて左に順次移動 し なが ら 、 その桁に数字があれば出力 し 、 数字 が無ければ現地通貨記号を出力 し ます。 すでに通貨記号が出力 さ れてい る場合 は、 スペースが出力 さ れます。 現地通貨記号は、 こ のプ ロ ジ ェ ク ト で有効な Currency Symbol プ ロパテ ィ 設定で 定義 さ れています。 44 ページの 「表示通貨を選択」 を参照 し て く だ さ い。 表示パ タ ー ン では、 負の値を表示す る処理方法を含んでいなければな り ません。 表示パ タ ー ンは、 以下の中の 1 つ を含む必要があ り ます。 + () 表示 さ れる値が表示 フ ォ ーマ ッ ト パ タ ン で指定 さ れてい る よ り も 多い小数点以下 有効桁数を持 っ ていた場合には、 値は丸め ら れて表示 さ れます。 以下のい く つか の例を参照 し て く だ さ い。 以下の表は、 様々な表示 フ ォ ーマ ッ ト が、 どのよ う に入力する値に影響するかを 示 し ます。 表 5-4 Amount 値の表示 フ ォ ーマ ッ ト の例 表示 フ ォ ーマ ッ ト $##,##&.&& (Default display format) 小数点以下 桁数 入力値 表示 2 12345.67 $12,345.67 (&&&&&&.&&) 2 1246.75 001246.75 ($$,$$$.&&) 2 1246.75 $1,246.75 ($$$,$$$.&&) 2 1246.75 _$1,246.75 (***,***.&&) 2 1246.75 **1,246.75 ($##,###.&&) 2 1246.75 $_1,246.75 (##,###.&&) 2 1246.75 _ _1,246.75 注 : _ はブ ラ ン ク を表 し ています。 Unify NXJ 開発者ガ イ ド 108 5 表 5-4 Amount 値の表示 フ ォ ーマ ッ ト の例 表示 フ ォ ーマ ッ ト 小数点以下 桁数 入力値 表示 +##,###.&& 2 1246.75 +_1,246.75 $###,##&.&&+ 2 1246.75 $_ _1,246.75+ (***,*##.&&) 2 234 ****234.00 (**#,###.&&) 2 234 **_ _234.00 (***,###.&&) 2 234 ***_234.00 +##,###.&& 2 234 +_ _ _234.00 $###,##&.&&+ 2 234 $_ _ _234.00+ (****.&&) 2 0 ***0.00 (#.##) 2 0 _ (**.&) 2 0 *0.0 (&) 2 0 0 (###) 2 - 234 (234) (###&.&&) 2 - 1246.75 (1246.75) -##& 2 - 234 -234 -###&.&& 2 - 1246.75 - 1246.76 注 : _ はブ ラ ン ク を表 し ています。 ユーザが実行時に フ ィ ール ド コ ン ト ロ ールに Amount 値を入力 し た場合には、 その 値は、 NXJ イ ン タ ラ ク シ ョ ンサーバに よ っ て以下のよ う に解釈 さ れます。 • 小数点は 1 つだけ許 さ れ、 値の内部ス ト レ ージに保存 さ れます。 実行時に入力 さ れた小数点以下桁数が、 ア プ リ ケーシ ョ ンの有効桁数よ り 多 い場合には、 値は丸め ら れます。 • 値が、 括弧で囲まれてい るか、 マ イ ナス記号 (-) がついてい る場合には、 負 の値 と し て保存 さ れます。 • 括弧は正 し く 対応 し てお り 、 数値の最初 と 最後に配置 さ れていなければな り ません。 例: (12) • 値に括弧が含まれてい る場合は、 プ ラ ス (+) あ る いはマ イ ナス記号 (-) が同時 に含まれていてはいけません。 Unify NXJ 開発者ガ イ ド 109 5 Float 値 Float 値に表示 フ ォ ーマ ッ ト を指定す る場合は、 一般的に、 小数点 (ピ リ オ ド )、 ま たはグループ区切 り 文字 (カ ン マ) の場所の指定を含みます。 小数点お よ びグ ループ区切 り 文字は、 locale に依存 し ます。 12,345.678 locale が en_US の場合の小数点 locale が en_US の場合のグループ区切 り 123.456,789 locale が de( ド イ ツ)の場合の小数点 locale が de( ド イ ツ)の場合のグループ区切 り 以下の表は、 表示 フ ォ ーマ ッ ト のパ タ ーン で指定す る文字を説明 し ています。 表 5-5 Float 値の表示 フ ォ ーマ ッ ト 文字 文字 表示結果 # こ の位置に数字があれば、 その数字が出力 さ れます。 数字が意味の無い 0 (ゼ ロ) の場合は出力 し ません。 & or 0 こ の位置に数字があれば、 その数字が出力 さ れます。 それ以外の場合は、 0 (ゼ ロ) を出力 し ます。 こ の場合は、 フ ィ ール ド の右か左が 0 (ゼロ) でパデ ィ ン グ さ れます。 + 正の値の場合は、 プ ラ ス記号が出力 さ れます。 - 負の値の場合は、 マ イ ナス記号が出力 さ れます。 マ イ ナス記号は、 複合表示パ タ ーンの負数向け フ ォ ーマ ッ ト にのみ許 さ れています。 こ の表の後ろ にあ る、 セ ミ コ ロ ン入力 ( : ) を参照 し て く だ さ い。 ( こ の位置に数字があれば、 その数字が出力 さ れます。 負の値であれば、 左括弧 を出力 し ます。 すでに左括弧が出力 さ れてい る場合は、 スペースが出力 さ れま す。 右括弧 ( ) ) が必ず同 じ フ ォ ーマ ッ ト パ タ ーン で使われなければな り ません。 括弧は、 複合表示パ タ ーンの負の値向け フ ォ ーマ ッ ト にのみ許 さ れています。 こ の表の後ろ にあ る、 セ ミ コ ロ ン入力 ( : ) を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 110 5 文字 表示結果 ) 負の値のであれば、 こ の位置に右括弧が出力 さ れます。 左括弧 ( ( ) が必ず同 じ フ ォ ーマ ッ ト パ タ ーン で使われなければな り ません。 括弧は、 複合表示パ タ ーンの負の値向け フ ォ ーマ ッ ト にのみ許 さ れています。 こ の表の後ろ にあ る、 セ ミ コ ロ ン入力 ( : ) を参照 し て く だ さ い。 . こ の位置に ロー カ ラ イ ズ さ れた小数点を出力 し ます。 , 数値が こ の位置よ り 左にあれば、 こ の位置にグループ区切 り 文字を出力 し ます。 それ以外の場合は、 なに も 出力 し ません。 グループ区切 り 文字は、 パ タ ーンの 自由な場所に配置で き ますが、 グループ区切 り 文字 と 文字の間の桁数は、 パ タ ーン内で一定で なければな り ません。 グループ区切 り は一般的には 3 桁ご と ですが、 2 桁ご と に入れる国 も あ り ます。 例: #,####.## 4 桁に よ る グループ #,##.## 2 桁に よ る グループ #,###.## 3 桁に よ る グループ グループ区切 り と し て使われる文字は、 現在の locale に よ っ て定義 さ れます。 ; 二種類の表示 フ ォ ーマ ッ ト を分離 し ます。 最初の も のは正の値向けに、 二番目 が負の値向けの フ ォ ーマ ッ ト です。 プ ラ ス記号は、 正の値のパ タ ーン にのみ指 定 さ れる も のです。 同様にマ イ ナス記号、 括弧は負の値のパ タ ーン にのみ指定 さ れる も のです。 負の値のパ タ ーンは、 オプ シ ョ ン です。 表示 フ ォ ーマ ッ ト は、 サ イ ン に関連 し た文字以外は、 同一であ る必要があ り ま す。 つま り 、 '+' を除いた正数用パ タ ーン と '-', '(', あ る いは ')' を除いた負数用パ タ ーンは同 じ にな り ます。 正数用パ タ ーンのみが与え ら れてい る場合には、 負数はロー カルのマ イ ナス記 号が前につ く こ と にな り ます。 つま り 、 "&.&" は、 "&.&;-&.&" と 同 じ にな り ま す。 負の値用表示 フ ォ ーマ ッ ト では、 以下の速記文字を指定で き ます。 -# 前につけ る マ イ ナス記号以外は、 正の値用のパ タ ーン と 同 じ #後ろ につけ る マ イ ナス記号以外は、 正の値用のパ タ ーン と 同 じ (#) 負の値を囲む括弧以外は、 正の値用のパ タ ーン と 同 じ Amount 値 と は違 っ て、 Float 値のパ タ ーンは、 負の値を表示す る ための指定が必 ず し も 必要あ り ません。 表示す る値が負の値の可能性があ る場合は、 マ イ ナス記 号のよ う な負の値を識別で き る よ う な表示 フ ォ ーマ ッ ト を指定す る よ う に し ます。 それ以外の場合では、 値は正数で表示 さ れます。 Unify NXJ 開発者ガ イ ド 111 5 表示 さ れる値が、 表示 フ ォ ーマ ッ ト パ タ ー ン で指定 さ れてい る よ り も 多い小数点 以下有効桁数を持 っ ていた場合には、 値は丸め ら れて表示 さ れます。 以下のい く つかの例を参照 し て く だ さ い。 以下の表は、 各種の表示 フ ォ ーマ ッ ト がいかに入力値に影響す るかを示 し ていま す。 表 5-6 Float 値の表示 フ ォ ーマ ッ ト の例 表示 フ ォ ーマ ッ ト Input Value Displays As ###,###,##0.### (Float 値のデ フ ォル ト の デ ィ ス プ レ イ フ ォ ーマ ッ ト ) 123,456.789 123,456.789 ###,###.###### 123.7236 123.7236 -123.7236 -123.7236 123,456.789 123,456.789 123.7263 123.73 -123.7263 -123.73 123.7236 123.72 -123.7236 (123.72) 123.7236 000,123.7236000 -123.7236 (000,123.7236000) 000.00 000.00;(000.00) 000,000.0000000;(000,000.0000000) 123,456.789 123,456.7890000 123.7236 123.724 -123.7236 (123.724) (###) 12 12 000.00+;000.00- 123.72 123.72+ -123.72 123.72- 123.72 +123.72 -123.72 -123.72 #,###.###;(#,###.###) +000.00;-000.00 #,##0.0;-# #,##0.;-# #,##0 123.7 123.7 -123.7 -123.7 123.7236 124. -123.7236 -124. 123.7236 124 -123.7236 -124 Unify NXJ 開発者ガ イ ド 112 5 デー タ ベースのデー タ タ イ プが、 NXJ Float 値 と 同等の場合の詳細に関 し ては、 『Unify NXJ jBiz 言語ガ イ ド 』 の付録 A を参照 し て下 さ い。 ユーザが実行時に、 フ ィ ール ド コ ン ト ロ ールに Float 値を入力 し た場合には、 その 値は、 NXJ イ ン タ ラ ク シ ョ ンサーバに よ っ て以下のよ う に解釈 さ れます。 • グループ区切 り は無視 さ れます。 • 小数点はひ と つだけ許 さ れ、 値の内部ス ト レ ージに保存 さ れます。 • 値が括弧で囲まれてい るか、 マ イ ナス記号 (-) がついてい る場合には、 負の 値 と し て保存 さ れます。 • 括弧は正 し く 対応 し てお り 、 値の最初 と 最後に配置 さ れていなければな り ま せん。 例: (12) • 値に括弧が含まれてい る場合は、 プ ラ ス (+) あ る いはマ イ ナス (-) 記号が同時 に含まれていてはいけません。 Date、 Time、 DateTime 表示 フ ォ ーマ ッ ト 日付、 時刻、 日時の値を表示を フ ォ ーマ ッ ト する には、 全体を どのよ う に分けて 表示するかを指定する特別な文字を使 っ て表示パ タ ーン を指定 し ます。 以下の表は、 フ ォ ーマ ッ ト パ タ ーン に指定 さ れる特別な文字を説明 し ています。 日 付デー タ あ る いは日時デー タ の日付部分の フ ォ ーマ ッ ト には、 Date 文字が使用 さ れ、 時刻デー タ には、 Time 文字が使用 さ れます。 Unify NXJ 開発者ガ イ ド 113 5 表 5-7 日付および時刻の フ ォ ーマ ッ ト パ タ ーン文字 デー タ タ イプ 文字 表示結果 例 Date y 年、 2 桁あ る いは 4 桁表示 2 桁年 : 96 4 桁年 :1996 M 月、 テキス ト あ る いは数値 1 数値、 シ ョ ー ト 表示 : 7 数値、 ロ ン グ表示 : 07 テキス ト 、 シ ョ ー ト 表示 : Sep テキス ト 、 ロ ン グ表示 : September E 曜日を テキス ト で表示 シ ョ ー ト 表示 : Wed ロ ン グ表示 : Wednesday d 日に ち を数値で表示 シ ョ ー ト 表示 : 9 ロ ン グ表示 : 09 h 1 か ら 12 で表 さ れる時間 シ ョ ー ト 表示 : 2 ロ ン グ表示 : 02 H 0 か ら 23 で表 さ れる時間 シ ョ ー ト 表示 : 2 ロ ン グ表示 : 02 m 数値で表 さ れる分 シ ョ ー ト 表示 : 3 ロ ン グ表示 : 03 s 数値で表 さ れる秒 シ ョ ー ト 表示 : 5 ロ ン グ表示 : 05 S 数値で表 さ れる ミ リ 秒 シ ョ ー ト 表示 : 9 ロ ン グ表示 : 90, 978 a テキス ト で表す am/pm マー ク . AM PM Time z テキス ト で表す タ イ ムゾーン シ ョ ー ト 表示 : PST ロ ン グ表示 : 太平洋標準時 Date あるい は Time ‘text’ シ ン グル引用符内のテキス ト は、 出力時にそのま ま文字で表 示 さ れる。 引用符を出力に含め たい場合は、 シ ン グル引用符を 2 つ使います。 ‘Start Time is : ’ ‘Winner’’s Time is : ’ @ 将来の利用する ために予約 . Time 1 ‘M” 文字については、 表に続 く 情報を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 114 5 注 – フ ォ ーマ ッ ト パ タ ーン に使われる文字で、 a か ら z お よ び A か ら Z の範囲に 入 っ ていない文字は引用文字 と し て扱われます。 例えば、 : ( コ ロ ン)、 . (ピ リ オ ド )、 / (ス ラ ッ シ ュ ) な どは、 それ ら がた と え シ ン グル引用符で囲まれていな く て も 、 フ ォ ーマ ッ ト テキス ト と し て表示 さ れます。 パ タ ーン内の記号文字の文字数が、 情報を シ ョ ー ト 表示にするか、 ロ ン グ表示にす るかを決定 し ます。 例えば、 "zz" のパ タ ーン であれば、 "PDT" と 表示す る こ と にな り ます。 ま た、 "zzzz" のパ タ ーンは、 "Pacific Daylight Time" にな り ます。 以下に、 その動作を説明 し ます。 • テキス ト 表示の場合には、 3 文字ま で で指定 し たのであれば、 省略形の シ ョ ー ト 表示にな り 、 4 文字以上を指定 し たのであれば、 フ ルのロ ン グ表示 にな り ます。 • 数値の場合には、 表示 さ れる最小の桁数を表示 し ます。 それよ り 桁が短い場 合は、 ゼロ でパデ ィ ン グ し ます (年の場合は、 ’y’ を 2 個指定する と 、 2 桁に 切 ら れて表示 さ れます)。 • 月を指定す る ‘M’ の場合は、 シ ョ ー ト 数値表示の場合は 1 文字で、 ロ ン グ数 値表示は 2 文字で、 シ ョ ー ト テキス ト 表示は 3 文字で、 ロ ン グ テキス ト 表示 は 4 文字で指定 し ます。 月のシ ョ ー ト テキス ト 表示では、 ロ ン グ テキス ト 表示の最初の 3 文字が表示 さ れます。 例えば、 ‘Nov’ はシ ョ ー と 表示で、 “November’ はロ ン グ表示にな り ます。 パ タ ーン内で指定 さ れた特別文字は、 パ タ ー ン内のほかの部分では使 う こ と がで き ません。 例えば、 分用の文字は "hh:mm:ss a mm" のよ う に、 繰 り 返 し ては使え ま せん。 加え て、 以下のよ う な相互に矛盾する オ プ シ ョ ンは、 同一の フ ォ ーマ ッ ト ス ト リ ン グの中では使え ません。 ‘H’ と ‘h’ ‘H’ と ‘a’ 年のシ ョ ー ト 表示を使 っ た フ ォ ーマ ッ ト パ タ ーン を適用す る場合には、 どのよ う に世紀を計算 し て、 どの様にシ ョ ー ト 表示を適用す るかを考慮 し なければな り ま せん。 デ フ ォ ル ト では、 2 桁の年は、 内部的には、 次の様に 4 桁の年に変換 さ れま す。 2 桁の年は、 1970 年か ら 2069 年の 100 年間に入 っ てい る も の と 仮定 さ れて います。従 っ て、‘60’ は ‘2060’ 年 と みな さ れ、‘70’ は ‘1970’ 年 と みな さ れます。 Unify NXJ 開発者ガ イ ド 115 5 こ の範囲が、 該当のア プ リ ケーシ ョ ン に と っ て適切で ない場合には、 4 桁年を使用 するか、 世紀を計算する ために Unify NXJ が使用す る 100 年の範囲を変更 し ます。 100 年の範囲の変更は、 フ ォ ームス ク リ プ ト に例えば以下のよ う にス ク リ プ ト を追 加を し ます。 BEFORE APPLICATION { session.centuryCutoff = "1950"; } こ のでの 4 桁年の指定は、 2 桁年が入 っ てい る と みな さ れる 100 年のス タ ー ト の年 を示 し ています。 例えば、 1960 と 指定を すれば、 入力 さ れた 2 桁年は、 1960-2059 の範囲に入 っ てい る も の と みな さ れます。 従 っ て、 ユーザが ‘22’ と 入力を すれば、 2022 年 と 解釈 さ れます。 こ こ での変更は、 ア プ リ ケーシ ョ ン内のすべての フ ォ ー ムに適用 さ れます。 すべての日付 と 時刻の値の表示は、 現在の locale に よ っ て決定 さ れます。 以下の 例は en_US の locale を使用 し ています。 表 5-8 日付時刻の表示 フ ォ ーマ ッ ト の例 表示 フ ォ ーマ ッ ト 入力値 表示内容 MM/dd/yyyy (日付のデ フ ォル ト ) July 10, 1996 at this time: 15:08:56.09 07/10/1996 HH:mm (Default for Time) 15:08 MM/dd/yyyy HH:mm:ss.S (日付時刻のデ フ ォル ト ) 07/10/1996 15:08:56.09 "yyyy.MM.dd 'at' HH:mm:ss.SS z" 1996.07.10 at 15:08:56.09 PDT "EEE, MMM d, ''yy" Wed, Jul 10, '96 "h:mm a" 3:08 PM "hh 'o''clock' a, zzzz" 03 o'clock PM, Pacific Daylight Time "h:mm a, z" 3:08 PM, PST "yyyyy.MMMMM.dd hh:mm aaa" 1996.July.10 3:08 PM Unify NXJ 開発者ガ イ ド 116 5 NXJSession プ ロパテ ィ の dateFormat, timeFormat, dateTimeFormat を使 う jBiz と 、 すべてのア プ リ ケーシ ョ ンの表示 フ ォ ーマ ッ ト の設定を行 う こ と がで き ます。 NXJNullableField イ ン タ フ ェ ースの displayFormat プ ロパ テ ィ を使 う と 、 個別の フ ィ ール ド の表示 フ ォ ーマ ッ ト を設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て Javadoc を参照 し て く だ さ い。 Date, Time, あ る いは DateTime フ ィ ール ド への入力に有効な フ ォ ーマ ッ ト は、 表 5-8 でデ フ ォ ル ト フ ォ ーマ ッ ト と し て示 さ れた も のです。 Display Justify こ のプ ロパテ ィ は、 コ ン ト ロ ールに表示 さ れる値を ウ ィ ン ド ウ内で位置揃えす る 方法を指定 し ます。 こ の フ ィ ール ド で適用 さ れる値は、 Left (左揃え)、 Right (右 揃え)、 Center (中央揃え) です。 デ フ ォ ル ト では、 Display Justify プ ロパテ ィ は左揃えに設定 さ れています。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの displayJustify jBiz プ ロパテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Field Length こ のプ ロパテ ィ は、 入力時に受け付け る文字数を指定 し ます。 ユーザが指定文字 数を超え て入力 し よ う と する と 、 エ ラ ー メ ッ セージが表示 さ れます。 こ の フ ィ ール ド コ ン ト ロ ールが タ ーゲ ッ ト フ ィ ール ド の場合、 Field Length プ ロパ テ ィ は、 タ ーゲ ッ ト フ ィ ール ド のサ イ ズ (Db Length プ ロパテ ィ ) に基づいて自動 的に設定 さ れます。 こ の値を上書 き入力 し て、 入力可能な文字数を変更で き ます。 関連付け ら れた タ ーゲ ッ ト テーブル列の長 さ を超え る値を指定す る と 、 タ ーゲ ッ ト テーブル列に 収ま ら ない場合は実行時エ ラ ーが表示 さ れます。 デ フ ォ ル ト では、 非 タ ーゲ ッ ト フ ィ ール ド コ ン ト ロ ールの長 さ は 100 です。 Unify NXJ 開発者ガ イ ド 117 5 こ のプ ロパテ ィ は、 jBiz ス ク リ プ ト では読み取 り 専用です。 jBiz NXJ NullableField イ ン タ フ ェ ースの fieldLength プ ロパテ ィ で接続 し ま す。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Password こ のチ ェ ッ ク ボ ッ ク ス を設定す る と 、 フ ィ ール ド コ ン ト ロ ールは内容を表示 し ま せん。 ユーザがパスワー ド を入力す る フ ィ ール ド コ ン ト ロ ールや機密デー タ な ど に使用 し ます。 デ フ ォ ル ト では、 こ のチ ェ ッ ク ボ ッ ク スは ク リ アにな っ ています。 こ のプ ロパテ ィ は、 NXJNullableField イ ン タ フ ェ ースの Password プ ロ jBiz パテ ィ を使 っ て実行時に設定で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Database プ ロパテ ィ Database プ ロパテ ィ グループ と は、 フ ィ ール ド コ ン ト ロ ールのデー タ ベース操作 に関連する プ ロパテ ィ で、 タ ーゲ ッ ト フ ィ ール ド コ ン ト ロ ールだけに適用 さ れる プ ロパテ ィ です。 自動検索操作の指定 コ ン ト ロ ールの Auto Find チ ェ ッ ク ボ ッ ク ス を設定 し て、 ユーザが フ ォ ームやデー タ ビ ュ ーにア ク セ スする と 、 自動的に検索が実行 さ れる よ う に設定で き ます。 検索操作の検索条件は Sql Optional Condition プ ロパテ ィ で指定 し ます。 こ のプ ロパテ ィ は、 NXJForm や NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ jBiz スの autoFind プ ロパテ ィ を使 っ て実行時に設定で き ます。 詳細につい ては、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 118 5 Control Data Type 各 フ ィ ール ド コ ン ト ロ ールは、 Data Type プ ロパテ ィ でデー タ タ イ プ を指定で き ま す。 デー タ タ イ プは、 例えば、 計算中の値を内部で どのよ う に扱 う かを指定す る ために使用 し ます。 デー タ の表示は、 Display Format プ ロパテ ィ で管理 さ れます。 Unify NXJ は、 以下のデー タ タ イ プがあ り ます。 Amount Binary Bool Date DateTime Float Numeric RowID String Text Time タ ーゲ ッ ト フ ィ ール ド の場合、 デー タ タ イ プ フ ィ ール ド は タ ーゲ ッ ト テーブル列 のデー タ タ イ プが割 り 当て ら れます。 デー タ タ イ プは、 互換性のあ る デー タ タ イ プ に変更す る こ と がで き ます。 各デー タ ベースベ ン ダーのデ フ ォ ル ト デー タ タ イ プ マ ッ ピ ン グの詳細については、 『Unify NXJ jBiz 言語ガ イ ド 』 の 「付録 A: デー タ タ イ プ マ ッ ピ ン グ」 を参照 し て く だ さ い。 互換性のあ る デー タ タ イ プ に関 し ては、 以下の URL にあ る NXJ ド キ ュ メ ン ト を参照 し て く だ さ い。 http://www.unify.com/products/nxj/documentation/supplemental/index.htm. こ のプ ロパテ ィ は、 NXJNullable フ ァ ウ ン デーシ ョ ン ク ラ スの dataType jBiz プ ロパテ ィ を使 っ て実行時に読み取 ら れる こ と がで き ます。 詳細につ いては、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Database Column Length Db Length プ ロパテ ィ は、 関連付け ら れたデー タ ベース列の長 さ を表 し ます。 こ の プ ロパテ ィ は読み取 り 専用です。 Unify NXJ 開発者ガ イ ド 119 5 Database Column Type こ のプ ロパテ ィ では、 関連付け ら れたデー タ ベース列のデー タ タ イ プ を指定 し ま す。 こ のプ ロパテ ィ は読み取 り 専用です。 Target Field フ ィ ール ド コ ン ト ロ ールが タ ーゲ ッ ト テーブルの列にマ ッ プ さ れるかど う かを指 定 し ます。 デ フ ォ ル ト では、 Target Field プ ロパテ ィ は <none> に設定 さ れています。 非 タ ー ゲ ッ ト フ ィ ール ド コ ン ト ロ ールを タ ーゲ ッ ト フ ィ ール ド に変更す る には、 ド ロ ッ プ ダウ ン リ ス ト か ら デー タ ベースの列名を選択 し ます。 列名の リ ス ト には、 フ ォ ームの Target Table プ ロパテ ィ で指定 さ れてい る、 現在の タ ーゲ ッ ト テーブル の列名が使用 さ れています。 タ ーゲ ッ ト の列を変更する と 、 フ ィ ール ド コ ン ト ロ ール名 も 変更 さ れます。 121 ページの 「Name」 を参照 し て く だ さ い。 こ のプ ロパテ ィ は、 jBiz ス ク リ プ ト では読み取 り 専用です。 jBiz NXJNullableVariable イ ン タ フ ェ ースの targetField プ ロパテ ィ で利用で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を 参照 し て く だ さ い。 General プ ロパテ ィ プ ロパテ ィ の General グループは、 すべての コ ン ト ロ ールに適用 さ れます。 Data Type 値 フ ィ ール ド には、 その フ ィ ール ド コ ン ト ロ ールのデー タ タ イ プの ド ロ ッ プ ダウ ン リ ス ト があ り 、 Amount、 Binary、 Bool、 Date、 DateTime、 Float、 Numeric、 RowID、 String、 Text、 Time が用意 さ れています。 デ フ ォ ル ト のデー タ タ イ プは、 String です。 選択する デー タ タ イ プは、 タ ーゲ ッ ト フ ィ ール ド (あ る場合) と の互換性が必要 です。 Unify NXJ 開発者ガ イ ド 120 5 jBiz こ のプ ロパテ ィ は、 NXJForm や NXJDataView フ ァ ウ ン デーシ ョ ン ク ラ スの dataType プ ロパテ ィ を使 っ て実行時に設定で き ます。 詳細につい ては、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 MultiValued こ のチ ェ ッ ク ボ ッ ク スは、 フ ィ ール ド コ ン ト ロ ールに選択セ ッ ト の各レ コ ー ド に 個別の値があ るかど う かを示 し ます。 設定 さ れてい る場合は、 実行時に選択セ ッ ト の各レ コ ー ド (行) に個別の値が表示 さ れます。 タ ーゲ ッ ト フ ィ ール ド を定義 し てい る場合は、 MultiValued チ ェ ッ ク ボ ッ ク スが自 動的に設定 さ れてお り 、 変更で き ません。 タ ーゲ ッ ト フ ィ ール ド は、 常に MultiValued です。 非 タ ーゲ ッ ト フ ィ ール ド は、 通常、 計算の結果やデー タ ベースル ッ ク ア ッ プの結 果を表示す る ために使用 さ れます。 MultiValued チ ェ ッ ク ボ ッ ク ス を設定にする と 、 計算やル ッ ク ア ッ プが 1 度だけ実行で き、 その結果は選択セ ッ ト に保存 さ れます。 MultiValued チ ェ ッ ク ボ ッ ク ス を ク リ アにする と 、 フ ィ ール ド の値は フ ォ ームに関 連付け ら れ、 選択セ ッ ト の現在の行にかかわ り な く 常に同 じ 値が表示 さ れます。 例 えば、 選択セ ッ ト が注文書の項目 リ ス ト の場合、 注文合計は複数値にな り ません。 どの項目を選択 し て も 合計は同 じ にな るか ら です。 非 タ ーゲ ッ ト フ ィ ール ド は、 デ フ ォ ル ト で チ ェ ッ ク ボ ッ ク スは ク リ ア です。 こ のプ ロパテ ィ は、 jBiz ス ク リ プ ト では読み取 り 専用です。 jBiz NXJNullableVariable イ ン タ フ ェ ースの multiValued プ ロパテ ィ で利用で き ます。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を 参照 し て く だ さ い。 Name コ ン ト ロ ールの名前は、 コ ン ト ロ ール作成時に NXJ デザ イ ン セ ン タ か ら 最初に割 り 当て ら れます。 フ ィ ール ド コ ン ト ロ ールが タ ーゲ ッ ト フ ィ ール ド の場合、 Name プ ロパテ ィ は Target Field プ ロパテ ィ の値に設定 さ れます。 コ ン ト ロ ールの名前は新 し い値を入力する と 変更で き ますが、 フ ィ ール ド コ ン ト ロ ールに タ ーゲ ッ ト フ ィ ール ド があれば、 フ ィ ール ド コ ン ト ロ ール名は タ ーゲ ッ ト フ ィ ール ド 名 と 一致 し てい る必要があ り ます。 120 ページの 「Target Field」 を参 照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 121 5 こ のプ ロパテ ィ は、 jBiz ス ク リ プ ト では読み取 り 専用です。 jBiz NXJNullableVariable イ ン タ フ ェ ースの Name プ ロパテ ィ で利用で き ま す。 詳細については、 ヘルプ > Javadoc を選択 し て jBiz Javadoc を参照 し て く だ さ い。 Text Field と Text Area フ ィ ール ド コ ン ト ロール テキス ト フ ィ ール ド コ ン ト ロ ールは、 1 行のテキス ト です。 フ ォ ームでデ フ ォ ル ト の フ ィ ール ド コ ン ト ロ ールを作成す る と 、 テキス ト フ ィ ール ド コ ン ト ロ ール と し て作成 さ れます。 Text Area コ ン ト ロ ールはテキス ト フ ィ ール ド コ ン ト ロ ールが複数行にな っ た も の で、 ス ク ロ ール バー付き で表示 さ れます。 テキス ト コ ン ト ロール Text Area コ ン ト ロール Text Field と Text Area には、 前のセ ク シ ョ ン で記述 さ れたすべての Field Control プ ロパテ ィ があ り 、 Text Area コ ン ト ロ ールには、 さ ら に以下のプ ロパテ ィ も 適用 さ れます。 Rows : 行数。 デ フ ォ ル ト は 10 行です。 Columns : 列数。 デ フ ォ ル ト は 6 列です。 こ れ ら のプ ロパテ ィ は、 TEXT グループにあ り ます。 Unify NXJ 開発者ガ イ ド 122 5 テキス ト フ ィ ール ド コ ン ト ロ ールま たは Text Area フ ィ ール ド コ ン ト ロ ールは、 89 ページの 「 コ ン ト ロ ールの作成」 で説明 さ れてい る コ ン ト ロ ールの作成ス テ ッ プ に従 っ て作成 し ます。 ア プ リ ケーシ ョ ン 情報フ ィ ール ド テキス ト フ ィ ール ド を Unify NXJ ア プ リ ケーシ ョ ン情報 フ ィ ール ド と し て使用す る こ と がで き ます。 ア プ リ ケーシ ョ ン情報 フ ィ ール ド には、 ア プ リ ケーシ ョ ンの 状態に関す る情報を表示 し ます。 NXJ イ ン タ ラ ク シ ョ ンサーバは、 ア プ リ ケー シ ョ ン実行中の メ ッ セージ で ア プ リ ケーシ ョ ン情報 フ ィ ール ド を自動的に更新 し ます。 ア プ リ ケーシ ョ ン情報 フ ィ ール ド は、 デ フ ォ ル ト の NXJ ツ ールバー、 フ ッ タ 、 ヘ ッ ダに含まれます。 こ れ ら の コ ン ポーネ ン ト を含ま ないア プ リ ケーシ ョ ン で、 ア プ リ ケーシ ョ ン情報 フ ィ ール ド を フ ォ ーム上に表示する必要があ る場合、 表 5-9 に示 さ れる よ う に、 表示 し たいア プ リ ケーシ ョ ン情報 フ ィ ール ド と 同 じ 名 称で dynamic text ま たは Text Field を作成 し ます。 Unify NXJ 開発者ガ イ ド 123 5 表 5-9 は、 ア プ リ ケーシ ョ ン情報 フ ィ ール ド の要約です。 表 5-9 ア プ リ ケーシ ョ ン情報 フ ィ ール ド ( 1 / 2 ) ア プ リ ケーシ ョ ン 情報 フ ィ ール ド 名 表示内容 form_mode 現在の フ ォ ームま たはデー タ ビ ュ ーの フ ォ ームモー ド 。 Unify NXJ は、 add/update/delete ま たは find の 2 つのモー ド があ り ま す。 fyi_message 現在の フ ィ ール ド コ ン ト ロールの fyiMessage プ ロパテ ィ の値。 record_action カ レ ン ト ま たは一番最後のデー タ ベース操作の状態。 "adding" は、 NXJ イ ン タ ラ ク シ ョ ンサーバがデー タ ベースの行 と し て、 カ レ ン ト レ コ ー ド を追加処理中であ る こ と を示 し ま す。 "added" は、 NXJ イ ン タ ラ ク シ ョ ンサーバがデー タ ベースの行 と し て、 カ レ ン ト レ コ ー ド を追加 し た こ と を示 し ます。 record_state ア プ リ ケーシ ョ ン情報 フ ィ ール ド には、 "stored" と 表示 さ れます。 "updating" は、 NXJ イ ン タ ラ ク シ ョ ンサーバが カ レ ン ト レ コ ー ド に関連するデー タ ベースの行を、 更新中であ る こ と を示 し ま す。 "updated" は、 NXJ イ ン タ ラ ク シ ョ ンサーバが カ レ ン ト レ コ ー ド に関連するデー タ ベースの行を更新 し た こ と を示 し ます。 record_state フ ィ ール ド には、 "stored" と 表示 さ れます。 "deleting" は、 NXJ イ ン タ ラ ク シ ョ ンサーバがデー タ ベースか ら カ レ ン ト レ コ ー ド を削除中であ る こ と を示 し ます。 "deleted" は、 NXJ イ ン タ ラ ク シ ョ ンサーバがデー タ ベースか ら カ レ ン ト レ コ ー ド を削除 し た こ と を示 し ます。 record_count フ ォ ームに関連付け ら れた選択セ ッ ト の現在のレ コ ー ド の数を 示 し ます。 実行時に、 フ ィ ール ド には " of x" と 表示 さ れ x は選 択セ ッ ト のレ コ ー ド 数を表表 し ます。 例えば、 選択セ ッ ト に 7 つのレ コ ー ド があ る場合、 record_count には "of 7" と 表示 さ れ ます。 record_number カ レ ン ト レ コ ー ド の選択セ ッ ト 中の番号を示 し ます。 数字は、 選択セ ッ ト 中のレ コ ー ド の相対位置を示 し ます。 例えば、 選択 セ ッ ト に 5 つ レ コ ー ド があ る場合、 2 つ目のレ コ ー ド の record_number は 2 と な り ます。 Unify NXJ 開発者ガ イ ド 124 5 表 5-9 ア プ リ ケーシ ョ ン情報 フ ィ ール ド ( 2 / 2 ) ア プ リ ケーシ ョ ン 情報 フ ィ ール ド 名 表示内容 record_state フ ォ ーム上の フ ィ ール ド コ ン ト ロールに現在表示 さ れるデー タ の状態を示 し ます。 "not stored" は、 デー タ がデー タ ベースにま だ格納 さ れていない こ と を示 し ます。 "stored" は、 デー タ がデー タ ベース行 と 一致 し てい る こ と を示 し ます。 "stored/modified" は、 デー タ がデー タ ベース行か ら 取得 さ れ、 こ の フ ォ ーム上で変更 さ れてい る こ と を示 し ます。 変更 さ れた デー タ は、 ま だ保存 さ れていません。 "not stored/modified" は、 clear-to-add 操作後にデー タ が変更 さ れ てお り 、 デー タ がデー タ ベースにま だ格納 さ れていない こ と を 示 し ます。 zoom_indicator 現在の フ ィ ール ド コ ン ト ロールで、 ズームが可能かど う かを示 し ます。 現在の フ ォ ーム フ ィ ール ド は、 カ ー ソ ルが現在置かれ てい る フ ィ ール ド を表 し ます。 フ ィ ール ド コ ン ト ロールがズー ム可能であ る場合、 ユーザは フ ィ ール ド か ら ズーム フ ォ ームに 移動する こ と がで き ます。 "zoom" は、 ズーム コ マ ン ド を実行する こ と で、 カ レ ン ト フ ィ ール ド か ら ズーム フ ォ ームに移動で き る こ と を示 し ます。 こ の フ ィ ール ド がブ ラ ン ク の場合、 現在の フ ィ ール ド か ら 利用 可能なズーム フ ォ ームは存在 し ない こ と を示 し ます。 こ の場 合、 ズーム コ マ ン ド は使用で き ません。 Checkbox コ ン ト ロール チ ェ ッ ク ボ ッ ク ス コ ン ト ロ ールは、 チ ェ ッ クボッ クス デー タ 値の説明にな っ ています。 値そ をク リア の も のを表示する テキス ト フ ィ ール ド チ ェ ッ クボッ クス コ ン ト ロ ール と は違 っ て、 チ ェ ッ ク を設定 ボ ッ ク スが設定か ク リ アかの状態で値 ラ ベル が決定 さ れます。 実行時に、 ユーザは チ ェ ッ ク ボ ッ ク ス を設定に し た り 、 ク リ ア し た り する こ と はで き ます。 あ る いは、 読み取 り 専用に し て情報を表示す る ためだけに使用す る こ と も で き ます。 ラ ベル コ ン ト ロ ールは、 通常チ ェ ッ ク ボ ッ ク スのす ぐ横に配置 さ れますが、 チ ェ ッ ク ボ ッ ク スの値に影響を与え る こ と はあ り ません。 Unify NXJ 開発者ガ イ ド 125 5 チ ェ ッ ク ボ ッ ク スの内部の値は "YES" (設定時)、 ま たは "NO" ( ク リ ア時) のみ のブール値か、 整数の 0/1 あ る いは文字列の ”False”/“True” と い っ た他のデー タ タ イ プの値 と する こ と がで き ます。 フ ォ ーム上のほかの コ ン ト ロ ール と 同様に、 チ ェ ッ ク ボ ッ ク ス コ ン ト ロ ールの デー タ タ イ プは、 タ ーゲ ッ ト 列あ る いは対応する変数の形に対応 し て決め ら れま す。 も し 、 上記のどれ と も 対応 し ていない場合には、 チ ェ ッ ク ボ ッ ク スのデー タ タ イ プは文字列にな り 、 “FALSE” か “TRUE” を表す こ と にな り ます。 チ ェ ッ ク ボ ッ ク スに値を指定す る ス テ ッ プは、 以下の と お り です。 1. フ ォ ームにチ ェ ッ ク ボ ッ ク ス コ ン ト ロ ールを配置 し ます。 89 ページの 「 コ ン ト ロ ールの作成」 の説明に従います。 2. チ ェ ッ ク ボ ッ ク スが設定の場合に値を指定 し ます。 デ フ ォ ル ト では、 ユーザが設定にす る ま では ク リ ア で表示 さ れます。 チ ェ ッ ク ボ ッ ク スが実行時に 1 つの値を と るのであれば、 チ ェ ッ ク ボ ッ ク ス を設定 の状態で表示する値を 1 つあ る いは複数の値を指定で き ます。 ブール値型のチ ェ ッ ク ボ ッ ク ス では、 true の値は自動的にチ ェ ッ ク ボ ッ ク ス を設定に し て、 False の値では ク リ ア し ますので、 明示的に値を指定す る必要 はあ り ません。 チ ェ ッ ク ボ ッ ク ス を設定にす る ために値を指定す る には、 以下のス テ ッ プ で 行います。 a. レ イ アウ ト パネルで、 チ ェ ッ ク ボ ッ ク ス を選択 し ます。 b. ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ーで、 On Value プ ロパテ ィ の値の列に あ る選択 ボ タ ン を ク リ ッ ク し ます。 こ のプ ロパテ ィ は、 Checkbox グループ にあ り ます。 選択 ボ タ ン を有効に する には、 まず Value の列を ク リ ッ ク し な く てはな り ません。 Checkbox ON Value ダ イ ア ロ グが表示 さ れます。 Unify NXJ 開発者ガ イ ド 126 5 選択 ボタ ン c. ダ イ ア ロ グで、 最初の値を入力 し ます。 入力 し た値は、 チ ェ ッ ク ボ ッ ク スのデー タ タ イ プ と 合 っ た フ ォ ーマ ッ ト で なければな り ません。 ( コ ン ト ロ ールのデー タ タ イ プは、 Data Type プ ロパテ ィ の値で識別で き ます。) d. 値を追加す る には、 Add ボ タ ン を ク リ ッ ク し ます。 e. OK ボ タ ン を ク リ ッ ク し て、 変更を保存 し て ダ イ ア ロ グ を終了 し ます。 3. チ ェ ッ ク ボ ッ ク スの値の保存 フ ォ ーマ ッ ト を指定 し ます。 チ ェ ッ ク ボ ッ ク スが タ ーゲ ッ ト の列 と マ ッ プ し てい る場合には、 チ ェ ッ ク ボ ッ ク ス で表 さ れる値はデー タ ベースに保存 さ れます。 あ る いは、 フ ォ ーム ス ク リ プ ト の jBiz 変数 と し て使用 さ れます。 ど ち ら の場合 も 、 チ ェ ッ ク ボ ッ ク スの値を格納する と き に使われる フ ォ ーマ ッ ト の指定がで き ます。 デ フ ォ ル ト では、 チ ェ ッ ク ボ ッ ク スの値の フ ォ ーマ ッ ト は、 “true”/”false” の文字列 にな り ます。 チ ェ ッ ク ボ ッ ク スの値に別の フ ォ ーマ ッ ト を指定す る ス テ ッ プは、 以下の と お り です。 a. a. レ イ アウ ト パネルで、 チ ェ ッ ク ボ ッ ク ス を選択 し ます。 b. ブ ラ ウザパネルのプ ロパテ ィ ビ ュ ーで、 Store Format プ ロパテ ィ の値の列 にあ る 選択 ボ タ ン を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 127 5 こ のプ ロパテ ィ は、 プ ロパテ ィ の Checkbox グループにあ り ます。 Checkbox Sotre Format ダ イ ア ロ グが表示 さ れます。 ダ イ ア ロ グで、 チ ェ ッ ク ボ ッ ク ス を設定を表す ON の値 と 、 ク リ ア で表 す OFF の値を入力 し ます。 入力 し た値は、 チ ェ ッ ク ボ ッ ク スのデー タ タ イ プに適切な フ ォ ーマ ッ ト で なければな り ません。 チ ェ ッ ク ボ ッ ク スの名前を使 っ て、 実行時にはチ ェ ッ ク ボ ッ ク スの値 jBiz にア ク セ ス し た り 、 設定す る こ と がで き ます。 詳細については、 『Unify NXJ jBiz 言語ガ イ ド 』 の第 3 章を参照 し て く だ さ い。 チ ェ ッ ク ボ ッ ク ス コ ン ト ロ ールは、 Field Control プ ロパテ ィ のい く つかを使いま す。 171 ページの 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Radio Button コ ン ト ロール ラ ジオグループは、 相互に排他的なオ プ シ ョ ンのグループ です。 ユーザは実行時 にボ タ ン を ク リ ッ ク し て、 いずれかのオ プ シ ョ ン を選択 し ます。 ラ ジ オボ タ ン コ ン ト ロ ールには、 すべての Field Control プ ロパテ ィ があ り 、 さ ら に以下のプ ロパ テ ィ も あ り ます。 Unify NXJ 開発者ガ イ ド 128 5 Title プ ロパテ ィ Button List プ ロパテ ィ Vertical orientation(縦方向) Horizontal orientation(横方向) Orientation (方向) : ラ ジオ ボ タ ン を縦方向に並べるか、 横方向に並べるかを 指定 し ます。 ド ロ ッ プ ダウ ン リ ス ト か ら Vertical (縦) ま たは Horizontal (横) を選択 し ます。 デ フ ォ ル ト は Vertical( 縦 ) です。 Title : ラ ジオグループの タ イ ト ルです。 Button List : ラ ジ オ ボ タ ンの タ イ ト ル と 値です。 こ れ ら のプ ロパテ ィ は、 Radio グループにあ り ます。 171 ページの 「プ ロパテ ィ の 概要」 を参照 し て く だ さ い。 ラ ジオ ボ タ ン コ ン ト ロ ールは、 89 ページの 「 コ ン ト ロ ールの作成」 で説明 さ れて い る コ ン ト ロ ールの作成手順に従 っ て作成 し ます。 Listbox コ ン ト ロール と Dropdown Listbox コ ン ト ロール リ ス ト ボ ッ ク ス コ ン ト ロ ールは読み取 り 専用の値の リ ス ト です。 ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス も 同 じ く 読み取 り 専用の値の リ ス ト ですが、 リ ス ト を表示す る た めにはユーザが下向き矢印を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 129 5 リ ス ト ボ ッ ク ス コ ン ト ロール ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス コ ン ト ロール タ ーゲ ッ ト フ ィ ール ド や タ ーゲ ッ ト 変数の追加 / 更新を す る場合は、 リ ス ト ボ ッ ク スのいずれかの値を選択 し ます。 フ ィ ール ド コ ン ト ロ ールに値を入力す る必要は あ り ません。 検索操作の後、 リ ス ト ボ ッ ク スには タ ーゲ ッ ト フ ィ ール ド か ら 戻 さ れた値がハ イ ラ イ ト さ れて表示 さ れます。 テキス ト フ ィ ール ド コ ン ト ロ ール と は異な り 、 リ ス ト ボ ッ ク ス コ ン ト ロ ールには、 タ ーゲ ッ ト フ ィ ール ド や タ ーゲ ッ ト 変数に格納 さ れてい る値 と は別の値を使用す る こ と も で き ます。 表示 さ れる値ご と に、 検索条件や検索結果に使用す る対応値 があ る場合 も あ り ますが、 ユーザには表示 さ れません。 例えば、 あ る フ ォ ームに、 あ る在庫ア プ リ ケーシ ョ ンの店舗 ID を表示す る リ ス ト ボ ッ ク スがあ る と し ます。 デー タ ベース列の店舗 ID の数はあ ま り 多 く ないので、 こ のよ う なデー タ には リ ス ト ボ ッ ク ス を使用するのが適 し ています。 ユーザが店 舗 ID を間違 っ て入力する こ と はあ り ません。 店舗 ID を表示する代わ り に、 リ ス ト ボ ッ ク スにその店舗 ID に対応する店舗名を 表示する こ と も で き ます。 ユーザには店舗 ID が表示 さ れず、 デー タ ベースには店 舗名は含まれません。 California Kentucky Internal Match Value 15 07 15 xxx xxx xxxx 07 xxx xxx xxxx Unify NXJ 開発者ガ イ ド 130 5 表示 さ れる リ ス ト と 対応値の リ ス ト は、 ク エ リ の結果に基づいて実行時に作成 さ れます。 例えば、 店舗 ID と 対応する店舗名の リ ス ト がア プ リ ケーシ ョ ン を実行す る国に よ っ て異な る と し ます。 対応す る ロ ケールでの ク エ リ に よ っ て、 実行時に 正 し い店舗 ID と 店舗名の リ ス ト を取得で き ます。 ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス コ ン ト ロ ールには、 すべての Field Control プ ロパ テ ィ があ り 、 さ ら に以下のプ ロパテ ィ も あ り ます。 Options : リ ス ト を構成する名称 と 対応値のペア。 こ のペアは、 オ プ シ ョ ン ダ イ ア ロ グで定義 し ます。 Query : 名称 と 値のペア を提供す る ク エ リ 。 Query Row Limit : Query プ ロパテ ィ で指定 さ れる ク エ リ が実行 さ れる場合、 リ ス ト ボ ッ ク スに表示す る行の最大数を指定 し ます。 デ フ ォ ル ト では、 リ ス ト ボ ッ ク スに表示する行の最大数は 250 です。 注 – オ プ シ ョ ン と ク エ リ は、 相互に排他的な関係にあ り ます。 オ プ シ ョ ン に値が あれば、 ク エ リ は使用で き ません。 ク エ リ に値があれば、 オ プ シ ョ ンは使用で き ません。 171 ページの 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 リ ス ト ボ ッ ク スや ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス コ ン ト ロ ールは、 以下のス テ ッ プ で設定 し ます。 1. レ イ アウ ト パネルの フ ォ ームに、 リ ス ト ボ ッ ク スや ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク ス コ ン ト ロ ールがなければ作 成 し ます。 2. 固定の名前 と 対応値に基づいて リ ス ト を作成する場合は、 Options プ ロパテ ィ の値の列にあ る ... ボ タ ン を ク リ ッ ク し 、 オ プ シ ョ ン ダ イ ア ロ グ を開き ます。 それ以外の場合 は、 ス テ ッ プ 4 に進みます。 Listbox シ ンボル Dropdown Listbox シ ン ボル 3. 追加 ボ タ ン を ク リ ッ ク し て、 新 し いエ ン ト リ を作成 し ま す。 名称の列に、 リ ス ト ボ ッ ク スに表示す る名称を入力 し ま す。 値の列に、 追加 / 更新中に タ ーゲ ッ ト フ ィ ール ド や タ ーゲ ッ ト 変数 と し て使 用す る対応値、 ま たは検索 操作中に検索条件 と し て使用す る対応値を入力 し ます。 値を入力 し ない場合は、 値 と し て名称が使用 さ れます。 Unify NXJ 開発者ガ イ ド 131 5 リ ス ト ボ ッ ク スの場合、 Height プ ロパテ ィ は何行が、 リ ス ト ボ ッ ク スに最初 に表示 さ れるかを決定 し ます。 残 り の行はス ク ロ ールす る こ と に よ り 表示で き ます。 4. タ ーゲ ッ ト テーブルの ク エ リ に基づいて リ ス ト を作成す る場合は、 Query プ ロパテ ィ の値の列にあ る ... ボ タ ン を ク リ ッ ク し 、 ク エ リ ダ イ ア ロ グ を開き ま す。 ダ イ ア ロ グの上の部分に SELECT 文を入力 し ます。 SELECT 文に よ っ て行ご と に 1 つの値が選択 さ れる と 、 こ れ ら の値は ラ ベル と し て使用 さ れ、 リ ス ト ボ ッ ク スの値 と し て も 使用 さ れます。 行ご と に 2 つ の値が選択 さ れる と 、 最初の値は ラ ベル と し て使用 さ れ、 も う 1 つの値は リ ス ト ボ ッ ク スの値 と し て使用 さ れます。 Query プ ロパテ ィ に値を指定す る と 、 Options プ ロパテ ィ には空の文字列が設 定 さ れます。 5. リ ス ト ボ ッ ク ス コ ン ト ロ ールが ド ロ ッ プ ダウ ン形式で、 リ ス ト ボ ッ ク ス形式 ではない場合、 リ ス ト に表示す る行数を入力 し ます。 Query Row Limit プ ロパテ ィ の値の列を ク リ ッ ク し 、 行数を整数値で入力 し ます。 リ ス ト ボ ッ ク スに表示 さ れる値は実行時には読み取 り 専用ですが、 ユーザは フ ィ ール ド コ ン ト ロ ールにデー タ を入力で き ます。 デー タ が リ ス ト 項目のどれか と 一致する と 、 対応する リ ス ト ボ ッ ク スの行がハ イ ラ イ ト さ れます。 こ の機能に よ り 、 ユーザが リ ス ト ボ ッ ク ス で選択 し たい も のを す ぐ探せます。 実行時の制限について ア プ リ ケーシ ョ ンが正 し く コ ンパ イル さ れ、 jBiz 変数への参照に よ っ て SQL 例外 が発生する場合、 ア プ リ ケーシ ョ ンは引き続き実行 さ れます。 こ の SQL 制限は、 リ ス ト ボ ッ ク ス と ド ロ ッ プ ダウ ン リ ス ト ボ ッ ク スに適用 さ れま す。 SQL 例外エ ラ ーが発生す る と 、 リ ス ト ボ ッ ク スには値が含まれません。 同様 に、 ク エ リ が行を返 さ なければ、 エ ラ ー メ ッ セージは表示 さ れず、 リ ス ト ボ ッ ク スには値が含まれません。 2 つの列が ク エ リ か ら 返 さ れる と 、 最初の列には表示 さ れる値、 次の列には実際の 値が含まれます。 列が 1 つ し か返 さ れない場合、 表示 さ れる値 と 実際の値の両方 が含まれます。 Unify NXJ 開発者ガ イ ド 132 5 ク エ リ は、 リ ス ト ボ ッ ク ス を含むデー タ ビ ュ ーで有効なデー タ ベース接続を使用 し ます。 ク エ リ には STRING デー タ タ イ プ と の互換性が必要です。 ま た、 リ ス ト ボ ッ ク スにはバ イ ナ リ デー タ やテキス ト デー タ はで き ません。 重複 し た値を除外する よ う な ク エ リ を作成 し なければ、 重複 し た値が返 さ れます。 デー タ ベースのテーブルに イ ン デ ッ ク ス を作成 し 、 重複 し た値を返 さ ない よ う に する こ と も で き ます。 ラ ベル と Styled Text ラ ベルボ ッ ク ス と styled text ボ ッ ク スの 2 種類の コ ン ト ロ ールは、 固定のテキス ト を表示 し ます。 実行時の Styled Text ボッ クス 実行時の ラ ベル 実行時の Styled Text ボッ クス ラ ベル と は 1 行のテキス ト です。 ラ ベルの文字の フ ォ ン ト 、 背景色、 前景色はす べて同 じ です。 Styled Text Box と は Styled Text を四角で囲 っ た部分です。 テキス ト ボ ッ ク ス全体 にス タ イル名を指定 し 、 割 り 当て る こ と がで き ます。 ラ ベル と Styled Text ボ ッ ク スは、 フ ィ ール ド コ ン ト ロ ールのすべてのプ ロパテ ィ に加え て以下の も のを持 っ ています。 Title: ラ ベル と し て表示 さ れる テキス ト 。 ラ ベルは、 ま た以下の も の も 持 っ ています。 Unify NXJ 開発者ガ イ ド 133 5 Align: フ ィ ール ド 中でのテキス ト の位置合わせ。 オ プ シ ョ ン と し て、 左揃え、 右揃え、 中央があ り ます。 プ ロパテ ィ の リ ス ト と 適用 さ れる フ ィ ール ド コ ン ト ロ ールに関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 ス タ イル バーの使い方 Styled Text ボ ッ ク ス で テキス ト を選択 し 、 ス タ イルバーで Styled Text を変更で き ます。 ス タ イルバーには、 選択 し た テキス ト に現在設定 さ れてい る ス タ イル も 表 示 さ れます。 ス タ イルバー ス タ イルバーには、 以下のエ レ メ ン ト があ り ます。 表 5-10 ス タ イル バーのエ レ メ ン ト ス タ イルバーの エレ メ ン ト 説明 ス タ イルの選択 現在の look & feel 定義にあ る ス タ イル名です。 ス タ イルを適用 する には、 レ イ アウ ト パネルで Styled Text ボ ッ ク ス を選択 し 、 ド ロ ッ プ ダウ ン リ ス ト で ス タ イルを選択 し ます。 テキス ト ボ ッ ク ス で選択 し た テキス ト には、 太字、 斜体、 下線、 フ ォ ン ト 、 色の属性を適用で き ますが、 Styled Text ボ ッ ク スに あ る別のス タ イルの名前を指定する こ と はで き ません。 フ ォ ン ト の選択 使用で き る フ ォ ン ト 名です。 フ ォ ン ト を適用する には、 Styled Text ボ ッ ク スか Styled Text ボ ッ ク ス内のテキス ト の一部を選択 し 、 ド ロ ッ プ ダウ ン リ ス ト で フ ォ ン ト を選択 し ます。 ド ロ ッ プ ダウ ン リ ス ト には、 選択 し たボ ッ ク スやテキス ト の現 在の フ ォ ン ト が表示 さ れます。 フ ォ ン ト サ イ ズの 選択 使用で き る フ ォ ン ト のサ イ ズ (ポ イ ン ト ) です。 サ イ ズ を適用 する には、 Styled Text ボ ッ ク スか Styled Text ボ ッ ク ス内のテキ ス ト の一部を選択 し 、 ド ロ ッ プ ダウ ン リ ス ト で フ ォ ン ト を選択 し ます。 ド ロ ッ プ ダウ ン リ ス ト には、 選択 し たボ ッ ク スやテキス ト の現 在の フ ォ ン ト サイ ズが表示 さ れます。 Unify NXJ 開発者ガ イ ド 134 5 表 5-10 ス タ イル バーのエ レ メ ン ト ス タ イルバーの エレ メ ン ト 説明 太字ボ タ ン 選択 し た テキス ト に太字を使用するかど う かを示す ト グル ボ タ ン です。 Styled Text ボ ッ ク ス で テキス ト を選択 し た場合、 太字 は選択 し た テキス ト に適用 さ れます。 それ以外の場合は、 現在 選択 し てい るすべての コ ン ト ロールに適用 さ れます。 斜体ボ タ ン 選択 し た テキス ト に斜体を使用するかど う かを示す ト グル ボ タ ン です。 Styled Text ボ ッ ク ス で テキス ト を選択 し た場合、 斜体 は選択 し た テキス ト に適用 さ れます。 それ以外の場合は、 現在 選択 し てい るすべての コ ン ト ロールに適用 さ れます。 前景色の選択 前景色が選択で き ます。 Styled Text ボ ッ ク ス で テキス ト を選択 し た場合、 前景色は選択 し た テキス ト に適用 さ れます。 それ以 外の場合は、 現在選択 し てい るすべての コ ン ト ロールに適用 さ れます。 背景色の選択 背景色が選択で き ます。 選択 し た背景色は、 現在選択 し てい る すべての コ ン ト ロールに適用 さ れます。 Styled Text ボ ッ ク スにス タ イルが適用 さ れてい る場合、 定義が変更 さ れる と ス タ イル も 変更 さ れて再表示 さ れます。 ス タ イル定義が look & feel 定義か ら 削除 さ れ る と 、 通常の HTML 規則に従 っ て こ の ク ラ スは無視 さ れます。 ス タ イル バー を使 っ て、 フ ィ ール ド コ ン ト ロ ールに Visual プ ロパテ ィ を適用す る こ と も で き ます。 フ ォ ン ト 、 ス タ イル、 色はテキス ト ボ ッ ク ス全体に適用 さ れま す。 ラ ベル と Styled Text ボ ッ ク スの編集モー ド ラ ベル と Styled Text ボ ッ ク スは、 通常モー ド で も 編集モー ド で も 操作で き ます。 通常モー ド の ラ ベル と Styled Text ボ ッ ク スは、 マウス を ド ラ ッ グす るか、 矢印 キー を押 し た り す る と 移動で き ます。 編集モー ド は、 ラ ベルやテキス ト ボ ッ ク ス のテキス ト に適用 さ れます。 マウス を ド ラ ッ グ し た り 矢印キー を押 し た り す る と 、 ラ ベルやテキス ト ボ ッ ク ス で選択 し た テキス ト を編集で き ますが、 ラ ベルやテキ ス ト ボ ッ ク ス を移動する こ と はで き ません。 ラ ベルやス タ イルテキス ト ボ ッ ク ス を ダ ブル ク リ ッ ク す る と 、 編集モー ド にな り ます。 ま た、 マウス を右 ク リ ッ ク し てポ ッ プ ア ッ プ メ ニ ュ ー を開き、 テキス ト の 編集 コ マ ン ド を選択 し て も 編集モー ド にな り ます。 編集モー ド では、 grabbers が傾 Unify NXJ 開発者ガ イ ド 135 5 斜境界線に変わ り ます。 通常モー ド にする と grabbers に戻 り ます。 通常モー ド で も 編集モー ド で も 十字型の カ ー ソ ルが表示 さ れます。 別の コ ン ト ロ ールや フ ォ ー ムを選択す る と 、 コ ン ト ロ ールは通常モー ド に戻 り ます。 ESC を押す と 編集モー ド で行 っ た変更が取 り 消 さ れ、 テキス ト ボ ッ ク スが通常モー ド に戻 り ます。 編集モー ド では、 ラ ベルやテキス ト ボ ッ ク スに テキス ト を直接入力 し 、 ス タ イル バー を使 っ て ス タ イルを適用で き ます。 ラ ベルやス タ イルテキス ト ボ ッ ク スの内 容は、 切 り 取 り 、 コ ピ ー、 貼 り 付け コ マ ン ド で編集する こ と も で き ます。 ラ ベル やテキス ト ボ ッ ク スのサ イ ズは、 grabbers で変更で き ます。 コ ン ト ロ ールを小 さ く し すぎ る と 、 テキス ト の一部が表示 さ れない こ と があ り ます。 その場合、 コ ン ト ロールに入力する と テキス ト がすべて表示で き る大き さ に戻 り ます。 . 編集モー ド の ラ ベルやテキス ト ボ ッ ク ス では、 Ctrl キー を押 し た ま ま A キー を押 す と 、 コ ン ト ロ ール内のすべてのテキス ト が選択で き ます。 Table Table コ ン ト ロ ールを使 う と 、 テーブル フ ォ ームの情報を整理で き ます。 45 ページ の 「絶対位置 と テーブルベースの位置」 を参照 し て く だ さ い。 テーブルの各セル は、 コ ン ト ロ ールを配置する こ と も 、 ブ ラ ン ク のま まに し てお く こ と も で き ます。 すでにセルに コ ン ト ロ ールが配置 さ れてい る場合は、 その右側に新 し い コ ン ト ロールを追加で き ます。 セルに コ ン ト ロ ールを配置する場合、 そのセルの属性に基づいて配置 さ れます。 セルのサ イ ズ を変更する と 、 1 つあ る いは複数のセル内の コ ン ト ロ ールのサ イ ズ も 変更 し なければな ら ない こ と があ り ます。 表は、 すべての Visual プ ロパテ ィ に加え て、 以下のプ ロパテ ィ があ り ます。 Row Style: 表の行のデ フ ォ ル ト のス タ イル。 Alternate Row Style: テーブル内の Alternate Row のデ フ ォ ル ト ス タ イル。 Unify NXJ 開発者ガ イ ド 136 5 Group size:Alternate Row の行 と 行の間にあ る行数。 テーブル行は、 すべての Visual プ ロパテ ィ に加え て、 以下のプ ロパテ ィ があ り ま す。 Align: 左揃え、 中央、 右揃え テーブルセルは、 すべての Visual プ ロパテ ィ に加え て、 以下のプ ロパテ ィ があ り ます。 Column Span: セルがま たがる列数 Row Span: セルがま たがる行数 Align: 左揃え、 中央、 右揃え Vertical Alignment: 上揃え、 中央、 下揃え Wallpaper: セルの背景に表示 さ れる イ メ ージの URL Cell padding: セルの境界 と セルの内容 と の間隔のピ ク セル数 Cell spacing: テーブル内のセル と セル と の間隔のピ ク セル数 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト の詳細については、 171 ページの 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 テーブルは、 フ ィ ール ド コ ン ト ロ ールよ り も 選択に関 し て以下の動作を提供 し て います。 • セルで コ ン ト ロ ールを ク リ ッ ク する と 、 コ ン ト ロ ールが選択 さ れます。 • セルで Ctrl キー を押 し た ま ま コ ン ト ロ ールを ク リ ッ ク す る と 、 ク リ ッ ク し た コ ン ト ロ ールが選択に追加 さ れます。 • セルを ク リ ッ ク す る と 、 ク リ ッ ク し たセルが選択 さ れます。 選択 さ れたセル の外側には、 赤い外枠が表示 さ れます。 • カ ー ソ ルを テーブルの境界線上に置 く と 、 カ ー ソ ルが手の形に変わ り ます。 カ ー ソ ルが手の形にな っ てい る と き に ク リ ッ ク す る と 、 そのテーブルが選択 さ れます。 (手の形状の カ ー ソ ルが表示 さ れてい る と き に Ctrl キー を押 し た ま ま ク リ ッ ク する と 、 その Table が選択に追加 さ れます。) Table は、 以下のス テ ッ プ で作成 し ます。 1. Table を配置す る フ ォ ーム を開き ます。 Unify NXJ 開発者ガ イ ド 137 5 2. コ ン ト ロ ールパレ ッ ト で、 Table の記号を ク リ ッ ク し ます。 . 3. レ イ アウ ト パネルで、 フ ォ ーム を ク リ ッ ク し ます。 Table シ ンボル 4. Table の行数 と 列数を入力 し ます。 行 と 列の数は 2 か ら 200 の 間で指定 し ます。 5. 必要に応 じ て、 他の コ ン ト ロ ールを Table に追加 し ます。 フ ィ ール ド を ド ラ ッ グ & ド ロ ッ プ し て、 セル間を移動 さ せる こ と も で き ま す。 Table の行や列は、 以下のス テ ッ プ で削除 し ます。 1. 1. 行や列のセルを選択 し ます。 セルの境界が赤色にな り ます。 2. マウス を右 ク リ ッ ク し て、 ポ ッ プ ア ッ プ メ ニ ュ ー を表示 し ます。 3. 行の削除、 ま たは列の削除を選択 し ます。 行ま たは列が削除 さ れます。 フ ィ ール ド を ド ラ ッ グ& ド ロ ッ プす る と 、 セル間で移動 さ せる こ と がで き ます Dynamic Text Dynamic Text は 1 行の読み取 り 専用テキス ト ボ ッ ク スに配置 さ れ、 jBiz の変数や プ ロパテ ィ 参照に よ っ て値が設定 さ れます。 通常、 Dynamic Text は、 他の フ ォ ー ムの フ ィ ール ド コ ン ト ロ ールを表示す る ために使用 し ます。 Dynamic Text のエ レ メ ン ト には、 すべての Visual プ ロパテ ィ があ り 、 さ ら に以下 のプ ロパテ ィ も あ り ます。 Expression : テキス ト ボ ッ ク スに表示 さ れる値です。 値の前に等号 (=) があ る場合は、 jBiz の単純式 と 見な さ れ実行時に評価 さ れます。 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト に関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 138 5 Button コ ン ト ロール ボ タ ンは、 コ マ ン ド に関連付け ら れています。 実行時に、 ユーザがボ タ ン を ク リ ッ ク する と コ マ ン ド が実行 さ れます。 こ の場合の コ マ ン ド は、 NXJ であ ら か じ め定義 さ れてい る コ マ ン ド か開発者が定義 し た jBiz コ マ ン ド です。 テキス ト ボ タ ン イ メ ージボ タ ン ボ タ ン にはすべての Visual プ ロパテ ィ があ り 、 さ ら に以下のプ ロパテ ィ も あ り ま す。 Command : ボ タ ン に関連付け ら れてい る コ マ ン ド の名称。 Title : ボ タ ンの タ イ ト ル。 イ メ ージ を割 り 当て る こ と がで き るのは、 image button コ ン ト ロ ールだけです。 こ のボ タ ン タ イ プ では、 さ ら に以下の Visual プ ロパテ ィ が使用で き ます。 Source : イ メ ージ ソ ースの URL。 project\sources\Static_Content デ ィ レ ク ト リ か ら の相対パス、 ま たは相対 フ ァ イル名 と し て評価する jBiz 式で指 定 さ れています。 作成プ ロ セ スは、 ア プ リ ケーシ ョ ンパ ッ ケージに イ メ ージ を コ ピ ー し て、 相対 URL と し てパス を使用で き ます。 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト に関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 139 5 Tab Controls tab control にはい く つかの tab insert があ り 、 他の コ ン ト ロ ールの コ ン テナ と し て 動作 し ます。 Tab Insert が 3 つあ る Tab Control 一般に、 tab control を使 う と 、 多数のダ イ ア ロ グオ プ シ ョ ンのセ ッ ト を表示グルー プ にま と めて、 必要な フ ォ ームだけ を画面に表示す る よ う にで き ます。 各 tab insert には、 個別のデー タ ビ ュ ー を配置す る こ と がで き ます。 tab control には、 すべての Visual プ ロパテ ィ があ り 、 さ ら に以下のプ ロパテ ィ も あ り ます。 Title : tab insert の タ イ ト ル。 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト に関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Images Image コ ン ト ロ ールでは、 イ メ ージ表示領域を指定 し ます。 ま た、 jBiz 文を使 う と 外部 フ ァ イルの イ メ ージ表示領域 も 指定で き ます。 イ メ ージには、 すべての Visual プ ロパテ ィ があ り 、 さ ら に以下のプ ロパテ ィ も あ り ます。 Unify NXJ 開発者ガ イ ド 140 5 Source : イ メ ージ ソ ースの URL。 project\sources\Static_Content デ ィ レ ク ト リ か ら の相対パス、 ま たは相対 フ ァ イル名 と し て評価する jBiz 式で指 定 さ れています。 作成プ ロ セ スはア プ リ ケーシ ョ ン パ ッ ケージに イ メ ージ を コ ピ ー し て、 相対 URL と し てパス を使用で き ます。 作成 プ ロ セ ス では、 ア プ リ ケーシ ョ ンパ ッ ケージに イ メ ージが コ ピ ー さ れ、 相対 URL と し てパス を使用で き ます。 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト に関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Line と Group Box Box と Line を使 っ て他の フ ィ ール ド コ ン ト ロ ールを視覚的にグループ化 し 、 フ ォ ームを見やす く し て、 よ り 使いやす く す る こ と がで き ます。 Title プ ロパテ ィ Box には、 Size プ ロパテ ィ を除 く 、 すべての Visual プ ロパテ ィ があ り ます。 Line には、 Height プ ロパテ ィ を除 く 、 すべての Visual プ ロパテ ィ があ り ます。 Line の Size プ ロパテ ィ には、 Line のピ ク セルを指定 し ます。 プ ロパテ ィ と 適用 さ れる フ ィ ール ド コ ン ト ロ ールの リ ス ト に関 し ては、 171 ページ の 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 141 5 Link コ ン ト ロール フ ォ ームの リ ン ク は、 ユーザが他の Web ページに移る こ と を可能にする ために、 一般的に使用 さ れます。 ま た、 ユーザが リ ン ク を ク リ ッ ク する と 、 コ マ ン ド が実 行 さ れる よ う に、 コ マ ン ド を リ ン ク と 関連 さ せる こ と も で き ます。 リ ン ク は、 テ キス ト 、 イ メ ージ、 ま たはその両方で表示す る こ と がで き ます。 以下の図は、 テ キス ト と イ メ ージ を持つ リ ン ク が、 Rofida Web ページにア ク セ スする こ と を示 し ています。 Source プ ロパテ ィ Text プ ロパテ ィ Href プ ロパテ ィ Text property (Rofida web ページ ) Link には、 すべての Visual プ ロパテ ィ があ り 、 さ ら に以下のプ ロパテ ィ も あ り ま す。 Href : リ ン ク で関連付け ら れてい る URL。 つま り 、 ユーザが リ ン ク を ク リ ッ ク す る と 、 開かれる タ ーゲ ッ ト ページ です。 Source : リ ン ク と し て表示する イ メ ージ。 Source プ ロパテ ィ は、 プ ロパテ ィ の Visual グループにあ り ます。 Text : リ ン ク と し て表示す る テキス ト 。 Command : リ ン ク に関連付け ら れてい る コ マ ン ド 。 Unify NXJ 開発者ガ イ ド 142 5 Href、 Source、 Text プ ロパテ ィ の前に等号 (=) があ る場合は、 jBiz の式であ る と 見な さ れ、 実行時に解釈 さ れます。 例えば、 “=URLlocalofficewebpage” に Href プ ロ パテ ィ を設定 し て、 次に以下の フ ォ ームの jBiz ス ク リ プ ト を含む こ と がで き ます。 BEFORE FORM { if ( session.clientLocale.getLanguage().equals("en") ( URLlocalofficewebpage = "http://www.rofida/com/us" ; } すべてのプ ロパテ ィ の リ ス ト と 、 リ ス ト が適用 さ れる フ ィ ール ド コ ン ト ロ ールに 関 し ては、 171 ページの 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 143 5 イ ン ラ イ ン フ レーム コ ン ト ロール イ ン ラ イ ン フ レ ーム コ ン ト ロ ールは、 NXJ フ ォ ーム内に別の ド キ ュ メ ン ト を表示 で き る コ ン ト ロ ールです。 ド キ ュ メ ン ト には、 テキス ト フ ァ イル、 Web ページ、 あ る いは、 その他の固定の フ ァ イルが使え ます。 ケースに よ っ ては、 ド キ ュ メ ン ト が使用す る Web ブ ラ ウザへのプ ラ グ イ ン を使 う も ので も 構いません。 フ ォ ームに ド キ ュ メ ン ト を埋め込む と 、 関連する情報を直ち に読み込んで、 ア プ リ ケーシ ョ ン ユーザにその内容を表示 し ます。 ド キ ュ メ ン ト を NXJ の フ ォ ームに 埋め込んだ場合には、 ツ ールバーお よ びその他のナ ビ ゲーシ ョ ン支援機能は、 埋 め込まれた ド キ ュ メ ン ト に対 し ては有効ではない こ と に注意 し て く だ さ い。 以下の例は、 従業員詳細 フ ォ ームの中に HTML フ ァ イルを表示 し ています。 HTML ド キ ュ メ ン ト を含む イ ン ラ イ ン フ レ ーム コ ン ト ロール Unify NXJ 開発者ガ イ ド 144 5 フ ォ ームに イ ン ラ イ ン フ レ ーム コ ン ト ロ ールを追加する には、 以下のス テ ッ プ を 行います。 1. フ ォ ームを開 く 。 レ イ アウ ト パネルに フ ォ ームが表示 さ れます。 2. フ ォ ームに イ ン ラ イ ン フ レ ーム コ ン ト ロ ールを配置 し ます。 Inline Frame シ ンボル 詳細については、 89 ページの 「 コ ン ト ロ ールの作成」 を参照 し て下 さ い。 コ ン ト ロ ールパレ ッ ト 上の イ ン ラ イ ン フ レ ームのシ ン ボルは 右の も のです。 3. Source プ ロパテ ィ の設定で、 フ レ ームの ソ ース、 すなわち、 フ レ ームに表示 さ れる も のを指定 し ます。 Source プ ロパテ ィ は、 プ ロパテ ィ の Visual グループにあ り 、 以下のいずれか を入力 し ます。 • URL URL は、 Static Content デ ィ レ ク ト リ の絶対、 あ る いは相対の も のにな り ます。 例えば、 http://www.unify.com あ る いは field_help.html • Static Content フ ァ イル (.txt、 .doc、 .pdf、 あ る いは Web ブ ラ ウザで表示 で き る その他の タ イ プの フ ァ イル) 選択 ボ タ ン を ク リ ッ ク し て、 Static Content デ ィ レ ク ト リ にア ク セ ス し て フ ァ イルを指定 し ます。 • URL あ るは Static Content フ ァ イルを指定す る動的な式 NXJSession フ ァ ウ ン デーシ ョ ン ク ラ スの openURL プ ロパテ ィ を使 っ jBiz て、 実行時に Source プ ロパテ ィ に URL を指定す る こ と がで き ます。 詳細については、 ヘルプ> Javadoc を選択 し て Javadoc を参照 し て下 さ い。 繰 り 返 し 領域コ ン ト ロール 繰 り 返 し 領域 と は、 マルチオ カ レ ン ス フ ォ ームで レ コ ー ド が表示 さ れる フ ォ ーム 領域です。 繰 り 返 し 領域には、 以下の 2 つのス タ イルがあ り ます。 • フ ィ ール ド コ ン ト ロ ールを使 う ス タ イル • リ ス ト ボ ッ ク ス コ ン ト ロ ールを使 う ス タ イル Unify NXJ 開発者ガ イ ド 145 5 デ フ ォ ル ト で作成 さ れた フ ォ ーム コ ン ト ロ ールの場合、 繰 り 返 し 領域のス タ イル は フ ォ ーム作成時に指定 さ れています。 デ フ ォ ル ト で作成 さ れた フ ォ ーム コ ン ト ロ ールの場合、 繰 り 返 し 領域のス タ イル は フ ォ ーム作成時に指定 さ れています。 Type : 繰 り 返 し 領域の タ イ プ ( フ ィ ール ド 、 あ る いは リ ス ト ボ ッ ク ス) すべてのプ ロパテ ィ の リ ス ト と 、 リ ス ト が適用 さ れる フ ィ ール ド コ ン ト ロ ールに 関 し ては、 171 ページの 「プ ロパテ ィ の概要」 を参照 し て く だ さ い。 新 し い繰 り 返 し 領域は、 以下のス テ ッ プ で作成 し ます。 1. コ ン ト ロ ールパレ ッ ト で繰 り 返 し 領域シ ン ボルを ク リ ッ ク す る と 、 新 し い繰 り 返 し 領域が作成 さ れます。 次に レ イ アウ ト パネルで フ ォ ーム を ク リ ッ ク するか、 ク リ ッ ク し て必要なサ イ ズにな る ま で ド ラ ッ グ し ます。 Repeating Area シ ン ボル 2. レ イ アウ ト パネルで繰 り 返 し 領域が選択 さ れた ま まの状 態で、 Type プ ロパテ ィ を設定 し ます。 Fields と List のオ プ シ ョ ンがあ り ます。 3. 必要な フ ィ ール ド コ ン ト ロ ールを、 繰 り 返 し 領域に配置 し ます。 フ ィ ール ド コ ン ト ロ ールは、 コ ン ト ロ ールパレ ッ ト で配置する シ ン ボルを ク リ ッ ク し 、 レ イ アウ ト パネルの繰 り 返 し 領域を ク リ ッ ク す る と 配置 さ れま す。 Type プ ロパテ ィ で Fields を指定する と 、 フ ィ ール ド コ ン ト ロ ールの コ ピ ーが デザ イ ン セ ン タ に よ っ て作成 さ れ、 各行に 1 つずつ配置 さ れます。 行の高 さ は自動的に調整 さ れます。 Type プ ロパテ ィ で Fields を指定する と 、 フ ィ ール ド コ ン ト ロ ールの コ ピ ーが デザ イ ン セ ン タ に よ っ て作成 さ れ、 各行に 1 つずつ配置 さ れます。 行の高 さ は自動的に調整 さ れます。 ラ ベル と Styled Text ボ ッ ク スの コ ピ ーは作成 さ れません (列の ラ ベル と し て 扱われます)。 コ ン ト ロ ールの コ ピ ー を繰 り 返 し 領域か ら 削除す る には、 最初に生成 さ れた コ ン ト ロ ールを選択 し 、 マウス を右 ク リ ッ ク し て切 り 取 り ます。 する と コ ピ ー も 削除 さ れます。 繰 り 返 し 領域か ら 切 り 取 っ た コ ン ト ロ ールを他の場所 に貼 り 付け る場合には、 1 つの コ ピ ーだけが貼 り 付け ら れます。 Unify NXJ 開発者ガ イ ド 146 5 繰 り 返 し 領域で Fields オ プ シ ョ ンが使用 さ れてい る と 、 繰 り 返 し 領域の行は 最初の行以外はすべて使用で き ませんが、 選択す る こ と はで き ます。 繰 り 返 し 領域で List オ プ シ ョ ンが使用 さ れてい る と 、 リ ス ト ボ ッ ク スは使用で き ま せん。 List オ プ シ ョ ン では、 繰 り 返 し 領域には ラ ベル行、 リ ス ト ボ ッ ク ス、 1 つま たは複数の フ ィ ール ド 行があ る と 見な さ れます。 繰 り 返 し 領域に フ ィ ール ド や ラ ベルを追加 し た り 切 り 取 っ た場合や、 繰 り 返 し 領域のサ イ ズ を変更する と 、 ラ ベルが上に来る よ う に (ユーザが指定 し た位置にな る よ う に) 繰 り 返 し 領域がデザ イ ン セ ン タ に よ っ て変更 さ れます。 リ ス ト ボ ッ ク スが中央に来 る よ う に フ ィ ール ド が下 (ユーザが指定 し た位置) に移動する こ と も あ り ま す。 style が “HEADER” の場合は、 ボ ッ ク スが リ ス ト ボ ッ ク スの上にな り ま す。 それ以外の場合は、 リ ス ト ボ ッ ク スの下にな り ます。 List タ イ プの繰 り 返 し 領域を指定 し て テーブルを配置す る と 、 レ ポー ト 形式の繰 り 返 し 領域が作成で き ます。 テーブルの行の背景色を 交互に変更 し て、 テーブルに フ ィ ール ド を配置する こ と がで き ます。 フ ィ ール ド コ ン ト ロ ールは、 繰 り 返 し 領 域に直接配置 さ れたかのよ う に、 テーブルの行に連続 し て コ ピ ー さ れます。 繰 り 返 し 領域のス タ イルを変更 繰 り 返 し 領域をが “Fields” と し て指定作成 さ れてい る場合に、 繰 り 返 し 領域のオ プ シ ョ ン を “List” に変更す る と 、 デザ イ ン セ ン タ に よ っ て フ ィ ール ド の先頭行が繰 り 返 し 領域の一番下に移動 し 、 残 り の フ ィ ール ド が削除 さ れ、 リ ス ト ボ ッ ク スが追 加 さ れます。 オ プ シ ョ ン を List か ら Fields に変更す る と 、 デザ イ ン セ ン タ に よ っ て リ ス ト が削除 さ れ、 コ ピ ー さ れた フ ィ ール ド が再表示 さ れます。 Table と 繰 り 返 し 領域 空の フ ィ ール ド 繰 り 返 し 領域に Table を配置する と 、 列の数を入力す る よ う に求め ら れます。 Table のサ イ ズは、 繰 り 返 し 領域の大き さ にな り ます。 行の数は繰 り 返 し 領域の高 さ に よ っ て決定 さ れます。 (他の コ ン テ ナ タ イ プの コ ン ト ロ ールに Table を配置する と 、 行 と 列の数を入力す る よ う に求め ら れます。) Table を繰 り 返 し 領域の内部に配置す る と 、 デザ イ ン セ ン タ は次の 3 つの カ テ ゴ リ の行に分割 し て生成 し ます。 ヘ ッ ダ行 : テーブルの最初にあ る行で、 ラ ベル と Styled Text ボ ッ ク スが含ま れています。 Unify NXJ 開発者ガ イ ド 147 5 マ ス タ ー行 : ヘ ッ ダ行に続 く 行で、 繰 り 返 し 領域で最初に繰 り 返 さ れる内容 です。 ク ロ ーン行 : マ ス タ ー行に続 く 行で、 残 り の繰 り 返 し 部分です。 Table が作成 さ れた時点では、 どの行 も ブ ラ ン ク です。 行にオ ブ ジ ェ ク ト を ド ロ ッ プす る と 、 ヘ ッ ダ行やマ ス タ ー行にな り ます。 ク ロ ーン行は自動的に生成 さ れま す。 繰 り 返 し 領域の Table のサ イ ズ を変更す る と 、 Table の高 さ に合わせて ク ロ ー ンの数が自動的に変わ り ます。 繰 り 返 し 領域のサ イ ズ を変更 し 、 繰 り 返 し 領域の コ ン ト ロ ールが Table だけにな る と 、 デザ イ ン セ ン タ に よ っ て繰 り 返 し 領域全体に表示 さ れるサ イ ズに Table のサ イ ズが変更 さ れ、 Table の ク ロ ー ンの数が自動的に調節 さ れます。 ヘ ッ ダ行に ラ ベル コ ン ト ロ ールが配置 さ れてい る と 、 自動的に Table のセルに HEADER のス タ イル が適用 さ れ、 Center の Align プ ロパテ ィ が適用 さ れます。 Unify NXJ 開発者ガ イ ド 148 Look and Feel のカ ス タ マ イ ズ 6 こ の章では、 NXJ ア プ リ ケーシ ョ ンの look & feel 定義について説明 し ます。 Look and Feel と は ? ア プ リ ケーシ ョ ンの Look and Feel は ク ラ ス と は別に作成 さ れ、 管理 さ れていま す。 Look and Feel には、 以下のよ う な機能があ り ます。 • ア プ リ ケーシ ョ ン で使用する Unify NXJ ツ ールバーの定義済みス タ イル • ヘ ッ ダ、 フ ッ タ 、 ツ ールバー フ レ ームセ ッ ト の内容 • ア プ リ ケーシ ョ ンのス タ イル定義 • キーボー ド にマ ッ ピ ン グ さ れた コ マ ン ド Unify NXJ では、 多 く のア プ リ ケーシ ョ ン に適 し たデ フ ォ ル ト の look & feel 定義が 用意 さ れています。 前述の機能を組み合わせた look & feel 定義を新 し く 作成す る こ と も で き ます。 NXJ デザ イ ン セ ン タ では、 常に有効な look & feel 定義があ り ます。 レ イ アウ ト パ ネルの フ ォ ームは、 現在の look & feel 定義のス タ イル定義や背景 イ メ ージ を使 っ て表示 さ れています。 ア プ リ ケーシ ョ ンパ ッ ケージ で現在の look & feel 定義を作成する と 、 現在の look & feel 定義が組み込まれます。 実行時に、 ス タ イル定義や背景 イ メ ージがそれぞれ の JSP ページに コ ピ ー さ れ、 Web ブ ラ ウザに送信 さ れます。 各ページのヘ ッ ダ、 フ ッ タ 、 ツ ールバーは、 look & feel 定義の値に基づいて作成 さ れています。 149 6 look & feel 定義の指定 プ ロ ジ ェ ク ト で使用する look & feel 定義は、 プ ロ ジ ェ ク ト プ ロパテ ィ ダ イ ア ロ グ の環境 パネル (プ ロ ジ ェ ク ト > プ ロパテ ィ > 環境 を選択) で指定 し ます。 Look and Feel の変更点を収集 し 管理す る ために、 新 し い look & feel 定義を作成 し ます。 ま た、 デ フ ォ ル ト の look & feel 定義を変更す る こ と も で き ます。 新 し い look & feel 定義は、 以下のス テ ッ プ で作成 し ます。 1. デザ イ ン セ ン タ メ イ ン ウ イ ン ド ウで、 フ ァ イル > 新規 を選択 し ます。 新規オ ブ ジ ェ ク ト の選択ダ イ ア ロ グが表示 さ れます。 2. look & feel 定義のシ ン ボルを ク リ ッ ク し 、 新 し い look & feel 定義の名称を入 力 し ます。 Look and Feel ダ イ ア ロ グのパネルを使 っ て、 Look and Feel を定義 し ます。 詳 細については、 こ の章の後のセ ク シ ョ ン で説明 し ます。 定義済みのツールバー フ ォ ーマ ッ ト の選択 ア プ リ ケーシ ョ ンの標準 フ ォ ーム (ズーム フ ォ ームで ない も の) では、 ツ ール バー フ ォ ーマ ッ ト を使用 し ます。 Unify NXJ には、 次に示す 4 つのあ ら か じ め定義 さ れた ツ ールバー フ ォ ーマ ッ ト が用意 さ れています。 横方向、 イ メ ージあ り デ フ ォ ル ト では、 ツ ールバーは フ ォ ームの上部に表示 さ れます。 Unify NXJ 開発者ガ イ ド 150 6 縦方向、 イ メ ージあ り ツ ールバーは、 フ ォ ームの左側に表示 さ れます。 横方向、 テキス ト のみ 前述の横方向のツ ールバーで、 テキス ト のみで イ メ ージはあ り ません。 テキス ト のみのツ ールバーは、 イ メ ージ を ダウ ン ロ ー ド す る必要がないので速 く 表示 さ れ ます。 ま た、 画面のスペース も 少な く てすみます。 解像度が低いデ ィ ス プ レ イ で 表示する場合は、 こ の点は重要です。 Unify NXJ 開発者ガ イ ド 151 6 縦方向、 テキス ト のみ 前述の縦方向のツ ールバーで、 テキス ト のみで イ メ ージはあ り ません。 テキス ト のみのツ ールバーは、 イ メ ージ を ダウ ン ロ ー ド す る必要がないので速 く 表示 さ れ ます。 ま た、 画面のスペース も 少な く てすみます。 解像度が低いデ ィ ス プ レ イ で 表示する場合は、 こ の点は重要です。 ズーム フ ォ ームのツールバー Unify NXJ には、 ア プ リ ケーシ ョ ンのズーム フ ォ ームに前述の標準 フ ォ ーム と 同 じ ツ ールバーがそれぞれ用意 さ れています。 ズーム フ ォ ームの場合 も 前述の標準 フ ォ ーム と 同 じ 内容 と ス タ イルですが、 フ レ ーム幅が小 さ く な っ ています。 例 と し て、 ズーム フ ォ ームの横方向 メ ニ ュ ー バー を以下に示 し ます。 定義済みのツールバー フ ォ ーマ ッ ト の選択手順 デ フ ォ ル ト のツ ールバーは、 横方向 イ メ ージあ り です。 ズーム フ ォ ームには、 こ のツ ールバーのズーム版があ り ます。 ア プ リ ケーシ ョ ン独自のツ ールバー フ ォ ーマ ッ ト を指定す る ス テ ッ プは、 以下の と お り です。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで、 変更を適用す る look & feel 定義を ク リ ッ ク し ます。 Look and Feel ダ イ ア ロ グが コ ン テ ン ト パネルに表示 さ れます 2. フ ォ ーマ ッ ト パネルが表示 さ れていなければ、 フ ォ ーマ ッ ト タ ブ を ク リ ッ ク し ます。 Unify NXJ 開発者ガ イ ド 152 6 3. 標準 フ ォ ーム ( ズームで ない フ ォ ーム ) で使用する ツ ールバー フ ォ ーマ ッ ト を選択する には、 “Main Window Format” ド ロ ッ プ ダウ ン リ ス ト で フ ォ ーマ ッ ト を選択 し ます。 4. ア プ リ ケーシ ョ ンのズーム フ ォ ームすべて で ツ ールバー フ ォ ーマ ッ ト を使用 する には、 “Zoom Window Format” ド ロ ッ プ ダウ ン リ ス ト で フ ォ ーマ ッ ト を選 択 し ます。 5. OK ボ タ ン を ク リ ッ ク し ます。 ス タ イル定義の使用 Unify NXJ では、 ス タ イル定義を使 っ て フ ォ ーム と コ ン ト ロ ールの visual 特性を コ ン ト ロ ール し ます。 ス タ イルに よ り 、 全 フ ォ ームに一貫 し た Look and Feel を設定で き ます。 現在の look & feel 定義にア ク セ ス し て、 ス タ イル定義を変更する こ と で全 フ ォ ームの外 見を変更で き ます。 Style プ ロパテ ィ を使 っ て、 フ ォ ームや コ ン ト ロ ールにス タ イ ル定義を割 り 当て ます。 Style プ ロパテ ィ は、 プ ロパテ ィ の Visual グループにあ り ます。 Visual グループのその他のプ ロパテ ィ は、 その フ ォ ームや コ ン ト ロ ールだけのス タ イル定義を オーバー ラ イ ド し ます。 組み込まれてい る ス タ イル以外のス タ イル も 定義で き ます。 以下の表に、 事前定 義ス タ イルを示 し ます。 表 6-1 Unify NXJ 定義済みのス タ イル 名称 目的 ALTERNATE_ROW_STYLE 1 行お きの背景色を指定する ために使用 FORM フ ォ ーム と 、 フ ォ ームの コ ン ト ロールのス タ イルを指定 する ために使用 HEADER 利用可能な ス タ イル と し て使用 NORMAL Unify ACCELL で変換 し た ア プ リ ケーシ ョ ン に使用 REPEATING_AREA 繰 り 返 し 領域に使用 Unify NXJ 開発者ガ イ ド 153 6 表 6-1 Unify NXJ 定義済みのス タ イル 名称 目的 ROW_STYLE 行の背景色を指定する ために使用 SELECTED_TAB 現在選択 さ れてい る ノ ー ト ブ ッ ク タ ブのス タ イルを指定 する ために使用 UNSELECTED_TAB 選択 さ れていないの ノ ー ト ブ ッ ク タ ブのス タ イルを指定 する ために使用 ユーザがア プ リ ケーシ ョ ン を実行す る と 、 実行シ ス テムがス タ イル定義を現在の look & feel 定義か ら 各 JSP ページに コ ピ ー し ます。 Web ブ ラ ウザは、 ス タ イル定 義の属性 と フ ォ ームエ レ メ ン ト の属性が統合 し ます。 レ イ アウ ト パネルで も 、 フ ォ ームエ レ メ ン ト を作成する と き には、 現在の Look and Feel の定義が使用 し ます。 ス タ イル定義を設定ま たは変更する ス テ ッ プは、 以下の と お り です。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで、 デ フ ォ ル ト の look & feel 定義を ク リ ッ ク し ます。 Look and Feel ダ イ ア ロ グが コ ン テ ン ト パネルに表示 さ れます。 2. ス タ イルパネルが表示 さ れていなければ、 ス タ イル タ ブ を ク リ ッ ク し ます。 プ ロ ジ ェ ク ト でグ ロ ーバル定義 さ れてい る ス タ イルの名称が表示 さ れた リ ス ト ボ ッ ク スが開き ます。 Unify NXJ 開発者ガ イ ド 154 6 3. ス タ イルを追加す る には、 追加 ボ タ ン を ク リ ッ ク し ます。 ス タ イルの属性は、 パネルの下側の部分で定義 し ます。 4. ス タ イルを削除す る には、 ス タ イルを選択 し て 削除 ボ タ ン を ク リ ッ ク し ま す。 5. OK ボ タ ン を ク リ ッ ク し ます。 プ ロ ジ ェ ク ト で、 こ のス タ イルを使用する コ ン ト ロ ール と フ ォ ームがすべて更新 さ れます。 コ マ ン ド キーマ ッ ピ ングの変更 事前定義 メ ニ ュ ーの フ レ ームセ ッ ト には、 ユーザが も っ と も よ く 使用す る コ マ ン ド であ る、 次 フ ォ ーム、 前 フ ォ ーム、 挿入、 更新、 削除、 終了、 ク リ ア し て検索、 検索、 ズーム、 ア プ リ ケーシ ョ ンの終了が用意 さ れています。 Unify NXJ 開発者ガ イ ド 155 6 ユーザがその他の有効な コ マ ン ド を実行で き る よ う に、 Unify NXJ ア プ リ ケーシ ョ ン プ ラ ッ ト フ ォ ームには、 キーボー ド シ ョ ー ト カ ッ ト が用意 さ れています。 look & feel 定義の コ マ ン ド に割 り 当て ら れたキーボー ド シ ョ ー ト カ ッ ト は、 以下のス テ ッ プ で変更で き ます。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで、 変更 し たい look & feel 定義を ク リ ッ ク し ます。 Look and Feel ダ イ ア ロ グが コ ン テ ン ト パネルに表示 さ れます。 2. キーマ ッ ピ ン グパネルが表示 さ れていなければ、 キーマ ッ ピ ン グ タ ブ を ク リ ッ ク し ます。 Unify NXJ ユーザ コ マ ン ド と 関連する キーボー ド シ ョ ー ト カ ッ ト のセ ッ ト が リ ス ト さ れます。 3. コ マ ン ド にマ ッ プ さ れてい る キース ト ロ ー ク を変更する場合は、 その コ マ ン ド のキース ト ロ ー ク の列に新 し いキース ト ロ ー ク を入力 し ます。 Unify NXJ 開発者ガ イ ド 156 6 キース ト ロ ー ク には フ ァ ン ク シ ョ ン キー を使用す るか、 識別子 と し ての Ctrl、 Alt、 Shift キー と と も に使用 し ます。 Enter キー と Tab キーは、 特別な場合に 使用 し ます ( こ の後の説明を参照 し て く だ さ い)。 Esc キー と BackSpace キー は、 使用で き ません。 キース ト ロ ー ク を完全に削除する には、 BackSpace キー を使用 し ます。 注 – 注 : 入力 し たキーは、 書式化 さ れた文字列 と し て表示 さ れます。 例えば、 Ctrl キー と “g” を同時に押す と 、 キース ト ロ ー ク の列には “Ctrl-G” と 表示 さ れます。 Enter キーのデ フ ォ ル ト の操作は次の入力 フ ィ ール ド に移動す る こ と です。 ただ し 、 ボ タ ン に フ ォ ー カ スがあ る状態で Enter キー を押す と 、 ボ タ ンの コ マ ン ド が実行 さ れます。 Enter キーには、 どのよ う な コ マ ン ド も 割 り 当て る こ と がで き ます。 割 り 当て を変更する には、 以下のス テ ッ プ を実行 し ます。 a. 変更 し たいキーの コ マ ン ド の列を ク リ ッ ク し ます。 b. キース ト ロ ー ク の列のキース ト ロ ー ク 割 り 当て を削除 し ます。 c. キース ト ロ ー ク フ ィ ール ド に フ ォ ー カ スが残 っ ていれば、 Enter キー を押 し ます。 デ フ ォ ル ト では、 Tab と Shift-Tab は次 フ ィ ール ド と 前 フ ィ ール ド に割 り 当て ら れていません。 ブ ラ ウザの タ ブ機能は Tab と Shift-Tab キース ト ロ ー ク に割 り 当て ら れます。 4. 4. OK ボ タ ン を ク リ ッ ク し ます。 キーボー ド シ ョ ー ト カ ッ ト を変更 し た ら 、 必ずユーザに新 し いマ ッ ピ ン グ内容を 知 ら せて く だ さ い。 Unify NXJ 開発者ガ イ ド 157 static content フ ァ イルの追加 7 Unify NXJ プ ロ ジ ェ ク ト には、 あ ら ゆる タ イ プの static content フ ァ イルを含める こ と がで き ます。 NXJ デザ イ ン セ ン タ には、 静的な HTML ページ を配置 し て イ メ ー ジ (.gif、 .jpg な ど) を表示する機能が用意 さ れています。 その他のすべての リ ソ ースは “ ブ ラ ッ ク ボ ッ ク ス ” と し て扱われ、 ユーザの入力は必要あ り ません。 こ れ ら の リ ソ ース を プ ロ ジ ェ ク ト に追加、 削除、 名称を変更する こ と はで き ますが、 表示や編集はで き ません。 イ メ ージ、 HTML ページ、 JSP ページ な どの外部 リ ソ ースや static content フ ァ イル を ア プ リ ケーシ ョ ン に追加する こ と がで き ます。 こ れ ら の リ ソ ース を追加す る場 合は、 新規 static content フ ァ イル と し て追加 し ます。 static content フ ァ イル と フ ォ ームの接続を設定 し ます。 例えば、 フ ォ ームで JSP ページへの リ ン ク を作成する と し ます。 Web ア プ リ ケーシ ョ ン では、 大文字 と 小 文字が区別 さ れるので、 Static Content への参照では大文字 と 小文字を正 し く 区別 する必要があ り ます。 大文字 と 小文字を間違え て も Windows 環境では正 し く 動作 し ますが、 UNIX ベースのシ ス テムであ る JSP に発行する と リ ン ク が壊れる こ と が あ り ます。 その場合は、 フ ァ イル > 新規 > 自に作成 し ます。 を選択 し て、 HTML や JSP のページ を独 注 – フ ァ イルを プ ロ ジ ェ ク ト に追加する前に、 Static Content デ ィ レ ク ト リ に コ ピ ー し てお く 必要があ り ます (下記のス テ ッ プ 2 を参照)。 プ ロ ジ ェ ク ト に static content フ ァ イルを追加する ス テ ッ プは、 以下の と お り です。 1. 1. プ ロ ジ ェ ク ト > フ ァ イルの追加 コ マ ン ド を選択 し 、 フ ァ イルの選択ダ イ ア ロ グ を表示 し ます。 2. フ ァ イルシ ス テムを ブ ラ ウズ し て、 追加す る フ ァ イルを選択 し ます。 158 7 static content フ ァ イルを削除、 完全に削除、 ま たは名称の変更がで き ます。 削除 は、 フ ァ イルを プ ロ ジ ェ ク ト 定義か ら 削除す る コ マ ン ド です。 完全に削除は、 フ ァ イルを プ ロ ジ ェ ク ト 定義か ら 削除 し 、 さ ら に フ ァ イルその も のを完全に削除 する コ マ ン ド です。 HTML および JSP フ ァ イルの作成 デザ イ ン セ ン タ で HTML フ ァ イルや JSP フ ァ イルを作成 し た り 、 別のツ ールか ら イ ン ポー ト する こ と も 可能です。 HTML エデ ィ タ を使 っ て、 静的な HTML/JSP フ ァ イルが編集で き ます。 レ イ アウ ト パネルで フ ォ ーム を編集する方法 と 同 じ ですが、 Display Format のよ う な T-cell プ ロパテ ィ は、 プ ロパテ ィ テーブルに表示 さ れません。 静的な HTML/JSP フ ァ イルは、 プ ロ ジ ェ ク ト パネルで フ ァ イルを ダ ブル ク リ ッ ク し て編集 し ます。 HTML/JSP エデ ィ タ には、 ソ ースパネル と レ イ アウ ト パネルの 2 つのパネルがあ り ます。 ソ ースパネルにはテキス ト エデ ィ タ が表示 さ れ、 ソ ース の構文は色分け さ れています。 レ イ アウ ト パネルは、 フ ォ ームで使用す る レ イ ア ウ ト パネル と 同 じ も のです。 フ ォ ームのレ イ アウ ト パネルでは、 静的 HTML/JSP フ ァ イルが解析で き ない場合、 フ ァ イルが開いて エ ラ ー メ ッ セージが表示 さ れますが、 エデ ィ タ のレ イ アウ ト パ ネルは、 ブ ラ ン ク のま ま です。 HTML/JSP ソ ースは、 テキス ト エデ ィ タ で編集で き ます。 デザ イ ン セ ン タ では、 静的 HTML/JSP フ ァ イルについては拡張属性 フ ァ イルがないので、 再構築は行われません。 フ ォ ームのレ イ アウ ト パネルで フ ォ ーム を表示す る と 、 現在選択 し てい る コ ン ト ロ ールの HTML 属性 と 、 その コ ン ト ロ ール固有のプ ロパテ ィ がブ ラ ウザパネルの プ ロパテ ィ ビ ュ ーに表示 さ れます。 静的 HTML/JSP フ ァ イルを編集す る場合、 プ ロパテ ィ ビ ュ ーには HTML プ ロパテ ィ だけが表示 さ れます。 レ イ アウ ト パネルの フ ォ ームや JSP ソ ースの フ ォ ームは、 いずれ も 変更可能です。 JSP ソ ース を変更 し て レ イ アウ ト パネルに戻る と 、 デザ イ ン セ ン タ が JSP を解析 し て その変更を Web フ ォ ーマ ッ ト で表示 し ます。 JSP を解析で き ない場合は、 テキ ス ト エデ ィ タ で行 っ た変更を元に戻すかど う かを たずねる Yes/No 形式のポ ッ プ ア ッ プ メ ニ ュ ーが表示 さ れます。 はい を選択する と 、 テキス ト エデ ィ タ でお こ な っ た変更が取 り 消 さ れます。 いいえ を選択する と 、 レ イ アウ ト パネルがブ ラ ン ク にな り 、 レ イ アウ ト パネルを変更す る コ マ ン ド がすべて使用で き な く な り ます。 Unify NXJ 開発者ガ イ ド 159 セキ ュ リ テ ィ の設定 と 管理 8 NXJ ア プ リ ケーシ ョ ンは、 J2EE セキ ュ リ テ ィ モデルに従 っ て動作す る よ う に設計 さ れています。 ユーザ と グループ Unify NXJ セキ ュ リ テ ィ シ ス テムは、 Java ア プ リ ケーシ ョ ンサーバのユーザ と グ ループの定義に依存 し ています。 Unify NXJ ツ ールを使 っ て、 ユーザ と グループの 設定や管理を する こ と はあ り ません。 ア プ リ ケーシ ョ ン開発者が、 実行環境のユーザやグループに関 し ての情報を持 っ てい る と は限 り ません。 ア プ リ ケーシ ョ ン開発者は、 実行環境で定義す る ユーザ と グループ を使 っ て セキ ュ リ テ ィ を設定せずに、 事前定義 さ れた ア ク セ ス タ イ プ を使 っ て、 NXJ ア プ リ ケーシ ョ ンのセキ ュ リ テ ィ を設定 し ます。 NXJ ア プ リ ケーシ ョ ンパ ッ ケージが コ ン ト ロ ールセ ン タ に配備 さ れる と 、 コ ン ト ロ ールセ ン タ 管理者は、 あ ら か じ め定義 さ れた各ア ク セ ス タ イ プ を、 1 以上の ユーザグループか、 あ る いは個別のユーザのみにマ ッ プ し ます。 する と 、 開発者 が指定 し た ロ ールのア ク セ ス権が こ れ ら のグループやユーザに設定 さ れ、 特定の フ ォ ームを表示す る よ う な こ と がで き ます。 注 – WebLogic では、 現在のグループ と ユーザは WebLogic Administrative Console を使 っ て指定 し ます。 eWave Engine では、 現在のユーザは Administrative Console で ホ ス ト 名を右 ク リ ッ ク し て設定 し ます。 セキ ュ リ テ ィ の対象 Unify NXJ ア プ リ ケーシ ョ ン には、 以下のよ う な セキ ュ リ テ ィ があ り ます。 160 8 • ア プ リ ケーシ ョ ン、 ア プ リ ケーシ ョ ンの フ ォ ーム、 static content フ ァ イルへ のユーザア ク セ ス コ ン ト ロ ール。 • ユーザが フ ォ ームか ら 呼び出す こ と がで き る、 デー タ ベース操作の コ ン ト ロ ール。 レ コ ー ド の検索、 も し く は削除な ど。 NXJ コ ン ト ロ ールセ ン タ のア プ リ ケーシ ョ ン に関連す る他の リ ソ ースや、 ア ク シ ョ ン に も セキ ュ リ テ ィ が設定で き ます。 詳細については、 『Unify NXJ 管理者ガ イ ド 』 を参照 し て く だ さ い。 ア ク セス コ ン ト ロール ア プ リ ケーシ ョ ンのセキ ュ リ テ ィ は、 ア プ リ ケーシ ョ ン コ ン ポーネ ン ト と デー タ ベース ア ク シ ョ ンへのア ク セ ス コ ン ト ロ ールで管理 し ます。 ア ク セ ス コ ン ト ロ ー ル と は、 実行時に コ ン ポーネ ン ト やデー タ ベース操作呼び出 し に設定 さ れる セ キ ュ リ テ ィ の タ イ プ です。 ア ク セ ス コ ン ト ロ ールには、 以下の 2 種類があ り ます。 : • すべてのユーザ • 認証 さ れたユーザのみ デ フ ォ ル ト の Unify NXJ ア ク セ ス コ ン ト ロ ールは “ すべてのユーザ ” です。 ア ク セ ス コ ン ト ロ ールは、 こ の後で説明す る方法を使 っ て変更 し ます。 すべてのユーザ すべてのユーザにはあ ら ゆる ユーザが含まれてお り 、 ロ グ イ ンの有無を問いませ ん。 認証 さ れたユーザ (ロ グ イ ン あ り ) だけで な く 、 匿名ユーザ (ロ グ イ ン な し ) に も ア ク セ ス権が認め ら れています。 認証 さ れたユーザのみ 認証 さ れたユーザだけが、 NXJ コ ン ト ロ ールセ ン タ に ロ グ イ ン で き ます。 ロ グ イ ン認証 (ユーザ名 と パスワー ド ) を使 っ て、 NXJ コ ン ト ロ ールセ ン タ (ま たは実 行中のア プ リ ケーシ ョ ン) にあ ら ゆる リ ク エ ス ト を行 う こ と がで き ます。 ロ グ イ ン認証はブ ラ ウザが開いてい るか、 ユーザが “ ロ グオ フ ” する ま では有効です。 Unify NXJ 開発者ガ イ ド 161 8 匿名ユーザが匿名ア ク セ スが許可 さ れていない リ ソ ースに初めて ア ク セ ス し よ う と す る と 、 ロ グ イ ン フ ォ ームが表示 さ れます。 こ のユーザが有効なユーザ名 と パ スワー ド を入力 し て正 し く 認証 さ れる と 、 指定 し た リ ソ ースへのア ク セ ス権が こ のユーザに認め ら れてい るかど う かを NXJ コ ン ト ロ ールセ ン タ が判断 し ます。 ア ク セス コ ン ト ロールの指定 こ こ では、 以下のオ ブ ジ ェ ク ト にア ク セ ス コ ン ト ロ ールを割 り 当て る方法を説明 し ます。 • ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト • Static content フ ァ イル • デー タ ベース操作 ア プ リ ケーシ ョ ンのエ ン ト リ ポ イ ン ト ア プ リ ケーシ ョ ン全体のア ク セ ス コ ン ト ロ ールに よ っ て、 ア プ リ ケーシ ョ ン全体 のア ク セ ス コ ン ト ロ ールが設定 さ れます。 つま り 、 エ ン ト リ ポ イ ン ト 以降の フ ォ ームのア ク セ ス コ ン ト ロ ールにかかわ り な く 、 その フ ォ ーム を利用する には、 エ ン ト リ ポ イ ン ト で ア ク セ スが認証 さ れる必要があ り ます。 エ ン ト リ ポ イ ン ト フ ォ ームのア ク セ ス コ ン ト ロ ールは、 エ ン ト リ ポ イ ン ト ダ イ ア ロ グで指定 し ます。 ア ク セ ス コ ン ト ロ ールを設定す る ス テ ッ プは、 以下の と お り です。 1. ブ ラ ウザパネルのプ ロ ジ ェ ク ト ビ ュ ーで、 エ ン ト リ ポ イ ン ト に指定す る フ ォ ームを右 ク リ ッ ク し ます。 2. ポ ッ プ ア ッ プ メ ニ ュ ーのエ ン ト リ ポ イ ン ト の追加を選択 し ます。 既存のエ ン ト リ ポ イ ン ト を変更する場合は、 エ ン ト リ ポ イ ン ト の編集を選択 し ます。 Unify NXJ 開発者ガ イ ド 162 8 エ ン ト リ ポ イ ン ト ダ イ ア ロ グが表示 さ れます。 3. ア プ リ ケーシ ョ ン に設定する ア ク セ ス コ ン ト ロ ールの タ イ プ を選択 し ます。 ド ロ ッ プ ダウ ン リ ス ト か ら タ イ プ を選択 し て く だ さ い。 以下のよ う なオ プ シ ョ ンがあ り ます。 • すべてのユーザ • 認証 さ れたユーザのみ 4. OK ボ タ ン を ク リ ッ ク し ます。 こ のダ イ ア ロ グには、 セキ ュ リ テ ィ と は関係がない フ ィ ール ド も あ り ます。 こ れ ら の フ ィ ール ド についての詳細は、 70 ページの 「エ ン ト リ ポ イ ン ト フ ォ ームの指 定」 を参照 し て く だ さ い。 Static Content ア プ リ ケーシ ョ ンの static content フ ァ イルでは、 すべて同 じ ア ク セ ス コ ン ト ロ ー ルが共有 さ れてお り 、 フ ァ イルご と に異な る ア ク セ ス コ ン ト ロ ールを指定す る こ と はで き ません。 ア プ リ ケーシ ョ ンの static content フ ァ イルにア ク セ ス コ ン ト ロ ールを設定する ス テ ッ プは、 以下の と お り です。 Unify NXJ 開発者ガ イ ド 163 8 1. 1. デザ イ ン セ ン タ メ イ ン ウ イ ン ド ウで、 プ ロ ジ ェ ク ト > プ ロパテ ィ を選択 し ます。 2. 環境パネルを選択 し ます。 3. Static Content ア ク セ ス コ ン ト ロ ール フ ィ ール ド の ド ロ ッ プ ダウ ン リ ス ト か ら 、 ア ク セ ス コ ン ト ロ ールの タ イ プ を選択 し ます。 4. OK ボ タ ン を ク リ ッ ク し ます。 デー タ ベース操作 65 ページの 「デー タ ベース操作を許可 し ない」 を参照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 164 実行 と パ ッ ケージ ング 9 ア プ リ ケーシ ョ ン開発プ ロ セ スのどの段階で も 、 NXJ デザ イ ン セ ン タ で プ ロ ジ ェ ク ト > 実行 を選択す る と ア プ リ ケーシ ョ ンが実行で き ます。 ア プ リ ケーシ ョ ン を 実行する と フ ォ ームス ク リ プ ト が コ ンパ イル さ れ、 出力 フ ァ イルが EAR フ ァ イル にパ ッ ケージ さ れます。 こ のパ ッ ケージは、 ロ ー カル NXJ コ ン ト ロ ールセ ン タ に 配備 さ れます。 ア プ リ ケーシ ョ ンが配備 さ れた ら 、 ユーザが実際に使用す る よ う にア プ リ ケー シ ョ ンの フ ォ ームを使用 し 、 ア プ リ ケーシ ョ ン を テ ス ト し ます。 NXJ イ ン タ ラ ク シ ョ ンサーバが フ ォ ームの実行を管理 し ます。 注 – Java ア プ リ ケーシ ョ ンサーバが WebSphere 4.x の場合は、 実行 コ マ ン ド が使 用で き ません。 NXJ コ ン ト ロ ールセ ン タ は、 WebSphere 4.x に配備で き ないためで す。 こ の場合は、 ア プ リ ケーシ ョ ンパ ッ ケージ を手動で配備 し ます。 『Unify NXJ 管理者ガ イ ド 』 の付録 C 「IBM WebSphere 4.x ア プ リ ケーシ ョ ンサーバに配置する NXJ ア プ リ ケーシ ョ ン」 を参照 し て く だ さ い。 Unify NXJ ア プ リ ケーシ ョ ン で予期 し ない結果が発生 し た場合は、 NXJ デバ ッ ガ で 実行内容を確認 し ます。 『Unify jBiz 言語ガ イ ド 』 の第 6 章 「NXJ デバ ッ ガ」 を参 照 し て く だ さ い。 実行 コ マ ン ド : コ ンパイル、 Make、 配備 実行 コ マ ン ド には、 以下の 4 つの タ ス ク フ ェ ーズがあ り 、 こ の順 に実行 さ れます。 • プ ロ ジ ェ ク ト の フ ォ ーム と Java フ ァ イルを コ ンパ イル Run ボ タ ン • ア プ リ ケーシ ョ ンパ ッ ケージの Make • ア プ リ ケーシ ョ ンパ ッ ケージ を ロ ー カル コ ン ト ロ ールセ ン タ に配備 165 9 • ア プ リ ケーシ ョ ン を開始 し て、 エ ン ト リ フ ォ ームを表示、 ま たは複数のエ ン ト リ フ ォ ームが定義 さ れてい る場合は メ ニ ュ ー を表示 コ ンパイルフ ェ ーズ プ ロ ジ ェ ク ト の フ ォ ームス ク リ プ ト と Java フ ァ イル (あれば) がまず jBiz コ ンパ イ ラ で コ ンパ イル さ れ、 次に Java コ ンパ イ ラ で コ ンパ イル さ れます。 Java コ ンパ イ ラ は JDK に付属 し ています。 コ ンパ イルエ ラ ーや警告があ る場合は、 メ ッ セー ジパネルの コ ンパ イ ラ ビ ュ ーに表示 さ れます。 エ ラ ー内容の表示 ス ク リ プ ト の該当行 Unify NXJ 開発者ガ イ ド 166 9 エ ラ ーは赤で、 警告は黒で表示 さ れます。 フ ォ ームス ク リ プ ト で エ ラ ーや警告が 発生 し た行を確認する には、 メ ッ セージパネルのエ ラ ー メ ッ セージや警告を ク リ ッ ク し ます。 ス ク リ プ ト エデ ィ タ がス ク ロ ール し て、 その行が赤でハ イ ラ イ ト さ れます。 Make フ ェ ーズ Make フ ェ ーズでは、 以下の タ ス ク が実行 さ れます。 • プ ロ ジ ェ ク ト の次 フ ォ ーム リ ス ト の全 フ ォ ームが ク ラ ス フ ォ ルダにあ る こ と を確認する • Static Content フ ォ ルダの static content フ ァ イルを すべて output デ ィ レ ク ト リ の該当個所に コ ピ ーする • フ ォ ームを Java に変換 し て コ ンパ イル し 、 その結果生成 さ れた フ ァ イルを output デ ィ レ ク ト リ の該当個所に配置する • プ ロ ジ ェ ク ト のすべての接続へのデー タ ソ ース参照を持つデプ ロ イ メ ン ト デ ィ ス ク リ プ タ を作成す る • ア プ リ ケーシ ョ ンパ ッ ケージ (EAR フ ァ イル) を作成 し 、 output デ ィ レ ク ト リ に配置す る。 169 ページの 「ア プ リ ケーシ ョ ンのパ ッ ケージ ン グ」 を参照 し て く だ さ い。 Make コ マ ン ド の実行中、 NXJ デザ イ ン セ ン タ にス テー タ ス ダ イ ア ロ グが表示 さ れ ます。 ダ イ ア ロ グには、 上記の タ ス ク の進行状況が表示 さ れます。 こ のダ イ ア ロ グの 取消 ボ タ ン を ク リ ッ ク する と 、 実行中の Make コ マ ン ド が取 り 消 さ れます。 配備 フ ェ ーズ を実行せずに Make フ ェ ーズ を実行 し たい場合には、 以下に示す Make コ マ ン ド のどれかを選択 し ます。 Make フ ェ ーズでは、 コ ンパ イル コ マ ン ド が自動的に実行 さ れます。 Unify NXJ 開発者ガ イ ド 167 9 Unify NXJ には、 以下のよ う な Make コ マ ン ド が用意 さ れています。 表 9-1 Make コ マ ン ド の種類 Make コ マ ン ド 目的 プ ロ ジ ェ ク ト > すべて Make 最後の Make 以降変更があ っ たかど う かにかかわ ら ず、 プ ロ ジ ェ ク ト の全 フ ァ イルが Make さ れます。 プ ロ ジ ェ ク ト > 変更分のみ Make 最後に Make コ マ ン ド が実行 さ れた後、 Make さ れて いないプ ロ ジ ェ ク ト の全 フ ァ イルが Make さ れます。 プ ロ ジ ェ ク ト > Make > < フ ォ ーム名 > 指定 し た フ ァ イルだけが Make さ れます。 配備フ ェ ーズ 配備 フ ェ ーズでは、 Unify NXJ に よ っ て ア プ リ ケーシ ョ ン フ ァ イルが Java ア プ リ ケーシ ョ ンサーバに コ ピ ー さ れ、 Web ブ ラ ウザ (ホ ス ト のデ フ ォ ル ト の Web ブ ラ ウザ) が起動 し て、 ア プ リ ケーシ ョ ンのエ ン ト リ フ ォ ームが表示 さ れます。 ア プ リ ケーシ ョ ン に複数のエ ン ト リ フ ォ ームがあ る場合は、 メ ニ ュ ーが表示 さ れます。 フ ォ ームのテキス ト が フ ォ ームの他のオ ブ ジ ェ ク ト と 重な る場合は、 デザ イ ン セ ン タ のレ イ アウ ト で テキス ト のサ イ ズ を変更 し ます。 Internet Explorer では、 表示 > 文字のサ イ ズ を選択 し てサ イ ズ を変更 し ます。 Netscape では、 表示 > テキ ス ト ズーム を選択 し ます。 NXJ ア プ リ ケーシ ョ ン で使用で き る Web ブ ラ ウザについては、 NXJ ReadMe を参 照 し て く だ さ い。 注 – プ ロ ジ ェ ク ト > 実行 コ マ ン ド を選択す る と 、 ア プ リ ケーシ ョ ンパ ッ ケージが ロー カルの コ ン ト ロールセ ン タ に配備 さ れます。 実際のア プ リ ケーシ ョ ンの運用 版を配備す る場合は、 こ こ で説明す る配備プ ロ セ ス ではな く 、 コ ン ト ロ ールセ ン タ の配備ウ ィ ザー ド を ご使用 く だ さ い。 開発環境 と 実運用環境は異な る と 考え ら れるか ら です。 テス ト のヒ ン ト ア プ リ ケーシ ョ ン を テ ス ト する場合は、 以下の点に注意 し て下 さ い。 • 正 し いア プ リ ケーシ ョ ン オ ブ ジ ェ ク ト が含まれてい る こ と 。 Unify NXJ 開発者ガ イ ド 168 9 ブ ラ ウザ パネルのプ ロ ジ ェ ク ト ビ ュ ーで エ ン ト リ を確認 し 、 ア プ リ ケーシ ョ ンの フ ォ ーム と static content フ ァ イルが含まれてい る こ と を確認 し ます。 不要なオ ブ ジ ェ ク ト を削除 し て、 ア プ リ ケーシ ョ ンパ ッ ケージのサ イ ズ を小 さ く し ます。 • ア プ リ ケーシ ョ ン に必要な JAR フ ァ イルが ク ラ スパスに含まれてい る こ と 。 プ ロ ジ ェ ク ト の ク ラ スパスは、 プ ロ ジ ェ ク ト > プ ロパテ ィ > ク ラ スパス を選 択す る と 表示 さ れます。 不要な JAR フ ァ イルを削除 し て、 ア プ リ ケーシ ョ ンパ ッ ケージのサ イ ズ を小 さ く し ます。 • エ ン ト リ ポ イ ン ト が定義 さ れ、 メ ニ ュ ーが定義があ る こ と 。 NXJ コ ン ト ロ ー ルセ ン タ か ら ア プ リ ケーシ ョ ン にア ク セ スす る際に、 こ れ ら が使用 さ れま す。 70 ページの 「エ ン ト リ ポ イ ン ト フ ォ ームの指定」 を参照 し て下 さ い。 • ア プ リ ケーシ ョ ン実行中は、 ユーザ と 同 じ よ う に フ ォ ーム を使用 し て テ ス ト し ます。 通常の操作だけではな く 、 間違 っ た操作 も 実行 し てみます。 例えば、 不正な 値を入力 し た り 、 禁止 さ れてい る操作を行 っ た り 、 無効な フ ァ ン ク シ ョ ン キー を使 っ た り し てみて く だ さ い。 エ ラ ーが発生 し た場合は、 エ ラ ー メ ッ セージに正 し い解決方法が示 さ れてい るかど う かを確認 し ます。 エ ン ド ユーザの前で フ ォ ームを実際に動か し て、 意見を聞いてみて く だ さ い。 一般的なユーザに使い勝手を試 し て も ら う の も いいで し ょ う 。 テ ス ト の結果に基づいて、 フ ォ ーム、 エ ラ ー メ ッ セージ、 ヘルプ、 マ ニ ュ ア ルを変更 し ます。 ア プ リ ケーシ ョ ンのパ ッ ケージ ング ア プ リ ケーシ ョ ンパ ッ ケージは、 プ ロ ジ ェ ク ト の Make コ マ ン ド を実行する たびに 作成 さ れます。 実行 コ マ ン ド の結果が満足のい く も のであれば、 こ のア プ リ ケー シ ョ ンパ ッ ケージ を実運用環境に配備 し ます。 ア プ リ ケーシ ョ ンパ ッ ケージは、 以下のデ ィ レ ク ト リ に作成 さ れます。 <NXJWork>\projects\<project_name>\output\<project_name>.ear. Unify NXJ 開発者ガ イ ド 169 9 パ ッ ケージ を コ ン ト ロ ールセ ン タ 管理者に渡 し て配備 し て も ら います。 ま たは J2EE Enterprise Application Archive と し て配備 し ます。 詳細については 『Unify NXJ 管理者ガ イ ド 』 を参照 し て く だ さ い。 ア プ リ ケーシ ョ ンの使用についての詳細は、 『Unify NXJ ユーザーズガ イ ド 』 を参 照 し て く だ さ い。 Unify NXJ 開発者ガ イ ド 170 プ ロパテ ィ の概要 A 以下の表には、 NXJ デザ イ ン セ ン タ のプ ロパテ ィ グループ と 関連する jBiz プ ロパ テ ィ の フ ォ ーム と コ ン ト ロ ールの概要が示 さ れています。 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 1 / 1 0 ) デザ イ ン セン タ エレ メ ン ト Form グループ名 と プ ロパテ ィ 名 同等の jBiz プ ロパテ ィ Database Auto Find Clear After Add Connection Find Count Sql Optional Condition Sql Order By Clause Start In Add Mode Target Table autoFind clearAfterAdd connectionName findCount sqlOptionalCondition sqlOrderByClause startInAddMode targetTable Auto Commit Click On Field Footer Header Menu Label Next Form List Title Toolbar autoCommit Add Allowed Delete Allowed Find Allowed Update Allowed addAllowed deleteAllowed findAllowed updateAllowed Form Security 171 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 2 / 1 0 ) デザ イ ン セン タ エレ メ ン ト Form (cant) グループ名 と プ ロパテ ィ 名 同等の jBiz プ ロパテ ィ Visual Background Border-color Border-style Border-width Font Family Font Size Foreground Height Style Wallpaper Width Zoom Zoom Return Expressions Unify NXJ 開発者ガ イ ド zoomReturnExpressions 172 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 3 / 1 0 ) デザ イ ン セン タ エレ メ ン ト Text Field グループ名 と プ ロパテ ィ 名 同等の jBiz プ ロパテ ィ Database Db Length Db Type Target Field dbLength dbType targetField Data Type Multi Valued Name dataType multiValued name FYI Message Help URL Immediate Required Stop For Input Updateable fyiMessage Auto Accept Case Conversion Display Format Display Justify Field Length Password autoAccept caseConversion displayFormat displayJustify fieldLength password General Interactive required stopForInput updateable Text Unify NXJ 開発者ガ イ ド 173 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 4 / 1 0 ) デザ イ ン セン タ エレ メ ン ト Text Field (cont) グループ名 と プ ロパテ ィ 名 同等の jBiz プ ロパテ ィ Visual Background Border-color Border-style Border-width Font Family Font Size Foreground Left Size Style Tooltip Top Width Zoom Return Values Into Zoom Active Mode Zoom Consistency Mode Zoom Form Unify NXJ 開発者ガ イ ド zoomReturnValuesInto zoomActiveMode zoomFormConsistencyMode zoomFormName 174 A 表 A-1 デザ イ ン セン タ エレ メ ン ト フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 5 / 1 0 ) グループ名 と プ ロパテ ィ 名 Button Button General Interactive Visual Title Name Command Background Border-color Border-style Border-width Font Family Font Size Foreground Height Left Style Tooltip Top Width Image Button General Interactive Visual Name Command Background Border-color Border-style Border-width Font Family Font Size Foreground Height Left Source Style Tooltip Top Width Unify NXJ 開発者ガ イ ド 同等の jBiz プ ロパテ ィ 175 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 6 / 1 0 ) デザ イ ン セン タ エレ メ ン ト Label グループ名 と プ ロパテ ィ 名 General Label Visual Styled Text General Visual 同等の jBiz プ ロパテ ィ Name Align Title Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Tooltip Top Width Name Background Border-color Border-style Border-width Font Family Font Size Foreground Height Left Style Tooltip Top Width Unify NXJ 開発者ガ イ ド 176 A 表 A-1 デザ イ ン セン タ エレ メ ン ト フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 7 / 1 0 ) グループ名 と プ ロパテ ィ 名 Dynamic Text Field General Text Visual Name Expression Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Tooltip Top Width Box General Visual Name Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Title Top Width Image General Visual Name Height Left Source Top Width Unify NXJ 開発者ガ イ ド 同等の jBiz プ ロパテ ィ 177 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 8 / 1 0 ) デザ イ ン セン タ エレ メ ン ト グループ名 と プ ロパテ ィ 名 Line General Visual Name Background Border-color Border-style Border-width Font Family Font Size Foreground Left Size Style Tooltip Top Width Link General Interactive Link Name Command Href Text Background Border-color Border-style Border-width Font Family Font Size Foreground Left Source Style Tooltip Top Visual Unify NXJ 開発者ガ イ ド 同等の jBiz プ ロパテ ィ 178 A 表 A-1 デザ イ ン セン タ エレ メ ン ト フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 9 / 1 0 ) グループ名 と プ ロパテ ィ 名 Repeating Area Repeating Area Visual Type Background Border-color Border-style Border-width Font Family Font Size Foreground Height Left Style Tooltip Top Width Tab Set General Visual Name Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Tooltip Top Width Unify NXJ 開発者ガ イ ド 同等の jBiz プ ロパテ ィ 179 A 表 A-1 フ ォ ームエ レ メ ン ト と プ ロパテ ィ ( 1 0 / 1 0 ) デザ イ ン セン タ エレ メ ン ト グループ名 と プ ロパテ ィ 名 Tab Insert General Tab Visual Name Title Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Tooltip Top Table General Table Name Alternate Row Style Cell Padding Cell Spacing Group Size Row Style Visual Background Border-color Border-style Border-width Font Family Font Size Foreground Left Style Tooltip Top Wallpaper Width Unify NXJ 開発者ガ イ ド 同等の jBiz プ ロパテ ィ 180