2.4 レポートのスケジューリング

次の項では、レポートをスケジュールするのに役立つ情報を提供します。

2.4.1 レポートのスケジューリングと実行

ジョブの実行日時と実行頻度を設定できます。

  1. ホームページで、レポートを表示をクリックするか、表示］>［リポジトリの順にクリックします。

  2. レポート名を右クリックして、スケジュールを選択します。

  3. Schedule Job (ジョブのスケジュール)をクリックして、スケジューラパネルを表示します。

  4. Job Name (ジョブ名)フィールドで、ジョブの名前を指定します。たとえば、「Weekly Report」と指定します。説明はオプションです。

  5. 次のスケジュール属性を設定します。

    • Start Job (ジョブの開始): 次のいずれかを選択します。

      • Immediately (即時): ジョブを終了したらすぐに開始します。

      • On (日付) (特定の日付): 将来ジョブを開始します。カレンダ アイコンをクリックし、今後の開始日時を選択します。ジョブの実行時間を設定するには、カレンダの下にある時間と分をクリックします。

    • タイムゾーン: スケジュールのタイムゾーンを指定します。デフォルトのタイムゾーンはサーバのタイムゾーンで、これはログイン時に入力したタイムゾーンです。タイムゾーンが異なる場合は、それに従ってこのフィールドを設定します。

    • Recurrence (繰り返し): 次の設定のいずれかを選択します。

      • なし: レポートを一度実行します。

      • Simple (単純): 時間、日、または週単位でジョブを繰り返します。

      • カレンダ: 週の特定の曜日または月の特定の日にジョブを繰り返します。

        Simple (単純)またはカレンダを選択すると、追加のフィールドが表示されます。詳細については、セクション 2.4.4, ［Simple (単純)］およびカレンダのオプションを参照してください。

  6. ［保存］をクリックします。

  7. (条件付き)スケジューリングしているレポートに入力コントロールがある場合は、入力を求められます。

    保存された値がある場合、Set the Parameter Values (パラメータ値の設定)パネルの最上部にあるドロップダウンリストに表示されます。Use saved values (保存された値の使用)ドロップダウンで、スケジューリングしているレポートに定義された入力コントロールを設定できます。スケジュールされたレポートの入力値を設定し、Save Current Values (現在の値を保存)をクリックして入力値を保存できます。

  8. 保存された値のセットを選択するか、入力コントロールを設定して、保存をクリックします。

  9. Output Settings (出力設定)パネルで出力オプションを設定します。

    詳細については、セクション 2.4.2, 出力オプションを参照してください。

  10. ［保存］をクリックします。

    ステップ 2に示すように、スケジュールされたジョブのリストにジョブが表示されます。

  11. Run Now (今すぐ実行)をクリックして、バックグラウンドでレポートを実行します。

2.4.2 出力オプション

Output Details (出力の詳細)パネルで、出力設定を変更できます。最初にジョブ、次に出力オプションを設定する必要があります。

詳細については、セクション 2.4.1, レポートのスケジューリングと実行を参照してください。

Output Details (出力の詳細)パネルでは、次の設定を変更できます。

  • Base Output File Name (ベース出力ファイル名): ジョブファイルの名前を指定します。

  • Output Description (出力の説明): (オプション)ジョブファイルの説明を指定します。

  • Output Format (出力フォーマット): ジョブファイルを保存するフォーマットを選択します。複数のフォーマットを選択した場合、各フォーマットは別のファイルとしてリポジトリに保存され、電子メール通知に別のファイルとして添付されます。

  • Output Locale (出力ロケール): レポートを生成するためのロケール設定を選択します。

    レポートはロケールをサポートする必要があります。たとえば、言語バンドルを含むドメインに基づくレポートの場合などです。

  • To (宛先): 電子メール通知の電子メールアドレスを指定します。

  • 件名: 電子メール通知の件名を指定します。

  • メッセージ: 電子メール通知のメッセージを指定します。

  • Attach Files (ファイルの添付): レポートの出力を電子メール通知とともに送信する場合、このオプションを選択します。

  • Skip Empty Reports (空のレポートをスキップ): レポートの実行が失敗したときに、サーバが電子メール通知に空のレポート出力ファイルを添付しないようにします。

  • Output Location (出力の場所): レポートを保存するフォルダを参照します。フォルダに対する書き込み許可が必要です。

  • Sequential File Names (順次ファイル名): ジョブによって作成されたファイル名にタイムスタンプを追加する場合、このオプションを選択します。これは、繰り返しジョブの出力や、出力に日付を付ける必要がある、時間が重要なレポートに役立ちます。タイムスタンプを使用する場合、ファイル名の出力は、<basename>-<timestamp>.<extension>になります。

  • Timestamp Pattern (タイムスタンプパターン): タイムスタンプのオプションのパターン。レポート出力ファイルの有効なパターンで使用できる文字は、文字、数字、ダッシュ、アンダースコア、およびピリオドのみです。デフォルトのパターンは、yyyyMMddHHmmです。たとえば、201307030601と入力します。

  • Overwrite Files (ファイルの上書き): 古い出力ファイルを新しいファイルで上書きする場合、このオプションを選択します。これは、順次ファイル名がない場合や、同一ファイル名になる可能性があるタイムスタンプパターンを指定する場合に役立ちます。

2.4.3 スケジュールされたジョブのリストの表示

スケジュールされたジョブは、リポジトリパネルに アイコン付きで表示されます。ユーザは自分が定義したジョブを表示できます。管理者はすべてのユーザが定義したジョブを表示できます。

  1. ホームページで、レポートを表示をクリックします。

  2. レポートを右クリックし、スケジュールを選択します。

    スケジュールされたジョブのリストが表示されます。

Scheduled Jobs (スケジュールされたジョブ)パネルに、ジョブのID、ジョブを作成した所有者、およびジョブの状態が表示されます。ジョブの状態は次のとおりです。

  • Normal (通常): ジョブはスケジュールされています。

  • Running (実行中): サーバがレポートを生成しています。

  • Complete (完了): サーバはジョブの実行を終了し、出力ファイルをリポジトリに配置しました。

  • エラー: ジョブをスケジュール中またはトリガ中にスケジューラでエラーが発生しました。ここには、ジョブは正常にトリガされたものの実行中にエラーが発生したケースは含まれません。

  • 不明: スケジューラにおいて、トリガされたジョブでエラーが発生しました。

Scheduled Jobs (スケジュールされたジョブ)パネルのオプションは、次のとおりです。

  • 編集: スケジュールされたジョブを編集して、変更を保存できます。

  • 削除: スケジュールされたジョブを削除できます。

    実行中のジョブを削除する要求をサーバが受信した場合、サーバはジョブを完了してから削除します。

Scheduled Jobs (スケジュールされたジョブ)パネルから次のタスクを実行できます。

  • 戻るをクリックして、レポートのリストに戻る。

  • Schedule Job (ジョブのスケジュール)をクリックして、新しいジョブを定義する。

  • Run Now (今すぐ実行)をクリックして、サーバの操作を継続したままバックグラウンドでレポートを実行する。

  • 一覧を更新をクリックして、最新のジョブを表示する。

2.4.4 ［Simple (単純)］およびカレンダのオプション

定期的かつ自動的にレポートを実行するには、［Set Up the Job (ジョブのセットアップ)］ページで単純な繰り返しまたはカレンダの繰り返しを選択します。

  • Simple (単純)の繰り返しは、時間、日、または週単位でジョブを定期的に実行します。単純な繰り返しを使用している場合、サーバを再起動するとレポートの実行時間が変わる可能性があります。

  • カレンダの繰り返しには、より多くの設定があり、特定の時刻、曜日、月の日、および年の月を設定できます。カレンダの繰り返しを使用している場合、サーバを再起動してもレポートは同じ時刻に実行されます。

単純な繰り返しオプションは次のとおりです。

  • Repeat every (繰り返し間隔): ジョブの間隔を分、時間、日、または週単位で設定します。

  • Run Indefinitely (無期限に実行): 削除するまでジョブを実行します。

  • Run a set number of times (設定した回数実行): 指定した回数、ジョブを実行します。

  • Run until a specified date (特定の日付まで実行): 特定の日付に達するまでジョブを実行します。 をクリックして、日付を選択します。

  • Holidays (休日): 休日カレンダで、スケジュールされたレポートを実行しない日のリストを指定します。一度に選択できる休日カレンダは1つだけです。

カレンダの繰り返しオプションは次のとおりです。

  • Months (月): レポートが実行される月。

  • 日: レポートが実行される日。

    • 毎日

    • 曜日

    • Month Days (月の日): 日付または日付範囲をカンマで区切って入力します。たとえば、「1, 15」と入力します。

  • Times (時刻): ジョブが実行される時刻(時と分)。時間は24時間形式を使用します。

    複数の時刻(時または分)および範囲をカンマで区切って入力することもできます。たとえば、分に「0, 15, 30, 45」を指定し、時に「9-17」を指定した場合、レポートは、午前9時から午後5時45分まで15分間隔で実行されます。毎時または毎分ジョブを実行するには、アスタリスク(*)を入力します。

  • Recur Until (繰り返しの終了): カレンダの繰り返しは、指定された日付に達するまで実行されます。 をクリックして、日付を選択します。

  • Holidays (休日): 休日カレンダで、スケジュールされたレポートを実行しない日のリストを指定します。一度に選択できる休日カレンダは1つだけです。

2.4.5 バックグラウンドでのジョブの実行

ジョブをバックグラウンドで実行すると、場合によってはサーバのパフォーマンスに影響を及ぼすことなくレポートが生成されます。ジョブが終了したら、レポートを任意の形式に直接エクスポートしてリポジトリに保存できます。生成されたレポートを電子メールで送信することで、レポートを他のユーザと共有できます。

ジョブをバックグラウンドで実行することは、ジョブを即時実行するようスケジューリングすることと同じです。

  1. ホームページで、レポートを表示をクリックします。

  2. レポートを右クリックして、Run in Background (バックグラウンドで実行)を選択します。

    実行中のレポートに入力コントロールまたはフィルタがある場合は、入力を求めるプロンプトが表示されます。

  3. 保存された値のセットを選択するか、一度に1つずつフィールドを設定し、［次へ］をクリックします。

  4. Setting Output Options (出力オプションの設定)パネルで、詳細を指定して送信をクリックします。出力オプションについては、セクション 2.4.2, 出力オプションを参照してください。

  5. 保存をクリックします。

    レポートは直ちに実行されます。