A.7 コマンドライン・キーワード(OUTPUTFOLDERからROLE)

この項では、Oracle Reportsコンポーネントと各コンポーネントで使用できるキーワードについて簡単に説明します。

A.7.1 OUTPUTFOLDER

表A-71では、OUTPUTFOLDERキーワードを使用できるコンポーネントを示します。

表A-71 OUTPUTFOLDERを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: OUTPUTFOLDERを使用して、レポート出力の配信先となるOracle WebDBリリース2.2またはOracle9iAS Portalリリース1のフォルダの名前を指定します。このキーワードは、Oracle WebDBリリース2.2およびOracle9iAS Portalリリース1に対する下位互換性を確保するために維持されています。Oracle Portal 10g (9.0.4)以降では、OUTPUTPAGEを使用してください。

構文: OUTPUTFOLDER=folder

値

folderには、Oracle WebDBリリース2.2またはOracle9iAS Portalリリース1で使用される有効なフォルダ名(内部名)を指定します。

デフォルト Oracle_Reports_Output

使用上の注意

このキーワードの値は大文字と小文字を区別します。
Oracle WebDBリリース2.2またはOracle9iAS Portalリリース1へのOracle Reports出力の送信において、このキーワードの使用はオプションです。
関連するキーワードは、CONTENTAREA*、EXPIREDAYS、ITEMTITLE、OUTPUTFOLDER*、OUTPUTPAGE、PAGEGROUP、SITENAME*、STATUSFOLDER*、STATUSPAGEです。

* Oracle9iAS Portalリリース1およびOracle WebDBリリース2.2に対する下位互換性を確保するために維持されています。

A.7.2 OUTPUTGRAPHFORMAT

表A-73では、OUTPUTGRAPHFORMATキーワードを使用できるコンポーネントを示します。

表A-72 OUTPUTGRAPHFORMATを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

説明: OUTPUTGRAPHFORMATを使用してグラフ・イメージ形式を指定します。

構文: OUTPUTGRAPHFORMAT={SVG}

値

SVG(デフォルト)

DESFORMAT値がHTMLまたはHTMLCSSの場合にサポートされるグラフ・イメージ形式。

例

例1

次のコマンドラインでは、HTML出力にPNGイメージが生成されます。

rwclient server=my_rep_server report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputgraphformat=SVG

rwrun report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputgraphformat=SVG

A.7.3 OUTPUTIMAGEFORMAT

表A-73では、OUTPUTIMAGEFORMATキーワードを使用できるコンポーネントを示します。

表A-73 OUTPUTIMAGEFORMATを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

説明: OUTPUTIMAGEFORMATを使用して、レポート出力のイメージの形式を指定します。

構文: OUTPUTIMAGEFORMAT={PNG|JPEG|JPG|GIF|BMP}

値

PNG、JPEG(デフォルト)、JPG

DESFORMAT値がPDF、HTML、HTMLCSS、RTFまたはSPREADSHEETである場合にサポートされるイメージ形式。
GIF

DESFORMAT値がPDF、HTML、HTMLCSSまたはSPREADSHEETである場合にサポートされるイメージ形式。
BMP

DESFORMAT値がRTFの場合にサポートされるイメージ形式。

使用上の注意

このコマンドライン・キーワードは、REPORTS_OUTPUTIMAGEFORMAT環境変数の設定より優先されます。
REPORTS_DEFAULT_DISPLAY環境変数が明示的にNO(デフォルトはYES)に設定されている場合、このコマンドライン・キーワードはサポートされません。その場合、デフォルトのイメージ形式は、HTML、HTMLCSSおよびPDF出力の場合GIF形式、RTF出力の場合BMP形式になります。
指定した形式と出力タイプが一致することを確認する必要があります。たとえば、BMPはRTF出力に対してのみ機能します。HTML、HTMLCSSまたはPDF出力では機能しません。
イメージを含むレポートおよび保護されたReports Serverを使用したDESFORMAT=SPREADSHEETへの実行はサポートされていません。これは、Microsoft ExcelのCookieサポートに対する制限が原因です。かわりに、WebDAVを使用してURLにセキュアなReports ServerからのExcel出力を書き込むことができます。

例

例1

次のコマンドラインでは、HTML出力にPNGイメージが生成されます。

rwclient server=my_rep_server report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputimageformat=PNG

rwrun report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputimageformat=PNG

同様に、DESFORMAT=pdfを指定した場合、イメージは生成されたPDF文書にPNG形式で埋め込まれます。

例2

OUTPUTIMAGEFORMATに無効な値を指定すると、エラー・メッセージが表示されます。次のコマンドラインでは、エラー・メッセージが表示されます。

rwclient server=my_rep_server report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputimageformat=ABCD

rwrun report=images.rdf destype=file desformat=html desname=images.html userid=user_id outputimageformat=ABCD

イメージ形式ABCDは無効であるため、次のエラー・メッセージが表示されます。

REP-35000: 指定されたイメージ出力形式はサポートされていません。

A.7.4 OUTPUTPAGE

表A-74では、OUTPUTPAGEキーワードを使用できるコンポーネントを示します。

表A-74 OUTPUTPAGEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: OUTPUTPAGEを使用して、レポート出力の配信先となるOracle Portalページの名前を指定します。旧リリース(Oracle WebDBリリース2.2およびOracle9iAS Portalリリース1)に対する下位互換性の詳細は、「OUTPUTFOLDER」を参照してください。

構文: OUTPUTPAGE=page

値

pageには、Oracle Portalで使用される有効なページ名(内部名)を指定します。

デフォルト Oracle_Reports_Output

使用上の注意

Oracle PortalへのOracle Reports出力の送信において、このキーワードの使用はオプションです。
- 出力ページを指定しないと、Oracle_Reports_Outputという名前のデフォルト・ページがOracle Portalにより作成されます。
- 出力ページを指定する場合は、表示名ではなく内部名を使用します。内部名を使用して、Oracle Portalコンポーネント・インスタンスを一意に識別します。
このキーワードの値は大文字と小文字を区別します。
DESTYPE=ORACLEPORTALが指定されている場合、ページには1つ以上の項目の領域が含まれる必要があります。
関連するキーワードは、CONTENTAREA*、EXPIREDAYS、ITEMTITLE、OUTPUTFOLDER*、OUTPUTPAGE、PAGEGROUP、SITENAME*、STATUSFOLDER*、STATUSPAGEです。

* Oracle9iAS Portalリリース1およびOracle WebDBリリース2.2に対する下位互換性を確保するために維持されています。

A.7.5 OVERWRITE

表A-75では、OVERWRITEキーワードを使用できるコンポーネントを示します。

表A-75 OVERWRITEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: OVERWRITEを使用して、既存のファイルを、変換済のファイルで上書きするかどうかを指定できます。

構文: OVERWRITE={YES|NO|PROMPT}

値

YESの場合、同名の既存ファイルを自動的にすべて上書きします。
NOの場合、同名の既存ファイルがあっても、レポートを変換せず、警告メッセージを表示します。
PROMPTの場合、既存ファイルを上書きする前に、確認を要求します。

デフォルト: NO

A.7.6 PARAMETER

表A-75では、parameterキーワードを使用できるコンポーネントを示します。

表A-76 parameterを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	はい	はい	はい

説明: parameterを使用して、レポート定義の一部であるパラメータを指定します。指定する値は、パラメータの値として使用されます。

構文: parameter=value

値

parameterには、レポートで定義されているパラメータの名前を指定します。
valueには、パラメータとして有効な値を指定します。

デフォルト: パラメータの初期値プロパティから取得します。

使用上の注意

ランタイム・パラメータ・フォームで、デフォルト値よりも優先される値を入力できます。
値は一重引用符または二重引用符で囲む場合もあります。一重引用符または二重引用符の効果はオペレーティング・システムによって異なります。
REPORTキーワードを使用して実行ファイルを指定すると、レポートの各パラメータ(「入力マスク」、「検証トリガー」など)の設定を使用してパラメータ値が検証されます。
REPORTキーワードを使用して実行ファイルを指定しないと、パラメータ値が未定義のパラメータを参照している場合もあるので、パラメータ値の解析や検証は行われません。

A.7.7 P_AVAILABILITY

表A-77では、P_AVAILABILITYキーワードを使用できるコンポーネントを示します。

表A-77 P_AVAILABILITYを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_AVAILABILITYを使用して、指定されたレポートがいつ処理できるようになるかを決定する使用可能日カレンダの名前を指定します。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_AVAILABILITY=calendar_name

値

calendar_nameには、有効な使用可能日カレンダ名を指定します。

デフォルトなし

使用上の注意: 使用可能日カレンダは、このSQL*Plusスクリプトを実行する前に、Oracle Portalに登録されている必要があります。登録されていない場合、無効なパッケージが作成されることがあります。

A.7.8 P_DESCRIPTION

表A-78では、P_DESCRIPTIONキーワードを使用できるコンポーネントを示します。

表A-78 P_DESCRIPTIONを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_DESCRIPTIONを使用して、レポートに関する追加情報を提供するテキストを指定できます。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_DESCRIPTON=description_text

値

description_textには、任意のテキスト文字列を指定します。

デフォルトなし

A.7.9 P_FORMATS

表A-79では、P_FORMATSキーワードを使用できるコンポーネントを示します。

表A-79 P_FORMATSを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_FORMATSを使用して、指定されたレポートに許可された宛先フォーマットを指定できます。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_FORMATS=destination_format|(destination_format1,destination_format2,...)

値

destination_formatには、有効な宛先の形式(HTMLなど)または、名前をカンマで区切り、括弧で囲んだ有効な宛先の形式のリスト((HTMLCSS,PDF,RTF)など)を指定します。

使用上の注意: レポートの宛先フォーマットがDELIMITEDDATAの場合、レポートをOracle Portalにバッチ登録できないことがあります。回避策として、異なる宛先フォーマットを定義して、レポートをバッチ登録し、後で手動でレポートをDESFORMAT=DELIMITEDDATAに編集できます。バッチ登録の詳細は、付録C「Oracle Portalへのレポートのバッチ登録」を参照してください。

デフォルトなし

A.7.10 P_JDBCPDS

表A-80では、P_JDBCPDSキーワードを使用できるコンポーネントを示します。

表A-80 P_JDBCPDSを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

説明: P_JDBCPDSを使用して、JDBC問合せを含むレポートを実行するためにデータベースに接続するためのJDBCプラガブル・データソース(PDS)接続文字列を指定します。

A.7.11 P_NAME

表A-81では、P_NAMEキーワードを使用できるコンポーネントを示します。

表A-81 P_NAMEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_NAMEを使用して、Oracle Portalに表示されるレポート名を指定します。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_NAME=report_name

値

report_nameには、任意のレポート名を指定します。

デフォルト: P_NAMEを指定しない場合、PL/SQLファンクションにはレポート定義ファイル名が入力されます。

使用上の注意

P_NAMEを指定しない場合、PL/SQLファンクションにはレポート定義ファイル名が入力されます。
P_NAMEは、Oracle Portalに登録する各レポート定義ファイルに対して同じレポート名を使用する場合にのみ指定します。このオプションは通常、空白にします。
レポート名の先頭には数字は使用できません(たとえば、401K_ reportは無効なファイル名ですが、my_401K_reportは有効です)。

A.7.12 P_OWNER

表A-82では、P_OWNERキーワードを使用できるコンポーネントを示します。

表A-82 P_OWNERを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_OWNERを使用して、レポート定義ファイルの登録時に作成されレポートのパッケージを所有するOracle Portal DBプロバイダを指定します。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_OWNER=portal_dbprovider

値

portal_dbproviderには、有効なOracle Portal DBプロバイダ名を指定します。

デフォルト: SQL*Plusスクリプト・ファイルの実行時に接続したOracle Portal DBプロバイダの名前になります。

A.7.13 P_PFORMTEMPLATE

表A-83では、P_PFORMTEMPLATEキーワードを使用するコンポーネントを示します。

表A-83 P_PFORMTEMPLATEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_PFORMTEMPLATEを使用して、ランタイム・パラメータ・フォームのスタイルを決定するOracle Portalテンプレートの名前を指定します。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_PFORMTEMPLATE=template_name

値

template_nameには、有効なOracle Portalテンプレート名を指定します。

デフォルトなし

A.7.14 P_PRINTERS

表A-84では、P_PRINTERSキーワードを使用するコンポーネントを示します。

表A-84 P_PRINTERSを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_PRINTERSを使用して、指定されたレポートに許可されたプリンタを指定できます。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_PRINTERS=printer_name

値

printer_nameには、有効なプリンタ(PRT1など)または、名前をカンマで区切り、括弧で囲んだ有効なプリンタのリスト((PRT1,PRT2,PRT3)など)を指定します。

デフォルトなし

使用上の注意: プリンタへのアクセスは、このSQL*Plusスクリプトを実行する前に、Oracle Portalに登録されている必要があります。

A.7.15 P_PRIVILEGE

表A-85では、P_PRIVILEGEキーワードを使用できるコンポーネントを示します。

表A-85 P_PRIVILEGEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_PRIVILEGEを使用して、選択したレポートを実行するアクセス権限を持つユーザーまたはロールを指定できます。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_PRIVILEGE=user_name

値

user_nameには、Oracle Portalで認識できるユーザー名またはロール(SCOTTなど)、または名前をカンマで区切り括弧で囲んだユーザー名またはロールのリスト((SCOTT,JABERS,PMARTIN)など)を指定します。

デフォルトなし

A.7.16 P_SERVERS

表A-86では、P_SERVERSキーワードを使用できるコンポーネントを示します。

表A-86 P_SERVERSを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_SERVERSを使用して、レポートを実行できる制限付きReports Serverの名前を指定します。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_SERVERS=tnsname

値

tnsnameには、Reports Serverの有効なTNS名(repserverなど)、または名前をカンマで区切り括弧で囲んだReports Serverの有効なTNS名のリスト((repserver, acct_server, sales_server)など)を指定します。

デフォルトなし

使用上の注意: Reports Serverへアクセスする前にOracle Portalに登録されている必要があります。

A.7.17 P_TRIGGER

表A-87では、P_TRIGGERSキーワードを使用するコンポーネントを示します。

表A-87 P_TRIGGERを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_TRIGGERを使用して、パラメータ値をコマンドラインで指定する際およびランタイム・パラメータ・フォームを確定する際に実行されるPL/SQLファンクションを指定できます。ファンクションは、ブール値(TRUEまたはFALSE)を戻す必要があります。

このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_TRIGGER=plsql_function

値

plsql_functionには、ブール値を戻す有効なPL/SQLファンクションを指定します。

デフォルトなし

例

P_TRIGGER="Is begin IF UPPER(DESTYPE) = ''PRINTER'' AND EMPNAME = ''SMITH'' THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; end;"

A.7.18 P_TYPES

表A-88では、P_TYPESキーワードを使用できるコンポーネントを示します。

表A-88 P_TYPESを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	はい	いいえ	いいえ

説明: P_TYPESを使用して、指定されたレポートに許可された宛先タイプを指定できます。このキーワードが使用されるのは、DTYPE=REGISTERの場合のみです。

構文: P_TYPES=destination_type

値

destination_typeには、有効な宛先タイプ(ブラウザに表示する場合のCACHEなど)、または名前をカンマで区切り括弧で囲んだ有効な宛先タイプのリスト((CACHE,MAIL,PRINTER)など)を指定します。

デフォルトなし

A.7.19 PAGEGROUP

表A-89では、PAGEGROUPキーワードを使用できるコンポーネントを示します。

表A-89 PAGEGROUPを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: PAGEGROUPを使用して、レポート出力の配信先となるOracle Portalページ・グループの名前を指定します。旧リリースとの下位互換性の詳細は、「SITENAME」(Oracle WebDBリリース2.2の場合)および「CONTENTAREA」(Oracle9iAS Portalリリース1の場合)を参照してください。このキーワードを使用するには、ページ・グループを事前にOracle Portalで作成しておく必要があります。

構文: PAGEGROUP=pagegroup

値

pagegroupには、Oracle Portalで使用される有効なページ・グループ名(内部名)を指定します。

デフォルトなし

使用上の注意

Oracle Reportsの出力をOracle Portalにプッシュする場合、このキーワードの使用は必須です。
ページ・グループ名には、表示名ではなく内部名を指定する必要があります。内部名を使用すると、Oracle Portalのページ・インスタンスが一意に識別されます。
関連するキーワードは、CONTENTAREA*、EXPIREDAYS、ITEMTITLE、OUTPUTFOLDER*、OUTPUTPAGE、PAGEGROUP、SITENAME*、STATUSFOLDER*、STATUSPAGEです。

* Oracle9iAS Portalリリース1およびOracle WebDBリリース2.2に対する下位互換性を確保するために維持されています。

A.7.20 PAGESIZE

表A-90では、PAGESIZEキーワードを使用できるコンポーネントを示します。

表A-90 PAGESIZEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	はい	はい	いいえ

説明: PAGESIZEを使用して、物理ページの大きさ(プリンタが出力するページのサイズ)を設定できます。ページはレポートが入る大きさである必要があるので注意してください。たとえば、レポートのフレームがページ・ディメンションを超えるサイズになっている場合、レポートは実行されません。

構文: PAGESIZE=width x height

値: 「ページ幅 x ページ高さ」の形式のフォームの有効なページ・サイズ。ページ幅とページ高さは0(ゼロ)より大きくする必要があります。最大幅と最大高さは、Oracle Reports Builderに設定されている測定単位によって異なります(「編集」→「プリファレンス」→「一般」タブ)。インチでは、最大幅および高さは512インチです。センチメートルでは、1312センチメートルです。パイカでは36,864パイカです。

デフォルト: ビットマップの場合は8.5 x 11インチです。キャラクタ・モードの場合は80×66文字です。レポートがキャラクタ・モードに対して設計されていて、ビットマップで実行あるいは変換される場合、ページ・サイズが指定されていないときは次の式を使用して決定されます。(デフォルトのページ・サイズ * 文字ページのサイズ)/デフォルトの文字のページ・サイズ。たとえば、文字ページのサイズが80 x 20の場合、ビットマップのページは次のサイズになります。
( (8.5 * 80)/80) x ((11 * 20)/66) = (680/80) x (220/66) = 8.5 x 3.33

使用上の注意

プリンタによっては、物理ページの印刷可能な面積に制限があります。たとえば、プリンタが受け入れる用紙は8.5×11インチであっても、実際にプリントできる面積は8×10.5インチである可能性もあります。プリンタの印刷可能面積よりも大きなページ幅とページ高さをOracle Reports Builderで定義すると、レポートを出力した際にクリッピングが生じる場合があります。クリッピングを防ぐには、プリンタの印刷可能領域を拡大するか(オペレーティング・システムで可能な場合)、ページ幅×ページの高さをページの印刷可能な領域のサイズに設定します。
レター・サイズは、8.5 x 11インチです。A4サイズは、210mm x 297mmまたは8.25インチ x 11.75インチです。
PAGESIZEキーワードを使用すると、その値が、レポート定義のページ・ディメンションよりも優先されます。
ランタイム・パラメータ・フォームに入力されたPAGESIZE値は、コマンドラインに入力されたPAGESIZE値よりも優先されます。

A.7.21 PAGESTREAM

表A-91では、PAGESTREAMキーワードを使用できるコンポーネントを示します。

表A-91 PAGESTREAMを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: PAGESTREAMは、レポートがHTMLあるいはHTMLCSS出力としてフォーマットされている場合に、次のいずれかで設定されているナビゲーション・コントロールを使用して、そのレポートのページ・ストリーム(ページ区切り)を有効または無効にします。

レポート・プロパティ・パレットのページ・ナビゲーション・コントロール値プロパティおよびページ・ナビゲーション・コントロール・タイプ・プロパティ
BEFORE REPORTトリガーのPL/SQL (SRW.SET_PAGE_NAVIGATION_HTML)

構文: PAGESTREAM={YES|NO}

値

YESの場合、レポート出力のページ区切りを行います。
NOの場合、ページ区切りなしでレポートを出力します。

デフォルト: NO

A.7.22 PARAMFORM

表A-92では、PARAMFORMキーワードを使用できるコンポーネントを示します。

表A-92 PARAMFORMを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	いいえ	はい	いいえ

説明: PARAMFORMを使用して、レポートをOracle Reports Servlet (rwservlet)により実行する際にランタイム・パラメータ・フォームを表示するかどうかを指定します。PARAMFORMは、JSPベースのWebレポートではなく、ペーパー・レイアウト・レポートにパラメータを指定するためにのみ使用されます。

構文: PARAMFORM=YES|NO|HTML

値

YESの場合、パラメータ・フォームが表示されます。
NOの場合、パラメータ・フォームが表示されません。
HTMLの場合、パラメータ・フォームがHTML形式で表示されます。

デフォルト: NO

使用上の注意

BATCH=YESの場合、PARAMFORM=YESを設定しても無効です。これは、バッチ・モードではランタイム・パラメータ・フォームを表示する意味がないためです。
Oracle Portal環境でレポートを実行する場合、このキーワードは使用しないでください。これは、Oracle Portal上でもレポートのランタイム・パラメータ・フォームの設定が可能であり、この設定がPARAMFORMキーワードで指定したパラメータ・フォームと競合する可能性があるためです。

例

http://myias.mycomp.com:7779/rwservlet?server=myrepserver+report=test.rdf 
+userid=scott/tiger@mydb+destype=cache+desformat=htmlcss+paramform=html

A.7.23 PARSEQUERY

表A-93では、PARSEQUERYキーワードを使用できるコンポーネントを示します。

表A-93 PARSEQUERYを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	いいえ	いいえ	はい	いいえ

説明: PARSEQUERYを使用して、rwservletに対するコマンド問合せを解析し、作成されたReports Serverコマンドラインを表示します。

構文 http://your_webserver/reports/rwservlet/parsequery[?] [server=server_name][&authid=username/password]

値構文を参照してください。

デフォルトなし

使用上の注意

このキーワードは値を必要としないコマンドです。つまり、対応する値を持たず、コマンドだけが入力されます。
関連するキーワードは、SERVERおよびAUTHIDです。

A.7.24 PDFCOMP

表A-94では、PDFCOMPキーワードを使用できるコンポーネントを示します。

表A-94 PDFCOMPを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: PDFCOMPを使用して、PDF出力を圧縮するかどうかを指定できます。

構文: PDFCOMP=value|{YES|NO}

値

valueには、0から9の任意の値を指定します。0の場合、PDF出力は圧縮されません。1から9の場合、PDF出力が圧縮され、ユーザーが圧縮レベルを制御できます。
YESの場合、出力は圧縮レベル6で圧縮されます。
NOの場合、出力は圧縮レベル0(非圧縮)で圧縮されます。

デフォルト: 6

A.7.25 PDFEMBED

表A-95では、PDFEMBEDキーワードを使用できるコンポーネントを示します。

表A-95 PDFEMBEDを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: PDFEMBEDを使用して、uifont.aliファイルで指定したType1 PostScriptフォント・ファイルをOracle ReportでPDF出力に埋め込むかどうかを指定します。

構文: PDFEMBED={YES|NO}

値

YESの場合、uifont.aliファイルの[PDF:Embed]ヘッダーで指定されたフォントが、PDFドライバによってPDF出力に埋め込まれます。
NOの場合、フォントはPDF出力に追加されません。

デフォルト: YES

A.7.26 PDFOWNER

表A-96では、PDFOWNERキーワードを使用できるコンポーネントを示します。

表A-96 PDFOWNERを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

注意:

Oracle Reports Builder (rwbuilder)を使用してPDF暗号化レポート出力を生成するには、コマンドのコマンドライン・キーワード(PDUSER、PDFOWNERまたはPDFSECURITY)のどれか1つ以上にパスしてrwbuilderを起動する必要があります。

Oracle Reports Builderで、「ファイルへ出力」→「PDF」を選択して、PDF暗号化出力を生成します。

説明: PDFOWNERを使用して、暗号化されたPDFレポート出力の所有者パスワードを指定します。このパスワードをPDFUSERと組み合せて、PDFレポート出力を開いたり(Acrobat Reader 5.0以降を使用)、PDFレポート出力のパスワードやアクセス権限を変更する(Acrobat Writer 6.0以降を使用)場合の認可権限を指定します。PDFOWNERおよびPDFUSERコマンドライン・キーワードで考えられる組合せによる結果の詳細は、表11-5を参照してください。

詳細は、第11.2.4項「暗号化、パスワードによる保護および権限セキュリティ」を参照してください。

構文: PDFOWNER=owner_password

値

owner_passwordには、エンド・ユーザーが要求に応じて入力する必要がある所有者パスワードを指定します。

デフォルトなし

A.7.27 PDFSECURITY

表A-97では、PDFSECURITYキーワードを使用できるコンポーネントを示します。

表A-97 PDSECURITYを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

注意:

Oracle Reports Builderで、「ファイルへ出力」→「PDF」を選択して、PDF暗号化出力を生成します。

説明: PDFSECURITYを使用して、暗号化されたPDFレポート出力の権限を最大8個まで抑止します。PDFSECURITYを指定する場合、PDFUSERおよびPDFOWNERの指定は必須ではありません。

詳細は、第11.2.4項「暗号化、パスワードによる保護および権限セキュリティ」を参照してください。

構文: PDFSECURITY=suppress_permission[,suppress_permission...]

値

表A-98に示す値をsuppress_permissionに指定すると、対応する効果が有効になります。

表A-98 PDFSECURITYの値

値	効果
`NOHIRESPRINTING`	高解像度での印刷を禁止します。文書は低解像度で印刷されます。
`NOMODIFYCONTENTS`	`NOMODIFYANNOTATIONS`、`NOFILLIN`および`NOASSEMBLY`で制御されていない操作によって文書の内容を変更することを禁止します。
`NOCOPY`	`NOSCREENREADERS`で制御されていない操作によって文書からテキストやグラフィックをコピーしたり、それ以外の手段で抽出することを禁止します。
`NOMODIFYANNOTATIONS`	テキスト注釈の追加や変更、さらに対話型フォームのフィールドにおける入力を禁止します。同時に`NOMODIFYCONTENTS`が指定されている場合、対話型フォームのフィールド(署名フィールドを含む)の作成や変更を禁止します。
`NOFILLIN`	`NOMODIFYANNOTATIONS`が指定されていない場合でも、既存の対話型フォームのフィールド(署名フィールドを含む)に入力することを禁止します。
`NOSCREENREADERS`	(アクセシビリティのサポートまたは他の目的で)テキストやグラフィックの抽出を禁止します。
`NOASSEMBLY`	`NOMODIFYCONTENTS`が指定されていない場合でも、文書の加工(ページの挿入、回転または削除、およびブックマークやサムネイル・イメージの作成)を禁止します。
`NOPRINTING`	PDF文書の印刷を禁止します。

デフォルト: なし(すべての権限が付与される)。

例

PDFSECURITY=NOHIRESPRINTING,NOMODIFYCONTENTS,NOCOPY

A.7.28 PDFUSER

表A-99では、PDFUSERキーワードを使用できるコンポーネントを示します。

表A-99 PDFUSERを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

注意:

Oracle Reports Builderで、「ファイルへ出力」→「PDF」を選択して、PDF暗号化出力を生成します。

説明: PDFUSERを使用して、暗号化されたPDFレポート出力のユーザー・パスワードを指定します。このパスワードをPDFOWNERと組み合せて、PDFレポート出力を開いたり(Acrobat Reader 5.0以降を使用)、PDFレポート出力のパスワードやアクセス権限を変更する(Acrobat Writer 6.0以降を使用)場合の認可権限を指定します。PDFOWNERおよびPDFUSERコマンドライン・キーワードで考えられる組合せによる結果の詳細は、表11-5を参照してください。

詳細は、第11.2.4項「暗号化、パスワードによる保護および権限セキュリティ」を参照してください。

構文: PDFUSER=user_password

値

user_passwordには、エンド・ユーザーが要求に応じて入力する必要があるユーザー用パスワードを指定します。

デフォルトなし

A.7.29 PFACTION

表A-100では、PFACTIONキーワードを使用できるコンポーネントを示します。

表A-100 PFACTIONを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	いいえ	いいえ	いいえ	いいえ	いいえ

注意:

PFACTIONは、Oracle Forms ServicesキーワードのRUN_REPORT_OBJECTと併用することもあります。これは、Web上でOracle FormsからOracle Reportsをコールする際に最もセキュアな方法です。RUN_REPORT_OBJECTを使用してOracle FormsからOracle Reportsをコールする方法の詳細は、OTNにあるホワイト・ペーパー『Oracle Application Server 10g Integrating Oracle Reports in Oracle Forms Services Applications』(http://otn.oracle.com/products/forms/pdf/10g/frm10gsrw10g.pdf)を参照してください。『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』も参照してください。

説明: PFACTIONは、パラメータ・フォームのアクション文字列を指定するために使用します。rwclientまたはOracle Forms ServicesのRUN_REPORT_OBJECTキーワードによりリクエストを送信して、パラメータ・フォームのあるレポートを実行する場合、生成されたパラメータ・フォームは、コマンドラインにPFACTIONが含まれていないと使用できません。パラメータ・フォームが使用できないという現象は、action属性が空になっていることが原因です(rwclientとRUN_REPORT_OBJECTがによりサーバー上で直接Oracle Reportsがコールされるため、Oracle Reportsでは、HTMLパラメータ・フォームを生成する際、Web環境にアクセスしてaction属性に値を移入するために必要な情報を取得できない)。

action属性は、エンド・ユーザーが「実行」をクリックしたときに実行されるアクションを定義する標準HTMLタグformの一部です。エンド・ユーザーが「実行」をクリックした後、Oracle Reportsのリクエストを処理するために必要な非表示ランタイム・パラメータが、Oracle Reportsパラメータ・フォームのaction属性に含まれる必要があります。

構文: PFACTION=request_URL_to_rwservlet?_hidden_encoded_original_url_string

値

request_URL_to_rwservlet: http://host:port/reports/rwservletのURL。
encoded_original_url_string: レポートを実行する問合せ文字列。

例

rwclient.exe report=pform.rdf destype=cache desformat=pdf paramform=yes PFACTION="http://mymachine.mycompany.com:7777/reports/rwservlet?_hidden_report=pform.rdf%20destype=cache%20desformat=pdf"

A.7.30 PRINTJOB

表A-101では、PRINTJOBキーワードを使用できるコンポーネントを示します。

表A-101 PRINTJOBを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
いいえ	いいえ	はい	いいえ	いいえ	いいえ

説明: PRINTJOBを使用して、レポートを実行する前に「ジョブの印刷」ダイアログ・ボックスを表示するかどうかを指定できます。

構文: PRINTJOB={YES|NO}

値

YESの場合、レポートが実行される前に「ジョブの印刷」ダイアログ・ボックスが表示されます。
NOの場合、「ジョブの印刷」ダイアログ・ボックスが表示されずに、レポートが実行されます。

デフォルト: YES

使用上の注意

レポートが派生プロセスで実行されるときは(rwrunなどのコンポーネントが、rwbuilderなどの別のコンポーネント内でコールされる場合)、PRINTJOBの値に関係なく、「ジョブの印刷」ダイアログ・ボックスは表示されません。
DESTYPE=MAILのときは、PRINTJOBの値にかかわりなく、「ジョブの印刷」ダイアログ・ボックスは表示されません。

A.7.31 READONLY

表A-102では、READONLYキーワードを使用できるコンポーネントを示します。

表A-102 READONLYを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	はい	いいえ	はい	いいえ

説明: READONLYを使用して、レポートでの複数回にわたる問合せで読取り一貫性をリクエストできます。Oracleデータベースからデータにアクセスする場合、読取り一貫性は、SET TRANSACTION READ ONLY文で確保されます(SET TRANSACTION READ ONLYの詳細は、使用しているOracleデータベースのドキュメントを参照してください)。

注意:

SET TRANSACTION READ ONLYの詳細は、Oracle SQLのドキュメントを参照してください。このドキュメントは、Oracle Technology Network(http://www.oracle.com/technology/index.html)で入手できます。

構文: READONLY={YES|NO}

値

YESの場合、読取り一貫性をリクエストします。
NOの場合、読取り一貫性は提供されません。

デフォルト: NO

使用上の注意

READONLYは、複数の問合せを使用するレポートでのみ役立ちます。Oracleデータベースでは、単一の問合せを使用するレポートに対しては、読取り一貫性がロックなしで自動的に提供されます。
レポート・トリガーの実行順に関して、データ・フェッチが行われる前にSET TRANSACTION READ ONLYを設定しておく必要があります。
READONLYは、コマンドラインからJSPベースのWebレポートを実行する場合に使用できます。

A.7.32 RECURSIVE_LOAD

表A-103では、RECURSIVE_LOADキーワードを使用できるコンポーネントを示します。

表A-103 RECURSIVE_LOADを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	はい	はい	いいえ

説明: RECURSIVE_LOADを使用して、レポートの実行時に、プログラム・ユニットの外部参照を検証するかどうかを指定します。無効な参照があった場合、プログラム・ユニットは自動的に再コンパイルされます。RECURSIVE_LOADをNOに設定すると、最初にPL/SQLがコンパイルされたデータベースとは異なるデータベースにレポートを実行する場合に役立ちます。

構文: RECURSIVE_LOAD={YES|NO}

値

YESの場合、レポートの実行時に外部参照が検証されます。無効な参照があった場合、そのプログラム・ユニットは(.rdfまたは.pllであっても)再コンパイルされます。
NOの場合、レポートの実行時に外部参照が検証されません。この設定は、最初にPL/SQLがコンパイルされたデータベースとは異なるデータベースにレポートを実行する場合に有効です。

デフォルト: YES

A.7.33 REPLYTO

表A-104では、REPLYTOキーワードを使用できるコンポーネントを示します。

表A-104 REPLYTOを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: REPLYTOを使用して、送信者が送信者(FROMキーワードで指定)以外の宛先に返信を送信させる場合に、返信の送信先となる電子メール・アドレスを指定します。

構文: REPLYTO="emailid"

値

emailidには、someone@foo.comの形式で有効な電子メール・アドレスを指定します。

デフォルトなし

使用上の注意: 関連するキーワードは、BCC、CC、FROMおよびSUBJECTです。電子メールの主な宛先を指定するには、DESNAMEを使用します。

A.7.34 REPORT | MODULE

「MODULE|REPORT」を参照してください。

A.7.35 ROLE

表A-105では、ROLEキーワードを使用できるコンポーネントを示します。

表A-105 ROLEを使用するコンポーネント

rwclient	rwrun	rwbuilder	rwconverter	rwservlet	rwserver
はい	はい	いいえ	いいえ	はい	いいえ

説明: ROLEを使用して、レポートに対するデータベース・ロールを実行時にチェックするように指定できます。このキーワードは、通常アクセス権限を持たないデータベース表に対して、問合せを行うレポートを実行できるようにする場合に有効です。

構文: ROLE={rolename[/rolepassword]}

値

rolenameには、有効なロールを指定します。

rolepasswordには、(オプションで)ロール・パスワードを指定します。

デフォルトなし

使用上の注意: ROLEは、コマンドラインからJSPベースのWebレポートを実行する場合に使用できます。