Report.cfgのパラメーター

Report.cfgパラメーターに関する情報です。

「レポートセ Report.cfg ットの設 定」に示すサンプルには 、デフォルトでファイルに含まれるパラメ Report.cfg ータのみが含まれます。 次の表に、使用可能なすべてのファイルパラメーターの説 Report.cfg 明を示します。

ファイルにパラメータを追加する必要がある場 Report.cfg 合は、テキストエディターを使用して追加する必要があります。 各パラメーターエントリの定義方法の例を含め、その手順については、既存のReport.cfgフ ァイルの編集を参照してください

メモ

次の表に示すパラメータは、アルファベット順に一覧表示されています。 Data Workbenchでファイルを開く Report.cfg と、ベクトルがアルファベット順に表示され、その後に個々のパラメーターがアルファベット順に表示されます。

パラメーター 説明
アラートしきい値

オプション. このパラメーターは、指標インジケーターを含むレポートにのみ適用されます。 警告レポートを送信する前にワークシートに表示する必要がある指標の数。

指標インジケーターのワークシートで1つの指標のみが監視されている場合は、しきい値を1に設定します。 シート内の指標が上向き/下向き矢印またはXに評価された場合、レポートが生成されます。レポート内で複数の指標が監視されている場合は、レポートが生成される前に上向き/下向き矢印またはXに評価する必要がある指標の数を選択できます。 例えば、2つの指標が監視されている場合:

  • しきい値を1に設定すると、シート内の指標のいずれかが上向き/下向き矢印またはXに評価された場合に、レポートが生成されます。
  • しきい値を2に設定した場合、両方の指標が上向き/下向き矢印またはXに評価されてから、レポートが生成されます。

For more information about metric indicators, see the Data Workbench User Guide.

レポートの再生成を許可

レポートを作成ま たは変 更する際に、Report Serverが特定のレポートを自動的に生成または再生成するかどうかを示します。 選択肢は true または false です。trueに設定した場合、レポートワークスペースを作成または変更すると、 Report Serverは最新の実 行時にそのレポートを再生成します。

注意: Report.cfgファイルを変 更すると、Report Serverは そのReport.cfgフ ァイルで制御されるすべてのレ ポートを再生成し ます。

添付ファイル

オプション. 電子メールで配信されるレポートで送信される添付ファイルの名前とコンテンツタイプを表すセクション識別子(添付ファイルの数を含む)。

新しい添付ファイルを追加するには:

  1. Data Workbenchで Report.cfgフ ァイルを開きます。
  2. Attachmentsを右クリックし、 新しい子を追 加/ Attachmentをク リック しま す。

コンテンツタイプ

添付するファイルのコンテンツタイプ。

例:image/jpeg

FileName

添付するファイルの場所と名前。

例: c:\myimage.jpg

Color Set .pngファイルに使用するカラースキームを 指定し ます。 0は黒の背景用、1は白の背景用、と2はグレースケール画像用です。
実行するコマンド オプション. レポートセットの生成後に実行されるバッチコマンドまたは実行可能ファイル。 コマンドシェルインタープリタの起動が必要な場合は、コマンドの前にcmd /cを付けます。
既定のExcelテンプレート

オプション. レポートをExcelファイルとして生成する際に使用する汎用Excelテ ンプレートファイル(.xlsま たは.xlsx )のファイル名です。 このパラメーターは、c:\templates\mytemplate.xlsなどの完全なファイルパスをサポート していま す。

このファイルは、特定のレポート用にテンプレートが定義されていない限り、すべてのExcelレポートで使用されます。 詳しくは、テ ンプレートファイルの使用を参照してくだ さい。

ディメンション名 オプション. レポートを動的に生成するディメンションの名前。 このパラメーターにディメンション名を入力する場合は、Lookup Fileパラメーター、またはTop N MetricパラメーターとTop N Valueパラメーターのいずれかに値を入力する必要があります。 このパラメーターで指定するディメンションは、レポートを作成するデータセットに存在する必要があります。
完全な場合のみ電子メールを送信 オプション. 実行中にエラーが発生しなかった場合にのみレポートセットを送信するようにユーザーが指定できます。 選択肢は true と false です。デフォルト値は false です。
終了日

オプション. レポートセットを実行する最後の日時。 今回は、データセットの基準日時に基づきます。

形式:MM/DD/YYYY hh:mmタイムゾーン。24時間構文を使用

例:08/01/2007 12:01 EDT

タイムゾーン設定の詳細については、『データセット設定ガイド』を参照してください。

レポートセットの生成の頻度:日、週または月。
Excelウォッチドッグタイムアウト(秒)

オプション. Excelファイルとしてレポートを生成する際に、Excelが応答しないとReport Serverが判断してプロセスを終了するま での、Microsoft Excelの応答をReport Serverが待機する 秒数です。 このパラメータを使用すると、 Excelが応答しな くなった場合にExcelを終了し、Excel以外のレポートの処理を続行できます。 デフォルトは300.0です。この機能を無効にするには、このパラメーターを0.0に設定します。

定義した値がExcelにエクスポートできる長さであることを確認します。 そうしないと、 Report Serverが早 期にExcelを終了し、レポートが生成されない場合があります。

フィルター式

オプション. レポートセット内のすべてのワークスペースに適用されるフィルター。

詳しくは、フィルター作成の構文 を参照してくださ い。

ガンマ補正

.pngファイル出力 のガンマ 設定。 デフォルトは 1.6 です。

注意: この値は変更しないことをお勧めします。

ロゴを隠す レポートを生成する際に、Report Serverでロゴを非表示にするかどうかを指定します。 The options are true or false . falseに設定した場 合、レ ポートはレポートのロゴと共に生成されます。 初期設定は false です。
参照ファイル

オプション. このパラメーターを入力すると、Report Serverは動的モードで実行され、Dimension Nameパラメーターで指定されたディメンションの各要素に関するレポートが生成されます。 このファイルには、2つのタブ区切り列(ヘッダー行なし)が含まれている必要があります。

  • 列1には、ディメンション要素のリストが含まれます。
  • 列2には、レポートの受信者の電子メールアドレスが含まれます。 列1の特定の要素に関するレポートが、列2の同じ行の電子メールアドレスに送信されます。 複数の電子メールアドレスを入力する場合は、コンマ(スペースなし)で区切ります。 レポートを電子メールで送信しない場合は、この列を空にすることができますが、存在している必要があります。

注意: このパラメーターに値を入力する場合は、Dimension Nameパラメーターに値を入力する必要があります。

通知のみ このレポ ートサ ーバー設定を使用すると、レポートの生成時に電子メールを送信するようにData Workbenchを設定できます。 この値をtrueに設定すると、レ ポー トは送信されず、登録ユーザーに対してレポートが生成されたことを知らせる電子メールが送信されます。
メールレポート

レポートを電子メールで配信するためのセクション識別子。 レポートを電子メールで配信するには、「電子メールレポート」エントリの次のパ ラメータを入力 します。 レポートセット内のすべてのレポートは、Recipientsパラメーターで指定された電子メールアドレス宛てに1つのメッセージで送信されます。

注意: レポートサーバーは、少なくとも1つのレポートが生成された場合にのみ電子メールを送信します。

レポートの電子メール送信を有効にするには、このエントリに対して少なくとも次のパラメーターを設定する必要があります。

  • SMTP Server
  • 受信者
  • 送信者のアドレス
  • 通知のみ

注意: レポートセットを再生成した後にレポートを電子メールで送信する方法については、既存のReport.cfgフ ァイルの編集を参照してくださ い。

「通知のみ」の値は、5.4xおよび5.5xリリースで使用できます。

多数の受信者に通知を送信する場合(20人以上)は、電子メールの配信リストを使用することを強くお勧めします。

ボディXSLテンプレート

オプション. reports.xmlファイルに適用するXSLテンプレートフ ァイルのパ ス。 このパラメーターを使用すると、Report Serverは、レポートを添付ファイルではなく、配信済みの電子メール内で送信できます。 結果のテキストは、電子メールメッセージの本文として使用されます。

サンプルファ イルについては、レポ ートのサンプルファイルを参照してください。

XSLT(Extensible Stylesheet Language)の詳細については、『The Extensible Stylesheet Language Family』を 参照してください

受信者 レポートの送信先の人の電子メールアドレス。
送信者のアドレス 送信者の電子メールアドレス。
送信者名 (オプション)送信者の名前。
SMTP Server SMTPサーバーコンピューターのアドレスと、認証に必要なパスワードとユーザー名。
件名 オプション. 送信する電子メールの件名行。
通知のみ バックグラウンドレポートの生成時に電子メールを送信するようにData Workbenchを設定できます。 この値をTrueに設定すると、レポートは送信されず、登録ユーザーをレポートの場所にリンクする電子メールが送信されます。
出力ルート

オプション. 生成されたレポートセットの出力場所。 デフォルトは、Report Serverのイ ンストールディレクトリ内の<profile name>\Reportsフォルダーです。

レポートをポー タルに 出力するようにReport Serverを設定するには、Output Rootをポータルに使用するWebサーバーのドキ ュメントルートに設定します。

プリロードクエリフィルタ

オプション. このパラメーターは、上位のディメンション 要素レポートタイ プにのみ適用されます。

レポートを生成する前に、上位N個のディメンション要素を決定するために実行する必要があるクエリーに適用するフィルターの名前。 デフォルトは Broken_Session_Filterです 。 For more information about the Broken Session Filter , see the Data Workbench User Guide.

レポートタイプ

出力を生成する形式。 次のオプションのいずれかまたはすべてを使用して、複数の形式でレポートセットを一度に出力できます。

  • Excelでは、ワークシートごとに1つのビジュアライゼーションを持つExcelワークブックが作成されます。 一般的に、電子メールの配信にはExcelファイルを使用します。 「Microsoft Excelファ イルとしてのレポートの生成」を参照してくださ い。 テンプレートファイルの使用に関する詳細は、「テンプレートファ イルの使用」を参照してくださ い。
  • pngを指定すると、Portable Network Graphicファイルが作成されます。 一般的に、Webブラウザー(ポータル) に表 示する.pngファイルを使用します。
  • サムネールは、ワークスペースのサ ムネール(.jpg ファイル)を作成します。 デフォルトのサイズは240 x 180です。 初期設定のサイズを変更するには、「サムネールX」と「サムネールY」の各パラメーターを編集します。

Data Workbenchで Report.cfgを編集する際に新しいレポートタイプを追加するには、「レポートタイプ」を右クリックし、「新しい子を追加」をクリックし て、 目的のレポートタイプ を選択します。

開始日

レポートセットを実行する最初の日時。 今回は、データセットの基準日時に基づきます。

形式:MM/DD/YYY hh:mmタイムゾーン。24時間構文を使用。

タイムゾーン設定の詳細については、『データセット設定ガイド』を参照してください。

注意: プロファイル内のデータのタイムスタンプが指定した日時と一致すると、レポートの実行が開始されます。

例:

開始日が2006年8月8日12:00 ESTの場合、レポートは米国東部標準時(EST)のタイムスタンプが08/08/2006年12:00以降のデータに対して実行されます。

  • 日別レポートは2006年8月8日に実行され、その後、hh:mm = 12:00 ESTのデータに対して毎日実行されます。
  • 週別レポートは、2006年8月8日と、その後7日ごとにhh:mm = 12:00 ESTのデータに対して実行されます。
  • 月別レポートは、hh:mm = 12:00 ESTのデータに対して、2006年8月8日とそれ以降の月の8日に対して実行されます。

レポ ート時 間指標は、「過去7日間」、「昨日」、「3週間前」など、「過去N」のレポートディメンションに影響します。レポートサーバーのクエリ ーの場合、レ ポート時間指標( Report Time.metric )は、レポートが実行される日時を識別します。 これは、Start Dateパラメーターで指定された日時で、Everyパラメーターで指定された期間だけ増分されます。 Data Workbenchのクエリーの場合、レポ ート時 間指標は基準日指標(基準日。指標 )の深夜0時に基づ いています。 レポート時間指標の定義が異なるので、Last Nディメンションを使用するワークスペースをクエリーする場合、同じワークスペースに対して、Data Workbenchと Report Serverで異なる結果を受け取るこ とができます。

サムネールX オプション. 出力として生成されるサムネールのX軸のサイズ(ピクセル単位)を制御する整数。
サムネールY オプション. 出力として生成されるサムネールのY軸のサイズ(ピクセル単位)を制御する整数。
上位N件の指標

オプション. 上位N個の値パラメーターの説明を参照してください。

注意: このパラメーターに値を入力する場合は、ディメンション名パラメーターと上位N個の値パラメーターに値を入力する必要があります。

上位N値

オプション. このパラメーターを入力すると、 Report Serverは動的モードで実行され、Dimension Nameパラメーターで指定されたディメンションのエレメントの上位の数(このパラメーターで指定)に関するレポートが生成されます。この数値は、Top N指標パラメーターで指定された指標でカウントされます。

例:ディメンション名パラメーターに「ページ」、「上位N件の指標」パラメーターに「セッション」、このパラメーターに「5」と入力した場合、生成されるレポートには、セッション数が最も多い上位5つのページが表示されます。

注意: このパラメーターに値を入力する場合は、Dimension NameパラメーターとTop N指標パラメーターに値を入力する必要があります。

ローカルサンプルのみを使用 オプション. データセットのローカルサ ンプルの みを使用してレポートをReport Serverで生成するかどうかを示します。 このパラメーターをtrueに設定すると、レポートセットのサンプル(Data Workbenchサーバーに読み込むことなく)を表示し、データを完全に処理するのに必要な時間をかけずに、出力の見え方を確認できます。 これはテスト関数として機能します。 選択肢は true または false です。デフォルトは false です。
ワークスペースパス

オプション. 特定のレポートセットのワークスペースのコレクションの場所。 これは、複数のレポートセットに対して Report.cfgファイルを使用して、複数の方法で生成および配布する必要があるワークスペースの1つのコピーを保 持する場合に役立ちます。 このパスのルートディレクトリは、任意のプロファイルフォルダーにすることができます。 パス文字列の先頭にはスラッシュ(\)を入力しないでください。

例:セットAとセットBの共通のワークスペースを Reports\Commonフォルダーに保存し、2つの異なるレポートセットに対して Report.cfg ファイルを定義し、それぞれ異なる生成と配信の設定を行うことができます。 両方の Report.cfgフ ァイルで、Workspace Pathパラメーターをprofile name \Reports\Commonに設定します。

XSL出力ファイル オプション. XSLテンプレートがレポートインデックスに適用され たときに作 成される出力ファイルのパス。
XSLテンプレート

オプション. レポートインデックスに適用するXSLテンプレートファイルのパス。 変換後の .xmlは、指 定した XSL出力ファイルに書き込まれます 。 サンプルファ イルについては、レポ ートのサンプルファイルを参照してください。

注意: レポートの生成時に .xslテン プレートを使用しない限り、すべてのレポートは添付ファイルとして電子メールで配信されます。

このページ