プログラミング・インタフェースのクイック・スタート

  関連項目

プロパティ

メソッド

イベント

事前定義済みの定数

プロパティのマップ

ResultCodeConstants


プロパティ

ReportName

DocumentName

ReportsServer

OutputDestination

OutputName

DatabaseUser

DatabasePassword

DatabaseName

ReportMode

UserDefinedParameters

CommandFile

OnRunSuccess

OnRunFailure

ShowParameterForm

PageSize

Orientation

NumberOfCopies

OutputDriver

CurrencyString

ThousandsCharacter

DecimalCharacter

ArrayBufferKBSize

VirtualMemoryKBSize

LongColumnBufferKBSize

SetTransactionReadOnly

AutomaticCommit

NonBlockingSQL

DebuggingChecks

ProfileLogFile

ErrorLogFile

TraceLogFile

TraceMode

TraceLogAll

TraceLogPerformance

TraceLogReportsObjects

TraceLogPLSQLObjects

TraceLogSQLTrace

TraceLogTimeStamp

TraceLogErrors

CallMode

CallTimeout

CallFrequency

JobTolerance

JobName

JobSchedule

SystemUser

SystemPassword

JobNotifyOnSuccess

JobNotifyOnFailure

Distribute

Destination


メソッド

GetCommandLine

GetReportStateCode

GetReportStateCodeString

GetReportStateString

RunReport

RunReportSimple

SetDefaults

Terminate Report

GetOutputName


イベント

AfterRunReport

BeforeRunReport

RunReportProgress


事前定義済みの定数

OutputDestinationConstants

ReportModeConstants

CallModeConstants

OrientationConstants

OnRunConstants

TraceModeConstants

ResultCodeConstants


コマンド・ライン引数に対するプロパティのマップ

ActiveXコントロール・プロパティ	Reports Server/Runtimeのコマンド・ライン引数
ArrayBufferKBSize	ARRAYSIZE
AutomaticCommit	AUTOCOMMIT
CallFrequency	なし
CallMode	なし
CallTimeout	なし
CommandFile	CMDFILE
CurrencyString	CURRENCY
DatabaseUser	USERID
DatabasePassword	USERID
DatabaseName	USERID
DebuggingChecks	RUNDEBUG
DecimalCharacter	DECIMAL
Destination	DESTINATION
Distribute	DISTRIBUTE
DocumentName	REPORT
ErrorLogFile	ERRFILE
JobTolerance	TOLERANCE（サーバー専用）
JobName	JOBNAME（サーバー専用）
JobSchedule	SCHEDULE（サーバー専用）
JobNotifyOnSuccess	NOTIFYSUCCESS（サーバー専用）
JobNotifyOnFailure	NOTIFYFAILURE（サーバー専用）
LongColumnBufferKBSize	LONGCHUNK
NonBlockingSQL	NONBLOCKSQL
NumberOfCopies	COPIES
OnRunFailure	ONRUNFAILURE
OnRunSuccess	ONRUNSUCCESS
Orientation	ORIENTATION
OutputDestination	DESTYPE
OutputDriver	DESFORMAT
OutputName	DESNAME
PageSize	PAGESIZE
ProfileLogFile	PROFILE
ReportMode	MODE
ReportName	REPORT
ReportsServer	SERVER
SetTransactionReadOnly	READONLY
ShowParameterForm	PARAMFORM
SystemUser	AUTHID
SystemPassword	AUTHID
ThousandsCharacter	THOUSANDS
TraceLogFile	TRACEFILE
TraceMode	TRACEMODE
TraceLogAll	TRACEOPTS=TRACE_ALL
TraceLogErrors	TRACEOPTS=TRACE_ERR
TraceLogPerformance	TRACEOPTS=TRACE_PRF
TraceLogPLSQLObjects	TRACEOPTS=TRACE_PLS
TraceLogReportsObjects	TRACEOPTS=TRACE_APP
TraceLogSQLTrace	TRACEOPTS=TRACE_SQL
TraceLogTimeStamp	TRACEOPTS=TRACE_TMS
UserDefinedParameters	ユーザー定義のレポート・パラメータ
VirtualMemoryKBSize	BUFFERS


プロパティに対するコマンド・ライン引数のマップ

Reports Server/Runtimeのコマンド・ライン引数	ActiveXコントロール・プロパティ
なし	CallFrequency, CallMode, CallTimeout
ARRAYSIZE	ArrayBufferKBSize
AUTHID	SystemPassword, SystemUser
AUTOCOMMIT	AutomaticCommit
BUFFERS	VirtualMemoryKBSize
CMDFILE	CommandFile
COPIES	NumberOfCopies
CURRENCY	CurrencyString
DECIMAL	DecimalCharacter
DESTYPE	OutputDestination
DESFORMAT	OutputDriver
DESNAME	OutputName
DESTINATION	Destination
DISTRIBUTE	Distribute
ERRFILE	ErrorLogFile
JOBNAME（サーバー専用）	JobName
LONGCHUNK	LongColumnBufferKBSize
MODE	ReportMode
NONBLOCKSQL	NonBlockingSQL
NOTIFYSUCCESS	JobNotifyOnSuccess
NOTIFYFAILURE	JobNotifyOnFailure
ONRUNFAILURE	OnRunFailure
ONRUNSUCCESS	OnRunSuccess
ORIENTATION	Orientation
PAGESIZE	PageSize
PARAMFORM	ShowParameterForm
PROFILE	ProfileLogFile
READONLY	SetTransactionReadOnly
REPORT	DocumentName, ReportName, _ReportName
RUNDEBUG	DebuggingChecks
SCHEDULE（サーバー専用）	JobSchedule
TOLERANCE（サーバー専用）	JobTolerance
SERVER	ReportsServer
THOUSANDS	ThousandsCharacter
TRACEFILE	TraceLogFile
TRACEMODE	TraceMode
TRACEOPTS=TRACE_ALL	TraceLogAll
TRACEOPTS=TRACE_ERR	TraceLogErrors
TRACEOPTS=TRACE_PRF	TraceLogPerformance
TRACEOPTS=TRACE_PLS	TraceLogPLSQLObjects
TRACEOPTS=TRACE_APP	TraceLogReportsObjects
TRACEOPTS=TRACE_SQL	TraceLogSQLTrace
TRACEOPTS=TRACE_TMS	TraceLogTimeStamp
USERID	DatabaseUser
ユーザー定義のレポート・パラメータ	UserDefinedParameters
USERID	DatabasePassword, DatabaseName


プロパティのマップ

コマンド・ライン引数に対するプロパティのマップ

プロパティに対するコマンド・ライン引数のマップ


「一般」プロパティ・ページ


「データ･ソース」プロパティ・ページ


「出力オプション」プロパティ・ページ


「パラメータ・オプション」プロパティ・ページ


「実行時オプション」プロパティ・ページ


「デバッグ・オプション」プロパティ・ページ


「スケジューリング・オプション」プロパティ・ページ


「サーバー･オプション」プロパティ・ページ


「通知オプション」プロパティ・ページ


「システム認証」プロパティ・ページ


vh


ReportName

ReportName（またはDocumentName）プロパティは、実行するレポートです。任意の有効な実行ファイル（.rdfまたは.repの拡張子が付いたファイル）を指定できます。ファイル拡張子を入力しない場合、Report Builderでは、拡張子.repのファイル、拡張子.rdfのファイル、拡張子のないファイルの順で検索します。

dispid(1)はReportNameに、dispid(2)はDocumentNameに使用します。
型: BSTR
REPORTコマンド・ライン・パラメータに対応します。


ReportsServer

ReportsServer プロパティは、Reports ServerのTNSアドレスです。

dispid(3)
型: BSTR
SERVERコマンド・ライン・パラメータに対応します。


OutputDestination

OutputDestinationプロパティは、レポート出力を受け取る宛先デバイスのタイプです。「OutputDestinationConstants」を参照してください。

dispid(4)
型: SHORT
DESTYPEコマンド・ライン・パラメータに対応します。


OutputName

OutputNameプロパティは、レポート出力が送られるファイルまたはプリンタ、メール・アドレスの名前です。名前をカンマで区切って丸カッコで囲むことによって、複数のユーザー名を指定できます （（<name>, <name>, .. .<name>）など）。

dispid(5)
型: BSTR
DESNAMEコマンド・ライン・パラメータに対応します。


DatabaseUser

DatabaseUserプロパティは、オプションのNet80アドレス（SYSTEMアカウントではない）を持つOracleのユーザー名およびパスワードです。

dispid(6)
型: BSTR
USERIDコマンド・ライン・パラメータに対応します。


DatabasePassword

DatabasePasswordプロパティは、DatabaseUserプロパティに指定されたデータベース・ユーザーのOracleパスワードです。

dispid(7)
型: BSTR
USERIDコマンド・ライン・パラメータに対応します。


DatabaseName

DatabaseNameプロパティは、レポートが実行するデータベースのNet80アドレスです。

dispid(8)
型: BSTR
USERIDコマンド・ライン・パラメータに対応します。


ReportMode

ReportModeプロパティは、キャラクタ・モードまたはビットマップのどちらでレポートを実行するかを指定します。これによって、キャラクタ・モードのレポートをビットマップのReport Builderから、またはビットマップのレポートをキャラクタ・モードのReport Builderから実行できます。たとえば、端末（vt220など）からPostScriptプリンタにレポートを送る場合、キャラクタ・モードのRWRUN60を起動し、MODE=BITMAPを指定してレポートを実行できます。「ReportModeConstants」を参照してください。

dispid(9)
型: SHORT
MODEコマンド・ライン・パラメータに対応します。


UserDefinedParameters

UserDefinedParametersプロパティは、レポートのユーザー・パラメータをコマンド・ライン書式（myparam1=yes myparam2=10など）で表したリストです。

dispid(10)
型: BSTR
ユーザー定義のコマンド・ライン・パラメータ文字列を表します。


CommandFile

CommandFileプロパティは、実行コマンドの引数を含むファイルです。このオプションを使用すると、レポートを実行するたびに多くの引数を指定しなくても、レポートを実行できます。

dispid(11)
型: BSTR
CMDFILEコマンド・ライン・パラメータに対応します。


OnRunSuccess

OnRunSuccessプロパティは、レポートの実行完了時に、COMMITまたはROLLBACKのどちらを実行するかを指定します。「OnRunConstants」を参照してください。

dispid(12)
型: SHORT
ONRUNSUCCESSコマンド・ライン・パラメータに対応します。


OnRunFailure

OnRunFailureプロパティは、エラーが発生してレポートが終了できない場合に、COMMITまたはROLLBACKのどちらを実行するかを指定します。「OnRunConstants」を参照してください。

dispid(13)
型: SHORT
ONRUNFAILUREコマンド・ライン・パラメータに対応します。


ShowParameterForm

ShowParameterFormプロパティは、レポートの実行時に、ランタイム・パラメータ・フォームを表示するかどうかを指定します。

dispid(14)
型: BOOL
PARAMFORMコマンド・ライン・パラメータに対応します。


PageSize

PageSizeプロパティは、ページ幅xページ高さの形で表わす物理ページのサイズ（つまり、プリンタが出力するページのサイズ）です。ページには、レポートの内容が収まるだけの大きさが必要であることに注意してください。たとえば、レポートの枠サイズがページのサイズよりも大きくなると、レポートは実行されません。

dispid(15)
型: BSTR
PAGESIZEコマンド・ライン・パラメータに対応します。


Orientation

Orientationプロパティは、レポートのページが印刷する方向を制御します。「OrientationConstants」を参照してください。

dispid(16)
型: SHORT
ORIENTATIONコマンド・ライン・パラメータに対応します。


NumberofCopies

NumberofCopiesプロパティは、レポートの印刷部数です。

dispid(17)
型: LONG
COPIESコマンド・ライン・パラメータに対応します。


OutputDriver

OutputDriverプロパティは、プリンタ・ドライバ（ビットマップ環境）またはプリンタ特性（キャラクタ・モード環境）、PDF（Portable Display Format）、HTMLを指定します。

dispid(18)
型: BSTR
DESFORMATコマンド・ライン・パラメータに対応します。


CurrencyString

CurrencyStringプロパティは、数値書式に使用される通貨記号です。

dispid(19)
型: BSTR
CURRENCYコマンド・ライン・パラメータに対応します。


ThousandsCharacter

ThousandsCharacterプロパティは、数値書式に使用される3桁区切り文字です。

dispid(20)
型: BSTR
THOUSANDSコマンド・ライン・パラメータに対応します。


DecimalCharacter

DecimalCharacterプロパティは、数値書式に使用される小数点文字です。

dispid(21)
型: BSTR
DECIMALコマンド・ライン・パラメータに対応します。


ArrayBufferKBSize

ArrayBufferKBSizeプロパティは、Oracle配列処理用の配列サイズで、キロバイトで指定します。通常、配列サイズが大きいほど、レポートの実行が速くなります。

dispid(22)
型: LONG
ARRAYSIZEコマンド・ライン・パラメータに対応します。


VirtualMemoryKBSize

VirtualMemoryKBSizeプロパティは、仮想メモリー・キャッシュのサイズで、キロバイトで指定します。レポートの実行に十分な領域を確保する一方で、システムのリソースを使用しすぎないように調整する必要があります。

dispid(23)
型: LONG
BUFFERSコマンド・ライン・パラメータに対応します。


LongColumnBufferKBSize

LongColumnBufferKBSizeプロパティは、Report BuilderでLONG列値を取り出す増分値のサイズで、キロバイトで指定します。LONG値を取り出す場合、メモリーのサイズに制限があるので、すべてを一度に取り出さずに、増分値ずつ取り出すことができます。LONGCHUNKは、Oracle7にのみ適用されます。

dispid(24)
型: LONG
LONGCHUNKコマンド・ライン・パラメータに対応します。


SetTransactionReadOnly

SetTransactionReadOnlyプロパティは、レポートの複数の問合せにおける読込み一貫性を要求します。Oracleからデータにアクセスする場合、読込み一貫性はSET TRANSACTION READ ONLY文によって達成されます（「SET TRANSACTION READ ONLY」の詳細は、『Oracle7 Server SQL言語リファレンス』および『Oracle8 Server SQLリファレンス』を参照）。

dispid(25)
型: BOOL
READONLYコマンド・ライン・パラメータに対応します。


AutomaticCommit

AutomaticCommitプロパティは、データベースの変更（CREATEなど）をデータベースに自動的にコミットするかどうかを指定します。一部の非Oracleデータベース（SQL Serverなど）では、AUTOCOMMIT=YESを指定する必要があることに注意してください。

dispid(26)
型: BOOL
AUTOCOMMITコマンド・ライン・パラメータに対応します。


NonBlockingSQL

NonBlockingSQLプロパティは、Report Builderがデータベースからデータをフェッチしている間に、他のプログラムを実行できるかどうかを指定します。

dispid(27)
型: BOOL
NONBLOCKSQLコマンド・ライン・パラメータに対応します。


DebuggingChecks

DebuggingChecksプロパティは、レポートの論理エラーのチェックを行うかどうかを指定します。

dispid(28)
型: BOOL
RUNDEBUGコマンド・ライン・パラメータに対応します。


ProfileLogFile

ProfileLogFileプロパティは、レポートの実行に関するパフォーマンス統計を格納するファイルの名前です。ファイル名を指定すると、Report Builderでは、レポートの実行にかかった経過時間およびCPU時間の統計を計算します。

dispid(29)
型: BSTR
PROFILEコマンド・ライン・パラメータに対応します。


ErrorLogFile

ErrorLogFileプロパティは、Report Builderで、レポートの実行中に発行されたすべてのエラー・メッセージを格納するファイルの名前です。

dispid(30)
型: BSTR
ERRFILEコマンド・ライン・パラメータに対応します。


TraceLogFile

TraceLogFileプロパティは、Report Builderがトレース情報のログをとるファイルの名前です。

dispid(31)
型: BSTR
TRACEFILEコマンド・ライン・パラメータに対応します。


TraceMode

TraceModeプロパティは、Report Builderでトレース情報をファイルに追加するか、またはファイル全体を上書きするかを示します。「TraceModeConstants」を参照してください。

dispid(32)
型: SHORT
TRACEMODEコマンド・ライン・パラメータに対応します。


TraceLogAll

TraceLogAllプロパティは、考えられるすべてのトレース情報のログをトレース・ファイルにとることを示します。このプロパティは、他のすべてのトレース・プロパティに上書きされます。

dispid(33)
型: BOOL
TRACEOPTS=TRACE_ALLコマンド・ライン・パラメータに対応します。


TraceLogPerformance

TraceLogPerformanceプロパティは、パフォーマンス統計のログをトレース・ファイルにとることを示します。

dispid(34)
型: BOOL
TRACEOPTS=TRACE_PRFコマンド・ライン・パラメータに対応します。


TraceLogReportsObjects

TraceLogReportsObjectsプロパティは、すべてのレポート・オブジェクトのトレース情報のログをトレース・ファイルにとることを示します。

dispid(35)
型: BOOL
TRACEOPTS=TRACE_APPコマンド・ライン・パラメータに対応します。


TraceLogPLSQLObjects

TraceLogPLSQLObjectsプロパティは、すべてのPL/SQLオブジェクトのトレース情報のログをトレース・ファイルにとることを示します。

dispid(36)
型: BOOL
TRACEOPTS=TRACE_PLSコマンド・ライン・パラメータに対応します。


TraceLogSQLTrace

TraceLogSQLTraceプロパティは、すべてのSQLのトレース情報のログをトレース・ファイルにとることを示します。

dispid(37)
型: BOOL
TRACEOPTS=TRACE_SQLコマンド・ライン・パラメータに対応します。


TraceLogTimeStamp

TraceLogTimeStampプロパティは、タイムスタンプがトレース・ファイルの各エントリに対して入力されることを示します。

dispid(38)
型: BOOL
TRACEOPTS=TRACE_TMSコマンド・ライン・パラメータに対応します。


TraceLogErrors

TraceLogErrorsプロパティは、エラー・メッセージと警告のログをトレース・ファイルにとることを示します。

dispid(39)
型: BOOL
TRACEOPTS=TRACE_ERRコマンド・ライン・パラメータに対応します。


CallMode

CallModeプロパティは、Reports ServerまたはReportsバックグラウンド・エンジンのどちらを使用してレポートを実行するかを示します。Reports Serverに対して実行する場合は、同期コールまたは非同期コールのどちらを使用するかも指定します。「CallModeConstants」を参照してください。

dispid(40)
型: SHORT


CallTimeout

CallTimeoutプロパティは、タイムアウトする前に、サーバーからの応答を待つ時間の長さです。

dispid(41)
型: LONG


CallFrequency

CallFrequencyプロパティは、Reports Serverに対してジョブ状態を問い合せるポーリングの頻度です。

dispid(42)
型: LONG


JobTolerance

JobToleranceプロパティは、重複ジョブの許容時間を指定します。指定したJobTolerance内に、まったく同じレポートが、同じパラメータで開始されていると、現行の要求は重複ジョブとして認識され、レポートが再実行するのではなく、キャッシュに入れられた出力が再利用されます。

dispid(43)
型: LONG
TOLERANCEコマンド・ライン・パラメータに対応します。


JobName

JobNameプロパティは、Reports Queue Managerに表示されるときのジョブの名前です。

dispid(44)
型: BSTR
JOBNAMEコマンド・ライン・パラメータに対応します。


JobSchedule

JobScheduleプロパティは、レポートがいつ、どのような頻度で実行されるかを示すスケジューリング・コマンドです。ATスケジューリング・コマンド構文を使用します。たとえば、hourly_from_09:00am_December_25,_1999のように指定します。

dispid(45)
型: BSTR
SCHEDULEコマンド・ライン・パラメータに対応します。


SystemUser

SystemUserプロパティは、制限されたReports Serverでレポートを実行するためのWebDBユーザー名とパスワードです。

dispid(55)
型: BSTR
AUTHIDコマンド・ライン・パラメータに対応します。


SystemPassword

SystemPasswordプロパティは、SystemUserプロパティに指定されたユーザーのパスワードです。

dispid(56)
型: BSTR
AUTHIDコマンド・ライン・パラメータに対応します。


JobNotifyOnSuccess

  関連項目

JobNotifyOnSuccessプロパティは、ジョブが正常に実行されると、指定した電子メール・アドレスに通知メッセージを送ります。サーバー実行モジュールは、サーバーの構成ファイルに指定された通知内容テンプレートを読み込みます。

サーバーから通知メッセージを送るには、サーバーの構成ファイルにSUCCNOTEFILEパラメータを定義しておく必要があります。詳細はシステム管理者に問い合せてください。注意

通知メッセージには、ジョブ名、Reports Serverおよびジョブが正常に完了した時刻が示されます。

dispid(57)
型: BSTR
NOTIFYSUCCESSコマンド・ライン・パラメータに対応します。


テンプレート・ファイルが見つからない場合、あるいはサーバー構成ファイルにSUCCNOTEFILEまたはFAILNOTEFILEパラメータが定義されていない場合は、LOGOPTIONパラメータが指定されている場合に限り、サーバーのログ・ファイルにエラーが記録されます。詳細はシステム管理者に問い合せてください。


JobNotifyOnFailure

  関連項目

JobNotifyOnFailureプロパティは、ジョブの実行に失敗すると、指定した電子メール・アドレスに通知メッセージを送ります。サーバー実行モジュールは、サーバーの構成ファイルに指定された通知内容テンプレートを読み込みます。

サーバーから通知メッセージを送るには、サーバーの構成ファイルにFAILNOTEFILEパラメータを定義しておく必要があります。詳細はシステム管理者に問い合せてください。注意

通知メッセージには、ジョブ名、サーバー名、ジョブが終了した時刻および失敗の理由が示されます。

dispid(58)
型: BSTR
NOTIFYFAILUREコマンド・ライン・パラメータに対応します。


Distribute

Distributeプロパティは、複数の宛先へのレポート出力の配布を使用可能または使用不可にします。 宛先は、「配布」ダイアログ・ボックスまたはDSTファイルに定義された配布リストで指定します。

dispid(59)
型: BOOLEAN
DISTRIBUTEコマンド・ライン・パラメータに対応します。


Destination

Destinationプロパティを使用すると、現在実行中のレポートの配布先を定義するDSTファイルの名前を指定できます。

dispid(60)
型: BSTR
DESTINATIONコマンド・ライン・パラメータに対応します。


GetCommandLine

GetCommandLineメソッドは、コントロール・プロパティの現在の設定値に基づいてコマンド・ラインを構成します。構成したコマンド・ラインは文字列として戻されます。

dispid(49)
プロトタイプ: BSTR GetCommandLine();


GetReportStateCode

GetReportStateCodeメソッドは、指定したレポート（ReportHandle）の現行の状態（結果または進捗のコード）を取り出します。戻されたコードは、コントロール・イベントで渡されたコードと同じです。「ResultCodeConstants」を参照してください。

dispid(50)
プロトタイプ: long GetReportStateCode([in] long ReportHandle);


GetReportStateCodeString

GetReportStateCodeStringメソッドは、指定した結果または進捗のコードに対する、ユーザーが読むことのできる文字列を取り出します。「ResultCodeConstants」を参照してください。

dispid(51)
プロトタイプ: BSTR GetReportStateCodeString([in] long Code);


GetReportStateString

GetReportStateStringメソッドは、指定したレポート（ReportHandle）の現行の状態に対する、結果または進捗を示すユーザーが読むことのできる文字列を取り出します。

dispid(52)
プロトタイプ: BSTR GetReportStateString([in] long ReportHandle);


RunReport

RunReportメソッドは、コントロール・プロパティの現在の設定値を使用して、Reports ServerまたはReportsバックグラウンド・エンジンによりレポートを実行します。ReportHandleと、（レポート実行結果ではなく）レポートの実行要求の結果/進捗コードを戻します。このコールは常に非同期で、レポートの実行完了を待たないことに注意してください。レポートと同期させる場合は、コントロール・イベントによって渡されるか、GetReportStateCodeメソッドで戻される進捗コードをさらに使用して、その動作のプログラムを作成します。結果と進捗のコードについては、「ResultCodeConstants」を参照してください。

dispid(46)
プロトタイプ: long RunReport([in, out] long ReportHandle);


RunReportSimple

RunReportSimpleメソッドは、RunReportメソッドのラッパーです。コントロール・イベント（CallFrequency=0; CallTimeout=0; CallMode=Local/Async）を生成せずに、Reports ServerまたはReportsバックグラウンド・エンジンによりレポートを実行します。ReportHandleは渡されません。

dispid(47)
プロトタイプ: long RunReportSimple();


SetDefaults

SetDefaultsメソッドは、すべてのコントロール・プロパティを強制的にデフォルト値に設定します。このメソッドにより、すでに実行されているレポートのプロパティ値が影響を受けることはありません。

dispid(48)
プロトタイプ: void SetDafaults();


Terminate Report

TerminateReportメソッドは、指定したレポート（ReportHandle）の実行を終了します。コントロール・イベントで渡されたものと同じ結果コードを戻します。「ResultCodeConstants」を参照してください。

dispid(53)
プロトタイプ: long TerminateReport([in] long ReportHandle);


GetOutputName

GetOutputNameメソッドは、レポート出力がReports ServerのキャッシュまたはODToServerCacheに送られたとき、その出力のファイル名を取得します。Reports Serverキャッシュからファイルを取得するには、キャッシュがある場所のファイル・システムを共有する必要があることに注意してください。

dispid(54)
プロトタイプ: BSTR GetOutputName([in] long ReportHandle);


BeforeRunReport

BeforeRunReportイベントは、コントロールによりレポートの実行要求が出される直前に起動します。

dispid(2)
プロトタイプ:void BeforeRunReport([in] long  ReportHandle, [in] long ResultCode);


AfterRunReport

AfterRunReportイベントは、コントロールによるレポート実行が完了した直後に起動します。レポート実行の結果を示します。「ResultCodeConstants」を参照してください。

dispid(1)
プロトタイプ:void BeforeRunReport([in] long ReportHandle);


RunReportProgress

RunReportProgressイベントは、コントロールがレポート実行中のプロセスに存在する間に起動します。指定した回数で、レポートの進捗を示します。「ResultCodeConstants」を参照してください。

dispid(3)
プロトタイプ:void RunReportProgress([in] longReportHandle, [in] long ProgressCode);


OutputDestinationConstants

OutputDestinationConstantsは、OutputDestinationプロパティ値に使用される定数です。

定数	説明
orODInReport = 0	レポート・ファイルで指定した値を使用します。
orODToLocalFile = 1	レポートをローカル・ファイルに出力します。
orODToFile = 2	レポートをファイルに出力します。
orODToPrinter = 3	レポートをプリンタに出力します。
orODToMail = 4	レポートを電子メールに出力します。
orODToScreen = 5	レポートを画面に出力します。
orODToPreview = 6	レポートをプレビューアに出力します（プリンタ・フォントを使用）。
orODToServerCache = 7	レポートをReports Serverキャッシュに出力します。
使用上の注意

•	Reports Serverの使用中に、orODToLocalFile = 1を指定すると、出力はローカル・ファイル・システムに転送されます。orODToFile = 2を指定すると、出力はReports Server側のファイルに送られます。

•	orODToScreen = 5とorODToPreview = 6は、Reportsバックグラウンド・エンジン（rwrbe60.exe）にのみ有効です。


ReportModeConstants

ReportModeConstantsは、ReportModeプロパティ値に使用される定数です。

定数	説明
orRMInReport = 0	レポート・ファイルで指定した値を使用します。
orRMBitmapMode = 1	ビットマップ・モードでレポートを実行します。
orRMCharacterMode = 2	キャラクタ・モードでレポートを実行します。


CallModeConstants

CallModeConstantsは、CallModeプロパティ値に使用される定数です。

定数	説明
orCMCallLocal = 0	rwisv60.exe実行プログラムを起動し、それによってrwrbe60.exeをコールすることで、レポートをReportsバックグラウンド・エンジンに送ります。OROCX_USE_RUNTIME環境変数が定義されていると、ランタイム実行プログラムのrwrun60.exeがかわりに起動されます。
orCMCallSync = 1	同期通信モードで、Reports Serverをコールします。RPCコールはジョブの実行要求に一度しか使用されないため、これによりネットワーク・トラフィックが軽減されます。
orCMCallAsync = 2	非同期通信モードで、Reports Serverをコールします。このオプションには、実行中のレポートの正確な状態（キューでの番号、サーバーの警告およびエラー・メッセージなど）がわかるという利点があります。


OrientationConstants

OrientationConstantsは、「Orientation」プロパティ値に使用される定数です。

定数	説明
orOInReport = 0	レポート・ファイルで指定した値を使用します。
orOInPrinter = 1	プリンタで現在選択されている印刷方向を使用します。
orOPortrait = 2	縦向きの印刷方向を使用します。
orOLandscape = 3	横向きの印刷方向を使用します。


OnRunConstants

OnRunConstantsは、OnRunSuccessおよびOnRunFailureプロパティ値に使用される定数です。

定数	説明
orORInReport = 0	レポート・ファイルで指定した値を使用します。
orORCommit = 1	レポート終了時に、COMMITを実行します。
orORRollback = 2	レポート終了時に、ROLLBACKを実行します。
orORNoAction = 3	レポート終了時に、何も行いません。


TraceModeConstants

TraceModeConstantsは、TraceModeプロパティ値に使用される定数です。

定数	説明
orTMInReport = 0	レポート・ファイルで指定した値を使用します。
orTMAppend = 1	新規の情報を既存のトレース・ログ・ファイルに追加します。
orTMReplace = 2	新規の情報を既存のトレース・ログ・ファイルに上書きします。


ResultCodeConstants

ResultCodeConstantsは、イベントやメソッドをコントロールするためのエラー・コード、進捗コードおよび結果コードとして使用される定数です。

定数	説明
orResNoError = 0	一般的な成功コードです。
orResFailed = 1	Reports ActiveXコントロールでエラーが発生しました。
orResNoComm = 10	エラー: Reports Serverへの接続を初期化できません。ネットワークが正しく構成され、Reports Serverが稼動していることを確認してください。
orResNoMemory = 11	エラー: メモリーが不足しています。
orResNoResources = 31	エラー: レポートを実行できません。システム・リソースが使い果たされています。スレッドまたはスレッド同期オブジェクトを作成できません。
orResParInvalid = 32	エラー: レポートを実行できません。1つまたは複数のプロパティの値が無効です。コントロール・プロパティの値を確認し、再試行してください。
orResParMissing = 33	エラー: レポートを実行できません。1つまたは複数の必須プロパティの値（ローカル・マシンが稼動していなければ、ReportNameおよびDatabaseUser、ReportsServer）が、指定されていません。必要なプロパティを指定し、再試行してください。
orResLocalExeNotFound = 34	エラー: レポートを実行できません。Reportsバックグラウンド・エンジン実行プログラムを使用して、レポートの実行を選択しました。正確にインストールされていないか、見つかりません。
orResTimeout = 35	レポートが正常に実行される前に、指定したCallTimeoutになりました。レポートの実行状態は、タイムアウトと同時に終了しました。
orResTooManyConnections = 36	エラー: レポートを実行できません。Reports Serverへのアクティブ接続が多すぎます。後で再試行してください。
orResListenerNone = 37	エラー: レポートを実行できません。Reports Serverが応答しません。正確にインストールされて、稼動していることを確認してください。
orResListenerBusy = 38	エラー: レポートを実行できません。Reports Serverがビジーで、接続できません。後で再試行してください。
orResListenerBad = 39	エラー: レポートを実行できません。Reports Serverへ接続できません。Reports ServerのネットワークTNS名が無効または不明です。使用しているネットワークの構成を確認してください。
orResBadCommandLine = 40	エラー: レポートを実行できません。Reports Serverで、渡したコマンド・ラインが拒否されました。コントロール・プロパティの値を確認してください。
orResBadSchedule = 41	エラー: レポートを実行できません。Reports Serverで、渡したスケジューリング・パラメータが拒否されました。コントロール・プロパティの値を確認してください。
orResServerShutdown = 42	エラー: レポートを実行できません。Reports Serverが停止しています。後で再試行してください。
orResServerError = 43	エラー: レポートを実行できません。Reports Serverのキューにレポートを入れる際に、エラーが発生しました。サーバー・リソースが使い果たされた可能性があります。後で再試行してください。
orResExecutableBad = 44	エラー: レポートを実行できません。ランタイム実行プログラムが破損しているか、不適切なバイナリ形式です。
orResNoSuchJob = 45	ジョブが存在しないか、またはすでに終了しています。
orResJobEnqueued = 46	レポートを実行中です。ジョブがReports Serverのキューに入り、実行の予定に組み込まれています。
orResJobRunning = 47	レポートを実行中です。ジョブがReports Serverエンジンによって実行されています。
orResJobParForm = 48	レポートを実行中です。Reports Serverエンジンでは、レポートのパラメータ・フォームを表示し、ユーザーの入力を待っています。
orResJobPreviewer = 49	レポートを実行中です。Reports Serverエンジンでは、レポート・プレビューを表示し、ユーザーの入力を待っています。
orResJobFinished = 50	レポートが正常に実行されました。
orResJobTerminated = 51	レポートが終了しました。レポートの実行中にエラーが発生しました。
orResJobCrashed = 52	Reports Serverの致命的エラー: レポートを実行しようとしたところ、Reports Serverがクラッシュしました。
orResJobCancelled = 53	レポートの実行が終了しました。レポートのジョブが、ユーザーまたは管理者の要求で取り消されました。
orResSecurityProblems = 54	エラー: セキュリティの問題で、要求された操作を実行できません。権限およびユーザーID、パスワード文字列を確認してください。
orResCallServerInProgress = 55	Reports Serverと通信中です。レポートが実行中です。
orResCallServerSubmitted = 56	Reports Serverと通信する権限を待っています。
orResCallServerInit = 57	Reports Serverへ送るレポート実行要求を準備中です。
orResExecutingLocal = 58	ローカル・マシンのReportsバックグラウンド・エンジンを使用して、レポートを実行中です。
orResJobOpeningReport = 59	レポートを実行中です。Reports Serverエンジンでレポート定義ファイルをオープンし、読込み中です。
orResOutputDestinationInvalid = 60	エラー: レポートを実行できません。OutputDestinationプロパティの値が、ToScreenまたはToPreviewに設定されています。対話形式の宛先は、ローカルな実行でしか使用しません。値を変更して再試行してください。
orResLocalFileNotFound = 61	エラー: レポートを実行できません。1つのプロパティの値が、オープンできないファイル名です。ファイル名を訂正して再試行してください。
orResLocalFileBad = 62	エラー: レポートを実行できません。プロパティの1つの値が、作成できないファイル名を指定します。ファイル名を訂正して再試行してください。
orResOutputTransfer = 63	レポートが正常に実行されました。レポート出力をリモート・サーバーからローカル・ファイルに転送中です。
orResNoOutputTransfer = 64	エラーが発生したため、レポートが終了しました。レポート出力が使用できないか、ローカル・ファイル・システムに転送できません。レポートの実行がエラーのために終了したか、ファイルの入力または出力エラーが発生したことが原因と考えられます。
OrResLocalOutputNameBad = 65	レポートは正常に実行されましたが、レポート出力をローカル・ファイル・システムに転送できません。ローカル・ファイル名が無効か、作成またはオープンできません。
orResServerIOFailed  = 66	エラー: Reports Serverが、ファイルの入力または出力障害を検出しました。
orResClientIOFailed = 67	エラー: ローカル・マシンにファイルの入力または出力障害があります。ローカル・ファイル・システムを確認してください。
orResBadJobTolerance  = 68	エラー: 時間の許容範囲を解釈できません。JobToleranceプロパティの値を確認してください。
orResBadReportName  = 69	レポート名が指定されていません。ReportNameプロパティの値を確認してください。
orResBadDatabaseUser = 70	データベースのログインが指定されていません。DatabaseUser、DatabasePassword、DatabaseNameの値を確認してください。
orResListenerNLS = 71	Reports Serverへ接続できません。指定したTNS名のReports Serverでは、使用しているものとは異なるキャラクタ・セットが使用されており、変換ができません。


メッセージとエラー処理

•	コントロール・プロパティは、例外なく、いつでも取得または設定できます。無効の値は無視されます。

•	情報提供メソッド（GetCommandLine、SetDafaults、GetReportStateCode、GetReportStateCodeStringおよびGetReportStateStringなど）にも、例外はありません。

•	レポートの実行要求が、何らかの理由で失敗すると、OLEオートメーション例外が発生します。実行要求に成功すると、（たとえば、RunEventProgessイベントにおいて）レポートの進捗追跡に使用できるレポート・ハンドルが戻されます。

•	レポートは、レポート・ハンドルが戻された時点からAfterRunReportイベントが起動される時点まで実行中と見なされます。

•	コントロールでは、そのレポートの実行全体を通して、1つの状態コードが使用されます。状態コードは、RunReport、TerminateReportおよびGetReportStateCodeメソッドによって戻されます。コードは、AfterRunReportイベントおよびRunReportProgressイベントに渡されます。

•	状態コードでは、レポート固有の情報（サーバー・キューでのレポート番号や、サーバーのエラーおよび警告メッセージなど）は表しません。

•	コントロール・コンテナ・スクリプトは、GetReportStateCodeStringまたはGetReportStateCodeメソッドを起動して、コード値の処理や状態コードの文字列へのマップができます。

•	レポート実行時に限り、レポート固有の状態を戻すことができます。イベント・サポートがないコンテナに対しては、レポートの状態について順番にポーリングできます。レポート・ハンドルは、レポートの実行完了後しばらくの間有効となり、機能停止ハンドルによる障害は発生しません。


実行するレポートを選択できるファイル・ダイアログ・ボックスを表示します。


実行するレポートの名前です。名前を入力するか、または参照ボタンをクリックして名前を選択してください。


レポート出力（画面、ファイル、プリンタ、プレビュー、メール、サーバー・キャッシュ、配布ファイル）を送信する宛先デバイスのタイプです。


レポート出力のファイル、プリンタ出力のプリンタまたは配布の宛先ファイルを選択できるファイル・ダイアログ・ボックスを表示します。


レポート出力を送信するファイル、プリンタ、メール・アドレスまたは宛先ファイルの名前です。名前を入力するか、または参照ボタンをクリックして名前を選択してください。


レポートを実行するReports Serverの名前です。有効なReports Server名を入力してください。


データベースのユーザー名です。データベースのユーザー名と、オプションのパスワードとデータベース名（userid/password@database形式）を入力してください。


指定されたデータベース・ユーザーのパスワードです。正しいパスワード（入力した文字は、アスタリスクで表示されます）を入力してください。


接続するデータベースの名前です。有効なデータベース名を入力してください。


レポートを実行するモードは、レポート定義によって決まります。


レポートを、ビットマップ・レポートで実行します。


レポートを、キャラクタ・モードで実行します。


レポートの印刷方向（横または縦）は、レポート定義によって決まります。


レポートの印刷方向（横または縦）は、現在選択されているプリンタ方向になります。


レポートの印刷方向を、縦にします。


レポートの印刷方向を、横にします。


レポートの大きさです。有効な幅と高さ（形式は幅x高さ）を入力するか、または値リストから選択してください。


希望するレポート出力の形式です。


作成するレポート出力のコピーの数です。ゼロ以上の整数を入力してください。


レポートを実行する前に、ランタイム・パラメータ・フォームを表示するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。ランタイム・パラメータ・フォームは、レポートを実行する前に、レポート・パラメータの値を変更できるダイアログです。


レポートのユーザー・パラメータに値を指定する文字列です。parameter1name=value parameter2name=value．．．形式で文字列を入力するか、値リストから文字列を選択してください。


コマンド・ラインを選択できるファイル・ダイアログ・ボックスを表示する参照ボタンです。


レポートのパラメータを指定するコマンド・ファイルの名前です。ファイル名を入力するか、または参照ボタンをクリックして名前を選択してください。


1つのレポートの複数の問合せに、読込み一貫性を持たせるかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。データのアクセス時に、SET TRANSACTION READ ONLY文によって読込み一貫性を持たせることができます。


データベースの変更（CREATEなど）を、データベースに自動的にコミットさせるかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。一部の非Oracleデータベース（SQL Serverなど）では、データベースの変更を自動的にコミットさせる必要があることに注意してください。


Report Builderで、データをデータベースから取り出している最中に、他のプログラムを実行できるかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


レポートの実行が終了したとき、COMMITまたはROLLBACKを実行するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


エラーが発生してレポートの終了に失敗した場合、COMMITまたはROLLBACKを実行するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


数値書式で、通貨文字に対して使用される文字列です。有効な通貨文字列を入力してください。


数値書式で使用される3桁区切り文字です。有効な3桁区切り文字を入力してください。


数値書式で使用される小数点文字です。有効な小数点文字を入力してください。


Oracle配列処理で使用するキロバイト単位の配列のサイズです。有効な数値を入力してください。通常、配列サイズが大きいほど、レポートの実行が速くなります。


キロバイト単位の仮想メモリー・キャッシュのサイズです。有効な数値を入力してください。


エラー・ファイルを選択できるファイル・ダイアログ・ボックスを表示する参照ボタンです。


レポートの実行中に発行されたすべてのエラー・メッセージを保存させるファイルの名前です。ファイル名を入力するか、または参照ボタンをクリックして名前を選択してください。


ログ・ファイルを選択できるファイル・ダイアログ・ボックスを表示する参照ボタンです。


レポートの実行についてのパフォーマンスの統計を保存するファイルの名前です。ファイル名を入力するか、または参照ボタンをクリックして名前を選択してください。


トレース・ログ・ファイルを選択できるファイル・ダイアログ・ボックスを表示する参照ボタンです。


トレース情報を記録するファイルの名前です。ファイル名を入力するか、または参照ボタンをクリックして名前を選択してください。


トレース情報はファイルの終わりに追加するか、またはファイル全体に上書きするかを指定します。リストから希望の動作を選択してください。


エラー・メッセージと警告をトレース・ファイルに記録するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


パフォーマンス統計をトレース・ファイルに記録するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


レポート・オブジェクトに関するすべての情報をトレース・ファイルに記録するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


PL/SQLオブジェクトに関するすべての情報をトレース・ファイルに記録するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


SQLに関するすべての情報をトレース・ファイルに記録するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


タイムスタンプをトレース・ファイルの各エントリに入力するかどうかを指定します。必要に応じて、チェックボックスを選択または選択解除してください。


レポートを直ちに実行します。


レポートの実行を開始する時刻と日付を指定します。


レポートを実行する時刻。時刻を入力するか、上/下ボタンを使用して時刻を選択してください。


レポートを実行する時刻。時刻を入力するか、上/下ボタンを使用して時刻を選択してください。


レポートを実行する日付。日付を入力するか、上/下ボタンを使用して日付を選択してください。


レポートを実行する日付。日付を入力するか、上/下ボタンを使用して日付を選択してください。


レポートが1回実行されます。


指定した間隔でレポートが実行されるようにスケジュールされます。


スケジューリングされたレポートが実行する間隔の単位数です（単位は時間で、2を指定すると、そのレポートは2時間おきに実行されます）。上/下矢印を使用して数値を選択してください。


スケジューリングされたレポートが実行する間隔の単位数です（単位は時間で、2を指定すると、そのレポートは2時間おきに実行されます）。上/下矢印を使用して数値を選択してください。


レポートを実行する間隔の定義に使用される単位です（時間など）。


毎月指定した曜日にジョブを実行します（毎月第1月曜日など）。


第何週目の指定した曜日にジョブを実行するかを定義します（第1週目など）。上/下矢印を使用して値を選択してください。


ジョブを実行する曜日です。上/下矢印を使用して曜日を選択してください。


毎月指定した日付以前の最後の曜日にジョブを実行します（毎月15日以前の最後の平日など）。


ジョブを実行する最後の曜日です（月曜日、平日など）。上/下矢印を使用して曜日を選択してください。


ジョブを実行する期限の日付です（15日など）。日付を入力するか、上/下矢印を使用して日付を選択してください。


ジョブを実行する期限の日付です（15日など）。日付を入力するか、上/下矢印を使用して日付を選択してください。


サーバーが、失敗したジョブを指定した間隔で再実行します。


失敗したジョブの再実行を試みる回数です。数字を入力するか、上/下矢印を使用して数字を選択してください。


失敗したジョブの再実行を試みる回数です。数字を入力するか、上/下矢印を使用して数字を選択してください。


サーバーがジョブの再実行を試みる間隔です（1時間など）。時間を入力するか、上/下矢印を使用して時間を選択してください。


サーバーがジョブの再実行を試みる間隔です（1時間など）。時間を入力するか、上/下矢印を使用して時間を選択してください。


サーバーがジョブの再実行を試みる間隔の単位です（時間など）。上/下矢印を使用して単位を選択してください。


レポートを実行するクライアントで、Reportsバックグラウンド・エンジンを使用します。


レポートを実行するReports Serverを同期的にコールするという意味です。レポートの実行が終了するまで、コールは戻されません。


レポートを実行するReports Serverを非同期にコールするという意味です。情報が必要なときのみ、クライアントはReports Serverに接続されます（レポートを実行する要求の送信、または進捗情報の取得など）。


Reports Serverがレポートの進捗情報にポーリングされる頻度です。上/下矢印ボタンを使用して、秒単位で頻度を選択してください。


Reports Serverがレポートの進捗情報にポーリングされる頻度です。上/下矢印ボタンを使用して、秒単位で頻度を選択してください。


タイムアウトする前に、サーバーからの応答を待つ時間の長さです。


キューのレポートに関係付けられた名前です。有効な文字列を入力してください。


ジョブが正常に実行されたときに通知メッセージが送られる電子メール・アドレスです。有効な電子メール・アドレスを入力してください。


ジョブの実行に失敗したときに通知メッセージが送られる電子メール・アドレスです。有効な電子メール・アドレスを入力してください。


制限されたReports Serverに対してユーザーを認証するためのWebDBユーザー名です。ユーザー名およびオプションのパスワード（userid/passwordの形式）を入力してください。


指定したWebDBユーザー名のパスワードです。正しいパスワード（入力した文字は、アスタリスクで表示されます）を入力してください。


Reports ActiveXコントロールについて

Reports ActiveXは業界標準のOLE ActiveX技術を使用してReports ServerとReportsバックグラウンド・エンジンを実現しているOLEカスタム・コントロールです。Reports ActiveXにより、レポートを任意のActiveXコンテナから実行できます。他のActiveXコントロールの場合と同様に、コンテナではコントロールのプロパティを取得または設定し、いつでもコントロールのメソッドを起動できます。Reports ActiveXは、Reports Serverの1クライアントにすぎないことに注意してください。

  Reports ActiveX アーキテクチャ

レポートを実行するためにRunReportが起動されるとき、そのコントロールは、次のことを実行しています。

1	プロパティのスナップショットを作成し、Reports ServerまたはReportsバックグラウンド・エンジンとの通信接続を開始します。

2	プロパティからコマンド・ラインを作成して、Reports ServerまたはReportsバックグラウンド・エンジンに送ることにより、レポートの実行を要求します。最小限のパラメータの妥当性チェックしか実行されないことに注意してください。

3	レポートの実行要求に何も問題がなければ、RunReportは成功して元に戻ります。

レポートの実行が始まると、ActiveXコントロールにより、レポート実行が追跡されます。レポートの実行がどのように追跡されるかは、レポートを実行するために選択された通信モードに依存します。すべての場合において、コントロールはBeforeRunReportおよびAfterRunReportコントロール・イベントを発生します。更新が正規の間隔で進行するように要求する場合（Call Frequencyを使用して）、RunReportProgressイベントもまた、要求された頻度で発生します。


Reports Serverについて

Reports Serverにより、レポートをリモート・マシンで実行できます。Reports Serverでは、クライアントからレポート実行の要求を受け取ります。これらの要求はキューに入れられ、Reports Serverのランタイム・プロセスの1つが使用可能になると、実行のために送り出されます。Reports Serverには、要求のステータスを問い合せることができます。スケジューリング・コマンドには、非対話形式のレポート要求が付随している場合があります。スケジューリング・コマンドでは、所定の時刻に、所定の頻度でレポートが実行されるように指定します。


システム仕様

Reports ActiveXコントロールは、マルチスレッド機能を利用するWin32アプリケーションです。他のActiveXコントロールの場合と同様にDLLです。他の複数のDLLを使用しますが、これらは正常に機能する上で必要です。Reports ActiveXでは、必要なDLLに静的リンクを使用します。つまり、Reports ActiveX DLLは、すべての必要なDLLがシステムで利用できない場合には正常にロードすることができません。

最良の結果を得るために、Oracle Installerを使用して、必要なコンポーネントをすべてインストールしてください。

Reports ActiveXで必要なDLL

•	Windows 95/NTシステム・ライブラリ

•	Microsoft MFC 4.1ライブラリのMFC40.DLLおよびMicrosoft C++ 4.1ランタイム・ライブラリのMSVCRT40.DLL

•	Oracle COREのCORE40.DLL

•	Oracle各国語サポート・ランタイムのNLSRTL33.DLL

•	Reports ServerユーティリティとCommunication、ZRC60.DLLおよびこのライブラリが依存するすべてのDLL

•	Oracle RPCのNL80.DLL、NS80.DLL、NT80.DLLおよび依存するすべてのライブラリ

Oracleコンポーネント・ライブラリを使用するには、HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ORACLE_HOMEレジストリ変数を、そのライブラリがあるBINディレクトリに設定する必要があります。

Oracle NLSライブラリを使用するには、次のレジストリ変数を設定し、NLSランタイム・ライブラリ・リソースをORA_NLS33とNLSRTL33で指定された場所にインストールする必要があります。

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ORA_NLS33

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\NLSRTL33

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\NLS_LANG

Oracle RPCリソースは、ORACLE_HOME\NETWORKにインストールする必要があります。すべてのReports Server名は、ORACLE_HOME\NETWORK\ADMIN\TNSNAMES.ORA構成ファイル内で指定する必要があります。

Reports ActiveXコントロールはNLS準拠です。USリソースは、コントロールにバインドされているほか、外部DLL（RWXUS60.DLL）としても提供されています。NLSが設定されていない場合、コントロールは内部にバインドされているUSリソースとOLEタイプのライブラリを使用します。

Reports ActiveXコントロールにより登録を行う場合、ORACLE_HOME\BINおよびREPORT60で外部リソースDLL（RWXxxx60.DLL、xxxはWindows 95/NT NLS地域の標準略称）が検索され、これらはローカライズされたOLEタイプのライブラリとして登録されます。


パフォーマンスのヒント

  関連項目

•	特にプレビューまたは画面の対話形式の出力が必要でない限り、Reports Serverを使用してください（対話形式の出力が必要な場合は、Reportsバックグラウンド･エンジンを使用する必要があります）。

•	一般的に、非同期通信モード（Call Modeプロパティを使用して設定します）が、最良の選択です。これを設定すると、別のレポートの実行が終了するまで複数のレポートが待機することはありません。ただし、このモード内の各プログレス・イベント（RunReportProgress）に、多少のネットワーク・トラフィックが発生することがあります。レポート進捗回数を適宜設定します（Call Frequencyプロパティを使用して）。

•	同期通信モードでは、次の場合に最も効果があります。

•	アプリケーションで一度に多数のレポートを実行する予定がないか、またはユーザー・インタフェースで同期実行モデルを実装している。

•	概算のレポート実行時間が短い（つまり、実行するレポートが比較的単純で、Reports Serverの負荷が大きくない）。

•	中間レポート実行進捗状況の精度が重要でないか、まったく使用されていない。

•	実行状態を追跡するために、GetReportStateCodeメソッドをポーリングするよりも、コントロール・イベントを使用します。

•	コントロール・イベント中は、時間のかかる処理を実行しないでください。


通信モードについて

ReportActiveXは、Reports Serverによって次の3つの通信モードをサポートしています（Call Modeプロパティを使用して設定します）。

非同期

同期

ローカル、つまりReports ActiveXコントロールは、ローカル・マシン上にインストールされたReportsバックグラウンド･エンジンのみを使用できます。


非同期通信

非同期通信モードでは、Reports ActiveXコントロールにより、必要（レポートの実行要求や進捗更新など）に応じてReports Serverがコールされます。コールはただちに、要求された情報とともに戻されます。非同期モード使用時には、次のことを考慮する必要があります。

•	Reports ActiveXコントロールにより、レポートの実行要求が成功するたびに通信スレッドが作成されます。このスレッドは、指定された頻度でReports Serverの進捗をポーリングします（Call Frequencyを使用して設定します）。そして適切なコントロール・イベントを生成します。コントロール・イベントから次のコントロール・イベントまでの間は、スレッドはスリープ状態になります。

•	Reports Serverに対するコールはRPCコールであり、ネットワーク・トラフィックとなります。レポート頻度が秒単位で測定され、それよりも小さな単位では測定されないのはこのためです。


同期通信

同期通信モードでは、Reports ActiveXコントロールにより、Reports Serverは1回しかコールされず、そのコールはレポートの実行が終了するまで戻されません。同期通信を使用する場合、次のことを考慮する必要があります。

•	非同期であるWindows GUIアプリケーションでは、通常、ユーザー・インタフェースの応答がなくなる（塗り直しや進捗のフィードバックがないなど）のは望ましくありません。基礎となる通信モードが同期であっても、ActiveXコントロールに関しては非同期の動作を保持することが常に重要です。状態を保持すること（ブール・フラグまたは列挙変数を使用するなど）によって、同期動作をエミュレートします。たとえば、現行レポートの実行要求が終了するまで、アプリケーションで「レポート実行」ボタンを使用不可にできます。

•	Reports Serverは1回しかコールされないため、クライアントには実際のレポート進行状況はわかりません。結果は、レポートの実行が完了するまで戻されません。実行進捗は、Reports ActiveXコントロールから要求されると、エミュレートする必要があります。

•	Reports Serverと一度に通信できるのは、そのプロセス1スレッドに限られます（通信コンテキストは、各プロセスで1つしか作成できないため）。ActiveXコントロールにより同期コールが行われる場合、他のすべての通信要求は、その同期コールが完了するまで（つまり、レポートの実行が終了するまで）待つ必要があります。レポートが終了するまでにかかる時間は、Reports Serverの状態によって異なるので保証できません。

•	同期モードでは、Reports ActiveXコントロールにより、レポートの実行要求ごとに2つのスレッド（コール側スレッドおよび監視側スレッド）が作成されます。コール側スレッドはReports Serverをコールし、レポートの実行が完了するまで戻されません。監視側スレッドではコール側スレッドの状態が確認され、要求があれば指定した頻度で進捗イベントが生成されます。これらの進捗イベントには、実際のレポート実行進捗は反映されません。生成される進捗は、一般的なもの（レポートを実行中など）で、詳細（レポート定義をオープン中や1ページをフォーマット中など）はありません。コントロール・イベントから次のコントロール・イベントまでの間は、監視側スレッドはスリープ状態になります。


ローカル通信

ローカル・モードでは、Reports ActiveXコントロールとReports Serverとの通信はまったく行われません。かわりにReportsバックグラウンド･エンジンを使用します。すべてはローカル・マシン上で行われるため、パフォーマンスはReports Serverとの通信よりも劣る可能性があります。ローカル・モード使用時には、次のことを考慮する必要があります。

レポート出力に対してインタラクティブな宛先（つまりPreview And Screen）が使用可能になります。

Reports Serverプロパティは、無視されます。

Reports ActiveXコントロールにより、ローカル・モードの場合、監視側スレッドが作成されます。このスレッドでは、Reportsバックグラウンド･エンジンのプロセス（rwrbe60.exe）をコールするアプリケーション（rwisv60.exe）が生成されます。レポートの実行は、rwisv60.exe が終了すると同時に完了したと見なされます。監視側スレッドでは、レポートの実行が完了するまで、指定した頻度で進捗イベントを生成します。


レポート実行状態

レポート実行状態は、BeforeRunReportおよびAfterRunReportのイベント間の任意の時に取得することができます。レポート実行状態は、RunReportProgressイベントを使用して、またはレポート実行状態を問い合せるコントロール・メソッドを起動（GetReportStateCodeなど）して取得できます。そのため、イベントを使用することをお薦めします。レポートの実行が終了すると（つまり、AfterReportRunが生成されると）、ActiveXコントロールではその情報が数秒間保持されますが、その後は破棄され、アクセス不能になります。


Reports Serverの制限

Reports Serverでは、指定されたすべてのファイル名、プリンタ名およびメール・アドレスが有効であることが必要です。OutputDestinationがファイルの場合、そのファイルを取得するためには、ローカル・ファイル・システムからアクセス可能な（たとえば、ネットワーク・ドライブ上の）ファイルであることが必要です。また、OutputDestinationをローカル・ファイルに設定できます。この場合、宛先名は有効なローカル・ファイル名であることが必要です。レポートの実行が正常に終了すると、Reports ActiveXコントロールにより、レポート出力が（従属ファイルとともに）指定されたローカル・ファイルに送られます。


必須プロパティ

  関連項目

ActiveXコントロールを使用してレポートを実行するには、少なくとも次のプロパティを指定する必要があります。

ReportName	実行するレポートの名前

DatabaseUser	データベース接続文字列

CallMode	通信モード

ReportsServer	Reports Serverの名前


Adobe Acrobat Readerなどの、PDFファイルを表示できるスタンドアロンまたはプラグインのソフトウェア。


UNICODE

rwsxu60.ocxは、Reports ActiveXコントロールのUNICODEビルドで、2バイト環境で実行されます。このビルドは、1バイト環境でも実行されますが、実際にこれを必要とする環境は2バイトであることに注意してください。

使用上の注意

•	Reports Queue Manager（rwqmu60.exe）のUNICODEビルドとReports ActiveXコントロールは、矛盾のないものを使用してください。たとえば、Reports ActiveXコントロールのUNICODEビルドを使用している場合は、Reports Queue ManagerのUNICODEビルドを使用する必要があります。あるいは、USER_NLS_LANG環境変数が指定されていることを確認する必要があります。デフォルトのUS構成を使用している場合は、このような制限はありません。

•	UNICODEビルドは、Windows NT 4.0では実行できますが、Windows 95では実行できません。


HTML 3.0準拠のブラウザ（Netscape 2.2以降など）。


Reports Server

Reports Serverにより、レポートをリモート・マシンで実行できます。Reports Serverでは、クライアントからレポート実行の要求を受け取ります。これらの要求はキューに入れられ、Reports Serverのランタイム・プロセスの1つが使用可能になると、実行のために送り出されます。Reports Serverには、要求のステータスを問い合せることができます。スケジューリング・コマンドには、非対話形式のレポート要求が付随している場合があります。スケジューリング・コマンドでは、所定の時刻に、所定の頻度でレポートが実行されるように指定します。


Reportsバックグラウンド・エンジン

Reportsバックグラウンド・エンジンは、レポート実行要求を処理するために、ローカル・マシン上で（つまり、ネットワーク接続不要）キューおよびReports Runtimeをメンテナンスする簡易サーバーです。Reportsバックグラウンド・エンジンを使用する場合、レポート出力用の対話形式の宛先（つまり、プレビューおよび画面）が使用可能になります。（以前のバージョンでは、Reportsバックグラウンド・エンジンは、Reports Serverと呼ばれていました。）


サーバー・ジョブ・ログ・ファイル

サーバー・ジョブ・ログには、デフォルトでサーバーおよびエンジンの開始時間や停止時間などの情報が記録されます。レポート・ジョブ実行の成功または失敗時にログを作成する場合は、LOGOPTIONパラメータをサーバーの構成ファイルに追加するようにシステム管理者に依頼してください。