Fusion Middleware PL/SQL Web Toolkitリファレンス

11gリリース1（11.1.1）

部品番号: B56250-01(原本部品番号:E12042-01)

目次

表一覧

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 htpおよびhtfパッケージ

- 1.1 サマリー

- 1.2 htp.address

- 1.3 htp.anchor、htp.anchor2

- 1.4 htp.appletopen、htp.appletclose

- 1.5 htp.area

- 1.6 htp.base

- 1.7 htp.basefont

- 1.8 htp.bgsound

- 1.9 htp.big

- 1.10 htp.blockquoteOpen、htp.blockquoteClose

- 1.11 htp.bodyOpen、htp.bodyClose

- 1.12 htp.bold

- 1.13 htp.center

- 1.14 htp.centerOpen、htp.centerClose

- 1.15 htp.cite

- 1.16 htp.code

- 1.17 htp.comment

- 1.18 htp.dfn

- 1.19 htp.dirlistOpen、htp.dirlistClose

- 1.20 htp.div

- 1.21 htp.dlistOpen、htp.dlistClose

- 1.22 htp.dlistDef

- 1.23 htp.dlistTerm

- 1.24 htp.download_file

- 1.25 htp.get_download_files_list

- 1.26 htp.emphasis、htp.em

- 1.27 htf.escape_sc

- 1.28 htf.escape_url

- 1.29 htp.fontOpen、htp.fontClose

- 1.30 htf.format_cell

- 1.31 htp.formCheckbox

- 1.32 htp.formOpen、htp.formClose

- 1.33 htp.formFile

- 1.34 htp.formHidden

- 1.35 htp.formImage

- 1.36 htp.formPassword

- 1.37 htp.formRadio

- 1.38 htp.formReset

- 1.39 htp.formSelectOpen、htp.formSelectClose

- 1.40 htp.formSelectOption

- 1.41 htp.formSubmit

- 1.42 htp.formText

- 1.43 htp.formTextarea、htp.formTextarea2

- 1.44 htp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaClose

- 1.45 htp.frame

- 1.46 htp.framesetOpen、htp.framesetClose

- 1.47 htp.headOpen、htp.headClose

- 1.48 htp.header

- 1.49 htp.htmlOpen、htp.htmlClose

- 1.50 htp.img、htp.img2

- 1.51 htp.isindex

- 1.52 htp.italic

- 1.53 htp.keyboard、htp.kbd

- 1.54 htp.line、htp.hr

- 1.55 htp.linkRel

- 1.56 htp.linkRev

- 1.57 htp.listHeader

- 1.58 htp.listingOpen、htp.listingClose

- 1.59 htp.listItem

- 1.60 htp.mailto

- 1.61 htp.mapOpen、htp.mapClose

- 1.62 htp.menulistOpen、htp.menulistClose

- 1.63 htp.meta

- 1.64 htp.nl、htp.br

- 1.65 htp.nobr

- 1.66 htp.noframesOpen、htp.noframesClose

- 1.67 htp.olistOpen、htp.olistClose

- 1.68 htp.para、htp.paragraph

- 1.69 htp.param

- 1.70 htp.plaintext

- 1.71 htp.preOpen、htp.preClose

- 1.72 htp.print、htp.prn

- 1.73 htp.prints、htp.ps

- 1.74 htp.s

- 1.75 htp.sample

- 1.76 htp.script

- 1.77 htp.small

- 1.78 htp.strike

- 1.79 htp.strong

- 1.80 htp.style

- 1.81 htp.sub

- 1.82 htp.sup

- 1.83 htp.tableCaption

- 1.84 htp.tableData

- 1.85 htp.tableHeader

- 1.86 htp.tableOpen、htp.tableClose

- 1.87 htp.tableRowOpen、htp.tableRowClose

- 1.88 htp.teletype

- 1.89 htp.title

- 1.90 htp.ulistOpen、htp.ulistClose

- 1.91 htp.underline

- 1.92 htp.variable

- 1.93 htp.wbr

2 owa_cacheパッケージ

- 2.1 サマリー

- 2.2 owa_cache.disable

- 2.3 owa_cache.set_expires

- 2.4 owa_cache.set_cache

- 2.5 owa_cache.set_not_modified

- 2.6 owa_cache.get_level

- 2.7 owa_cache.get_etag

3 owa_cookieパッケージ

- 3.1 サマリー

- 3.2 owa_cookie.cookieデータ型

- 3.3 owa_cookie.getファンクション

- 3.4 owa_cookie.get_allプロシージャ

- 3.5 owa_cookie.removeプロシージャ

- 3.6 owa_cookie.sendプロシージャ

4 owa_imageパッケージ

- 4.1 サマリー

- 4.2 owa_image.NULL_POINTパッケージ変数

- 4.3 owa_image.pointデータ型

- 4.4 owa_image.get_xファンクション

- 4.5 owa_image.get_yファンクション

5 owa_opt_lockパッケージ

- 5.1 サマリー

- 5.2 owa_opt_lock.vcArrayデータ型

- 5.3 owa_opt_lock.checksumファンクション

- 5.4 owa_opt_lock.get_rowidファンクション

- 5.5 owa_opt_lock.store_valuesプロシージャ

- 5.6 owa_opt_lock.verify_valuesファンクション

6 owa_patternパッケージ

- 6.1 サブプログラム

- 6.2 正規表現

- 6.2.1 ワイルドカード・トークン

- 6.2.2 数量詞

- 6.2.3 フラグ

- 6.3 owa_pattern.amatchファンクション

- 6.4 owa_pattern.changeファンクションおよびプロシージャ

- 6.5 owa_pattern.getpatプロシージャ

- 6.6 owa_pattern.matchファンクション

- 6.7 owa_pattern.patternデータ型

7 owa_secパッケージ

- 7.1 サマリー

- 7.2 owa_sec.get_client_hostnameファンクション

- 7.3 owa_sec.get_client_ipファンクション

- 7.4 owa_sec.get_passwordファンクション

- 7.5 owa_sec.get_user_idファンクション

- 7.6 owa_sec.set_authorizationプロシージャ

- 7.7 owa_sec.set_protection_realmプロシージャ

8 owa_textパッケージ

- 8.1 サマリー

- 8.2 owa_text.add2multiプロシージャ

- 8.3 owa_text.multi_lineデータ型

- 8.4 owa_text.new_row_list

- 8.5 owa_text.print_multiプロシージャ

- 8.6 owa_text.print_row_listプロシージャ

- 8.7 owa_text.row_listデータ型

- 8.8 owa_text.stream2multiプロシージャ

- 8.9 owa_text.vc_arrデータ型

9 owa_utilパッケージ

- 9.1 サマリー

- 9.2 owa_util.bind_variablesファンクション

- 9.3 owa_util.calendarprintプロシージャ

- 9.4 owa_util.cellsprintプロシージャ

- 9.5 owa_util.choose_dateプロシージャ

- 9.6 owa_util.dateTypeデータ型

- 9.7 owa_util.get_cgi_envファンクション

- 9.8 owa_util.get_owa_service_pathファンクション

- 9.9 owa_util.get_procedureファンクション

- 9.10 owa_util.http_header_closeプロシージャ

- 9.11 owa_util.ident_arrデータ型

- 9.12 owa_util.ip_addressデータ型

- 9.13 owa_util.listprintプロシージャ

- 9.14 owa_util.mime_headerプロシージャ

- 9.15 owa_util.print_cgi_envプロシージャ

- 9.16 owa_util.redirect_urlプロシージャ

- 9.17 owa_util.showpageプロシージャ

- 9.18 owa_util.showsourceプロシージャ

- 9.19 owa_util.signatureプロシージャ

- 9.20 owa_util.status_lineプロシージャ

- 9.21 owa_util.tablePrintファンクション

- 9.22 owa_util.todateファンクション

- 9.23 owa_util.who_called_meプロシージャ

索引

表一覧

- 1-1 htp.address

- 1-2 htp.anchor、htp.anchor2

- 1-3 htp.appleton、htp.appletclose

- 1-4 htp.area

- 1-5 htp.base

- 1-6 htp.basefont

- 1-7 htp.bgsound

- 1-8 htp.big

- 1-9 htp.blockquoteOpen、htp.blockquoteClose

- 1-10 htp.bodyOpen、htp.bodyClose

- 1-11 htp.bold

- 1-12 htp.center

- 1-13 htp.centerOpen、htp.centerClose

- 1-14 htp.cite

- 1-15 htp.code

- 1-16 htp.comment

- 1-17 htp.dfn

- 1-18 htp.dirlistOpen、htp.dirlistClose

- 1-19 htp.div

- 1-20 htp.dlistOpen、htp.dlistClose

- 1-21 htp.dlistDef

- 1-22 htp.dlistTerm

- 1-23 htp.download_file

- 1-24 htp.get_download_files_list

- 1-25 htp.emphasis、htp.em

- 1-26 htf.escape_sc

- 1-27 htf.escape_url

- 1-28 htp.fontOpen、htp.fontClose

- 1-29 htf.format_cell

- 1-30 htp.formCheckbox

- 1-31 htp.formOpen、htp.formClose

- 1-32 htp.formFile

- 1-33 htp.formHidden

- 1-34 htp.formImage

- 1-35 htp.formPassword

- 1-36 htp.formRadio

- 1-37 htp.formReset

- 1-38 htp.formSelectOpen、htp.formSelectClose

- 1-39 htp.formSelectOption

- 1-40 htp.formSubmit

- 1-41 htp.formText

- 1-42 htp.formTextarea、htp.formTextarea2

- 1-43 htp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaClose

- 1-44 htp.frame

- 1-45 htp.framesetOpen、htp.framesetClose

- 1-46 htp.headOpen、htp.headClose

- 1-47 htp.header

- 1-48 htp.htmlOpen、htp.htmlClose

- 1-49 htp.img、htp.img2

- 1-50 htp.isindex

- 1-51 htp.italic

- 1-52 htp.keyboard、htp.kbd

- 1-53 htp.line、htp.hr

- 1-54 htp.linkRel

- 1-55 htp.linkRev

- 1-56 htp.listHeader

- 1-57 htp.listingOpen、htp.listingClose

- 1-58 htp.listltem

- 1-59 htp.mailto

- 1-60 htp.mapOpen、htp.mapClose

- 1-61 htp.menulistOpen、htp.menulistClose

- 1-62 htp.meta

- 1-63 htp.nl、htp.br

- 1-64 htp.nobr

- 1-65 htp.noframesOpen、htp.noframesClose

- 1-66 htp.olistOpen、htp.olistClose

- 1-67 htp.para、htp.paragraph

- 1-68 htp.param

- 1-69 htp.plaintext

- 1-70 htp.preOpen、htp.preClose

- 1-71 htp.print、htp.prn

- 1-72 htp.prints、htp.ps

- 1-73 htp.s

- 1-74 htp.sample

- 1-75 htp.script

- 1-76 htp.small

- 1-77 htp.strike

- 1-78 htp.strong

- 1-79 htp.style

- 1-80 htp.sub

- 1-81 htp.sup

- 1-82 htp.tableCaption

- 1-83 htp.tableData

- 1-84 htp.tableHeader

- 1-85 htp.tableOpen、htp.tableClose

- 1-86 htp.tableRowOpen、htp.tableRowClose

- 1-87 htp.teletype

- 1-88 htp.title

- 1-89 htp.ulistOpen、htp.ulistClose

- 1-90 htp.underline

- 1-91 htp.variable

- 1-92 htp.wbr

- 2-1 owa_cache.disable

- 2-2 owa_cache.set_expires

- 2-3 owa_cache.set_cache

- 2-4 owa_cache.set_not_modified

- 2-5 owa_cache.get_level

- 2-6 owa_cache.get_etag

- 3-1 owa_cookie.cookieデータ型

- 3-2 owa_cookie.getファンクション

- 3-3 owa_cookie.get_allプロシージャ

- 3-4 owa_cookie.removeプロシージャ

- 3-5 owa_cookie.sendプロシージャ

- 4-1 owa_image.NULL_POINTパッケージ変数

- 4-2 owa_image.pointデータ型

- 4-3 owa_image.get_xファンクション

- 4-4 owa_image.get_yファンクション

- 5-1 owa_opt_lock.vcArrayデータ型

- 5-2 owa_opt_lock.checksumファンクション

- 5-3 owa_opt_lock.get_rowidファンクション

- 5-4 owa_opt_lock.store_valuesプロシージャ

- 5-5 owa_opt_lock.verify_valuesファンクション

- 6-1 owa_patternパッケージが認識するワイルドカード・トークン

- 6-2 数量詞

- 6-3 フラグ

- 6-4 owa_pattern.amatchファンクション

- 6-5 owa_pattern.changeファンクションおよびプロシージャ

- 6-6 owa_pattern.getpatプロシージャ

- 6-7 owa_pattern.matchファンクション

- 6-8 owa_pattern.patternデータ型

- 7-1 owa_sec.get_client_hostnameファンクション

- 7-2 owa_sec.get_client_ipファンクション

- 7-3 owa_sec.get_passwordファンクション

- 7-4 owa_sec.get_user_idファンクション

- 7-5 owa_sec.set_authorizationプロシージャ

- 7-6 owa_sec.set_protection_realmプロシージャ

- 8-1 owa_text.add2multiプロシージャ

- 8-2 owa_text.multi_lineデータ型

- 8-3 owa_text.new_row_list

- 8-4 owa_text.print_multiプロシージャ

- 8-5 owa_text.print_row_listプロシージャ

- 8-6 owa_text.row_listデータ型

- 8-7 owa_text.stream2multiプロシージャ

- 8-8 owa_text.vc_arrデータ型

- 9-1 owa_util.bind_variablesファンクション

- 9-2 owa_util.calendarprintプロシージャ

- 9-3 owa_util.cellsprintプロシージャ

- 9-4 owa_util.choose_dateプロシージャ

- 9-5 owa_util.dateTypeデータ型

- 9-6 owa_util.get_cgi_envファンクション

- 9-7 owa_util.get_owa_service_pathファンクション

- 9-8 owa_util.get_procedureファンクション

- 9-9 owa_util.http_header_closeプロシージャ

- 9-10 owa_util.ident_arrデータ型

- 9-11 owa_util.ip_addressデータ型

- 9-12 owa_util.listprintプロシージャ

- 9-13 owa_util.mime_headerプロシージャ

- 9-14 owa_util.print_cgi_envプロシージャ

- 9-15 owa_util.redirect_urlプロシージャ

- 9-16 owa_util.showpageプロシージャ

- 9-17 owa_util.showsourceプロシージャ

- 9-18 owa_util.signatureプロシージャ

- 9-19 owa_util.status_lineプロシージャ

- 9-20 owa_util.tablePrintファンクション

- 9-21 owa_util.todateファンクション

- 9-22 owa_util.who_called_meプロシージャ

Oracle® Fusion Middleware

PL/SQL Web Toolkitリファレンス

11gリリース1（11.1.1）

部品番号: B56250-01(原本部品番号:E12042-01)

2009年9月

Oracle Fusion Middleware PL/SQL Web Toolkitリファレンス, 11gリリース1（11.1.1）

部品番号: B56250-01

Oracle Fusion Middleware PL/SQL Web Toolkit Reference, 11g Release 1 (11.1.1)

原本部品番号: E12042-01

原本著者: Showvik Roy Chowdhuri

原本協力者: Peter Lubbers, Pushkar Kapasi, Eric Lee

Copyright © 1996, 2009, Oracle and/or its affiliates. All rights reserved.

制限付権利の説明

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS

Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアを危険が伴うアプリケーションで使用する際、このソフトウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

このリファレンス・マニュアルでは、PL/SQL Web Toolkitのパッケージについて説明します。

対象読者

このガイドは、Oracle Fusion Middleware 11gリリース1（11.1.1）のPL/SQL Web Toolkitに関するリファレンスです。

ドキュメントのアクセシビリティについて

オラクル社は、障害のあるお客様にもオラクル社の製品、サービスおよびサポート・ドキュメントを簡単にご利用いただけることを目標としています。オラクル社のドキュメントには、ユーザーが障害支援技術を使用して情報を利用できる機能が組み込まれています。HTML形式のドキュメントで用意されており、障害のあるお客様が簡単にアクセスできるようにマークアップされています。標準規格は改善されつつあります。オラクル社はドキュメントをすべてのお客様がご利用できるように、市場をリードする他の技術ベンダーと積極的に連携して技術的な問題に対応しています。オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/accessibility/を参照してください。

ドキュメント内のサンプル・コードのアクセシビリティについて

スクリーン・リーダーは、ドキュメント内のサンプル・コードを正確に読めない場合があります。コード表記規則では閉じ括弧だけを行に記述する必要があります。しかしJAWSは括弧だけの行を読まない場合があります。

外部Webサイトのドキュメントのアクセシビリティについて

このドキュメントにはオラクル社およびその関連会社が所有または管理しないWebサイトへのリンクが含まれている場合があります。オラクル社およびその関連会社は、それらのWebサイトのアクセシビリティに関しての評価や言及は行っておりません。

聴覚に障害があるお客様のOracleサポート・サービスへのアクセス

Oracleサポート・サービスに連絡するには、電気通信リレー・サービス（TRS）をご利用いただき、Oracleサポート（+1-800-223-1711）までお電話ください。Oracleサポート・サービスの技術者が、Oracleサービス・リクエストのプロセスに従って、技術的な問題を処理し、お客様へのサポートを提供します。TRSの詳細情報はhttp://www.fcc.gov/cgb/consumerfacts/trs.htmlを、電話番号のリストはhttp://www.fcc.gov/cgb/dro/trsphonebk.htmlを参照してください。

関連ドキュメント

詳細は、次のマニュアルを参照してください。

- 『Oracle Fusion Middleware mod_plsqlユーザーズ・ガイド』

- 『Oracle Fusion Middleware概要』

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

サポートおよびサービス

次の各項に、各サービスに接続するためのURLを記載します。

Oracleサポート・サービス

オラクル製品サポートの購入方法、およびOracleサポート・サービスへの連絡方法の詳細は、次のURLを参照してください。

http://www.oracle.com/lang/jp/support/index.html

製品マニュアル

製品のマニュアルは、次のURLにあります。

http://www.oracle.com/technology/global/jp/documentation/index.html

研修およびトレーニング

研修に関する情報とスケジュールは、次のURLで入手できます。

http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=3

その他の情報

オラクル製品やサービスに関するその他の情報については、次のURLから参照してください。

http://www.oracle.com/lang/jp/index.html
http://www.oracle.com/technology/global/jp/index.html

注意:
ドキュメント内に記載されているURLや参照ドキュメントには、Oracle Corporationが提供する英語の情報も含まれています。日本語版の情報については、前述のURLを参照してください。

1 htpおよびhtfパッケージ

htp（hypertext procedures）パッケージおよびhtf（hypertext functions）パッケージにより、HTMLタグが生成されます。たとえば、htp.anchorプロシージャにより、HTMLのアンカー・タグ<A>が生成されます。次のコマンドは、簡単なHTMLドキュメントを生成します。

create or replace procedure hello AS
BEGIN
htp.htmlopen;           -- generates <HTML>
htp.headopen;           -- generates <HEAD>
htp.title('Hello');     -- generates <TITLE>Hello</TITLE>
htp.headclose;          -- generates </HEAD>
htp.bodyopen;           -- generates <BODY>
htp.header(1, 'Hello'); -- generates <H1>Hello</H1>
htp.bodyclose;          -- generates </BODY>
htp.htmlclose;          -- generates </HTML>
END;

HTMLタグを生成するhtpプロシージャにはすべて、同じパラメータを持った、対応するhtfファンクションが存在します。ファンクション・バージョンは、出力を直接Webページに生成しません。かわりに、出力を呼び出し元の文に戻り値として渡します。コールをネストする必要がある場合は、ファンクションを使用します。htfファンクションを調べるには、対応するhtpプロシージャのエントリを参照してください。

htfファンクションの結果を出力するには、htp.printプロシージャ内でファンクションをコールします。その結果、生成されたWebページにパラメータが出力されます。

注意:
htp.print、htp.prn、htp.prints、htp.pa、owa_util.cellsprintなどのプロシージャでLONGデータ型の値を使用する場合は、LONGデータの最初の32Kのみが使用されます。LONGデータは、プロシージャまたはファンクションのvarchar2データ型にバインドされます。

1.1 サマリー

HTMLタグ、HEADタグおよびBODYタグ

htp.htmlOpen、htp.htmlClose: <HTML>および</HTML>を生成します。

htp.headOpen、htp.headClose: <HEAD>および</HEAD>を生成します。

htp.bodyOpen、htp.bodyClose: <BODY>および</BODY>を生成します。

コメント・タグ

htp.comment: <!-- and -->を生成します。

<HEAD>領域のタグ

htp.base: <BASE>を生成します。

htp.linkRel: REL属性を含む<LINK>を生成します。

htp.linkRev: REV属性を含む<LINK>を生成します。

htp.title: <TITLE>を生成します。

htp.meta: <META>を生成します。

htp.script: <SCRIPT>を生成します。

htp.style: <STYLE>を生成します。

htp.isindex: <ISINDEX>を生成します。

アプレット・タグ

htp.appletopen、htp.appletclose: <APPLET>および</APPLET>を生成します。

htp.param: <PARAM>を生成します。

リスト・タグ

htp.olistOpen、htp.olistClose: <OL>および</OL>を生成します。

htp.ulistOpen、htp.ulistClose: <UL>および</UL>を生成します。

htp.dlistOpen、htp.dlistClose: <DL>および</DL>を生成します。

htp.dlistTerm: <DT>を生成します。

htp.dlistDef: <DD>を生成します。

htp.dirlistOpen、htp.dirlistClose: <DIR>および</DIR>を生成します。

htp.listHeader: <LH>を生成します。

htp.listingOpen、htp.listingClose: <LISTING>および</LISTING>を生成します。

htp.menulistOpen、htp.menulistClose: <MENU>および</MENU>を生成します。

htp.listItem: <LI>を生成します。

フォーム・タグ

htp.formOpen、htp.formClose: <FORM>および</FORM>を生成します。

htp.formCheckbox: <INPUT TYPE="CHECKBOX">を生成します。

htp.formHidden: <INPUT TYPE="HIDDEN">を生成します。

htp.formImage: <INPUT TYPE="IMAGE">を生成します。

htp.formPassword: <INPUT TYPE="PASSWORD">を生成します。

htp.formRadio: <INPUT TYPE="RADIO">を生成します。

htp.formSelectOpen、htp.formSelectClose: <SELECT>および</SELECT>を生成します。

htp.formSelectOption: <OPTION>を生成します。

htp.formText: <INPUT TYPE="TEXT">を生成します。

htp.formTextarea、htp.formTextarea2: <TEXTAREA>を生成します。

htp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaClose: <TEXTAREA>および</TEXTAREA>を生成します。

htp.formReset: <INPUT TYPE="RESET">を生成します。

htp.formSubmit: <INPUT TYPE="SUBMIT">を生成します。

テーブル・タグ

htp.tableOpen、htp.tableClose: <TABLE>および</TABLE>を生成します。

htp.tableCaption: <CAPTION>を生成します。

htp.tableRowOpen、htp.tableRowClose: <TR>および</TR>を生成します。

htp.tableHeader: <TH>を生成します。

htp.tableData: <TD>を生成します。

htf.format_cell: <TD>を生成します。

IMGタグ、HRタグおよびAタグ

htp.line、htp.hr: <HR>を生成します。

htp.img、htp.img2: <IMG>を生成します。

htp.anchor、htp.anchor2: <A>を生成します。

htp.mapOpen、htp.mapClose: <MAP>および</MAP>を生成します。

段落書式設定タグ

htp.header: 見出しタグ（<H1>〜<H6>）を生成します。

htp.para、htp.paragraph: <P>を生成します。

htp.print、htp.prn: 受け渡す任意のテキストを生成します。

htp.prints、htp.ps: 受け渡す任意のテキストを生成します。HTMLの特殊文字はエスケープされます。

htp.preOpen、htp.preClose: <PRE>および</PRE>を生成します。

htp.blockquoteOpen、htp.blockquoteClose: <BLOCKQUOTE>および</BLOCKQUOTE>を生成します。

htp.div: <DIV>を生成します。

htp.nl、htp.br: <BR>を生成します。

htp.nobr: <NOBR>を生成します。

htp.wbr: <WBR>を生成します。

htp.plaintext: <PLAINTEXT>を生成します。

htp.address: <ADDRESS>を生成します。

htp.mailto: MAILTO属性を含む<A>を生成します。

htp.area: <AREA>を生成します。

htp.bgsound: <BGSOUND>を生成します。

文字書式設定タグ

htp.basefont: <BASEFONT>を生成します。

htp.big: <BIG>を生成します。

htp.bold: <B>を生成します。

htp.center: <CENTER>および</CENTER>を生成します。

htp.centerOpen、htp.centerClose: <CENTER>および</CENTER>を生成します。

htp.cite: <CITE>を生成します。

htp.code: <CODE>を生成します。

htp.dfn: <DFN>を生成します。

htp.get_download_files_list: <EM>を生成します。

htp.fontOpen、htp.fontClose: <FONT>および</FONT>を生成します。

htp.italic: <I>を生成します。

htp.keyboard、htp.kbd: <KBD>および</KBD>を生成します。

htp.s: <S>を生成します。

htp.sample: <SAMP>を生成します。

htp.small: <SMALL>を生成します。

htp.strike: <STRIKE>を生成します。

htp.strong: <STRONG>を生成します。

htp.sub: <SUB>を生成します。

htp.sup: <SUP>を生成します。

htp.teletype: <TT>を生成します。

htp.underline: <U>を生成します。

htp.variable: <VAR>を生成します。

フレーム・タグ

htp.frame: <FRAME>を生成します。

htp.framesetOpen、htp.framesetClose: <FRAMESET>および</FRAMESET>を生成します。

htp.noframesOpen、htp.noframesClose: <NOFRAMES>および</NOFRAMES>を生成します。

1.2 htp.address

<ADDRESS>タグおよび</ADDRESS>タグを生成します。このタグは、ドキュメントのアドレス、作成者、および署名を指定します。

表1-1にhtp.addressのプロパティを示します。

表1-1 htp.address

プロパティ

定義

構文:

htp.address (
cvalue         in       varchar2
cnowrap        in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT
NULL);
htf.address (cvalue, cnowrap, cclear, cattributes) return varchar2;

パラメータ:

cvalue: <ADDRESS>タグと</ADDRESS>タグの間に挿入する文字列。

cnowrap: このパラメータの値がNULLではない場合、NOWRAP属性がタグに追加される。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<ADDRESS CLEAR="cclear" NOWRAP cattributes>cvalue</ADDRESS>

1.3 htp.anchor、htp.anchor2

HTMLの<A>タグおよび</A>タグを生成します。このタグは、ハイパーテキスト・リンクのソースまたはリンク先を指定します。このタグには複数の属性を使用できますが、HREFまたはNAMEのどちらかの属性は必須です。HREFはリンク先を指定します。NAMEを使用すると、このタグをハイパーテキスト・リンクのターゲットにすることができます。この2つのサブプログラムの違いは、htp.anchor2はターゲットを生成することによりフレームに使用できる点です。

表1-2にhtp.anchor、htp.anchor2のプロパティを示します。

表1-2 htp.anchor、htp.anchor2

プロパティ

定義

構文:

htp.anchor (
curl           in       varchar2
ctext          in       varchar2
cname          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.anchor (curl, ctext, cname, cattributes) return varchar2;

htp.anchor2 (
curl           in       varchar2
ctext          in       varchar2
cname          in       varchar2   DEFAULT NULL
ctarget        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.anchor2 (curl, ctext, cname, ctarget, cattributes) return varchar2;

パラメータ:

curl: HREF属性の値。

ctext: <A>タグと</A>タグの間に挿入する文字列。

cname: NAME属性の値。

ctarget: TARGET属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<A HREF="curl" NAME="cname" cattributes>ctext</A>

<A HREF="curl" NAME="cname" TARGET = "ctarget" cattributes>ctext</A>

1.4 htp.appletopen、htp.appletclose

htp.appletopenは、HTMLの<APPLET>タグを生成します。このタグは、Javaアプレットの呼び出しを開始します。アプレットの呼び出しは、HTMLの</APPLET>タグを生成するhtp.appletcloseを使用して終了します。

htp.paramプロシージャを使用して、Javaアプレットに対するパラメータを指定します。

PL/SQLカートリッジにはクラス・ファイルを検索する場所がわからないため、cattributesパラメータを使用してCODEBASE属性を指定します。CODEBASE属性では、クラス・ファイルを含む仮想パスを指定します。

表1-3にhtp.appletopen、htp.appletcloseのプロパティを示します。

表1-3 htp.appleton、htp.appletclose

プロパティ

定義

構文:

htp.appletopen(
ccode          in       varchar2
cheight        in       number
cwidth         in       number
cattributes    in       varchar2   DEFAULT NULL);
htf.appletopen(ccode, cheight, cwidth, cattributes) return varchar2;

htp.appletclose;
htf.appletclose return varchar2;

パラメータ:

ccode: CODE属性の値。アプレット・クラスの名前を指定する。

cheight: HEIGHT属性の値。

cwidth: WIDTH属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<APPLET CODE=ccode HEIGHT=cheight WIDTH=cwidth cattributes>

</APPLET>

例:

htp.appletopen('testclass.class', 100, 200, 'CODEBASE="/ows-applets"')
generates

<APPLET CODE="testclass.class" height=100 width=200 CODEBASE="/ows-applets">

1.5 htp.area

HTMLの<AREA>タグを生成します。このタグは、クライアント側のイメージ・マップを定義します。<AREA>タグでは、イメージ内の領域と、その領域のリンク先を定義します。

表1-4にhtp.areaのプロパティを示します。

表1-4 htp.area

プロパティ

定義

構文:

htp.area(
ccoords        in       varchar2
cshape         in       varchar2   DEFAULT NULL
chref          in       varchar2   DEFAULT NULL
cnohref        in       varchar2   DEFAULT NULL
ctarget        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.area(ccoords, cshape, chref, cnohref, ctarget, cattributes) return varchar2;

パラメータ:

ccoords: COORDS属性の値。

cshape: SHAPE属性の値。

chref: HREF属性の値。

cnohref: このパラメータの値がNULLではない場合、NOHREF属性がタグに追加される。

ctarget: TARGET属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<AREA COORDS="ccoords" SHAPE="cshape" HREF="chref" NOHREF TARGET="ctarget" cattributes>

1.6 htp.base

HTMLの<BASE>タグを生成します。このタグは、ドキュメントのURLを記録します。

表1-5にhtp.baseのプロパティを示します。

表1-5 htp.base

プロパティ

定義

構文:

htp.base(
ctarget        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.base(ctarget, cattributes) return varchar2;

パラメータ:

ctarget: TARGET属性の値。ドキュメント内の全リンクの対象となるウィンドウ名を設定する。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BASE HREF="<current URL>" TARGET="ctarget" cattributes>

1.7 htp.basefont

HTMLの<BASEFONT>タグを生成します。このタグは、Webページの基本フォント・サイズを指定します。

表1-6にhtp.basefontのプロパティを示します。

表1-6 htp.basefont

プロパティ

定義

構文:

htp.basefont(nsize in integer);
htf.basefont(nsize) return varchar2;

パラメータ:

nsize: SIZE属性の値。

実行結果:

<BASEFONT SIZE="nsize">

1.8 htp.bgsound

HTMLの<BGSOUND>タグを生成します。このタグは、Webページに音声を組み込みます。

表1-7にhtp.bgsoundのプロパティを示します。

表1-7 htp.bgsound

プロパティ

定義

構文:

htp.bgsound(
csrc           in       varchar2
cloop          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.bgsound(csrc, cloop, cattributes) return varchar2;

パラメータ:

csrc: SRC属性の値。

cloop: LOOP属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BGSOUND SRC="csrc" LOOP="cloop" cattributes>

1.9 htp.big

<BIG>タグおよび</BIG>タグを生成します。このタグは、大きいフォントでテキストをレンダリングするようブラウザに指示します。

表1-8にhtp.bigのプロパティを示します。

表1-8 htp.big

プロパティ

定義

構文:

htp.big(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.big(ctext, cattributes) return varchar2;

パラメータ:

ctext: タグの間に挿入するテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BIG cattributes>ctext</BIG>

1.10 htp.blockquoteOpen、htp.blockquoteClose

<BLOCKQUOTE>タグおよび</BLOCKQUOTE>タグを生成します。このタグは、引用されたテキストを表示する場所を定義します。

表1-9にhtp.blockquoteOpen、htp.blockquoteCloseのプロパティを示します。

表1-9 htp.blockquoteOpen、htp.blockquoteClose

プロパティ

定義

構文:

htp.blockquoteOpen (
cnowrap        in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.blockquoteOpen (cnowrap, cclear, cattributes) return varchar2;

htp.blockquoteClose;
htf.blockquoteClose return varchar2;

パラメータ:

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BLOCKQUOTE CLEAR="cclear" NOWRAP cattributes>

</BLOCKQUOTE>

1.11 htp.bodyOpen、htp.bodyClose

<BODY>タグおよび</BODY>タグを生成します。このタグは、HTMLドキュメントのボディ・セクションを定義します。

表1-10にhtp.bodyOpen、htp.bodyCloseのプロパティを示します。

表1-10 htp.bodyOpen、htp.bodyClose

プロパティ

定義

構文:

htp.bodyOpen(
cbackground    in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.bodyOpen(cbackground, cattributes) return varchar2;

htp.bodyClose;
htf.bodyClose return varchar2;

パラメータ:

cbackground: BACKGROUND属性の値。この属性は、ドキュメントの背景に使用するグラフィック・ファイルを指定する。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BODY background="cbackground" cattributes>

</BODY>

例:

htp.bodyOpen('/img/background.gif');
generates:
<BODY background="/img/background.gif">

1.12 htp.bold

<B>タグおよび</B>タグを生成します。このタグは、太字でテキストを表示するようブラウザに指示します。

表1-11にhtp.boldのプロパティを示します。

表1-11 htp.bold

プロパティ

定義

構文:

htp.bold (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.bold (ctext, cattributes) return varchar2;

パラメータ:

ctext: タグの間に挿入するテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<B cattributes>ctext</B>

1.13 htp.center

<CENTER>タグおよび</CENTER>タグを生成します。このタグは、Webページでテキストのセクションを中央揃えにします。

表1-12にhtp.centerのプロパティを示します。

表1-12 htp.center

プロパティ

定義

構文:

htp.center(ctext in varchar2);
htf.center(ctext in varchar2) return varchar2;

パラメータ:

ctext: 中央揃えにするテキスト。

実行結果:

<CENTER>ctext</CENTER>

1.14 htp.centerOpen、htp.centerClose

<CENTER>タグおよび</CENTER>タグを生成します。このタグは、テキストのセクションを中央揃えにすることを定義します。

表1-13にhtp.centerOpen、htp.centerCloseのプロパティを示します。

表1-13 htp.centerOpen、htp.centerClose

プロパティ

定義

構文:

htp.centerOpen;
htf.centerOpen return varchar2;

htp.centerClose;
htf.centerClose return varchar2;

パラメータ:

なし

実行結果:

<CENTER>

</CENTER>

1.15 htp.cite

<CITE>タグおよび</CITE>タグを生成します。このタグは、引用としてテキストをレンダリングするようブラウザに指示します。

表1-14にhtp.citeのプロパティを示します。

表1-14 htp.cite

プロパティ

定義

構文:

htp.cite (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.cite (ctext, cattributes) return varchar2;

パラメータ:

ctext: 引用としてレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<CITE cattributes>ctext</CITE>

1.16 htp.code

<CODE>タグおよび</CODE>タグを生成します。このタグは、等幅フォントでテキストをレンダリングするようブラウザに指示します。

表1-15にhtp.codeのプロパティを示します。

表1-15 htp.code

プロパティ

定義

構文:

htp.code (
ctext          in        varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.code (ctext, cattributes) return varchar2;

パラメータ:

ctext: コードとしてレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<CODE cattributes>ctext</CODE>

1.17 htp.comment

コメント・タグを生成します。

表1-16にhtp.commentのプロパティを示します。

表1-16 htp.comment

プロパティ

定義

構文:

htp.comment (ctext in varchar2);
htf.comment (ctext in varchar2) return varchar2;

パラメータ:

ctext: コメント。

実行結果:

<!-- ctext -->

1.18 htp.dfn

<DFN>タグおよび</DFN>タグを生成します。このタグは、イタリックでテキストをレンダリングするようブラウザに指示します。

表1-17にhtp.dfnのプロパティを示します。

表1-17 htp.dfn

プロパティ

定義

構文:

htp.dfn(ctext in varchar2);
htf.dfn(ctext in varchar2) return varchar2;

パラメータ:

ctext: イタリックでレンダリングするテキスト。

実行結果:

<DFN>ctext</DFN>

1.19 htp.dirlistOpen、htp.dirlistClose

<DIR>タグおよび</DIR>タグを生成します。このタグは、ディレクトリ・リスト・セクションを作成します。ディレクトリ・リストは、最大で20文字を含む項目のリストを表します。このリストの項目は、通常、24文字幅の列に配置されます。このタグの直後に<LI>タグを指定して、リストの項目を定義する必要があります。

表1-18にhtp.dirlistOpen、htp.dirlistCloseのプロパティを示します。

表1-18 htp.dirlistOpen、htp.dirlistClose

プロパティ

定義

構文:

htp.dirlistOpen;
htf.dirlistOpen return varchar2;

htp.dirlistClose;
htf.dirlistClose return varchar2;

パラメータ:

なし

実行結果:

<DIR>

</DIR>

1.20 htp.div

<DIV>タグを生成します。このタグは、ドキュメントの範囲を設定します。

表1-19にhtp.divのプロパティを示します。

表1-19 htp.div

プロパティ

定義

構文:

htp.div(
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.div(calign, cattributes) return varchar2;

パラメータ:

calign: ALIGN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<DIV ALIGN="calign" cattributes>

1.21 htp.dlistOpen、htp.dlistClose

<DL>タグおよび</DL>タグを生成します。このタグは、定義リストを作成します。定義リストは用語集に似ており、用語と定義が含まれています。用語はhtp.dlistTermを使用して挿入され、定義はhtp.dlistDefを使用して挿入されます。

表1-20にhtp.dlistOpen、htp.dlistCloseのプロパティを示します。

表1-20 htp.dlistOpen、htp.dlistClose

プロパティ

定義

構文:

htp.dlistOpen (
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.dlistOpen (cclear, cattributes) return varchar2;

htp.dlistClose;
htf.dlistClose return varchar2;

パラメータ:

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<DL CLEAR="cclear" cattributes>

</DL>

1.22 htp.dlistDef

<DD>タグを生成します。このタグは、用語の定義を挿入します。定義リスト<DL>で使用します。用語には<DT>タグが付き、定義には<DD>タグが付きます。

表1-21にhtp.dlistDefのプロパティを示します。

表1-21 htp.dlistDef

プロパティ

定義

構文:

htp.dlistDef(
ctext          in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.dlistDef(ctext, cclear, cattributes) return varchar2;

パラメータ:

ctext: 用語の定義。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<DD CLEAR="cclear" cattributes>ctext

1.23 htp.dlistTerm

<DT>タグを生成します。このタグは、定義リスト<DL>の用語を定義します。

表1-22にhtp.dlistTermのプロパティを示します。

表1-22 htp.dlistTerm

プロパティ

定義

構文:

htp.dlistTerm (
ctext          in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.dlistTerm (ctext, cclear, cattributes) return varchar2;

パラメータ:

ctext: 用語。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<DT CLEAR="cclear" cattributes>ctext

1.24 htp.download_file

データベースにファイルをアップロードした後は、ファイルをダウンロードしたり、データベースからファイルを削除したり、ファイルの属性を読み取ったり書き込んだりすることができます。

表1-23にhtp.download_fileのプロパティを示します。

表1-23 htp.download_file

プロパティ

定義

構文:

htp.download_file(
sFileName  in  varchar2
bCompress  in  boolean  DEFAULT FALSE);

パラメータ:

sFileName: ダウンロードするファイル。

bCompress: ファイルを圧縮するかどうか。

実行結果:

ダウンロードしたファイル。

1.25 htp.get_download_files_list

データベースにファイルをダウンロードした後に、ファイルを取得する必要がある場合に使用します。

表1-24にhtp.get_download_files_listのプロパティを示します。

表1-24 htp.get_download_files_list

プロパティ

定義

構文:

htp.get_download_files_list(
sFileName  out varchar2
bCompress  out binary_integer);

パラメータ:

sFileName: 取得するファイル。

bCompress: ファイルを圧縮するかどうか。

実行結果:

ダウンロードしたファイル。

1.26 htp.emphasis、htp.em

<EM>タグおよび</EM>タグを生成します。このタグは、強調表示するテキストを定義します。

表1-25にhtp.emphasis、htp.emのプロパティを示します。

表1-25 htp.emphasis、htp.em

プロパティ

定義

構文:

htp.em (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.em (ctext, cattributes) return varchar2;

htp.emphasis (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.emphasis (ctext, cattributes) return varchar2;

パラメータ:

ctext: 強調表示するテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<EM cattributes>ctext</EM>

1.27 htf.escape_sc

HTMLで特殊な意味を持つ文字を、エスケープ・シーケンスに置き換えます。次の文字が変換されます。

&→&amp;

"→&quot;

<→&lt;

>→&gt;

このサブプログラムのプロシージャ・バージョンは、htp.printsおよびhtp.psと同じ処理を行います。

表1-26にhtf.escape_scのプロパティを示します。

表1-26 htf.escape_sc

プロパティ

定義

構文:

htf.escape_sc(ctext in varchar2) return varchar2;
htp.escape_sc(ctext in varchar2);

パラメータ:

ctext: 変換する文字列。

実行結果:

変換された文字列。

1.28 htf.escape_url

HTMLおよびHTTPで特殊な意味を持つ文字を、エスケープ・シーケンスに置き換えます。次の文字が変換されます。

&→&amp;

"→&quot;

<→&lt;

>→&gt;

%→%25

表1-27にhtf.escape_urlのプロパティを示します。

表1-27 htf.escape_url

プロパティ

定義

構文:

htf.escape_url(p_url in varchar2) return varchar2;

パラメータ:

p_url: 変換する文字列。

実行結果:

変換された文字列。

注意:
このプロシージャは、下位互換性のためにのみ提供されています。URLエンコーディングに関するInternet Engineering Task Force（IETF）のRequest for Comments（RFC）の標準には準拠していません。URLをエンコードする必要がある場合は、Oracle Databaseで提供されるPL/SQLパッケージで使用できるutl_url.escape()ファンクションを使用することをお薦めします。

1.29 htp.fontOpen、htp.fontClose

<FONT>タグおよび</FONT>タグを生成します。このタグは、指定したフォント特性を使用するテキストのセクションを定義します。

表1-28にhtp.fontOpen、htp.fontCloseのプロパティを示します。

表1-28 htp.fontOpen、htp.fontClose

プロパティ

定義

構文:

htp.fontOpen(
ccolor         in       varchar2   DEFAULT NULL
cface          in       varchar2   DEFAULT NULL
csize          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.fontOpen(ccolor, cface, csize, cattributes) return varchar2;

htp.fontClose;
htf.fontClose return varchar2;

パラメータ:

ccolor: COLOR属性の値。

cface: FACE属性の値。

csize: SIZE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<FONT COLOR="ccolor" FACE="cface" SIZE="csize" cattributes>

</FONT>

1.30 htf.format_cell

htf.tableDataを使用して、HTML表内の列の値の書式を設定します。これにより、HTML表をより詳細に制御できます。

表1-29にhtf.format_cellのプロパティを示します。

表1-29 htf.format_cell

プロパティ

定義

構文:

htf.format_cell (
columnValue          in       varchar2
format_numbers       in       varchar2   DEFAULT NULL) return varchar2;

パラメータ:

columnValue: HTML表内で書式を設定する必要がある値。

format_numbers: 数値データを表示する書式。このパラメータの値がNULLでない場合は、数値フィールドは右揃えされ、小数点以下第2位に四捨五入される。

実行結果:

<TD>columnValue</TD>

1.31 htp.formCheckbox

TYPE="checkbox"属性を含む<INPUT>タグを生成します。このタグは、チェック・ボックス要素をフォームに挿入します。チェック・ボックス要素は、オンとオフの切替えができるボタンです。

表1-30にhtp.formCheckboxのプロパティを示します。

表1-30 htp.formCheckbox

プロパティ

定義

構文:

htp.formCheckbox (
cname          in       varchar2
cvalue         in       varchar2   DEFAULT 'on'
cchecked       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formCheckbox (cname, cvalue, cchecked, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

cvalue: VALUE属性の値。

cchecked: このパラメータの値がNULLではない場合は、CHECKED属性がタグに追加される。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="checkbox" NAME="cname" VALUE="cvalue" CHECKED cattributes>

1.32 htp.formOpen、htp.formClose

<FORM>タグおよび</FORM>タグを生成します。このタグは、HTMLドキュメント内のフォーム・セクションを作成します。

表1-31にhtp.formOpen、htp.formCloseのプロパティを示します。

表1-31 htp.formOpen、htp.formClose

プロパティ

定義

構文:

htp.formOpen (
curl           in       varchar2
cmethod        in       varchar2   DEFAULT 'POST'
ctarget        in       varchar2   DEFAULT NULL
cenctype       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formOpen (curl, cmethod, ctarget, cenctype, cattributes) return varchar2;

htp.formClose;
htf.formClose return varchar2;

パラメータ:

curl: フォームの内容の送信先であるWRBスクリプトまたはCGIスクリプトのURL。このパラメータは必須。

cmethod: METHOD属性の値。指定できる値はGETまたはPOST。

ctarget: TARGET属性の値。

cenctype: ENCTYPE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<FORM ACTION="curl" METHOD="cmethod" TARGET="ctarget" ENCTYPE="cenctype" cattributes>

</FORM>

1.33 htp.formFile

TYPE="file"属性を含む<INPUT>タグを生成します。このタグを使用してファイルを選択すると、フォームとともにそのファイル内容を送信できます。

表1-32にhtp.formFileのプロパティを示します。

表1-32 htp.formFile

プロパティ

定義

構文:

function formFile(
cname          in       varchar2
caccept        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formFile (cname, caccept, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

caccept: アップロードで使用するMIMEタイプのカンマ区切りリスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="file" NAME="cname" ACCEPT="caccept" cattributes>

1.34 htp.formHidden

TYPE="hidden"属性を含む<INPUT>タグを生成します。このタグは、表示されないフォーム要素を挿入します。この要素は、ユーザーからは見えません。スクリプトに追加の値を送信します。

表1-33にhtp.formHiddenのプロパティを示します。

表1-33 htp.formHidden

プロパティ

定義

構文:

htp.formHidden (
cname          in       varchar2
cvalue         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formHidden (cname, cvalue, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

cvalue: VALUE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="hidden" NAME="cname" VALUE="cvalue" cattributes>

1.35 htp.formImage

TYPE="image"属性を含む<INPUT>タグを生成します。このタグは、クリックするとフォームがただちに送信されるイメージ・フィールドを作成します。クリックされた点の座標はピクセルで測定され、名前と値の2つのペアで（フォームの他の内容とともに）返されます。X座標は.xが付加されたフィールド名で送信され、Y座標は.yが付加されたフィールド名で送信されます。VALUE属性はすべて無視されます。

表1-34にhtp.formImageのプロパティを示します。

表1-34 htp.formImage

プロパティ

定義

構文:

htp.formImage (
cname          in       varchar2
csrc           in       varchar2
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formImage (cname, csrc, calign, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

csrc: SRC属性の値。イメージ・ファイルを指定する。

calign: ALIGN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="image" NAME="cname" SRC="csrc" ALIGN="calign" cattributes>

1.36 htp.formPassword

TYPE="password"属性を含む<INPUT>タグを生成します。このタグは、1行のテキスト入力フィールドを作成します。ユーザーがフィールドにテキストを入力すると、各文字がアスタリスクで表示されます。このフィールドは、パスワードの入力に使用されます。

表1-35にhtp.formPasswordのプロパティを示します。

表1-35 htp.formPassword

プロパティ

定義

構文:

htp.formPassword (
cname          in       varchar2
csize          in       varchar2
cmaxlength     in       varchar2   DEFAULT NULL
cvalue         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formPassword (cname, csize, cmaxlength, cvalue, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

csize: SIZE属性の値。

cmaxlength: MAXLENGTH属性の値。

cvalue: VALUE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="password" NAME="cname" SIZE="csize" MAXLENGTH="cmaxlength" VALUE="cvalue" cattributes>

1.37 htp.formRadio

TYPE="radio"属性を含む<INPUT>タグを生成します。このタグは、ラジオ・ボタンをHTMLフォームに作成します。ラジオ・ボタンのセットの中で、選択できるものは1つのみです。同じセット内の各ラジオ・ボタンは、名前は同じですが値が異なります。ラジオ・ボタンが選択されると、名前と値のペアが生成されます。

表1-36にhtp.formRadioのプロパティを示します。

表1-36 htp.formRadio

プロパティ

定義

構文:

htp.formRadio (
cname          in       varchar2
cvalue         in       varchar2
cchecked       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formRadio (cname, cvalue, cchecked, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

cvalue: VALUE属性の値。

cchecked: このパラメータの値がNULLではない場合は、CHECKED属性がタグに追加される。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="radio" NAME="cname" VALUE="cvalue" CHECKED cattributes>

1.38 htp.formReset

TYPE="reset"属性を含む<INPUT>タグを生成します。このタグは、クリックするとフォームのフィールドが初期値にリセットされるボタンを作成します。

表1-37にhtp.formResetのプロパティを示します。

表1-37 htp.formReset

プロパティ

定義

構文:

htp.formReset (
cvalue         in       varchar2   DEFAULT 'Reset'
cattributes    in       varchar2   DEFAULT NULL);
htf.formReset (cvalue, cattributes) return varchar2;

パラメータ:

cvalue: VALUE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="reset" VALUE="cvalue" cattributes>

1.39 htp.formSelectOpen、htp.formSelectClose

<SELECT>タグおよび</SELECT>タグを生成します。このタグは、選択フォーム要素を作成します。選択フォーム要素は、1つ以上の値を選択できるリストボックスです。値は、htp.formSelectOptionを使用して挿入されます。

表1-38にhtp.formSelectOpen、htp.formSelectCloseのプロパティを示します。

表1-38 htp.formSelectOpen、htp.formSelectClose

プロパティ

定義

構文:

htp.formSelectOpen (
cname          in       varchar2
cprompt        in       varchar2   DEFAULT NULL
nsize          in       integer    DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formSelectOpen (cname, cprompt, nsize, cattributes) return varchar2;

htp.formSelectClose;
htf.formSelectClose return varchar2;

パラメータ:

cname: NAME属性の値。

cprompt: リストボックスの前に付加する文字列。

nsize: SIZE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

cprompt <SELECT NAME="cname" SIZE="nsize" cattributes>

</SELECT>

例:

htp.formSelectOpen('greatest_player',
'Pick the greatest player:');
htp.formSelectOption('Messier');
htp.formSelectOption('Howe');
htp.formSelectOption('Gretzky');.
htp.formSelectClose;

Generates:
Pick the greatest player:
<SELECT NAME="greatest_player">
<OPTION>Messier
<OPTION>Howe
<OPTION>Gretzky
</SELECT>

1.40 htp.formSelectOption

<OPTION>タグを生成します。選択要素内の1つの選択肢を表します。

表1-39にhtp.formSelectOptionのプロパティを示します。

表1-39 htp.formSelectOption

プロパティ

定義

構文:

htp.formSelectOption (
cvalue         in       varchar2
cselected      in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formSelectOption (cvalue, cselected, cattributes) return varchar2;

パラメータ:

cvalue: オプションのテキスト。

cselected: このパラメータの値がNULLでない場合は、SELECTED属性がタグに追加される。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<OPTION SELECTED cattributes>cvalue

例:

htp.formSelectOpen、htp.formSelectCloseを参照。

1.41 htp.formSubmit

TYPE="submit"属性を含む<INPUT>タグを生成します。このタグは、クリックするとフォームが送信されるボタンを作成します。

ボタンにNAME属性がある場合には、送信されるデータに名前と値のペアが付加されます。

表1-40にhtp.formSubmitのプロパティを示します。

表1-40 htp.formSubmit

プロパティ

定義

構文:

htp.formSubmit (
cname          in       varchar2   DEFAULT NULL
cvalue        in       varchar2   DEFAULT 'Submit'
cattributes    in       varchar2   DEFAULT NULL);
htf.formSubmit (cname, cvalue, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

cvalue: VALUE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="submit" NAME="cname" VALUE="cvalue" cattributes>

1.42 htp.formText

TYPE="text"属性を含む<INPUT>タグを生成します。このタグは、単一行のテキストのフィールドを作成します。

表1-41にhtp.formTextのプロパティを示します。

表1-41 htp.formText

プロパティ

定義

構文:

htp.formText (
cname          in       varchar2
csize          in       varchar2   DEFAULT NULL
cmaxlength    in       varchar2   DEFAULT NULL
cvalue         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formText (cname, csize, cmaxlength, cvalue, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

csize: SIZE属性の値。

cmaxlength: MAXLENGTH属性の値。

cvalue: VALUE属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<INPUT TYPE="text" NAME="cname" SIZE="csize" MAXLENGTH="cmaxlength" VALUE="cvalue" cattributes>

1.43 htp.formTextarea、htp.formTextarea2

<TEXTAREA>タグを生成します。このタグは、テキスト領域にテキストが事前に定義されていないテキスト・フィールドを作成します。このフィールドを使用すると、複数行のテキストを入力できます。

htp.formTextareaとhtp.formTextarea2の違いは、htp.formTextarea2には折り返しのスタイルを指定するcwrapパラメータがある点です。

表1-42にhtp.formTextarea、htp.formTextarea2のプロパティを示します。

表1-42 htp.formTextarea、htp.formTextarea2

プロパティ

定義

構文:

htp.formTextarea (
cname          in       varchar2
nrows          in       integer
ncolumns       in       integer
calign       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formTextarea (cname, nrows, ncolumns, calign, cattributes) return varchar2;

htp.formTextarea2 (
cname          in       varchar2
nrows          in       integer
ncolumns       in       integer
calign         in       varchar2   DEFAULT NULL
cwrap          in       varchar2   DEFAULT NULL
cattributes  in       varchar2   DEFAULT NULL);
htf.formTextarea2 (cname, nrows, ncolumns, calign, cwrap, cattributes) return varchar2;

パラメータ:

cname: NAME属性の値。

nrows: ROWS属性の値。整数。

ncolumns: COLS属性の値。整数。

calign: ALIGN属性の値。

cwrap: WRAP属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" cattributes></TEXTAREA>

<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" WRAP="cwrap" cattributes></TEXTAREA>

1.44 htp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaClose

<TEXTAREA>タグおよび</TEXTAREA>タグを生成します。このタグは、テキスト領域フォーム要素を作成します。htp.formTextareaOpenとhtp.formTextareaOpen2の違いは、htp.formTextareaOpen2には折り返しのスタイルを指定するcwrapパラメータがある点です。

表1-43にhtp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaCloseのプロパティを示します。

表1-43 htp.formTextareaOpen、htp.formTextareaOpen2、htp.formTextareaClose

プロパティ

定義

構文:

htp.formTextareaOpen (
cname          in       varchar2
nrows          in       integer
ncolumns       in       integer
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formTextareaOpen (cname, nrows, ncolumns, calign, cattributes) return varchar2;

htp.formTextareaOpen2(
cname          in       varchar2
nrows          in       integer
ncolumns       in       integer
calign         in       varchar2   DEFAULT NULL
cwrap          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.formTextareaOpen2(cname, nrows, ncolumns, calign, cwrap, cattributes) return varchar2;

htp.formTextareaClose;
htf.formTextareaClose return varchar2;

パラメータ:

cname: NAME属性の値。

nrows: ROWS属性の値。整数。

ncolumns: COLS属性の値。整数。

calign: ALIGN属性の値。

cwrap: WRAP属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" cattributes>

<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" WRAP = "cwrap" cattributes>

</TEXTAREA>

1.45 htp.frame

<FRAME>タグを生成します。このタグは、<FRAMESET>タグによって作成されるフレームの特性を定義します。

表1-44にhtp.frameのプロパティを示します。

表1-44 htp.frame

プロパティ

定義

構文:

htp.frame(
csrc           in       varchar2
cname          in       varchar2   DEFAULT NULL
cmarginwidth   in       varchar2   DEFAULT NULL
cmarginheight  in       varchar2   DEFAULT NULL
cscrolling     in       varchar2   DEFAULT NULL
cnoresize      in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.frame(csrc, cname, cmarginwidth, cmarginheight, cscrolling, cnoresize, cattributes) return varchar2;

パラメータ:

csrc: フレームに表示するURL。

cname: NAME属性の値。

cmarginwidth: MARGINWIDTH属性の値。

cmarginheight: MARGINHEIGHT属性の値。

cscrolling: SCROLLING属性の値。

noresize: このパラメータの値がNULLでない場合は、NORESIZE属性がタグに追加される。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<FRAME SRC="csrc" NAME="cname" MARGINWIDTH="cmarginwidth" MARGINHEIGHT="cmarginheight" SCROLLING="cscrolling" NORESIZE cattributes>

1.46 htp.framesetOpen、htp.framesetClose

<FRAMESET>タグおよび</FRAMESET>タグを生成します。このタグは、フレームセット・セクションを定義します。

表1-45にhtp.framesetOpen、htp.framesetCloseのプロパティを示します。

表1-45 htp.framesetOpen、htp.framesetClose

プロパティ

定義

構文:

htp.framesetOpen(
crows          in       varchar2   DEFAULT NULL
ccols          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.framesetOpen(crows, ccols, cattributes) return varchar2;

htp.framesetClose;
htf.framesetClose return varchar2;

パラメータ:

crows: ROWS属性の値。

ccols: COLS属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<FRAMESET ROWS="crows" COLS="ccols" cattributes>

</FRAMESET>

1.47 htp.headOpen、htp.headClose

<HEAD>タグおよび</HEAD>タグを生成します。このタグは、HTMLドキュメントのヘッダー・セクションを定義します。

表1-46にhtp.headOpen、htp.headCloseのプロパティを示します。

表1-46 htp.headOpen、htp.headClose

プロパティ

定義

構文:

htp.headOpen;
htf.headOpen return varchar2;

htp.headClose;
htf.headClose return varchar2;

パラメータ:

なし

実行結果:

<HEAD>

</HEAD>

1.48 htp.header

見出し開始タグ（<H1>〜<H6>）と、それに対応する終了タグ（</H1>〜</H6>）を生成します。

表1-47にhtp.headerのプロパティを示します。

表1-47 htp.header

プロパティ

定義

構文:

htp.header (

nsize          in       integer

cheader        in       varchar2

calign         in       varchar2   DEFAULT NULL

cnowrap        in       varchar2   DEFAULT NULL

cclear         in       varchar2   DEFAULT NULL

cattributes    in       varchar2   DEFAULT NULL);

htf.header (nsize, cheader, calign, cnowrap, cclear, cattributes) return varchar2;

パラメータ:

nsize: 見出しレベル。1〜6の整数値。

calign: ALIGN属性の値。

cheader: 見出しに表示するテキスト。

cnowrap: NOWRAP属性の値。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<Hnsize ALIGN="calign" NOWRAP CLEAR="cclear" cattributes>cheader</Hnsize>

例:

htp.header (1,'Overview');

次のような結果が生成される。

<H1>Overview</H1>

1.49 htp.htmlOpen、htp.htmlClose

<HTML>タグおよび</HTML>タグを生成します。これらのタグは、HTMLドキュメントの開始と終了を定義します。

表1-48にhtp.htmlOpen、htp.htmlCloseのプロパティを示します。

表1-48 htp.htmlOpen、htp.htmlClose

プロパティ

定義

構文:

htp.htmlOpen;
htf.htmlOpen return varchar2;

htp.htmlClose;
htf.htmlClose return varchar2;

パラメータ:

なし

実行結果:

<HTML>

</HTML>

1.50 htp.img、htp.img2

<IMG>タグを生成します。このタグは、HTMLページにイメージをロードするようブラウザに指示します。htp.imgとhtp.img2の違いは、htp.img2はcusemapパラメータを使用する点です。

表1-49にhtp.img、htp.img2のプロパティを示します。

表1-49 htp.img、htp.img2

プロパティ

定義

構文:

htp.img (
curl           in       varchar2   DEFAULT NULL
calign         in       varchar2   DEFAULT NULL
calt           in       varchar2   DEFAULT NULL
cismap         in       varchar2  DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.img (curl, calign, calt, cismap, cattributes) return varchar2;

htp.img2(
curl           in       varchar2   DEFAULT NULL
calign         in       varchar2   DEFAULT NULL
calt           in       varchar2   DEFAULT NULL
cismap         in       varchar2   DEFAULT NULL
cusemap        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.img2(curl, calign, calt, cismap, cusemap, cattributes) return varchar2;

パラメータ:

curl: SRC属性の値。

calign: ALIGN属性の値。

calt: ALT属性の値。ブラウザがイメージをサポートしていない場合に表示する代替テキストを指定する。

cismap: このパラメータの値がNULLでない場合は、ISMAP属性がタグに追加される。この属性は、イメージがイメージ・マップであることを示す。

cusemap: USEMAP属性の値。この属性は、クライアント側のイメージ・マップを指定する。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<IMG SRC="curl" ALIGN="calign" ALT="calt" ISMAP cattributes>

<IMG SRC="curl" ALIGN="calign" ALT="calt" ISMAP USEMAP="cusemap" cattributes>

1.51 htp.isindex

「値を入力してください」のようなプロンプト・テキストが付いた単一の入力フィールドを作成し、入力された値をページまたはプログラムのURLに送信します。

表1-50にhtp.isindexのプロパティを示します。

表1-50 htp.isindex

プロパティ

定義

構文:

htp.isindex (
cprompt        in       varchar2    DEFAULT NULL
curl           in       varchar2    DEFAULT NULL);
htf.isindex (cprompt, curl) return varchar2;

パラメータ:

cprompt: PROMPT属性の値。

curl: HREF属性の値。

実行結果:

<ISINDEX PROMPT="cprompt" HREF="curl">

1.52 htp.italic

<I>タグおよび</I>タグを生成します。このタグは、イタリックでテキストをレンダリングするようブラウザに指示します。

表1-51にhtp.italicのプロパティを示します。

表1-51 htp.italic

プロパティ

定義

構文:

htp.italic (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.italic (ctext, cattributes) return varchar2;

パラメータ:

ctext: イタリックでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<I cattributes>ctext</I>

1.53 htp.keyboard、htp.kbd

<KBD>タグおよび</KBD>タグを生成します。このタグは、等幅でテキストをレンダリングするようブラウザに指示します。htp.keyboardとhtp.kbdの機能は同じです。

表1-52にhtp.keyboard、htp.kbdのプロパティを示します。

表1-52 htp.keyboard、htp.kbd

プロパティ

定義

構文:

htp.keyboard (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.keyboard (ctext, cattributes) return varchar2;

htp.kbd (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.kbd (ctext, cattributes) return varchar2;

パラメータ:

ctext: 等幅でレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<KBD cattributes>ctext</KBD>

1.54 htp.line、htp.hr

<HR>タグを生成します。このタグは、HTMLドキュメントに罫線を作成します。

表1-53にhtp.line、htp.hrのプロパティを示します。

表1-53 htp.line、htp.hr

プロパティ

定義

用途

<HR>タグの生成。このタグは、HTMLドキュメントに罫線を作成する。

構文:

htp.line (
cclear         in       varchar2   DEFAULT NULL
csrc           in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.line (cclear, csrc, cattributes) return varchar2;

htp.hr (
cclear         in       varchar2   DEFAULT NULL
csrc           in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.hr (cclear, csrc, cattributes) return varchar2;

パラメータ:

cclear: CLEAR属性の値。

csrc: SRC属性の値。この属性は、罫線のソースとして使用するカスタム・イメージを指定する。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<HR CLEAR="cclear" SRC="csrc" cattributes>

1.55 htp.linkRel

REL属性を含む<LINK>タグを生成します。このタグは、アンカーからターゲットへのハイパーテキスト・リンクによって記述される関係を指定します。このタグは、HREF属性がある場合にのみ使用します。このタグは、ドキュメント間の関係は示しますが、リンクは作成しません。リンクを作成するには、htp.anchor、htp.anchor2を使用します。

表1-54にhtp.linkRelのプロパティを示します。

表1-54 htp.linkRel

プロパティ

定義

構文:

htp.linkRel (
crel           in       varchar2
curl           in       varchar2
ctitle         in       varchar2   DEFAULT NULL);
htf.linkRel (crel, curl, ctitle) return varchar2;

パラメータ:

crel: REL属性の値。

curl: HREF属性の値。

ctitle: TITLE属性の値。

実行結果:

<LINK REL="crel" HREF="curl" TITLE="ctitle">

1.56 htp.linkRev

REV属性を含む<LINK>タグを生成します。このタグは、ターゲットからアンカーへのハイパーテキスト・リンクによって記述される関係を指定します。このプロシージャは、htp.linkRelと逆の機能です。このタグは、ドキュメント間の関係は示しますが、リンクは作成しません。リンクを作成するには、htp.anchor、htp.anchor2を使用します。

表1-55にhtp.linkRevのプロパティを示します。

表1-55 htp.linkRev

プロパティ

定義

構文:

htp.linkRev (
crev           in       varchar2
curl           in       varchar2
ctitle         in    varchar2   DEFAULT NULL);
htf.linkRev (crev, curl, ctitle) return varchar2;

パラメータ:

crev: REV属性の値。

curl: HREF属性の値。

ctitle: TITLE属性の値。

実行結果:

<LINK REV="crev" HREF="curl" TITLE="ctitle">

1.57 htp.listHeader

<LH>タグおよび</LH>タグを生成します。このタグは、リストの先頭のHTMLタグを作成します。

表1-56にhtp.listHeaderのプロパティを示します。

表1-56 htp.listHeader

プロパティ

定義

構文:

htp.listHeader (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.listHeader (ctext, cattributes) return varchar2;

パラメータ:

ctext: <LH>と</LH>の間に挿入するテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<LH cattributes>ctext</LH>

1.58 htp.listingOpen、htp.listingClose

<LISTING>タグおよび</LISTING>タグを生成します。このタグは、HTMLページのボディ内での固定幅テキストのセクションを定義します。

表1-57にhtp.listingOpen、htp.listingCloseのプロパティを示します。

表1-57 htp.listingOpen、htp.listingClose

プロパティ

定義

構文:

htp.listingOpen;
htf.listingOpen return varchar2;

htp.listingClose;
htf.listingClose return varchar2;

パラメータ:

なし

実行結果:

<LISTING>

</LISTING>

1.59 htp.listItem

<LI>タグを生成します。このタグは、リスト項目を示します。

表1-58にhtp.listItemのプロパティを示します。

表1-58 htp.listltem

プロパティ

定義

構文:

htp.listItem (
ctext          in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cdingbat       in       varchar2   DEFAULT NULL
csrc           in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.listItem (ctext, cclear, cdingbat, csrc, cattributes) return varchar2;

パラメータ:

ctext: リスト項目のテキスト。

cclear: CLEAR属性の値。

cdingbat: DINGBAT属性の値。

csrc: SRC属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<LI CLEAR="cclear" DINGBAT="cdingbat" SRC="csrc" cattributes>ctext

1.60 htp.mailto

メール・アドレス引数の前にmailtoが付加されたHREF属性を含む<A>タグを生成します。

表1-59にhtp.mailtoのプロパティを示します。

表1-59 htp.mailto

プロパティ

定義

構文:

htp.mailto (
caddress       in       varchar2
ctext          in    varchar2
cname          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.mailto (caddress, ctext, cname, cattributes) return varchar2;

パラメータ:

caddress: 受信者の電子メール・アドレス。

ctext: リンクのクリック可能な部分。

cname: NAME属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<A HREF="mailto:caddress" NAME="cname" cattributes>ctext</A>

例:

htp.mailto('pres@white_house.gov','Send Email to the President');

次のような結果が生成される。

<A HREF="mailto:pres@white_house.gov">Send Email to the President</A>

1.61 htp.mapOpen、htp.mapClose

<MAP>タグおよび</MAP>タグを生成します。このタグは、クライアント側のイメージ・マップにおけるリージョンのセットを定義します。

表1-60にhtp.mapOpen、htp.mapCloseのプロパティを示します。

表1-60 htp.mapOpen、htp.mapClose

プロパティ

定義

構文:

htp.mapOpen(
cname          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.mapOpen(cname, cattributes) return varchar2;
htp.mapClose;
htf.mapClose return varchar2;

パラメータ:

cname: NAME属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<MAP NAME="cname" cattributes>

</MAP>

1.62 htp.menulistOpen、htp.menulistClose

<MENU>タグおよび</MENU>タグを生成します。このタグは、各項目を1行で表すリストを作成します。リスト内の項目の表示は、番号なしリストよりコンパクトです。メニュー・リスト内のリスト項目は、htp.listItemで定義します。

表1-61にhtp.menulistOpen、htp.menulistCloseのプロパティを示します。

表1-61 htp.menulistOpen、htp.menulistClose

プロパティ

定義

構文:

htp.menulistOpen;
htf.menulistOpen return varchar2;

htp.menulistClose;
htf.menulistClose return varchar2;

パラメータ:

なし

実行結果:

<MENU>

</MENU>

1.63 htp.meta

<META>タグを生成します。このタグは、ドキュメントに関するメタ情報を埋め込み、HTTPヘッダーの値も指定します。たとえば、有効期限、キーワード、作成者名などを指定します。

表1-62にhtp.metaのプロパティを示します。

表1-62 htp.meta

プロパティ

定義

構文:

htp.meta (
chttp_equiv    in       varchar2
cname          in       varchar2
ccontent       in       varchar2);
htf.meta (chttp_equiv, cname, ccontent) return varchar2;

パラメータ:

chttp_equiv: HTTP-EQUIV属性の値。

cname: NAME属性の値。

ccontent: CONTENT属性の値。

実行結果:

<META HTTP-EQUIV="chttp_equiv" NAME ="cname" CONTENT="ccontent">

例:

htp.meta ('Refresh', NULL, 120);

次のような結果が生成される。

<META HTTP-EQUIV="Refresh" CONTENT=120>

一部のWebブラウザでは、このようなタグを指定すると、現在のURLが120秒ごとに自動的にリロードされる。

1.64 htp.nl、htp.br

<BR>タグを生成します。このタグは、新しいテキスト行を開始します。

表1-63にhtp.nl、htp.brのプロパティを示します。

表1-63 htp.nl、htp.br

プロパティ

定義

構文:

htp.nl (
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.nl (cclear, cattributes) return varchar2;

htp.br (
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.br (cclear, cattributes) return varchar2;

パラメータ:

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<BR CLEAR="cclear" cattributes>

1.65 htp.nobr

<NOBR>タグおよび</NOBR>タグを生成します。このタグは、テキストのセクション内で自動改行を無効にします。

表1-64にhtp.nobrのプロパティを示します。

表1-64 htp.nobr

プロパティ

定義

構文:

htp.nobr(ctext in varchar2);
htf.nobr(ctext) return varchar2;

パラメータ:

ctext: 1行にレンダリングするテキスト。

実行結果:

<NOBR>ctext</NOBR>

1.66 htp.noframesOpen、htp.noframesClose

<NOFRAMES>タグおよび</NOFRAMES>タグを生成します。このタグは、noframesセクションを指定します。

表1-65にhtp.noframesOpen、htp.noframesCloseのプロパティを示します。

表1-65 htp.noframesOpen、htp.noframesClose

プロパティ

定義

構文:

htp.noframesOpen
htf.noframesOpen return varchar2;

htp.noframesClose
htf.noframesClose return varchar2;

パラメータ:

なし

実行結果:

<NOFRAMES>

</NOFRAMES>

関連項目:

「htp.frame」、「htp.framesetOpen、htp.framesetClose」

1.67 htp.olistOpen、htp.olistClose

<OL>タグおよび</OL>タグを生成します。このタグは、番号付きリストを定義します。番号付きリストは、番号の付いた項目のリストを表します。番号の付いた項目は、htp.listItemを使用して追加します。

表1-66にhtp.olistOpen、htp.olistCloseのプロパティを示します。

表1-66 htp.olistOpen、htp.olistClose

プロパティ

定義

構文:

htp.olistOpen (
cclear         in       varchar2   DEFAULT NULL
cwrap          in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.olistOpen (cclear, cwrap, cattributes) return varchar2;

htp.olistClose;
htf.olistClose return varchar2;

パラメータ:

cclear: CLEAR属性の値。

cwrap: WRAP属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<OL CLEAR="cclear" WRAP="cwrap" cattributes>

</OL>

1.68 htp.para、htp.paragraph

<P>タグを生成します。このタグは、タグの後に続くテキストを段落として書式設定することを示します。htp.paragraphを使用すると、属性をタグに追加できます。

表1-67にhtp.para、htp.paragraphのプロパティを示します。

表1-67 htp.para、htp.paragraph

プロパティ

定義

構文:

htp.para;
htf.para return varcahr2;

htp.paragraph (
calign         in       varchar2   DEFAULT NULL
cnowrap        in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.paragraph (calign, cnowrap, cclear, cattributes) return varchar2;

パラメータ:

calign: ALIGN属性の値。

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<P>

<P ALIGN="calign" NOWRAP CLEAR="cclear" cattributes>

1.69 htp.param

<PARAM>タグを生成します。このタグは、Javaアプレットに対するパラメータ値を指定します。値ではHTML変数を参照できます。WebページからJavaアプレットを呼び出すには、htp.appletopenを使用して呼び出しを開始します。必要な名前と値のペアごとに1つのhtp.paramを使用し、htp.appletcloseを使用してアプレットの呼び出しを終了します。

表1-68にhtp.paramのプロパティを示します。

表1-68 htp.param

プロパティ

定義

構文:

htp.param(
cname          in       varchar2
cvalue         in       varchar2);
htf.param(cname, cvalue) return varchar2;

パラメータ:

cname: NAME属性の値。

cvalue: VALUE属性の値。

実行結果:

<PARAM NAME=cname VALUE="cvalue">

1.70 htp.plaintext

<PLAINTEXT>タグおよび</PLAINTEXT>タグを生成します。このタグは、タグで囲まれているテキストを固定幅タイプでレンダリングするようブラウザに指示します。

表1-69にhtp.plaintextのプロパティを示します。

表1-69 htp.plaintext

プロパティ

定義

構文:

htp.plaintext(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.plaintext(ctext, cattributes) return varchar2;

パラメータ:

ctext: 固定幅フォントでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<PLAINTEXT cattributes>ctext</PLAINTEXT>

1.71 htp.preOpen、htp.preClose

<PRE>タグおよび</PRE>タグを生成します。このタグは、HTMLページのボディ内で事前に書式設定されているテキストのセクションを定義します。

表1-70にhtp.preOpen、htp.preCloseのプロパティを示します。

表1-70 htp.preOpen、htp.preClose

プロパティ

定義

構文:

htp.preOpen (
cclear         in       varchar2   DEFAULT NULL
cwidth         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.preOpen (cclear, cwidth, cattributes) return varchar2;

htp.preClose;
htf.preClose return varchar2;

パラメータ:

cclear: CLEAR属性の値。

cwidth: WIDTH属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<PRE CLEAR="cclear" WIDTH="cwidth" cattributes>

</PRE>

1.72 htp.print、htp.prn

htp.printは、指定されたパラメータを、改行文字\nで終了する文字列として生成します。文字\nは、<BR>とは異なります。文字\nはHTMLソースの書式を設定します。ブラウザがHTMLソースをレンダリングする方法には影響を与えません。ブラウザがHTMLソースをレンダリングする方法を制御するには、<BR>を使用します。

htp.prnは、指定されたパラメータを文字列として生成します。htp.printとは異なり、文字列の最後には改行文字\nは付加されません。これらのサブプログラムはプロシージャのみで、同名のファンクションはありません。

表1-71にhtp.print、htp.prnのプロパティを示します。

表1-71 htp.print、htp.prn

プロパティ

定義

構文:

htp.print (cbuf in varchar2);
htp.print (dbuf in date);
htp.print (nbuf in number);

htp.prn (cbuf in varchar2);
htp.prn (dbuf in date);
htp.prn (nbuf in number);

パラメータ:

cbuf、dbuf、nbuf: 生成する文字列。

実行結果:

htp.print: 改行で終了する文字列。

htp.prn: 指定された文字列。改行では終了しない。

1.73 htp.prints、htp.ps

このサブプログラムはどちらも、文字列を生成し、次の文字を対応するエスケープ・シーケンスに置き換えます。

<→&lt;

>→&gt;

"→&quot;

&→&amp;

これらの文字を置き換えないと、特殊文字はHTMLの制御文字として解釈され、想定外の出力が生成される可能性があります。このプロシージャは、文字が置換されること以外は、htp.prnと同じ機能です。これらのサブプログラムはプロシージャのみで、同名のファンクションはありません。文字列変換ファンクションが必要な場合は、htf.escape_scを使用してください。

表1-72にhtp.prints、htp.psのプロパティを示します。

表1-72 htp.prints、htp.ps

プロパティ

定義

構文:

htp.prints(ctext in varchar2);
htp.ps(ctext in varchar2);

パラメータ:

ctext: 文字の置換を行う文字列。

実行結果:

文字列。

1.74 htp.s

<S>タグおよび</S>タグを生成します。このタグは、タグで囲まれているテキストに取消し線を入れるようブラウザに指示します。

表1-73にhtp.sのプロパティを示します。

表1-73 htp.s

プロパティ

定義

構文:

htp.s(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.s(ctext, cattributes) return varchar2;

パラメータ:

ctext: 取消し線を入れるテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<S cattributes>ctext</S>

1.75 htp.sample

<SAMP>タグおよび</SAMP>タグを生成します。このタグは、タグで囲まれているテキストを等幅フォントでレンダリングするようブラウザに指示します。

表1-74にhtp.sampleのプロパティを示します。

表1-74 htp.sample

プロパティ

定義

構文:

htp.sample (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.sample (ctext, cattributes) return varchar2;

パラメータ:

ctext: 等幅フォントでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<SAMP cattributes>ctext</SAMP>

1.76 htp.script

<SCRIPT>タグおよび</SCRIPT>タグを生成します。このタグは、JavaScriptやVBscriptなどの言語で記述されたスクリプトを含みます。

表1-75にhtp.scriptのプロパティを示します。

表1-75 htp.script

プロパティ

定義

構文:

htp.script(
cscript        in       varchar2
clanguage      in       varchar2   DEFAULT NULL);
htf.script(cscript, clanguage) return varchar2;

パラメータ:

cscript: スクリプトのテキスト。これは、スクリプト自体を構成するテキストであり、スクリプトを含むファイルの名前ではない。

clanguage: スクリプトの記述に使用されている言語。このパラメータを省略すると、ユーザーのブラウザがスクリプト言語を判別する。

実行結果:

<SCRIPT LANGUAGE=clanguage>cscript</SCRIPT>

例:

htp.script ('script text here', 'Javascript');

generates:
<SCRIPT LANGUAGE=Javascript>"script text here"
</SCRIPT>

This causes the browser to run the script enclosed in the tags.

1.77 htp.small

<SMALL>タグおよび</SMALL>タグを生成します。このタグは、タグで囲まれているテキストを小さいフォントでレンダリングするようブラウザに指示します。

表1-76にhtp.smallのプロパティを示します。

表1-76 htp.small

プロパティ

定義

構文:

htp.small(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.small(ctext, cattributes) return varchar2;

パラメータ:

ctext: 小さいフォントでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<SMALL cattributes>ctext</SMALL>

1.78 htp.strike

<STRIKE>タグおよび</STRIKE>タグを生成します。このタグは、タグで囲まれているテキストに取消し線を入れるようブラウザに指示します。

表1-77にhtp.strikeのプロパティを示します。

表1-77 htp.strike

プロパティ

定義

構文:

htp.strike(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.strike(ctext, cattributes) return varchar2;

パラメータ:

ctext: 取消し線を入れるテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<STRIKE cattributes>ctext</STRIKE>

1.79 htp.strong

<STRONG>タグおよび</STRONG>タグを生成します。このタグは、タグで囲まれているテキストを太字でレンダリングするようブラウザに指示します。

表1-78にhtp.strongのプロパティを示します。

表1-78 htp.strong

プロパティ

定義

構文:

htp.strong (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.strong (ctext, cattributes) return varchar2;

パラメータ:

ctext: 強調するテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<STRONG cattributes>ctext</STRONG>

1.80 htp.style

<STYLE>タグおよび</STYLE>タグを生成します。このタグは、Webページにスタイル・シートを追加します。スタイル・シートはHTML 3.2の機能です。スタイル・シートの詳細は、http://www.w3.orgを参照してください。この機能は、HTMLバージョン2.0以下のみサポートするブラウザとは互換性がありません。このようなブラウザの場合、このタグを無視します。

表1-79にhtp.styleのプロパティを示します。

表1-79 htp.style

プロパティ

定義

構文:

htp.style(cstyle in varchar2);

htf.style(cstyle) return varchar2;

パラメータ:

cstyle: 組み込むスタイル情報。

実行結果:

<STYLE>cstyle</STYLE>

1.81 htp.sub

<SUB>タグおよび</SUB>タグを生成します。このタグは、タグで囲まれているテキストを下付きでレンダリングするようブラウザに指示します。

表1-80にhtp.subのプロパティを示します。

表1-80 htp.sub

プロパティ

定義

構文:

htp.sub(
ctext          in       varchar2
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.sub(ctext, calign, cattributes) return varchar2;

パラメータ:

ctext: 下付きでレンダリングするテキスト。

calign: ALIGN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<SUB ALIGN="calign" cattributes>ctext</SUB>

1.82 htp.sup

<SUP>タグおよび</SUP>タグを生成します。このタグは、タグで囲まれているテキストを上付きでレンダリングするようブラウザに指示します。

表1-81にhtp.supのプロパティを示します。

表1-81 htp.sup

プロパティ

定義

構文:

htp.sup(
ctext          in       varchar2
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.sup(ctext, calign, cattributes) return varchar2;

パラメータ:

ctext: 上付きでレンダリングするテキスト。

calign: ALIGN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<SUP ALIGN="calign" cattributes>ctext</SUB>

1.83 htp.tableCaption

<CAPTION>タグおよび</CAPTION>タグを生成します。このタグは、HTML表の見出しを設定します。

表1-82にhtp.tableCaptionのプロパティを示します。

表1-82 htp.tableCaption

プロパティ

定義

構文:

htp.tableCaption (
ccaption       in       varchar2
calign         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.tableCaption (ccaption, calign, cattributes) return varchar2;

パラメータ:

ccaption: 見出しのテキスト。

calign: ALIGN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<CAPTION ALIGN="calign" cattributes>ccaption</CAPTION>

1.84 htp.tableData

<TD>タグおよび</TD>タグを生成します。このタグは、HTML表のセルにデータを挿入します。

表1-83にhtp.tableDataのプロパティを示します。

表1-83 htp.tableData

プロパティ

定義

構文:

htp.tableData (
cvalue         in       varchar2   DEFAULT NULL
calign         in       varchar2   DEFAULT NULL
cdp            in       varchar2   DEFAULT NULL
cnowrap        in       varchar2   DEFAULT NULL
crowspan       in       varchar2   DEFAULT NULL
ccolspan       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.tableData (cvalue, calign, cdp, cnowrap, crowspan, ccolspan, cattributes) return varchar2;

パラメータ:

cvalue: テーブルのセルに挿入するデータ。

calign: ALIGN属性の値。

cdp: DP属性の値。

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

crowspan: ROWSPAN属性の値。

ccolspan: COLSPAN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TD ALIGN="calign" DP="cdp" ROWSPAN="crowspan" COLSPAN="ccolspan" NOWRAP cattributes>cvalue</TD>

1.85 htp.tableHeader

<TH>タグおよび</TH>タグを生成します。このタグは、HTMLテーブルにヘッダー・セルを挿入します。<TH>タグは<TD>タグと似ています。ただし、<TH>タグの場合、行のテキストは通常、太字でレンダリングされます。

表1-84にhtp.tableHeaderのプロパティを示します。

表1-84 htp.tableHeader

プロパティ

定義

構文:

htp.tableHeader (
cvalue         in       varchar2   DEFAULT NULL
calign         in       varchar2   DEFAULT NULL
cdp            in       varchar2   DEFAULT NULL
cnowrap        in       varchar2   DEFAULT NULL
crowspan       in       varchar2   DEFAULT NULL
ccolspan       in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.tableHeader (cvalue, calign, cdp, cnowrap, crowspan, ccolspan, cattributes) return varchar2;

パラメータ:

cvalue: テーブルのセルに挿入するデータ。

calign: ALIGN属性の値。

cdp: DP属性の値。

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

crowspan: ROWSPAN属性の値。

ccolspan: COLSPAN属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TH ALIGN="calign" DP="cdp" ROWSPAN="crowspan" COLSPAN="ccolspan" NOWRAP cattributes>cvalue</TH>

1.86 htp.tableOpen、htp.tableClose

<TABLE>タグおよび</TABLE>タグを生成します。このタグは、HTML表を定義します。

表1-85にhtp.tableOpen、htp.tableCloseのプロパティを示します。

表1-85 htp.tableOpen、htp.tableClose

プロパティ

定義

構文:

htp.tableOpen (
cborder        in       varchar2   DEFAULT NULL
calign         in       varchar2   DEFAULT NULL
cnowrap        in       varchar2   DEFAULT NULL
cclear         in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.tableOpen (cborder, calign, cnowrap, cclear, cattributes) return varchar2;

htp.tableClose;
htf.tableClose return varchar2;

パラメータ:

cborder: BORDER属性の値。

calign: ALIGN属性の値。

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

cclear: CLEAR属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TABLE "cborder" NOWRAP ALIGN="calign" CLEAR="cclear" cattributes>

</TABLE>

1.87 htp.tableRowOpen、htp.tableRowClose

<TR>タグおよび</TR>タグを生成します。このタグは、HTML表に新しい行を挿入します。

表1-86にhtp.tableRowOpen、htp.tableRowCloseのプロパティを示します。

表1-86 htp.tableRowOpen、htp.tableRowClose

プロパティ

定義

構文:

htp.tableRowOpen (
calign         in       varchar2   DEFAULT NULL
cvalign        in       varchar2   DEFAULT NULL
cdp            in       varchar2   DEFAULT NULL
cnowrap        in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL);
htf.tableRowOpen (calign, cvalign,cdp, cnowrap, cattributes) return varchar2;

htp.tableRowClose;
htp.tableRowClose return varchar2;

パラメータ:

calign: ALIGN属性の値。

cvalign: VALIGN属性の値。

cdp: DP属性の値。

cnowrap: このパラメータの値がNULLでない場合は、NOWRAP属性がタグに追加される。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TR ALIGN="calign" VALIGN="cvalign" DP="cdp" NOWRAP catttributes>

</TR>

1.88 htp.teletype

<TT>タグおよび</TT>タグを生成します。このタグは、タグで囲まれているテキストを、courierフォントなどの固定幅のタイプライタ・フォントでレンダリングするようブラウザに指示します。

表1-87にhtp.teletypeのプロパティを示します。

表1-87 htp.teletype

プロパティ

定義

構文:

htp.teletype (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.teletype (ctext, cattributes) return varchar2;

パラメータ:

ctext: 固定幅のタイプライタ・フォントでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<TT cattributes>ctext</TT>

1.89 htp.title

<TITLE>タグおよび</TITLE>タグを生成します。このタグは、ブラウザ・ウィンドウのタイトル・バーに表示するテキストを指定します。

表1-88にhtp.titleのプロパティを示します。

表1-88 htp.title

プロパティ

定義

構文:

htp.title (ctitle in varchar2);
htf.title (ctitle) return varchar2;

パラメータ:

ctitle: ブラウザ・ウィンドウのタイトル・バーに表示するテキスト。

実行結果:

<TITLE>ctitle</TITLE>

1.90 htp.ulistOpen、htp.ulistClose

<UL>タグおよび</UL>タグを生成します。このタグは、番号なしリストを定義します。番号なしリストでは、箇条書きの項目が表示されます。リストの項目は、htp.listItemで追加します。

表1-89にhtp.ulistOpen、htp.ulistCloseのプロパティを示します。

表1-89 htp.ulistOpen、htp.ulistClose

プロパティ

定義

構文:

htp.ulistOpen (
cclear         in       varchar2   DEFAULT NULL
cwrap          in       varchar2   DEFAULT NULL
cdingbat       in       varchar2   DEFAULT NULL
csrc           in       varchar2   DEFAULT NULL
cattributes    in       varchar2   DEFAULT NULL
htf.ulistOpen (cclear, cwrap, cdingbat, csrc, cattributes) return varchar2;

htp.ulistClose;
htf.ulistClose return varhar2;

パラメータ:

cclear: CLEAR属性の値。

cwrap: WRAP属性の値。

cdingbat: DINGBAT属性の値。

csrc: SRC属性の値。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<UL CLEAR="cclear" WRAP="cwrap" DINGBAT="cdingbat" SRC="csrc" cattributes>

</UL>

1.91 htp.underline

<U>タグおよび</U>タグを生成します。このタグは、タグで囲まれているテキストを下線付きでレンダリングするようブラウザに指示します。

表1-90にhtp.underlineのプロパティを示します。

表1-90 htp.underline

プロパティ

定義

構文:

htp.underline(
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.underline(ctext, cattributes) return varchar2;

パラメータ:

ctext: 下線付きでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<U cattributes>ctext</U>

1.92 htp.variable

<VAR>タグおよび</VAR>タグを生成します。このタグは、タグで囲まれているテキストをイタリックでレンダリングするようブラウザに指示します。

表1-91にhtp.variableのプロパティを示します。

表1-91 htp.variable

プロパティ

定義

構文:

htp.variable (
ctext          in       varchar2
cattributes    in       varchar2   DEFAULT NULL);
htf.variable (ctext, cattributes) return varchar2;

パラメータ:

ctext: イタリックでレンダリングするテキスト。

cattributes: タグにそのまま追加するその他の属性。

実行結果:

<VAR cattributes>ctext</VAR>

1.93 htp.wbr

<WBR>タグを生成します。このタグは、NOBRテキストのセクション内にソフト改行を挿入します。

表1-92にhtp.wbrのプロパティを示します。

表1-92 htp.wbr

プロパティ

定義

構文:

htp.wbr;
htf.wbr return wbr;

パラメータ:

なし

実行結果:

<WBR>

2 owa_cacheパッケージ

owa_cacheパッケージには、PL/SQL Webアプリケーションのパフォーマンスを向上するために、PL/SQL Gatewayのキャッシュ機能を使用可能にする、ファンクションとプロシージャが含まれています。この項では、これらのファンクションとプロシージャの仕様について説明します。

2.1 サマリー

owa_cache.disable: 特定のリクエストに対してキャッシュを無効にします。

owa_cache.set_expires: 有効期限モデルのキャッシュ・タイプにキャッシュ・ヘッダーを設定します。

owa_cache.set_cache: 検証モデルのキャッシュ・タイプにキャッシュ・ヘッダーを設定します。

owa_cache.set_not_modified: 変更されていないキャッシュ・ヒット用のヘッダーを設定します（検証方式モデルでのみ使用）。

owa_cache.get_level: キャッシュ・レベルを返します（検証方式モデルでのみ使用）。

owa_cache.get_etag: キャッシュされているコンテンツに関連したタグを返します（検証方式モデルでのみ使用）。

2.2 owa_cache.disable

特定のリクエストに対してキャッシュを無効にします。

表2-1にowa_cache.disableのプロパティを示します。

表2-1 owa_cache.disable

プロパティ

定義

パラメータ:

なし

例外:

なし

2.3 owa_cache.set_expires

キャッシュ・ヘッダーを有効期限モデル・キャッシュ・タイプに設定します。

表2-2にowa_cache.set_expiresのプロパティを示します。

表2-2 owa_cache.set_expires

プロパティ

定義

パラメータ:

p_expires IN: コンテンツが有効になっている時間（分単位）。

p_level IN: キャッシュ・レベル。

例外:

次のいずれかの場合は、VALUE_ERRORが発生する。

p_expiresが負またはゼロである。

p_level isがUSERまたはSYSTEMではない。

p_expiresが525600（1年）より大きい。

2.4 owa_cache.set_cache

キャッシュ・ヘッダーを検証モデル・キャッシュ・タイプに設定します。

表2-3にowa_cache.set_cacheのプロパティを示します。

表2-3 owa_cache.set_cache

プロパティ

定義

パラメータ:

p_etag IN: そのコンテンツに関連したタグ。

p_level IN: キャッシュ・レベル。

例外:

次のいずれかの場合は、VALUE_ERRORが発生する。

p_etagが55より大きい。

p_levelがUSERまたはSYSTEMではない。

2.5 owa_cache.set_not_modified

変更されていないキャッシュ・ヒット用のヘッダーを設定します。検証方式でのみ使用します。

表2-4にowa_cache.set_not_modifiedのプロパティを示します。

表2-4 owa_cache.set_not_modified

プロパティ

定義

例外:

ETagを渡さないと、VALUE_ERRORが発生する。

2.6 owa_cache.get_level

キャッシュ・レベルを返します。検証方式モデルでのみ使用します。

表2-5にowa_cache.get_levelのプロパティを示します。

表2-5 owa_cache.get_level

プロパティ

定義

戻り値:

キャッシュ・ヒットに対するキャッシュ・レベルの文字列（USERまたはSYSTEM）。それ以外の場合はNULL。

2.7 owa_cache.get_etag

キャッシュされているコンテンツに関連したタグを返します。検証方式でのみ使用します。

表2-6にowa_cache.get_etagのプロパティを示します。

表2-6 owa_cache.get_etag

プロパティ

定義

戻り値:

キャッシュ・ヒットに対するタグ。それ以外の場合はNULL。

3 owa_cookieパッケージ

owa_cookieパッケージには、HTTPのCookieをクライアントのブラウザに送信したり、ブラウザから取得したりするサブプログラムが含まれています。Cookieは、HTTPコール間で状態を保持するためにブラウザに送信される隠ぺいされた文字列です。状態は、クライアントのセッションが確立されている間のみ、または有効期限が指定されている場合は有効期限まで保持されます。システムの日付は、owa_customパッケージで指定されている情報に従って計算されます。

3.1 サマリー

owa_cookie.cookieデータ型: Cookieの名前/値ペアを格納するデータ型です。

owa_cookie.getファンクション: 指定したCookieの値を取得します。

owa_cookie.get_allプロシージャ: Cookieのすべての名前/値ペアを取得します。

owa_cookie.removeプロシージャ: 指定したCookieを削除します。

owa_cookie.sendプロシージャ: HTTPヘッダーにSet-Cookie行を追加します。

注意:
HTTPヘッダーはすべて英語で記述する必要があります。ヘッダーをデータベースから生成する場合は、ヘッダーが英語で作成されていることを確認してください。

3.2 owa_cookie.cookieデータ型

HTTP標準ではCookie名のオーバーロードが認められている（つまり、同じCookie名に複数の値を関連付けることができる）ので、このデータ型は、特定のCookie名と関連付けられている値をすべて保持するPL/SQL RECORDです。

vc_arr型は、table of varchar2(4000) index by binary_integerです。

表3-1にowa_cookie.cookieデータ型のプロパティを示します。

表3-1 owa_cookie.cookieデータ型

プロパティ

定義

構文:

type cookie is RECORD (
name           varchar2(4000),
vals           vc_arr,
num_vals       integer);

戻り値:

なし

3.3 owa_cookie.getファンクション

指定したCookieに関連する値が返されます。値はowa_cookie.cookieデータ型で返されます。

表3-2にowa_cookie.getファンクションのプロパティを示します。

表3-2 owa_cookie.getファンクション

プロパティ

定義

構文:

owa_cookie.get(name in varchar2) return cookie;

パラメータ:

name: Cookieの名前。

戻り値:

owa_cookie.cookieデータ型。

3.4 owa_cookie.get_allプロシージャ

クライアントのブラウザからすべてのCookie名とその値が返されます。値は、ブラウザから送信された順序で示されます。

表3-3にowa_cookie.get_allプロシージャのプロパティを示します。

表3-3 owa_cookie.get_allプロシージャ

プロパティ

定義

構文:

owa_cookie.get_all(
names          out      vc_arr,
vals           out      vc_arr,
num_vals       out      integer);

パラメータ:

names: Cookieの名前。

vals: Cookieの値。

num_vals: Cookieの名前/値ペアの数。

実行結果:

受信した順序での名前と値の配列、および組合せの数。

3.5 owa_cookie.removeプロシージャ

HTTPヘッダーのSet-Cookie行のexpiresフィールドを01-Jan-1990に設定することで、強制的にCookieを有効期限切れにします。このプロシージャは、HTTPヘッダーのコンテキスト内でコールされる必要があります。

表3-4にowa_cookie.removeプロシージャのプロパティを示します。

表3-4 owa_cookie.removeプロシージャ

プロパティ

定義

構文:

owa_cookie.remove(
name           in       varchar2,
val            in       varchar2,
path           in       varchar2   DEFAULT NULL);

パラメータ:

name: 有効期限切れにするCookieの名前。

value: Cookieの値。

path: 現在は使用されていない。

実行結果:

Set-Cookie: <name>=<value> expires=01-JAN-1990

3.6 owa_cookie.sendプロシージャ

Cookieをクライアントに送信するSet-Cookie行を生成します。このプロシージャは、HTTPヘッダーのコンテキスト内で使用する必要があります。

表3-5にowa_cookie.sendプロシージャのプロパティを示します。

表3-5 owa_cookie.sendプロシージャ

プロパティ

定義

構文:

owa_cookie.send(
name           in       varchar2,
value          in       varchar2,
expires        in       date       DEFAULT NULL,
path           in       varchar2   DEFAULT NULL,
domain         in       varchar2   DEFAULT NULL,
secure         in       varchar2   DEFAULT NULL),
httponly       in       varchar2   DEFAULT NULL),

パラメータ:

name: Cookieの名前。

value: Cookieの値。

expires: Cookieの有効期限が切れる日付。

path: pathフィールドの値。

domain: domainフィールドの値。

secure: このパラメータの値がNULLでない場合は、secureフィールドが行に追加される。

httponly: このパラメータの値がNULLでない場合は、HttpOnlyフィールドが行に追加される。

実行結果:

Set-Cookie: <name>=<value> expires=<expires> path=<path> domain=<domain> secure HttpOnly

注意:
HTTPOnly Cookieの詳細は、http://msdn.microsoft.com/en-us/default.aspxで「Mitigating Cross-site Scripting With HTTP-only Cookies」の項を参照してください。

4 owa_imageパッケージ

owa_imageパッケージには、ユーザーがクリックした画像上の座標を取得するサブプログラムが含まれています。PL/SQL Gatewayを呼び出す宛先リンクを含むイメージ・マップがある場合は、このパッケージを使用します。プロシージャは次のようになります。

create or replace procedure process_image
(my_img in owa_image.point)
as
x integer := owa_image.get_x(my_img);
y integer := owa_image.get_y(my_img);
begin
/* process the coordinate */
end

4.1 サマリー

owa_image.NULL_POINTパッケージ変数: XとYの値がNULLであるpoint型の変数です。

owa_image.pointデータ型: 座標のXとYの値を格納するデータ型です。

owa_image.get_xファンクション: point型のXの値を取得します。

owa_image.get_yファンクション: point型のYの値を取得します。

4.2 owa_image.NULL_POINTパッケージ変数

point型のこのパッケージ変数は、pointのパラメータをデフォルトに設定するために使用されます。この変数のXフィールドとYフィールドはどちらもNULLです。

表4-1にowa_image.NULL_POINTパッケージ変数のプロパティを示します。

表4-1 owa_image.NULL_POINTパッケージ変数

プロパティ

定義

構文:

null_point - package variable

戻り値:

なし

4.3 owa_image.pointデータ型

このデータ型は、イメージ・マップ上のユーザーがクリックした位置のX座標とY座標を提供します。次のように定義されます。

type point is table of varchar2(32767) index by binary_integer.

表4-2にowa_image.pointデータ型のプロパティを示します。

表4-2 owa_image.pointデータ型

プロパティ

定義

構文:

point - data type

戻り値:

なし

4.4 owa_image.get_xファンクション

このファンクションは、ユーザーがクリックしたイメージ・マップ上の位置のX座標を返します。

表4-3にowa_image.get_xファンクションのプロパティを示します。

表4-3 owa_image.get_xファンクション

プロパティ

定義

構文:

owa_image.get_x(p in point) return integer;

パラメータ:

p: ユーザーがクリックした位置。

戻り値:

整数で表されたX座標。

4.5 owa_image.get_yファンクション

このファンクションは、ユーザーがクリックしたイメージ・マップ上の位置のY座標を返します。

表4-4にowa_image.get_yファンクションのプロパティを示します。

表4-4 owa_image.get_yファンクション

プロパティ

定義

構文:

owa_image.get_y(p in point) return integer;

パラメータ:

p: ユーザーがクリックした位置。

戻り値:

整数で表されたY座標。

5 owa_opt_lockパッケージ

owa_opt_lockパッケージには、更新情報が失われるのを防ぐためにコミット時ロック方式を実施するサブプログラムが含まれています。ユーザーが更新しようとしている行が、作業中に他のユーザーによって変更されているかどうかを検査します。

HTTPはステートレスなプロトコルなので、PL/SQL Gatewayでは従来型のデータベース・ロック構造は使用できません。owa_opt_lockパッケージは、更新情報が失われる問題に対処するための2つの方法を提供します。

- 非表示フィールドを使用する方法は、HTMLページの非表示フィールドに以前の値を格納します。ユーザーが更新をリクエストすると、PL/SQL Gatewayは、これらの値とデータベースの現在の状態を比較して検査します。更新操作は、値が一致する場合にのみ実行されます。この方法を使用するには、owa_opt_lock.store_valuesプロシージャをコールします。

- チェックサムを使用する方法は、値そのものではなくチェックサムを格納します。この方法を使用するには、owa_opt_lock.checksumファンクションをコールします。

これらの方法はオプティミスティックです。他のユーザーが更新できないようにするのではなく、更新の割込みが発生した場合に現在の更新を無効にします。

5.1 サマリー

owa_opt_lock.vcArrayデータ型: ROWIDを格納するデータ型です。

owa_opt_lock.checksumファンクション: チェックサムの値を返します。

owa_opt_lock.get_rowidファンクション: ROWIDの値を返します。

owa_opt_lock.store_valuesプロシージャ: 後で検証するために、変更前の値を非表示フィールドに格納します。

owa_opt_lock.verify_valuesファンクション: 格納されている値と変更後の値を比較して検証します。

5.2 owa_opt_lock.vcArrayデータ型

このデータ型は、ROWIDを保持するためのPL/SQLの表です。

vcArray型は、table of varchar2(2000) index by binary_integerです。

このデータ型はowa_text.vc_arrデータ型とは異なることに注意してください。

表5-1にowa_opt_lock.vcArrayデータ型のプロパティを示します。

表5-1 owa_opt_lock.vcArrayデータ型

プロパティ

定義

構文:

owa_opt_lock.vcArray: データ型

戻り値:

なし

5.3 owa_opt_lock.checksumファンクション

指定された文字列または表内の行に対するチェックサムの値を返します。表内の行の場合は、その行の列の値に基づいてチェックサムの値を計算します。このファンクションには2つのバージョンがあります。

1番目のバージョンは、指定された文字列に基づくチェックサムを返します。これは、Internet 1プロトコルに基づいてデータベースにより実行される純粋な32ビット・チェックサムです。

2番目のバージョンは、表内の行の値に基づいてチェックサムを返します。これは、Internet 1プロトコルに基づく不純な32ビット・チェックサムです。

表5-2にowa_opt_lock.checksumファンクションのプロパティを示します。

表5-2 owa_opt_lock.checksumファンクション

プロパティ

定義

構文:

owa_opt_lock.checksum(p_buff in varchar2) return number;
owa_opt_lock.checksum(
p_owner        in       varchar2
p_tname        in       varchar2
p_rowid        in       rowid) return number;

パラメータ:

p_buff: チェックサムを計算する文字列。

p_owner: 表の所有者。

p_tname: 表の名前。

p_rowid: チェックサムの値を計算するp_tnameの行。vcArrayの値を適切なrowidに変換するには、owa_opt_lock.get_rowidファンクションを使用する。

戻り値:

チェックサムの値。

5.4 owa_opt_lock.get_rowidファンクション

指定されたowa_opt_lock.vcArrayデータ型からROWIDデータ型を返します。

表5-3にowa_opt_lock.get_rowidファンクションのプロパティを示します。

表5-3 owa_opt_lock.get_rowidファンクション

プロパティ

定義

構文:

owa_opt_lock.get_rowid(p_old_values in vcArray) return rowid;

パラメータ:

p_old_values: このパラメータは通常、HTMLフォームから渡される。

戻り値:

ROWID。

5.5 owa_opt_lock.store_valuesプロシージャ

後で更新する行の列の値を格納します。値は、HTMLフォームの非表示要素に格納されます。行を更新する前に、これらの値と行の現在の値を比較して、行の値が変更されていないことを確認します。値が変更されている場合は、ユーザーに警告を出し、更新を実行するかどうかをユーザーに決定させることができます。

表5-4にowa_opt_lock.store_valuesプロシージャのプロパティを示します。

表5-4 owa_opt_lock.store_valuesプロシージャ

プロパティ

定義

構文:

owa_opt_lock.store_values(
p_owner        in       varchar2
p_tname        in       varchar2
p_rowid        in       rowid);

パラメータ:

p_owner: 表の所有者。

p_tname: 表の名前。

p_rowid: 値を格納する行。

実行結果:

一連の非表示フォーム要素。

表の所有者に対して、1つの非表示フォーム要素が作成される。要素の名前はold_p_tname。ここで、p_tnameは表の名前。要素の値は所有者名。

表の名前に対して、1つの非表示フォーム要素が作成される。要素の名前はold_p_tname。ここで、p_tnameは表の名前。要素の値は表の名前。

行の列ごとに1つの要素が作成される。要素の名前はold_p_tname。ここで、p_tnameは表の名前。要素の値は列の値。

関連項目:

「owa_opt_lock.verify_valuesファンクション」

5.6 owa_opt_lock.verify_valuesファンクション

指定された行の値が、最後の問合せ以降に更新されているかどうかを検証します。このファンクションは、owa_opt_lock.store_valuesプロシージャとあわせて使用します。

表5-5にowa_opt_lock.verify_valuesファンクションのプロパティを示します。

表5-5 owa_opt_lock.verify_valuesファンクション

プロパティ

定義

構文:

owa_opt_lock.verify_values(p_old_values in vcArray) return boolean;

パラメータ:

p_old_values: 次の情報を含むPL/SQLの表。

p_old_values(1)は、表の所有者を示す。

p_old_values(2)は、表を示す。

p_old_values(3)は、検証する行のrowidを示す。

残りの索引には、表の列の値が含まれる。

通常、このパラメータはHTMLフォームから渡される。このHTMLフォームは、以前にowa_opt_lock.store_valuesプロシージャをコールして、非表示フォーム要素に行の値を格納したもの。

戻り値:

他の更新が実行されていない場合はTRUE、実行されている場合はFALSE。

関連項目:

「owa_opt_lock.store_valuesプロシージャ」

6 owa_patternパッケージ

PL/SQL Web Toolkitのowa_patternパッケージは、文字列内でテキストのパターンを検索し、一致した文字列を別の文字列に置き換えます。このパッケージのサブプログラムでは正規表現を使用します。

6.1 サブプログラム

正規表現: この項では、正規表現の構成で使用する特殊文字、数量詞、およびフラグについて説明します。

owa_pattern.amatchファンクション: 文字列に指定されたパターンが含まれるかどうかを判定します。一致を検索する文字列内の場所を指定できます。

owa_pattern.changeファンクションおよびプロシージャ: 文字列内のパターンを置き換えます。ファンクションとしてコールされた場合は、発見されて置換された正規表現の数を返します。

owa_pattern.getpatプロシージャ: VARCHAR2型からパターンのデータ型を生成します。

owa_pattern.matchファンクション: 文字列に指定されたパターンが含まれるかどうかを判定します。

owa_pattern.patternデータ型: 正規表現を格納するデータ型です。

これらのサブプログラムはオーバーロードされます。つまり、各サブプログラムには複数のバージョンがあり、使用するパラメータによって区別されます。具体的には、MATCHには6つのバージョン、AMATCHとCHANGEには4つのバージョンがあります。サブプログラムでは次のパラメータを使用します。

- line: 一致を検査する対象です。複数行のテキストまたはowa_text.multi_lineデータ型の場合があります。

- pat: サブプログラムがline中で検索するパターンです。このパターンには正規表現を使用できます。owa_pattern.changeファンクションおよびプロシージャでは、このパラメータはfrom_strという名前になっています。

- flags: 検索で大/小文字を区別するかどうか、または置換をグローバルに行うかどうかを指定します。

6.2 正規表現

様々なワイルドカード・トークンや数量詞を使用して検索する文字列を作成することで、正規表現を指定します。

6.2.1 ワイルドカード・トークン

ワイルドカード・トークンは、ワイルドカード・トークン以外のものと一致します。

表6-1では各ワイルドカード・トークンを定義します。

表6-1 owa_patternパッケージが認識するワイルドカード・トークン

トークン

説明

^

改行またはターゲットの先頭と一致する。

$

改行またはターゲットの最後と一致する。

\n

改行と一致する。

.

改行以外の任意の文字と一致する。

\t

タブと一致する。

\d

数字（0〜9）と一致する。

\D

数字以外（0〜9以外）と一致する。

\w

単語文字（0〜9、a〜z、A〜Z、または_）と一致する。

\W

単語文字以外（0〜9、a〜z、A〜Z、または_以外）と一致する。

\s

空白文字（ブランク、タブまたは改行）と一致する。

\S

空白文字以外（ブランク、タブまたは改行以外）と一致する。

\b

単語境界（\wと\Wの間）と一致する。

\x<HEX>

現行キャラクタ・セットにおける16進数2桁の値と一致する。

\<OCT>

現行キャラクタ・セットにおける8進数2桁または3桁の値と一致する。

\

別の方法でその文字との一致を指定できない任意の文字の前に付ける。

&

CHANGEに対してのみ適用される。これを使用すると、正規表現と一致した文字列を、それと置換する文字列に挿入可能。このトークンは、ターゲットの一致方法ではなく、ターゲットの変更方法を指定する点が、他のトークンと異なる。このトークンの詳細は、CHANGEを参照。

6.2.2 数量詞

&以外のトークンは、次のいずれかの数量詞を使用して意味を拡張できます。これらの数量詞はリテラルにも適用できます。

表6-2では各数量詞を定義します。

表6-2 数量詞

数量詞

説明

?

0または1回

*

0回以上

+

1回以上

{n}

n回

(n,}

n回以上

{n,m}

n回以上でm回以下

6.2.3 フラグ

owa_patternのファンクションおよびプロシージャでは、ターゲットおよび正規表現以外にも、フラグを使用してその解釈方法を変更できます。

表6-3ではフラグを定義します。

表6-3 フラグ

フラグ

説明

i

大/小文字を区別しない検索を示す。

g

CHANGEに対してのみ適用される。グローバルな置換を示す。つまり、正規表現と一致するターゲットのすべての部分が置換される。

6.3 owa_pattern.amatchファンクション

文字列内の特定の位置でパターンが発生するかどうかを指定します。このファンクションには4つのバージョンがあります。

- 1番目と2番目のバージョンは、一致したトークンを保存しません（3番目と4番目のバージョンでは、一致したトークンはbackrefsパラメータに保存されます）。1番目と2番目のバージョンの違いは、patパラメータです。このパラメータのデータ型は、VARCHAR2またはpatternです。

- このファンクションの3番目と4番目のバージョンは、一致したトークンをbackrefsパラメータに保存します。3番目と4番目のバージョンの違いは、patパラメータです。このパラメータのデータ型は、VARCHAR2またはpatternです。

注意:
オーバーラップする複数の文字列が正規表現と一致する場合は、最も長く一致する文字列が取得されます。

表6-4では、owa_pattern.amatchファンクションのプロパティを定義します。

表6-4 owa_pattern.amatchファンクション

プロパティ

定義

構文:

owa_pattern.amatch(
line           in       varchar2
from_loc       in       integer
pat            in       varchar2
flags          in       varchar2   DEFAULT NULL) return integer;

owa_pattern.amatch(
line           in       varchar2
from_loc       in       integer
pat            in out   pattern
flags          in       varchar2   DEFAULT NULL) return integer;

owa_pattern.amatch(
line           in       varchar2
from_loc       in       integer
pat            in   varchar2
backrefs       out      owa_text.vc_arr
flags          in       varchar2   DEFAULT NULL) return integer;

owa_pattern.amatch(
line           in       varchar2
from_loc       in       integer
pat            in out   pattern
backrefs       out      owa_text.vc_arr
flags          in       varchar2   DEFAULT NULL) return integer;

パラメータ:

line: 検索対象のテキスト。

from_loc: 検索を開始するline内の位置（文字数で指定）。

pat: 検索する文字列。正規表現を含めることが可能。データ型はVARCHAR2またはpattern。patternの場合、このパラメータの出力値は一致したパターン。

backrefs: 一致したテキスト。一致した各トークンは、owa_text.vc_arrデータ型のPL/SQL表のセルに格納される。

flags: 検索で大/小文字を区別するかどうか。このパラメータの値が「i」の場合、検索で大/小文字を区別しない。それ以外の場合は大/小文字が区別される。

戻り値:

一致が終了した後の文字の索引。lineの先頭から数えた値。一致するものがなかった場合は、0が返される。

6.4 owa_pattern.changeファンクションおよびプロシージャ

文字列またはmulti_lineデータ型を検索して置換します。オーバーラップする複数の文字列が正規表現と一致する場合は、最も長く一致する文字列が取得されます。

表6-5では、owa_pattern.changeファンクションおよびプロシージャのプロパティを定義します。

表6-5 owa_pattern.changeファンクションおよびプロシージャ

プロパティ

定義

構文:

/* function */
owa_pattern.change(
line           in out    varchar2
from_str       in        varchar2
to_str         in        varchar2
flags          in        varchar2   DEFAULT NULL) return integer;

/* procedure */
owa_pattern.change(
line           in out   varchar2
from_str       in       varchar2
to_str         in       varchar2
flags          in       varchar2   DEFAULT NULL);

/* function */
owa_pattern.change(
mline          in out   owa_text.multi_line
from_str       in       varchar2
to_str         in       varchar2
flags          in       varchar2   DEFAULT NULL) return integer;

/* procedure */
owa_pattern.change(
mline          in out   owa_text.multi_line
from_str       in       varchar2
to_str         in       varchar2
flags          in       varchar2   DEFAULT NULL);

パラメータ:

line: 検索対象のテキスト。このパラメータの出力値は、変更された文字列。

mline: 検索対象のテキスト。これは、owa_text.multi_lineデータ型。このパラメータの出力値は、変更された文字列。

from_str: 置換する正規表現。

to_str: 発見された文字列と置き換えるパターン。

flags: 大/小文字を区別して検索するかどうか、および変更をグローバルに行うかどうか。「i」を指定すると、検索で大/小文字を区別しない。「g」を指定すると、すべての一致に対して変更が行われる。指定しない場合、最初の一致を置換した後でファンクションは停止する。

戻り値:

ファンクションの場合、置換回数が返される。フラグ「g」を使用しないと、この数は0または1のみで、最初に一致したもののみが置換される。フラグ「g」を指定すると、正規表現と一致するものはすべて置換される。

例:

例1:

owa_pattern.change('Cats in pajamas', 'C.+in', '& red ')

正規表現はサブストリング「Cats in」と一致する。一致したサブストリングは、文字列「& red」と置き換えられる。アンパサンド文字（&）は正規表現と一致したものなので、「Cats in」を示す。したがって、文字列「Cats in pajamas」は、「Cats in red pajamas」に置換される。これをプロシージャではなくファンクションとしてコールすると、返される値は1になり、置換が1回行われたことを示す。

例2:

create or replace procedure test_pattern as theline VARCHAR2(256);
num_found integer;
begin
theline := 'what is the goal?';
num_found := owa_pattern.change(theline, 'goal', 'idea', 'g');
htp.print(num_found); -- num_found is 1
htp.print(theline); -- theline is 'what is the idea?'
end;
/
show errors

6.5 owa_pattern.getpatプロシージャ

VARCHAR2の文字列をowa_pattern.patternデータ型に変換します。

表6-6では、owa_pattern.getpatプロシージャのプロパティを定義します。

表6-6 owa_pattern.getpatプロシージャ

プロパティ

定義

構文:

owa_pattern.getpat(arg in VARCHAR2, pat in out pattern);

パラメータ:

arg: 変換する文字列。

pat: argで初期化されたowa_pattern.patternデータ型。

戻り値:

なし

6.6 owa_pattern.matchファンクション

文字列に指定されたパターンが含まれるかどうかを判定します。このパターンには正規表現を使用できます。オーバーラップする複数の文字列が正規表現と一致する場合は、最も長く一致する文字列が取得されます。

このファンクションの正規表現としては、VARCHAR2またはowa_pattern.patternデータ型を使用できます。文字列からowa_pattern.patternデータ型を作成するには、owa_pattern.getpatプロシージャを使用します。

長い文字列からmulti_lineデータ型を作成するには、owa_text.stream2multiプロシージャを使用します。multi_lineを使用した場合、rlistパラメータにより、検索された一致部分のリストが示されます。

lineが文字列でmulti_lineではない場合は、backrefsという名前のオプションの出力パラメータを追加できます。このパラメータはrow_listで、正規表現の一連のトークンと一致したターゲット内の各文字列を保持します。

表6-7では、owa_pattern.matchファンクションのプロパティを定義します。

表6-7 owa_pattern.matchファンクション

プロパティ

定義

構文:

owa_pattern.match(
line           in       varchar2
pat            in       varchar2
flags          in       varchar2   DEFAULT NULL) return boolean;

owa_pattern.match(
line           in       varchar2
pat            in out   pattern
flags          in       varchar2   DEFAULT NULL) return boolean;

owa_pattern.match(
line           in       varchar2
pat            in       varchar2
backrefs       out      owa_text.vc_arr
flags          in       varchar2   DEFAULT NULL) return boolean;

owa_pattern.match(
line           in       varchar2
pat            in out   pattern
backrefs       out      owa_text.vc_arr
flags          in       varchar2   DEFAULT NULL) return boolean;

owa_pattern.match(
mline          in       owa_text.multi_line
pat            in       varchar2
rlist          out      owa_text.row_list
flags          in       varchar2   DEFAULT NULL) return boolean;

owa_pattern.match(
mline          in       owa_text.multi_line
pat            in out   pattern
rlist          out      owa_text.row_list
flags          in       varchar2   DEFAULT NULL) return boolean;

パラメータ:

line: 検索対象のテキスト。

mline: 検索対象のテキスト。これは、owa_text.multi_lineデータ型。

pat: 検索パターン。VARCHAR2データ型またはowa_pattern.patternデータ型。patternの場合、このパラメータの出力値は一致したパターン。

backrefs: 一致したテキスト。一致した各トークンは、owa_text.vc_arrデータ型のPL/SQL表のセルに格納される。このパラメータはrow_listで、正規表現の一連のトークンと一致したターゲット内の各文字列を保持する。

rlist: 一致した文字列のリストを含む出力パラメータ。

flags: 検索で大/小文字を区別するかどうか。このパラメータの値が「i」の場合、検索で大/小文字を区別しない。それ以外の場合は大/小文字が区別される。

戻り値:

一致するものが検索された場合はTRUE、検索されない場合はFALSE。

例:

KAZOOは、正規表現zoo.*を検索するターゲット。ピリオドは改行以外の任意の文字を表し、アスタリスクは前にある文字の0回以上の出現と一致する。この例では、改行以外の任意の文字と一致する。

したがって、この正規表現では、一致するターゲットは、zooと、それに続いて、改行で終了しない、または改行を含んでいない（改行はピリオドと一致しない）、一連の任意の文字から構成されていることを指定している。フラグiは、検索で大/小文字を無視することを示す。この例では、ファンクションはTRUEを返し、一致するものが見つかったことを示す。

boolean foundMatch;
foundMatch := owa_pattern.match('KAZOO', 'zoo.*', 'i');

次に示す例では、「goal」の後に任意の文字が0回以上繰り返される文字列を、sometext内で検索する。

sometext  VARCHAR2(256);
pat       VARCHAR2(256);

sometext := 'what is the goal?'
pat := 'goal.*';
if owa.pattern.match(sometext, pat) then
htp.print('Match found');
else
htp.print('Match not found');
end if;

6.7 owa_pattern.patternデータ型

patternは、入力パラメータと出力パラメータの両方で使用できます。したがって、1回の解析のみで、同じ正規表現をOWA_PATTERNのファンクション・コールに渡すことができます。

表6-8では、owa_pattern.patternデータ型のプロパティを定義します。

表6-8 owa_pattern.patternデータ型

プロパティ

定義

構文:

owa_pattern.pattern - data type

戻り値:

なし

7 owa_secパッケージ

この章では、PL/SQL Web Toolkitのowa_secパッケージのファンクション、プロシージャ、およびデータ型について説明します。

注意:
owa_secパッケージのプロシージャとファンクションは、カスタム認証に使用します。

デフォルト値のあるパラメータはオプションです。

7.1 サマリー

owa_sec.get_client_hostnameファンクション: クライアントのホスト名を返します。

owa_sec.get_client_ipファンクション: クライアントのIPアドレスを返します。

owa_sec.get_passwordファンクション: ユーザーが入力したパスワードを返します。

owa_sec.get_user_idファンクション: ユーザーが入力したユーザー名を返します。

owa_sec.set_authorizationプロシージャ: PL/SQLアプリケーションがカスタム認証を使用できるようにします。

owa_sec.set_protection_realmプロシージャ: ページが含まれるレルムを定義します。

7.2 owa_sec.get_client_hostnameファンクション

クライアントのホスト名を返します。

表7-1では、owa_sec.get_client_hostnameファンクションのプロパティを定義します。

表7-1 owa_sec.get_client_hostnameファンクション

プロパティ

定義

構文:

owa_sec.get_client_hostname return varchar2;

パラメータ:

なし

戻り値:

ホスト名。

7.3 owa_sec.get_client_ipファンクション

クライアントのIPアドレスを返します。

表7-2では、owa_sec.get_client_ipファンクションのプロパティを定義します。

表7-2 owa_sec.get_client_ipファンクション

プロパティ

定義

構文:

owa_sec.get_client_ip return owa_util.ip_address;

パラメータ:

なし

戻り値:

IPアドレス。owa_util.ip_addressデータ型はPL/SQLの表であり、最初の4つの要素にはIPアドレスの4つの値が含まれる。たとえば、IPアドレスが123.45.67.89で、変数ipaddrがowa_util.ip_addressデータ型である場合、変数には次の値が含まれる。

ipaddr(1) = 123
ipaddr(2) = 45
ipaddr(3) = 67
ipaddr(4) = 89

7.4 owa_sec.get_passwordファンクション

ユーザーがログインの際に使用したパスワードを返します。セキュリティ上の理由から、このファンクションはカスタム認証が使用されている場合にのみ実際の値を返します。カスタム認証を使用していない場合に、このファンクションをコールすると、ファンクションは未定義の値を返します。したがって、データベース・パスワードは公開されません。

表7-3では、owa_sec.get_passwordファンクションのプロパティを定義します。

表7-3 owa_sec.get_passwordファンクション

プロパティ

定義

構文:

owa_sec.get_password return varchar2;

パラメータ:

なし

戻り値:

パスワード。

7.5 owa_sec.get_user_idファンクション

ユーザーがログインの際に使用したユーザー名を返します。

表7-4では、owa_sec.get_user_idファンクションのプロパティを定義します。

表7-4 owa_sec.get_user_idファンクション

プロパティ

定義

構文:

owa_sec.get_user_id return varchar2;

パラメータ:

なし

戻り値:

ユーザー名。

7.6 owa_sec.set_authorizationプロシージャ

このプロシージャは、owa_customパッケージの初期化部分でコールされ、PL/SQL Gatewayに対して認証方式を設定します。このプロシージャはauthorizeファンクションを実装します。このファンクションは、ユーザーがリクエストするプロシージャが実行される前に、ユーザーを認証します。authorizeファンクションの配置場所は、選択した方式によって異なります。

表7-5では、owa_sec.set_authorizationプロシージャのプロパティを定義します。

表7-5 owa_sec.set_authorizationプロシージャ

プロパティ

定義

構文:

owa_sec.set_authorization(scheme in integer);

パラメータ:

scheme: 認証方式。set_authorizationの場合、次のいずれかの方式。

OWA_SEC.NO_CHECK: この指定では、PL/SQLアプリケーションにより、いずれのカスタム認証も行われない。デフォルトの設定。

OWA_SEC.GLOBAL: 全ユーザーおよび全プロシージャに対してコールされる認証ファンクションを定義する。このファンクションは、SYSスキーマのowa_custom.authorizeファンクション。

OWA_SEC.PER_PACKAGE: パッケージ内のプロシージャまたは無名プロシージャがコールされるときにコールされる、authorizeファンクションを定義する。プロシージャがパッケージ内にある場合は、ユーザーのスキーマ内のpackage.authorizeファンクションがコールされて、ユーザーを認証する。プロシージャがパッケージ内にない場合は、ユーザーのスキーマ内の無名authorizeファンクションがコールされる。

OWA_SEC.CUSTOM: ユーザーごとに異なる認証ファンクションを実装する。ユーザーを認証するために、ユーザーのスキーマ内のowa_custom.authorizeファンクションがコールされる。ユーザーのスキーマにowa_custom.authorizeファンクションが含まれない場合、PL/SQL GatewayはSYSスキーマ内でファンクションを検索する。

カスタムauthorizeファンクションのシグネチャは次のとおり。

function authorize return boolean;

ファンクションがTRUEを返した場合、認証は成功。FALSEを返した場合、認証は失敗。authorizeファンクションが定義されていない場合には、Gatewayはエラーを返して失敗する。

戻り値:

なし

7.7 owa_sec.set_protection_realmプロシージャ

ユーザーに対して返されるページのレルムを設定します。ユーザーは、レルム内にすでに存在しているユーザー名を入力してログインします。

表7-6では、owa_sec.set_protection_realmプロシージャのプロパティを定義します。

表7-6 owa_sec.set_protection_realmプロシージャ

プロパティ

定義

構文:

owa_sec.set_protection_realm(realm in varchar2);

パラメータ:

realm: ページが属するレルム。ユーザーに対してはこの文字列が表示される。

戻り値:

なし

8 owa_textパッケージ

owa_textパッケージには、文字列を操作するためにowa_patternが使用するサブプログラムが含まれます。サブプログラムは直接使用できるように外部化されています。

8.1 サマリー

owa_text.add2multiプロシージャ: 既存のmulti_line型にテキストを追加します。

owa_text.multi_lineデータ型: 大量のテキストを保持するためのデータ型です。

owa_text.new_row_list: 新しいrow_listを作成します。

owa_text.print_multiプロシージャ: multi_listの内容を出力します。

owa_text.print_row_listプロシージャ: row_listの内容を出力します。

owa_text.row_listデータ型: 処理するデータを保持するためのデータ型です。

owa_text.stream2multiプロシージャ: varchar2をmulti_line型に変換します。

owa_text.vc_arrデータ型: 大量のテキストを保持するためのデータ型です。

8.2 owa_text.add2multiプロシージャ

既存のowa_text.multi_lineデータ型に内容を追加します。

表8-1にowa_text.add2multiプロシージャのプロパティを示します。

表8-1 owa_text.add2multiプロシージャ

プロパティ

定義

構文:

owa_text.add2multi(
stream         in       varchar2
mline          in out   multi_line
continue       in       boolean   DEFAULT TRUE);

パラメータ:

stream: 追加するテキスト。

mline: owa_text.multi_lineデータ型。このパラメータの出力には、streamが含まれる。

continue: TRUEの場合、前回の最後の行にstreamが追加される（32K未満の場合）。FALSEの場合、新しい行にstreamが格納される。

戻り値:

なし

8.3 owa_text.multi_lineデータ型

このデータ型は、大量のテキストを保持するPL/SQLレコードです。レコード内のテキスト・データは、owa_text.vc_arrデータ型のrowsフィールドに含まれます。

表8-2にowa_text.multi_lineデータ型のプロパティを示します。

表8-2 owa_text.multi_lineデータ型

プロパティ

定義

構文:

type multi_line is record (
rows           vc_arr,
num_rows       integer,
partial_row    boolean);

戻り値:

なし

8.4 owa_text.new_row_list

このファンクションまたはプロシージャは、新しいowa_text.row_listデータ型を作成します。ファンクション・バージョンは、パラメータを使用せず、新しい空のrow_listを返します。プロシージャ・バージョンは、出力パラメータとしてrow_listデータ型を作成します。

表8-3にowa_text.new_row_listのプロパティを示します。

表8-3 owa_text.new_row_list

プロパティ

定義

構文:

/* procedure */
owa_text.new_row_list(rlist out row_list);
/* function */
owa_text.new_row_list return row_list;

パラメータ:

rlist: 新しいrow_listデータ型を含む出力パラメータ。

戻り値:

ファンクション・バージョンは、新しいrow_listデータ型を返す。

8.5 owa_text.print_multiプロシージャ

htp.printおよびhtp.prnを使用して、owa_text.multi_lineデータ型のrowsフィールドを出力します。

表8-4にowa_text.print_multiプロシージャのプロパティを示します。

表8-4 owa_text.print_multiプロシージャ

プロパティ

定義

構文:

owa_text.print_multi(mline in multi_line);

パラメータ:

mline: 出力するmulti_lineデータ型。

戻り値:

multi_lineの内容。

8.6 owa_text.print_row_listプロシージャ

htp.printおよびhtp.prnを使用して、owa_text.row_listデータ型のrowsフィールドを出力します。

表8-5にowa_text.print_row_listプロシージャのプロパティを示します。

表8-5 owa_text.print_row_listプロシージャ

プロパティ

定義

構文:

owa_text.print_row_list(rlist in row_list);

パラメータ:

rlist: 出力するrow_listデータ型。

戻り値:

row_listの内容。

8.7 owa_text.row_listデータ型

処理するデータを保持するデータ型です。

表8-6にowa_text.row_listデータ型のプロパティを示します。

表8-6 owa_text.row_listデータ型

プロパティ

定義

構文:

type row_list is record (
rows           int_arr,
num_rows       integer);
int_arr is defined as:
type int_arr is table of integer index by binary_integer;

戻り値:

なし

8.8 owa_text.stream2multiプロシージャ

文字列をmulti_lineデータ型に変換します。

表8-7にowa_text.stream2multiプロシージャのプロパティを示します。

表8-7 owa_text.stream2multiプロシージャ

プロパティ

定義

構文:

owa_text.stream2multi(

stream         in       varchar2

mline          out      multi_line);

パラメータ:

stream: 変換する文字列。

mline: owa_text.multi_lineデータ型形式のstream。

戻り値:

なし

8.9 owa_text.vc_arrデータ型

owa_text.multi_lineデータ型の構成要素です。

表8-8にowa_text.vc_arrデータ型のプロパティを示します。

表8-8 owa_text.vc_arrデータ型

プロパティ

定義

構文:

type vc_arr is table of varchar2(32767) index by binary_integer;

戻り値:

なし

9 owa_utilパッケージ

owa_utilパッケージには、CGI環境変数の値の取得、クライアントに返されるデータの出力、問合せの結果のHTML表への出力などの操作を実行するための、ユーティリティ・サブプログラムが含まれます。

owa_utilには、3種類のユーティリティ・サブプログラムが含まれます。

- 動的SQLユーティリティを使用すると、動的に生成されるSQLコードを含むページを生成できます。

- HTMLユーティリティを使用すると、CGI環境変数の値を取得したり、URLリダイレクトを実行したりすることができます。

- 日付ユーティリティを使用すると、適切な日付処理が可能です。日付の値は、HTMLでは単純な文字列ですが、Oracleデータベースではデータ型として扱われます。

9.1 サマリー

owa_util.bind_variablesファンクション: SQL問合せを準備し、変数をSQL問合せにバインドします。

owa_util.calendarprintプロシージャ: カレンダを出力します。

owa_util.cellsprintプロシージャ: 問合せの内容をHTMLのテーブルに出力します。

owa_util.choose_dateプロシージャ: ユーザーが日付を選択できるHTMLフォーム要素を生成します。

owa_util.dateTypeデータ型: 日付情報を保持するデータ型です。

owa_util.get_cgi_envファンクション: 指定されたCGI環境変数の値を返します。

owa_util.get_owa_service_pathファンクション: PL/SQL Gatewayに対するフル仮想パスを返します。

owa_util.get_procedureファンクション: PL/SQL Gatewayによって起動されるプロシージャの名前を返します。

owa_util.http_header_closeプロシージャ: HTTPヘッダーを閉じます。

owa_util.ident_arrデータ型: データ型です。

owa_util.ip_addressデータ型: owa_sec.get_client_ipファンクションによって使用されます。

owa_util.listprintプロシージャ: 問合せ結果のデータを含むHTMLフォーム要素を生成します。

owa_util.mime_headerプロシージャ: HTTPヘッダーにContent-type行を生成します。

owa_util.print_cgi_envプロシージャ: すべてのCGI環境変数とその値のリストを生成します。

owa_util.redirect_urlプロシージャ: HTTPヘッダーにLocation行を生成します。

owa_util.showpageプロシージャ: SQL*Plusで、htpパッケージおよびhtfパッケージによって生成されたページを出力します。

owa_util.showsourceプロシージャ: 指定されたサブプログラムのソースを出力します。

owa_util.signatureプロシージャ: ページがPL/SQL Agentによって生成されたことを示す行を出力します。

owa_util.status_lineプロシージャ: HTTPヘッダーにStatus行を生成します。

owa_util.tablePrintファンクション: データベース表のデータをHTMLの表として出力します。

owa_util.todateファンクション: dateTypeのデータを標準のPL/SQL日付型に変換します。

owa_util.who_called_meプロシージャ: プロシージャのコール元に関する情報を返します。

9.2 owa_util.bind_variablesファンクション

変数をバインドすることでSQL問合せを作成し、オープンされているカーソルに出力を格納します。このファンクションは、動的に生成された問合せを送信するプロシージャに対するパラメータとして使用します。指定できるバインド変数は最大で25個です。

表9-1にowa_util.bind_variablesファンクションのプロパティを示します。

表9-1 owa_util.bind_variablesファンクション

プロパティ

定義

構文:

owa_util.bind_variables(
theQuery       in       varchar2   DEFAULT NULL
bv1Name        in       varchar2   DEFAULT NULL
bv1Value       in       varchar2   DEFAULT NULL
bv2Name        in       varchar2   DEFAULT NULL
bv2Value       in       varchar2   DEFAULT NULL
bv3Name        in       varchar2   DEFAULT NULL
bv3Value       in       varchar2   DEFAULT NULL
...
bv25Name       in       varchar2   DEFAULT NULL
bv25Value      in       varchar2   DEFAULT NULL) return integer;

パラメータ:

theQuery: SQL問合せ文。SELECT文を指定する必要がある。

bv1Name: 変数の名前。

bv2Value: 変数の値。

戻り値:

オープンしているカーソルを示す整数値。

9.3 owa_util.calendarprintプロシージャ

HTMLにカレンダを作成します。カレンダ内の各日付には、任意の数のハイパーテキスト・リンクを含めることができます。問合せは次のように作成します。

- 1番目の列はDATEです。この列は、問合せによって生成された情報と、プロシージャによって生成されたカレンダ出力を関連付けます。

- 問合せの出力は、ORDER BYを使用してこの列でソートする必要があります。

- 2番目の列には、その日付に対して出力するテキスト（存在する場合）が含まれます。

- 3番目の列には、生成されたリンクのリンク先が含まれます。2番目の列の各項目は、この列で指定されているリンク先へのハイパーテキスト・リンクになります。この列を省略すると、2番目の列の項目は、リンクではなく単純なテキストになります。

このプロシージャには2つのバージョンがあります。1番目のバージョンは、varchar2の文字列で格納されるハードコードされた問合せを使用します。2番目のバージョンは、owa_util.bind_variablesファンクションで作成される動的な問合せを使用します。

表9-2にowa_util.calendarprintプロシージャのプロパティを示します。

表9-2 owa_util.calendarprintプロシージャ

プロパティ

定義

構文:

owa_util.calendarprint(
p_query        in       varchar2
p_mf_only      in       varchar2   DEFAULT 'N');

owa_util.calendarprint(
p_cursor       in       integer
p_mf_only      in       varchar2   DEFAULT 'N');

パラメータ:

p_query: PL/SQLの問合せ。問合せから返される内容については、前述の説明を参照。

p_cursor: p_queryと同じフォーマットを含むPL/SQLカーソル。

p_mf_only: 「N」（デフォルト）の場合は、生成されるカレンダには日曜日から土曜日までが含まれる。Nではない場合は、月曜日から金曜日までしか含まれない。

実行結果:

枠付きのHTML表形式のカレンダ。

9.4 owa_util.cellsprintプロシージャ

SQL問合せの出力からHTML表を生成します。SQLの基本データ項目はHTMLのセルにマップされ、SQLの行はHTMLの行にマップされます。HTML表を開始および終了するコードを記述する必要があります。このプロシージャには9つのバージョンがあります。

- 1番目のバージョンは、問合せの結果を索引表に渡します。問合せを実行し、cellsprintにより書式の設定を行います。SQL問合せの出力からのHTML表の生成をより詳細に制御するには、htf.format_cellファンクションを使用します。

- 2番目と3番目のバージョンは、問合せまたはカーソルから返される行を（指定されている最大数まで）表示します。

- 4番目と5番目のバージョンは、指定された数の行をHTML表から除外します。表示されている最後の行を非表示フォーム要素に保存することで結果セットをスクロールするには、4番目と5番目のバージョンを使用します。

6番目から9番目のバージョンは、最初の4つのバージョンと同じですが、行数の出力パラメータを返す点が異なります。

表9-3にowa_util.cellsprintプロシージャのプロパティを示します。

表9-3 owa_util.cellsprintプロシージャ

プロパティ

定義

構文:

owa_util.cellsprint(
p_colCnt          in    integer
p_resultTbl       in    vc_arr
p_format_numbers  in    varchar2   DEFAULT NULL);

owa_util.cellsprint(
p_theQuery        in    varchar2
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL);

owa_util.cellsprint(
p_theCursor       in    integer
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL);

owa_util.cellsprint(
p_theQuery        in    varchar2
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_skip_rec        in    number      DEFAULT 0
p_more_data       out   boolean);

owa_util.cellsprint(
p_theCursor       in    integer
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_skip_rec        in    number     DEFAULT 0
p_more_data       out   boolean);

owa_util.cellsprint(
p_theQuery        in    varchar2
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_reccnt          out   number);

owa_util.cellsprint(
p_theCursor       in    integer
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_reccnt          out   number);

owa_util.cellsprint(
p_theQuery        in    varchar2
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_skip_rec        in    number     DEFAULT 0
p_more_data       out   boolean
p_reccnt          out   number);

owa_util.cellsprint(
p_theCursor       in    integer
p_max_rows        in    number     DEFAULT 100
p_format_numbers  in    varchar2   DEFAULT NULL
p_skip_rec        in    number     DEFAULT 0
p_more_data       out   boolean
p_reccnt          out   number);

パラメータ:

p_colCnt: 表の列数。

p_theQuery: SQLのSELECT文。

p_theCursor: カーソルID。owa_util.bind_variablesファンクションからの戻り値を使用可能。

p_max_rows: 出力する最大行数。

p_format_numbers: このパラメータの値がNULLでない場合は、数値フィールドは右揃えされ、小数点以下第2位に四捨五入される。

p_skip_rec: HTML表から除外する行数。

p_more_data: 問合せまたはカーソルにさらに行がある場合はTRUE、それ以外の場合はFALSE。

p_reccnt: 問合せの結果返された行数。スキップされた行がある場合、この値にはスキップされた行は含まれない。

p_resultTbl: 問合せの結果が格納される索引表。問合せの各エントリは、1つの列の値に対応する。

実行結果:

<tr><td>QueryResultItem</td><td>QueryResultItem</td></tr>
<tr><td>QueryResultItem</td><td>QueryResultItem</td></tr>

9.5 owa_util.choose_dateプロシージャ

ユーザーが日、月、および年を選択できる3つのHTMLフォーム要素を作成します。これらの要素からデータを受け取るプロシージャのパラメータには、owa_util.dateTypeデータ型を使用する必要があります。owa_util.dateTypeデータ型の値をOracle Databaseバージョン7の標準のDATEデータ型に変換するには、owa_util.todateファンクションを使用します。

表9-4にowa_util.choose_dateプロシージャのプロパティを示します。

表9-4 owa_util.choose_dateプロシージャ

プロパティ

定義

構文:

owa_util.choose_date(
p_name         in       varchar2,
p_date         in       date       DEFAULT SYSDATE);

パラメータ:

p_name: フォーム要素の名前。

p_date: HTMLページが表示されるときに最初に選択されている日付の初期値。

実行結果:

<SELECT NAME="p_name" SIZE="1">
<OPTION value="01">1
...
<OPTION value="31">31
</SELECT>
-
<SELECT NAME="p_name" SIZE="1">
<OPTION value="01">JAN
...
<OPTION value="12">DEC
</SELECT>
-
<SELECT NAME="p_name" SIZE="1">
<OPTION value="1992">1992
...
<OPTION value="2002">2002
</SELECT>

9.6 owa_util.dateTypeデータ型

owa_util.todateファンクションは、この型の項目を、データベースに日付として認識され、適切に処理されるDATE型に変換します。owa_util.choose_dateプロシージャを使用すると、ユーザーは必要な日付を選択できます。

表9-5にowa_util.dateTypeデータ型のプロパティを示します。

表9-5 owa_util.dateTypeデータ型

プロパティ

定義

構文:

type dateType is table of varchar2(10) index by binary_integer;

戻り値:

なし

9.7 owa_util.get_cgi_envファンクション

指定されたCGI環境変数の値を返します。WRBはCGIでは動作しませんが、PL/SQL Gatewayを含む多くのWRBカートリッジはCGI環境変数を利用できます。

表9-6にowa_util.get_cgi_envファンクションのプロパティを示します。

表9-6 owa_util.get_cgi_envファンクション

プロパティ

定義

構文:

owa_util.get_cgi_env(param_name in varchar2) return varchar2;

パラメータ:

param_name: CGI環境変数の名前。大/小文字は区別されない。QUERY_STRINGを除く、すべてのCGI環境変数の値を取得可能。これは、PL/SQL GatewayがQUERY_STRINGの値を解析して、ストアド・プロシージャに渡すパラメータを判別するため。

戻り値:

指定されたCGI環境変数の値。変数が定義されていない場合は、NULLを返す。

9.8 owa_util.get_owa_service_pathファンクション

リクエストを処理するPL/SQL Gatewayのフル仮想パスを返します。

表9-7にowa_util.get_owa_service_pathファンクションのプロパティを示します。

表9-7 owa_util.get_owa_service_pathファンクション

プロパティ

定義

構文:

owa_util.get_owa_service_path return varchar2;

パラメータ:

なし

戻り値:

リクエストを処理するPL/SQL Gatewayの仮想パス。

9.9 owa_util.get_procedureファンクション

PL/SQL Gatewayによって呼び出されるプロシージャの名前を返します。

表9-8にowa_util.get_procedureファンクションのプロパティを示します。

表9-8 owa_util.get_procedureファンクション

プロパティ

定義

構文:

owa_util.get_procedure return varchar2;

パラメータ:

なし

戻り値:

プロシージャの名前。プロシージャがパッケージで定義されている場合は、パッケージ名を含む。

9.10 owa_util.http_header_closeプロシージャ

HTTPヘッダーを閉じるための改行文字を生成します。owa_util.mime_headerプロシージャ、owa_util.redirect_urlプロシージャ、またはowa_util.status_lineプロシージャなどのコールで、bclose_headerパラメータを使用してヘッダーを閉じていない場合は、このプロシージャを使用します。htp.printまたはhtp.prnをコールする前に、HTTPヘッダーを閉じる必要があります。

表9-9にowa_util.http_header_closeプロシージャのプロパティを示します。

表9-9 owa_util.http_header_closeプロシージャ

プロパティ

定義

構文:

owa_util.http_header_close;

パラメータ:

なし

実行結果:

HTTPヘッダーを閉じる改行文字。

9.11 owa_util.ident_arrデータ型

配列に使用するデータ型です。

表9-10にowa_util.ident_arrデータ型のプロパティを示します。

表9-10 owa_util.ident_arrデータ型

プロパティ

定義

構文:

type ident_arr is table of varchar2(30) index by binary_integer;

戻り値:

なし

9.12 owa_util.ip_addressデータ型

owa_sec.get_client_ipファンクションが使用するデータ型です。

表9-11にowa_util.ip_addressデータ型のプロパティを示します。

表9-11 owa_util.ip_addressデータ型

プロパティ

定義

構文:

type ip_address is table of integer index by binary_integer;

戻り値:

なし

9.13 owa_util.listprintプロシージャ

SQL問合せの出力から、HTMLの選択リスト・フォーム要素を生成します。問合せの出力の列は、次の方法で処理されます。

- 1番目の列は、返される値を示します。これらの値は、OPTIONタグのVALUE属性に使用されます。

- 2番目の列は、ユーザーに表示される値を示します。

- 3番目の列は、その行をOPTIONタグでSELECTEDとしてマークするかどうかを示します。値がNULLでない場合、その行は選択されています。

このプロシージャには2つのバージョンがあります。1番目のバージョンにはハードコードされたSQL問合せが含まれ、2番目のバージョンにはowa_util.bind_variablesファンクションで作成される動的な問合せが使用されます。

表9-12にowa_util.listprintプロシージャのプロパティを示します。

表9-12 owa_util.listprintプロシージャ

プロパティ

定義

構文:

owa_util.listprint(
p_theQuery     in       varchar2
p_cname        in       varchar2
p_nsize        in       number
p_multiple     in       boolean   DEFAULT FALSE);

owa_util.listprint(
p_theCursor    in    integer
p_cname        in       varchar2
p_nsize        in       number
p_multiple     in       boolean   DEFAULT FALSE);

パラメータ:

p_theQuery: SQL問合せ。

p_theCursor: カーソルID。owa_util.bind_variablesファンクションからの戻り値を使用可能。

p_cname: HTMLフォーム要素の名前。

p_nsize: フォーム要素のサイズ（スクロールしないで表示可能な項目数が決まる）。

p_multiple: 複数の選択を許可するかどうか。

実行結果:

<SELECT NAME="p_cname" SIZE="p_nsize">
<OPTION SELECTED value='value_from_the_first_column'>value_from_the_second_column
<OPTION SELECTED value='value_from_the_first_column'>value_from_the_second_column
...
</SELECT>

9.14 owa_util.mime_headerプロシージャ

スクリプトが返すデフォルトのMIMEヘッダーを変更します。スクリプトでデフォルトのMIMEヘッダーを使用しないようにするため、このプロシージャはhtp.printまたはhtp.prnコールより前に置く必要があります。

表9-13にowa_util.mime_headerプロシージャのプロパティを示します。

表9-13 owa_util.mime_headerプロシージャ

プロパティ

定義

構文:

owa_util.mime_header(
ccontent_type  in       varchar2   DEFAULT 'text/html',
bclose_header  in       boolean    DEFAULT TRUE,
ccharset       in       varchar2   DEFAULT NULL);

パラメータ:

ccontent_type: 生成するMIMEタイプ。

bclose_header: HTTPヘッダーを閉じるかどうか。TRUEの場合は、2つの改行が送信されて、HTTPヘッダーが閉じられる。TRUE以外の場合は、1つの改行が送信されて、HTTPヘッダーは開いたままになる。

ccharset: 使用するキャラクタ・セット。

実行結果:

Content-type: <ccontent_type>; charset=<ccharset>

例:

owa_util.mime_header('text/plain', false, 'ISO-8859-4')
generates:
Content-type: text/plain; charset=ISO-8859-4\n

9.15 owa_util.print_cgi_envプロシージャ

PL/SQL Gatewayによりストアド・プロシージャで使用可能なCGI環境変数とその値をすべて生成します。

表9-14にowa_util.print_cgi_envプロシージャのプロパティを示します。

表9-14 owa_util.print_cgi_envプロシージャ

プロパティ

定義

構文:

owa_util.print_cgi_env;

パラメータ:

なし

実行結果:

次の形式のリスト。

cgi_env_var_name = value\n

9.16 owa_util.redirect_urlプロシージャ

アプリケーション・サーバーが特定のURLに進むように指定します。URLにより、返されるWebページまたは実行されるプログラムを指定できます。このプロシージャは、htpまたはhtfのプロシージャまたはファンクション・コールより前に置く必要があります。

表9-15にowa_util.redirect_urlプロシージャのプロパティを示します。

表9-15 owa_util.redirect_urlプロシージャ

プロパティ

定義

構文:

owa_util.redirect_url(
curl           in       varchar2
bclose_header  in       boolean    DEFAULT TRUE);

パラメータ:

curl: 移動先のURL。

bclose_header: HTTPヘッダーを閉じるかどうか。TRUEの場合は、2つの改行が送信されて、HTTPヘッダーが閉じられる。TRUE以外の場合は、1つの改行が送信されて、HTTPヘッダーは開いたままになる。

実行結果:

Location: <curl>\n\n

9.17 owa_util.showpageプロシージャ

SQL*Plus、SQL*DBA、またはOracle Server ManagerにおけるプロシージャのHTML出力を表示します。このプロシージャは、htpパッケージまたはhtfパッケージを使用してHTMLページを生成する必要があります。また、プロシージャをコールされた後で、かつHTPまたはHTFの他のサブプログラムを直接または間接にコールする前に、このプロシージャを発行する必要があります。この方法は、静的なデータを設定したページを生成する際に便利です。このプロシージャは、dbms_outputを使用し、個々の行は255文字に、また全体のバッファ・サイズは1,000,000バイトに制限されています。

表9-16にowa_util.showpageプロシージャのプロパティを示します。

表9-16 owa_util.showpageプロシージャ

プロパティ

定義

構文:

owa_util.showpage;

パラメータ:

なし

実行結果:

htpプロシージャの出力は、SQL*Plus、SQL*DBA、またはOracle Server Managerで表示される。例は次のとおり。

SQL> set serveroutput on
SQL> spool gretzky.html
SQL> execute hockey.pass("Gretzky")
SQL> execute owa_util.showpage
SQL> exit

これにより、WebブラウザからアクセスできるHTMLページが生成される。

9.18 owa_util.showsourceプロシージャ

指定されたプロシージャ、ファンクション、またはパッケージのソースを出力します。パッケージに属するプロシージャまたはファンクションが指定されると、パッケージ全体が表示されます。

表9-17にowa_util.showsourceプロシージャのプロパティを示します。

表9-17 owa_util.showsourceプロシージャ

プロパティ

定義

構文:

owa_util.showsource (cname in varchar2);

パラメータ:

cname: プロシージャまたはファンクションの名前。

実行結果:

指定されたファンクション、プロシージャ、またはパッケージのソース・コード。

9.19 owa_util.signatureプロシージャ

HTMLドキュメントでシグネチャ行が後に付いたHTML行を生成します。パラメータが指定された場合は、そのプロシージャに対するPL/SQLソースを表示するハイパーテキスト・リンクも生成します。このリンクは、owa_util.showsourceプロシージャをコールします。

表9-18にowa_util.signatureプロシージャのプロパティを示します。

表9-18 owa_util.signatureプロシージャ

プロパティ

定義

構文:

owa_util.signature;
owa_util.signature (cname in varchar2);

パラメータ:

cname: ソースを表示するファンクションまたはプロシージャ。

実行結果:

パラメータを指定しないと、次のような行が生成される。

This page was produced by the PL/SQL Agent on August 9, 2001 09:30.

パラメータを指定すると、次のように、HTMLドキュメントにシグネチャ行が生成される。

This page was produced by the PL/SQL Agent on 8/09/01 09:30
View PL/SQL Source

9.20 owa_util.status_lineプロシージャ

標準のHTTPステータス・コードをクライアントに送信します。コンテンツ・データではなくヘッダーの一部としてステータス・コードを返すには、このプロシージャは、htp.printまたはhtp.prnコールより前に置く必要があります。

表9-19にowa_util.status_lineプロシージャのプロパティを示します。

表9-19 owa_util.status_lineプロシージャ

プロパティ

定義

構文:

owa_util.status_line(
nstatus        in       integer,
creason        in       varchar2   DEFAULT NULL
bclose_header  in       boolean    DEFAULT TRUE);

パラメータ:

nstatus: ステータス・コード。

creason: ステータス・コードに対する文字列。

bclose_header: HTTPヘッダーを閉じるかどうか。TRUEの場合は、2つの改行が送信されて、HTTPヘッダーが閉じられる。TRUE以外の場合は、1つの改行が送信されて、HTTPヘッダーは開いたままになる。

実行結果:

Status: <nstatus> <creason>\n\n

9.21 owa_util.tablePrintファンクション

データベース表から、事前に書式設定された表またはHTML表を生成します（ユーザーのブラウザの機能によって決まります）。RAW列はサポートしますが、LONG RAW列はサポートしません。LONG RAW列を参照すると、Not Printableと表示されます。このファンクションでは、cattributesは最後のパラメータではなく2番目のパラメータです。

表9-20にowa_util.tablePrintファンクションのプロパティを示します。

表9-20 owa_util.tablePrintファンクション

プロパティ

定義

構文:

owa_util.tablePrint(
ctable         in       varchar2
cattributes    in       varchar2   DEFAULT NULL
ntable_type    in       integer    DEFAULT HTML_TABLE
ccolumns       in       varchar2   DEFAULT '*'
cclauses       in    varchar2   DEFAULT NULL
ccol_aliases   in       varchar2   DEFAULT NULL
nrow_min       in       number     DEFAULT 0
nrow_max       in       number     DEFAULT NULL) return boolean;

パラメータ:

ctable: データベース表。

cattributes: タグにそのまま追加するその他の属性。

ntable_type: 表を生成する方法。HTML_TABLEを指定して、<TABLE>タグを使用して表を生成するか、PRE_TABLEを指定して、<PRE>タグを使用して表を生成する。

ccolumns: 生成されるテーブルに含めるctableの列のカンマ区切りリスト。

cclauses: WHERE句またはORDER BY句。データベース表から取得する行、および行を並べ替える方法を指定する。

ccol_aliases: 生成されるテーブルの見出しのカンマ区切りリスト。

nrow_min: 取得された行の中で最初に表示する行。

nrow_max: 取得された行の中で最後に表示する行。

実行結果:

事前に書式設定されている表またはHTML表。リクエストされたnrow_maxより多くの行がある場合はTRUEを返す。それ以外の場合はFALSEを返す。

例:

HTMLテーブルをサポートしないブラウザの場合は、次のようなプロシージャを作成する。

create or replace procedure showemps is
ignore_more boolean;
begin
ignore_more := owa_util.tablePrint('emp', 'BORDER', OWA_UTIL.PRE_TABLE);
end;

http://myhost:8080/ows-bin/hr/plsql/showempsのようなURLをリクエストすると、次のような結果がクライアントに返される。

<PRE>
-----------------------------------------------------------------
| EMPNO |ENAME |JOB      |MGR   |HIREDATE   | SAL | COMM | DEPTNO |
-----------------------------------------------------------------
| 7369| SMITH  | CLERK   | 7902 | 17-DEC-80 | 800  |     | 20     |
| 7499| ALLEN  | SALESMAN| 7698 | 20-FEB-81 | 1600 | 300 | 30     |
| 7521| WARD   | SALESMAN| 7698 | 22-FEB-81 | 1250 | 500 | 30     |
| 7566| JONES  | MANAGER | 7839 | 02-APR-81 | 2975 |     | 20     |
| 7654| MARTIN | SALESMAN| 7698 | 28-SEP-81 | 1250 | 1400| 30     |
| 7698| BLAKE  | MANAGER | 7839 | 01-MAY-81 | 2850 |     | 30     |
| 7782| CLARK  | MANAGER | 7839 | 09-JUN-81 | 2450 |     | 10     |
| 7788| SCOTT  | ANALYST | 7566 | 09-DEC-82 | 3000 |     | 20     |
| 7839| KING   |PRESIDENT|      | 17-NOV-81 | 5000 |     | 10     |
| 7844| TURNER | SALESMAN| 7698 | 08-SEP-81 | 1500 | 0   | 30     |
| 7876| ADAMS  | CLERK   | 7788 | 12-JAN-83 | 1100 |     | 20     |
| 7900| JAMES  | CLERK   | 7698 | 03-DEC-81 | 950  |     | 30     |
| 7902| FORD   | ANALYST | 7566 | 03-DEC-81 | 3000 |     | 20     |
| 7934| MILLER | CLERK   | 7782 | 23-JAN-82 | 1300 |     | 10     |
-----------------------------------------------------------------
</PRE>

部署10の従業員について、その従業員ID、名前、および給与のみを表示するには、次のようなプロシージャを作成する。

create or replace procedure showemps_10 is
ignore_more boolean;
begin
ignore_more := owa_util.tablePrint
('EMP', 'BORDER', OWA_UTIL.PRE_TABLE,
'empno, ename, sal',
'where deptno=10 order by empno',
'Employee Number, Name, Salary');
end;

http://myhost:8080/ows-bin/hr/plsql/showemps_10のようなURLをリクエストすると、次のような結果がクライアントに返される。

<PRE>
-------------------------------------
| Employee Number |Name     | Salary |
-------------------------------------
| 7782            | CLARK   | 2450   |
| 7839            | KING    | 5000   |
| 7934            | MILLER  | 1300   |
-------------------------------------
</PRE>

HTML表をサポートするブラウザの場合、部署表をHTML表で表示するには、次のようなプロシージャを作成する。

create or replace procedure showdept is
ignore_more boolean;
begin
ignore_more := owa_util.tablePrint('dept', 'BORDER');
end;

http://myhost:8080/ows-bin/hr/plsql/showdeptのようなURLをリクエストすると、次のような結果がクライアントに返される。

<TABLE BORDER>
<TR>
<TH>DEPTNO</TH>
<TH>DNAME</TH>
<TH>LOC</TH>
</TR>
<TR>
<TD ALIGN="LEFT">10</TD>
<TD ALIGN="LEFT">ACCOUNTING</TD>
<TD ALIGN="LEFT">NEW YORK</TD>
</TR>
<TR>
<TD ALIGN="LEFT">20</TD>
<TD ALIGN="LEFT">RESEARCH</TD>
<TD ALIGN="LEFT">DALLAS</TD>
</TR>
<TR>
<TD ALIGN="LEFT">30</TD>
<TD ALIGN="LEFT">SALES</TD>
<TD ALIGN="LEFT">CHICAGO</TD>
</TR>
<TR>
<TD ALIGN="LEFT">40</TD>
<TD ALIGN="LEFT">OPERATIONS</TD>
<TD ALIGN="LEFT">BOSTON</TD>
</TR>
</TABLE>

Webブラウザは、書式を設定して次のようなテーブルを表示する。

--------------------------------------
| DEPTNO  | DNAME         | LOC      |
|------------------------------------|
| 10      | ACCOUNTING    | NEW YORK |
| 20      | RESEARCH      | DALLAS   |
| 30      | SALES         | CHICAGO  |
--------------------------------------

9.22 owa_util.todateファンクション

owa_util.dateTypeデータ型をOracleデータベースの標準のDATE型に変換します。

表9-21にowa_util.todateファンクションのプロパティを示します。

表9-21 owa_util.todateファンクション

プロパティ

定義

構文:

owa_util.todate(p_dateArray in dateType) return date;

パラメータ:

p_dateArray: 変換する値。

実行結果:

標準のDATE型。

9.23 owa_util.who_called_meプロシージャ

起動したPL/SQLコード単位に関する情報を（出力パラメータの形式で）返します。

表9-22にowa_util.who_called_meプロシージャのプロパティを示します。

表9-22 owa_util.who_called_meプロシージャ

プロパティ

定義

構文:

owa_util.who_called_me(
owner          out      varchar2
name           out      varchar2
lineno         out      number
caller_t       out      varchar2);

パラメータ:

owner: プログラム単位の所有者。

name: プログラム単位の名前。コール元のプログラム単位がパッケージにラップされている場合はパッケージの名前、コール元のプログラム単位がスタンドアロンのプロシージャまたはファンクションである場合はプロシージャまたはファンクションの名前。コール元プログラム単位が無名ブロックの一部である場合はNULL。

lineno: コールが実行されたプログラム単位内の行番号。

caller_t: コールを実行したプログラム単位のタイプ。パッケージ本体、無名ブロック、プロシージャ、ファンクションなど。プロシージャとファンクションは、スタンドアロンのプロシージャおよびファンクションの場合のみ。

実行結果:

なし

索引
A B C D E F G H I J L M N O P S T V W あ い か き け し せ た ち て は ふ み も ら り

A

addressタグ, [1], [2]

anchor, [1]

areaタグ, [1]

B

basefrontタグ, [1]

baseタグ, [1]

bgsoundタグ, [1]

bigタグ, [1]

blockquoteタグ

開始, [1]

終了, [1]

bodyタグ, [1] boldタグ, [1]
C

centerCloseタグ, [1]

centerOpenタグ, [1]

centerタグ

タグ

center, [1]

CGI環境変数, [1], [2] citeタグ, [1] codeタグ, [1]
D

dfnタグ, [1]

dirlistCloseタグ, [1]

dirlistOpenタグ, [1]

divタグ, [1]

dlistDefタグ, [1]

dlistTermタグ, [1]

download_file, [1]

E

escape_sc, [1]

escape_url, [1]

etag, [1]

F

fontCloseタグ, [1]

fontOpenタグ, [1]

formCheckbox, [1]

formCloseタグ, [1]

formFile, [1]

formHidden, [1]

formImage, [1]

formOpenタグ, [1]

formPassword, [1]

formRadio, [1]

formReset, [1]

formSelectClose, [1]

formSelectOpen, [1]

formSelectOption, [1]

formSubmit, [1]

formText, [1]

formTextarea, [1]

formTextarea2, [1]

framesetClose, [1]

frameタグ, [1]

G

get_download_files_list, [1]

H

headタグ, [1]

htmlCloseタグ, [1]

htmlOpenタグ, [1]

HTMLコメント, [1]

HTMLでのコメント, [1]

htp.address, [1], [2]

htp.anchor, [1]

htp.anchor2, [1]

htp.appletclose, [1]

htp.appletopen, [1]

htp.area, [1]

htp.base, [1]

htp.basefont, [1]

htp.bgsound, [1]

htp.big, [1]

htp.blockquoteClose, [1]

htp.blockquoteOpen, [1]

htp.bodyClose, [1], [2]

htp.bold, [1]

htp.br, [1]

htp.center, [1]

htp.centerClose, [1]

htp.centerOpen, [1]

htp.cite, [1]

htp.code, [1]

htp.comment, [1]

htp.dfn, [1]

htp.dirlistClose, [1]

htp.dirlistOpen, [1]

htp.div, [1]

htp.dlistClose, [1]

htp.dlistDef, [1]

htp.dlistOpen, [1]

htp.dlistTerm, [1]

htp.em, [1]

htp.emphasis, [1]

htp.fontClose, [1]

htp.fontOpen, [1]

htp.formCheckbox, [1]

htp.formClose, [1]

htp.formFile, [1]

htp.formHidden, [1]

htp.formImage, [1]

htp.formOpen, [1]

htp.formPassword, [1]

htp.formRadio, [1]

htp.formReset, [1]

htp.formSelectClose, [1]

htp.formSelectOpen, [1]

htp.formSelectOption, [1]

htp.formSubmit, [1]

htp.formText, [1]

htp.formTextarea, [1]

htp.formTextareaClose, [1]

htp.frame, [1]

htp.framesetClose, [1]

htp.framesetOpen, [1]

htp.headClose, [1]

htp.header, [1]

htp.headOpen, [1]

htp.hr, [1]

htp.htmlClose, [1]

htp.htmlOpen, [1]

htp.img, [1]

htp.img2, [1]

htp.isindex, [1]

htp.italic, [1]

htp.kbd, [1]

htp.keyboard, [1]

htp.line, [1]

htp.linkRel, [1]

htp.linkRev, [1]

htp.listHeader, [1]

htp.listingClose, [1]

htp.listingOpen, [1]

htp.listItem, [1], [2]

htp.mailClose, [1]

htp.mailto, [1]

htp.mapOpen, [1]

htp.menulistClose, [1]

htp.menulistOpen, [1]

htp.meta, [1]

htp.nl, [1]

htp.nobr, [1]

htp.noframesClose, [1]

htp.noframesOpen, [1]

htp.olistClose, [1]

htp.olistOpen, [1]

htp.para, [1]

htp.paragraph, [1]

htp.param, [1]

htp.plaintext, [1]

htp.preClose, [1]

htp.preOpen, [1]

htp.print, [1]

htp.prints, [1]

htp.prn, [1]

htp.ps, [1]

htp.s, [1]

htp.sample, [1]

htp.script, [1]

htp.strike, [1]

htp.strong, [1]

htp.style, [1]

htp.sub, [1]

htp.sup, [1]

htp.tableCaption, [1]

htp.tableClose, [1]

htp.tableData, [1]

htp.tableHeader, [1]

htp.tableOpen, [1]

htp.tableRowClose, [1]

htp.tableRowOpen, [1]

htp.teletype, [1]

htp.textareaOpen, [1]

htp.textareaOpen2, [1]

htp.title, [1]

htp.ulistClose, [1]

htp.ulistOpen, [1]

htp.underline, [1]

htp.variable, [1]

htp.wbr, [1]

I

imgタグ, [1]

IPアドレス

PL/SQLカートリッジでの取得, [1]

isindex, [1]
J

Javaアプレット

参照, [1]

L

linkRev, [1]

linkタグ, [1]

listHeaderタグ, [1]

listingCloseタグ, [1]

listingOpenタグ, [1]

listItemタグ, [1]

M

mailtoタグ, [1]

mapタグ, [1]

menuタグ, [1]

metaタグ, [1]

N

noframesタグ, [1]

O

owa_cache, [1]

owa_cache.disable, [1]

owa_cache.get_etag, [1]

owa_cache.get_level, [1]

owa_cache.set_not_modified, [1]

owa_cookie.cookieデータ型, [1]

owa_cookie.get_allプロシージャ, [1]

owa_cookie.getファンクション, [1]

owa_cookie.removeプロシージャ, [1]

owa_cookie.sendプロシージャ, [1]

owa_cookie.vc_arrデータ型, [1]

owa_image.get_xファンクション, [1]

owa_image.get_yファンクション, [1]

owa_image.NULL_POINTパッケージ変数, [1]

owa_image.pointデータ型, [1]

owa_opt_lock.checksumファンクション, [1]

owa_opt_lock.get_rowidファンクション, [1]

owa_opt_lock.store_valuesプロシージャ, [1]

owa_opt_lock.vcArrayデータ型, [1]

owa_opt_lock.verify_valuesファンクション, [1]

owa_pattern.amatchファンクション, [1]

owa_pattern.changeファンクションおよびプロシージャ, [1]

owa_pattern.getpatプロシージャ, [1]

owa_pattern.matchファンクション, [1]

owa_pattern.patternデータ型, [1]

owa_sec.get_client_hostnameファンクション, [1]

owa_sec.get_client_ipファンクション, [1]

owa_sec.get_passwordファンクション, [1]

owa_sec.get_user_idファンクション, [1]

owa_sec.set_authorizationプロシージャ, [1]

owa_sec.set_protection_realmプロシージャ, [1]

owa_text.add2multiプロシージャ, [1]

owa_text.multi_lineデータ型, [1]

owa_text.new_row_list, [1]

owa_text.print_multiプロシージャ, [1]

owa_text.print_row_listプロシージャ, [1]

owa_text.row_listデータ型, [1]

owa_text.stream2multiプロシージャ, [1]

owa_text.vc_arrデータ型, [1]

owa_util.bind_variablesファンクション, [1]

owa_util.calendarprintプロシージャ, [1]

owa_util.cellsprintプロシージャ, [1]

owa_util.choose_dateプロシージャ, [1]

owa_util.dateTypeデータ型, [1]

owa_util.get_cgi_envファンクション, [1]

owa_util.get_owa_service_pathファンクション, [1]

owa_util.get_procedureファンクション, [1]

owa_util.http_header_closeプロシージャ, [1]

owa_util.ident_arrデータ型, [1]

owa_util.ip_addressデータ型, [1]

owa_util.listprintプロシージャ, [1]

owa_util.mime_headerプロシージャ, [1]

owa_util.print_cgi_envプロシージャ, [1]

owa_util.redirect_urlプロシージャ, [1]

owa_util.showpageプロシージャ, [1]

owa_util.showsourceプロシージャ, [1]

owa_util.signatureプロシージャ, [1]

owa_util.status_lineプロシージャ, [1]

owa_util.tablePrintファンクション, [1]

owa_util.todateファンクション, [1]

owa_util.who_called_meプロシージャ, [1]

P

paramタグ, [1]

PL/SQL Web Toolkit

htfパッケージ, [1]

htpパッケージ, [1]

owa_cookieパッケージ, [1]

owa_imageパッケージ, [1]

owa_opt_lockパッケージ, [1]

owa_patternパッケージ, [1]

owa_secパッケージ, [1]

owa_textパッケージ, [1]

owa_utilパッケージ, [1]

PL/SQLカートリッジ

アプレット・タグ, [1]

サブプログラム・サマリー, [1]

段落書式設定タグ, [1]

テーブル・タグ, [1]

フォーム・タグ, [1]

フレーム・タグ, [1]

文字書式設定タグ, [1]

リスト・タグ, [1]

plaintextタグ, [1] printタグ, [1] p_expires, [1]
S

sampタグ, [1]

scriptタグ, [1]

strikeタグ, [1]

strongタグ, [1]

styleタグ, [1]

subタグ, [1]

supタグ, [1]

T

tableCaptionタグ, [1]

tableCloseタグ, [1]

tableDataタグ, [1]

tableHeaderタグ, [1]

tableOpenタグ, [1]

tableRowCloseタグ, [1]

teletypeタグ, [1]

titleタグ, [1]

V

varタグ, [1]

vc_arrデータ型, [1]

W

wbrタグ, [1]

あ

アプレット・タグ, [1], [2]

い

イタリック・タグ, [1]

か

改行禁止タグ, [1]

改行タグ, [1]

下線タグ, [1]

環境変数

PL/SQLカートリッジでの取得, [1]

き

キーボード・タグ, [1]

キャッシュ, [1]

キャッシュの有効期限, [1]

強調タグ, [1]

け

検証キャッシュ, [1]

し

書式設定済テキスト・タグ, [1]

せ

正規表現, [1]

た

タグ

address, [1], [2]

applet, [1]

area, [1]

base, [1]

basefont, [1]

bgsound, [1]

big, [1]

blockquote

開始, [1]

終了, [1]

body, [1] bold, [1] centerClose, [1] centerOpen, [1] cite, [1] code, [1] dfn, [1] dirlistClose, [1] dirlistOpen, [1] div, [1] dlistDef, [1] dlistTerm, [1] emphasis, [1] fontClose, [1] fontOpen, [1] formClose, [1] formOpen, [1] frame, [1] head, [1] header, [1] htmlClose, [1] htmlOpen, [1] img, [1] italic, [1] keyboard, [1] line, [1] link, [1] linkRev, [1] listHeader, [1] listItem, [1] mapClose, [1] mapOpen, [1] menulistClose, [1] menulistOpen, [1] meta, [1] nl, [1] nobr, [1] noframes, [1] paragraph, [1] param, [1] plaintext, [1] pre, [1] print, [1] sample, [1] script, [1] strike, [1] strong, [1] style, [1] sub, [1] sup, [1] tableCaption, [1] tableData, [1] tableHeader, [1] teletype, [1] title, [1] underline, [1] variable, [1] wbr, [1] 番号なしリスト, [1] 段落書式設定タグ（PL/SQLカートリッジ）, [1] 段落タグ, [1]
ち

チェック・ボックス・フォーム, [1]

て

データベース

ロック, [1]

テーブル・タグ（PL/SQLカートリッジ）, [1]
は

番号付きリスト・タグ

タグ

olist, [1]

番号なしリスト・タグ, [1]
ふ

フォーム・タグ, [1]

フォント

big, [1]

フレーム・タグ, [1]
み

見出しタグ, [1]

も

文字書式設定タグ（PL/SQLカートリッジ）, [1]

文字列

正規表現, [1]

ら

ライン・タグ, [1]

り

リスト・タグ, [1]

Copyright © 1996, 2009, Oracle and/or its affiliates. All rights reserved.