新機能 PowerBuilder® 11

新機能
PowerBuilder® 11
Document ID: DC00357-01-1110-01
Last revised: April, 2008
項目
Vista サポー ト
.NET 配布機能
Web サービ ス の機能拡張
デー タ ウ ィ ン ド ウ の機能拡張
ウ ィ ン ド ウ コ ン ト ロ ールの新 し い機能
PowerBuilder ユーザ イ ン タ フ ェース の機能拡張
新規お よ び変更 さ れた PowerBuilder コ ン ト ロ ール
言語の機能拡張
デー タ ベース接続の機能拡張お よ び変更
JDK 1.5 のサポー ト
ページ
2
12
22
28
40
41
50
65
69
85
Copyright 1991-2008 by Sybase, Inc. All rights reserved. Sybase trademarks can be viewed at the Sybase trademarks page
at http://www.sybase.com/detail?id=1011207. Sybase and the marks listed are trademarks of Sybase, Inc. ® indicates registration in the United States
of America. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Unicode
and the Unicode Logo are registered trademarks of Unicode, Inc. All other company and product names mentioned may be trademarks of the respective companies with which they are associated.
Vista サポー ト
Vista サポー ト
PowerBuilder® 11 開発環境は、 Microsoft Windows Vista オペレーテ ィ ン
グ シ ス テ ム の Vista Business Edition の 32 ビ ッ ト 版 と 64 ビ ッ ト 版の両
方を使用 し て テ ス ト し ま し た。 配布アプ リ ケーシ ョ ンは、 同 じ Vista エ
デ ィ シ ョ ン を 使 用 し て テ ス ト し ま し た。 PowerBuilder 開 発 環 境 と
PowerBuilder を 使用 し て 作成 さ れ た ア プ リ ケ ー シ ョ ン は、 両方の プ
ラ ッ ト フ ォ ーム で 32 ビ ッ ト アプ リ ケーシ ョ ン と し て実行 さ れ ます。
Microsoft 社は、 ソ フ ト ウ ェ アのための Windows Vista ロ ゴ プ ロ グ ラ ム
を制定 し ま し た。 こ のプ ロ グ ラ ム には、 「Certified for Windows Vista」 と
「Works with Windows Vista」 の 2 つの レベルがあ り ます。 PowerBuilder
11 は、 Works with Windows Vista 要件を満た し ます。 PowerBuilder で構
築 さ れた アプ リ ケーシ ョ ンは、Certified for Windows Vista 要件を満たす
よ う に設計 さ れ ます。 こ れ ら の要件の詳細については、 Microsoft Web
サ イ ト を参照 し て く だ さ い。
ユーザ ア カ ウ ン ト および管理者特権
Windows Vista での重要な変更の一つは、ユーザ ア カ ウ ン ト 制限(UAC:
User Account Control) の導入です。 UAC は、 Vista 上でユーザが実行す
る デ フ ォ ル ト の特権を制限す る ために Vista が使用す る メ カ ニ ズ ム で
す。 こ れ ら の特権の制限は、 ユーザのア ク シ ョ ン がシ ス テ ム の設定あ
る いはほかのユーザの状態や設定に影響す る こ と を少な く す る こ と を
目的 と し てい ます。
標準ユーザ (ユーザ グループの メ ンバー) の特権は、 制限 さ れてい ま
す。 標準ユーザは、 ほ と ん ど のアプ リ ケーシ ョ ン を イ ン ス ト ール し た
り 、 シ ス テ ム設定を変更 し た り 、 ほかのほ と ん ど の管理 タ ス ク を実行
し た り す る こ と がで き ません。
管理者は、 昇格特権を持ち ま す。 管理者グループの メ ンバー (ま たは
昇格特権を持つほかのグループ) であ る ユーザが、 Vista コ ン ピ ュ ー タ
に ロ グ オ ン す る と 、 対話型 ロ グ イ ン 処理は管理者の昇格特権 を 示す
ト ー ク ンに加え て、制限 さ れた ト ー ク ン を作成 し ます。制限 さ れた ト ー
ク ンは、 標準ユーザの特権を持ち、 対話先のデス ク ト ッ プ と Windows
Explorer セ ッ シ ョ ン を作成す る ために使用 さ れ ます。
ユーザの昇格特権は、 必要な と き に使用す る こ と がで き ます。 ユーザ
が管理者特権を要求す る 操作を行お う と す る と 、 ユーザに操作の許可
を求め る プ ロ ン プ ト が表示 さ れます。
2
新機能
Vista サポー ト
ユーザがア イ コ ン を ダブル ク リ ッ ク す る か、 ス タ ー ト メ ニ ュ ーか ら 選
択す る と 、 プ ロ セ ス は制限 さ れた ト ー ク ン を継承 し ます。 アプ リ ケー
シ ョ ン がマ ニ フ ェ ス ト フ ァ イ ルで昇格特権 を 要求す る よ う に指定 さ
れてい る と 、 UAC は こ れ ら の特権で実行す る こ と を認め る よ う にユー
ザにプ ロ ン プ ト を表示 し ます。 マニ フ ェ ス ト フ ァ イ ルの詳細について
は、 4 ページの 「マニ フ ェ ス ト フ ァ イ ル」 を参照 し て く だ さ い。
ス タ ー ト メ ニ ュ ーあ る いは Explorer で右 ク リ ッ ク し て、 ポ ッ プア ッ プ
メ ニ ュ ーか ら [管理者 と し て実行] を選択 し て、 アプ リ ケーシ ョ ン を
管理者特権で開始す る こ と がで き ます。
PowerBuilder のイ ン ス ト ール
Windows Vista に PowerBuilder を イ ン ス ト ールす る には、 管理者特権が
必要です。 正 し く イ ン ス ト ールが完了す る よ う にす る には、 setup.exe
あ る いは autorun.exe フ ァ イ ルを右 ク リ ッ ク し て、 [管理者 と し て実行]
を選択 し ます。
PowerBuilder の実行
PowerBuilder は 通常 Program Files デ ィ レ ク ト リ に複数の フ ァ イ ルを書
き 込みます。 書 き 込まれ る フ ァ イ ルは、 pb.ini、 PB110_sysam.properties、
コ ー ド サ ン プル、 チ ュ ー ト リ アル、 お よ びデモ デー タ ベー ス フ ァ イ
ルです。 管理者特権を持たずにアプ リ ケーシ ョ ン を実行す る と 、 Vista
は レ ジ ス ト リ の HKEY_LOCAL_MACHINE サ ブ ツ リ ー、 Program Files
デ ィ レ ク リ 、お よ び Windows デ ィ レ ク ト リ への書 き 込みを制限 し ます。
かわ り に、 変更点は レ ジ ス ト リ 内の書 き 込み可能な領域お よ びユーザ
の local デ ィ レ ク ト リ に書 き 込まれます。こ れは、仮想化 と 呼ばれます。
た と えば、 管理者特権 を 持たずに PowerBuilder を 開始す る と 、 pb.ini
フ ァ イ ルは C:\Users\<your_name>\AppData\VirtualStore デ ィ レ ク ト リ
内の Program Files\Sybase\PowerBuilder 11.0\pb.ini に書 き 込ま れ ます。
こ の動作に よ る 問題を避け る ために、 Vista では、 ス タ ー ト メ ニ ュ ーあ
る いは Explorer で pb110.exe を右 ク リ ッ ク し て、 そのポ ッ プア ッ プ メ
ニ ュ ー か ら [管 理 者 と し て 実 行] を 選 択 し て、 管 理 者 特 権 で
PowerBuilder 11 を起動す る 必要があ り ます。
PowerBuilder 11
3
Vista サポー ト
マニ フ ェ ス ト フ ァ イル
Windows Vista ロ ゴ プ ロ グ ラ ム の認定要件を満たすア プ リ ケーシ ョ ン
を Windows Vista オペレーテ ィ ン グ シ ス テ ムへ配布す る 場合には、ユー
ザ ア カ ウ ン ト 制御 (UAC: User Account Control) ガ イ ド ラ イ ン に準拠
す る 必要があ り ます。 実行フ ァ イ ルには、 実行レベルを指定 し 、 別の
ウ ィ ン ド ウ のユーザ イ ン タ フ ェ ー ス への ア ク セ ス が必要か を 指定 し
た埋め込みマ ニ フ ェ ス ト が必要です。 Vista の ア プ リ ケーシ ョ ン 情報
サービ ス (AIS: Application Information Service) はマニ フ ェ ス ト フ ァ イ
ルを確認 し て、 プ ロ セ ス を起動す る 特権を判別 し ます。 こ れ ら のプ ロ
パテ ィ を指定す る には、 プ ロ ジ ェ ク ト ペ イ ン タ の [セキ ュ リ テ ィ ] タ
ブ ページ を使用 し ます。
生成オプ シ ョ ン
アプ リ ケーシ ョ ンに Vista 認定が必要な場合には、「Embedded manifest」
を選択 し ます。 選択 し た実行レベルが記述 さ れたマニ フ ェ ス ト フ ァ イ
ルは、 アプ リ ケーシ ョ ンの実行フ ァ イ ルに埋め込まれます。
「External manifest」 を選択す る と 、 アプ リ ケーシ ョ ンの実行フ ァ イ ル と
と も に配布す る 、 独立 し たマニ フ ェ ス ト フ ァ イ ルを XML 形式で生成
し ま す。 あ る いは、 マ ニ フ ェ ス ト フ ァ イ ルの配布が不要な場合には、
「No manifest」 を選択す る こ と も で き ます。
埋め込みマニ フ ェ ス ト が必要 と する .NET 2.0 SDK
Windows フ ォーム タ ーゲ ッ ト で [Embedded manifest] を選択す る 場合、
シ ス テ ムに .NET 2.0 SDK が イ ン ス ト ール さ れてい る 必要があ り ます。
こ れは、 実行フ ァ イ ルにマニ フ ェ ス ト を埋め込むプ ロ セ ス が、 SDK で
配布 さ れ る mt.exe ツールを使用す る か ら です。
実行レ ベル
昇格特権ま たは管理者特権が不要な アプ リ ケーシ ョ ン の場合には、「As
Invoker」 を選択 し ます。 Vista 認定を受け る には、 異な る 実行レベルを
選択す る 場合に備え て、 アプ リ ケーシ ョ ン を変更 し て管理機能を別プ
ロ セ ス に分離す る こ と が必要にな り ます。
管理者グループの メ ンバーがアプ リ ケーシ ョ ン のプ ロ セ ス を作成す る
必要が あ る 場合には、 「Require Administrator」 を 選択 し ま す。 ア プ リ
ケーシ ョ ン のユーザが管理者 と し てプ ロ セ ス を開始 し ない場合、 メ ッ
セージ ボ ッ ク ス が表示 さ れ、 ユーザに適切な資格情報の入力を促 し ま
す。
プ ロ セ ス を開始す る ユーザに提供で き る 最高特権を AIS が入手す る に
は、 「Highest Available」 を選択 し ます。
4
新機能
Vista サポー ト
UI ア ク セス
ス ク リ ー ン キーボー ド の よ う な、 デ ス ク ト ッ プ上で高 レ ベル特権の
ウ ィ ン ド ウ への入力が必要な アプ リ ケーシ ョ ンの場合には、[保護 さ れ
たシ ス テ ム UI へのア ク セ ス を許可す る ] チ ェ ッ ク ボ ッ ク ス を オ ンに し
ます。 ほ と ん ど のアプ リ ケーシ ョ ン では、 こ のチ ェ ッ ク ボ ッ ク ス を オ
ン にす る 必要は あ り ま せん。 Microsoft 社は こ の設定 を ユーザ イ ン タ
フ ェ ース支援技術 (米国 リ ハビ リ テー ョ ン法 508 条) のために提供 し
てい ます。
Authenticode の署名が必要
[保護 さ れたシ ス テ ム UI へのア ク セ ス を許可す る ] チ ェ ッ ク ボ ッ ク ス
を オ ン に し た場合、 アプ リ ケーシ ョ ンには Authenticode 署名が必要で、
Program Files ま たは Windows\system32 の よ う な保護 さ れた場所にアプ
リ ケーシ ョ ン を置 く 必要があ り ます。
署名付き DLL
Vista 上 で ア プ リ ケ ー シ ョ ン を 実行す る と き 、 ア プ リ ケ ー シ ョ ン が
Authenticode 証明書で署名 さ れて い な い DLL を 使用す る 場合に Vista
は警告を出 し ます。 Windows Vista ロ ゴ認定を付けて アプ リ ケーシ ョ ン
を配布 し たい場合は、 アプ リ ケーシ ョ ン と 配布す る DLL はすべて署名
さ れてい る 必要があ り ます。 PowerBuilder ラ ン タ イ ム DLL お よ びほか
の PowerBuilder DLL は署名 さ れてい ます。
Web フ ォ ーム用ア プ リ ケーシ ョ ン プールのセ ッ ト ア ッ プ
IIS 内の仮想デ ィ レ ク ト リ は、 アプ リ ケーシ ョ ン プール内にホ ス ト さ
れ ます。 アプ リ ケーシ ョ ン プールは、 1 つ以上の Web アプ リ ケーシ ョ
ン のホ ス ト プ ロ セ ス です。 PowerBuilder Web フ ォ ーム アプ リ ケーシ ョ
ン を IIS 7 に配布す る と 、アプ リ ケーシ ョ ンは DefaultAppPool に配布 さ
れ ます。 デフ ォ ル ト では、 こ のアプ リ ケーシ ョ ン プールは統合マネー
ジ パ イ プ ラ イ ン モー ド を使用 し ます。 マネージ コ ー ド は、 リ ク エ ス
ト プ ロ セ ス パ イ プ ラ イ ン に統合 さ れ ます。
互換の問題を避け る ために、 PowerBuilder か ら 配布 さ れ る Web フ ォ ー
ム アプ リ ケーシ ョ ンは、 ク ラ シ ッ ク マネージ パ イ プ ラ イ ン モー ド を
使用す る ア プ リ ケ ー シ ョ ン プ ー ル内 で 実行す る 必要 が あ り ま す。
ASP.NET は ISAPI エ ク ス テ ン シ ョ ン と し て実行 し ます。
PowerBuilder 11
5
Vista サポー ト
ク ラ シ ッ ク モー ド を使用す る よ う に DefaultAppPool を設定す る こ と が
で き ますが、 設定を変更す る と 、 アプ リ ケーシ ョ ン プール内で実行す
る すべてのアプ リ ケーシ ョ ン に影響 し ます。 PowerBuilder Web フ ォ ー
ム ア プ リ ケーシ ョ ン のための新 し い ア プ リ ケーシ ョ ン プール を作成
し たほ う が よ いで し ょ う 。
PowerBuilder Web
フ ォ ーム ア プ リ ケー
シ ョ ン プールの作 り
方
新 し いアプ リ ケーシ ョ ン プールを作成 し ない場合は、 アプ リ ケー
シ ョ ン を ホ ス ト す る アプ リ ケーシ ョ ン プールに対 し て次の手順 4 を行
う 必要があ り ます。
❖
PowerBuilder Web フ ォ ーム ア プ リ ケーシ ョ ンのア プ リ ケーシ ョ ン プール
を作成、 設定するには
1
IIS マネージ ャ で [アプ リ ケーシ ョ ン プール] を選択 し ます。
2
操作 ウ ィ ン ド ウ で [アプ リ ケーシ ョ ン プールの追加] を選択 し ま
す。
3
アプ リ ケーシ ョ ン プールに PBWebForms 等の名前を指定 し ます。
4
[マネージ パ イ プ ラ イ ン モー ド ] を 「 ク ラ シ ッ ク ] に設定 し 、[OK]
を ク リ ッ ク し ます。
新 し いアプ リ ケーシ ョ ン プールが一覧に表示 さ れ ます。
64 ビ ッ ト 版 Vista 上
で 32 ビ ッ ト ア プ リ
ケーシ ョ ン を有効にす
る
64 ビ ッ ト 版 Vista では、 32 ビ ッ ト アプ リ ケーシ ョ ン を実行す る ために
アプ リ ケーシ ョ ン プールを有効にす る 必要があ り ます。
❖
別のア プ リ ケーシ ョ ン
プールにア プ リ ケー
シ ョ ン を移動
6
64 ビ ッ ト 版 Vista で 32 ビ ッ ト ア プ リ ケーシ ョ ン を有効にするには
1
IIS マネージ ャ で [アプ リ ケーシ ョ ン プール] を選択 し ます。
2
アプ リ ケーシ ョ ン プールの一覧か ら 、 PowerBuilder Web フ ォ ーム
で使用す る た めに設定 し た ア プ リ ケ ーシ ョ ン プール を 選択 し ま
す。
3
操作 ウ ィ ン ド ウ で [アプ リ ケーシ ョ ン プールの編集] の下の [詳
細設定] を選択 し ます。
4
[全般] を展開 し て、 [32 ビ ッ ト アプ リ ケーシ ョ ン の有効化] を
「True」 に設定 し 、 [OK] を ク リ ッ ク し ます。
PowerBuilder のための新 し いアプ リ ケーシ ョ ン プールを作成 し て、 設
定 し た場合、 PowerBuilder Web フ ォ ーム アプ リ ケーシ ョ ン を そのプー
ルに移動す る 必要があ り ます。
新機能
Vista サポー ト
❖
別のア プ リ ケーシ ョ ン プールにア プ リ ケーシ ョ ン を移動するには
1
IIS マネージ ャ で 「Web サ イ ト 」、 「Default Web Site」 の順に展開 し
ます。
2
アプ リ ケーシ ョ ンの仮想デ ィ レ ク ト リ を右 ク リ ッ ク し て、 [詳細設
定] を ク リ ッ ク し ます。
3
[アプ リ ケーシ ョ ン プール] プ ロ パテ ィ の隣の参照 ([...]) ボ タ ン
を ク リ ッ ク し て、 作成 し た ア プ リ ケ ー シ ョ ン プール を 選択 し 、
[OK] を ク リ ッ ク し ます。
4
アプ リ ケーシ ョ ン を再 ロ ー ド し ます。
必要な IIS 6 互換 コ ンポーネ ン ト
Web フ ォ ーム アプ リ ケーシ ョ ン を IIS 7 が稼働中の リ モー ト サーバに
配布す る 場合、 あ る いは ス マー ト ク ラ イ ア ン ト ア プ リ ケーシ ョ ン を
IIS 7 が稼働中の ロ ーカル サーバ ま たは リ モー ト サーバに発行す る 場
合、IIS 7 の Vista メ タ ベース互換 コ ン ポーネ ン ト がサーバに イ ン ス ト ー
ル さ れてい る 必要があ り ます。 こ の コ ン ポーネ ン ト は、 デフ ォ ル ト で
は イ ン ス ト ール さ れ ません。 Web フ ォーム アプ リ ケーシ ョ ン を ロ ーカ
ル サーバに配布す る 場合は必要あ り ません。
Windows コ ン ト ロ ール パネルのプ ロ グ ラ ム と 機能ページ か ら 互換 コ
ン ポーネ ン ト を イ ン ス ト ールす る こ と がで き ます。[Windows 機能の有
効化 ま たは無効化] を選択 し てか ら 、 [Internet Information Services |
Web 管理ツール| IIS 6 と 互換性のあ る 管理| IIS メ タ ベースお よ び IIS
6 構成 と の互換性] を選択 し ます。
Web フ ォ ーム ア プ リ ケーシ ョ ンのア ク セス許可のセ ッ ト ア ッ プ
新 し い Web フ ォーム タ ーゲ ッ ト を配布す る と き に、 temp デ ィ レ ク ト
リ が Inetpub\wwwroot\application_name デ ィ レ ク ト リ の下に作成 さ れ
ます。 application_name はアプ リ ケーシ ョ ンの名前で、 複数のサブデ ィ
レ ク ト リ が Inetpub\wwwroot\application_name_root デ ィ レ ク ト リ に作
成 さ れ ます。 フ ァ イ ルが こ れ ら のデ ィ レ ク ト リ に書 き 込ま れ、 削除 さ
れ ます。 そのため、 IIS_IUSRS グループは、 temp デ ィ レ ク ト リ お よ び
application_name_root デ ィ レ ク ト リ に対 し て フ ル ア ク セ ス 許可を持つ
必要があ り ます。
PowerBuilder 11
7
Vista サポー ト
PowerBuilder .NET Web フ ォ ーム アプ リ ケーシ ョ ン が SQL Anywhere®
デー タ ベー ス に接続す る 前に、 手動で デー タ ベー ス を 起動す る か、
Sybase\Shared お よ び Sybase\SQL Anywhere デ ィ レ ク ト リ に対 し て IIS 7
のデフ ォ ル ト のア ク セ ス許可を IIS_IUSRS グループに与え る 必要があ
り ます。 こ れ ら のデ ィ レ ク ト リ 内の子オブジ ェ ク ト すべてのア ク セ ス
許可を置 き 換え ます。 アプ リ ケーシ ョ ン が使用す る デー タ ベース お よ
びデー タ ベース ロ グ フ ァ イ ルは、 フル ア ク セ ス許可が必要です。
Sybase デ ィ レ ク ト リ に適切なユーザ ア ク セ ス許可を与えずに、 デー タ
ベー ス が自動的に起動す る よ う にデー タ ベース を設定 し た場合、 アプ
リ ケーシ ョ ンはデー タ ベー ス への接続に失敗 し ま す。 IIS_IUSRS ユー
ザ グループがデー タ ベース にア ク セ スす る 権限を持たない限 り 、 SQL
Anywhere はフ ァ イ ルにア ク セ ス で き ません。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「.NET Web プ ロ ジ ェ ク ト 用 ASP.NET の設定」 のセ
ク シ ョ ン を参照 し て く だ さ い。
Windows ヘルプ フ ァ イル
Windows Vista では、 PowerBuilder で使用 さ れてい る pbhlp110.hlp フ ァ
イ ルなど の Windows ヘルプ フ ァ イ ルを 開く ために必要な WinHlp32.exe
フ ァ イ ルは配布 さ れ ま せん。 .hlp フ ァ イ ル を 使用す る には、 Microsoft
Web http://go.microsoft.com/fwlink/?LinkID=82148 で、 [Change Language] か
ら 「Japanese」 を選択 し 、 [Change] ボ タ ン を ク リ ッ ク し て、 Vista 用の
WinHlp32.exe を ダ ウ ン ロ ー ド す る 必要があ り ます。
コ ンパ イ ル済み HTML ヘルプ (.chm) フ ァ イ ル を サポー ト し ま すが、
pbhlp110.hlp フ ァ イ ルか ら pbman110.chm フ ァ イ ルへの リ ン ク をサポー
ト す る Help マ ク ロ を有効にす る ために、Windows レ ジ ス ト リ を編集す
る 必要があ り ます。 レ ジ ス ト リ を編集 し ない と 、 Windows ヘルプの多
く の ト ピ ッ ク の下にあ る 「詳細について」 リ ン ク にエ ラ ーが表示 さ れ
ます。
イ ン ト ラ ネ ッ ト に あ る リ モー ト の場所で Windows ヘルプ フ ァ イ ル を
実行す る 必要があ る 場合に も 、レ ジ ス ト リ を編集す る 必要があ り ます。
8
新機能
Vista サポー ト
64 ビ ッ ト 版 Windows でのレ ジ ス ト リ の反映
Windows の 64 ビ ッ ト 版では、 32 ビ ッ ト の レ ジ ス ト リ 表示 と 64 ビ ッ ト
の レ ジ ス ト リ 表示 を保持す る ために、 レ ジ ス ト リ 反映 を使用 し ま す。
64 ビ ッ ト 版の Windows では、 32 ビ ッ ト アプ リ ケーシ ョ ン に関連す る
設定情報は、 HKEY_LOCAL_MACHINE\Software\WOW6432node レ ジ ス
ト リ ハ イ ブに格納 さ れ ます。
❖
Vista 上で Windows Help マ ク ロおよび リ モー ト ア ク セス を有効にするには
1
次の レ ジ ス ト リ キーを作成 し ます。
32 ビ ッ ト 版 Windows 上 :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WinHelp
64 ビ ッ ト 版 Windows 上 :
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432node\Microsoft\
WinHelp
2
値の名前に AllowProgrammaticMacros、値のデー タ に 1 を設定 し て、
新規 DWORD 値を追加 し ます。
3
値の名前に AllowIntranetAccess、 値のデー タ に 1 を設定 し て、 新規
DWORD 値を追加 し ます。
次の行を メ モ帳に貼 り 付けて、拡張子 .reg を付けて フ ァ イ ルを保存 し 、
その保存 し た フ ァ イ ル を レ ジ ス ト リ に イ ン ポー ト す る こ と に よ っ て、
こ のサポー ト を追加す る こ と も で き ます。
32 ビ ッ ト 版 Windows 上 :
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WinHelp]
"AllowProgrammaticMacros"=dword:00000001
"AllowIntranetAccess"=dword:00000001
64 ビ ッ ト 版 Windows 上 :
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Microsoft\WinH
elp]
"AllowProgrammaticMacros"=dword:00000001
"AllowIntranetAccess"=dword:00000001
PowerBuilder 11
9
Vista サポー ト
Microsoft 社は、 配布アプ リ ケーシ ョ ン と と も に WinHlp32.exe を配布す
る こ と を禁 じ てい ます。 アプ リ ケーシ ョ ン が .hlp フ ァ イ ルを使用す る
場合、 ユーザに対 し て WinHlp32.exe フ ァ イ ルのダ ウ ン ロ ー ド 方法を提
供 し て く だ さ い。 詳細については、 Microsoft サポー ト の
http://support.microsoft.com/kb/917607 を参照 し て く だ さ い。
EAServer のサポー ト
Vista オペレーテ ィ ン グ シ ス テ ムは、 EAServer 6.0.2 以降でサポー ト し
ます。
Windows Vista での制限
こ のセ ク シ ョ ン では、 PowerBuilder に影響す る Vista オペレーテ ィ ン グ
シ ス テ ム の制限、 お よ び Vista での PowerBuilder 11 の使用時に問題 と
な る 可能性のあ る 事項について記述 し ます。
JSP タ ーゲ ッ ト
Vista オペレーテ ィ ン グ シ ス テ ム では、 JSP タ ーゲ ッ ト と JSP ページ を
作成で き ますが、 HTML エデ ィ タ の [ページ編集] ビ ュ ーお よ びその
組み込みの ス ク リ プ ト エ デ ィ タ を 実装す る た め に使用 さ れ る コ ン
ポーネ ン ト は、Vista オペレーテ ィ ン グ シ ス テ ム ではサポー ト し てい ま
せん。 そのため、 Vista では JSP タ ーゲ ッ ト を サポー ト し ません。
カ レ ン ダ を使用する コ ン ト ロール
Vista オペレーテ ィ ン グ シ ス テ ムは、 日付ピ ッ カー コ ン ト ロ ール、 エ
デ ィ ッ ト マ ス ク コ ン ト ロ ール、 月表示カ レ ン ダ コ ン ト ロ ール、 お よ び
デー タ ウ ィ ン ド ウ カ ラ ム の ド ロ ッ プダ ウ ン カ レ ン ダのい く つかのプ
ロ パテ ィ を サポー ト し ません。 Vista では次のプ ロ パテ ィ を サポー ト し
ません。
•
10
日付ピ ッ カー : CalendarBackColor、 CalendarFontName、
CalendarFontWeight、 CalendarItalic、 CalendarTextColor、
CalendarTextSize、 CalendarTitleBackColor、 CalendarTitleTextColor、
CalendarTrailingTextColor、 CalendarUnderLine
新機能
Vista サポー ト
•
エデ ィ ッ ト マ ス ク : CalendarBackColor、 CalendarTextColor、
CalendarTitleBackColor、 CalendarTitleTextColor、
CalendarTrailingTextColor
•
月表示カ レ ン ダ : FaceName、 MonthBackColor、 TextColor、
TextSize、 TitleBackColor、 TitleTextColor、 TrailingTextColor、
Underline
•
ド ロ ッ プダ ウ ン カ レ ン ダ編集様式のデー タ ウ ィ ン ド ウ オブジ ェ
ク ト のカ ラ ム コ ン ト ロ ール : DDCal_BackColor、
DDCal_TextColor、 DDCal_TitleBackColor、 DDCal_TitleTextColor、
DDCal_TrailingTextColor
さ ら に Vista オペレーテ ィ ン グ シ ス テ ムは、 日付ピ ッ カー コ ン ト ロ ー
ルの WeekNumbers プ ロ パテ ィ をサポー ト し ません。 こ のプ ロ パテ ィ が
「true」 の と き 、 日付ピ ッ カー コ ン ト ロ ールは正 し く 表示 さ れ ま せん。
WeekNumbers が 「true」 で Autosize が 「false」 の と き 、 同 じ 制限が月表
示カ レ ン ダ コ ン ト ロ ールに も あ ては ま り ます。
PDF の保存
開発環境で PDF と し て保存す る には、 管理者 と し て PowerBuilder を実
行す る 必要があ り ます (3 ページの 「PowerBuilder の実行」 を参照 し て
く だ さ い)。 ま た、 Distill メ ソ ッ ド を使用 し て PDF と し て フ ァ イ ルを保
存す る と き に、 正 し いバージ ョ ン の Microsoft PostScript プ リ ン タ ド ラ
イ バ フ ァ イ ルが drivers デ ィ レ ク ト リ で使用で き る 必要があ り ます。
PostScript プ リ ン タ を イ ン ス ト ール し てい る 場合は、PDF フ ァ イ ルを作
成す る ために必要な PostScript ド ラ イ バ フ ァ イ ルは イ ン ス ト ール さ れ
てい ます。 イ ン ス ト ール さ れ る 標準の場所は、 Windows XP の場合は、
C:\WINDOWS\system32\spool\drivers\w32x86、 Vista の場合は、
C:\Windows\System32\DriverStore\FileRepository\ntprint.inf_xxxxxxxx\
です。xxxxxxxx はシ ス テ ム固有の識別子で、32 ビ ッ ト 版 Vista では I386
サブデ ィ レ ク ト リ 、 64 ビ ッ ト 版 Vista では Amd64 サブデ ィ レ ク ト リ に
な り ま す。 PDF フ ァ イ ル を 作成す る シ ス テ ム に適 し たバージ ョ ン の
フ ァ イ ルを使用す る 必要があ り ます。 Shared\PowerBuilder\drivers デ ィ
レ ク ト リ に フ ァ イ ルを コ ピー し ます。
PostScript プ リ ン タ を イ ン ス ト ール し ていない場合は、 Windows コ ン ト
ロ ール パ ネ ルの プ リ ン タ と FAX オ プ シ ョ ン を 使用 し て、 一般的 な
PostScript プ リ ン タ を イ ン ス ト ール し ます。 Microsoft PSCRIPT5.DLL が
イ ン ス ト ール さ れていない場合は、 Windows Vista イ ン ス ト ール CD を
挿入す る よ う にプ ロ ン プ ト が表示 さ れます。
PowerBuilder 11
11
.NET 配布機能
.NET 配布機能
PowerBuilder 11 では、PowerBuilder でアプリケーションとコンポーネ
ントを構築し、それらを .NET Framework バージ ョ ン 2.0 に配布す る 機
能を導入 し ま し た。新 し い ウ ィ ザー ド に よ り 、PowerBuilder アプ リ ケー
シ ョ ン を .NET Web フ ォーム アプ リ ケーシ ョ ン、 あ る いは、 オプシ ョ
ン で イ ン テ リ ジ ェ ン ト 更新 (ス マー ト ク ラ イ ア ン ト ) 機能 を 用い て
.NET Windows フ ォ ーム アプ リ ケーシ ョ ン と し て配布す る こ と がで き
ます。カ ス タ ム ク ラ ス ユーザ オブジ ェ ク ト を .NET Web サービ スお よ
びアセ ン ブ リ と し て配布す る こ と も で き ます。
•
.NET Web フ ォ ームの配布
•
.NET Windows フ ォーム と ス マー ト ク ラ イ ア ン ト の配布
•
非ビ ジ ュ アル オブジ ェ ク ト を .NET アセ ンブ リ 内の .NET ク ラ ス と
し て配布
•
非ビ ジ ュ アル オブジ ェ ク ト を .NET Web サービ ス と し て配布
•
.NET デバ ッ ガ
•
条件付 き コ ンパ イ ル
•
.NET 言語の相互運用性
•
.NET アセ ン ブ リ の イ ン ポー ト
•
.NET アプ リ ケーシ ョ ン タ ーゲ ッ ト の イ ン ク リ メ ン タ ル再構築
•
Web フ ォ ーム アプ リ ケーシ ョ ンのための RadControl プ レ ビ ュ ー
•
Windows フ ォーム でのパ イ プ ラ イ ンのサポー ト
•
Web フ ォ ーム での Web サービ ス ク ラ イ ア ン ト のサポー ト
すべての .NET 機能の詳細については、 『アプ リ ケーシ ョ ン と コ ン ポー
ネ ン ト の .NET への配布』 マニ ュ アルを参照 し て く だ さ い。
12
新機能
.NET 配布機能
.NET Web フ ォ ームの配布
Web フ ォ ーム アプ リ ケーシ ョ ン には、 従来の ク ラ イ ア ン ト サーバ ア
プ リ ケーシ ョ ンや Windows フ ォ ーム ア プ リ ケーシ ョ ン よ り 優れた点
があ り ます。 Web フ ォ ーム アプ リ ケーシ ョ ンは、 ク ラ イ ア ン ト 側の イ
ン ス ト ールを必要 と せず、 更新が簡単で、 配布 コ ス ト がかか ら ず、 広
範囲に渡 る ユーザ ア ク セ ス を提供 し ます。 Web ブ ラ ウ ザお よ びオ ン ラ
イ ン接続を使用す る ユーザは誰で も 、 Web フ ォ ーム アプ リ ケーシ ョ ン
を実行す る こ と がで き ます。 単純な問い合わせ、 閲覧、 ま たは レ ポー
ト 用のアプ リ ケーシ ョ ンが、 Web フ ォ ーム配布に適 し てい ます。
.NET Web フ ォ ーム アプ リ ケーシ ョ ン タ ーゲ ッ ト ウ ィ ザー ド を使用 し
て Web フ ォ ーム タ ーゲ ッ ト を作成 し 、 .NET Web フ ォ ーム プ ロ ジ ェ ク
ト ペ イ ン タ か ら アプ リ ケーシ ョ ン を配布 し ます。 配布後、 シ ス テ ム ツ
リ ーのプ ロ ジ ェ ク ト で右 ク リ ッ ク し て、 コ ン テ キ ス ト メ ニ ュ ーで [実
行] メ ニ ュ ー項目を選択 し て、 Web アプ リ ケーシ ョ ン を テ ス ト す る こ
と がで き ます。 エ ン ド ユーザは、 開発者が指定 し た URL を使用 し て
ブ ラ ウ ザか ら 配布アプ リ ケーシ ョ ン にア ク セ ス し ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「Web フ ォ ーム タ ーゲ ッ ト 」 を参照 し て く だ さ い。
.NET Windows フ ォ ーム と ス マー ト ク ラ イ ア ン ト の配布
ス マー ト ク ラ イ ア ン ト 機能を持つ Windows フ ォ ーム アプ リ ケーシ ョ
ンは、 Web の可能性 と ロ ーカル コ ン ピ ュ ー タ のハー ド ウ ェ アの能力を
結合 し ます。レ ス ポ ン ス が ク ラ イ ア ン ト サーバ アプ リ ケーシ ョ ン と 同
じ く ら い速 く な る ため、 ユーザは満足の行 く 利用環境が得 ら れ ま す。
ス マー ト ク ラ イ ア ン ト 機能を使用す る と 、 アプ リ ケーシ ョ ンの配布 と
更新が簡単に行え る う え、Sybase の MobiLink 技術を利用 し て随時接続
機能 を 提供で き ま す。 多数のデー タ 入力が必要な ア プ リ ケーシ ョ ン、
大量のデー タ を検索す る アプ リ ケーシ ョ ン (た と えば、 1 回の要求で
3MB 以上) 、 ま たは複雑な ユーザ イ ン タ フ ェ ー ス を持つア プ リ ケー
シ ョ ン な ど は、 Windows フ ォ ーム配布が適 し てい ます。
PowerBuilder 11
13
.NET 配布機能
Windows フ ォ ーム タ ーゲ ッ ト を作成 し て、 .NET Windows フ ォ ーム プ
ロ ジ ェ ク ト ペ イ ン タ で ア プ リ ケ ー シ ョ ン を 配布す る た め に、 .NET
Windows フ ォ ーム アプ リ ケーシ ョ ン タ ーゲ ッ ト ウ ィ ザー ド を使用 し
ます。 ウ ィ ザー ド ま たはペ イ ン タ で、 [ス マー ト ク ラ イ ア ン ト アプ リ
ケーシ ョ ン と し て発行] チ ェ ッ ク ボ ッ ク ス を オ ン に し て、イ ン テ リ ジ ェ
ン ト 配布 と 更新を有効に し ます。 シ ス テ ム ツ リ ーのプ ロ ジ ェ ク ト を右
ク リ ッ ク し て、 コ ン テ キ ス ト メ ニ ュ ーで [実行] メ ニ ュ ー項目を選択
し て、 Windows フ ォ ーム アプ リ ケーシ ョ ン を テ ス ト す る こ と がで き ま
す。 プ ロ ジ ェ ク ト ペ イ ン タ で [アプ リ ケーシ ョ ンの発行] ボ タ ン を ク
リ ッ ク し て、 Web や FTP サ イ ト 、 あ る いはネ ッ ト ワ ー ク フ ァ イ ル シ
ス テ ム にアプ リ ケーシ ョ ン を発行す る こ と で、 ユーザが最新バージ ョ
ンに簡単にア ク セ ス で き る よ う に し ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「Windows フ ォ ーム タ ーゲ ッ ト 」 を参照 し て く だ さ
い。
非ビ ジ ュ アル オブ ジ ェ ク ト を .NET アセ ン ブ リ 内の .NET ク ラ ス と し て
配布
.NET アセ ンブ リ タ ーゲ ッ ト ウ ィ ザー ド お よ びプ ロ ジ ェ ク ト ペ イ ン タ
を使用 し て、 .NET アセ ンブ リ 内の .NET ク ラ ス と し て非ビ ジ ュ アル オ
ブジ ェ ク ト を配布す る こ と がで き ます。 デー タ 型は、 PowerScript か ら
C# に自動的にマ ッ プ さ れ ます。
.NET ア セ ン ブ リ プ ロ ジ ェ ク ト を 配布す る と き 、 PowerBuilder は ウ ィ
ザー ド あ る いはプ ロ ジ ェ ク ト ペ イ ン タ で選択 し た非ビ ジ ュ アル ユー
ザ オ ブ ジ ェ ク ト か ら ア セ ン ブ リ DLL を 作成 し ま す。 セ ッ ト ア ッ プ
フ ァ イ ル名 も 指定す る と 、 PowerBuilder は ア セ ン ブ リ DLL、 .NET の
PowerBuilder シ ス テ ム ラ イ ブ ラ リ 、 お よ び ウ ィ ザー ド あ る いはプ ロ
ジ ェ ク ト ペ イ ン タ で指定 し た リ ソ ー ス フ ァ イ ルを含む MSI フ ァ イ ル
を作成 し ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「.NET アセ ン ブ リ と Web サービ ス タ ーゲ ッ ト 」 を
参照 し て く だ さ い。
14
新機能
.NET 配布機能
非ビ ジ ュ アル オブ ジ ェ ク ト を .NET Web サービ ス と し て配布
Web サービ ス は、 XML や Simple Object Access Protocol (SOAP) な ど
のオープ ン ス タ ン ダー ド を 使用す る た め、 異機種環境での ク ロ ス プ
ラ ッ ト フ ォ ーム通信に適 し てい ます。
PowerBuilder .NET Web サ ー ビ ス コ ン ポ ー ネ ン ト は、 Microsoft .NET
Framework の上に作成 さ れます。 .NET Web サービ ス タ ーゲ ッ ト を IIS
に配布す る と き 、 PowerBuilder は、 サーバのアプ リ ケーシ ョ ン デ ィ レ
ク ト リ で選択す る PowerBuilder 非 ビ ジ ュ ア ル オ ブ ジ ェ ク ト の .asmx
フ ァ イ ルお よ び .disco フ ァ イ ルを作成 し ます。
.NET Web サービ ス ウ ィ ザー ド は、 プ ロ ジ ェ ク ト を配布す る ために必
要な情報を集め る 一連の手順を案内 し ます。 Web サービ ス を配布 し た
後、 プ ロ ジ ェ ク ト ペ イ ン タ で .NET Web サービ ス プ ロ ジ ェ ク ト に割 り
当て る テ ス ト アプ リ ケーシ ョ ン か ら Web サービ ス メ ソ ッ ド を実行 し
た り 、 デバ ッ グ し た り で き ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「.NET アセ ン ブ リ と Web サービ ス タ ーゲ ッ ト 」 を
参照 し て く だ さ い。
.NET デバ ッ ガ
.NET タ ーゲ ッ ト を 配布 し た と き 、 PowerBuilder デバ ッ ガ で それ を デ
バ ッ グす る こ と がで き ま す。 プ ロ ジ ェ ク ト ペ イ ン タ の ツ ールバーで
[デバ ッ グ] ア イ コ ン を ク リ ッ ク す る か、 シ ス テ ム ツ リ ーのプ ロ ジ ェ
ク ト を右 ク リ ッ ク し 、 [デバ ッ グ] メ ニ ュ ー項目を選択 し て、 デバ ッ ガ
を起動す る こ と がで き ます。 Windows フ ォ ーム アプ リ ケーシ ョ ンが実
行 し てい る 場合、 デバ ッ ガ を実行プ ロ セ ス にア タ ッ チで き ます。
標準の PowerBuilder タ ーゲ ッ ト と .NET タ ーゲ ッ ト のデバ ッ ガの操作
は、 ほ と ん ど同 じ です。 .NET アプ リ ケーシ ョ ンは、 式の評価お よ び条
件付 き ブ レー ク ポ イ ン ト を含むほ と ん ど の PowerBuilder デバ ッ ガ機能
を サポー ト し ま す。 メ モ リ ビ ュ ーでのオブ ジ ェ ク ト お よ び変数のブ
レー ク ポ イ ン ト は、.NET プ ラ ッ ト フ ォ ーム の制限に よ り サポー ト し ま
せん。 .NET アプ リ ケーシ ョ ンお よ び標準アプ リ ケーシ ョ ン の両方で、
例外が送出 さ れ る と き にデバ ッ ガに割 り 込む こ と がで き ます (50 ペー
ジの 「例外送出時にデバ ッ ガ を中断」 を参照)。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「 コ ンパ イ ル と デバ ッ グ」 を参照 し て く だ さ い。
PowerBuilder 11
15
.NET 配布機能
条件付き コ ンパイル
複数のプ ラ ッ ト フ ォ ーム に配布す る 予定のアプ リ ケーシ ョ ン を開発 し
てい る と き に、 タ ーゲ ッ ト を識別す る ために条件付 き コ ンパ イ ルを使
用で き ます。 PowerBuilder は タ ーゲ ッ ト の種類ご と に 5 個のプ リ プ ロ
セ ッ サ シ ン ボルを用意 し てい ます。 #if defined symbol...#end if 文の中で
特定の タ ーゲ ッ ト の種類だけ を解析す る よ う に コ ー ド を囲みます。 デ
バ ッ グ構築でのみ コ ンパ イ ル さ れ る コ ー ド に印を付け る ために使用で
き る DEBUG シ ン ボル も あ り ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マニ ュ アルの 「条件付 き コ ンパ イ ルについて」 お よ び 『PowerScript
リ フ ァ レ ン ス』 マニ ュ アルの 「条件付 き コ ンパ イ ルについて」 を参照
し て く だ さ い。
.NET 言語の相互運用性
.NET Framework お よ びほかの関連す る サー ド パーテ ィ のマ ネージ ラ
イ ブ ラ リ は、 豊富な リ ソ ース を提供 し ます。 PowerBuilder ユーザは、 こ
れ ら の ラ イ ブ ラ リ を使用 し て、 PowerBuilder .NET タ ーゲ ッ ト の機能を
拡張 し 、 開発時間を短縮で き ます。
.NET 言語の相互運用性は、 PowerBuilder の .NET タ ーゲ ッ ト 内の .NET
ク ラ スお よ び メ ソ ッ ド を使用で き る よ う に し ます。.NET 言語の相互運
用性では、 PowerBuilder 構文を使用 し て、 .NET ク ラ ス の作成、 .NET メ
ソ ッ ド の呼び出 し 、.NET プ ロ パテ ィ へのア ク セ ス を行 う こ と がで き ま
す。 Hashtable や Set な ど の .NET コ レ ク シ ョ ン ク ラ ス を使用す る こ と
がで き 、 さ ら に強力な .NET 通信 ク ラ スやほかの .NET サービ ス を使用
す る こ と がで き ます。
詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配
布』 マ ニ ュ ア ル の 「PowerScript で の .NET ク ラ ス 参照」 お よ び次の
「.NET アセ ン ブ リ の イ ン ポー ト 」 を参照 し て く だ さ い。
.NET アセ ン ブ リ のイ ンポー ト
タ ーゲ ッ ト のプ ロ パテ ィ ダ イ ア ロ グボ ッ ク ス の [.NET アセ ンブ リ ] タ
ブ ページか ら .NET ア セ ン ブ リ を .NET タ ーゲ ッ ト に イ ン ポー ト す る
こ と がで き ます。
16
新機能
.NET 配布機能
参照 ([...]) ボ タ ン を ク リ ッ ク し て、 .NET アセ ンブ リ の参照 ダ イ ア ロ
グ ボ ッ ク ス を開 き ま す。 こ のダ イ ア ロ グ ボ ッ ク ス か ら .dll、 .tlb、 .olb、
.ocx、 あ る いは .exe 拡張子を持つプ ラ イ ベー ト アセ ンブ リ を イ ン ポー
ト す る ために参照で き ます。複数のアセ ン ブ リ を イ ン ポー ト す る には、
1 つずつ選択 し て、 イ ン ポー ト す る 必要があ り ます。
[追加] ボ タ ン を ク リ ッ ク し て、 .NET アセ ン ブ リ の イ ン ポー ト ダ イ ア
ロ グ ボ ッ ク ス を開 き ます。 こ のダ イ ア ロ グ ボ ッ ク ス か ら 、 タ ーゲ ッ ト
に共有アセ ン ブ リ を イ ン ス ト ールす る こ と がで き ます。アセ ン ブ リ は、
厳密な名前であ る 必要があ り ます。アセ ン ブ リ を イ ン ポー ト す る には、
それを選択 し て、 [OK] を ク リ ッ ク し ま す。 複数のア セ ン ブ リ を イ ン
ポー ト す る には、 1 つず つ選択 し て、 イ ン ポー ト す る 必要があ り ます。
最後に使用 し たアセ ン ブ リ を イ ン ポー ト す る ために、.NET アセ ンブ リ
の イ ン ポー ト ダ イ ア ロ グボ ッ ク ス を使用す る こ と も で き ます。
シ ス テム ツ リ ーの表
示
シ ス テ ム ツ リ ーには、 .NET タ ーゲ ッ ト に イ ン ポー ト す る C# アセ ンブ
リ の ク ラ ス、 メ ソ ッ ド 、 構造体、 お よ び列挙体が表示 さ れ ま す。 し か
し 、 C# マネージ ア セ ン ブ リ に影響す る 言語関連の制限に よ り 、 シ ス
テ ム ツ リ ーに ク ラ ス、 構造体、 列挙体の メ ンバーは表示 さ れ ません。
デフ ォ ル ト では、 アセ ン ブ リ 内の各 ク ラ ス の完全な名前がシ ス テ ム ツ
リ ーに表示 さ れます。 最後の名前だけ を表示 し たい場合は、 pb.ini フ ァ
イ ルの [PB] セ ク シ ョ ンに次の行を追加 し ます。
SystemTree_DotNetFullName=0
た と えば、 こ の設定では System.Data.dll の
Microsoft.SqlServer.Server.DataAccessKind ク ラ ス は、 DataAccessKind と 表
示 さ れ ます。 ク ラ ス を右 ク リ ッ ク し 、 ポ ッ プア ッ プ メ ニ ュ ーか ら
[プ ロ パテ ィ ] を選択 し て、 完全な ク ラ ス名を表示す る こ と がで き ま
す。
.NET ア プ リ ケーシ ョ ン タ ーゲ ッ ト のイ ン ク リ メ ン タ ル再構築
PowerBuilder 11 では、 .NET アプ リ ケーシ ョ ン タ ーゲ ッ ト のための イ
ン ク リ メ ン タ ル構築 を導入 し ま し た。 イ ン ク リ メ ン タ ル構築に よ り 、
テ ス ト 目的や本番目的のためにアプ リ ケーシ ョ ン を配布す る 時間を節
約で き ま す。 こ の機能は、 1 つ以上の変更の影響を受け る ク ラ ス だけ
を構築プ ロ セ ス の間に再 コ ンパ イ ル し ます。
PowerBuilder 11
17
.NET 配布機能
.NET タ ーゲ ッ ト のための イ ン ク リ メ ン タ ル再構築プ ロ セ ス は、 .NET
プ ラ ッ ト フ ォ ー ム へのプ ロ ジ ェ ク ト の配布の最初の段階で行われ ま
す。 配布はプ ロ ジ ェ ク ト レベルの ま ま ですが、 イ ン ク リ メ ン タ ル再構
築は タ ーゲ ッ ト レベルで行われ ます。 こ れは、 1 つの タ ーゲ ッ ト 内の
複数のプ ロ ジ ェ ク ト が同 じ イ ン ク リ メ ン タ ル構築アセ ン ブ リ あ る いは
.NET モジ ュ ールを共有す る と い う 利点があ る こ と を意味 し ます。
.NET Web サービ スおよび .NET アセ ン ブ リ タ ーゲ ッ ト
イ ン ク リ メ ン タ ル構築は、 .NET コ ン ポーネ ン ト タ ーゲ ッ ト で使用す
る こ と はで き ません。 PowerBuilder .NET コ ンパ イ ラ は、 こ の タ ーゲ ッ
ト については フル構築 し ます。
イ ン ク リ メ ン タ ル構築で作成 し た構築デ ィ レ ク ト リ と .NET モジ ュ ー
ルの詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET へ
の配布』 マニ ュ アルの 「 コ ンパ イ ル と デバ ッ グ」 の章を参照 し て く だ
さ い。
構築操作 と 配布操作の起動
PowerBuilder は、 .NET Web フ ォ ーム あ る いは Windows フ ォ ーム プ ロ
ジ ェ ク ト を実行あ る いはデバ ッ グす る と き に、 構築操作お よ び配布操
作を起動 し ます。 デフ ォ ル ト では、 PowerBuilder ツールバーで [実行]
ア イ コ ンや [デバ ッ グ] ア イ コ ン を ク リ ッ ク し た と き 、 あ る いはプ ロ
ジ ェ ク ト メ ニ ュ ーや こ の タ ーゲ ッ ト の コ ン テ キ ス ト メ ニ ュ ーか ら [実
行] を選択 し た と き 、 PowerBuilder は選択 さ れた タ ーゲ ッ ト に関 し て
対 応 す る 構 築 デ ィ レ ク ト リ が あ る か を 判 断 し ま す。 あ る 場 合 は、
PowerBuilder は構築デ ィ レ ク ト リ 内の .NET モ ジ ュ ールが現行ア プ リ
ケーシ ョ ン内の各オブジ ェ ク ト への最新の変更 と 一致す る か ど う か を
確認 し ます。
実装の変更や イ ン タ フ ェ ー ス の変更が見つか っ た場合、 あ る いは現行
タ ー ゲ ッ ト の た め の 構 築 デ ィ レ ク ト リ が 存 在 し な い 場 合 は、
PowerBuilder はプ ロ ジ ェ ク ト が古い こ と を知 ら せて、 プ ロ ジ ェ ク ト を
再配布す る こ と を促す メ ッ セージ ボ ッ ク ス を表示 し ます。 メ ッ セージ
ボ ッ ク ス には、 3 つのボ タ ン ([はい]、 [いいえ]、 [キ ャ ン セル])、 お
よ び次回 [実行] (あ る いは [デバ ッ グ] ) を ク リ ッ ク か選択 し た と き
に こ の メ ッ セージ ボ ッ ク ス を 表示 し な い よ う にす る チ ェ ッ ク ボ ッ ク
ス があ り ます。
18
新機能
.NET 配布機能
メ ッ セージ ボ ッ ク ス で [はい] を ク リ ッ ク す る と 、 PowerBuilder は現
行の再構築 ス コ ープに従っ て イ ン ク リ メ ン タ ル再構築あ る いは フル再
構築を使用 し てプ ロ ジ ェ ク ト を構築 し ます。 それか ら 、 現行プ ロ ジ ェ
ク ト の配布指定を使用 し て、 再配布 し ます。 再配布の メ ッ セージ ボ ッ
ク ス で [いいえ] を ク リ ッ ク す る と 、 古い場合で も PowerBuilder は現
行の配布 タ ーゲ ッ ト を実行あ る いはデバ ッ グ し よ う と し ます。[キ ャ ン
セル] を ク リ ッ ク す る と 、 実行 リ ク エ ス ト あ る いはデバ ッ グ リ ク エ ス
ト を終わ ら せます。
[再度問い合わせない] チ ェ ッ ク ボ ッ ク ス を選択 し てか ら 、 [はい] ま
たは [いいえ] ボ タ ン を ク リ ッ ク す る と 、 PowerBuilder はシ ス テ ム オ
プシ ョ ン ダ イ ア ロ グ ボ ッ ク ス の [全般] タ ブの ド ロ ッ プダ ウ ン リ ス ト
の選択を変更 し ます。
シ ス テム オプ シ ョ ン
シ ス テ ム オプシ ョ ン ダ イ ア ロ グ ボ ッ ク ス の [全般] タ ブの [実行時に
.NET アプ リ ケーシ ョ ンが期限切れにな っ ていた場合の動作] ド ロ ッ プ
ダ ウ ン リ ス ト で選択 し た内容に よ り 、プ ロ ジ ェ ク ト オブジ ェ ク ト を変
更 し 、 プ ロ ジ ェ ク ト を実行あ る いはデバ ッ グ し た場合に、 メ ッ セージ
ボ ッ ク ス が表示 さ れ る か ど う かが決 ま り ます。 次の表は、 こ の ド ロ ッ
プダ ウ ン リ ス ト で指定で き る 選択肢です。
選択肢
問い合わせ る
再配布す る
再配布 し ない
PowerBuilder 11
実行 (あるいはデバ ッ グ) を ク リ ッ ク または選択する
と きの結果
(デフ ォ ル ト の選択) 最後に配布 し てか ら 現行プ ロ ジ ェ
ク ト を変更 し た場合、あ る いは以前に配布 し ていない場
合に、 メ ッ セージ ボ ッ ク ス を表示 し ます。
プ ロ ジ ェ ク ト を実行あ る いはデバ ッ グする 前に、常に再
配布 し ま す。 プ ロ ジ ェ ク ト ペ イ ン タ で設定 し た再構築
ス コ ープ を使用 し て プ ロ ジ ェ ク ト を 最初に再構築 し ま
す。
プ ロ ジ ェ ク ト を実行 し よ う と す る 前に再配布 し ま せん
が、以前にプ ロ ジ ェ ク ト を配布 し ていない場合は配布 し
て、プ ロ ジ ェ ク ト を実行あ る いはデバ ッ グ し よ う と し ま
す。 (以前に配布 し たプ ロ ジ ェ ク ト をデバ ッ グ し たい場
合は、 こ のオプシ ョ ン を選択 し ないで く だ さ い。)
19
.NET 配布機能
期限切れのプ ロ ジ ェ ク ト を 再配布す る か を 尋ね る メ ッ セージ ボ ッ ク
ス は、 ド ロ ッ プダ ウ ン リ ス ト の選択が 「問い合わせ る 」 であ る と き に
のみ表示 さ れ ます。 [再度問い合わせない] チ ェ ッ ク ボ ッ ク ス を オ ン に
し た と き に、 メ ッ セージ ボ ッ ク ス で [はい] を ク リ ッ ク す る と 、 自動
的に [再配布す る ] が選択 さ れた状態に変わ り ます。 [再度問い合わせ
ない] チ ェ ッ ク ボ ッ ク ス を オ ン に し た と き に、 メ ッ セージ ボ ッ ク ス で
[いいえ] を ク リ ッ ク す る と 、 [再配布 し ない] に変わ り ます。
Web フ ォ ーム ア プ リ ケーシ ョ ンのための RadControl プ レ ビ ュ ー
PowerBuilder 11 セ ッ ト ア ッ プ プ ロ グ ラ ム は、 Telerik RadControls for
ASP.NET を イ ン ス ト ール し ます。 PowerBuilder は自動的に こ れ ら の コ
ン ト ロ ール を Web フ ォ ー ム ア プ リ ケーシ ョ ン と 一緒に配布 し ま す。
RadControl は、 Web フ ォ ーム ツールバー と メ ニ ュ ーの拡張機能を提供
し 、 IE Web Controls のかわ り に使用 さ れ ます。 RadControl セ ッ ト を イ
ン ス ト ール し た PowerBuilder には、 日付ピ ッ カー コ ン ト ロ ールお よ び
月表示カ レ ン ダ コ ン ト ロ ール も 含まれ ます。
RadControl プ レ ビ ュ ーのための不完全な コ ン ト ロール セ ッ ト
RadControl の ツ リ ー ビ ュ ー コ ン ト ロ ールは、 現行の PowerBuilder リ
リ ース には含ま れ ません。 そのため、 Web フ ォ ーム アプ リ ケーシ ョ ン
が ツ リ ービ ュ ー コ ン ト ロ ールを使用す る 場合は、 IE Web Controls を イ
ン ス ト ールす る 必要があ り ます。
PBWebControlSource グ ロ ーバル プ ロ パテ ィ は、 古い ス タ イ ルの コ ン ト
ロ ール と イ ン ス ト ール し た RadControl コ ン ト ロ ール セ ッ ト を切 り 替
え ます。 Web フ ォーム プ ロ ジ ェ ク ト ペ イ ン タ の [設定] タ ブで こ のプ
ロ パテ ィ を設定す る こ と がで き ます。 ま た、 Web フ ォ ーム アプ リ ケー
シ ョ ン の Web.config フ ァ イ ル内の deployment の後にあ る その値を変更
す る こ と も で き ます。
PBWebControlSource グ ロ ーバル プ ロ パテ ィ に次の値の ど ち ら か を 設
定す る こ と がで き ます。
20
新機能
.NET 配布機能
こ の設定は、 Web フ ォ ーム アプ リ ケーシ ョ ン が、 アプ リ ケー
シ ョ ン ツ ールバー と メ ニ ュ ーでは IE Web Controls を、 日付 ピ ッ
カー コ ン ト ロ ール と 月表示カ レ ン ダ コ ン ト ロ ールでは古い ス タ
イ ルの コ ン ト ロ ールを使用す る よ う に し ま す。 こ れは、 デフ ォ ル
ト の設定です。 こ の設定を使用す る には IE Web Controls を イ ン ス
ト ールす る 必要があ り ます。
•
IE
•
RAD
こ の設定は、 Web フ ォ ーム ア プ リ ケーシ ョ ン が アプ リ ケー
シ ョ ン ツールバー と メ ニ ュ ー、 お よ び日付ピ ッ カー コ ン ト ロ ール
と 月表示カ レ ン ダ コ ン ト ロ ールで RadControl を使用す る よ う に し
ます。 ツ リ ービ ュ ー コ ン ト ロ ールを含むアプ リ ケーシ ョ ン で こ の
設定を使用す る 場合は、 IE Web Controls を イ ン ス ト ールす る 必要
があ り ます。
IE Web Controls の イ ン ス ト ールについての詳細は、『アプ リ ケーシ ョ ン
と コ ン ポーネ ン ト の .NET への配布』 マニ ュ アルの第 1 章を参照 し て
く だ さ い。
Windows フ ォ ームでのパイ プ ラ イ ンのサポー ト
PowerBuilder 11 は、Windows フ ォーム タ ーゲ ッ ト でのパ イ プ ラ イ ン オ
ブ ジ ェ ク ト の使用 を サ ポ ー ト し ま す。 こ れ は、 新 し い DLL で あ る
pbdpl110.dll でサポー ト し ます。 こ の DLL は、 .NET Windows フ ォ ーム
と 標準 PowerBuilder アプ リ ケーシ ョ ンの両方で配布 さ れ る 必要があ り
ます。 こ の DLL は ラ ン タ イ ム パ ッ ケージ ャ に追加 さ れ ま し た。
Web フ ォ ームでの Web サービ ス ク ラ イ ア ン ト のサポー ト
こ の リ リ ース では、 .NET Web フ ォ ーム タ ーゲ ッ ト と Windows フ ォ ー
ム タ ーゲ ッ ト の両方で、 組み込みの Web サービ ス ク ラ イ ア ン ト エ ク
ス テ ン シ ョ ン (pbwsclient110.pbx) を使用 し ま す。 .NET タ ーゲ ッ ト で
ほかの PBNI エ ク ス テ ン シ ョ ン を使用す る こ と はで き ません。
PowerBuilder 11
21
Web サービ スの機能拡張
Web サービ スの機能拡張
PowerBuilder 11 は、 .NET Web サービ ス エ ン ジ ン を使用 し て SOAP リ
ク エ ス ト を作成 し 、 Web サービ ス か ら 返 さ れ る SOAP メ ッ セージ を解
析 し ます。
Web サービ ス アプ リ ケーシ ョ ン の作成に関す る 詳細については、 『ア
プ リ ケーシ ョ ン テ ク ニ ッ ク 』 マニ ュ アルの第 31 章 「Web サービ ス ク
ラ イ ア ン ト の構築」 を参照 し て く だ さ い。
.NET Web サービ ス エ ン ジ ン に関 し て
.NET Web サービ ス エ ン ジ ンは、 XML 形式の配列デー タ 型を処理で き
ます。 SOAP メ ッ セージ エ ンベ ロ ープのヘ ッ ダ セ ク シ ョ ン でのセキ ュ
リ テ ィ 制約の送信 も サポー ト し ます。
.NET Web サービ ス エ ン ジ ンは、 最新の Web サービ ス標準を サポー ト
し ま す。 こ のエ ン ジ ン を 使用す る には、 開発 コ ン ピ ュ ー タ で wsdl.exe
Web サービ ス ツールが必要にな り ます。 WSDL フ ァ イ ルの解析お よ び
.NET アセ ン ブ リ のための C# コ ー ド を生成す る ために、 こ の ツールが
必要です。 wsdl.exe フ ァ イ ルは .NET SDK と 一緒に イ ン ス ト ール さ れま
す。 配布 コ ン ピ ュ ー タ には、 こ の フ ァ イ ルは必要あ り ませんが、 .NET
Web サー ビ ス エ ン ジ ン に依存す る Web サー ビ ス を 利用す る た め に
.NET 2.0 Framework が必要です。
.NET Web サービ ス エ ン ジ ンの使用
.NET アセ ン ブ リ の生
成
Web サービ ス プ ロ キ シ ウ ィ ザー ド で .NET Web サービ ス エ ン ジ ン を選
択す る と 、 ウ ィ ザー ド はプ ロ キ シ オブジ ェ ク ト に加え て .NET アセ ン
ブ リ (DLL) を生成 し ま す。 実行時に Web サー ビ ス を使用す る には、
ア プ リ ケーシ ョ ン と 一緒に ウ ィ ザー ド で生成 さ れ る DLL を 配布す る
必要があ り ます。
新 し い Web サービ ス プ ロ キ シのためのプ ロ ジ ェ ク ト ペ イ ン タ で .NET
Web サービ ス エ ン ジ ン を選択す る こ と も で き ます。 Web サービ ス プ ロ
キ シ ジ ェ ネ レ ー タ のプ ロ パテ ィ ダ イ ア ロ グ ボ ッ ク ス の [Web サービ
ス] タ ブで [WSDL エ ン ジ ン] の [.NET] チ ェ ッ ク ボ ッ ク ス を オ ン に
す る と 、 PowerBuilder は [保存] ア イ コ ン を ク リ ッ ク し た後にア セ ン
ブ リ DLL を生成 し よ う と し ます。 Web サービ ス プ ロ キ シ ウ ィ ザー ド
で生成 し たプ ロ キ シの Web サービ ス エ ン ジ ン を、 プ ロ パテ ィ ダ イ ア
ロ グボ ッ ク ス で変更す る こ と はで き ません。
22
新機能
Web サービ スの機能拡張
[アセ ン ブ リ 名] テ キ ス ト ボ ッ ク ス で、Web サービ ス プ ロ
キ シ ウ ィ ザー ド ま たはプ ロ ジ ェ ク ト ペ イ ン タ で生成 さ れた DLL に名
前を 付け る こ と がで き ま す。 DLL 拡張子を 含め る 必要はあ り ま せん。
ウ ィ ザー ド で生成 さ れた ア セ ン ブ リ の名前は Web_service.DLL です。
Web_service は、 [アセ ン ブ リ 名] フ ィ ール ド で指定す る 名前です。 名前
を指定 し ない場合は、 ア セ ン ブ リ は DLL が利用す る Web サービ ス の
名前を受け取 り ます。 アセ ンブ リ は、 現行の タ ーゲ ッ ト デ ィ レ ク ト リ
に生成 さ れます。
DLL の命名
DLL の配布 ク ラ イ ア ン ト 実行 フ ァ イ ル を 配布す る デ ィ レ ク ト リ に、
Web サービ ス プ ロ ジ ェ ク ト に対 し て作成 し た DLL を配布す る 必要が
あ り ます。 さ ら に、 こ のデ ィ レ ク ト リ に
Sybase.PowerBuilder.WebService.Runtime.dll お よ び
Sybase.PowerBuilder.WebService.RuntimeRemoteLoader.dll シ ス テ ム ア セ
ン ブ リ を コ ピーす る 必要 も あ り ます。
新 し いエ ク ス テ ン シ ョ
ン ク ラス ライブラ リ
.NET Web サービ ス エ ン ジ ン と EasySoap Web サービ ス エ ン ジ ン で、同
じ SOAP 接続 と 例外処理 ク ラ ス を使用 し て も 、 .NET Web サービ ス エ
ン ジ ン を 参照す る オブ ジ ェ ク ト は異な る エ ク ス テ ン シ ョ ン フ ァ イ ル
あ る いは ラ イ ブ ラ リ を要求 し ます。
詳細については、 『アプ リ ケーシ ョ ン テ ク ニ ッ ク 』 マ ニ ュ アルの 「エ
ク ス テ ン シ ョ ン フ ァ イ ルのオブジ ェ ク ト の イ ン ポー ト 」 を参照 し て く
だ さ い。
SOAP ク ラ イ ア ン ト
ヘ ッ ダにセキ ュ リ テ ィ
情報を追加
SoapConnection ク ラ ス の SetOptions 関数を使用 し て、SOAP ク ラ イ ア ン
ト ヘ ッ ダにセキ ュ リ テ ィ 情報を含め る こ と がで き ます。 別の メ ソ ッ ド
は、 セキ ュ リ テ ィ 情報を追加す る ための好ま し い方法を提供 し ます。
別の メ ソ ッ ド の詳細については、25 ページの「SoapConnection オブジ ェ
ク ト の新 し い メ ソ ッ ド 」 を参照 し て く だ さ い。
.NET Web サービ ス ク ラ イ ア ン ト の SetOptions 関数の Options 引数に以
下のオプシ ョ ン を含め る こ と がで き ます。
.NET セ キ ュ リ テ ィ オ プ
ション
Domain
UseWindowsAuthentication
PowerBuilder 11
説明
ユーザが属す る Web ド メ イ ンの String 型の
値。 こ れは 「sybase.com」 な ど の ド メ イ ン名
ま たは コ ン ピ ュ ー タ 名
「統合 Windows 認証」 を使用す る か ど う か
を決め る 「yes」 ま たは 「no」 の値。 入力す
る 値は、Boolean 型の値あ る いは String 型の
値。 こ のオプシ ョ ンに 「yes」 を設定す る 場
合は、 UserID、 Password、 お よ び Domain オ
プシ ョ ン を設定す る 必要はない
23
Web サービ スの機能拡張
.NET セ キ ュ リ テ ィ オ プ
ション
AuthenticationMode
CertificateFile
説明
使用 し たい認証モー ド の String 型の値。 こ
の値は 「basic」 ま たは 「digest」。
AuthenticationMode 値 は、 Microsoft MSDN
Web サ イ ト http://msdn2.microsoft.com/jajp/library/w67h0dw7.aspx で説明 さ れてい る
Web サー ビ ス ク ラ イ ア ン ト か ら サーバに
送信 し た い証明書 フ ァ イ ル の String 型の
値。String 型の値には、 リ モー ト 証明書フ ァ
イ ル へ の 完全 な パ ス お よ び URL を 持つ
ロ ーカル フ ァ イ ルを含め る こ と がで き る 。
複数フ ァ イ ルの場合は、 区切 り 記号 と し て
セ ミ コ ロ ン を使用す る 必要があ る
.NET Web サービ ス エ ン ジ ン では、 SetOptions メ ソ ッ ド の Options 引数
に SoapLog あ る いは ConnectionCache パ ラ メ ー タ を使用す る こ と はで
き ません。
EasySoap Web サービ ス エ ン ジ ンの使用
EasySoap Web サー
ビ ス エ ン ジ ンの選択
EasySoap Web サービ ス エ ン ジ ン を使用す る こ と がで き ます。 こ のエ ン
ジ ンは、.NET Web サービ ス エ ン ジ ンの拡張機能の一部をサポー ト し て
い ません。 EasySoap Web サービ ス エ ン ジ ンは、 下位互換のため、 お よ
び UNIX コ ン ピ ュ ー タ に配布 さ れ る EAServer コ ン ポーネ ン ト と 一緒
に使用す る ために残 さ れてい ます。
Web サービ ス プ ロ キ シ ウ ィ ザー ド の先頭ページで、あ る いは Web サー
ビ ス プ ロ ジ ェ ク ト のプ ロ パテ ィ シー ト の [Web サービ ス] タ ブで使用
し たい Web サービ ス エ ン ジ ン を設定 し ます。 新 し い Web サービ ス プ
ロ ジ ェ ク ト では、 [.Net エ ン ジ ン を 使用す る ] チ ェ ッ ク ボ ッ ク ス はデ
フ ォ ル ト で オ フ に な り ま す。 UNIX コ ン ピ ュ ー タ に配布す る 予定で
Web サービ ス アプ リ ケーシ ョ ン を開発 し てい る 場合は、 こ のチ ェ ッ ク
ボ ッ ク ス を オ ンに し ないで く だ さ い。
24
新機能
Web サービ スの機能拡張
SoapConnection オブ ジ ェ ク ト の新 し い メ ソ ッ ド
.NET SOAP 接続オプ
シ ョ ンのための メ ソ ッ
ド
1 つの引数ですべての SOAP 接続オプシ ョ ン を設定す る SetOptions メ
ソ ッ ド を使用す る かわ り に、 Web サービ ス アプ リ ケーシ ョ ンが要求す
る 特定のオプシ ョ ン を適用す る 個別の メ ソ ッ ド を使用す る こ と がで き
ま す。 以下の メ ソ ッ ド は、 .NET Web サー ビ ス の た め の SetOptions メ
ソ ッ ド を補 う ため、 あ る いは置 き 換え る ために使用で き ます。
SoapConnection
メソッド
説明
RemoveAuthentication
SoapConnection オブジ ェ ク ト か
ら Basic、 Digest、 Domain、 お よ
び統合 Windows 認証情報 を 消
去す る
Basic 認証を要求す る Web サー
ビ ス のための ク ラ イ ア ン ト 識別
情報を設定す る
SetBasicAuthentication
SetClientCertificateFile
Web サービ ス に接続す る ために
使用す る 証明書フ ァ イ ルを設定
す る 。 フ ァ イ ル名は、 セ ミ コ ロ
ン で区切っ た フ ァ イ ルの リ ス ト
にな る
SOAP 接続のための ク ラ イ ア ン
ト サ イ ド の タ イ ム ア ウ ト 値を
設定す る
SoapConnection オブジ ェ ク ト が
Web サ ー ビ ス へ の 接続 に 統合
Windows 認証を使用す る か ど う
か を決め る
SetTimeout
UseIntegratedWindows
Authentication
構文
conn.RemoveAuthentication ()
conn.SetBasicAuthentication (string domain,
string userID, string password)
conn.SetClientCertificateFile (string
filename)
conn.SetTimeout (long seconds)
conn.UseIntegratedWindowsAuthentication
(boolean useIWA)
すべての SoapConnection メ ソ ッ ド は、 Long デー タ 型の値を返 し ま す。
それ ら の メ ソ ッ ド は、 成功 し た場合は 0 を返 し 、 失敗 し た場合は 50 を
返 し ます。 メ ソ ッ ド 構文の conn 変数は、 イ ン ス タ ン ス化 し た
SoapConnection オブジ ェ ク ト を保持 し ます。
EasySoap SOAP 接続
オプ シ ョ ンのための メ
ソッド
以下の メ ソ ッ ド は、 EasySoap Web サービ ス のための SetOptions メ ソ ッ
ド を補 う ため、 あ る いは置 き 換え る ために使用で き ます。
SoapConnection メ ソ ッ ド
SetSoapLogFile
SetTimeout
UseConnectionCache
PowerBuilder 11
説明
未加工の SOAP メ ッ セージの ロ グ の
ためのフ ァ イ ル名を設定
構文
conn.SetSoapLogFile (string
filename)
conn.SetTimeout (long seconds)
SOAP 接続のための ク ラ イ ア ン ト サ
イ ド の タ イ ム ア ウ ト 値を設定する
接続キ ャ ッ シ ュ を Web サービ ス接続 conn.UseConnectionCache (boolean
cache)
で使用す る か ど う か を決め る
25
Web サービ スの機能拡張
すべての SoapConnection メ ソ ッ ド は、 Long デー タ 型の値を返 し ま す。
それ ら の メ ソ ッ ド は、 成功 し た場合は 0 を返 し 、 失敗 し た場合は 50 を
返 し ます。 メ ソ ッ ド 構文の conn 変数は、 イ ン ス タ ン ス化 し た
SoapConnection オブジ ェ ク ト を保持 し ます。
新 し い SoapConnection メ ソ ッ ド の使用に関す る 情報については、 オ ン
ラ イ ン ヘルプの 『PowerBuilder エ ク ス テ ン シ ョ ン リ フ ァ レ ン ス』 マ
ニ ュ アルあ る いは 『 リ リ ース ノ ー ト 』 を参照 し て く だ さ い。
プ ロキシ サーバ接続
を設定する ための別の
メソッド
ア プ リ ケーシ ョ ン ユーザがプ ロ キ シ サーバ を介 し て イ ン タ ーネ ッ ト
に 接 続 し て い る 場 合 は、 SetProxyServerOptions メ ソ ッ ド の か わ り に
SetProxyServer メ ソ ッ ド を使用 し て、プ ロ キ シ サーバ接続パ ラ メ ー タ を
割 り 当て る こ と がで き ます。
SetProxyServer メ ソ ッ ド には 2 つの構文があ り ます。
•
conn.SetProxyServer (string address, string userID, string password)
•
conn.SetProxyServer (string hostname, long port, string userID, string
password)
すべての SoapConnection メ ソ ッ ド は、 Long デー タ 型の値を返 し ま す。
それ ら の メ ソ ッ ド は、 成功 し た場合は 0 を返 し 、 失敗 し た場合は 50 を
返 し ます。 メ ソ ッ ド 構文の conn 変数は、 イ ン ス タ ン ス化 し た
SoapConnection オブジ ェ ク ト を保持 し ます。
最初の構文には 3 つの文字列引数があ り ま す。 こ の構文では、 プ ロ キ
シ サーバのホ ス ト 名 と 一緒に address 引数にプ ロ キ シ サーバのポー ト
の値を設定 し ま す。 次の書式を使用 し て address 引数にプ ロ キ シ エ ン
ド ポ イ ン ト を含め る こ と も で き ます。 http://hostname:port/path
2 つめの構文には、 プ ロ キ シ サーバ 名、 ポー ト 、 ユーザ ID、 お よ びパ
ス ワ ー ド に関す る 引数があ り ます。 port 引数は Long デー タ 型を受け取
り 、 ほかの引数は String デー タ 型を受け取 り ます。 古い
SetProxyServerOptions メ ソ ッ ド で使用す る 1 つの文字列引数 と 同 じ コ ン
ポーネ ン ト があ り ます。
26
新機能
Web サービ スの機能拡張
.NET Web サービ スのカ ス タ ム ヘ ッ ダのサポー ト
PowerBuilder 11 は、 .NET Web サービ ス の カ ス タ ム SOAP ヘ ッ ダ を サ
ポー ト し ます。
PowerBuilder .NET Web サービ ス プ ロ キ シ ジ ェ ネ レー タ は、SOAP ヘ ッ
ダ で送信 さ れ る 認証情報 を 要求す る Web サー ビ ス の メ ソ ッ ド に関す
る 構造体を作成 し ます。 生成 さ れた構造体の フ ィ ール ド の数、 お よ び
それ ら のデー タ 型は、 Web サービ ス の SOAP ヘ ッ ダ ク ラ ス に含まれ る
情報に依存 し ます。
生成 さ れた構造体の名前は、 (あ る 場合) Web サービ ス プ ロ キ シに割
り 当て る 接頭辞、お よ び Web サービ ス のための SOAP ヘ ッ ダ ク ラ ス の
名前で構成 さ れ ます。 た と えば、 プ ロ キ シ接頭辞 と し て 「ws_」 を割 り
当て、 SOAP ヘ ッ ダ ク ラ ス の名前が 「Authentication」 の場合、 生成 さ
れた構造体の名前は 「ws_Authentication」 にな り ます。
プ ロ キ シ ジ ェ ネ レー タ は、 生成 さ れた構造体内の認証値を渡す関数あ
る いは生成 さ れた構造体に認証値を渡すための関数 も 少な く と も 1 つ
作成 し ます。 作成 さ れた関数の種類は、 Web サービ ス SOAP ヘ ッ ダ ク
ラ ス の direction パ ラ メ ー タ で決ま り ます。 direction は 「in」、 「out」、 ま
たは 「inout」 にな り ます。
direction が 「in」 の場合、 PowerBuilder .NET Web サー ビ ス プ ロ キ シ
ジ ェ ネ レー タ は、 認証値を持つ構造体を作成 し た後に、 Web サービ ス
に生成 さ れた構造体を渡すために使用す る こ と がで き る 関数を作成 し
ま す。 こ の関数の名前は、 「set」 接頭辞 と 「value」 接尾辞を持つ Web
サービ ス SOAP ヘ ッ ダ ク ラ ス の名前で構成 さ れます。
SOAP ヘ ッ ダ ク ラ ス名 「Authentication」 を持つ例では、 関数の構文は
次の よ う にな り ます。
boolean setAuthenticationValue (ws_Authentication
AuthenticationValue)
戻 り 値は、 成功 し た場合は true、 失敗 し た場合は false にな り ます。 こ
の例では、 AuthenticationValue は、 カ ス タ ム ヘ ッ ダの Web サービ ス に
送信す る 生成 さ れた構造体に関す る 変数です。
SOAP ヘ ッ ダ direction パ ラ メ ー タ の値が 「out」 の場合、 PowerBuilder
.NET Web サービ ス プ ロ キ シ ジ ェ ネ レー タ は、 Web サービ ス の呼び出
し で SOAP ヘ ッ ダか ら 逆に情報を取得す る ために使用す る こ と がで き
る 関数を作成 し ま す。 こ の関数の名前は、 「get」 接頭辞 と 「value」 接
尾辞を持つ SOAP ヘ ッ ダ ク ラ ス の名前で構成 さ れ ます。
PowerBuilder 11
27
デー タ ウ ィ ン ド ウの機能拡張
SOAP ヘ ッ ダ ク ラ ス名 「Authentication」 を持つ例では、 関数の構文は
次の よ う にな り ます。
ws_Authentication getAuthenticationValue ( )
同 じ 例で、 SOAP ヘ ッ ダ direction パ ラ メ ー タ が 「inout」 の と き 、
setAuthenticationValue 関数お よ び getAuthenticationValue 関数の両方が作
成 さ れ ます。PowerScript で こ れ ら の関数を呼び出 し て、カ ス タ ム SOAP
ヘ ッ ダに認証値を設定 し た り 、 返 し た り す る こ と がで き ます。
デー タ ウ ィ ン ド ウの機能拡張
PowerBuilder® 11 では、 次のデー タ ウ ィ ン ド ウ への機能拡張が行われ
ま し た。
28
•
ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ 提示様式
•
リ ッ チテ キ ス ト の機能拡張
•
デー タ ウ ィ ン ド ウ 式で Decimal 型をサポー ト
•
Web デー タ ウ ィ ン ド ウ での ド ロ ッ プダ ウ ン デー タ ウ ィ ン ド ウ の新
し い様式
•
Web デー タ ウ ィ ン ド ウ の新 し い HTMLGen.PagingMethod プ ロ パ
ティ
•
ド ロ ッ プダ ウ ン カ レ ン ダ デー タ ウ ィ ン ド ウ オプシ ョ ン
•
すべてのデー タ ウ ィ ン ド ウ 区域での高 さ の自動調節プ ロ パテ ィ
•
改ページでグループ ヘ ッ ダ を非表示にす る 新 し いプ ロ パテ ィ
•
印刷プ レ ビ ュ ー時の青い境界線を非表示にす る 新 し いプ ロ パテ ィ
•
新 し い dbAlias デー タ ウ ィ ン ド ウ オブジ ェ ク ト プ ロ パテ ィ
•
新 し い ResetInk、 SaveInk、 お よ び SaveInkPic デー タ ウ ィ ン ド ウ メ
ソッド
•
デー タ ウ ィ ン ド ウ デー タ ソ ース と し ての Web サービ ス
•
デー タ ウ ィ ン ド ウ 検索引数の保存
•
デー タ ウ ィ ン ド ウ オブジ ェ ク ト の UseEllipsis プ ロ パテ ィ
•
検索引数 と し て null 値を指定
新機能
デー タ ウ ィ ン ド ウの機能拡張
ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ提示様式
PowerBuilder がデザ イ ン ビ ュ ーでデー タ ウ ィ ン ド ウ オブジ ェ ク ト を表
示す る ために使用す る 形式は、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト に対 し
て選択す る 提示様式で決ま り ます。 PowerBuilder 11 では、ツ リ ービ ュ ー
提示様式を使用 し たデー タ ウ ィ ン ド ウ を作成で き る よ う にす る 、 新 し
いデー タ ウ ィ ン ド ウ ウ ィ ザー ド を用意 し ま し た。 ツ リ ービ ュ ー提示様
式では、 階層デー タ を グループ化 し 、 折 り た たんだ り 展開 し た形式で
デー タ を表示で き ま す。 ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ ス タ イ ルは、
Web デー タ ウ ィ ン ド ウ では使用で き ません。
ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ ウ ィ ザー ド を使用 し て、 1 つの ツ リ ー
ビ ュ ー レベルを持つツ リ ービ ュ ー デー タ ウ ィ ン ド ウ オブジ ェ ク ト を
作成 し ます。 メ ニ ュ ー バーか ら [行|ツ リ ービ ュ ーレベルの作成] を
選択 し て、 ツ リ ービ ュ ーに さ ら に レベルを追加 し ます。
以下のサン プルの ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ は、EAS デモ デー タ
ベース内の department テーブル と employee テーブルを使用 し 、 2 つの
ツ リ ービ ュ ー レベルがあ り ます。 第 1 レベルは部署名です。 第 2 レベ
ルは各従業員が住む都道府県です。
PowerBuilder 11
29
デー タ ウ ィ ン ド ウの機能拡張
ツ リ ー ビ ュ ー デー タ ウ ィ ン ド ウ を 使用す る 場合、 状態ア イ コ ン を ク
リ ッ ク し て、 ノ ー ド を展開 し た り 折 り た たんだ り し ます。 状態ア イ コ
ンは、 ノ ー ド を折 り たたんでい る と き にはプ ラ ス記号 (+) 、 ノ ー ド を
展開 し てい る と き にはマ イ ナ ス記号 (-) と な り ます。 ノ ー ド を展開 し
てい る 場合、 デフ ォ ル ト で接続線が表示 さ れ、 親デー タ と 子デー タ が
ど の よ う に接続す る か を示 し ます。 ノ ー ド を折 り た たんでい る 場合は
親デー タ のみが表示 さ れ、 詳細デー タ は表示 さ れ ません。
ツ リ ービ ュ ー デー タ ウ ィ ン ド ウ ス タ イ ルは、 .NET Web フ ォ ーム アプ
リ ケーシ ョ ン に Web デー タ ウ ィ ン ド ウ を 作成す る ために使用す る こ
と も で き ま す。 (Web デー タ ウ ィ ン ド ウ の ツ リ ー ビ ュ ー Web デー タ
ウ ィ ン ド ウ ス タ イ ルは、 JSP タ ーゲ ッ ト ではサポー ト し ません。)
ツ リ ービ ュ ー Web デー タ ウ ィ ン ド ウ は、 Windows アプ リ ケーシ ョ ン の
ツ リ ー ビ ュ ー デー タ ウ ィ ン ド ウ で 使用可能 な ほ と ん ど の機能 を サ
ポー ト し ます。 ShowConnectLines お よ び ShowLeafNodeConnectLines プ
ロ パ テ ィ は、 パ フ ォ ーマ ン ス に関す る 理由で現在の リ リ ー ス ではサ
ポー ト し ません。
ツ リ ー ノ ー ド ア イ コ ン で使用 さ れ る イ メ ージ フ ァ イ ルは、 ほかの イ
メ ージ フ ァ イ ル と 同 じ よ う に、PBL と と も に Web サ イ ト に配布す る 必
要があ り ます。 こ れを行 う には、 プ ロ ジ ェ ク ト ペ イ ン タ の [ リ ソ ース
フ ァ イ ル] ページでア イ コ ン を選択 し ます。
プ ロパテ ィ 、 イ ベン
ト 、 および メ ソ ッ ド
30
ツ リ ービ ュ ー ス タ イ ル を カ ス タ マ イ ズす る ために ツ リ ービ ュ ー デー
タ ウ ィ ン ド ウ プ ロ パテ ィ を使用 し た り 、ツ リ ービ ュ ー ノ ー ド を展開 し
た り 、 折 り た たむための メ ソ ッ ド を使用 し た り 、 ノ ー ド が展開 ま たは
折 り た た ま れ る と き に起動 さ れ る イ ベ ン ト を 使用す る こ と がで き ま
す。 プ ロ パテ ィ 、 イ ベン ト 、 お よ び メ ソ ッ ド についての情報について
は、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マ ニ ュ アルあ る いはオ ン ラ イ
ン ヘルプの以下の ト ピ ッ ク を参照 し て く だ さ い。
•
プ ロ パテ ィ
Tree.Leaf.TreeNodeIconName
Tree.Level.#property
Tree.property
•
イ ベン ト
Expanded
Expanding
Collapsed
Collapsing
TreeNodeSelected
TreeNodeSelecting
新機能
デー タ ウ ィ ン ド ウの機能拡張
•
詳細情報
メソッド
Expand
Collapse
ExpandAll
CollapseAll
ExpandAllChildren
CollapseAllChildren
ExpandLevel
CollapseLevel
IsExpanded
SelectTreeNode
詳細については、 『ユーザーズ ガ イ ド 』 マ ニ ュ アルの 「ツ リ ービ ュ ー
提示様式」 を参照 し て く だ さ い。
リ ッ チ テキス ト の機能拡張
リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ 提示様式お よ び リ ッ チテ キ ス ト エ
デ ィ ッ ト コ ン ト ロ ールの両方が、 新 し い リ ッ チ テ キ ス ト エデ ィ タ を
使用 し ます。 こ れ ら の変更については、 50 ページの 「新規お よ び変更
さ れた PowerBuilder コ ン ト ロ ール」 で説明 し ます。
デー タ ウ ィ ン ド ウ式で Decimal 型をサポー ト
デ ー タ ウ ィ ン ド ウ は Decimal デ ー タ 型 を サ ポ ー ト し て い ま す が、
PowerBuilder の以前の リ リ ース では、デー タ ウ ィ ン ド ウ 式の Decimal 型
の値は Double デー タ 型に変換 さ れてい ま し た。 PowerBuilder 11 では、
デー タ ウ ィ ン ド ウ 式の Decimal 型の値を サポー ト し 、Decimal 型の値を
サポー ト す る 新 し いデー タ ウ ィ ン ド ウ 式関数を追加 し ま し た。 検索引
数に Decimal 型の値を使用す る こ と がで き ます。 PowerBuilder 11 では、
Decimal デー タ 型は 28 桁ま でサポー ト し ます。
オペ ラ ン ド の両方が Decimal デー タ 型を持つ場合、 以下の算術演算子
は PowerBuilder 11 では Decimal 型の値を返 し ます。
演算子
+
*
/
PowerBuilder 11
意味
加算
減算
乗算
除算
例
Subtotal + Tax
Price - Discount
Quantity * Price
Discount / Price
31
デー タ ウ ィ ン ド ウの機能拡張
オペ ラ ン ド の ど ち ら かが Decimal デー タ 型ではない場合は、 戻 り 値は
Double デー タ 型に変換 さ れ ま す。 指数演算子 (^) は引 き 続 き Double
デー タ 型を返 し ます。
数値を操作す る 関係演算子 (=、 >、 <、 <>、 >=、 お よ び <= を含む) は、
Decimal オペ ラ ン ド を扱 う こ と がで き ます。 Decimal オペ ラ ン ド の精度
は、 相対的に保持 さ れ ます。
次の関数は、 引数が Decimal 型の値の場合には Decimal デー タ 型を返
し ます。 Sum、 CumulativeSum、 Avg、 Median、 First、 Last、 Max、 Min、 Large、
Small、 Var、 VarP、 Mod、 Mode、 Abs、 Case、 If
次の新 し い関数は、 Double デー タ 型のかわ り に Decimal デー タ 型を返
し ます。 CrosstabAvgDec、 CrosstabMaxDec、 CrosstabMinDec、
CrosstabSumDec
新 し い Dec 関数は String 型を Decimal デー タ 型に変換 し ます。 デー タ
ウ ィ ン ド ウ 式で数字を Decimal 定数 と みなす よ う に、 大文字あ る いは
小文字の D を付加す る こ と も で き ます。 た と えば、 2.0d お よ び
123.456789012345678901D は、 Decimal デー タ 型 と し て扱われ ます。
Decimal お よ び Decimal 配列が、 検索引数の指定 ダ イ ア ロ グボ ッ ク ス の
デー タ 型の一覧に追加 さ れ ま し た。
新 し い関数の解説については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マ
ニ ュ アルあ る いはオ ン ラ イ ン ヘルプ を参照 し て く だ さ い。
Web デー タ ウ ィ ン ド ウでの ド ロ ッ プダウ ン デー タ ウ ィ ン ド ウの新 し い
様式
ド ロ ッ プ ダ ウ ン デー タ ウ ィ ン ド ウ 編集様式 を 使用す る カ ラ ム に タ ブ
移動す る 際に、 キーボー ド の矢印キーを使用 し てその値を変更す る こ
と がで き ま す。 カ ラ ム を ク リ ッ ク す る と 、 別の値に ス ク ロ ール し て そ
れを選択す る ために ク リ ッ ク す る こ と がで き る よ う に、 ド ロ ッ プダ ウ
ン デー タ ウ ィ ン ド ウ が表示 さ れます。
32
新機能
デー タ ウ ィ ン ド ウの機能拡張
以前は Web デー タ ウ ィ ン ド ウ 内の カ ラ ム を ク リ ッ ク す る と 、 デー タ
ウ ィ ン ド ウ 内のすべての行を表示 し てい ま し た。 新 し い様式では、 色
お よ び複数のカ ラ ム を よ り 正確に レ ン ダ リ ン グで き ます。
デー タ ウ ィ ン ド ウ ペ イ ン タ のプ ロ パテ ィ ビ ュ ーの [編集] ページで、
カ ラ ム の表示プ ロ パテ ィ を設定 し ま す。 [ ド ロ ッ プダ ウ ン の幅] プ ロ
パテ ィ は、 ド ロ ッ プダ ウ ン の表示幅を カ ラ ム の幅の割合で設定 し ます。
た と えば、 300 は表示幅を カ ラ ム幅の 3 倍に設定 し ます。
新 し い動作は イ ン ラ イ ン フ レーム (iFrames) を使用 し ます。 こ れは、
生成 さ れ る マー ク ア ッ プの量を増加 さ せ る こ と があ り ま す。 ド ロ ッ プ
ダ ウ ン デー タ ウ ィ ン ド ウ を 大量に使用す る デー タ ウ ィ ン ド ウ オ ブ
ジ ェ ク ト では、 ド ロ ッ プダ ウ ン デー タ ウ ィ ン ド ウ を HTML select 要素
で生成す る と い う 以前の動作を使用 し て、 帯域を節約す る ほ う が よ い
か も し れ ま せん。 こ れ を 行 う には、 [Web 生成] ページ で [設定す る
フ ォ ーマ ッ ト ] オプ シ ョ ン を 「HTML/XHTML」 に設定 し て [DDDW
フ レーム の生成] チ ェ ッ ク ボ ッ ク ス を オ フ に し ま す。 各方法で生成 さ
れた ソ ー ス を表示 し て、 それを フ ァ イ ルに保存 し 、 それか ら フ ァ イ ル
サ イ ズ を比較 し て、 そのデー タ ウ ィ ン ド ウ オブジ ェ ク ト に最適な方法
を判断す る こ と がで き ます。
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「HTMLGen.property」 を参照 し て く だ さ い。
Web デー タ ウ ィ ン ド ウの新 し い HTMLGen.PagingMethod プ ロパテ ィ
HTMLGen.Method プ ロ パテ ィ を設定す る には、 ペ イ ン タ のプ ロ パテ ィ
ビ ュ ーの [Web 生成] ページにあ る [設定す る フ ォ ーマ ッ ト ] ド ロ ッ
プダ ウ ン リ ス ト で 「HTML/XHTML」 を選択 し てか ら 、 [ページ ン グ メ
ソ ッ ド ] ド ロ ッ プダ ウ ン リ ス ト か ら 値を選択 し ます。 コ ー ド でプ ロ パ
テ ィ を設定す る こ と も で き ます。
HTMLGen.PagingMethod プ ロ パテ ィ は、 PagingMethod カ タ ロ グ デー タ
型変数の値を受け取 り ます。 デフ ォ ル ト は PostBack! です。
PowerBuilder 11
値
PostBack!
数値
0
CallBack!
1
説明
ページ ン グ処理はサーバに ポ ス ト さ れ
る
ページ ン グ処理は ク ラ イ ア ン ト サ イ ド
の ス ク リ プ ト コ ール バ ッ ク を 使用す
る 。 こ のプ ロ パテ ィ は、 HTMLGenerator
コ ン ポーネ ン ト では使用で き ない
33
デー タ ウ ィ ン ド ウの機能拡張
値
XMLClientSide!
数値
2
説明
ページ ン グ処理は、 すべての XML 結果
集合を取 り 出 し 、キ ャ ッ シ ュ さ れた ス タ
イ ル シー ト の XSLT の再変換 を 行 う こ
と で、 ク ラ イ ア ン ト で実行 さ れ る 。 こ の
オプシ ョ ン を使用す る には XML レ ン ダ
リ ン グ形式を使用す る 必要があ る
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マ ニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「HTMLGen.property」 を参照 し て く だ さ い。
ド ロ ッ プ ダウ ン カ レ ン ダ デー タ ウ ィ ン ド ウ オプ シ ョ ン
ド ロ ッ プ ダ ウ ン カ レ ン ダ デー タ ウ ィ ン ド ウ オ プ シ ョ ン は、 Date、
DateTime、 あ る いは TimeStamp デー タ 型のデー タ ウ ィ ン ド ウ カ ラ ム の
エデ ィ ッ ト マ ス ク で使用で き ま す。 [ ド ロ ッ プ ダ ウ ン カ レ ン ダ] エ
デ ィ ッ ト マ ス ク プ ロ パテ ィ オプ シ ョ ン は、 カ レ ン ダの年、 月、 日の
個々に対 し て選択で き ま す。 こ のオプシ ョ ン は、 エデ ィ ッ ト マ ス ク 編
集様式のカ ラ ムが選択 さ れ る と き に、デー タ ウ ィ ン ド ウ ペ イ ン タ プ ロ
パテ ィ ビ ュ ーの [編集] タ ブのチ ェ ッ ク ボ ッ ク ス で設定で き ます。 コ ー
ド で設定す る こ と も で き ます。 次の例の よ う に、 birth_date カ ラ ム に対
し て コ ー ド で設定す る こ と も で き ます。
dw_1.Modify("birth_date.EditMask.DDCalendar='Yes'")
Windows アプ リ ケーシ ョ ン での西暦の範囲は 1753 か ら 3000 です。 ス
ク リ プ ト あ る いはカ ラ ム のプ ロ パテ ィ ビ ュ ーの [その他] ページで、
カ レ ン ダの表示を制御す る ために以下のプ ロ パテ ィ を設定す る こ と が
で き ます。
ペ イ ン タ オプ シ ョ ン
ド ロ ッ プダ ウ ンの右揃え
カ レ ン ダの背景色
カ レ ン ダのテ キ ス ト 色
カ レ ン ダ タ イ ト ルの背景色
カ レ ン ダ タ イ ト ルのテ キ ス
ト色
カ レ ン ダ ト レー ラ のテキ ス
ト色
34
プ ロパテ ィ
Column.Editmask.ddcal_alignright
Column.Editmask.ddcal_backcolor
Column.Editmask.ddcal_textcolor
Column.Editmask.ddcal_titlebackcolor
Column.Editmask.ddcal_titletextcolor
Column.Editmask.ddcal_trailingtextcolor
新機能
デー タ ウ ィ ン ド ウの機能拡張
ド ロ ッ プ ダ ウ ン カ レ ン ダ オ プ シ ョ ン で選択 し た日付が Web デー タ
ウ ィ ン ド ウ で希望す る エデ ィ ッ ト マ ス ク で表示 さ れ る よ う にす る に
は、 [ ク ラ イ ア ン ト での書式化] オプシ ョ ン を指定 し て、 デー タ ウ ィ ン
ド ウ に対 し て静的 JavaScript の生成 と 配布が含 ま れ る よ う に し ま す。
帯域使用を減少 さ せ る ために、 デフ ォ ル ト では ク ラ イ ア ン ト での書式
化 を 行 う JavaScript は含 ま れ ま せん。 こ の ス ク リ プ ト を 含め る には、
デー タ ウ ィ ン ド ウ プ ロ パテ ィ ビ ュ ーの [Web 生成] ページで [ ク ラ イ
ア ン ト での書式化] チ ェ ッ ク ボ ッ ク ス を オ ン に し ま す。 ク ラ イ ア ン ト
での書式化を行 う ス ク リ プ ト を含めない場合は、 ド ロ ッ プダ ウ ン カ レ
ン ダはデフ ォ ル ト のエデ ィ ッ ト マ ス ク を使用 し て、 ク ラ イ ア ン ト コ ン
ピ ュ ー タ のデ フ ォ ル ト の地域の設定 を も と に カ ラ ム デー タ を 表示 し
ます。
以下の よ う に ド ロ ッ プダ ウ ン カ レ ン ダ内で操作 し ます。
•
上端の矢印を ク リ ッ ク し て、 月か ら 月に移動す る
•
月を ク リ ッ ク し て月の リ ス ト を表示 し 、 それか ら 月を ク リ ッ ク し
て選択す る
•
年を ク リ ッ ク し て ス ピ ン コ ン ト ロ ールを表示 し 、 それか ら ス ピ ン
コ ン ト ロ ールの矢印を使用 し て年を選択す る
•
日を ク リ ッ ク し て日付を選択 し 、 カ レ ン ダ を閉 じ る
•
〔Esc〕 を押 し て、 選択を変更 し ないでカ レ ン ダ を閉 じ る
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「EditMask.property」 を参照 し て く だ さ い。
すべてのデー タ ウ ィ ン ド ウ区域での高 さ の自動調節プ ロパテ ィ
PowerBuilder 11 では、 Height.Autosize プ ロ パテ ィ をデー タ ウ ィ ン ド ウ
の ど の区域で も 設定で き ます。 以前の PowerBuilder の リ リ ース では、こ
のプ ロ パテ ィ は詳細区域でのみ使用で き ま し た。
PowerBuilder 11
35
デー タ ウ ィ ン ド ウの機能拡張
Height.Autosize プ ロパテ ィ の制限
•
Height.Autosize プ ロ パテ ィ は、 グ ラ フ、 ラ ベル、 OLE 、 ま たは リ ッ
チテ キ ス ト 提示様式のデー タ ウ ィ ン ド ウ ではサポー ト し ません。
•
次のページ ま で続 く ネ ス テ ィ ッ ド レ ポー ト は、 詳細区域のみを サ
ポー ト し ます。
•
自動調節に よ り 1 ページに少な く て も 1 行の詳細区域を表示で き
な く な る 場合は、 区域を自動調節す る こ と がで き ません。
Height.Autosize プ ロ パテ ィ を選択す る と 、 ピ ク チ ャ ま たはネ ス テ ィ ッ
ド レ ポー ト の内容全体を表示で き る よ う に、 区域の最小の高 さ を設定
し ます。 デー タ ウ ィ ン ド ウ 区域のプ ロ パテ ィ ビ ュ ーの [全般] タ ブで
こ のプ ロ パテ ィ を選択で き ま す。 PowerScript® で実行時にデー タ ウ ィ
ン ド ウ 区域の Height.Autosize プ ロ パテ ィ を修正す る こ と がで き ます。
dw_2.modify ("DataWindow.header.height.autosize=yes")
dw_2.modify ("DataWindow.footer.height.autosize=no")
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マ ニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「Bandname.propery」 を参照 し て く だ さ い。
改ページ でグループ ヘ ッ ダ を非表示にする新 し いプ ロパテ ィ
PowerBuilder 11 では、 改ページ後のグループ化 さ れたデー タ ウ ィ ン ド
ウ オブジ ェ ク ト 内に表示す る グループ ヘ ッ ダ を非表示にす る 新 し い
プ ロ パテ ィ が追加 さ れ ま し た。 こ のプ ロ パテ ィ を グループ ヘ ッ ダ区域
でのみ設定す る こ と がで き ます。
グループの リ ス ト がページ を ま たが る と き 、 こ のプ ロ パテ ィ を設定 し
たすべてのグループ ヘ ッ ダは表示 さ れ ません。 非表示のヘ ッ ダはペー
ジ の上部に表示 さ れ ま せん。 すべて の グ ループ ヘ ッ ダ が非表示の場
合、ページ を ま たが る 連続す る リ ス ト と し て グループは表示 さ れ ます。
し か し 、 改ページが新 し いグループの開始 と 重な る と 、 新 し いグルー
プ ヘ ッ ダ よ り 上位のヘ ッ ダのみが非表示にな り ます。
グループ ヘ ッ ダ区域のプ ロ パテ ィ ビ ュ ーで [グループヘ ッ ダの非表
示] チ ェ ッ ク ボ ッ ク ス を オ ン に し て、 グループヘ ッ ダの非表示プ ロ パ
テ ィ を有効に し ます。 Describe お よ び Modify メ ソ ッ ド を使用 し て、実行
時にプ ロ パテ ィ の設定を確認 し た り 、 変更 し た り で き ます。
string s
s = dw_1.describe("datawindow.header.1.suppress")
dw_1.modify("datawindow.header.1.suppress=no")
36
新機能
デー タ ウ ィ ン ド ウの機能拡張
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「Bandname.propery」 を参照 し て く だ さ い。
印刷プ レ ビ ュ ー時の青い境界線を非表示にする新 し いプ ロパテ ィ
デフ ォ ル ト の印刷プ レ ビ ュ ー モー ド では、 余白の位置を示すために青
い線が表示 さ れ ます。 デー タ ウ ィ ン ド ウ ペ イ ン タ のプ ロ パテ ィ ビ ュ ー
の [印刷の仕様] ページで [印刷プ レ ビ ュ ーの境界表示] チ ェ ッ ク ボ ッ
ク ス を オ フ にす る こ と で、 こ の線を非表示にす る こ と がで き ます。
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「Print.property」 を参照 し て く だ さ い。
新 し い dbAlias デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト プ ロパテ ィ
dbAlias デー タ ウ ィ ン ド ウ オブジ ェ ク ト プ ロ パテ ィ に よ り 、 ス ク リ プ
ト でテーブル名のエ リ ア ス を使用す る カ ラ ム名を取得す る こ と がで き
ます。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の SELECT 文でテーブル名にエ
リ ア ス が定義 し て あ り 、 動的に update WHERE 句を操作で き る よ う に
テーブル エ リ ア ス を 持つカ ラ ム 名 を 取得 し た い場合に、 こ のプ ロ パ
テ ィ を使用 し ます。
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「dbAlias」 を参照 し て く だ さ い。
新 し い ResetInk、 SaveInk、 お よび SaveInkPic デー タ ウ ィ ン ド ウ メ
ソッド
SaveInk メ ソ ッ ド は、オーバーレ イ イ ン ク をデー タ ウ ィ ン ド ウ 内の イ ン
ク ピ ク チ ャ コ ン ト ロ ールか ら フ ァ イ ル あ る いは blob に保存 し ま す。
SaveInkPic メ ソ ッ ド は、 ピ ク チ ャ を保存 し 、 オプシ ョ ン でオーバーレ イ
イ ン ク を フ ァ イ ルに保存 し ます。 ResetInk は、 コ ン ト ロ ールか ら イ ン ク
を消去 し ます。
詳細については、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルあ る
いはオ ン ラ イ ン ヘルプの 「ResetInk」、 「SaveInk」、 「SaveInkPic」 を参照
し て く だ さ い。
PowerBuilder 11
37
デー タ ウ ィ ン ド ウの機能拡張
デー タ ウ ィ ン ド ウ デー タ ソ ース と し ての Web サービ ス
PowerBuilder 11 では、 リ ッ チテ キ ス ト お よ び OLE を除 く 提示様式の
デー タ ウ ィ ン ド ウ オブジ ェ ク ト のデー タ ソ ース と し て Web サービ ス
を使用す る こ と がで き ます。
デー タ ウ ィ ン ド ウ オブジ ェ ク ト に関す る Web サービ ス デー タ ソ ース
の使用の詳細については、PowerBuilder の 『ユーザーズ ガ イ ド 』 マニ ュ
アルの 「デー タ ウ ィ ン ド ウ の定義」 の章を参照 し て く だ さ い。
Web サービ ス デー タ ソ ース を使用 し たデー タ ウ ィ ン ド ウ オブジ ェ ク
ト の更新の詳細については、 PowerBuilder の 『ユーザーズ ガ イ ド 』 マ
ニ ュ アルの 「デー タ ウ ィ ン ド ウ オブジ ェ ク ト での更新の制御」 の章を
参照 し て く だ さ い。
デー タ ウ ィ ン ド ウ検索引数の保存
PowerBuilder の以前のバージ ョ ン では、 検索引数の指定 ダ イ ア ロ グ
ボ ッ ク ス でデー タ ウ ィ ン ド ウ オブ ジ ェ ク ト に対 し て検索引数 を 指定
し た と き 、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト は指定 し た検索引数の値を
保存す る こ と がで き ませんで し た。
ユーザ ビ リ テ ィ を拡張す る ために、 PowerBuilder では検索引数の指定
ダ イ ア ロ グ ボ ッ ク ス には [検索引数の状態保存] チ ェ ッ ク ボ ッ ク ス が
追加 さ れ ま し た。 [検索引数の状態保存] チ ェ ッ ク ボ ッ ク ス がオ ンの場
合、 デー タ の値が保存 さ れ、 [OK] ボ タ ン を押す と 、 チ ェ ッ ク ボ ッ ク
ス はオ ンの ま ま にな り ます。 [検索引数の状態保存] チ ェ ッ ク ボ ッ ク ス
を オ フ に し て、 [OK] を ク リ ッ ク す る と 、 デー タ の値が削除 さ れ ます。
こ の機能は、 開発環境でのみ使用で き ます。
ネス ト さ れたデー タ ウ ィ ン ド ウおよび コ ンポジ ッ ト デー タ ウ ィ ン ド ウでは使
用で き ない
ネ ス ト さ れたデー タ ウ ィ ン ド ウ あ る いは コ ン ポ ジ ッ ト デー タ ウ ィ ン
ド ウ で検索引数の状態を 保存す る 機能 を使用す る こ と はで き ま せん。
そのため、 [検索引数の状態保存] チ ェ ッ ク ボ ッ ク ス はグ レー表示にな
り ます。
新 し いデー タ ウ ィ ン ド ウ では、 デー タ ウ ィ ン ド ウ を保存 し てそれに名
前を付け る ま で、 [検索引数の状態保存] チ ェ ッ ク ボ ッ ク ス は使用で き
ません。 チ ェ ッ ク ボ ッ ク ス を有効にす る には、 デー タ ウ ィ ン ド ウ オブ
ジ ェ ク ト あ る いはプ レ ビ ュ ー ビ ュ ー を 閉 じ て再度開 く 必要が あ り ま
す。
38
新機能
デー タ ウ ィ ン ド ウの機能拡張
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の UseEllipsis プ ロパテ ィ
エデ ィ ッ ト 編集様式あ る いはエデ ィ ッ ト マ ス ク 編集様式を持つカ ラ ム
が、 デー タ ウ ィ ン ド ウ のカ ラ ム で表示 し き れない長 さ の文字デー タ を
含む場合は、 デー タ が省略表示 さ れ ます。 省略表示 さ れたデー タ の最
後に省略記号を表示す る よ う にで き ます。こ れを行 う には、プ ロ パテ ィ
ビ ュ ーの [書式] ページで [省略記号の使用] チ ェ ッ ク ボ ッ ク ス を オ
ン にす る か、 ス ク リ プ ト で UseEllipsis デー タ ウ ィ ン ド ウ オブジ ェ ク ト
プ ロ パテ ィ を指定 し ます。
dw1.Object.col1.Edit.UseEllipsis = Yes
dw1.Modify("col1.Edit.UseEllipsis=Yes")
dw1.Object.col1.EditMask.UseEllipsis = Yes
dw1.Modify("col1.EditMask.UseEllipsis=Yes")
表示テ キ ス ト に関 し て、 文字列の最後が長方形の中に納ま ら ない場合
は、 文字列が省略表示 さ れ て、 省略記号が表示 さ れ ま す。 カ ラ ム に
フ ォ ーカ ス があ る と き には、 省略記号は表示 さ れ ません。
次の状況では、 プ ロ パテ ィ は無視 さ れ ます。
•
[位置] ページの [高 さ の自動調節] がオ ン にな っ てい る か、 ま た
は ス ク リ プ ト に Height.Autosize プ ロ パテ ィ が設定 さ れてい る 場合
•
テ キ ス ト を回転す る ために [フ ォ ン ト ] ページで [回転角] プ ロ
パテ ィ 、 ま たは、 ス ク リ プ ト で Font.Escapement プ ロ パテ ィ に式が
指定 さ れてい る 場合
UseEllipsis デー タ ウ ィ ン ド ウ オブジ ェ ク ト プ ロ パテ ィ は、 Web フ ォ ー
ム アプ リ ケーシ ョ ン ではサポー ト さ れ ません。
検索引数 と し て null 値を指定
デー タ ウ ィ ン ド ウ ペ イ ン タ で検索引数 を 受け取 る デー タ ウ ィ ン ド ウ
を プ レ ビ ュ ーす る と き 、 1 つ以上の引数が null 値を持つ よ う に指定 し
たい場合があ り ます。 検索引数 ダ イ ア ロ グボ ッ ク ス では、 各検索引数
の隣にチ ェ ッ ク ボ ッ ク ス があ り ます。 引数が null 値を持つ こ と を指定
す る 場合は、 こ のチ ェ ッ ク ボ ッ ク ス を選択 し ま す。 [値] ボ ッ ク ス に
値を入力す る と 、 こ のチ ェ ッ ク ボ ッ ク ス は ク リ ア さ れます。
PowerBuilder 11
39
ウ ィ ン ド ウ コ ン ト ロールの新 し い機能
ウ ィ ン ド ウ コ ン ト ロールの新 し い機能
次の ウ ィ ン ド ウ コ ン ト ロ ールの新 し いプ ロ パテ ィ を使用 し て、 アプ リ
ケーシ ョ ンに特殊な効果を追加す る こ と がで き ます。
•
ア ニ メ ーシ ョ ン効果を備え た ウ ィ ン ド ウ の開閉
•
ウ ィ ン ド ウ の透明度
ウ ィ ン ド ウ のプ ロ パテ ィ ビ ュ ーの [全般] ページでプ ロ パテ ィ を設定
し ます。
ア ニ メ ーシ ョ ン効果を備えたウ ィ ン ド ウの開閉
ウ ィ ン ド ウ を開 く 、 ま たは閉 じ る と き に特定の効果を利用す る こ と が
で き ます。 効果には、 フ ェー ド イ ン、 フ ェー ド ア ウ ト 、 中央か ら 開 く 、
上下左右か ら の ス ラ イ ド 表示や ロ ー リ ン グ な ど が含 ま れ ま す。 ア ニ
メ ーシ ョ ン時間 (AnimationTime) プ ロ パテ ィ を 1 ~ 5000 ミ リ 秒間の
値に設定 し て、 ア ニ メ ーシ ョ ン効果の完了ま でにかか る 時間を指定 し
ます。
た と えば、 ア プ リ ケーシ ョ ン の メ イ ン ウ ィ ン ド ウ を 初期化中に ス プ
ラ ッ シ ュ 画面が表示 さ れてい る 場合を想定 し ます。 こ の場合、 アプ リ
ケーシ ョ ン の初期化後 ま たは タ イ ム ア ウ ト 後に、 ウ ィ ン ド ウ を単に閉
じ る のではな く フ ェ ー ド ア ウ ト さ せ る こ と がで き ます。
w_splash.CloseAnimation = FadeAnimation!
詳細については、 オ ン ラ イ ン ヘルプあ る いは 『オブジ ェ ク ト と コ ン
ト ロ ール』 マニ ュ アルの ウ ィ ン ド ウ コ ン ト ロ ールに関す る
OpenAnimation、 CloseAnimation、 お よ び AnimationTime プ ロ パテ ィ を
参照 し て く だ さ い。
ウ ィ ン ド ウの透明度
ウ ィ ン ド ウ の透明度 (Transparency) プ ロ パテ ィ に 1 ~ 100% の間の値
を指定す る こ と がで き ます。 こ のプ ロ パテ ィ は、 モー ド レ ス ダ イ ア ロ
グ ボ ッ ク ス が フ ォ ーカ ス を失っ た と き に、 そのダ イ ア ロ グ ボ ッ ク ス を
表示 し た ま ま半透明に し たい場合に便利です。
詳細については、 オ ン ラ イ ン ヘルプあ る いは 『オブジ ェ ク ト と コ ン ト
ロ ール』 マニ ュ アルの ウ ィ ン ド ウ コ ン ト ロ ールに関す る Transparency
プ ロ パテ ィ を参照 し て く だ さ い。
40
新機能
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
PowerBuilder 11 では、 次の PowerBuilder ユーザ イ ン タ フ ェースへの変
更が行われ ま し た。
PowerBuilder 11
•
新 し いア イ コ ン
•
メ ニ ュ ーお よ びツールバーの機能拡張
•
XP でのボ タ ン の背景色の表示
•
新 し い タ ーゲ ッ ト の種類
•
現行 タ ーゲ ッ ト の設定
•
プ ロ ジ ェ ク ト ペ イ ン タ の拡張
•
シ ス テ ム ツ リ ーの拡張
•
出力 ウ ィ ン ド ウ の拡張
•
サ イ ズ変更可能なダ イ ア ロ グボ ッ ク ス
•
PowerBuilder Application Server Plug-in のサポー ト
•
ウ ィ ザー ド で使用可能な アプ リ ケーシ ョ ンサーバ プ ロ フ ァ イ ル
ダ イ ア ロ グボ ッ ク ス
•
ソ ー ス 管理内のオブジ ェ ク ト に関す る 警告 メ ッ セージ を表示 し な
い
•
オー ト ス ク リ プ ト オプシ ョ ンの設定
•
コ ピー と 貼 り 付けのための更新日を表示
•
サ イ ズ変更 さ れたオブジ ェ ク ト ブ ラ ウ ザ内の タ ーゲ ッ ト フ ィ ー
ルド
•
編集様式を オブジ ェ ク ト 詳細ビ ュ ーで作成
•
例外送出時にデバ ッ ガ を中断
•
デバ ッ グのための EAServer コ ン ポーネ ン ト の選択
41
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
新 し いア イ コ ン
PowerBuilder ユーザ イ ン タ フ ェ ース のア イ コ ン を一新 し ま し た。 その
新 し い ア イ コ ン を ア プ リ ケ ー シ ョ ン で 使 用 す る こ と が で き ま す。
PowerBuilder 11 に ア プ リ ケ ー シ ョ ン を 移行す る 際には、 ア プ リ ケ ー
シ ョ ン が使用す る PowerBuilder の組み込みア イ コ ンは自動的に更新 さ
れ ます。
メ ニ ュ ーお よびツールバーの機能拡張
PowerBuilder では、 メ ニ ュ ー ペ イ ン タ を使用 し て メ ニ ュ ーお よ びツー
ルバー を 作成 し ま す。 ツ ールバーは メ ニ ュ ー と 関連 し 、 そ の ツ ール
バー ボ タ ン は メ ニ ュ ーの選択項目の シ ョ ー ト カ ッ ト と し て動作 し ま
す。
メ ニ ュ ー ス タ イル PowerBuilder で 作 成 す る ア プ リ ケ ー シ ョ ン の メ
ニ ュ ーお よ び ツ ールバーの表示を カ ス タ マ イ ズす る こ と がで き ま す。
PowerBuilder の以前のバージ ョ ン か ら イ ン ポー ト あ る いは移行す る メ
ニ ュ ーは、デフ ォ ル ト で ト ラ デ ィ シ ョ ナル メ ニ ュ ー ス タ イ ルを使用 し
ます。
コ ン テ ン ポ ラ リ ス タ イ ルの メ ニ ュ ーは、 Microsoft Office 2003 お よ び
Visual Studio 2005 に似た 3 次元 メ ニ ュ ーの外観を持ち、 ビ ッ ト マ ッ プ
お よ び メ ニ ュ ー タ イ ト ル部分を含め る こ と がで き ます。
ツールバーのス タ イル プ ロパテ ィ ツ ールバーには、 ト ッ プ レ ベルの メ
ニ ュ ー オブ ジ ェ ク ト でデザ イ ン時に変更で き る ス タ イ ル プ ロ パテ ィ
があ り ます。 ト ッ プ レベルの メ ニ ュ ー オブジ ェ ク ト の ツールバー ス タ
イ ル と し て contemporarytoolbar! を選択 し た場合のみ こ れ ら のプ ロ
パテ ィ を変更す る こ と がで き ます。
PowerBuilder 11 開発環境での メ ニ ュ ー と ツールバーは、 コ ン テ ン ポ ラ
リ ス タ イ ルを使用 し ます。
PowerBuilder の以前のバージ ョ ン では、 MDI ウ ィ ン ド ウ でのみツール
バーを使用す る こ と がで き ま し た。 PowerBuilder 11 では、 ウ ィ ン ド ウ
の種類 Main! で も 同 じ よ う に ツールバーを使用す る こ と がで き ます。
42
新機能
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
メ ニ ュ ー と ツールバーの詳細については、『ユーザーズ ガ イ ド 』 マニ ュ
アルの第 14 章「 メ ニ ュ ー と ツールバーでの作業」 を参照 し て く だ さ い。
XP でのボ タ ンの背景色の表示
XP オペ レーテ ィ ン グ シ ス テ ム で、 デー タ ウ ィ ン ド ウ 内のボ タ ン の背
景色を変更す る と き 、 デフ ォ ル ト では、 その変更はプ レ ビ ュ ー ビ ュ ー
あ る いはアプ リ ケーシ ョ ン実行時に表示 さ れません。 こ れは、 通常 XP
テーマがボ タ ン の背景色を制御す る か ら です。
プ レ ビ ュ ー モー ド で変更 を 表示す る には、 PB.INI フ ァ イ ルの [Data
Window] セ ク シ ョ ン で ShowBackColorOnXP プ ロ パテ ィ を設定 し ます。
[Data Window]
ShowBackColorOnXP=1
実行時に変更を表示す る には、 デー タ ウ ィ ン ド ウ を表示す る 前に次の
ス テー ト メ ン ト のいずれか を実行す る ス ク リ プ ト に追加 し ます。
dw_1.Object.DataWindow.ShowBackColorOnXP = "yes"
dw_1.Modify("DataWindow.ShowBackColorOnXP = yes")
新 し い タ ーゲ ッ ト の種類
PowerBuilder の以前のバージ ョ ン では、 PowerScript タ ーゲ ッ ト お よ び
Web (JSP) タ ーゲ ッ ト の 2 種類の タ ーゲ ッ ト のみを作成で き ま し た。
新規作成 ダ イ ア ロ グ ボ ッ ク ス の [ タ ーゲ ッ ト ] ページで EAServer コ
ン ポーネ ン ト 、COM/COM+ コ ン ポーネ ン ト 、 あ る いはオー ト メ ーシ ョ
ン サーバ を選択 し た場合、 PowerScript アプ リ ケーシ ョ ン タ ーゲ ッ ト
に コ ン ポーネ ン ト を作成 し ま し た。 PowerBuilder 11 開発環境でのユー
ザビ リ テ ィ を拡張す る ために、 タ ーゲ ッ ト ページの項目は特定の種類
の タ ーゲ ッ ト を作成 し ます。
PowerBuilder 11 には、 い く つかの新 し い タ ーゲ ッ ト の種類が追加 さ れ
て い ま す。 ア プ リ ケーシ ョ ン サーバ コ ン ポーネ ン ト ウ ィ ザー ド は、
J2EE サーバに配布す る コ ン ポーネ ン ト を 作成 し ま す。 詳細につい て
は、 47 ページの 「PowerBuilder Application Server Plug-in のサポー ト 」 を
参照 し て く だ さ い。 4 種類の .NET ウ ィ ザー ド があ り ます。 詳細につい
ては、 12 ページの 「.NET 配布機能」 を参照 し て く だ さ い。
PowerBuilder 11
43
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
新規作成 ダ イ ア ロ グ ボ ッ ク ス の [ タ ーゲ ッ ト ] ページの EAServer コ
ン ポーネ ン ト 項目は、 PowerBuilder の以前のバージ ョ ン のア プ リ ケー
シ ョ ン タ ーゲ ッ ト ではな く 、 EAServer タ ーゲ ッ ト を作成す る ウ ィ ザー
ド を表示 し ます。
オー ト メ ーシ ョ ン サーバお よ び COM/COM+ ウ ィ ザー ド は、 新規作成
ダ イ ア ロ グ ボ ッ ク ス の [ タ ー ゲ ッ ト ] ペー ジ か ら 削除 さ れ ま し た。
COM/COM+ あ る いはオー ト メ ーシ ョ ン サーバ コ ン ポーネ ン ト を作成
す る には、 最初に ア プ リ ケーシ ョ ン タ ーゲ ッ ト を 作成 し 、 [PB オブ
ジ ェ ク ト ] ページの ウ ィ ザー ド を使用 し て、 コ ン ポーネ ン ト を作成 し
ます。
新 し い タ ーゲ ッ ト にはそれぞれ、 関連す る プ ロ ジ ェ ク ト が あ り ま す。
プ ロ ジ ェ ク ト オブジ ェ ク ト で配布、実行、デバ ッ グ命令を指定 し ます。
タ ーゲ ッ ト 内の ラ イ ブ ラ リ が別の種類の タ ーゲ ッ ト のプ ロ ジ ェ ク ト を
含む場合は、 シ ス テ ム ツ リ ーに表示 さ れません。
現行 タ ーゲ ッ ト の設定
現行 タ ーゲ ッ ト は、 シ ス テ ム ツ リ ーに太字で表示 さ れます。 現行 タ ー
ゲ ッ ト は、 新規作成 ダ イ ア ロ グ ボ ッ ク ス、 お よ び実行 と デバ ッ グで使
用 さ れ る デフ ォ ル ト の タ ーゲ ッ ト です。 現行 タ ーゲ ッ ト は次の こ と を
行 う と き に設定 さ れます。
•
シ ス テ ム ツ リ ー、 ラ イ ブ ラ リ ペ イ ン タ 、 あ る いは メ イ ン メ ニ ュ ー
で タ ーゲ ッ ト あ る いは タ ーゲ ッ ト の子に影響す る ア ク シ ョ ン (構
築、 移行、 実行、 あ る いはデバ ッ グ な ど) を呼び出す と き 。 検索
や移行な ど の一部のア ク シ ョ ン では、 ダ イ ア ロ グ ボ ッ ク ス が表示
さ れ ま す。 ダ イ ア ロ グ ボ ッ ク ス で [キ ャ ン セル] ボ タ ン を ク リ ッ
ク し て ア ク シ ョ ン を キ ャ ン セルす る 場合、 現行 タ ーゲ ッ ト は変更
さ れ ません。
•
オブジ ェ ク ト ペ イ ン タ を開 く と き 、 あ る いは JSP タ ーゲ ッ ト の
フ ァ イ ルを開 く と き
•
ア ク テ ィ ブ オブジ ェ ク ト ペ イ ン タ を変更す る と き
シ ス テ ム ツ リ ーで タ ーゲ ッ ト の [現行 タ ーゲ ッ ト に設定] メ ニ ュ ー項
目を使用す る か、 [フ ァ イ ル|現行 タ ーゲ ッ ト の設定] メ ニ ュ ー項目を
使用 し て、 現行 タ ーゲ ッ ト を 明確に設定 し た い場合、 シ ス テ ム オプ
シ ョ ン ダ イ ア ロ グボ ッ ク ス の [ ワー ク スペース] タ ブ ページの [現行
タ ーゲ ッ ト を自動設定] チ ェ ッ ク ボ ッ ク ス を オ フ に し ます。
44
新機能
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
プ ロ ジ ェ ク ト ペ イ ン タ の拡張
プ ロ ジ ェ ク ト ペ イ ン タ では、オブジ ェ ク ト の選択 ダ イ ア ロ グボ ッ ク ス
お よ びプ ロ パ テ ィ ダ イ ア ロ グ ボ ッ ク ス が削除 さ れ ま し た。 [プ ロ パ
テ ィ ] タ ブ ページはペ イ ン タ ワ ー ク ス ペー ス に表示 さ れ ま す。 オブ
ジ ェ ク ト の選択 ダ イ ア ロ グ ボ ッ ク ス で行 っ て い た選択は、 今はプ ロ
ジ ェ ク ト ペ イ ン タ ワ ー ク ス ペー ス の [ コ ン ポーネ ン ト ] タ ブ ページ
で行 う こ と がで き ます。 オ ン ラ イ ン ヘルプ を見 る には、 ペ イ ン タ ワ ー
ク ス ペー ス で右 ク リ ッ ク し 、 [ヘルプ] ポ ッ プ ア ッ プ メ ニ ュ ーを表示
し ます。
ほ と ん ど のプ ロ ジ ェ ク ト ペ イ ン タ には、 [実行] タ ブ ページがあ り ま
す。 こ のページで行 う 設定は、 タ ーゲ ッ ト に よ り 異な り ます。 ほ と ん
ど のプ ロ ジ ェ ク ト で、 コ マ ン ド ラ イ ン 引数 を 指定 し て、 ア プ リ ケー
シ ョ ン が 開 始す る デ ィ レ ク ト リ を 変 更す る こ と が で き ま す。 Web
フ ォ ーム タ ーゲ ッ ト では、 アプ リ ケーシ ョ ン を実行す る ブ ラ ウ ザを選
択す る こ と がで き ます。EAServer お よ びアプ リ ケーシ ョ ンサーバ コ ン
ポーネ ン ト に関 し て、 コ ン ポーネ ン ト を呼び出す ク ラ イ ア ン ト アプ リ
ケ ー シ ョ ン を 開始 し た り 、 PowerBuilder の別の イ ン ス タ ン ス 内のデ
バ ッ ガで ク ラ イ ア ン ト ア プ リ ケーシ ョ ン を 実行 し た り す る よ う に選
択で き ます。
シ ス テム ツ リ ーの拡張
PowerBuilder 11 ではシ ス テ ム ツ リ ーに次の拡張が行われ ま し た。
PowerBuilder 11
•
シ ス テ ム ツ リ ーで イ ベン ト あ る いは関数を ダブル ク リ ッ ク し て、
その ス ク リ プ ト をペ イ ン タ で開 く こ と がで き ます。
•
ス ク リ プ ト を持つ イ ベン ト お よ び関数は、 ス ク リ プ ト ア イ コ ン で
識別す る こ と がで き ます。
•
.NET アセ ンブ リ を .NET プ ロ ジ ェ ク ト に イ ン ポー ト す る 場合、 ア
セ ン ブ リ がシ ス テ ム ツ リ ーに表示 さ れ、 その ク ラ ス と メ ソ ッ ド を
表示す る よ う に展開す る こ と がで き ます。
45
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
出力ウ ィ ン ド ウの拡張
出力 ウ ィ ン ド ウ には、 今ま での PowerBuilder のバージ ョ ン では 1 つの
ペ イ ン に表示 さ れていた メ ッ セージが、 メ ッ セージの種類ご と に別々
の タ ブに表示 さ れ ます。
新 し い PowerBuilder セ ッ シ ョ ン を開始 し た直後は、 出力 ウ ィ ン ド ウ に
は 1 つの タ ブ [デフ ォ ル ト ] のみが表示 さ れ ます。 各種操作の実行に
応 じ て、 新 し い タ ブが追加 さ れ ます。 残 り の タ ブは出力 ウ ィ ン ド ウ で
作成 さ れた順番に PowerBuilder セ ッ シ ョ ンの間表示 さ れ続け ます。 新
し い構築を開始す る と き に、 タ ブか ら 出力を消去す る よ う にす る には、
シ ス テ ム オプシ ョ ン ダ イ ア ロ グ ボ ッ ク ス の [全般] ページの [自動的
に出力 ウ ィ ン ド ウ を ク リ アす る ] チ ェ ッ ク ボ ッ ク ス を オ ン に し ます。
タブ
内容
デフ ォ ル ト
フル構築ま たは イ ン ク リ メ ン タ ル構築、お よ びプ ロ
ジ ェ ク ト 配布の進行状況に関す る 一般情報
デバ ッ ガ 出力 (.NET デバ ッ グ の サ ポ ー ト 目的 で
ロ ー ド さ れ る アセ ンブ リ のパ ス を含む)
構築 ま た は配布処理が正常に行われな い問題 を 示
す メ ッ セージ
警告 メ ッ セージ と 情報 メ ッ セージ
検索操作か ら の出力結果
.NET タ ーゲ ッ ト の場合、 サポー ト さ れていない機
能の名前 と 位置
デバ ッ グ
エラー
警告
検索
未サポー ト 機能
メ ッ セージが特定のオブジ ェ ク ト や ス ク リ プ ト を参照す る と き 、 メ ッ
セージ を ダブル ク リ ッ ク し て、 オブジ ェ ク ト を開 く こ と がで き ます。
サイ ズ変更可能なダ イ ア ログボ ッ ク ス
PowerBuilder 11 開発環境のダ イ ア ロ グボ ッ ク ス は、 サ イ ズ変更可能で
す。 た と えば、 [フ ァ イ ル|新規作成] を選択 し て新規作成 ダ イ ア ロ
グ ボ ッ ク ス を 表 示 し 、 [プ ロ ジ ェ ク ト ] タ ブ を ク リ ッ ク し ま す。
PowerBuilder 11 では、 新規作成 ダ イ ア ロ グ ボ ッ ク ス のサ イ ズ を変更 し
て、 ス ク ロ ールせずにすべてのプ ロ ジ ェ ク ト を表示す る こ と がで き ま
す。 以前のバージ ョ ン では、 すべてのプ ロ ジ ェ ク ト を表示す る ために
は、 ス ク ロ ール ダ ウ ンす る こ と が必要で し た。
46
新機能
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
PowerBuilder Application Server Plug-in のサポー ト
PowerBuilder Application Server Plug-in は、 単体の製品で、 PowerBuilder
ユーザがサー ド パーテ ィ のアプ リ ケーシ ョ ン サーバに コ ン ポーネ ン ト
を配布 し て、 ク ラ イ ア ン ト アプ リ ケーシ ョ ン を開発で き る よ う に し ま
す。 製品の最初の リ リ ー ス でサポー ト す る サーバは、 WebSphere 6.1、
WebLogic 9.2、 お よ び JBoss 4.0.4 です。
EAServer プ ロ フ ァ イ ル ダ イ ア ロ グ ボ ッ ク ス は、 「ア プ リ ケ ー シ ョ ン
サーバ プ ロ フ ァ イ ル」 と い う 名前に変更 さ れ、現在はほかの J2EE サー
バのプ ロ フ ァ イ ルを指定す る ために使用で き ます。
ア プ リ ケーシ ョ ン サーバ コ ン ポーネ ン ト ジ ェ ネ レ ー タ の新 し い ア イ
コ ン が、 PowerBuilder Enterprise の 新規作成 ダ イ ア ロ グ ボ ッ ク ス の
[ タ ーゲ ッ ト ]、 [PB オブジ ェ ク ト ]、 お よ び [プ ロ ジ ェ ク ト ] ページに
追加 さ れ ま し た。アプ リ ケーシ ョ ンサーバ プ ロ キ シ ジ ェ ネ レー タ の新
し い ア イ コ ン が、 [プ ロ ジ ェ ク ト ] ページ に追加 さ れ ま し た。 新 し い
ウ ィ ザー ド お よ びそれ ら の使い方は、関連す る EAServer ウ ィ ザー ド と
よ く 似てい ます。
EAServer コ ン ポーネ ン ト に追加 さ れた複数の新 し い機能は、 ア プ リ
ケーシ ョ ン サーバ コ ン ポーネ ン ト に も 適用 さ れてい ま す。 た と えば、
アプ リ ケーシ ョ ン サーバ コ ン ポーネ ン ト を EJB 2.1 Web サービ ス と し
て配布す る こ と がで き 、プ ロ ジ ェ ク ト ペ イ ン タ でセキ ュ リ テ ィ ロ ール
お よ びカ ス タ ム の EJB プ ロ パテ ィ を指定す る こ と がで き ます。
ウ ィ ザー ド で使用可能な ア プ リ ケーシ ョ ンサーバ プ ロ フ ァ イル ダ イ ア
ロ グボ ッ ク ス
EAServer ウ ィ ザー ド 、 アプ リ ケーシ ョ ン サーバ コ ン ポーネ ン ト ウ ィ
ザー ド お よ びプ ロ キ シ ウ ィ ザー ド の [EAServer プ ロ フ ァ イ ルの選択]
ページや[アプ リ ケーシ ョ ン サーバ プ ロ フ ァ イ ルの選択] ページに [プ
ロ フ ァ イ ルの編集] ボ タ ン があ り ます。 こ のボ タ ン を ク リ ッ ク す る と 、
ア プ リ ケーシ ョ ン サーバ プ ロ フ ァ イ ル ダ イ ア ロ グ ボ ッ ク ス が表示 さ
れ ま す。 こ のダ イ ア ロ グ ボ ッ ク ス では、 ウ ィ ザー ド を 終了 し な いで、
新 し いプ ロ フ ァ イ ルを追加 し た り 、 既存のプ ロ フ ァ イ ルを編集 し た り
で き ます。
PowerBuilder 11
47
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
ア プ リ ケーシ ョ ン サーバ プ ロ フ ァ イ ルの編集 ダ イ ア ロ グ ボ ッ ク ス の
プ ロ フ ァ イ ル名は編集で き ません。 こ れは、 プ ロ フ ァ イ ルのほかのプ
ロ パテ ィ だけでな く 、 名前 も プ ロ ジ ェ ク ト オブジ ェ ク ト に保存 さ れ る
ためです。 プ ロ ジ ェ ク ト を配布す る と き に、 レ ジ ス ト リ にプ ロ フ ァ イ
ル名が見つか ら ない場合は、 プ ロ ジ ェ ク ト オブジ ェ ク ト に格納 さ れて
い る プ ロ フ ァ イ ル名が使用 さ れます。
ソ ース管理内のオブ ジ ェ ク ト に関する警告 メ ッ セージ を表示 し ない
オブジ ェ ク ト が ソ ース 管理にチ ェ ッ ク イ ン さ れ、 再びチ ェ ッ ク ア ウ ト
さ れ る ま での間に、 PowerBuilder ペ イ ン タ でオブジ ェ ク ト を開いて も 、
そのオブジ ェ ク ト に対 し て行われた変更は保存 さ れ ません。 デフ ォ ル
ト では、 ソ ー ス管理の も と でオブジ ェ ク ト を開 こ う と す る と き 、 オブ
ジ ェ ク ト がチ ェ ッ ク ア ウ ト さ れていない場合に PowerBuilder がそれを
知 ら せ る 警告 メ ッ セージ を表示 し ます。 ワ ー ク ス ペー ス のプ ロ パテ ィ
ダ イ ア ロ グ ボ ッ ク ス の [ ソ ー ス管理] タ ブの [読み取 り 専用フ ァ イ ル
の上書 き 時に問い合わせな い] チ ェ ッ ク ボ ッ ク ス を オ ン にす る こ と
で、 こ の種類の警告 メ ッ セージ を回避す る こ と がで き ます。
デ フ ォ ル ト 設定 を 変更 し な か っ た場合で も 、 表示 さ れ る 最初の警告
メ ッ セージ のチ ェ ッ ク ボ ッ ク ス を オ ン にす る こ と がで き ま す。 警告
メ ッ セー ジ ボ ッ ク ス の [次回か ら は こ の メ ッ セー ジ を 表示 し な い]
チ ェ ッ ク ボ ッ ク ス を オ ン に し て [はい] を選択す る と 、 [ ソ ース管理]
タ ブの該当す る チ ェ ッ ク ボ ッ ク ス が自動的にオ フ にな り ます。 こ れに
よ っ て、 ソ ース 管理にチ ェ ッ ク イ ン さ れたオブジ ェ ク ト を次回開 く と
き に、 警告 メ ッ セージが表示 さ れな く な り ます。 警告 メ ッ セージが表
示 さ れ な く て も 、 こ の時点で PowerBuilder ペ イ ン タ で こ れ ら の オ ブ
ジ ェ ク ト に対 し て行っ た変更は保存 さ れ ません。
オー ト ス ク リ プ ト オプ シ ョ ンの設定
ス ク リ プ ト ビ ュ ー を 持つペ イ ン タ で、 [デザ イ ン |オ プ シ ョ ン] メ
ニ ュ ーを選択 し て、 オー ト ス ク リ プ ト オプシ ョ ン を設定す る こ と がで
き ます。 [オプシ ョ ン] ページに [戻 り 値の型表示] チ ェ ッ ク ボ ッ ク ス
が追加 さ れま し た。
48
新機能
PowerBuilder ユーザ イ ン タ フ ェ ースの機能拡張
[編集|形式を指定 し て貼 り 付け] メ ニ ュ ー項目を使用 し て ス ク リ プ ト
に ス テー ト メ ン ト を貼 り 付け る と き 、 プ ロ ト タ イ プの値が条件やア ク
シ ョ ン を示すために構文に表示 さ れ ます。 デフ ォ ル ト では、 ス テー ト
メ ン ト は小文字で貼 り 付け ら れ ます。 大文字で ス テー ト メ ン ト を貼 り
付け る には、 PB.INI フ ァ イ ルの [PB] セ ク シ ョ ン に次の行 を追加 し ま
す。
PasteLowercase=0
こ の PB.INI の設定は、 「オー ト ス ク リ プ ト 」 お よ び 「形式を指定 し て
貼 り 付け」 の機能に適用 さ れ ます。
コ ピー と 貼 り 付けのための更新日を表示
既存の PBL か ら 、 ほかの PBL にオブジ ェ ク ト を コ ピーす る と き に同
じ 名前のオブジ ェ ク ト がすでに存在す る 場合に表示 さ れ る メ ッ セージ
には、 コ ピーを行 う か ど う かの判断の助け と な る オブジ ェ ク ト の変更
日 と 時間が含ま れ ます。
サイ ズ変更 さ れたオブ ジ ェ ク ト ブ ラ ウザ内の タ ーゲ ッ ト フ ィ ール ド
選択 さ れてい る タ ーゲ ッ ト が分か り やす く な る よ う に、 オブジ ェ ク ト
ブ ラ ウ ザの上にあ る タ ーゲ ッ ト フ ィ ール ド のサ イ ズが、 オブジ ェ ク ト
ブ ラ ウ ザの幅 と 同一にな る よ う にサ イ ズ変更 さ れ ま し た。
編集様式を オブ ジ ェ ク ト 詳細ビ ュ ーで作成
デー タ ベー ス ペ イ ン タ で編集様式 を 作成 し た り 、 変更 し た り す る と
き 、 ダ イ ア ロ グ ボ ッ ク ス ではな く 、 表示書式お よ び入力条件則 と 同 じ
よ う に、 オブジ ェ ク ト 編集ビ ュ ーで ス タ イ ルを指定 し ます。 イ ン ク エ
デ ィ ッ ト 編集様式のカ ス タ ム編集様式を作成す る こ と も で き ます。
PowerBuilder 11
49
新規および変更 さ れた PowerBuilder コ ン ト ロール
例外送出時にデバ ッ ガ を中断
デバ ッ グ中にアプ リ ケーシ ョ ン が例外を送出 し た場合、 プ ロ グ ラ ム が
その例外の処理を始め る 前に、 デバ ッ ガがその例外を認識 し ます。 デ
バ ッ ガでは、 そのプ ロ グ ラ ム を その ま ま続行 さ せ る こ と も 、 その例外
を処理す る こ と も で き ます。 こ れは、 通常、 例外を処理す る デバ ッ ガ
の最初の機会 と みな さ れ ます。 デバ ッ ガが例外を処理 し ない場合、 プ
ロ グ ラ ム がその例外を認識 し ます。 プ ロ グ ラ ム がその例外を処理 し な
い場合、 デバ ッ ガは、 その例外を処理す る 2 番目の機会を得ます。
例外設定 ダ イ ア ロ グ ボ ッ ク ス で、 デバ ッ ガが例外の最初の機会を処理
す る か ど う か を制御で き ます。ダ イ ア ロ グ ボ ッ ク ス を開 く には、デバ ッ
ガ を開いて [デバ ッ グ] メ ニ ュ ーか ら [例外] を選択 し ます。 デフ ォ
ル ト では、 すべての例外はその親か ら 継承 さ れ、 それ ら はすべて [継
続] に設定 さ れ ます。
こ れ ら の例外のいずれかが送出 さ れ る と 、 ダ イ ア ロ グ ボ ッ ク ス が表示
さ れ、 デバ ッ ガ を開 く か、 ま たはプ ロ グ ラ ム に例外を渡すか を選択す
る こ と がで き ます。
デバ ッ グのための EAServer コ ンポーネ ン ト の選択
EAServer タ ーゲ ッ ト をデバ ッ グす る と き 、 デバ ッ グ可能な コ ン ポーネ
ン ト セ ッ ト を プ ロ ジ ェ ク ト か ら 指定 し ます。 こ の コ ン ポーネ ン ト セ ッ
ト には、 プ ロ ジ ェ ク ト ペ イ ン タ の [ コ ン ポーネ ン ト ] ページで選択 し
たすべての コ ン ポーネ ン ト が含 ま れ ま す。 ただ し 、 [ リ モー ト デバ ッ
グのサポー ト ] チ ェ ッ ク ボ ッ ク ス がオ ンにな っ てい る 必要があ り ます。
異な る コ ン ポーネ ン ト セ ッ ト を選択 し た り 、 複数のパ ッ ケージか ら の
コ ン ポーネ ン ト をデバ ッ グす る 場合は、 デバ ッ ガの メ ニ ュ ー バーか ら
[デバ ッ グ| コ ン ポーネ ン ト の選択] を 選択す る か、 ペ イ ン タ バーの
[ コ ン ポーネ ン ト の選択] ボ タ ン を ク リ ッ ク し ます。
新規および変更 さ れた PowerBuilder コ ン ト ロール
PowerBuilder 11 では、 次の PowerBuilder コ ン ト ロ ールへの変更が行わ
れま し た。
50
•
リ ッ チテ キ ス ト の機能拡張
•
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールのページ表示プ ロ パ
ティ
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
•
日付ピ ッ カー コ ン ト ロ ール
•
日付ピ ッ カー と 月表示カ レ ン ダ コ ン ト ロ ールでの RightToLeft プ
ロ パテ ィ のサポー ト
•
エデ ィ ッ ト マ ス ク コ ン ト ロ ールの DropDownCalendar プ ロ パテ ィ
•
月表示カ レ ン ダ コ ン ト ロ ールの DateSelected イ ベン ト
リ ッ チ テキス ト の機能拡張
RTF は、 ASCII ド キ ュ メ ン ト の書式設定命令 と ド キ ュ メ ン ト の内容を
指定す る 標準の規格です。 RTF を サポー ト す る エデ ィ タ は、 ド キ ュ メ
ン ト の命令を解釈 し 、 テ キ ス ト を書式化 し て表示 し ます。
PowerBuilder 11 は、 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ール と リ ッ チ
テ キ ス ト デー タ ウ ィ ン ド ウ 提示様式 を サ ポー ト す る た めに、 新 し い
リ ッ チ テ キ ス ト エデ ィ タ を使用 し ます。 新 し いエデ ィ タ は、 現代風の
外観を持ち、 書式 ス タ イ ルに名前を付けてそれを使用す る と い っ た新
し い 機 能 を 含 ん で い ま す。 新 し い リ ッ チ テ キ ス ト エ デ ィ タ は、
PowerBuilder の以前のバージ ョ ンの リ ッ チテ キ ス ト オブジ ェ ク ト のほ
と ん ど のプ ロ パ テ ィ と 関数 を 継続 し て サ ポー ト し ま す。 PowerBuilder
の以前のバージ ョ ン の リ ッ チ テ キ ス ト オブ ジ ェ ク ト を イ ン ポー ト す
る 際には、サポー ト さ れな く な っ たプ ロ パテ ィ と 関数は無視 さ れ ます。
新 し い リ ッ チテ キ ス ト エデ ィ タ は、 RTF 規格のバージ ョ ン 1.6 のサブ
セ ッ ト をサポー ト し ます。
新 し い リ ッ チテ キ ス ト エデ ィ タ の機能については、 以下のセ ク シ ョ ン
で説明 し てい ます。
PowerBuilder 11
•
リ ッ チテ キ ス ト エデ ィ タ のユーザ イ ン タ フ ェース の変更
•
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールの変更
•
リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ 提示様式の変更
•
リ ッ チテ キ ス ト コ ン ト ロ ールでの スペル チ ェ ッ ク のサポー ト
•
リ ッ チテ キ ス ト コ ン ト ロ ールの フ ッ タ へのページ番号の挿入
51
新規および変更 さ れた PowerBuilder コ ン ト ロール
リ ッ チ テキス ト エデ ィ タ のユーザ イ ン タ フ ェ ースの変更
ルー ラ、 ツールバー、
およびス テー タ ス
バー
従来の リ ッ チテ キ ス ト エデ ィ タ と 同 じ よ う に、 新 し いエデ ィ タ にはデ
ザ イ ン時あ る いは実行時に非表示に し た り 、 表示 し た り で き る ツール
バー と ルー ラ があ り ます。 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールあ
る いは リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ の [ポ ッ プア ッ プ メ ニ ュ ー]
プ ロ パテ ィ を有効にす る と 、 PowerBuilder アプ リ ケーシ ョ ン のエ ン ド
ユーザはツールバーあ る いはルー ラ を表示 し た り 非表示に し た り す る
こ と を選ぶ こ と も で き ます。
新 し いエデ ィ タ は、 デザ イ ン時あ る いは実行時に有効に し た り 、 リ ッ
チテ キ ス ト アプ リ ケーシ ョ ンのユーザが表示、 非表示を選ぶ こ と がで
き る ス テー タ ス バーを含んでい ます。 リ ッ チテ キ ス ト エデ ィ タ は、 別
個の タ ブ バーを含ま な く な り ま し た。 リ ッ チテ キ ス ト コ ン ト ロ ールの
エ ン ド ユーザは、 Tabs ダ イ ア ロ グ ボ ッ ク ス ま たは直接ルー ラ で、 コ ン
ト ロ ールに タ ブ を設定す る こ と がで き ます。
リ ッ チ テキス ト エ
デ ィ タ のツールバー項
目
リ ッ チテ キ ス ト エデ ィ タ の ツールバーの外観は、 現代風の フ ラ ッ ト な
ス タ イ ルです。 ツールバーには、 書式 ス タ イ ルお よ び縮拡率の ド ロ ッ
プダ ウ ン リ ス ト 、お よ び リ ッ チテ キ ス ト コ ン ト ロ ールの段落に記号あ
る いは連番を付加す る ツールバー ボ タ ン が含ま れてい ます。
ユーザは、 ツールバーの空白部分を ダブル ク リ ッ ク す る こ と で開かれ
る テ キ ス ト 書式のダ イ ア ロ グ ボ ッ ク ス で ド キ ュ メ ン ト のプ ロ パテ ィ を
設定す る こ と がで き ます。
開 く ダ イ ア ログボ ッ ク ス
Styles
Font
Paragraph
Bullets and Numbering
Tabs
52
ツールバーでダブルク リ ッ ク する領域
[Styles] ド ロ ッ プ ダ ウ ン リ ス ト の 前 の ス
ペース あ る いはそれに続 く スペース
フ ォ ン ト 関連の フ ィ ール ド ( [font face] ド
ロ ッ プダ ウ ン リ ス ト 、 [font size] ド ロ ッ プ
ダ ウ ン リ ス ト 、 あ る いは文字属性 (太字、
斜体、 下線)) の前の スペース、 あ る いはそ
れ ら に続 く スペース
[alignment] ボ タ ンの前ま たは後ろの スペー
ス
[bullet] お よ び [numbering] ボ タ ン の前後
の スペース
[tab] お よ び [paragraph] ボ タ ンの前後の ス
ペース
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
ページ余白の表示
新 し いエデ ィ タ は、 テ キ ス ト 本文 と 一緒にヘ ッ ダお よ びフ ッ タ を表示
さ せ る こ と がで き ま す。 ヘ ッ ダお よ び フ ッ タ を 含め る こ と を 選ぶ と 、
エデ ィ タ は上下余白の境界線があ り 、 隣接す る ページ間に空白があ る
状態でテ キ ス ト の各ページ を表示 し ま す。 こ れに よ り 、 リ ッ チテ キ ス
ト コ ン ト ロ ールあ る いはデー タ ウ ィ ン ド ウ オブジ ェ ク ト を 3 次元の
外観に し ます。
デザ イ ン時にのみヘ ッ ダお よ びフ ッ タ を許可す る か ど う か を決定す る
こ と が で き ま す。 ヘ ッ ダ お よ び フ ッ タ を 許可 し な い と 、 テ キ ス ト の
ページは境界線や余白のない連続 し た シー ト と し て表示 さ れ ま すが、
印刷プ レ ビ ュ ー モー ド では別々のページに表示 さ れ ます。
ダ イ ア ログボ ッ ク スの
変更
PowerBuilder 11
Styles ダ イ ア ロ グボ ッ ク ス と Bullets and Numbering ダ イ ア ロ グボ ッ ク ス
は、 PowerBuilder 11 で新 し く 追加 さ れま し た。 ユーザは Styles ダ イ ア
ロ グ ボ ッ ク ス で ス タ イ ルを作成、 修正、 あ る いは削除す る こ と がで き
ます。 Font ダ イ ア ロ グボ ッ ク ス は、 線の位置の項目 (通常、 上付 き 、 下
付 き ) を含む よ う にな り ま し た。 Paragraph ダ イ ア ロ グボ ッ ク ス に、 イ
ンデン ト お よ び間隔設定機能が追加 さ れ ま し た。 PowerBuilder の以前
のバージ ョ ン では、 Tabs ダ イ ア ロ グ ボ ッ ク ス は Paragraph ダ イ ア ロ グ
ボ ッ ク ス に含ま れてい ま し たが、 現在は別にな っ てい ます。
53
新規および変更 さ れた PowerBuilder コ ン ト ロール
リ ッ チ テキス ト エデ ィ ッ ト コ ン ト ロールの変更
変更 さ れたプ ロパテ ィ
以下の表は、PowerBuilder 11 の リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ー
ルの新 し いプ ロ パテ ィ と 変更 さ れたプ ロ パテ ィ を記載 し てい ます。
プ ロパテ ィ
StatusBar
54
デー タ 型
Boolean
ControlCharsVisible
Boolean
HeaderFooter
Boolean
説明
ス テー タ ス バー を リ ッ チ テ キ ス
ト コ ン ト ロ ールの編集エ リ ア の
下に表示す る か ど う か を 指定す
る 新 し いプ ロ パテ ィ 。 値は以下の
とおり
• True ス テ ー タ ス バー を 表示
する
• False ス テー タ ス バーを非表
示にす る
デザ イ ン時にペ イ ン タ で、 あ る い
は実行時に PowerScript で こ のプ
ロ パ テ ィ の値 を 設定す る こ と が
で き る。 リ ッ チテ キ ス ト コ ン ト
ロ ールの ポ ッ プ ア ッ プ メ ニ ュ ー
が有効な場合は、エン ド ユーザは
ポ ッ プ ア ッ プ メ ニ ュ ーか ら ス
テー タ ス表示のオン、 オ フ を設定
する こ と がで き る
サポー ト さ れな く な っ た
ReturnsVisible、SpacesVisible、お よ
び TabsVisibleプ ロ パテ ィ のかわ り
と な る 新 し いプ ロ パテ ィ 。 制御文
字を リ ッ チテキ ス ト コ ン ト ロ ー
ル に表示す る か ど う か を 指定す
る 。 値は以下の と お り
• True 制御文字を表示す る
• False 制御文字 を 非表示にす
る
こ の プ ロ パ テ ィ は PowerBuilder
の以前の バー ジ ョ ン と 実質同 じ
だ が、 こ れ を 「true」 に設定す る
と 、 ヘ ッ ダお よ びフ ッ タ を リ ッ チ
テ キ ス ト コ ン ト ロ ールの本文 と
同 じ ビ ュ ーに表示で き る 。 (以前
の リ ッ チテ キ ス ト エデ ィ タ では、
テ キ ス ト 本文 と 同 じ ビ ュ ーに
ヘ ッ ダ と フ ッ タ を 表示で き な
か っ た。 ) デザ イ ン時にのみ こ の
プ ロ パ テ ィ を 設定す る 必要が あ
る
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
プ ロパテ ィ
InputFieldBackColor
デー タ 型
Long
Pointer
カ タ ロ グ
デー タ 型
説明
こ の プ ロ パ テ ィ は PowerBuilder
の以前の バー ジ ョ ン と 実質同 じ
だ が、 新 し い リ ッ チ テ キ ス ト エ
デ ィ タ は、 ユ ー ザ が 個々 の 入力
フ ィ ール ド でデ フ ォ ル ト の背景
色 を 上書 き で き る よ う にす る。
Font プ ロ パ テ ィ ダ イ ア ロ グ ボ ッ
ク ス で ユーザ が入力 フ ィ ール ド
で行っ た変更は、 リ ッ チテ キ ス ト
ド キ ュ メ ン ト のほかの入力
フ ィ ール ド のデ フ ォ ル ト の背景
色には影響 し ない
新 し い リ ッ チ テ キ ス ト エデ ィ タ
は、古い リ ッ チテ キ ス ト エデ ィ タ
で使用で き る 組み込み ポ イ ン タ
のほ と ん ど をサポー ト する が、 す
べて を サポー ト し て い る わけ で
はない。 AppStarting!、 Help!、 お よ
び No! ポ イ ン タ は、 サポー ト し て
いない。 ユーザは次のポ イ ン タ を
選択す る こ と が で き る 。 Arrow!、
Cross!、 HourGlass!、 Hyperlink!、
IBeam!、 Size!、 SizeNESW!、
SizeNS!、 SizeWE!、 SizeNWSE!、
SizeWE!、 お よ び UpArrow!
値が指定 さ れない場合 (あ る いは
サ ポ ー ト し て い な い値が指定 さ
れた場合)、 リ ッ チテ キ ス ト コ ン
ト ロ ール が編集可能 な 場合のデ
フ ォ ル ト の ポ イ ン タ は 「IBeam!」
で、 コ ン ト ロ ールが呼び出 し 専用
の と き は 「Arrow!」 にな る
新 し い リ ッ チ テ キ ス ト エデ ィ タ で
は、ReturnsVisible、SpacesVisible、TabBar、TabsVisible、お よ び UndoDepth
プ ロ パテ ィ はサポー ト さ れ ま せん。 こ れ ら のプ ロ パテ ィ を リ ッ チテ キ
ス ト エデ ィ ッ ト コ ン ト ロ ールに設定す る と 、新 し いエデ ィ タ では無視
さ れ ます。 新 し い リ ッ チテ キ ス ト エデ ィ タ での最大取 り 消 し 回数は 50
です。 こ の値は、 デザ イ ン時で も 実行時で も 変更す る こ と がで き ませ
ん。
サポー ト さ れな く な っ たプ ロパテ ィ
PowerBuilder 11
55
新規および変更 さ れた PowerBuilder コ ン ト ロール
変更 さ れた関数
次の表は、 PowerBuilder 11 で変更 さ れた関数の一覧です。
関数
InsertDocument
説明
こ の関数は、 以下の追加の フ ァ イ ルの種類を サポー
ト する
• FileTypeHTML! - 開かれ る フ ァ イ ルは HTML 形式
(HTM ま たは HTML)
• FileTypeDoc! - 開かれ る フ ァ イ ルは Microsoft Word
形式 (DOC)
InsertPicture
PasteRTF
SaveDocument
ま た、 既存のヘ ッ ダ と フ ッ タ を、 こ の関数 を使用 し
て挿入す る ド キ ュ メ ン ト のヘ ッ ダ と フ ッ タ に置 き 換
え る こ と がで き る 。 既存のヘ ッ ダ と フ ッ タ に追加す
る こ と はで き な い。 ヘ ッ ダ と フ ッ タ を 含む既存の ド
キ ュ メ ン ト を置 き 換え る には、 clearflag 引数を 「true」
に設定す る 必要があ る
こ の関数は、 現在以下の フ ァ イ ルの種類を サポー ト
す る 。 .bmp、 .wmf、 .jpeg、 .png、 .gif、 お よ び .tif
新 し い リ ッ チテ キ ス ト エデ ィ タ は少 し おか し な動 き
をす る ため、 PasteRTF 関数は、 1 つ以上の段落 タ グ
があ る と き に、 コ ン ト ロ ールに貼 り 付け る RTF 文字
列の後ろにあ る 最後の段落 タ グ を常に無視する
こ の関数は、 以下の追加の フ ァ イ ルの種類を サポー
ト する
• FileTypeDoc! - Microsoft Word 形式に フ ァ イ ルを保
存
• FileTypeHTML! - HTML 形式に フ ァ イ ルを保存
• FileTypePDF! - PDF 形式に フ ァ イ ルを保存
こ れ ら の関数は、 リ ッ チ テ キ ス ト コ ン ト ロ ールの
HeaderFooter プ ロ パ テ ィ が選択 さ れ る と き に の み、
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールの編集モー
ド で動作す る 。 こ れ ら は、 HeaderFooter プ ロ パテ ィ の
設定 に 関 わ ら ず印刷 プ レ ビ ュ ー モ ー ド で 動作 し 、
デー タ ウ ィ ン ド ウ にヘ ッ ダ あ る いは フ ッ タ 区域が あ
る か否かに関係な く リ ッ チテ キ ス ト デー タ ウ ィ ン ド
ウ コ ン ト ロ ールの編集モー ド で動作す る
SelectedLength、 こ れ ら の関数は、 キ ャ リ ッ ジ リ タ ーンお よ び ラ イ ン
SelectText、 お よ フ ィ ー ド を別の文字ではな く 1 つの文字 と し て数え
び SelectTextAll
る 。 LineLength、 SelectTextLine、 SelectTextWord、 お よ
び TextLine な ど のほかの関数は、 文字数にキ ャ リ ッ
ジ リ タ ーンや ラ イ ン フ ィ ー ド を含めない
SelectedLine
編集可能な コ ン ト ロ ールで挿入ポ イ ン ト を含む行の
番号を取得す る 。 現行行がキ ャ リ ッ ジ リ タ ーン を含
む場合は、 挿入ポ イ ン ト は次の行に移動する
ScrollNextPage
および
ScrollPriorPage
56
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
関数
SetTextStyle
説明
新 し い多重定義構文は、 上付 き お よ び下付 き の書式
のための boolean 引数を削除す る 。 ユーザが、 ツール
バーの空白領域を ダブル ク リ ッ ク し て ア ク セ ス す る
プ ロ パテ ィ ダ イ ア ロ グ ボ ッ ク ス で上付 き ス タ イ ルあ
る いは下付 き ス タ イ ル を 設定す る こ と がで き る 。 多
重定義構文は以下の と お り
integer rtename.SetTextStyle ( boolean
bold, boolean underline, boolean
italic, boolean strikeout )
ShowHeadFoot
新 し い多重定義構文は、 編集す る ヘ ッ ダ と フ ッ タ パ
ネルの挿入ポ イ ン ト (キ ャ レ ッ ト ) がヘ ッ ダ部分に
あ る か、 フ ッ タ 部分にあ る か を指定する boolean 引数
を追加する 。 値は以下の と お り
• True キ ャ レ ッ ト はヘ ッ ダ部分
• False キ ャ レ ッ ト はフ ッ タ 部分
最初の引数が false の場合には 2 番目の引数は無視 さ
れ る 。 2 番目の引数のデフ ォ ル ト は 「true」 (値が指定
さ れない場合) 。 こ の関数の多重定義構文は以下の と
おり
integer rtename.ShowHeadFoot ( boolean
editheadfoot, boolean headerfooter )
変更 さ れた イ ベン ト
ユーザが 〔Enter〕 を押 し た と き に、 InputFieldSelected お よ び
PictureSelected イ ベ ン ト が発生 し な く な り ま し た。 PrintHeader お よ び
PrintFooter イ ベン ト はサポー ト さ れな く な り ま し た。 こ れ ら は、 いか
な る 状況において も 発生 し ません。
デ フ ォル ト フ ォ ン ト
の設定
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールのプ ロ パテ ィ ビ ュ ーには、コ
ン ト ロ ールのデフ ォ ル ト の フ ォ ン ト 特性を設定で き る [フ ォ ン ト ] タ
ブ ペー ジ が あ り ま す。 実行時に コ ン ト ロ ールが最初に表示 さ れ て、
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ール を持つツールバーを含む と
き 、 ツールバーはデザ イ ン時に [フ ォ ン ト ] タ ブ ページで選択 し たデ
フ ォ ル ト の フ ォ ン ト 特性を表示 し ます。 アプ リ ケーシ ョ ン ユーザは実
行時に フ ォ ン ト を変更 し た り 、PowerScript を使用 し て フ ォ ン ト ス タ イ
ルを変更す る こ と がで き ますが、 デザ イ ン時にのみデフ ォ ル ト の フ ォ
ン ト を設定す る こ と がで き ます。
PowerBuilder 11
57
新規および変更 さ れた PowerBuilder コ ン ト ロール
移行の問題
PowerBuilder の古いバージ ョ ン で作成 し た ア プ リ ケーシ ョ ン を移行す
る と き 、移行 さ れ る アプ リ ケーシ ョ ン で リ ッ チテ キ ス ト エデ ィ ッ ト コ
ン ト ロ ールお よ び リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の
InputFieldsVisible プ ロ パテ ィ は自動的に 「false」 に設定 さ れ ます。 入力
フ ィ ール ド のデー タ を表示す る には、 こ のプ ロ パテ ィ を 「true」 に設定
す る 必要があ り ます。 リ ッ チテ キ ス ト コ ン ト ロ ールの入力フ ィ ール ド
の テ キ ス ト ラ ベ ル を 表示す る に は、 こ の プ ロ パ テ ィ を 設 定 し て、
InputFieldNamesVisible プ ロ パテ ィ を 「true」に設定す る 必要があ り ます。
リ ッ チ テキス ト デー タ ウ ィ ン ド ウ提示様式の変更
リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ 提示様式ス タ イ ルは、 新 し い リ ッ チ
テ キ ス ト エデ ィ タ を使用 し ま す。 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト
ロ ールへのプ ロ パテ ィ と メ ソ ッ ド の変更は、 リ ッ チ テ キ ス ト デー タ
ウ ィ ン ド ウ に も 適用 さ れ ます。
PowerBuilder 11 では、 リ ッ チテ キ ス ト デー タ ウ ィ ン ド ウ のデー タ ウ ィ
ン ド ウ ペ イ ン タ のプ レ ビ ュ ー ビ ュ ーは、 「WYSIWYG (what you see is
what you get) 」 で、 読み取 り 専用です。 デー タ ウ ィ ン ド ウ のヘ ッ ダ と
フ ッ タ の詳細ビ ュ ーの内容を設定す る と き 、 プ レ ビ ュ ー ビ ュ ーはデー
タ ウ ィ ン ド ウ 行 の 詳 細 と 一 緒 に ヘ ッ ダ と フ ッ タ を 表 示 し ま す。
PowerBuilder の以前のバージ ョ ン では、 ド キ ュ メ ン ト 本文 と ページ余
白 を 同時にプ レ ビ ュ ーす る た めに印刷プ レ ビ ュ ー ビ ュ ー を 開 く 必要
があ り ま し た。
デー タ ウ ィ ン ド ウ ペ イ ン タ のプ レ ビ ュ ー ビ ュ ーに フ ォ ーカ ス が あ る
状態で、 プ リ ン タ に ド キ ュ メ ン ト を送 る 前にプ レ ビ ュ ーす る ために、
[フ ァ イ ル|印刷プ レ ビ ュ ー] メ ニ ュ ー項目 を 選択す る こ と がで き ま
す。 プ レ ビ ュ ーは WYSIWYG のため、印刷プ レ ビ ュ ー ビ ュ ーの余白を
制御す る パネルが削除 さ れ ま し た。 PowerBuilder の以前のバージ ョ ン
では、 ページ余白のパネルはデー タ ウ ィ ン ド ウ ド キ ュ メ ン ト のページ
を ス ク ロ ールす る ためのボ タ ン も 含んでい ま し た。 PowerBuilder 11 で
は、 印刷プ レ ビ ュ ー ビ ュ ーでページ を変更す る ために 〔Page Up〕 お
よ び 〔Page Down〕 を使用 し て行い ます。
ヘ ッ ダお よ び フ ッ タ を 持つデー タ ウ ィ ン ド ウ のプ レ ビ ュ ー ビ ュ ーに
フ ォ ーカ ス を置 く と き に、 [デザ イ ン|ヘ ッ ダ / フ ッ タ ] メ ニ ュ ー項目
を使用す る こ と も で き ま す。 こ の メ ニ ュ ー項目を選択す る と 、 有効に
す る 区域の選択 ダ イ ア ロ グ ボ ッ ク ス が表示 さ れます。 こ のダ イ ア ロ グ
ボ ッ ク ス の ラ ジオ ボ タ ン で、 有効にす る 区域を選択 し ます。 [OK] を
ク リ ッ ク す る と 、 フ ォーカ ス は選択 し た ラ ジオ ボ タ ン に対応 し てプ レ
ビ ュ ー ビ ュ ーのその区域に移動 し ます。
58
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
新 し い リ ッ チテ キ ス ト エデ ィ タ の入力フ ィ ール ド は、 常に複数行が有
効で、 サ イ ズ 固定では あ り ま せん。 そ の た め、 リ ッ チ テ キ ス ト 入力
フ ィ ール ド の MultiLine お よ び FixedSize プ ロ パテ ィ を サポー ト し ませ
ん。 それ ら は、 デー タ ウ ィ ン ド ウ ペ イ ン タ か ら 選択で き な く な り ま し
た。
実行時、 リ ッ チ テ キ ス ト デー タ ウ ィ ン ド ウ は、 ヘ ッ ダ と フ ッ タ を ド
キ ュ メ ン ト 本文 と 同 じ ウ ィ ン ド ウ に表示す る WYSIWYG 形式で表示
さ れ ま す。 ツールバー と それに関連す る ダ イ ア ロ グ ボ ッ ク ス、 お よ び
ルー ラ と ス テー タ ス バー も 実行時に使用で き ます。 そのほかの実行機
能に変更はあ り ません。
リ ッ チ テキス ト コ ン ト ロールでのスペル チ ェ ッ ク のサポー ト
スペル チ ェ ッ クのサ
ポー ト のための新 し い
プ ロパテ ィ
SelectedStartPos プ ロ パテ ィ お よ び SelectedTextLength プ ロ パテ ィ は、サ
ポー ト す る ActiveX コ ン ト ロ ールを使用 し て、 PowerBuilder リ ッ チテ
キ ス ト コ ン ト ロ ール内のテ キ ス ト を スペル チ ェ ッ ク し ます。サポー ト
す る スペル チ ェ ッ ク コ ン ト ロ ールは、 ComponentOne の VSSpell お よ
び Wintertree Software の WSpell です。
SelectedStartPos プ ロ パ テ ィ お よ び SelectedTextLength プ ロ パ テ ィ は、
long デー タ 型の値を取 り ます。 実行時に、 ス ク リ プ ト でプ ロ パテ ィ 値
を設定す る 必要があ り ます。
サ ポ ー ト す る ActiveX ス ペ ル チ ェ ッ ク コ ン ト ロ ー ル に 関 す る
ReplaceWord イ ベン ト 内の次の コ ー ド は、 スペル チ ェ ッ ク を行い、 ス
ペルが違 う 単語の相対位置 を テ キ ス ト 文字列の開始位置に設定 し ま
す。 開始位置を設定 し た後に、 SelectedTextLength 設定は スペルが違 う
単語全体をハ イ ラ イ ト 表示 し 、 ReplaceText を呼び出 し は スペルが違 う
単語を ActiveX スペルチ ェ ッ ク コ ン ト ロ ールのダ イ ア ロ グ ボ ッ ク ス で
ユーザが選択す る 単語に置 き 換え ます。
string str
str = ole_1.object.MisspelledWord
rte_1.SelectedStartPos = ole_1.object.WordOffset
rte_1.SelectedTextLength = Len(str)
rte_1.ReplaceText(ole_1.object.ReplacementWord)
こ れ ら の新 し いプ ロ パテ ィ の詳細につい て は、 オ ン ラ イ ン ヘルプの
SelectedStartPos お よ び SelectedTextLength を参照 し て く だ さ い。
PowerBuilder 11
59
新規および変更 さ れた PowerBuilder コ ン ト ロール
ActiveX スペル チ ェ ッ
ク コ ン ト ロールの使
用
リ ッ チ テ キ ス ト エデ ィ ッ ト コ ン ト ロ ールの SelectedStartPos プ ロ パ
テ ィ お よ び SelectedTextLength プ ロ パテ ィ を 使用 し て、 サポー ト す る
ActiveX スペル チ ェ ッ ク コ ン ト ロ ールで解析 し てい る テ キ ス ト 文字列
内でつづ り が違 う 単語の現在位置をハ イ ラ イ ト 表示 し ます。 次の手順
では、 ActiveX コ ン ト ロ ールを使用 し て、 リ ッ チテ キ ス ト エデ ィ ッ ト
コ ン ト ロ ールの現領域のテ キ ス ト 全体を スペル チ ェ ッ ク し ます。
❖
リ ッ チ テキス ト エデ ィ ッ ト コ ン ト ロール内の選択テキス ト を スペル チ ェ ッ
ク するには
1
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールを持つ ウ ィ ン ド ウ で、
ウ ィ ン ド ウ メ ニ ュ ーか ら [挿入| コ ン ト ロ ール| OLE] を選択 し
ます。
2
オブジ ェ ク ト の挿入 ダ イ ア ロ グボ ッ ク ス の [ コ ン ト ロ ールの挿入]
タ ブ を ク リ ッ ク し て、 イ ン ス ト ール さ れ て い る ActiveX ス ペル
チ ェ ッ ク コ ン ト ロ ールを選択 し て、 [OK] を ク リ ッ ク し ます。
3
ウ ィ ン ド ウ ペ イ ン タ の ウ ィ ン ド ウ 内を ク リ ッ ク し て、 ActiveX コ
ン ト ロ ールを挿入 し ます。
デフ ォ ル ト では、 挿入 さ れた コ ン ト ロ ールの名前は ole_n で、 ウ ィ
ン ド ウ にほかの OLE コ ン ト ロ ールがない場合は、 n は 1 にな り ま
す。
4
現行の ウ ィ ン ド ウ に関連す る メ ニ ュ ーに メ ニ ュ ー項目 を 追加 し 、
そのテ キ ス ト ラ ベルを 「 スペル チ ェ ッ ク 」 に変更 し ます。
5
次の コ ー ド を メ ニ ュ ー項目の Clicked イ ベン ト に追加 し ます。
windowName は、リ ッ チテ キ ス ト エデ ィ ッ ト と ActiveX コ ン ト ロ ー
ルを含む ウ ィ ン ド ウ の名前にな り ます。
string ls_selected
// 現領域の コ ン テキス ト を取得 し
// 選択モー ド のま まにする
windowName.rte_1.selecttext(0,0,0,0)
windowName.rte_1.SelectTextAll()
ls_selected = windowName.rte_1.SelectedText()
windowName.rte_1.SelectedTextLength = 0
// 文字列の内容を ActiveX コ ン ト ロールに割 り 当て る
windowName.ole_1.object.text = ls_selected
windowName.ole_1.object.start()
6
ウ ィ ン ド ウ ペ イ ン タ で ActiveX コ ン ト ロ ールを選択 し 、 コ ン ト
ロ ールの イ ベン ト リ ス ト か ら ReplaceWord を選択 し ます。
7
次の コ ー ド を ReplaceWord イ ベン ト ス ク リ プ ト に追加 し ます。
string str
60
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
str = this.object.MisspelledWord
rte_1.SelectedStartPos = this.object.WordOffset
rte_1.SelectedTextLength = Len(str)
rte_1.ReplaceText(this.object.ReplacementWord)
messagebox("misspelled word", "replaced")
次に ア プ リ ケーシ ョ ン を 実行す る と き に、 「ス ペル チ ェ ッ ク 」 メ
ニ ュ ー項目 を ク リ ッ ク し て、 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト
ロ ールの現領域の内容全体 を ス ペル チ ェ ッ ク す る こ と がで き ま
す。
リ ッ チ テキス ト コ ン ト ロールのフ ッ タ へのページ番号の挿入
次の ス ク リ プ ト は、 リ ッ チテ キ ス ト コ ン ト ロ ール内の文書の フ ッ タ に
現在のページ番号を挿入 し 、 文書本文に フ ォ ーカ ス を戻 し ます。
rte_1.ShowHeadFoot(true,false)
rte_1.SetAlignment ( Center! )
rte_1.InputFieldInsert("PAGENO")
rte_1.ShowHeadFoot(false,false)
PAGENO 予約語は、 ヘ ッ ダ と フ ッ タ にページ番号を追加で き る よ う に
し ます。 PowerBuilder の以前のバージ ョ ン では、 PrintHeader イ ベン ト
あ る いは PrintFooter イ ベン ト で SelectedPage を呼び出す こ と がで き ま
し たが、 こ れ ら の イ ベン ト はサポー ト し な く な り ま し た。
リ ッ チ テキス ト エデ ィ ッ ト コ ン ト ロールのページ表示プ ロパテ ィ
リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールのページ表示プ ロ パテ ィ は、
コ ン ト ロ ール内の ド キ ュ メ ン ト のサ イ ズ と 向 き を指定 し ます。 こ れ ら
の表示プ ロ パテ ィ は、 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト ロ ールの内容
を印刷す る ために、 実行時に設定で き る ページ プ ロ パテ ィ と 異な り ま
す。 こ れは、 コ ン ト ロ ール自体の幅 と 高 さ のプ ロ パテ ィ と も 異な り ま
す。
次の表は、 新 し い表示プ ロ パテ ィ の説明です。 こ れ ら のプ ロ パテ ィ は、
標準の PowerBuilder タ ーゲ ッ ト お よ び Windows フ ォ ーム タ ーゲ ッ ト
に実装 さ れてい ます。 Web フ ォーム タ ーゲ ッ ト には実装 さ れてい ませ
ん。
プ ロパテ ィ
PaperHeight
PaperWidth
PowerBuilder 11
説明
現行の単位でページの高 さ の値を指定
現行の単位でページの幅の値を指定
61
新規および変更 さ れた PowerBuilder コ ン ト ロール
プ ロパテ ィ
PaperOrientation
説明
PaperHeight と PaperWidth の値を入れ換え る 。値は以下の
通り
• PaperPortrait! 現行の PaperWidth が現行の
PaperHeight よ り 大 き い場合、 PaperHeight が大 き く な
る よ う に こ れ ら の値を入れ換え る 。 現行の PaperWidth
が現行の PaperHeight よ り 小 さ い場合、 こ ら れの値は
変わ ら ない。 こ の設定の場合に、 値 0 が返 さ れ る
• PaperLandscape! 現行の PaperHeight が現行の
PaperWidth よ り 大 き い場合、 PaperWidth が大き く な る
よ う に こ れ ら の値 を 入れ換え る 。 現行の PaperHeight
が現行の PaperWidth よ り 小 さ い場合、こ れ ら の値は変
わ ら な い。 こ の 設定 の 場 合 に、 値 1 が 返 さ れ る 。
PaperOrientation の値は、 PaperHeight と PaperWidth が
同 じ 大 き さ の と き に も 、 こ の値が設定 さ れ る
現行単位の変更
デフ ォ ル ト では、 現行の単位は 1/1000 イ ンチに設定 さ れ ます。 そのた
め、 11 イ ン チの用紙の高 さ を 表示す る た めには、 PaperHeight の値 を
11000 に設定す る 必要があ り ます。 リ ッ チテ キ ス ト エデ ィ ッ ト コ ン ト
ロ ールの PopMenu プ ロ パテ ィ が有効な場合、アプ リ ケーシ ョ ン ユーザ
が リ ッ チ テ キ ス ト オブジ ェ ク ト ダ イ ア ロ グ ボ ッ ク ス を表示 し て、 現
行の単位を 1/1000 セ ンチ メ ー ト ルに変更す る よ う にで き ます。 ユーザ
が単位を セ ンチ メ ー ト ルに変更す る と 、PaperHeight と PaperWidth の値
は 2.54 倍にな り ます。
デフ ォ ル ト では、 PaperHeight と PaperWidth に設定 し た値は、 画面表示
と 印刷で使用 さ れ ます。 画面表示の値の ど ち ら か、 あ る いは両方を設
定す る と 、 リ ッ チテ キ ス ト オブジ ェ ク ト ダ イ ア ロ グ ボ ッ ク ス の [印刷
の仕様] ページの [用紙サ イ ズ] ド ロ ッ プダ ウ ン リ ス ト のデフ ォ ル ト
の値が [ カ ス タ マ イ ズ ] に変わ り ます。
同様に、 PaperOrientation プ ロ パテ ィ に値を指定す る と 、 [印刷の仕様]
ページの [印刷の向 き ] のデフ ォ ル ト の値が変わ り ます。 アプ リ ケー
シ ョ ン ユーザは、 実行時に リ ッ チテ キ ス ト オブジ ェ ク ト ダ イ ア ロ グ
ボ ッ ク ス で印刷の仕様を変更す る こ と がで き ますが、 こ れは リ ッ チテ
キ ス ト オブジ ェ ク ト の PopMenu プ ロ パテ ィ に true を設定 し てい る 場
合のみです。
62
新機能
新規お よび変更 さ れた PowerBuilder コ ン ト ロール
日付ピ ッ カ ー コ ン ト ロール
日付ピ ッ カー コ ン ト ロ ールは、 ユーザが単一の日付を選択す る 場合に
簡単な方法を提供 し ます。 ユーザは、 コ ン ト ロ ール内で日付を編集す
る か、 ド ロ ッ プダ ウ ン カ レ ン ダか ら 日付を選択す る か を選ぶ こ と がで
き ます。 カ レ ン ダは月表示カ ン レ ダ コ ン ト ロ ールに似てお り 、 日付の
範囲を選択す る ために使用す る こ と がで き ます。 日付ピ ッ カー コ ン ト
ロ ールは、 ド ロ ッ プ ダ ウ ン カ レ ン ダ のかわ り に上下の矢印の コ ン ト
ロ ールを持つ よ う に指定す る こ と も で き ます。
日付を表示す る Date あ る いは DateTime エデ ィ ッ ト マ ス ク コ ン ト ロ ー
ルお よ びデー タ ウ ィ ン ド ウ カ ラ ム内の ド ロ ッ プダ ウ ン カ レ ン ダ を使
用す る こ と も で き ま す。 詳細については、 「エデ ィ ッ ト マ ス ク コ ン ト
ロ ールの DropDownCalendar プ ロ パテ ィ 」 お よ び 「 ド ロ ッ プダ ウ ン カ
レ ン ダ デー タ ウ ィ ン ド ウ オプシ ョ ン」 を参照 し て く だ さ い。
日付 ピ ッ カー コ ン ト ロ ール を ウ ィ ン ド ウ あ る いは ビ ジ ュ アル ユーザ
オブジ ェ ク ト に追加す る には、 [挿入| コ ン ト ロ ール] メ ニ ュ ーか ら 選
択 し て、 ウ ィ ン ド ウ あ る いはオ ブ ジ ェ ク ト で ド ロ ッ プ し ま す。 日付
ピ ッ カー コ ン ト ロ ールには、 日付 と 同様に時間を操作で き る 複数のプ
ロ パテ ィ があ り ますが、 ド ロ ッ プダ ウ ン カ レ ン ダ を使用 し て選択で き
る のは日付のみです。
プ ロ パテ ィ ビ ュ ーで、 コ ン ト ロ ールの初期の表示 と 動作を設定す る こ
と がで き ます。 コ ン ト ロ ールの ド ロ ッ プダ ウ ン カ レ ン ダ部分に適用す
る プ ロ パテ ィ は、 月表示カ レ ン ダ コ ン ト ロ ールに適用す る プ ロ パテ ィ
と 似ていて、 プ ロ パテ ィ ビ ュ ーの [カ レ ン ダ] ページ上に表示 さ れま
す。 例えば、 一週間の最初を何曜日にす る のか、 現在の日付を四角で
囲むのか、 カ レ ン ダの最下段に現在の日付を表示す る のかな ど を選択
す る こ と がで き ます。
詳細情報
PowerBuilder 11
詳細については、 『ユーザーズ ガ イ ド 』 マニ ュ アルの コ ン ト ロ ールの
操作の章の 「日付ピ ッ カー」 を参照 し て く だ さ い。 日付ピ ッ カー プ ロ
パテ ィ 、 イ ベン ト 、 お よ び関数の完全な リ ス ト については、 オ ン ラ イ
ン ヘルプの 「オブジ ェ ク ト と コ ン ト ロ ール」 の 「DatePicker コ ン ト ロ ー
ル」 を参照 し て く だ さ い。
63
新規および変更 さ れた PowerBuilder コ ン ト ロール
日付ピ ッ カ ー と 月表示カ レ ン ダ コ ン ト ロールでの RightToLeft プ ロパ
テ ィ のサポー ト
PowerBuilder 11 は、日付ピ ッ カー コ ン ト ロ ール と 月表示カ レ ン ダ コ ン
ト ロ ールで RightToLeft プ ロ パテ ィ を サポー ト し ま す。 Web フ ォ ーム
タ ーゲ ッ ト では こ れ ら の コ ン ト ロ ールの RightToLeft プ ロ パテ ィ を サ
ポー ト し ません。
エデ ィ ッ ト マ ス ク コ ン ト ロールの DropDownCalendar プ ロパテ ィ
Date ま たは DateTime エデ ィ ッ ト マ ス ク を持つエデ ィ ッ ト マ ス ク コ ン
ト ロ ールで、日付ピ ッ カー コ ン ト ロ ールに似た ド ロ ッ プダ ウ ン カ レ ン
ダ を使用す る こ と がで き ま す。 ユーザは、 コ ン ト ロ ール内の日付を編
集 し た り 、 ド ロ ッ プダ ウ ン カ レ ン ダか ら 日付を選ぶために選択す る こ
と がで き ます。 Windows アプ リ ケーシ ョ ンの西暦の範囲は、 1753 か ら
3000 ま でです。
エデ ィ ッ ト マ ス ク コ ン ト ロ ールが ド ロ ッ プ ダ ウ ン カ レ ン ダ を 使用 し
て日付の表示 と 設定を行 う よ う に指定す る には、 プ ロ パテ ィ ビ ュ ーの
[マ ス ク ] ページの [ ド ロ ッ プダ ウ ン カ レ ン ダ] チ ェ ッ ク ボ ッ ク ス を
オ ン に し ま す。 [カ レ ン ダ] ページで カ レ ン ダのプ ロ パテ ィ を表示す
る こ と がで き ます。 ユーザは、 日付ピ ッ カー コ ン ト ロ ールのカ レ ン ダ
で日付を移動 し て選択す る よ う に、 カ レ ン ダ内で日付を移動 し て選択
し ます。
DropDownCalendar プ ロ パテ ィ の詳細については、 『オブジ ェ ク ト と コ
ン ト ロ ール』 マニ ュ アルのプ ロ パテ ィ の章の 「DropDownCalendar」 を
参照 し て く だ さ い。
月表示カ レ ン ダ コ ン ト ロールの DateSelected イ ベ ン ト
月表示カ レ ン ダ コ ン ト ロ ールの新 し い DateSelected イ ベン ト は、 ユー
ザがマ ウ ス を使用 し て明確に日付 を選択す る と き にのみ発生 し ま す。
既存の DateChanged イ ベ ン ト は、 日付が変更 さ れ る 度に発生 し ま す。
日付が変更 さ れ る のは、 ユーザがマ ウ ス を使用 し て日付を選択す る と
き 、 日付が ス ク リ プ ト で変更 さ れ る と き 、 お よ びユーザがキーボー ド
の矢印 キ ー を 使用 し て別の日付に移動 し た り 、 コ ン ト ロ ールの矢印
キーを使用 し て別の月に ス ク ロ ールす る と き です。
詳細については、 『PowerScript リ フ ァ レ ン ス』 マ ニ ュ アルあ る いはオ
ン ラ イ ン ヘルプの 「DateSelected イ ベン ト 」 を参照 し て く だ さ い。
64
新機能
言語の機能拡張
言語の機能拡張
PowerBuilder 11 では、 言語に関 し て次の機能拡張が行われま し た。
•
PowerBuilder エ ク ス テ ン シ ョ ンの イ ン ポー ト
•
Decimal デー タ 型のサポー ト
•
Byte デー タ 型のサポー ト
•
新 し い OLERuntimeError プ ロ パテ ィ
•
新 し い関数 と 変更 さ れた関数
•
OrcaScript の機能拡張
PowerBuilder エ ク ス テ ン シ ョ ンのイ ンポー ト
PowerBuilder 11 では、 ポ ッ プ ア ッ プ メ ニ ュ ー項目 を 使用 し て ア プ リ
ケーシ ョ ンの ラ イ ブ ラ リ に PowerBuilder エ ク ス テ ン シ ョ ン を イ ン ポー
ト す る こ と がで き 、 PowerBuilder エ ク ス テ ン シ ョ ン の作成者は、 エ ク
ス テ ン シ ョ ン フ ァ イ ルを持つ PBD フ ァ イ ルを提供す る 必要はな く な
り ま し た。
PowerBuilder エ ク ス テ ン シ ョ ン は、 PowerBuilder ネ イ テ ィ ブ イ ン タ
フ ェ ー ス (PBNI : PowerBuilder Native Interface) を 使用 し て作成 し た
PowerBuilder 機能のエ ク ス テ ン シ ョ ン です。 い く つかの PowerBuilder
エ ク ス テ ン シ ョ ン (PBDOM、EJB ク ラ イ ア ン ト 、Web サービ ス の SOAP
ク ラ イ ア ン ト 、 お よ び UDDIProxy エ ク ス テ ン シ ョ ン な ど) は、
PowerBuilder で提供 さ れます。 PowerBuilder Samples and Utilities Web サ
イ ト http://PowerBuilder.CodeXchange.sybase.com に も PowerBuilder エ ク
ス テ ン シ ョ ン があ り ます。
PowerBuilder の以前の リ リ ース では、PowerBuilder エ ク ス テ ン シ ョ ンの
作成者は、 C++ 開発環境でエ ク ス テ ン シ ョ ン フ ァ イ ル (pbx ま たは .dll
フ ァ イ ル) を作成 し 、それか ら pbx2pbd ユーテ ィ リ テ ィ を使用 し て PBD
フ ァ イ ル を 作成す る 必要が あ り ま し た。 エ ク ス テ ン シ ョ ン の使用者
は、 ア プ リ ケーシ ョ ン の探索パ ス にエ ク ス テ ン シ ョ ン フ ァ イ ル を 置
き 、PBD フ ァ イ ルを タ ーゲ ッ ト の ラ イ ブ ラ リ リ ス ト に追加す る 必要が
あ り ま し た。
PowerBuilder 11
65
言語の機能拡張
PowerBuilder 11 では、 作成者はエ ク ス テ ン シ ョ ン フ ァ イ ルのみを提供
す る だけで よ く 、 ユーザはシ ス テ ム ツ リ ーで ラ イ ブ ラ リ のポ ッ プア ッ
プ メ ニ ュ ーの [PB エ ク ス テ ン シ ョ ン の イ ン ポー ト ] 項目を使用 し て、
エ ク ス テ ン シ ョ ン フ ァ イ ルのオブ ジ ェ ク ト のデ ィ ス ク リ プ シ ョ ン を
既存の ラ イ ブ ラ リ に イ ン ポー ト す る こ と がで き ます。 PBX フ ァ イ ルあ
る いは DLL フ ァ イ ルは、実行時にアプ リ ケーシ ョ ンの探索パ ス になけ
ればな り ません。
シ ス テ ム ツ リ ーでは、 イ ン ポー ト さ れ る エ ク ス テ ン シ ョ ンは ラ イ ブ ラ
リ のユーザ オブジ ェ ク ト と し て表示 さ れ、ほかのユーザ オブジ ェ ク ト
の よ う に使用す る こ と がで き ます。
PBX あ る いは DLL フ ァ イ ルを イ ン ポー ト す る には、エ ク ス テ ン シ ョ ン
のデ ィ ス ク リ プシ ョ ン を PowerScript に変換 し 、 それを PBL に ソ ー ス
コ ー ド と し て追加 し ます。 ソ ース コ ー ド の新 し いキー ワー ド native は、
PowerBuilder タ イ プ が エ ク ス テ ン シ ョ ン で定義 さ れ た こ と を 示 し ま
す。
Decimal デー タ 型のサポー ト
PowerBuilder の以前の リ リ ース では、PowerScript の Decimal デー タ 型は
18 桁ま でサポー ト し てい ま し た。 PowerBuilder 11 では、 Decimal デー タ
型は 28 桁ま でサポー ト し ます。
Byte デー タ 型のサポー ト
PowerBuilder 11 で、Byte デー タ 型のサポー ト を追加 し ま し た。 Byte デー
タ 型は、 値の範囲が狭い こ と (0 か ら 255 ま で) を除いて Uint デー タ
型 と 同 じ です。 Java コ ン ポーネ ン ト あ る いは Web サービ ス と の相互関
係に関 し て、PowerScript Byte デー タ 型は、Java お よ び C# あ る いは .NET
言語で Byte デー タ 型にマ ッ プ し ます。
PowerBuilder 11 では Byte デー タ 型で動作す る 以下の関数 も 追加 さ れて
い ます。
関数
Byte (stringorblob)
GetByte (blobvariable, n, b)
SetByte (blobvariable, n, b)
66
説明
数値デー タ 型 (値が数値であ る 文字列を含む) を
Byte デー タ 型に変換 し た り 、 blob に格納 さ れ る
Byte 値を取得する
blob 変数か ら Byte デー タ 型を抽出する
blob 変数に Byte デー タ 型を設定する
新機能
言語の機能拡張
詳細については、 『PowerScript リ フ ァ レ ン ス』 マ ニ ュ アルあ る いはオ
ン ラ イ ン ヘルプの 「Byte」、 「GetByte」、 お よ び 「SetByte」 を参照 し て
く だ さ い。
新 し い OLERuntimeError プ ロパテ ィ
OLERuntimeError はシ ス テ ム オブジ ェ ク ト で、 RuntimeError オブジ ェ
ク ト (Throwable オ ブ ジ ェ ク ト か ら 順 に 継 承) か ら 継 承 さ れ ま す。
OLERuntimeError は、 ocx_error、 ExternalException、 あ る い は Error イ
ベン ト ス ク リ プ ト で処理 さ れない OLE エ ラ ーが発生す る と き に自動
的に送出 さ れます。 ExternalException お よ び Error イ ベン ト か ら の情報
は、 OLERuntimeError オブジ ェ ク ト に伝え ら れ ます。
PowerBuilder 11 では、 OLERuntimeError オブジ ェ ク ト はその先祖オブ
ジ ェ ク ト にはない 4 つのプ ロ パテ ィ を持ち ます。
OLERuntimeError プ ロ
パテ ィ
Description
HelpContext
デー タ 型
String
UnsignedLong
HelpFile
String
Source
String
説明
エン ド ユーザを対象 と し たエ ラ ーの説明
エ ラ ーに関す る 情報を含むヘルプ フ ァ イ ルの ト ピ ッ ク の
ヘルプ コ ン テ キ ス ト ID
エ ラ ーに関す る 情報を持つヘルプ フ ァ イ ルの完全なパ ス
と フ ァ イ ル名
例外 ソ ース の名前 (通常はアプ リ ケーシ ョ ン名)
新 し い関数 と 変更 さ れた関数
バイ ト 配列変換関数
新 し い PowerScript 関数 GetByteArray、 お よ び Blob 関数の新 し い構文が
blob デー タ と バ イ ト 配列間で変換で き る よ う に追加 さ れ ま し た。
構文は次の通 り です。
Blob ( any stringorbytearray ) returns blob
GetByteArray ( blob input ) returns Any
Trim 関数を使用する
2 つの方法
PowerBuilder 11
Trim、 LeftTrim、 お よ び RightTrim 関数の新 し い多重定義版が追加 さ れ ま
し た。 デ フ ォ ル ト では、 こ れ ら の関数は ス ペー ス (半角お よ び全角)
だけ を削除 し ます。すべての種類の空白文字( タ ブやキ ャ リ ッ ジ リ タ ー
ン な ど) を削除す る には、 オプシ ョ ンの 2 番目の引数に true を設定 し
ます。 デフ ォ ル ト は、 false です。
67
言語の機能拡張
フ ィ ル タ 式での \s の
使用
辞書順ではな く ASCII 順で文字列を比較 し たい場合に、SetFilter デー タ
ウ ィ ン ド ウ 関数で使用す る フ ィ ル タ 式に \s を追加で き る よ う にな り
ま し た。 た と えば、 次の式は、 カ ラ ム 2 が a ま たは b で始ま る 行だけ
を表示 し ます。 こ れは、 大文字の ASCII 値が小文字の ASCII 値 よ り 小
さ いか ら です。
#2 >= 'a' and #2 < 'c' \s
\s を指定 し ない と 、 カ ラ ム 2 が A、 B、 あ る いは b で始ま る 行が表示
さ れ ます。
詳細につい て は、 オ ン ラ イ ン ヘルプの関数の説明 を 参照 し て く だ さ
い。
OrcaScript の機能拡張
Windows フ ォ ーム
タ ーゲ ッ ト のサポー ト
PowerBuilder 11 には、 プ ロ ジ ェ ク ト オブ ジ ェ ク ト に含 ま れ る 指定に
従っ て Windows フ ォ ーム プ ロ ジ ェ ク ト を構築、配布す る ための新 し い
ORCA ラ イ ブ ラ リ 関数があ り ます。
PBORCA_DeployWinFormProject 関数の詳細については、 PowerBuilder
11 セ ッ ト ア ッ プ プ ロ グ ラ ム が PowerBuilder SDK\ORCA デ ィ レ ク ト リ
に イ ン ス ト ールす る 、 『ORCA ガ イ ド 』 マニ ュ アルの PDF フ ァ イ ルを
参照 し て く だ さ い。
次の OrcaScript コ マ ン ド を使用 し て Windows フ ォ ーム配布関数を呼び
出 し ます。
Deploy WinForm Project "pblName" "entryName"
["iconName"]
こ の コ マ ン ド で指定す る 引数は、 配布す る プ ロ ジ ェ ク ト を含む ラ イ ブ
ラ リ の名前、 プ ロ ジ ェ ク ト オブジ ェ ク ト の名前、 お よ びオプシ ョ ン の
アプ リ ケーシ ョ ン ア イ コ ンの名前です。
OrcaScript の詳細については、 PowerBuilder の 『ユーザーズ ガ イ ド 』 マ
ニ ュ アルの付録 B を参照 し て く だ さ い。
Unicode コ マ ン ド
フ ァ イルのサポー ト
68
PowerBuilder 11 では、 Unicode コ マ ン ド フ ァ イ ルあ る いは ANSI コ マ
ン ド フ ァ イ ルのいずれか を使用 し ます。 以前は、 ANSI コ マ ン ド フ ァ
イ ルだけ を サポー ト し てい ま し た。
新機能
デー タ ベース接続の機能拡張および変更
デー タ ベース接続の機能拡張および変更
PowerBuilder 11 では、 次のデー タ ベース接続機能が拡張お よ び変更 さ
れ ま し た。
•
デー タ ベース ト レース の機能拡張
•
Adaptive Server Enterprise 15 のサポー ト
•
Adaptive Server Enterprise 15 の新 し いデー タ ベース イ ン タ フ ェース
•
Adaptive Server Enterprise 15 の符号な し デー タ 型を サポー ト
•
Adaptive Server Enterprise 15 の Identity カ ラ ム
•
Sybase Adaptive Server Enterprise テ ン ポ ラ リ テーブルのサポー ト
•
Sybase Adaptive Server Enterprise お よ び Oracle の ADO.NET のサ
ポー ト
•
Microsoft SQL Server 2005 のサポー ト
•
ServerCursor デー タ ベース パ ラ メ ー タ
•
EAServer 6.0 のサポー ト
•
Oracle のための NCharBind デー タ ベース パ ラ メ ー タ
•
Oracle 10g の ス テー ト メ ン ト キ ャ ッ シ ュ
•
Oracle 10g の HA イ ベン ト 通知のサポー ト
•
MobiLink 同期のサポー ト の拡張
•
Informix 10 のサポー ト
デー タ ベース ト レースの機能拡張
PowerBuilder 11 では、 メ イ ンのデー タ ベース ト レース ユーテ ィ リ テ ィ
PBTRA110.DLL に精度 と 使いやす さ の機能拡張 を 行い、 2 つ目の ト
レース ユーテ ィ リ テ ィ PBTRS110.DLL を提供 し ます。 新 し いユーテ ィ
リ テ ィ は、 デー タ ベース に発行 し た各 SQL 文の日付 と 時刻 (経過時間
ではない) を記録 し ます。 こ のユーテ ィ リ テ ィ は、 DBMS サーバ コ ン
ピ ュ ー タ の タ イ ム ゾーン の タ イ ム ス タ ン プ を使用す る こ と で き 、 別の
タ イ ム ゾ ー ン の ク ラ イ ア ン ト が ト レ ー ス 出力 フ ァ イ ル を マージ で き
る よ う に し ます。
PowerBuilder 11
69
デー タ ベース接続の機能拡張お よび変更
こ れ ら の機能拡張は、PowerBuilder 10.2 で行われま し た。 詳細について
は、 『デー タ ベー ス と の接続』 マ ニ ュ アルの 「デー タ ベー ス ト レ ー ス
の使い方」 の節を参照 し て く だ さ い。
Adaptive Server Enterprise 15 のサポー ト
Adaptive Server® Enterprise のネ イ テ ィ ブ イ ン タ フ ェース (pbsyc110.dll)
を Adaptive Server バ ー ジ ョ ン 15 で 使 用 す る こ と が で き 、 Adaptive
Server のバージ ョ ン 15 のい く つかの新 し い機能 を サポー ト す る よ う
に拡張 さ れま し た。
ス ク ロール可能な カ ー
ソル
Adaptive Server Enterprise は ス ク ロ ール可能な カー ソ ルお よ びス ク ロ ー
ル不可のカー ソ ルの両方を許可 し ます。 こ のカー ソ ルは、 半反映型あ
る いは非反映型であ る こ と がで き ます。 「ス ク ロ ール可能」 は、 一度に
1 行ではな く 、 い く つかの、 多 く の行の フ ェ ッ チに よ る カー ソ ル結果
集合を ス ク ロ ールで き る こ と を意味 し ます。 繰 り 返 し 結果集合を見 る
こ と も で き ま す。 CursorType デー タ ベー ス パ ラ メ ー タ で、 使用す る
カ ー ソ ル の 種 類 を 指 定 す る こ と が で き ま す。 詳 細 に つ い て は、
PowerBuilder オ ン ラ イ ン ヘルプの 「CursorType」 を参照 し て く だ さ い。
Unitext のサポー ト
PowerBuilder は可変長の UniText デー タ 型を サポー ト し ます。 こ のデー
タ 型は 1,073,741,823 Unicode 文字 (2,147,483,646 バ イ ト ) ま で有効で
す。 同 じ 動作の text デー タ 型を使用す る と こ ろ で UniText デー タ 型を使
用で き ます。 Unitext カ ラ ムは、Adaptive Server のデフ ォ ル ト の文字セ ッ
ト に関係な く UTF-16 エ ン コ ーデ ィ ン グ で格納 さ れ ま す。 Unitext デー
タ 型は、 Unicode テ キ ス ト を サポー ト し 、 PowerScript string デー タ 型に
マ ッ プす る ために UTF-16 エ ン コ ーデ ィ ン グ を使用 し ます。
Bigint のサポー ト
PowerBuilder は、 64 ビ ッ ト integer 符号付 き BigInt デー タ 型
(PowerScript longlong デー タ 型にマ ッ プ)、お よ び符号な し BigInt デー タ
型 (PowerScript decimal デー タ 型にマ ッ プ) を サポー ト し ます。
符号な し integer デー
タ型
符号な し BigInt デー タ 型に加え て、 PowerBuilder は Adaptive Server 15.0
で導入 さ れた 2 つの符号な し integer デー タ 型 も サポー ト し ます。 こ の
リ リ ース では、 符号な し integer デー タ 型は、 SYC お よ び JDBC ド ラ イ
バを使用 し て Adaptive Server に接続す る と き にサポー ト さ れます。
こ れ ら のデー タ 型に よ っ て、 要求 さ れ る 格納サ イ ズ を増や さ ずに既存
の integer デー タ 型の正数範囲を拡張で き ます。 つま り 、 こ れ ら のデー
タ 型の符号付 き は負の方向 と 正の方向の両方に拡張 し ま す。 け れ ど
も 、 符号な し は正の方向のみ拡張 し ます。 表 1 は こ れ ら のデー タ 型の
符号付 き と 符号な し の範囲を表 し てい ます。
70
新機能
デー タ ベース接続の機能拡張および変更
表 1: 符号付き と 符号な し の integer デー タ 型の範囲
デー タ 型
BigInt
Int
SmallInt
符号付きデー タ 型の範囲
-263 か ら 263 - 1 の間の整数
(- 9,223,372,036,854,775,808 か ら
+9,223,372,036,854,775,807 ま で)、 始め と 終わ
り の数値を含む
-231 か ら 231 - 1 の間の整数 (- 2,147,483,648 か ら
2,147,483,647 ま で)、始め と 終わ り の数値を含む
-215 か ら 215 -1 の間の整数 (- 32,768 か ら 32,767
ま で)、 始め と 終わ り の数値を含む
Adaptive Server 15 の
使用
符号な し デー タ 型の範囲
0 か ら 18,446,744,073,709,551,615 の
間の整数
0 か ら 4,294,967,295 の間の整数
0 か ら 65535 の間の整数
Adaptive Server 15 を使用す る には、ク ラ イ ア ン ト コ ン ピ ュ ー タ に Open
Client バージ ョ ン 15 を イ ン ス ト ール し 、 Release パ ラ メ ー タ に 15 を設
定 し て Open Client 15 ク ラ イ ア ン ト コ ン テ キ ス ト を確立す る 必要があ
り ます。 DB プ ロ フ ァ イ ル設定 - Adaptive Server ダ イ ア ロ グ ボ ッ ク ス の
[接続] ページ あ る いは コ ー ド で、 以下の よ う に Release パ ラ メ ー タ を
指定す る こ と がで き ます。
SQLCA.DBParm="Release='15'"
Open Client 15 ク ラ イ ア ン ト コ ン テ キ ス ト は、Adaptive Server 11.x、12.x、
お よ び 15.x で使用で き ます。
PowerBuilder 11.1 では、 SYC ド ラ イ バが動的に ク ラ イ ア ン ト ラ イ ブ ラ
リ の適切なバージ ョ ン に リ ン ク し 、 Open Client コ ン テ キ ス ト はすべて
の接続が閉 じ ら れ る と き に解放 さ れ ま す。 複数の接続を開 く と 、 最初
に確立 し た Open Client コ ン テ キ ス ト がすべての接続で使用 さ れ ます。
開発環境で新 し い Open Client コ ン テ キ ス ト を 確立す る 必要が あ る 場
合は、 すべての開いてい る 接続を閉 じ て、 Release パ ラ メ ー タ に必要 と
す る コ ン テ キ ス ト を設定 し て新 し い接続を確立 し ます。
Adaptive Server Enterprise 15 の新 し いデー タ ベース イ ン タ フ ェ ース
新 し いデー タ ベース イ ン タ フ ェ ース ASE イ ン タ フ ェース が、 Adaptive
Server® Enterprise 15 以降の リ リ ース を サポー ト す る ために追加 さ れま
し た。 こ の イ ン タ フ ェ ー ス は、 次の点 を 除い て、 既存の SYC イ ン タ
フ ェース と 同 じ です。
PowerBuilder 11
•
Adaptive Server 15 だけ を サポー ト (Release デー タ ベース パ ラ メ ー
タ に 15 を設定す る だけ)
•
128 文字ま での大 き な識別子をサポー ト 。 こ のサポー ト は、SYC イ
ン タ フ ェース では使用で き ません。
71
デー タ ベース接続の機能拡張お よび変更
こ の イ ン タ フ ェース を使用す る には、 Adaptive Server 15 ク ラ イ ア ン ト
を ク ラ イ ア ン ト コ ン ピ ュ ー タ に イ ン ス ト ールす る 必要があ り ます。
Adaptive Server Enterprise 15 の符号な し デー タ 型をサポー ト
Adaptive Server® Enterprise 15 で導入 さ れた 3 つの符号な し デー タ 型
UnsignedBigInt、 UnsignedInt、 お よ び UnsignedSmallInt をサポー ト し ます。
SYC、 JDBC、 ODBC、 お よ び ASE イ ン タ フ ェース は、 こ れを サポー ト
し ます。
Adaptive Server Enterprise 15 の Identity カ ラ ム
Adaptive Server® Enterprise 15.0 以降で は、 identity カ ラ ム と し て 次の
デー タ 型を使用で き ます。 使用で き る デー タ 型は、 bigint、 int、 numeric、
smallint、 tinyint、 unsigned bigint、 unsigned int、 お よ び unsigned smallint で
す。 こ のサポー ト は、 PowerBuilder 11 の ASE お よ び SYC デー タ ベー
ス イ ン タ フ ェース に追加 さ れ ま し た。
Sybase Adaptive Server Enterprise テ ンポ ラ リ テーブルのサポー ト
PowerBuilder 11 では、 Adaptive Server® Enterprise デー タ ベース に接続
す る ために PowerBuilder SYC ネ イ テ ィ ブ ド ラ イ バを使用す る と き に、
デー タ ベース ペ イ ン タ 、SQL ペ イ ン タ 、 あ る いはデー タ ウ ィ ン ド ウ ペ
イ ン タ でテ ン ポ ラ リ テーブルを作成 し 編集す る こ と がで き ます。 テ ン
ポ ラ リ テーブルは、「tempdb」 と 呼ばれ る 特殊なデー タ ベース に存在 し
て、 デー タ ベース接続の間存続 し ます。
PowerBuilder ペ イ ン タ で新 し いテーブルを作成す る と き に、# 文字で始
ま る 名前を割 り 当て て、テ ン ポ ラ リ テーブルを tempdb デー タ ベース に
追加 し ま す。 (テ ン ポ ラ リ テーブルは # 文字で始 ま る 必要が あ り ま
す。)
テ ン ポ ラ リ テーブルを作成 し てか ら 、 テーブルの イ ンデ ッ ク スお よ び
主 キ ー を 作成す る こ と が で き ま す。 固有の イ ン デ ッ ク ス あ る いは主
キー を 定義す る と 、 テ ン ポ ラ リ テーブルに対 し て INSERT、 UPDATE、
お よ び DELETE 文を実行す る こ と がで き ます。 テ ン ポ ラ リ テーブルの
ポ ッ プア ッ プ メ ニ ュ ーか ら [デー タ 操作ペ イ ン タ を開 く ] を選択 し て、
そのテーブルに格納 さ れてい る デー タ を検索 し ます。
72
新機能
デー タ ベース接続の機能拡張および変更
詳細については、 『ユーザーズ ガ イ ド 』 マニ ュ アルの 「Sybase Adaptive
Server テ ン ポ ラ リ テーブルの作成 と 編集」 を参照 し て く だ さ い。
Sybase Adaptive Server Enterprise お よび Oracle の ADO.NET のサ
ポー ト
PowerBuilder 11 は、ADO.NET を使用 し た Adaptive Server® Enterprise お
よ び Oracle へのネ イ テ ィ ブ ア ク セ ス を提供 し ます。 ADO.NET デー タ
プ ロ バ イ ダ を使用 し てデー タ ベース に接続 し 、 ネ イ テ ィ ブの構文を使
用す る 処理を行 う こ と がで き ま す。 新 し い接続を作成 し た り 、 ト ラ ン
ザ ク シ ョ ン管理で既存の接続オブジ ェ ク ト を共有 し た り す る こ と がで
き ます。
PowerBuilder は現在以下の ADO.NET 名前空間 と デー タ プ ロ バ イ ダ を
サポー ト し ます。
デー タ プ ロバイ ダ
名前空間
.NET Framework Data Provider for OLE DB
System.Data.OleDb
.NET Framework Data Provider for SQL Server
System.Data.SqlClient
Oracle Data Provider for .NET (ODP.NET)
Oracle.DataAccess.Client
Sybase ADO.NET Data Provider for Adaptive Server Sybase.Data.AseClient
Enterprise (ASE)
PBADO110.DLL フ ァ イ ル お よ び Sybase.PowerBuilder.Db.dll お よ び
Sybase.PowerBuilder.DbExt.dll .NET ア セ ン ブ リ で サ ポ ー ト し ま す。
PowerBuilder で配布 さ れ る ADO.NET ド ラ イ バは、Sybase お よ び Oracle
で提供 さ れ る ADO.NET ア セ ン ブ リ の特定のバージ ョ ン で作成 さ れ ま
す。 Oracle 10g あ る いは Adaptive Server 15 以降を使用 し てい る 場合は、
アプ リ ケーシ ョ ン と 一緒に Sybase.PowerBuilder.DbExt.dll を配布す る 必
要があ り ます。
詳 細 に つ い て は、 『デ ー タ ベ ー ス と の 接 続』 マ ニ ュ ア ル の 第 5 章
「ADO.NET イ ン タ フ ェース について」 を参照 し て く だ さ い。
Microsoft SQL Server 2005 のサポー ト
新 し いデー タ ベース イ ン タ フ ェ ース SNC イ ン タ フ ェ ース が、Microsoft
SQL Server を サ ポ ー ト す る た め に 追加 さ れ ま し た。 新 し い イ ン タ
フ ェ ース は、 ク ラ イ ア ン ト 側の SQL Server 2005 ネ イ テ ィ ブ ク ラ イ ア
ン ト (sqlncli.h お よ び sqlncli.dll) を使用 し 、 OLE DB を使用 し て接続 し
ます。
PowerBuilder 11
73
デー タ ベース接続の機能拡張お よび変更
PBODB 初期設定 フ ァ イルを使用 し ない
OLE DB か ら 直接行われた接続は、PBODB 初期設定フ ァ イ ルを使用 し
て、 一部のパ ラ メ ー タ を設定 し ますが、 SNC イ ン タ フ ェース を使用 し
て行っ た接続は PBODB 初期設定フ ァ イ ルを使用 し ません。
SNC イ ン タ フ ェース は、 SQL Server 2005 お よ び SQL Server 2000 に接
続す る ために使用で き ます。
SQL Server 2000 について、 SQL client SDK は Microsoft Database Access
Components (MDAC) に よ っ て提供 さ れてい ま し た。 MDAC は、 SQL
Server 2005 の新 し い機能をサポー ト し ません。 SNC イ ン タ フ ェース を
使 用 す る に は、 SQL Server 2005 SQL Native Client お よ び .NET
Framework 2.0 が ク ラ イ ア ン ト コ ン ピ ュ ー タ に イ ン ス ト ール さ れてい
る 必要があ り ます。
詳細につい て は、 『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「Microsoft
SQL Server の使い方」 の章を参照 し て く だ さ い。
ServerCursor デー タ ベース パラ メ ー タ
Microsoft SQL Server デー タ ベー ス で OLE DB デー タ ベー ス イ ン タ
フ ェ ー ス を 使用 し て、 デー タ ウ ィ ン ド ウ にデー タ を 取 り 出 し た り 、
SELECT 文で埋め込み SQL カ ー ソ ル を 使用す る と き 、 サーバサ イ ド
カー ソ ルが複数の コ マ ン ド 実行を サポー ト す る ために使用 さ れ ま す。
こ れがパ フ ォ ーマ ン ス を低下 さ せ る 場合は、 Block デー タ ベース パ ラ
メ ー タ の サ イ ズ を 500 以上に増やすか、 PBODB110.INI フ ァ イ ル の
[Microsoft SQL Server] セ ク シ ョ ン に次の行を追加 し て、 サーバサ イ ド
カー ソ ルを解除 し ます。
ServerCursor = 'NO'
ServerCursor パ ラ メ ー タ は、 PBODB 初期設定フ ァ イ ルでのみ使用す る
こ と がで き ます。
EAServer 6.0 のサポー ト
EAServer 6.0 には、パッケージに関する 1 つの新しいプロパティおよ
びコンポーネントに関する 2 つの新しいプロパティがあります。
com.sybase.jaguar.package.java.package
com.sybase.jaguar.component.roles
com.sybase.jaguar.component.webservice
74
新機能
デー タ ベース接続の機能拡張および変更
EAServer ウ ィ ザー ド お よ びプ ロ ジ ェ ク ト ペ イ ン タ のプ ロ パテ ィ ダ イ
ア ロ グ ボ ッ ク ス には、 こ れ ら のプ ロ パテ ィ を設定す る こ と がで き る 新
し い フ ィ ール ド があ り ます。 EAServer の以前のバージ ョ ン を使用 し て
い る 場合は、 こ れ ら の フ ィ ール ド で指定す る 値は無視 さ れ ます。
以前の リ リ ース あ る いは EJB 2.1 Web サービ ス と 同 じ よ う に、コ ン ポー
ネ ン ト を EAServer 5.x Web サービ ス と し て配布す る こ と がで き ま す。
EAServer 6.0 で使用す る 場合は、 EJB 2.1 Web サービ ス を選択 し ます。
パ ッ ケ ー ジ 名 mypkg の 場 合、 デ フ ォ ル ト の Java パ ッ ケ ー ジ 名 は
mypkg.ejb です。別のパ ッ ケージ名を指定す る には、ウ ィ ザー ド の [パ ッ
ケージ名の指定] ページ あ る いはプ ロ ジ ェ ク ト ペ イ ン タ の [全般] ペー
ジでその名前を入力 し ます。EJB 2.1 Web サービ ス と し て コ ン ポーネ ン
ト を配布す る 予定の場合は、 Java パ ッ ケージ名を指定す る 必要があ り
ます。
ウ ィ ザー ド で コ ン ポーネ ン ト に対 し て 1 つ以上のセキ ュ リ テ ィ ロ ール
を指定す る こ と がで き ます。プ ロ ジ ェ ク ト ペ イ ン タ のプ ロ パテ ィ ダ イ
ア ロ グ ボ ッ ク ス の [ コ ン ポーネ ン ト ] ページで、 プ ロ ジ ェ ク ト 内のす
べて の コ ン ポーネ ン ト に対 し て セ キ ュ リ テ ィ ロ ール を 指定す る こ と
がで き ます。
EAServer 6.0 では、PowerBuilder® コ ン ポーネ ン ト は EJB と し て ラ ッ プ
さ れ ます。 PowerBuilder デー タ 型の EJB デー タ 型へのマ ッ ピ ン グにつ
いての表、 PowerBuilder コ ン ポーネ ン ト お よ び EAServer 6.0 の ク ラ イ
ア ン ト の作成に関す る 詳細については、 Sybase Product Manuals Web サ
イ ト http://sybooks.sybase.com にあ る EAServer 6.0 core documentation set
の 『CORBA Components Guide』 マニ ュ アルを参照 し て く だ さ い。
EAServer でのみ使用 さ れていた機能を ほかのアプ リ ケーシ ョ ンサーバ
で も 使用で き る よ う に拡張す る ために、 ユーザ イ ン タ フ ェース の変更
が行われ ま し た。 EAServer プ ロ フ ァ イ ル ダ イ ア ロ グ ボ ッ ク ス は、 「ア
プ リ ケーシ ョ ンサーバ プ ロ フ ァ イ ル」 と 改名 さ れ、 ほかのサーバでプ
ロ フ ァ イ ルを指定す る ために使用で き る よ う にな り ま し た。 シ ス テ ム
ツ リ ーの [ コ ン ポーネ ン ト ] ページの [アプ リ ケーシ ョ ンサーバ] フ ォ
ルダには、 作成 さ れた アプ リ ケーシ ョ ンサーバ プ ロ フ ァ イ ルがすべて
表示 さ れ ます。
EAServer 6.0 の EJB
ク ラ イアン ト アプ リ
ケーシ ョ ンの作成
PowerBuilder 11
EAServer 6.0 で実行す る EJB の EJB ク ラ イ ア ン ト アプ リ ケーシ ョ ン を
作成す る 場合は、 EJB ク ラ イ ア ン ト プ ロ キ シ を作成す る と き 、 お よ び
ク ラ イ ア ン ト を作成す る と き に、 い く つか追加の手順を取 る 必要があ
り ます。
75
デー タ ベース接続の機能拡張お よび変更
❖
❖
EAServer 6.0 に配布 さ れる EJB のプ ロキシ を生成する には
1
サーバの %DJC_HOME%\deploy\ejbjars\ デ ィ レ ク ト リ か ら ク ラ イ
ア ン ト コ ン ピ ュ ー タ に packagename デ ィ レ ク ト リ を コ ピ ー し ま
す。 packagename は、 使用 し たい EJB を含むパ ッ ケージです。
2
EJB プ ロ キ シ プ ロ ジ ェ ク ト ペ イ ン タ で EJB コ ン ポーネ ン ト の選択
ダ イ ア ロ グ ボ ッ ク ス の [ ク ラ ス パ ス] に こ のデ ィ レ ク ト リ を追加
し ます。
3
プ ロ キ シ を生成 し ます。
EAServer 6.0 に配布 さ れる EJB の EJB ク ラ イ ア ン ト ア プ リ ケーシ ョ ン を
作成するには
1
%DJC_HOME%\lib デ ィ レ ク ト リ か ら ク ラ イ ア ン ト コ ン ピ ュ ー タ
に eas-server-14.jar フ ァ イ ル (JDK 1.5.x を使用 し てい る 場合は easserver-15.jar) を コ ピー し 、 ク ラ イ ア ン ト の ク ラ ス パ ス にその フ ァ
イ ルの完全なパ ス を含め ます。
2
%DJC_HOME%\genfiles\java\classes\ デ ィ レ ク ト リ か ら ク ラ イ ア
ン ト コ ン ピ ュ ー タ に ス タ ブ フ ァ イ ルを コ ピー し 、 ク ラ イ ア ン ト の
ク ラ ス パ ス に こ のパ ス を含め ます。
3
サーバの %DJC_HOME\deploy\ejbjars\ デ ィ レ ク ト リ か ら ク ラ イ ア
ン ト コ ン ピ ュ ー タ に packagename デ ィ レ ク ト リ を コ ピ ー し ま す。
packagename は、 使用 し たい EJB を含むパ ッ ケージです。 そ し て、
ク ラ イ ア ン ト の ク ラ ス パ ス に こ のパ ス を含め ます。
こ れ ら の フ ァ イ ル と デ ィ レ ク ト リ を EAServer6 と い う ク ラ イ ア ン
ト のデ ィ レ ク ト リ に コ ピー し て、 datamapping パ ッ ケージ内の EJB
を使用す る 場合は、 ク ラ イ ア ン ト ク ラ ス パ ス の設定は以下の よ う
にな り ます。
Classpath=D:\EAServer6\libeasserver-14.jar;D:EAServer6\genfiles\java\classes;D:E
AServer6\deploy\ejbjars\datamapping
76
新機能
デー タ ベース接続の機能拡張および変更
Oracle のための NCharBind デー タ ベース パラ メ ー タ
Oracle9i お よ び Oracle 10g の NCharBind デー タ ベー ス パ ラ メ ー タ は、
文字列変数を Char ま たは NChar デー タ 型の ど ち ら と し て扱 う か を指
定す る こ と に よ っ てパ フ ォ ーマ ン ス を 改善 し ま す。 デ フ ォ ル ト では、
文字列変数 を Char デー タ 型 と し て 扱い ま す。 Oracle9i お よ び Oracle
10g の DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の [ ト ラ ンザ ク シ ョ
ン] タ ブ ページで こ のパ ラ メ ー タ を設定す る こ と がで き ます。 詳細に
ついては、 『接続 リ フ ァ レ ン ス』 マニ ュ アルあ る いはオ ン ラ イ ン ヘル
プの 「NCharBind」 を参照 し て く だ さ い。
Oracle 10g のス テー ト メ ン ト キ ャ ッ シ ュ
Oracle 10g での ス テー ト メ ン ト キ ャ ッ シ ュ は、 各セ ッ シ ョ ン の ス テー
ト メ ン ト キ ャ ッ シ ュ を提供 し 、 管理 し ます。 サーバでは、 カー ソ ルは
再度 ス テー ト メ ン ト を解析せずに実行で き る 状態にな っ てい ます。 ス
テー ト メ ン ト キ ャ ッ シ ュ は、 接続プールで使用で き 、 パフ ォ ーマ ン ス
と ス ケー ラ ビ リ テ ィ を向上 し ます。
ス テー ト メ ン ト キ ャ ッ シ ュ の最大のサ イ ズ を設定す る には、
StatementCache DBParm に キ ャ ッ シ ュ す る ス テー ト メ ン ト の数 を 設定
し ます。 デフ ォ ル ト 値は 0 で、 こ れは、 現行セ ッ シ ョ ン で ス テー ト メ
ン ト キ ャ ッ シ ュ が無効であ る こ と を意味 し ます。 こ の DBParm は O10
デー タ ベース イ ン タ フ ェ ース でのみ使用で き ます。
Oracle 10g の HA イ ベン ト 通知のサポー ト
Oracle Real Application Clusters (RAC) は共有キ ャ ッ シ ュ アーキ テ ク
チ ャ を使用す る ク ラ ス タ デー タ ベース です。Oracle 10g Release 2 では、
RAC デー タ ベー ス に接続 さ れてい る 高可用性 (HA: High Availability)
ク ラ イ ア ン ト は、 ク ラ イ ア ン ト の接続に影響す る デー タ ベー ス に障害
が発生 し た と き に、 サーバか ら 通知を受け取 る 必要があ る こ と を示す
コ ールバ ッ ク を登録で き ます。
こ の機能を利用す る には、 PowerBuilder ユーザは新 し い DBNotification
イ ベン ト に ス ク リ プ ト を記述 し ます。こ の イ ベン ト は、 ト ラ ンザ ク シ ョ
ン オブジ ェ ク ト に追加 さ れ ま し た。 詳細については、 オ ン ラ イ ン ヘル
プの DBNotification イ ベン ト お よ び HANotification デー タ ベー ス パ ラ
メ ー タ を参照 し て く だ さ い。
PowerBuilder 11
77
デー タ ベース接続の機能拡張お よび変更
MobiLink 同期のサポー ト の拡張
MobiLink は、統合デー タ ベース と 呼ばれ る メ イ ン デー タ ベース と 複数
の リ モー ト デー タ ベー ス 間の双方向の同期 を 実現で き る セ ッ シ ョ ン
ベース の同期シ ス テ ム です。 新規作成 ダ イ ア ロ グボ ッ ク ス の [デー タ
ベース] タ ブにあ る ASA MobiLink 同期 ウ ィ ザー ド は、 PowerBuilder ア
プ リ ケーシ ョ ン か ら のデー タ ベー ス 同期の制御を助け る オブジ ェ ク ト
を作成 し ます。
ウ ィ ザー ド の変更
PowerBuilder 11 では、 MobiLink 機能が .NET アプ リ ケーシ ョ ン で動作
す る よ う に 、シ ス テ ム オブジ ェ ク ト が追加 さ れ ま し た。ASA MobiLink
同期 ウ ィ ザー ド は PowerBuilder アプ リ ケーシ ョ ン か ら デー タ ベース同
期の制御を助け る オブジ ェ ク ト を生成 し ますが、 ウ ィ ザー ド で生成 さ
れた メ イ ン の非 ビ ジ ュ アル オブ ジ ェ ク ト は、 MLSync シ ス テ ム オブ
ジ ェ ク ト の イ ン ス タ ン ス にな り ます (MLSynchronization ベース ク ラ ス
か ら 継承 さ れ ます)。
ウ ィ ザー ド は、 ユーザが入力 し た同期パ ラ メ ー タ の記憶領域のための
グ ロ ーバル構造体オ ブ ジ ェ ク ト を 生成 し な く な り 、 生成 さ れ た同期
ウ ィ ン ド ウ は、 かわ り に SyncParm シ ス テ ム構造体を使用 し ます。 こ の
変更は、.NET プ ラ ッ ト フ ォームに配布 さ れない タ ーゲ ッ ト に も 適用 さ
れます。
MobiLink オブ ジ ェ ク ト の移行
PowerBuilder 11 へ移行す る PowerBuilder 10 MobiLink アプ リ ケーシ ョ
ン では、 MobiLink ウ ィ ザー ド を再実行 し て、 新 し い同期オブジ ェ ク ト
を生成す る こ と を強 く 推奨 し ます。 .NET Windows フ ォ ーム タ ーゲ ッ
ト に配布す る 場合は、 ウ ィ ザー ド を再実行す る 必要があ り ます。
移行す る 同期アプ リ ケーシ ョ ンは、 ウ ィ ザー ド を再実行せずに、 標準
の PowerBuilder ア プ リ ケーシ ョ ン を使用 し て動かす こ と がで き ま す。
し か し 、ウ ィ ザー ド で生成 さ れた nvo_appname_mlsync オブジ ェ ク ト の
pb_run_dbmlsync お よ び pb_cancel_dbmlsync 関数内の ラ イ ブ ラ リ オ ブ
ジ ェ ク ト 参照を変更す る 必要があ り ます。 PowerBuilder 11 では こ れ ら
の関数の参照 ラ イ ブ ラ リ は pbodb110.dll (pbvm10.dll ではな く ) にな り
ます。
次の表では、 ウ ィ ザー ド で生成 さ れ る オブジ ェ ク ト をデフ ォ ル ト のオ
ブジ ェ ク ト 名で説明 し ます。 appname は現行のアプ リ ケーシ ョ ン の名
前です。
78
新機能
デー タ ベース接続の機能拡張および変更
デ フ ォル ト 名
nvo_appname_mlsync
説明
リ モ ー ト ク ラ イ ア ン ト か ら 同期 を 開始す る
MLSync 標準 ク ラ ス ユーザ オブ ジ ェ ク ト の イ
ン ス タ ン ス。 PowerBuilder 10 では、 こ れは単純
な非ビ ジ ュ アル ユーザ オブジ ェ ク ト で し た。
PowerBuilder 11 での名前の変更
ウ ィ ザー ド の以前のバー ジ ョ ン で使用 さ れ て
いた _sync デフ ォ ル ト 接尾辞は、_mlsync デフ ォ
ル ト 接尾辞に置 き 換え ら れます。
gf_appname_sync
w_appname_syncprogress
同期 を 開始す る た めに nvo_appname_mlsync を
イ ン ス タ ン ス化す る グ ロ ーバル関数。 こ の関数
は フ ィ ー ド バ ッ ク ウ ィ ン ド ウ を 使用 し て あ る
いは使用せずに、 同期を開始する ロ ジ ッ ク を含
みます。
ク ラ イ ア ン ト に同期 ス テ ー タ ス を 表示す る た
め に使用 さ れ る オ プ シ ョ ン の フ ィ ー ド バ ッ ク
ウィンドウ
PowerBuilder 11 での名前の変更
ウ ィ ザー ド の以前のバー ジ ョ ン で使用 さ れ て
いた _sync デフ ォ ル ト 接尾辞は、syncprogress デ
フ ォ ル ト 接尾辞に置 き 換え ら れます。
gf_appname_configure_sync
w_appname_sync_options
MLSync のイ ン ス タ ン
スの作成
w_appname_sync_options ウ ィ ン ド ウ を呼び出す
オ プ シ ョ ン の グ ロ ー バ ル 関 数。 ユ ー ザ が
dbmlsync ク ラ イ ア ン ト を 設定で き る よ う に し
ます。
ア プ リ ケーシ ョ ン ユーザが実行時に接続引数
を 変更で き る よ う にす る オ プ シ ョ ン の ウ ィ ン
ドウ
PowerBuilder 11 の新 し い MLSync シ ス テ ム オ ブ ジ ェ ク ト と 一緒に、
MobiLink 同期 ウ ィ ザー ド を使用 し て Dbmlsync.exe を起動す る 非ビ ジ ュ
アル オブ ジ ェ ク ト を 作成す る こ と はで き な く な り ま し た。 次の よ う
に、 アプ リ ケーシ ョ ン には MLSync オブジ ェ ク ト を含め る こ と がで き
ます。
•
PowerScript を使用 し てプ ロ グ ラ ム的に
MLSync オブ ジ ェ ク ト を プ ロ グ ラ ム で追加す る 方法を示す例につ
いては、 『アプ リ ケーシ ョ ン テ ク ニ ッ ク 』 マニ ュ アルの 「MobiLink
同期の使い方」 の章を参照 し て く だ さ い。
PowerBuilder 11
79
デー タ ベース接続の機能拡張お よび変更
•
新規作成 ダ イ ア ロ グ ボ ッ ク ス か ら 選択す る
MobiLink 同期の詳細については、 『ユーザーズ ガ イ ド 』 マニ ュ アルの
「デー タ ベース の管理」 の章お よ び 『アプ リ ケーシ ョ ン テ ク ニ ッ ク 』 マ
ニ ュ アルの 「MobiLink 同期の使い方」 の章を参照 し て く だ さ い。 同期
に関連す る シ ス テ ム オブジ ェ ク ト 、 お よ びその関数、 イ ベン ト 、 プ ロ
パ テ ィ の詳細につい て は、 オ ン ラ イ ン ヘルプ の MLSynchronization、
MLSync、 お よ び SyncParm を参照 し て く だ さ い。
MobiLink 同期の補助
オブ ジ ェ ク ト
PowerScript コ ー ド で あ る い は 新 規 作 成 ダ イ ア ロ グ ボ ッ ク ス か ら
MLSync の イ ン ス タ ン ス を作成す る 場合、 ウ ィ ザー ド に よ っ て自動的
に生成 さ れた り 、 PowerBuilder ウ ィ ン ド ウ ペ イ ン タ でカ ス タ マ イ ズで
き た り す る 補助オブジ ェ ク ト を使用す る こ と を考慮 し ます。
『アプ リ ケーシ ョ ン テ ク ニ ッ ク 』 マニ ュ アルの 「MobiLink 同期の使い
方」 の章には、 デフ ォ ル ト の進行状態、 オプシ ョ ン ウ ィ ン ド ウ 、 お よ
びそれ ら を カ ス タ マ イ ズす る ための提案を説明す る セ ク シ ョ ン があ り
ます。
Informix 10 のサポー ト
PowerBuilder 11 は、 Informix デー タ ベー ス のための新 し いデー タ ベー
ス イ ン タ フ ェ ー ス を 導入 し ま し た。 PBI10110.DLL 内 の I10 イ ン タ
フ ェ ー ス は、 Informix ア プ リ ケーシ ョ ン開発用に Informix Client SDK
2.9 以降を、 実行時配布用に Informix Connect 2.9 以降を必要 と し ます。
新 し い イ ン タ フ ェ ー ス は、 Unicode デー タ ベー ス へのア ク セ ス お よ び
IBM Informix Dynamic Server (IDS) の最新バージ ョ ン で使用可能ない
く つかの機能をサポー ト し ます。
制限
1 つの PowerBuilder セ ッ シ ョ ン で、 IN9 イ ン タ フ ェ ー ス と I10 イ ン タ
フ ェ ース の両方を使用す る こ と はで き ません。
Unicode デー タ のア ク セス
PowerBuilder は、 IN9 イ ン タ フ ェース を使用 し て、 ANSI/DBCS デー タ
ベー ス のデー タ に対す る 接続、 保存、 お よ び検索を行 う こ と がで き ま
すが、 IN9 イ ン タ フ ェ ー ス は Unicode デー タ ベー ス を サポー ト し てい
ません。 Informix I10 イ ン タ フ ェ ー ス は、 ANSI/DBCS デー タ ベー ス お
よ び Unicode デー タ ベース をサポー ト し てい ます。
80
新機能
デー タ ベース接続の機能拡張および変更
I10 ネ イ テ ィ ブ イ ン タ フ ェース では、 広域言語サポー ト (GLS: Global
Language Support) を目的 と し て、Informix GLS API を使用 し てい ます。
ネ イ テ ィ ブ イ ン タ フ ェース は、 次の 3 つの DBParms を使用 し て、 現行
接続で使用す る ロ ケールを設定 し ます。
•
Client_Locale
•
DB_Locale
•
StrByCharset
こ れ ら のパ ラ メ ー タ は、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の
[地域の設定] タ ブ ページで設定で き ます。
Client_Locale
Client_Locale は、 Informix 環境変数 CLIENT_LOCALE の値を指定 し ま
す。 書式は language_territory.codeset です。 た と えば、 以下の よ う に指
定 し ます。
Client_Locale='en_us.1252'
Client_Locale='en_us.utf8'
Client_Locale='ja_jp.utf8'
I10 イ ン タ フ ェ ース は、 こ の設定を使用 し て、 Informix デー タ ベース の
文字列デー タ にア ク セ ス し 、 SQL 文を処理 し ます。DBParm を設定 し な
い場合、 デフ ォ ル ト の ロ ケール値は、 OS の ロ ケールに基づ き ます。
DB_Locale
DB_Locale は、 Informix 環境変数 DB_LOCALE の値を指定 し ます。 形
式は language_territory.codeset です。 次に例を示 し ます。
DB_Locale='en_us.1252'
DB_Locale='en_us.utf8'
DB_Locale='ja_jp.utf8'
DB_LOCALE は、 デー タ ベー ス サーバが特定のデー タ ベー ス での ロ
ケールに依存 し たデー タ 型の解釈に必要な、 言語、 地域、 お よ び コ ー
ド セ ッ ト を指定 し ます。こ れ ら のデー タ 型には、 NChar お よ び NVarChar
な ど が あ り ま す。 DB_LOCALE に指定 さ れた コ ー ド セ ッ ト を 使用 し
て、 すべての文字カ ラ ム の文字、 ま たはデー タ ベー ス、 テーブル、 カ
ラ ム、 ビ ュ ーな どデー タ ベース オブジ ェ ク ト の名前が有効か ど う か を
判 断 し ま す。 DBParm を 設 定 し な い 場 合、 I10 イ ン タ フ ェ ー ス は、
DB_LOCALE の値は CLIENT_LOCALE の値 と 同一 と みな し ます。
CLIENT_LOCALE 環境変数お よ び DB_LOCALE 環境変数は、 Informix
デー タ ベー ス イ ン タ フ ェ ー ス 用 の Utilities フ ォ ル ダ で 使用 で き る
Informix Setnet32 ユーテ ィ リ テ ィ を使用 し て、 デー タ ベー ス ペ イ ン タ
のオブジ ェ ク ト ビ ュ ーま たは DB プ ロ フ ァ イ ル ダ イ ア ロ グ ボ ッ ク ス で
直接設定で き ます。
PowerBuilder 11
81
デー タ ベース接続の機能拡張お よび変更
Informix の CLIENT_LOCALE 環境変数お よ び DB_LOCALE 環境変数
の詳細については、 Informix library Web サイ ト
http://publib.boulder.ibm.com/epubs/pdf/b8886700.pdf の 『IBM Informix GLS
ユーザーズガ イ ド 』 を参照 し て く だ さ い。
StrByCharset
StrByCharset DBParm は、 PowerBuilder Unicode 文字列 と Informix ク ラ
イ ア ン ト のマルチバ イ ト 文字列 と の文字列デー タ の変換方法を指定 し
ま す。 デ フ ォ ル ト では、 UTF-8 コ ー ド セ ッ ト の文字列変換は UTF-8
コ ー ド セ ッ ト に基づいて実行 さ れ、UTF-8 コ ー ド セ ッ ト 以外の文字列
変 換 は、 現 行 の OS の コ ー ド ペ ー ジ に 基 づ い て 実 行 さ れ ま す。
StrByCharset が 1 (true) に設定 さ れてい る 場合、文字列変換は、DBParm
Client_Locale で指定 さ れた コ ー ド セ ッ ト に基づいて実行 さ れ ます。
PowerBuilder カ タ ログ テーブルへのオーナーの割 り 当て
I10 イ ン タ フ ェ ー ス を 使 用 す る 場 合、 [シ ス テ ム] タ ブ ペ ー ジ の
[PowerBuilder カ タ ロ グ テーブル オーナー](PBCatalogOwner DBParm)
を使用 し て、 拡張属性シ ス テ ム テーブルにデフ ォ ル ト 以外のオーナー
を割 り 当て る こ と がで き ます。 ANSI 準拠のデー タ ベース の場合、 指定
す る オーナー名は固有であ る 必要があ り ますが、 テーブル名は固有で
あ る 必要はあ り ません。 異な る ユーザ名で始ま る カ タ ロ グ テーブルの
複数のセ ッ ト を作成で き ます。 ただ し 、 デー タ ベース が ANSI 準拠で
ない場合は、 テーブル名は固有で あ る 必要があ り ま す。 つま り 、 オー
ナー名が割 り 当て ら れた カ タ ロ グ テーブルのセ ッ ト を 1 つだけ作成す
る こ と がで き ます。
長いオブ ジ ェ ク ト 名のサポー ト
I10 イ ン タ フ ェ ース は、 128 文字ま での Informix の長いオブジ ェ ク ト 名
をサポー ト し ます。
イ ンデ ッ ク スの名前の変更
IDS 9.2.1 以降では、 I10 イ ン タ フ ェ ース を使用 し て接続 し てい る 場合、
デー タ ベー ス ペ イ ン タ で イ ンデ ッ ク ス の名前を変更で き ます。 I10 イ
ン タ フ ェース で IDS RENAME INDEX 文を使用 し て、 イ ンデ ッ ク ス の
名前を変更 し ます。 ほかの変更を行 う 場合は、 イ ンデ ッ ク ス を削除 し
て再度作成す る 必要があ り ます。
82
新機能
デー タ ベース接続の機能拡張および変更
SQL ス テー ト メ ン ト キ ャ ッ シ ュ
IDS 9.2.1 以降では、デー タ ベース サーバは SQL ス テー ト メ ン ト キ ャ ッ
シ ュ (SSC) を使用 し て、 ユーザのセ ッ シ ョ ンが終了す る ま で SQL ス
テー ト メ ン ト を格納 し ます。ユーザが SQL ス テー ト メ ン ト キ ャ ッ シ ュ
に格納 さ れてい る SQL ス テー ト メ ン ト を実行す る 場合、 デー タ ベース
サーバは ス テー ト メ ン ト の解析お よ び最適化を再度行 う こ と はあ り ま
せん。 その結果、 パ フ ォ ーマ ン ス が向上 し ます。 キ ャ ッ シ ュ に格納で
き る のは、 SELECT 文、 UPDATE 文、 DELETE 文、 INSERT 文のみで、 こ
れ ら の ス テー ト メ ン ト にユーザ定義のルーチン を含め る こ と はで き ま
せん。
サ ー バ の キ ャ ッ シ ュ を 設 定 す る 方 法 は、 い く つ か あ り ま す。 SET
STATEMENT CACHE 文は、 STMT_CACHE 環境変数お よ び
STMT_CACHE 設定パ ラ メ ー タ よ り 優先 さ れ ま す。 SET STATEMENT
CACHE 文を正常に実行で き る よ う に、 事前に、 STMT_CACHE 設定パ
ラ メ ー タ を 設定す る か Informix onmode ユー テ ィ リ テ ィ を 使用 し て、
SQL ス テー ト メ ン ト キ ャ ッ シ ュ を有効にす る 必要があ り ます。
I10 接続の、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の [シ ス テ ム]
タ ブ ページで [SQL ス テー ト メ ン ト キ ャ ッ シ ュ の有効化] (StmtCache
DBParm) を設定 し て、 ク ラ イ ア ン ト での SQL ス テー ト メ ン ト キ ャ ッ
シ ュ を オ ン ま たはオ フ に し ます。ただ し 、ク ラ イ ア ン ト か ら キ ャ ッ シ ュ
にア ク セ ス す る 前に、 サーバで SQL ス テー ト メ ン ト キ ャ ッ シ ュ を サ
ポー ト す る よ う に設定す る 必要があ り ます。
Informix SQL ス テー ト メ ン ト キ ャ ッ シ ュ の詳細については、 IBM
Informix Dynamic Server パフ ォ ーマ ン ス ガ イ ド
http://publib.boulder.ibm.com/epubs/pdf/b8886780.pdf を参照 し て く だ さ い。
ロ ッ ク せずに イ ンデ ッ ク スの作成 と 削除
IDS 10.0 以降では、 CREATE INDEX お よ び DROP INDEX の SQL 構文は
ONLINE キー ワ ー ド を サポー ト し ます。 こ のキー ワ ー ド を使用す る と 、
デー タ ベー ス と そ の テーブルが継続的に使用可能な オ ン ラ イ ン 環境
で、 イ ンデ ッ ク ス の作成 と 削除を実行で き ます。 ONLINE キー ワー ド を
使用 し て イ ンデ ッ ク ス の作成 ま たは削除を実行 し た場合、 デー タ 定義
言語 (DDL) 処理は、 指定 し た イ ンデ ッ ク ス が定義 さ れた テーブルで
排他 ロ ッ ク を行わずに実行 し ます。
PowerBuilder 11
83
デー タ ベース接続の機能拡張お よび変更
CREATE INDEX ONLINE を使用 し て、 ほかのユーザがア ク セ ス中のテー
ブルで イ ンデ ッ ク ス を作成 し た場合、 ほかのユーザのテーブル更新が
終了す る ま で、 作成 し た イ ン デ ッ ク ス は有効 に な り ま せ ん。 DROP
INDEX ONLINE を発行 し て イ ンデ ッ ク ス を削除 し た場合、 ユーザはその
イ ンデ ッ ク ス を参照で き ませんが、 同時デー タ 操作言語 (DML) 処理
は、 処理が終了す る ま でその イ ンデ ッ ク ス を使用で き ます。 イ ンデ ッ
ク ス の削除は、 すべてのユーザがその イ ンデ ッ ク ス の使用を終了す る
ま で延期 さ れ ます。
I10 接続の、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の [シ ス テ ム]
タ ブ ページ で [非 ク ラ ス タ 化 イ ン デ ッ ク ス の作成 ま たは削除の際に
テーブルを ロ ッ ク し ない] (OnlineIndex 静的 DBParm) を設定 し て、 イ
ンデ ッ ク ス を作成 し た り 削除 し た り す る 場合に、 デー タ ベース ペ イ ン
タ が必ず ONLINE キー ワー ド を使用す る よ う に指定 し ます。
サポー ト さ れていない ク ラ ス タ 化イ ンデ ッ ク ス
ク ラ ス タ 化 イ ンデ ッ ク ス は、 オ ン ラ イ ン モー ド を使用 し て作成で き ま
せん。 こ れは、 IDS でサポー ト さ れていないためです。
カ ラ ム レ ベルの暗号化
IDS 10.0 以降では、SQL 文 SET ENCRYPTION PASSWORD を使用す る と 、
カ ラ ム レ ベルでデー タ を 暗号化お よ び復号化す る ためのパ ス ワ ー ド
を定義 し た り 再設定 し た り す る こ と に よ っ て、 デー タ の機密性を向上
さ せ、 デー タ の整合性を サポー ト で き ます。
I10 接続の、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の [シ ス テ ム]
タ ブ ページ で [暗号化パ ス ワ ー ド ] (EncryptionPass DBParm) お よ び
[ ヒ ン ト ] (Hint DBParm) を設定 し て、 パ ス ワー ド 、 お よ びパ ス ワー ド
を 思 い 出す た め の ヒ ン ト を 指定 で き ま す。 ア プ リ ケ ー シ ョ ン で は
Informix の組み込み関数を使用 し て、 文字デー タ の暗号化 と 復号化を
行い ます。
84
新機能
ユーザ定義ルーチ ン での複数の OUT パラ メ ー タ の使い方
ユーザ定義ルーチン (UDR) では、 OUT パ ラ メ ー タ は、 ポ イ ン タ を介
し て返 さ れた値に対応 し ます。 IDS バージ ョ ン 9.4 よ り 前では、 1 つの
UDR での複数の OUT パ ラ メ ー タ はサポー ト し てい ませんで し た。 さ
ら に、 OUT パ ラ メ ー タ は、 パ ラ メ ー タ リ ス ト の最後の項目 と し て登録
す る 必要があ り ま し た。 IDS バージ ョ ン 9.4 で こ の制限がな く な り 、 複
数の OUT パ ラ メ ー タ がサポー ト さ れ、 UDR のパ ラ メ ー タ リ ス ト の ど
の位置で も 有効にな り ま し た。 こ の機能は、 I10 イ ン タ フ ェース を使用
す る 場合に有効にな り ます。 こ れに よ っ て、 UDR の定義におけ る 柔軟
性が向上 し 、 複数の戻 り 値が必要な コ ン テ キ ス ト に コ レ ク シ ョ ン変数
を返す必要がな く な り ま し た。
UDR か ら OUT パ ラ メ ー タ を返すには、 ス テー ト メ ン ト の ロ ーカル変
数 (SLV) を使用す る 必要があ り ます。 次の ス テー ト メ ン ト では、 UDR
myfunc の OUT パ ラ メ ー タ が、SLV 構文 slvname#out_param_type を使用
し て定義 さ れてい ます。
SELECT sales FROM mytable WHERE myfunc(10, sales#money)
< 1000
Informix では、 EXECUTE 文 を 使用す る 、 OUT パ ラ メ ー タ を 指定 し た
UDR の呼び出 し を サポー ト し てい ま せん。 し たが っ て、 複数の OUT
パ ラ メ ー タ は、 PowerBuilder の リ モー ト プ ロ シージ ャ コ ール (RPC)
お よ び埋め込み SQL EXECUTE PROCEDURE コ マ ン ド ではサポー ト さ
れません。
JDK 1.5 のサポー ト
PowerBuilder 11 は、 EAServer 6.0 お よ びほかのアプ リ ケーシ ョ ン サー
バ と の互換のために JDK 1.5 を サポー ト し ます。
85
JDK 1.5 のサポー ト
86