日付パラメータを増分したり、宛先ファイル名を動的に定義することができます。
レポートのデータ・パラメータ・フィールドには式を入力できます。
スケジュールされたレポートに日付パラメータが含まれ、スケジュール日付の値を入力した場合は、日付値を変更できません。スケジュールしたレポート・インスタンスが実行されるたびに、同じ日付パラメータが使用されます。実行ごとに日付パラメータを変更する必要がある場合は、スケジューラの日付パラメータ・フィールドに式を入力して、レポート・ジョブが実行されるたびに日付が計算されるようにできます。
たとえば、毎週月曜日に前の週のデータを取得して実行するレポートのスケジュールを作成する場合は、レポートの日付パラメータを増分して、前の週の初日と最終日に更新する必要があります。
示された構文を使用して、次の関数のいずれかを入力し、レポートの実行がスケジュールされる日が適切に計算されるようにします。
{$SYSDATE()$} - 現在の日付(BI Publisherが実行されているサーバーのシステム日付)。
{$FIRST_DAY_OF_MONTH()$} - 当月の初日
{$LAST_DAY_OF_MONTH()$} - 当月の最終日
{$FIRST_DAY_OF_YEAR()$} - 当年の初日
{$LAST_DAY_OF_YEAR()$} - 当年の最終日
パラメータ値での日付関数のコールは、スケジューラによってレポート・ジョブが処理されるまで評価されません。
プラス記号(+)とマイナス記号(-)を使用して式を入力することによって、次のように日を増減させることもできます。
{$SYSDATE()+1$}
{$SYSDATE()-7$}
この例では、スケジュールが実行されるたびに前の週のデータが取得されるように、レポートの日付パラメータ・フィールドに、次のように入力します。
開始日: {$SYSDATE()-7$}
終了日: {$SYSDATE()-1$}
データ・モデルのデフォルトのパラメータ値として、日付関数を設定できます。この場合は、ユーザーがレポート・ビューアでレポートを表示するたびに、デフォルト値として指定された式に従って日付パラメータが計算されます。
出力先がWebフォルダまたはFTPのリモート・ファイル名を入力する場合は、日付式を入力してファイル名に自動的に付加できます。日付は、サーバーのタイム・ゾーンを使用して実行時に設定されます。
次の表に、日付式の説明を示します。
式 | 説明 |
---|---|
%y |
年を4桁で表示します: 例: 2011 |
%m |
月を2桁で表示します: 01-12 (01 = 1月) |
%d |
日を2桁で表示します: 01-31 |
%H |
24時間制に基づいて時間を2桁で表示します: 00-24 |
%M |
分を2桁で表示します: 00 - 59 |
%S |
秒を2桁で表示します: 00 - 59 |
%l |
ミリ秒を3桁で表示します: 000 - 999 |
次の例を使用して、日付が付加されたファイル名、および先頭に日付が付き、末尾に時刻が付加されたファイル名を作成します。
日付、月、年が付加された次のようなファイル名を作成するには:
myfile_01_11_2010.pdf
次を入力します。
myfile_%d_%m_%y.pdf
日付、月、年が先頭に付き、時間と分が末尾に付加された次のようなファイル名を作成するには:
01_01_2010_myfile_22_57.pdf
次を入力します。
%d_%m_%y_myfile_%H_%M.pdf
ファイル名に未定義の式が含まれている場合(my_file_%a%b%c.pdf
など)、そのファイルはmy_file_%a%b%c.pdfという名前で作成されます。