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. 添付ファイル」を右クリックし、「 追加 new child 」/「添付ファイル 」をクリックします。

コンテンツタイプ

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

例: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ウォッチドッグタイムアウト(秒)

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

定義した値がExcelにエクスポートできる長さであることを確認します。 それ以外の場合は、レポートサーバーがExcelを途中で終了し、レポートは生成されません。

フィルターの数式

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

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

ガンマ補正

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

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

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

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

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

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

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

電子メールでレポートを配信するためのセクション識別子。 電子メールでレポートを配信するには、メールレポートエントリの次のパラメーターを設定します。 レポートセット内のすべてのレポートは、受信者パラメーターで指定された電子メールアドレスに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に設定すると、レポートは送信されず、登録ユーザーをレポートの場所にリンクする電子メールが送信されます。
Output Root

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

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

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

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

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

レポートタイプ

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

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

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

開始日

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

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

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

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

例:

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

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

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

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

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

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

上位N値

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

例:Dimension名パラメーターに「ページ」、「上位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パラメーターをプロファイル名\Reports\Commonに設定します。

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

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

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

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now