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 ファイルによって制御されるすべてのレポートを再生成します。

添付ファイル

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

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

  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 レポートで使用されます。 テンプレートファイルの使用 を参照してください。

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

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

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

例:08/01/2007 12:01 EDT

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

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

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

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

フィルター式

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

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

ガンマ補正

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

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

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

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

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

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

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

電子メールでレポートを配信するためのセクション識別子。 電子メールでレポートを配布するには、 メールレポート エントリの次のパラメーターを設定します。 レポートセット内のすべてのレポートは、「受信者」パラメーターで指定された電子メールアドレス宛に、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 のデータで実行されます。
  • 月別レポートは08/08/2006で、その後は毎月 8 日に hh:mm = 12:00 EST のデータで実行されます。

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

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

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

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

上位 N 値

オプション. このパラメーターが入力されると、 レポートサーバー は動的モードで実行され、「Dimension名」パラメーターで指定したディメンションの要素の上位の数(このパラメーターで指定)のレポートを生成します。

例:Dimension名パラメーターに「Page」、「Top N Metric」パラメーターに「Sessions」、このパラメーターに「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 テンプレートを使用しない限り、すべてのレポートは添付ファイルとして電子メールで配信されます。

このページ