dwprgug_110

PowerBuilder

®

11.0

DOCUMENT ID: DC37775-01-1100-01 LAST REVISED: May 2007

Copyright © 1991-2008 by Sybase, Inc. All rights reserved.

本書は Sybase ソ フ ト ウ ェ アの付属マニ ュ アルであ り 、 新 し いマニ ュ アルま たはテ ク ニ カル ノ ー ト で特に示 さ れないかぎ り 、 後続の リ リ ース に も 付属 し ます。 こ のマニ ュ アルの内容は、 予告な く 変更 さ れ る こ と があ り ますが、Sybase,Inc. お よ びその関連会社では内容の変更に関 し て一切の責任を負い ません。 こ のマニ ュ アルに記載 さ れてい る ソ フ ト ウ ェ アは ラ イ セ ン ス契約に基づいて提供 さ れ る も のであ り 、 無断で使用す る こ と はで き ません。 予定 し た ソ フ ト ウ ェ アの リ リ ース日にのみア ッ プグ レー ド を提供 し ます。 本書に記載 さ れてい る 内容は、Sybase, Inc. お よ びその関連会社の書面に よ る 事前許可を得ずに、 電子的、 機械的、 手作業、 光学的、 ま たはその他のいかな る 手段に よ っ て も 複製、 転載、 翻訳す る こ と を禁 じ ます。

Sybase の商標は Sybase の商標ページ のサイ ト http://www.sybase.com/detail?id=1011207 に記載 さ れてい ます。 記載の Sybase お よ びマー ク は Sybase, Inc の商標です。 ® はア メ リ カ合衆国におけ る 登録商標を示 し ます。

Java お よ びすべての Java ベース のマー ク は、 米国お よ び他国におけ る Sun Microsystems, Inc. の商標ま たは登録商標です。 Unicode お よ び Unicode の ロ ゴは Unicode, Inc. の登録商標です。

本書で記載 さ れてい る 上記以外の社名お よ び製品名は、 各社の商標ま たは登録商標の場合があ り ます。

本書に記載 さ れてい る 内容は、 将来予告な し に変更す る こ と があ り ます。 ま た、 本 ソ フ ト ウ ェ アお よ び説明書を使用 し た こ と に よ る 損害、 ま たは第三者か ら のいかな る 請求について も 、 サ イ ベース株式会社、 その親会社であ る 米国法人 Sybase, Inc. ま たはその関連会社は、 一切の責任を負わない も の と し ます。

本書について... ix 第 1 部 デー タ ウ ィ ン ド ウ と デー タ ス ト アの基本 第1 章 デー タ ウ ィ ン ド ウ テ ク ノ ロ ジについて ... 3 デー タ ウ ィ ン ド ウ オブジ ェ ク ト 、 コ ン ト ロール、 コ ンポーネン ト に ついて... 3 提示様式 と デー タ ソ ース ... 6 基本的な プ ロ セス... 7 デー タ ウ ィ ン ド ウ テ ク ノ ロ ジの選択... 8 ク ラ イ ア ン ト/ サーバ アプ リ ケーシ ョ ンおよび分散ア プ リ ケー シ ョ ンの ソ リ ュ ーシ ョ ン... 9 Web アプ リ ケーシ ョ ンのソ リ ュ ーシ ョ ン ... 9 PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロール ... 12 第2 章 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の使い方 ... 15 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の使い方について ... 16 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のコ ン ト ロールへの取 り 込み ... 17 デー タ ウ ィ ン ド ウ コ ン ト ロール と デー タ ウ ィ ン ド ウ オブジ ェ ク ト の名前... 18 PowerBuilder でのデー タ ウ ィ ン ド ウ コ ン ト ロールの操作... 19 実行段階でのデー タ ウ ィ ン ド ウ オブジ ェ ク ト の指定... 21 デー タ ベースへのア ク セス... 24 デー タ ウ ィ ン ド ウ コ ン ト ロールへの ト ラ ンザク シ ョ ン オブジ ェ ク ト の設定... 25 デー タ の検索 と 更新... 29 Web サービ ス デー タ ソ ースへのア ク セス ... 33 外部 ソ ースから のデー タ のイ ンポー ト... 33 デー タ ウ ィ ン ド ウ コ ン ト ロールのデー タ の操作... 34 デー タ ウ ィ ン ド ウ コ ン ト ロールのデー タ 管理方法 ... 34 エデ ィ ッ ト コ ン ト ロールのテキス ト へのア ク セス ... 37 エデ ィ ッ ト コ ン ト ロールのテキス ト の操作 ... 38 ItemChanged イ ベン ト のス ク リ プ ト の記述 ... 38

目次 ItemError イ ベン ト のス ク リ プ ト の記述... 39 デー タ ウ ィ ン ド ウの項目へのア ク セス... 39 ほかのデー タ ウ ィ ン ド ウ メ ソ ッ ド の使い方 ... 42 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のプ ロパテ ィ へのア ク セス... 43 デー タ ウ ィ ン ド ウ エ ラ ーの処理... 45 検索および更新エ ラ ー と DBError イ ベン ト ... 45 プ ロパテ ィ 式およびデー タ 式のエ ラ ー と Error イ ベン ト ... 49 デー タ ベースの更新... 51 デー タ ウ ィ ン ド ウ コ ン ト ロールによ るデー タ ベースの更新方法 51 プ ログ ラ ムによ る行またはカ ラ ムのス テー タ スの変更... 54 レ ポー ト の作成... 55 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の計画 と 構築 ... 56 レポー ト の印刷... 56 ネス テ ィ ッ ド レポー ト の使い方... 57 ク ロ ス タ ブの使い方... 60 元にな るデー タ の表示... 60 ユーザによ る ク ロ ス タ ブの再定義... 61 実行段階での ク ロ ス タ ブのプ ロパテ ィ の修正... 63 HTML の生成... 64 表示の制御... 68 SaveAs メ ソ ッ ド の呼び出 し ... 71 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の HTML フ ォ ーム と し ての表示 72 第3 章 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の動的変更 ... 77 動的なデー タ ウ ィ ン ド ウの処理について... 77 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の修正 ... 78 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の作成 ... 80 ユーザへの ク エ リ 機能の提供... 83 ク エ リ モー ド の仕組み ... 83 ク エ リ モー ド の使い方 ... 85 ヘルプ ボ タ ンの使用... 88 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の再利用 ... 89 第4 章 デー タ ス ト ア オブ ジ ェ ク ト の使い方 ... 91 デー タ ス ト アについて... 91 デー タ ス ト アの操作... 95 カ ス タ ム デー タ ス ト ア オブジ ェ ク ト の使い方 ... 95 デー タ ス ト アにおけるデー タ のア ク セス と 操作... 97 デー タ の共有... 100 例 : デー タ ス ト アからのデー タ の印刷 ... 101

第5 章 グ ラ フの操作 ... 107 グ ラ フ の使い方... 107 グ ラ フ のプ ロパテ ィ の修正... 108 グ ラ フ要素の表示... 109 グ ラ フ要素の参照... 110 デー タ のプ ロパテ ィ へのア ク セス... 111 デー タ の情報の取得... 111 グ ラ フのデー タ の保存... 114 色、 模様、 そのほかのデー タ の修正... 115 グ ラ フ メ ソ ッ ド の使い方... 116 ポ イ ン ト ア ン ド ク リ ッ クの使い方 ... 119 第 2 部 JSP と WEB ア プ リ ケーシ ョ ン でのデー タ ウ ィ ン ド ウの使い方 第6 章 Web デー タ ウ ィ ン ド ウの使い方 ... 125 Web デー タ ウ ィ ン ド ウ と は... 125 Web デー タ ウ ィ ン ド ウの種類 ... 126 Web デー タ ウ ィ ン ド ウの仕組み... 127 Web デー タ ウ ィ ン ド ウのサーバ コ ンポーネン ト と ク ラ イ ア ン ト コ ン ト ロール... 129 XML Web デー タ ウ ィ ン ド ウの使い方 ... 132 XML、 XSLT、 CSS、 および XHTML について ... 133 XML Web デー タ ウ ィ ン ド ウの仕組み ... 134 XML Web デー タ ウ ィ ン ド ウの使い方 ... 138 Web デー タ ウ ィ ン ド ウ用のデー タ ウ ィ ン ド ウ オブジ ェ ク ト の設計.. 140 Web デー タ ウ ィ ン ド ウのプ ロパテ ィ ... 143 生成 さ れる コ ー ド のサイ ズの制御... 150 ド ロ ッ プダウン デー タ ウ ィ ン ド ウの使い方 ... 151 コ ールバ ッ ク および ク ラ イ ア ン ト サイ ド ページ ングのサポー ト 152 Web デー タ ウ ィ ン ド ウ メ ソ ッ ド への JavaScript キ ャ ッ シ ュの使 い方... 153 式の使い方... 157 外国語文字セ ッ ト の使い方... 158 デー タ の リ ン ク の実現... 159 HTML Web デー タ ウ ィ ン ド ウ内のコ ン ト ロールに対する HTML の レ ン ダ リ ング... 159 ボ タ ン コ ン ト ロール と ピ ク チ ャ コ ン ト ロールの使い方 ... 160 特定のブ ラ ウザ用の Web 生成の指定... 163 デー タ ウ ィ ン ド ウのプ レ ビ ュ ー... 164 Web デー タ ウ ィ ン ド ウ デザイ ン タ イム コ ン ト ロール プ ロパテ ィ の設 定... 165

目次 デー タ ベース接続の設定... 168 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のコ ンポーネン ト サーバへの配布.. 170 Web デー タ ウ ィ ン ド ウ コ ン テナ プ ロ ジ ェ ク ト ウ ィ ザー ド 170 Web ページ テ ン プ レー ト の作成... 173 ク ラ イ ア ン ト サイ ド ス ク リ プ ト の記述 ... 176 生成 さ れる Web デー タ ウ ィ ン ド ウのカ ス タ マ イズ... 179 XHTML エ ク スポー ト テ ン プ レー ト ビ ュ ー ... 179 カ ス タ マ イ ズで き る部分... 180 デ フ ォル ト の XHTML エ ク スポー ト テ ン プ レー ト ... 181 テ ン プ レー ト の管理... 182 テ ン プ レー ト 構造... 187 XHTML エ ク スポー ト テ ン プ レー ト の編集 ... 190 実行時の XHTML エ ク スポー ト テ ン プ レー ト 選択 ... 196 XML および XSLT、 または XHTML でのデー タ ウ ィ ン ド ウ Web フ ォ ームのエ ク スポー ト... 197 第7 章 Web デー タ ウ ィ ン ド ウのサーバ サイ ド プ ロ セス ... 199 サーバ構成の要件... 199 サーバ コ ンポーネン ト のイ ン ス タ ン ス化 と 設定... 204 コ ンポーネ ン ト のイ ン ス タ ン ス化... 206 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト のロー ド ... 207 生成内容の制御... 208 デー タ ベース接続の指定 と デー タ 検索... 210 リ ロー ド さ れたページにページ固有のデー タ を渡す... 212 サーバ コ ンポーネン ト にユーザ ア ク シ ョ ン を渡す ... 215 ページへの生成 さ れた HTML または XHTML の挿入... 216 カ ス タ ム サーバ コ ンポーネン ト の使い方 ... 217 EAServer でのカ ス タ ム サーバ コ ンポーネン ト の作成... 219 EAServer でのカ ス タ ム コ ンポーネン ト のプ ロパテ ィ の設定 221 カ ス タ ム コ ンポーネン ト のイ ン ス タ ン ス化 ... 224 サーバ上での状態の保持... 226 サービ ス ク ラ スの使い方... 228 PowerBuilder コ ンポーネン ト に対するサービ ス ク ラ スの定義 .. 229 Java コ ンポーネン ト に対するサービ ス ク ラ スの定義 ... 232 第8 章 デー タ ウ ィ ン ド ウ Web コ ン ト ロール ActiveX の使い方... 235 Web ActiveX について ... 235 Web ページに コ ン ト ロールを挿入する HTML ... 239 Object 要素... 240 プ ロパテ ィ と Param 要素 ... 242

Web ActiveX 対応のデー タ ウ ィ ン ド ウ オブジ ェ ク ト ... 246 デー タ ウ ィ ン ド ウ オブジ ェ ク ト に取 り 込む こ と がで き る内容 246 PowerBuilder ラ イ ブ ラ リ 内でのデー タ ウ ィ ン ド ウ オブジ ェ ク ト の 管理... 246 コ ン ト ロールに対するデー タ ウ ィ ン ド ウ オブジ ェ ク ト の指定 248 デー タ ウ ィ ン ド ウ ト ラ ンザク シ ョ ン オブジ ェ ク ト コ ン ト ロールの使 い方... 249 デー タ ベース と の接続... 250 デー タ ベース と の接続 と デー タ の検索... 252 Web ActiveX 用ス ク リ プ ト の記述 ... 252 メ ソ ッ ド の引数および戻 り 値のデー タ 型... 253 イ ベン ト の リ タ ーン コ ー ド の設定 ... 254 Web ActiveX の配布... 254 索引... 257

目的 _{こ のマニ ュ アルでは、 ク ラ イ ア ン ト / サーバ アプ リ ケーシ ョ ン、 分} 散アプ リ ケーシ ョ ン、Web アプ リ ケーシ ョ ンにおけ る DataWindow® テ ク ノ ロ ジの使い方について説明 し ま す。 特に、 作成す る ア プ リ ケーシ ョ ンに合わせてデー タ ウ ィ ン ド ウ オブジ ェ ク ト を定義する 方法、 定義 し たデー タ ウ ィ ン ド ウ オブジ ェ ク ト と 対話する ための コー ド を作成する方法について説明し ます。 対象 と する読者 _{こ のマニ ュ アルは、 デー タ ウ ィ ン ド ウ テ ク ノ ロ ジ を使用す る アプ} リ ケーシ ョ ン の開発者を対象に し てい ま す。 ま た以下を前提 と し てい ます。 • デー タ ウ ィ ン ド ウ ペ イ ン タ に精通 し てい る こ と 。 デー タ ウ ィ ン ド ウ ペ イ ン タ については、 PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アルを参照 し て く だ さ い。 • 開発環境に対応 し た プ ロ グ ラ ミ ン グ言語について基本的な知 識 を 持 っ て い る こ と 。 対 象 と な る 言 語 は、 PowerScript®、 JavaScript、 お よ び Java です。 こ れ ら の言語に関す る 知識がな い場合は、 PowerBuilder® のマニ ュ アルお よ び目的の言語に関 す る 参考資料を参照 し て く だ さ い。 そのほかの情報 製品に関す る そのほかの詳細情報については、 PowerBuilder DVD、 ア シ ス ト Web サ イ ト 、 お よ び Sybase 製品マニ ュ アル Web サ イ ト （英語） を参照 し て く だ さ い。

• PowerBuilder DVD には、製品マニ ュ アルが収め ら れてい ま す。 製品マニ ュ アルは、 PDF 形式で提供 し てい ます。 PDF フ ァ イ ルを読んだ り 、 印刷 し た り す る には、 Adobe Acrobat Reader が 必要です。 Adobe Acrobat Reader は、 Adobe Web サ イ ト か ら 無 料でダ ウ ン ロ ー ド す る こ と がで き ます。 • ア シ ス ト Web サ イ ト には、 標準の Web ブ ラ ウ ザでア ク セ スす る こ と がで き る オ ン ラ イ ン版のマ ニ ュ アルが あ り ま す。 こ の Web サ イ ト では、 PDF お よ び HTML 形式でマニ ュ アルを見 る こ と がで き ます。 オ ン ラ イ ン版のマニ ュ アルには、 ア シ ス ト のPowerBuilder のサ イ ト http://www.ashisuto.co.jp/prod/powerbuilder/ にあ る 「技術情報」 か ら ア ク セ ス で き ます。

• Sybase 製品マニ ュ アル Web サ イ ト （英語） は、 標準の Web ブ ラ ウ ザか ら ア ク セ ス で き 、 Sybase の製品マニ ュ アルのほか、 EBF/ メ ン テナン ス、 技術文書な どへの リ ン ク も 含んでい ます。

Sybase 製品マ ニ ュ ア ル Web サ イ ト には、Product Manuals のサ イ ト http://www.sybase.com/support/manuals/ か ら ア ク セ ス で き ます。

ト アの基本

第 1 部では、デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト およびデー タ ス ト ア オブジ ェ ク ト を作成、 使用する方法を記述 し ます。 こ れ ら の オ ブ ジ ェ ク ト お よ び デ ー タ ウ ィ ン ド ウ コ ン ト ロールの追加情報については、『ユーザーズ ガ イ ド』 マニ ュ アルおよび 『ア プ リ ケーシ ョ ン テ ク ニ ッ ク』 マニ ュ アルで 入手で き ま す。 リ フ ァ レ ン ス情報は、 『デー タ ウ ィ ン ド ウ リ フ ァ レ ン ス』 マニ ュ アルおよびオ ン ラ イ ン ヘルプで入手 で き ます。

ついて

こ の章について こ の章では、デー タ ウ ィ ン ド ウ オブジ ェ ク ト について説明 し ます。 ま た、 各種のアプ リ ケーシ ョ ン アーキテ ク チ ャやプ ロ グ ラ ミ ン グ 環境でデー タ ウ ィ ン ド ウ を使用す る 方法について も 説明 し ます。 内容

デー タ ウ ィ ン ド ウ

オブジ ェ ク ト 、 コ ン ト ロール、

コ ンポーネ ン ト について

データ ウ ィ ン ド ウ テ ク ノ ロ ジ は、 以下の 2 つの要素に実装さ れ ま す。 • デー タ ウ ィ ン ド ウ オブジ ェ ク ト デー タ ウ ィ ン ド ウ オブジ ェ ク ト は、 デー タ ソ ース と デー タ の提示様式を定義 し ます。 • データ ウィ ン ド ウ コ ン ト ロ ールまたはコ ン ポーネン ト コ ン ト ロ ー ルや コ ン ポーネ ン ト は、 ア プ リ ケーシ ョ ン に配置す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト の コ ン テナです。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を操作す る には、 コ ン テナの メ ソ ッ ド を呼び出 す コ ー ド を記述 し ます。 項目 ページ デー タ ウ ィ ン ド ウ オブジ ェ ク ト 、 コ ン ト ロール、 コ ンポーネ ン ト について 3 デー タ ウ ィ ン ド ウ テ ク ノ ロ ジの選択 8 PowerBuilder データ ウ ィ ン ド ウ コ ン ト ロール 12

デー タ ウ ィ ン ド ウ オブジ ェ ク ト 、 コ ン ト ロール、 コ ンポーネン ト について デー タ ウ ィ ン ド ウ コ ン ト ロールおよび コ ンポーネ ン ト 当初、 デー タ ウ ィ ン ド ウ は、 ク ラ イ ア ン ト / サーバ アプ リ ケーシ ョ ン におけ る デー タ 検索、 デー タ 操作、 お よ びデー タ 更新の強力な機能を PowerBuilder で実現す る こ と を目的に設計 さ れ ま し た。 現在、 デー タ ウ ィ ン ド ウ は複数の環境で使用で き ます。 • PowerBuilder デー タ ウ ィ ン ド ウ ク ラ イ アン ト / サーバ型およ び分散 型 PowerBuilder アプリ ケ ーショ ン で使用さ れる PowerBuilder コ ン ト ロ ールです。 • Web デー タ ウ ィ ン ド ウ Web アプ リ ケーシ ョ ンのためのシ ン ク ラ イ ア ン ト デー タ ウ ィ ン ド ウ の実装。 PowerBuilder デー タ ウ ィ ン ド ウ のデー タ 操作機能、 表示機能、 お よ び ス ク リ プ ト 機能の大部分を 備え てい ます。 コ ン ポーネ ン ト サーバ側には Web デー タ ウ ィ ン ド ウ コ ン ポーネ ン ト が必要ですが、 ク ラ イ ア ン ト 側に PowerBuilder DLL は必要あ り ません。 Web デー タ ウ ィ ン ド ウ は、 以下の 3 つの 方法で実装す る こ と がで き ます。 • XML Web デー タ ウ ィ ン ド ウ XML （内容）、XSLT （レ イ ア ウ ト ）、 CSS （表示様式） の 3 つに分けて記述 し 、 XHTML に変換 し て 利用 • XHTML Web デー タ ウ ィ ン ド ウ XHTML • HTML Web デー タ ウ ィ ン ド ウ HTML • Web デー タ ウ ィ ン ド ウ DTC 開発に使用す る マ シ ン 上で Web デー タ ウ ィ ン ド ウ を 表現す る た め のデザ イ ン タ イ ム コ ン ト ロ ール。 DTC と は、コ ン ポーネ ン ト サーバ上のデー タ ウ ィ ン ド ウ コ ンポー ネ ン ト に対 し て命令セ ッ ト を生成す る ActiveX コ ン ト ロールです。 コ ン ポーネ ン ト は、 ク ラ イ ア ン ト ブ ラ ウ ザに表示 さ れ る Web デー タ ウ ィ ン ド ウ を生成 し ます。 ク ラ イ ア ン ト ブ ラ ウ ザは、ActiveX コ ン ト ロ ールを サポー ト し ていな く て も 、Web デー タ ウ ィ ン ド ウ を 表示で き ます。

• Sybase デー タ ウ ィ ン ド ウ Web コ ン ト ロール ActiveX Web ペー ジ 上 で 使用す る ActiveX コ ン ト ロ ール。 ク ラ イ ア ン ト ブ ラ ウ ザ は、 ActiveX コ ン ト ロ ールをサポー ト し ていない と 、 こ の コ ン ト ロ ール で使用 さ れ る デー タ ウ ィ ン ド ウ オブジ ェ ク ト を表示で き ません。 • デー タ ウ ィ ン ド ウ プ ラ グ イ ン Powersoft レ ポー ト を表示す る ための ブ ラ ウ ザ プ ラ グ イ ンです。 各環境の比較については、8 ページの 「デー タ ウ ィ ン ド ウ テ ク ノ ロ ジ の選択」 を参照 し て く だ さ い。

デー タ ウ ィ ン ド ウ オブジ ェ ク ト の コ ン テナ と し て、デー タ ス ト ア オブ ジ ェ ク ト を使用す る こ と も で き ます。 デー タ ス ト アは、 デー タ 検索や デー タ 操作な ど のデー タ ウ ィ ン ド ウ の機能を、 画面出力を行わずに実 現 し ます。 印刷時の レ イ ア ウ ト 指定、 分散アプ リ ケーシ ョ ン のサーバ コ ン ポーネ ン ト でのデー タ 管理な ど にデー タ ス ト ア を使用で き ます。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト と は デー タ ウ ィ ン ド ウ オブジ ェ ク ト は、 データ の検索、 表示、 操作を行 う_{ためのオブジ ェ ク ト です。 デー タ ウ ィ ン ド ウ で扱 う デー タ は、 リ レー} シ ョ ナル データ ベースや、そのほかのデー タ ソ ース （Excel ワー ク シー ト 、dBASE フ ァ イ ルな ど） か ら 読み込まれます。 デー タ の更新につい ては、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト でサポー ト する かど う かを指定 で き ます。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト には、 検索対象のデー タ に関する情報 が格納 さ れ ます。 ユーザが効率的にデー タ を操作で き る よ う に、 表示 書式や提示様式な ど のデー タ プ ロ パテ ィ を指定で き ます。 デー タ ウ ィ ン ド ウ ペ イ ン タ では、 Powersoft レ ポー ト （PSR） フ ァ イ ル を作成す る こ と も で き ます。PSR フ ァ イ ルは、 デー タ ウ ィ ン ド ウ の コ ン ト ロ ール ま たは コ ン ポーネ ン ト で使用で き ます。PSR フ ァ イ ルには、 その フ ァ イ ルの作成時に レ ポー ト 内に存在 し ていたデー タ と 、 レ ポー ト 自体の定義 （基本的には、 更新機能の な いデー タ ウ ィ ン ド ウ オブ ジ ェ ク ト ） が含まれ ます。 デー タ 検索は行い ません。 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト を定義する 場所 デー タ ウ ィ ン ド ウ オブジ ェ ク ト は、 PowerBuilder のデータ ウ ィ ン ド ウ ペ イ ン タ で定義 し ます。 更新機能のないデー タ ウ ィ ン ド ウ オブジ ェ ク ト は、InfoMaker の レ ポー ト ペ イ ン タ内で定義する こ と も で き ます。

デー タ ウ ィ ン ド ウ オブジ ェ ク ト 、 コ ン ト ロール、 コ ンポーネン ト について

提示様式 と デー タ

ソ ース

デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を定義す る には、 提示様式 と デー タ ソ ース を選択 し ます。 提示様式 提示様式は、 レ ポー ト の一般的な様式を定義す る と と も に、 ページ上 で行を ど の よ う にグループ化す る か を指定 し ます。 それぞれの提示様 式では、 デー タ の表示方法 を カ ス タ マ イ ズ で き ま す。 提示様式には、 以下の よ う な種類があ り ます。 表 1-1: デー タ ウ ィ ン ド ウの提示様式 提示様式の例については、PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アルを参照 し て く だ さ い。 提示様式 説明 タ ブ ラ ページの横方向にデー タ カ ラ ムが並べ ら れ、 各カ ラ ム の上にヘ ッ ダがあ る 。 複数の行を一度に表示で き る フ リ ーフ ォーム ページの縦方向にデー タ カ ラ ムが並べ ら れ、 各カ ラ ム の横に ラ ベルがあ る 。 一度に表示で き る のは 1 行だけ グ リ ッ ド ス プ レ ッ ド シー ト と 似た グ リ ッ ド 線 を 使用 し た表書 式。 ユーザは境界線やカ ラ ム を移動で き る ラ ベル 1 つの ラ ベルにつき 1 行分のデータ を表示 し、1 ページ に複数の ラ ベルが表示 さ れ る 。 郵便 ラ ベルな ど に使用 段組み 2 行以上のデー タ をページ上に隣 り 合わせで表示。 曜 日単位、 四半期の各月のデー タ な ど、 周期的なデー タ を表示す る 場合に便利 グループ 見出 し の下に行が グループ化 さ れてい る タ ブ ラ 様式。 それぞれのグループ別に、 合計を表示す る 要約フ ィ ー ル ド を取 り 込む こ と がで き る ツ リ ービ ュ ー 階層的にデー タ を グループ化 し 、 展開、 折 り たたみ可 能な方法でデー タ を表示す る タ ブ ラ 様式 コ ン ポジ ッ ト 複数のデー タ ウ ィ ン ド ウ オブジ ェ ク ト を 1 つの提示 様式に ま と め て表示。Web デー タ ウ ィ ン ド ウ ではサ ポー ト さ れていない グ ラ フ デー タ を グ ラ フ ィ カルに提示。Web データ ウ ィ ン ド ウ ではサポー ト さ れていない ク ロ ス タ ブ デー タ を要約 し て表書式で表示 リ ッ チテ キ ス ト テ キ ス ト にデー タ カ ラ ムが埋め込まれたパ ラ グ ラ フ。 Web データ ウ ィ ン ド ウ、 Sybase データ ウ ィ ン ド ウ Web コ ン ト ロ ール ActiveX ではサポー ト さ れていない OLE 検索 さ れたデー タ と 関連付け ら れ る OLE オブジ ェ ク

ト がデー タ ウ ィ ン ド ウ 内に リ ン ク ま た は埋め込 ま れ る 。Web デー タ ウ ィ ン ド ウ ではサポー ト さ れていない

デー タ ソ ース デー タ ソ ースは、 データ ウ ィ ン ド ウ で使用するデー タ を ど こ か ら 持っ て き て、 ど の よ う なデー タ 項目を表示す る のか を指定 し ます。 デー タ は、 デー タ ベー ス 内のテーブルや Web サービ ス か ら 持っ て く る ほか、 フ ァ イ ルか ら イ ン ポー ト し た り 、 コ ー ド でデー タ を指定 し た り す る こ と がで き ます。デー タ ベース か ら 取 り 出す場合は、デー タ の指定が SQL 文に保存 さ れ ます。 ど の場合で も 、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト に は、表示 さ れ る デー タ 項目の名前 と そのデー タ 型が保存 さ れてい ます。 表 1-2: デー タ ウ ィ ン ド ウで使用する こ と がで き るデー タ ソ ース

基本的な プ ロ セス

デー タ ウ ィ ン ド ウ を使用す る には、 大 き く 分けて以下の 2 つの ス テ ッ プが必要です。 1 デー タ ウ ィ ン ド ウ ペ イ ン タ を使用 し て、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を作成ま たは編集 し ます。 デー タ ソ ース 説明 Quick Select SQL デー タ ベー ス 内の 1 つ ま たは複数のテーブルか ら デー タ が取 り 出 さ れ る 。 複数のテーブルのデー タ を使用 す る には、 テーブル間は外部キーに よ っ て結合 さ れてい なければな ら ない。 カ ラ ム、 選択条件、 お よ び ソ ー ト 条 件を選択す る だけの場合に使用 SQL Select データ ソ ース に関し て生成する SELECT 文を 制御する 場 合に使用。 グループ条件や計算カ ラ ム など を 指定でき る ク エ リ デー タ があ ら か じ め選択 さ れ、ク エ リ ペ イ ン タ で定義 さ れた ク エ リ オブジ ェ ク ト に SQL 文が保存 さ れてい る。 ク エ リ オブジ ェ ク ト はデー タ ウ ィ ン ド ウ オブジ ェ ク ト を 定義す る と き にデー タ ウ ィ ン ド ウ に取 り 込 ま れ る の で、アプ リ ケーシ ョ ンの実行時は ク エ リ オブジ ェ ク ト が 存在 し ていな く て も か ま わない 外部 デー タ ベー ス にデー タ が格納 さ れていない場合に使用。 デー タ はフ ァ イ ル （ タ ブで区切 ら れた フ ァ イ ル、dBASE フ ァ イ ルな ど） か ら イ ン ポー ト さ れた り 、 コ ー ド か ら 生 成 さ れた り す る ス ト ア ド プ ロ シージ ャ デー タ ベー ス ス ト ア ド プ ロ シージ ャ に定義 さ れてい る デー タ が取 り 出 さ れ る

Web サービ ス デー タ は Web サー ビ ス で定義 さ れ る。 Web サー ビ ス デー タ ソ ースは、 コ ンポジ ッ ト 、 リ ッ チテキ ス ト 、 お よ び OLE 提示様式では使用で き ない

デー タ ウ ィ ン ド ウ テ ク ノ ロ ジの選択 ペ イ ン タ では、 デー タ ソ ースや提示様式のほかに、 表示書式、 入 力条件則、 ソ ー ト 条件、 フ ィ ル タ 条件、 グ ラ フ な ど、 オブジ ェ ク ト のあ ら ゆ る プ ロ パテ ィ を定義 し ます。 2 開発環境で、デー タ ウ ィ ン ド ウ コ ン ト ロ ールを ウ ィ ン ド ウ、ビ ジ ュ アル ユーザ オブジ ェ ク ト 、 ま たはフ ォームに配置 し 、 データ ウ ィ ン ド ウ コ ン テナを Web ページに配置 し 、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト をデー タ ウ ィ ン ド ウ コ ン ト ロ ールま たはデー タ ウ ィ ン ド ウ コ ン テナ と 関連付け ます。 デー タ ウ ィ ン ド ウ ペ イ ン タ で作成 し た デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト と アプ リ ケーシ ョ ン と の通信は、 デー タ ウ ィ ン ド ウ コ ン ト ロ ール ま たは コ ン テナを介 し て行われ ま す。 デー タ ウ ィ ン ド ウ コ ン ト ロ ール ま た は コ ン テ ナ と 、 そ のデー タ ウ ィ ン ド ウ コ ン ト ロ ール ま たは コ ン テナに含まれ る デー タ ウ ィ ン ド ウ オブジ ェ ク ト を 操作す る コ ー ド を 記述 し ま す。 通常は、 デー タ の検索 と 更新、 デー タ の表示形式の変更、 エ ラ ー処理、 お よ びデー タ ウ ィ ン ド ウ コ ン ト ロ ール間でのデー タ 共有を行 う コ ー ド な ど を記述 し ます。

デー タ ウ ィ ン ド ウ

テ ク ノ ロ ジの選択

デー タ ウ ィ ン ド ウ テ ク ノ ロ ジ は さ ま ざ ま な環境で使用で き る た め、 デー タ ベース 対応のアプ リ ケーシ ョ ン を実装す る 方法は状況に応 じ て 異な り ます。 こ の節では、 基本的な アプ リ ケーシ ョ ン アーキ テ ク チ ャ で使用可能なデー タ ウ ィ ン ド ウ テ ク ノ ロ ジ と 、各デー タ ウ ィ ン ド ウ ソ リ ュ ーシ ョ ン の要件について説明 し ます。 基本的な アーキ テ ク チ ャ は、 以下の と お り です。 • ク ラ イ ア ン ト / サーバ アプ リ ケーシ ョ ン ク ラ イ ア ン ト 側の ワ ー ク ス テーシ ョ ン で動作す る プ ロ グ ラ ム が、 サーバ上で動作す る デー タ ベース にア ク セ ス し ます。 ク ラ イ ア ン ト 側の コ ン ピ ュ ー タ に、ユー ザ イ ン タ フ ェ ー ス と ビ ジ ネ ス ロ ジ ッ ク の両方が組み込 ま れてい ます。 • 分散ア プ リ ケーシ ョ ン ク ラ イ ア ン ト 側の コ ン ピ ュ ー タ のユーザ イ ン タ フ ェ ー ス が、 中間層に あ る サーバ上の コ ン ポーネ ン ト を呼び 出 し ます。 こ の コ ン ポーネ ン ト に よ っ て、 ビ ジネ ス ロ ジ ッ ク が実 行 さ れ、 デー タ ベース サーバへア ク セ ス し ます。

• Web アプ リ ケーシ ョ ン ク ラ イ ア ン ト 側の Web ブ ラ ウ ザが、 HTML ド キ ュ メ ン ト ま たは JSP ド キ ュ メ ン ト の要求を Web サーバに送信 し ます。Web サーバは制御をページ サーバま たはアプ リ ケーシ ョ ン サーバに渡 し 、サーバ サ イ ド ス ク リ プ ト を使用 し て ト ラ ンザ ク シ ョ ン サーバ上の コ ン ポーネ ン ト にア ク セ ス し 、 さ ら に こ れを通 じ てデー タ ベース サーバ上のデータ ベース に接続で き ます。 • .NET アプ リ ケーシ ョ ン PowerBuilder では、 .NET Web フ ォ ーム ア

プ リ ケーシ ョ ンお よ び Windows フ ォーム アプ リ ケーシ ョ ンでデー タ ウ ィ ン ド ウ を配布で き ます。.NET アプ リ ケーシ ョ ンの詳細につ いては、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配布 』 マニ ュ アルを参照 し て く だ さ い。

ク ラ イ ア ン ト

_{/ サーバ ア プ リ ケーシ ョ ンおよび分散アプ リ ケーシ ョ ンの}

ソ リ ュ ーシ ョ ン

PowerBuilder データ ウ ィ ン ド ウ は、 当初、 ク ラ イ ア ン ト / サーバ アプ リ ケーシ ョ ン で使用す る こ と を目的に開発 さ れ ま し た。 PowerBuilder デー タ ウ ィ ン ド ウ は、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト を 表示す る コ ン ト ロ ール と し て実装す る か、 ま たはデー タ を表示せずに デー タ の検索や更新を行 う こ と がで き る デー タ ス ト ア と し て実装 し ま す。PowerScript でプ ロ グ ラ ム さ れた イ ベン ト と メ ソ ッ ド の組み合わせ に よ っ て、 デー タ の検索、 表示、 検証、 更新な ど、 デー タ ウ ィ ン ド ウ のあ ら ゆ る 要素を制御で き ます。 PowerBuilder デー タ ウ ィ ン ド ウ は、 分散アプ リ ケーシ ョ ン で使用す る コ ン ポーネ ン ト と し て配布す る こ と も で き ます。 詳細については、12 ページの 「PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロ ール」 を参照 し て く だ さ い。

Web アプ リ ケーシ ョ ンのソ リ ュ ーシ ョ ン

Web アプ リ ケーシ ョ ンでは、 以下のデー タ ウ ィ ン ド ウ テ ク ノ ロ ジ を使 用で き ます。 • Web デー タ ウ ィ ン ド ウお よび Web デー タ ウ ィ ン ド ウ DTC • Sybase デー タ ウ ィ ン ド ウ Web コ ン ト ロ ール ActiveX • デー タ ウ ィ ン ド ウ プ ラ グ イ ン

デー タ ウ ィ ン ド ウ テ ク ノ ロ ジの選択

Web デー タ ウ ィ ン ド ウ

Web デー タ ウ ィ ン ド ウ は、 Web アプ リ ケーシ ョ ンのためのシ ン ク ラ イ ア ン ト データ ウ ィ ン ド ウ の実装です。こ の環境では、PowerBuilder デー タ ウ ィ ン ド ウ のデー タ 操作機能、 表示機能、 お よ び ス ク リ プ ト 機能の 大部分を実現で き ます。 ク ラ イ ア ン ト 側には PowerBuilder DLL は必要 あ り ません。 機能 _{Web デー タ ウ ィ ン ド ウ は、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の動的変更} な ど、PowerBuilder デー タ ウ ィ ン ド ウ の イ ベン ト お よ び メ ソ ッ ド のサ ブセ ッ ト を サポー ト し ます。 ユーザはデー タ の修正や更新を行 う こ と がで き ます。 コ ン ポジ ッ ト 、 グ ラ フ、OLE、 ツ リ ービ ュー、 お よび リ ッ チテ キ ス ト の提示様式 と コ ン ト ロ ールはサポー ト し てい ません。 ク ラ イ ア ン ト の要件 _{HTML Web デー タ ウ ィ ン ド ウ はどのブ ラ ウ ザで も 機能 し ますが、 生成} さ れた HTML を表示す る 場合は Internet Explorer が最適です。 生成 さ れた HTML は、Netscape ま たは Internet Explorer に合わせて動的に最適 化で き ます。 ま た、 旧型のブ ラ ウ ザ を使用す る 場合、 そのブ ラ ウ ザに 合わせて元の ス ケールに戻す こ と も で き ます。XML Web デー タ ウ ィ ン ド ウ お よ び XHTML Web データ ウ ィ ン ド ウ では、 ク ラ イ ア ン ト サ イ ド テ ク ノ ロ ジ （XML、 XSLT、 XHTML、 CSS、 およ び JavaScript） をサポー ト す る ブ ラ ウ ザが必要 と な り ます。 サポー ト さ れてい る ブ ラ ウ ザにつ いては、137 ページの 「XML Web デー タ ウ ィ ン ド ウ のブ ラ ウ ザ要件」 を参照 し て く だ さ い。 サーバの要件 コ ン ポーネ ン ト サーバ と 動的ページ サーバは連携 し なが ら 、デー タ と ク ラ イ ア ン ト コ ン ト ロ ールを生成 し 、それを Web ページに取 り 込みま す。 ユーザがデー タ の新規ページ を要求 し た り 、 デー タ の更新、 あ る いは行の挿入や削除を行っ た り す る たびに、 サーバはその要求を取得 し て、 新規ページ を生成 し ま す。 状態の管理の仕方に よ っ ては、 コ ン ポ ー ネ ン ト は呼び出 さ れ る た びにデー タ の検索 を 行 う こ と が あ り 、 サーバ側の負荷が増え る こ と にな り ます。 開発ツール _{PowerBuilder の Web ターゲ ッ ト イ ン タ フ ェースは、 実際に コー ド を記} 述 し な く て も Web デー タ ウ ィ ン ド ウ を開発で き る Web デー タ ウ ィ ン ド ウ DTC を提供 し ます。 ま た、 コ ン ポーネ ン ト サーバの API を使用 し て、Web デー タ ウ ィ ン ド ウ を作成する ための独自のサーバ サ イ ド ス ク リ プ ト を 記述す る こ と も で き ま す。 ペー ジ サーバの種類 （Active Server Pages ま たは JavaServer Pages）を指定 し て ス ク リ プ ト を記述する こ と も で き ます。Web サ イ ト タ ーゲ ッ ト については、 Web タ ーゲ ッ ト オブ ジ ェ ク ト モデルを使用 し て、 ページ サーバの種類に依存 し ない サーバ ス ク リ プ ト （Active Server Pages への配布が可能） を記述する こ

4GL Web ページで Web デー タ ウ ィ ン ド ウ DTC を使用する場合は、サー バ サ イ ド イ ベン ト が使用で き、 ページ変数を使っ て Web アプ リ ケー シ ョ ン の動的な機能性 を 高め る こ と がで き ま す。 4GL Web ページ で Web デー タ ウ ィ ン ド ウ を手書きする こ と はで き ません。 Web デー タ ウ ィ ン ド ウ については、第 6 章の 「Web データ ウ ィ ン ド ウ の使い方」 を参照 し て く だ さ い。Web データ ウ ィ ン ド ウ DTC について は、 『JSP タ ーゲ ッ ト での作業』 マニ ュ アルを参照 し て く だ さ い。

Sybase デー タ ウ ィ ン ド ウ Web コ ン ト ロール ActiveX

Sybase データ ウ ィ ン ド ウ Web コ ン ト ロ ール ActiveX は、 Internet Explorer での使用を 目的と し た 対話型のデータ ウ ィ ン ド ウ コ ン ト ロ ールです。 PowerBuilder データ ウ ィ ン ド ウ のリ ッ チテキス ト 以外のすべての機能が 実装さ れていま す。 機能 _{Web ActiveX は、 完全にプ ロ グ ラ ム実行可能で、 デー タ ウ ィ ン ド ウ の} イ ベン ト や メ ソ ッ ド 、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の動的変更をサ ポー ト し ま す。 ユーザはデー タ の修正や更新 を行 う こ と がで き ま す。 リ ッ チテ キ ス ト 提示様式はサポー ト さ れてい ません。

ク ラ イ ア ン ト の要件 コ ン ト ロ ールは ActiveX テク ノ ロ ジを 使用し 、 Microsoft Internet Explorer

でのみ動作し ま す。 ユーザは、 コ ン ポーネ ン ト の CAB フ ァ イ ル （2 MB 未満） を ダ ウ ン ロ ー ド す る 必要が あ り ま す。JDBC を介 し たデー タ ベース と の接続は ク ラ イ ア ン ト 側か ら 行われ、 こ のため接続 ソ フ ト ウ ェ ア を ク ラ イ ア ン ト 側 に設定す る 必要があ り ます。 接続 ソ フ ト ウ ェ アは、Web サーバか ら ダ ウ ン ロ ー ド で き ます。 SaveAs 機能な ど、 ク ラ イ ア ン ト のセキ ュ リ テ ィ を脅かすよ う なデー タ ウ ィ ン ド ウ の動作は無効にな り ます。 サーバの要件 _{JDBC を 介 し たデー タ ベー ス と の接続に よ り 、 リ モー ト サーバ上の} デー タ ベース にア ク セ ス で き ます。 開発ツール _{ActiveX コ ン ポーネ ン ト を使用 し て Web アプ リ ケーシ ョ ン を開発する} 場合、JSP タ ーゲ ッ ト ツールを使用で き ます。 詳細 に つ い て は、第 8 章の 「デー タ ウ ィ ン ド ウ Web コ ン ト ロ ール ActiveX の使い方」 を参照 し て く だ さ い。

デー タ ウ ィ ン ド ウ

プ ラ グ イ ン

デー タ ウ ィ ン ド ウ プ ラ グ イ ンは、 Powersoft レ ポー ト （PSR） を表示す る ためのブ ラ ウ ザ プ ラ グ イ ンです。

PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロール 機能 _{PSR は、 静的なデー タ ウ ィ ン ド ウ です。 こ のデー タ ウ ィ ン ド ウ は修正} がで き ないので、最新のデー タ が反映 さ れ ません。 ただ し 、PSR はデー タ ウ ィ ン ド ウ の定義 と デー タ を コ ンパ ク ト に表 し た も ので あ り 、 ダ ウ ン ロ ー ド の効率を上げ る こ と がで き ます。 バ ッ チ処理に よ っ て生成 さ れた レ ポー ト を表示す る 場合に効率的な手段です。 ユーザはデー タ の修正や更新を行 う こ と がで き ません。 ク ラ イ ア ン ト の要件 ブ ラ ウ ザのプ ラ グ イ ン デ ィ レ ク ト リ に、 プ ラ グ イ ンの実行フ ァ イ ルを イ ン ス ト ールす る 必要があ り ます。 プ ラ グ イ ン の実行フ ァ イ ルは、 自 動的にダ ウ ン ロ ー ド し イ ン ス ト ールす る こ と はで き ません。 こ のプ ラ グ イ ンは、Netscape お よび Internet Explorer 5.5 SP 1 以下で動作 し ます。 SaveAs 機能な ど、 ク ラ イ ア ン ト のセキ ュ リ テ ィ を脅かすよ う なデー タ ウ ィ ン ド ウ の動作 も使用可能です。 開発ツール _{PowerBuilder ま たは InfoMaker を使用 し て、 PSR を作成で き ます。} プ ラ グ イ ン アーキ テ ク チ ャ についての詳細は、 『アプ リ ケーシ ョ ン テ ク ニ ッ ク』 マニ ュ アルを参照 し て く だ さ い。

.Net アプ リ ケーシ ョ ン

詳細については、 『アプ リ ケーシ ョ ン と コ ン ポーネ ン ト の .NET への配 布』 マニ ュ アルを参照 し て く だ さ い。

PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロール

機能 _{PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロ ールは、 PowerBuilder アプ リ} ケーシ ョ ン に配置す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト の コ ン テナで す。 デー タ ウ ィ ン ド ウ コ ン ト ロ ールを ウ ィ ン ド ウ で使用す る こ と で、 対話形式に よ る デー タ 表示を実現で き ます。 ユーザはデー タ を表示 し て変更 し 、 変更内容をデー タ ベース に送信で き ます。 デー タ ウ ィ ン ド ウ コ ン ト ロ ールのほかに、デー タ ス ト ア オブジ ェ ク ト を使用で き ま す。 デー タ ス ト ア オブジ ェ ク ト は、 サーバ アプ リ ケー シ ョ ンや、 画面表示が必要ない場合の非表示 コ ン テナです。

デー タ ウ ィ ン ド ウ では、 検索引数を使用 し たデー タ 検索 と デー タ 更新 を サポー ト し てい ます。 デー タ 入力やデー タ 表示の一貫性を保つため に、 編集様式、 表示書式、 お よ び入力条件則を使用で き ま す。 デー タ ウ ィ ン ド ウ では、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のプ ロ パテ ィ を変更 す る Modify メ ソ ッ ド な ど、デー タ ウ ィ ン ド ウ を操作する ための メ ソ ッ ド が多数用意 さ れてい ます。 さ ら に、 結果集合を複数のデー タ ウ ィ ン ド ウ コ ン ト ロール間で共有 し た り 、 ク ラ イ ア ン ト と サーバの間でデー タ を同期 さ せた り す る こ と がで き ます。 開発環境 _{PowerBuilder では、 デー タ ウ ィ ン ド ウ を実装す る ために必要な両方の} 要素を開発で き ます。 以下のペ イ ン タ を使用 し ます。 • デー タ ウ ィ ン ド ウ ペ イ ン タ。 データ ウ ィ ン ド ウ オブジ ェ ク ト を定 義 し ます。 • ウ ィ ン ド ウ ペ イ ン タ ま たはユーザ オブジ ェ ク ト ペ イ ン タ。デー タ ウ ィ ン ド ウ コ ン ト ロ ールを ウ ィ ン ド ウ ま たは ビ ジ ュ アル ユーザ オブ ジ ェ ク ト に追加 し ま す。 デー タ ウ ィ ン ド ウ コ ン ト ロ ールは、 ペ イ ン タ の ド ロ ッ プ ダ ウ ン コ ン ト ロ ール パ レ ッ ト 上に並べ ら れ てい ます。 ウ ィ ン ド ウ ペ イ ン タ ま たはユーザ オブジ ェ ク ト ペ イ ン タ で、デー タ ウ ィ ン ド ウ の動作を制御 し た り 、 検索 さ れ る デー タ を操作 し た り す る ための ス ク リ プ ト を記述 し ます。 ま た、 デー タ ス ト ア オブ ジ ェ ク ト の イ ン ス タ ン ス も 生成で き ます。 オブジ ェ ク ト ブ ラ ウ ザでは、 ［シ ス テ ム］ タ ブ ページで、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールやデータ ス ト ア オブジ ェ ク ト のプ ロ パテ ィ 、 イ ベ ン ト 、 お よ び メ ソ ッ ド を調べ る こ と がで き ます。 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト が含 ま れ る ラ イ ブ ラ リ を 開い て い る 場合は、 ブ ラ ウ ザの ［デー タ ウ ィ ン ド ウ ］ タ ブ ページで、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の内部プ ロ パテ ィ を調べ る こ と がで き ます。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト デー タ ウ ィ ン ド ウ コ ン ト ロールやデー タ ス ト ア オブジ ェ ク ト は、どの_{提示様式で も 定義で き る デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を使用す る} こ と で、 ど の よ う なデー タ を検索 し 、 検索 し たデー タ を ど の よ う に表 示す る か を判断 し ます。 コ ン ト ロ ールには、 デー タ を検索す る 必要が ない Powersoft レ ポー ト （PSR） を表示する こ と も で き ます。 デー タ ベース と の接続 _{PowerBuilder デー タ ウ ィ ン ド ウ では、 デー タ ベース に接続する ために、} ODBC、 JDBC、 およ びネ イ テ ィ ブなデー タ ベース ド ラ イ バを使用で き ま す。 こ れに よ っ て、 ユーザは ア ク セ ス 先のサーバ上に あ る デー タ ソ ー ス （ イ ン タ ーネ ッ ト 上のデー タ ベース や中間層のサーバな ど） に 接続で き ます。

PowerBuilder デー タ ウ ィ ン ド ウ コ ン ト ロール 接続を確立す る には、 デー タ ウ ィ ン ド ウ の内部 ト ラ ンザ ク シ ョ ン オブ ジ ェ ク ト を使用で き ます。ま た、独立 し た PowerBuilder ト ラ ンザ ク シ ョ ン オブジ ェ ク ト に接続する こ と も で き ます。 PowerBuilder アプ リ ケーシ ョ ン には、 デフ ォ ル ト の ト ラ ンザ ク シ ョ ン オブジ ェ ク ト SQLCA が用意 さ れてい ますが、 追加の接続が必要な場 合は、 ほかの ト ラ ンザ ク シ ョ ン オブジ ェ ク ト を定義で き ます。 接続に 独立 し た ト ラ ンザ ク シ ョ ン オブジ ェ ク ト を使用する と 、SQL COMMIT 文お よ び ROLLBACK 文を実行す る タ イ ミ ン グ を制御 し た り 、 複数の コ ン ト ロ ールに対 し て同 じ 接続を使用 し た り す る こ と がで き ます。 デー タ ウ ィ ン ド ウ と ト ラ ン ザ ク シ ョ ン オブジ ェ ク ト を併用す る 方法 についての詳細は、第 2 章の 「データ ウ ィ ン ド ウ オブジ ェ ク ト の使い 方」 を参照 し て く だ さ い。 PowerBuilder ト ラ ン ザ ク シ ョ ン オ ブ ジ ェ ク ト に つ い て の 詳細 は、 PowerBuilder マニ ュ アル セ ッ ト の 『アプ リ ケーシ ョ ン テ ク ニ ッ ク』 マ ニ ュ アルを参照 し て く だ さ い。 ス ク リ プ ト の記述 デー タ ベース と の接続、デー タ の検索、ユーザ入力の処理、お よ びデー タ の更新を行 う ための ス ク リ プ ト は、 ウ ィ ン ド ウ ペ イ ン タ ま たはユー ザ オブジ ェ ク ト ペ イ ン タ で記述 し ます。 PowerBuilder では、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールか ら 継承する ユー ザ オブジ ェ ク ト を定義 し 、 それに独自のカ ス タ ム機能を追加する こ と に よ っ て、 オブジ ェ ク ト の継承を利用す る こ と がで き ます。 こ の よ う に し て カ ス タ マ イ ズ し たデー タ ウ ィ ン ド ウ コ ン ト ロ ールは、 ア プ リ ケーシ ョ ン全体で再利用で き ます。 非 ビ ジ ュ アルなデー タ ウ ィ ン ド ウ コ ン ト ロ ールで あ る デー タ ス ト ア オブジ ェ ク ト を作成す る には、 まずそのオブジ ェ ク ト を作成す る ため の ス ク リ プ ト を記述 し 、 そのオブジ ェ ク ト に対す る メ ソ ッ ド を呼び出 し ます。 ま た、 デー タ ス ト アか ら 継承 さ れ る ユーザ オブジ ェ ク ト を定 義 し 、 それを カ ス タ マ イ ズす る こ と も で き ます。 詳細については、第 4 章の 「デー タ ス ト ア オブジ ェ ク ト の使い方」 を参照 し て く だ さ い。 ラ イ ブ ラ リ と ア プ リ ケーシ ョ ン 開発段階では、 デー タ ウ ィ ン ド ウ_{ブ ラ リ （PBL） に格納 し てお き ま す。 ア プ リ ケ ーシ ョ ン の構築時に、} オブジ ェ ク ト は、 PowerBuilder ラ イ デー タ ウ ィ ン ド ウ オブジ ェ ク ト を、 アプ リ ケーシ ョ ンの実行フ ァ イ ル ま たは PowerBuilder 動的 ラ イ ブ ラ リ （PBD） の中に取 り 込む こ と がで き ます。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を 設計 し 、 PowerBuilder ア プ リ ケ ー シ ョ ン を構築す る 方法についての詳細は、PowerBuilder の 『ユーザー ズ ガ イ ド』 マニ ュ アルお よ び 『アプ リ ケーシ ョ ン テ ク ニ ッ ク』 マニ ュ

使い方

こ の章について こ の章では、 アプ リ ケーシ ョ ン でのデー タ ウ ィ ン ド ウ オブジ ェ ク ト の使い方について説明 し ます。 内容 は じ めに _{こ の章では、デー タ ウ ィ ン ド ウ ペ イ ン タ でのデー タ ウ ィ ン ド ウ オ} ブジ ェ ク ト の構築方法を把握 し てい る こ と が前提にな り ま す。 こ れについては、PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アル を参照 し て く だ さ い。 項目 ページ デー タ ウ ィ ン ド ウ オブジ ェ ク ト の使い方について 16 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の コ ン ト ロ ールへの 取 り 込み 17 デー タ ベースへのア ク セ ス 24 Web サービ ス データ ソ ースへのア ク セ ス 33 外部 ソ ース か ら のデー タ の イ ン ポー ト 33 デー タ ウ ィ ン ド ウ コ ン ト ロールのデータ の操作 34 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のプ ロ パテ ィ へのア ク セ ス 43 デー タ ウ ィ ン ド ウ エ ラ ーの処理 45 デー タ ベース の更新 51 レ ポー ト の作成 55 ネ ス テ ィ ッ ド レ ポー ト の使い方 57 ク ロ ス タ ブの使い方 60 HTML の生成 64

デー タ ウ ィ ン ド ウ オブジ ェ ク ト の使い方について

デー タ ウ ィ ン ド ウ

オブ ジ ェ ク ト の使い方について

デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の構築 アプ リ ケーシ ョ ン でデー タ ウ ィ ン ド ウ_{まずそのオブジ ェ ク ト を構築す る 必要があ り ます。} オブジ ェ ク ト を使用す る には、_{PowerBuilder には、} デー タ ベー ス 管理、 デー タ ウ ィ ン ド ウ 定義、 お よ び ラ イ ブ ラ リ 管理用 の個別のペ イ ン タ があ り ます。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト は、デー タ ウ ィ ン ド ウ ペ イ ン タ で定義 お よ び編集を行い ます。 デー タ ソ ースや提示様式を指定 し た後、 表示 書式や編集様式な ど を指定 し てオブジ ェ ク ト を拡張 し ます。 デー タ ウ ィ ン ド ウ ペ イ ン タ では、 Powersoft レ ポー ト （PSR） フ ァ イ ル を作成す る こ と も で き ます。 こ の PSR フ ァ イ ルはアプ リ ケーシ ョ ンで 使用す る こ と がで き ます。PSR フ ァ イ ルには、 その フ ァ イ ルの作成時 に レ ポー ト 内に存在 し ていたデー タ と 、 レ ポー ト 自体の定義 （基本的 には、更新機能のないデー タ ウ ィ ン ド ウ オブジ ェ ク ト ） が含まれます。 レポー ト オブジ ェ ク ト を使用で き るのは InfoMaker のみ 以前のバージ ョ ンの PowerBuilder には、 データ ウ ィ ン ド ウ ペ イ ン タ の ほかに、 レ ポー ト ペ イ ン タ があ り ま し た。 レ ポー ト オブジ ェ ク ト は、 デー タ の書 き 出 し はで き ますが、 デー タ の更新はで き ません。 レ ポー ト オブジ ェ ク ト は、 基本的には、 更新機能のないデー タ ウ ィ ン ド ウ オ ブジ ェ ク ト です。 現在、 レ ポー ト ペ イ ン タ は InfoMaker でのみ使用で き ます。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の管理 い く つかのペ イ ン タ では、 デー タ ウ ィ ン ド ウ_{プ リ ケーシ ョ ン用のパ ッ ケージ化が可能です。} オブジ ェ ク ト の管理 と ア 特に、1 つま たは複数の ラ イ ブ ラ リ （PBL フ ァ イ ル） にデー タ ウ ィ ン ド ウ オブジ ェ ク ト を保持で き ます。 アプ リ ケーシ ョ ンでデー タ ウ ィ ン ド ウ オブジ ェ ク ト を使用する準備がで き た ら 、 こ れ ら のオブジ ェ ク ト を よ り コ ン パ ク ト な ラ ン タ イ ム ラ イ ブ ラ リ （PBD フ ァ イ ル） にパ ッ ケージ化で き ます。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の構築方法お よ び編成方法について の詳細は、 PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アルを参照 し て く だ さ い。 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト の使い方 デー タ ウ ィ ン ド ウ_{PSR フ ァ イ ル） を構築 し た ら 、 そのオブジ ェ ク ト を使用 し て、 適切な} ペ イ ン タ でデータ ウ ィ ン ド ウ オブジ ェ ク ト （ま たは デー タ ソ ース か ら 情報を表示 し 、 処理する こ と がで き ます。 以降の節 では、 こ の方法について詳 し く 説明 し ます。

デー タ ウ ィ ン ド ウ

オブ ジ ェ ク ト のコ ン ト ロールへの

取 り 込み

デー タ ウ ィ ン ド ウ コ ン ト ロールは、 アプ リ ケーシ ョ ンに配置するデー タ ウ ィ ン ド ウ オブジ ェ ク ト の コ ン テナです。デー タ ウ ィ ン ド ウ コ ン ト ロ ールは、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト のデータ や外観を操作する ためのプ ロ パテ ィ 、 メ ソ ッ ド 、 お よ び イ ベン ト を提供 し ます。 デー タ ウ ィ ン ド ウ コ ン ト ロールは、アプ リ ケーシ ョ ンのユーザ イ ン タ フ ェー ス の一部です。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト は、 非ビ ジ ュ アルなデー タ ス ト アや、 ド ロ ッ プ ダ ウ ン デー タ ウ ィ ン ド ウ や コ ン ポ ジ ッ ト 提示様式な ど の子 デー タ ウ ィ ン ド ウ で も 使用で き ます。デー タ ス ト アについての詳細は、 第 4 章の 「データ ス ト ア オブジ ェ ク ト の使い方」を参照 し て く だ さ い。 ド ロ ッ プダ ウ ン デー タ ウ ィ ン ド ウ お よ び コ ン ポ ジ ッ ト デー タ ウ ィ ン ド ウ についての詳細は、PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アルを参照 し て く だ さ い。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト を アプ リ ケーシ ョ ン で使用す る には、 ウ ィ ン ド ウ ま たは フ ォ ー ム にデー タ ウ ィ ン ド ウ コ ン ト ロ ール を追加 し 、 その コ ン ト ロ ールをデー タ ウ ィ ン ド ウ オブジ ェ ク ト と 関連付け ま す （図2-1 を参照）。 図 2-1: デー タ ウ ィ ン ド ウ オブジ ェ ク ト のデー タ ウ ィ ン ド ウ コ ン ト ロールへ の取 り 込み こ の節では、 以下の内容について説明 し ます。 • デー タ ウ ィ ン ド ウ コ ン ト ロ ール と デー タ ウ ィ ン ド ウ オブジ ェ ク ト の名前 • コ ン ト ロ ールを挿入 し 、 その コ ン ト ロ ールにデー タ ウ ィ ン ド ウ オ ブジ ェ ク ト を割 り 当て る ための手順 • 実行段階でのデー タ ウ ィ ン ド ウ オブジ ェ ク ト の指定

デー タ ウ ィ ン ド ウ オブジ ェ ク ト のコ ン ト ロールへの取 り 込み デー タ ウ ィ ン ド ウ オブジ ェ ク ト と Web デー タ ウ ィ ン ド ウ コ ン ト ロ ー ル と の関連付けについての詳細は、 『JSP タ ーゲ ッ ト での作業』 マニ ュ アル ま たは 207 ページの 「デー タ ウ ィ ン ド ウ オブジ ェ ク ト の ロ ー ド 」 を参照 し て く だ さ い。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト と Web コ ン ト ロール ActiveX と の関連 付けについての詳細は、248 ページの 「コ ン ト ロ ールに対す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト の指定」 を参照 し て く だ さ い。

データ ウィ ン ド ウ

コ ン ト ロ ールと データ ウィ ン ド ウ オブジェ ク ト の名前

デー タ ウ ィ ン ド ウ を操作す る 際に、注意が必要な名前が 2 つあ り ます。 • デー タ ウ ィ ン ド ウ コ ン ト ロ ールの名前 • コ ン ト ロ ールに関連付け ら れてい る デー タ ウ ィ ン ド ウ オブジ ェ ク ト の名前 デー タ ウ ィ ン ド ウ コ ン ト ロール名 ウ ィ ン ド ウ ま たは フ ォ ー ム にデー タ ウ ィ ン ド ウ コ ン ト ロ ールを配置する と 、 その コ ン ト ロ ールにデフ ォル ト の名前が付け ら れ ます。 こ の名前を アプ リ ケーシ ョ ン内で意味のあ る 名前に変更 し て く だ さ い。 PowerBuilder では、 コ ン ト ロ ール名に dw_ と い う プ レ フ ィ ッ ク ス が付 け ら れ ます。 開発環境に関係な く 、 こ の規則を守っ てお く と 便利です。 た と えば、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールに顧客名が リ ス ト さ れてい る 場合は、 その コ ン ト ロ ールに dw_customer と い う 名前を付けてお く と 便利です。 名前の使い方 コ ー ド で デ ー タ ウ ィ ン ド ウ を 参 照 す る 場 合 は、 コ ン ト ロ ー ル名 （dw_customer な ど） を使用 し て く だ さ い。 コ ン ト ロ ール内にあ るデー タ ウ ィ ン ド ウ オブジ ェ ク トは参照で き ません。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト 名 混乱を避け る ために、デー タ ウ ィ ン ド ウ オブジ ェ ク ト と デー タ ウ ィ ン ド ウ コ ン ト ロ ールには、 異な る プ レ フ ィ ッ ク ス を付け て く だ さ い。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト には、 プ レ フ ィ ッ ク ス d_ を付け る のが一般的です。 た と えば、 デー タ ウ ィ ン ド ウ コ ン ト ロ ール名が dw_customer の場合、 それに対応す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト 名は d_customer に し ます。

PowerBuilder でのデー タ ウ ィ ン ド ウ コ ン ト ロールの操作

❖ ウ ィ ン ド ウにデー タ ウ ィ ン ド ウ コ ン ト ロールを配置するには 1 データ ウ ィ ン ド ウ コ ン ト ロ ールを 配置する ウ ィ ン ド ウ を 開き ま す。 2 メ ニ ュ ー バーか ら ［挿入｜コ ン ト ロ ール｜デー タ ウ ィ ン ド ウ］ を 選択 し ます。 3 コ ン ト ロ ールを表示す る 位置を ク リ ッ ク し ます。 ウ ィ ン ド ウ に空のデー タ ウ ィ ン ド ウ コ ン ト ロ ールが配置 さ れ ま す。 4 （オプシ ョ ン） デー タ ウ ィ ン ド ウ コ ン ト ロ ールのサ イ ズ を変更する には、 コ ン ト ロ ールを選択 し 、 いずれかのハ ン ド ル を ド ラ ッ グ し ます。 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の指定 デー タ ウ ィ ン ド ウ コ ン ト ロールを配置 し た ら 、 次は、 その コ ン ト ロ ー_{ルにデー タ ウ ィ ン ド ウ オブジ ェ ク ト を関連付け ます。} ❖ コ ン ト ロールにデー タ ウ ィ ン ド ウ オブジ ェ ク ト を関連付けるには 1 デー タ ウ ィ ン ド ウ プ ロ パテ ィ ビ ューで、 ［デー タ オブジ ェ ク ト ］ プ ロ パテ ィ の参照 （［...］） ボ タ ン を ク リ ッ ク し ます。 2 コ ン ト ロ ール内に配置す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト を選択 し 、 ［OK］ を ク リ ッ ク し ます。 デー タ ウ ィ ン ド ウ プ ロ パテ ィ ビ ュ ーの、 ［デー タ オブジ ェ ク ト ］ ボ ッ ク ス に、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の名前が表示 さ れま す。 3 （オプシ ョ ン） 必要であれば、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールのプ ロ パテ ィ を変更 し ます。

デー タ ウ ィ ン ド ウ オブジ ェ ク ト のコ ン ト ロールへの取 り 込み ユーザ側でデー タ ウ ィ ン ド ウ コ ン ト ロールを移動で き る よ う にする 実行時にユーザがデー タ ウ ィ ン ド ウ コ ン ト ロ ールを移動で き る よ う にす る には、コ ン ト ロ ールに タ イ ト ルを付けて、［ タ イ ト ル バー］ チ ェ ッ ク ボ ッ ク ス を選択 し ます。 こ れで、ユーザは、 タ イ ト ル バー を ド ラ ッ グ し て コ ン ト ロ ールを移動で き ます。

再利用可能なデー タ ウ ィ ン ド ウ

コ ン ト ロールの定義

アプ リ ケーシ ョ ン内のすべてのデー タ ウ ィ ン ド ウ コ ン ト ロ ールに、 同 じ 外観お よ び同 じ 動作を定義で き ます。た と えば、すべての コ ン ト ロ ー ルで同 じ エ ラ ー処理が可能です。 こ の よ う な動作を一度定義 し 、それを各 ウ ィ ン ド ウ で再利用す る には、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールを基に標準的なユーザ オブジ ェ ク ト を作成す る 必要があ り ます。 ユーザ オブジ ェ ク ト のプ ロ パテ ィ を定義 し 、 エ ラ ー処理な ど 必要な汎用処理 を行 う ス ク リ プ ト を作成 し ま す。 次に、 新 し いデー タ ウ ィ ン ド ウ コ ン ト ロ ールを作成す る のではな く 、 こ のユーザ オブジ ェ ク ト を ウ ィ ン ド ウ に配置 し ます。 デー タ ウ ィ ン ド ウ ユーザ オブジ ェ ク ト には、あ ら か じ め定義 さ れてい る目的の機能が すべて取 り 込ま れ ます。 再度指定す る 必要はあ り ません。 ユーザ オブ ジ ェ ク ト の作成方法お よ び使用方法につい て の詳細は、 PowerBuilder の 『ユーザーズ ガ イ ド』 マニ ュ アルを参照 し て く だ さ い。

コ ン ト ロール内のデー タ ウ ィ ン ド ウ

オブ ジ ェ ク ト の編集

デー タ ウ ィ ン ド ウ オブジ ェ ク ト を ウ ィ ン ド ウ 内のデー タ ウ ィ ン ド ウ コ ン ト ロ ール と 関連付け る と 、 デー タ ウ ィ ン ド ウ ペ イ ン タ に直接ア ク セ ス し て、 関連付け ら れてい る デー タ ウ ィ ン ド ウ オブジ ェ ク ト を編集 で き ます。 ❖ 関連付けられているデー タ ウ ィ ン ド ウ オブジ ェ ク ト を編集するには • デー タ ウ ィ ン ド ウ コ ン ト ロ ールの ポ ッ プ ア ッ プ メ ニ ュ ーか ら 、 ［デー タ ウ ィ ン ド ウ の修正］ を選択 し ます。 関連付け ら れ て い る デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト が、 デー タ ウ ィ ン ド ウ ペ イ ン タ 内で開き ます。

実行段階でのデー タ ウ ィ ン ド ウ

オブ ジ ェ ク ト の指定

デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト の変更 デー タ ウ ィ ン ド ウ_す。 オブジ ェ ク ト の変更方法は、 環境に よ っ て異な り ま • PowerBuilder DataObject プ ロ パテ ィ を、 アプ リ ケーシ ョ ンに組み 込んだいずれかのデー タ ウ ィ ン ド ウ オブジ ェ ク ト に設定 し ます。 • Web ActiveX 新 し い ラ イ ブ ラ リ フ ァ イ ルお よ びデー タ ウ ィ ン ド ウ を選択す る よ う に、SourceFileName および DataWindowObject プ ロ パテ ィ を設定 し ます。 • Web デー タ ウ ィ ン ド ウ Web タ ーゲ ッ ト オブジ ェ ク ト モデルを使 用 し ない場合は、Web デー タ ウ ィ ン ド ウ ジ ェ ネ レー タ コ ン ポーネ ン ト の SetDWObject メ ソ ッ ド を呼び出す こ と がで き ます。 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の変更時の ト ラ ンザク シ ョ ン オブジ ェ ク ト の 設定 実行時にデー タ ウ ィ ン ド ウ オブジ ェ ク ト を変更す る 場合、 setTrans ま たは setTransObject を再度呼び出 さ なければな ら ない こ と があ り ます。 詳細については、25 ページの 「デー タ ウ ィ ン ド ウ コ ン ト ロ ールへの ト ラ ンザ ク シ ョ ン オブジ ェ ク ト の設定」 を参照 し て く だ さ い。 データ ウィ ン ド ウ オ ブ ジ ェ ク ト の動的な 作成 実行時に新 し いデー タ ウ ィ ン ド ウ オブジ ェ ク ト を作成 し て、 コ ン ト ロ ール と 関連付け る こ と も で き ます。 詳細については、第 3 章の 「デー タ ウ ィ ン ド ウ オブジ ェ ク ト の動的変 更」 を参照 し て く だ さ い。

PowerBuilder でのデー タ ウ ィ ン ド ウの変更

デー タ ウ ィ ン ド ウ オブジ ェ ク ト を ウ ィ ン ド ウ 内の コ ン ト ロ ール と 関 連付け る と き には、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールの DataObject プ ロ パテ ィ の初期値を設定 し ます。 こ れ に よ っ て、 ア プ リ ケ ー シ ョ ン の 実行時 に は、 コ ン ト ロ ー ル の DataObject プ ロ パテ ィ に指定 さ れたデー タ ウ ィ ン ド ウ オブジ ェ ク ト の イ ン ス タ ン ス が作成 さ れ、 その イ ン ス タ ン ス が コ ン ト ロ ールで使用 さ れ ます。

デー タ ウ ィ ン ド ウ オブジ ェ ク ト のコ ン ト ロールへの取 り 込み コ ード での DataObject プロ パティ の設定 _{法以外に も 、コ ー ド 内で DataObject プ ロ パテ ィ の値を変更する こ と で、}ウ ィ ン ド ウ ペ イ ン タ でデー タ ウ ィ ン ド ウ オブジ ェ ク ト を指定す る 方 実行時に コ ン ト ロ ールに表示 さ れ る オブジ ェ ク ト を切 り 替え る こ と が で き ます。 例: デー タ ウ ィ ン ド ウ コ ン ト ロール dw_emp 内に、 ラ イ ブ ラ リ emp.pbl のデー タ ウ ィ ン ド ウ オブジ ェ ク ト d_emp_hist を表示する には、次の ス ク リ プ ト を記述 し ます。 dw_emp.DataObject = "d_emp_hist" デー タ ウ ィ ン ド ウ オブジ ェ ク ト d_emp_hist は、 デー タ ウ ィ ン ド ウ ペ イ ン タ で作成 さ れ、 アプ リ ケーシ ョ ン の検索パ ス 内の ラ イ ブ ラ リ に格 納 さ れてい ま す。 コ ン ト ロ ール dw_emp は ウ ィ ン ド ウ に取 り 込 ま れ、 ウ ィ ン ド ウ 定義の一部 と し て保存 さ れてい ます。 再描画を防ぐ方法 SetRedraw メ ソ ッ ド を使用 し て再描画機能を オ フ に し てお く と 、 オブ ジ ェ ク ト や コ ン ト ロ ールのプ ロ パテ ィ を い く つか変更 し た場合のち ら つ き を防ぎ、 再描画時間を短縮で き ます。 実行時にデー タ ウ ィ ン ド ウ オブジ ェ ク ト を動的に変更す る と 、 再描画機能は暗黙的にオ ン にな り ます。 再描画機能を再度オ フ にす る には、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト を変更す る たびに、SetRedraw メ ソ ッ ド を呼び出 し ます。 dw_emp.DataObject = "d_emp_hist" dw_emp.SetRedraw(FALSE) PSR フ ァ イ ルの使い方 実行時にデー タ ウ ィ ン ド ウ コ ン ト ロ ールに PSR フ ァ イ ルを取 り 込む には、 コ ン ト ロ ールの DataObject プ ロ パテ ィ に目的の PSR フ ァ イ ル名 を指定 し ます。

Web ActiveX でのデー タ ウ ィ ン ド ウの変更

デー タ ウ ィ ン ド ウ オブジ ェ ク ト をデー タ ウ ィ ン ド ウ コ ン ト ロ ール と 関連付け る と き は、 デー タ ウ ィ ン ド ウ コ ン ト ロ ールの SourceFileName お よ び DataWindowObject プ ロ パテ ィ の初期値を設定 し ます。 こ れに よ っ て、 アプ リ ケーシ ョ ン の実行時に次の処理が行われ ます。 1 コ ン ト ロ ールの SourceFileName プ ロ パテ ィ に指定 さ れた ラ イ ブ ラ リ （PBL フ ァ イ ル） ま たは ラ ン タ イ ム ラ イ ブ ラ リ （PBD フ ァ イ ル） 内のデー タ ウ ィ ン ド ウ オブジ ェ ク ト が検索 さ れます。