Report.cfg のパラメーター

Report.cfgパラメーターについて取り上げます。

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

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

メモ

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

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

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

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

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

指標の指標について詳しくは、『Data Workbenchユーザーガイド』を参照してください。

レポートの再生成を許可

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

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

添付ファイル

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

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

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

コンテンツタイプ

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

例: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指標とTop N値パラメーターのいずれかに値を入力する必要があります。 このパラメーターで指定するディメンションは、レポートの作成対象となるデータセット内に存在する必要があります。
完全な場合のみ電子メール オプション. 実行中にエラーが発生しなかった場合にのみレポートセットを送信するようにユーザーが指定できます。 選択肢は true と false です。デフォルト値は false です。
終了日

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

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

例:08/01/2007 12:01 EDT

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

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

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

定義した値が、レポートをExcelにエクスポートできるだけの長さであることを確認します。 そうしないと、レポートサーバーがExcelを途中で終了し、レポートが生成されない場合があります。

フィルター式

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

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

ガンマ補正

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

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

ロゴを隠す レポートの生成時に、レポートサーバーでロゴを非表示にするかどうかを示します。 オプションは true または false です。 false に設定した場合、レポートはレポートのロゴを使用して生成されます。 初期設定は false です。
参照ファイル

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

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

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

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

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

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

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

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

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

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

多数の受信者に通知を送信する場合(20件を超える場合)は、Eメール配布リストを使用することを強くお勧めします。

ボディXSLテンプレート

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

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

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

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

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

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

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

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

レポートを生成する前に、上位N個のディメンション要素を決定するために実行する必要があるクエリに適用するフィルターの名前。 デフォルト値は Broken_Session_Filter です。 Broken Session Filter の詳細については、『Data Workbenchユーザーガイド』を参照してください。

レポートタイプ

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

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

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

開始日

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

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

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

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

例:

開始日が08/08/2006 12:00 ESTの場合、タイムスタンプが08/08/2006 12:00 EST以降のデータに対してレポートが実行されます。

  • 日別レポートは08/08/2006で実行され、その後はhh:mm = 12:00 ESTのデータに対して毎日実行されます。
  • 週別レポートは08/08/2006で、その後7日ごとにhh:mm = 12:00 ESTのデータで実行されます。
  • HH:mm = 12:00(東部標準時)のデータに関しては、月別レポートは08/08/2006、その後は毎月8日に実行されます。

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

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

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

注意: このパラメータに値を入力する場合は、[Dimension名]パラメータと[上位N値]パラメータに値を入力する必要があります。

上位N値

オプション. このパラメーターが設定されると、レポートサーバーは動的モードで実行され、Dimension名パラメーターで指定されたディメンションの要素の上位番号(このパラメーターで指定)のレポートを、Top N指標パラメーターで指定された指標でカウントして生成します。

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

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

ローカルサンプルのみを使用 オプション. レポートサーバーで、データセットのローカルサンプルのみを使用してレポートを生成するかどうかを示します。 このパラメーターを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 テンプレートを使用しない限り、すべてのレポートは添付ファイルとして電子メールで配信されます。

このページ