エクスポートをスケジュールする

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • エクスポートをスケジュールして、エクスポートセットからリモートの宛先に定期的にデータをプッシュすることができます。繰り返しスケジュール済みエクスポートを設定することで、レポートやデータのスナップショットを保存するために、データを外部の場所に定期的にプッシュできます。

    始める前に

    必要なロール：export_set_scheduler または export_set_admin

    このタスクについて

    デルタエクスポートを使用して、新規または変更されたレコードのみをエクスポートするようにスケジュール済みエクスポートセットを構成できます。

    手順

    1. 次のように移動する。 All (すべて) > システムエクスポートセット > アドミニストレーション > スケジュール済みエクスポート.
    2. [New] をクリックします。
    3. 次のフィールドに入力します。
      表 : 1. [データエクスポートのスケジュール (Schedule Data Export)] フィールド
      フィールド 説明
      名前 このスケジュール済みエクスポートのわかりやすい名前を入力します。
      エクスポートセット スケジュールするエクスポートセットを選択します。
      実行方法 スケジュール済みエクスポートを実行するユーザーを選択します。エクスポートするデータを表示するために必要なロールがユーザーにあることを確認します。
      実行 スケジュール済みエクスポートの頻度を選択します。
      日 このスケジュール済みエクスポートを実行する曜日または月を選択します。このフィールドは、[実行] フィールドが [毎週] または [毎月] に設定されている場合に表示されます
      繰り返し間隔 このスケジュール済みエクスポートを繰り返すまでの日数と時間数を入力します。このフィールドは、[実行] フィールドが [定期的] に設定されている場合に表示されます。
      時刻 スケジュール済みエクスポートを実行する時刻を入力します。
      デルタエクスポート
      デルタエクスポートを有効化 このスケジュール済みエクスポートのデルタ機能を有効にするには、このチェックボックスをオンにします。選択すると、新規または変更されたレコードのみがエクスポートされます。
      当該時点またはその後のデルタ 新しいレコードを含む、前回のエクスポート以降に変更されたすべてのレコードをエクスポートするには、[更新] を選択します。前回のエクスポート以降に作成された新しいレコードのみをエクスポートするには、[作成済み] を選択します。
      注:
      エクスポート定義の [sys_updated_on] または [sys_created_on] フィールドに既にフィルター条件が含まれている場合、デルタエクスポートを有効にすると、スケジュール済みデータエクスポートレコードを保存できなくなります。このイベントでは、フォームの上部にエラーが表示されます。
      前回のスケジュール設定済みエクスポート実行 エクスポート定義からすべてのレコードをエクスポートするには、このフィールドを空白のままにします。デルタエクスポートを使用すると、スケジュール済みエクスポートが実行されるたびにこのフィールドが自動的に設定されます。この日時以降に更新または作成されたレコードは、[当該時点またはその後のデルタ] の値に応じてエクスポートデルタに含まれます。
      スクリプト
      条件付き 条件が満たされた場合にのみスケジュールを実行するには、このチェックボックスをオンにします。
      条件 エクスポートを実行するかどうかを評価するために使用するスクリプトを記述します。このフィールドは、[条件付き] チェックボックスをオンにすると表示されます。
      エクスポート前処理スクリプトの実行 エクスポートを開始する前にスクリプトを実行するには、このチェックボックスをオンにします。
      前処理スクリプト データをエクスポートする前に実行するスクリプトを記述します。このフィールドは、[エクスポート前処理スクリプトの実行] チェックボックスをオンにした場合に表示されます。
      エクスポート後処理スクリプトの実行 エクスポートの終了後にスクリプトを実行するには、このチェックボックスをオンにします。
      後処理スクリプト エクスポートの終了後に実行するスクリプトを記述します。このフィールドは、[エクスポート後処理スクリプトの実行] チェックボックスをオンにした場合に表示されます。
    4. [送信] をクリックします。

    次のタスク

    [今すぐ実行] ボタンをクリックしてエクスポートをすぐに実行し、データが想定どおりにエクスポートされることを確認できます。

    スケジュール済みエクスポートセットのデルタエクスポート

    デルタエクスポートには、最後のスケジュール済みエクスポート以降に変更されたレコードのみが含まれます。

    デルタエクスポートは、タスクテーブルや問題テーブルなどの通常のテーブルに対してのみ使用できます。
    重要:
    物理テーブルを結合する仮想テーブルであるデータベースビューテーブルには、デルタエクスポートを使用できません。

    データベースビューには、sys_created on、sys_created by、sys_updated on などのシステムフィールドは含まれません。システムの日付フィールドはデータベースビューに含まれていないため、テーブルが最後に更新された日時を知る方法がないため、データベースビューでデルタエクスポートを使用することはできません。

    スケジュール済みエクスポートセットのスクリプティングオプション

    エクスポートセットをスケジュール設定すると、特定の JavaScript オブジェクトにアクセスできます。

    これらのオブジェクトは、[前処理スクリプト (Pre-script)] や [後処理スクリプト (Post-script)] フィールドなどのスケジュール済みエクスポート設定スクリプトで使用します。
    cancel
    エクスポートアクションを停止するには、このオブジェクトを [true] に設定します。親がキャンセルされると、子エクスポートセットもキャンセルされます。このオブジェクトは、[前処理スクリプト (Pre-script)] フィールドでのみ使用できます。
    例：[前処理スクリプト (Pre-script)] フィールドを使用してエクスポートの条件を評価し、エクスポートプロセスをキャンセルするかどうかを決定します。エクスポートプロセスをキャンセルするには、次の呼び出しを使用します。
    cancel = true;
    export_set
    新しいエクスポートセットの GlideRecord オブジェクトを取得します。この変数を使用すると、sys_export_set テーブルから次の列をクエリできます。
    • name
    • sys_id
    • state
    • table_name

    このオブジェクトは、[前処理スクリプト (Pre-script)] と [後処理スクリプト (Post-script)] フィールドの両方で使用できます。

    例：エクスポートセットの情報を使用する場合は、export_set 変数のプロパティの 1 つを指定できます。

    var x = export_set.sys_id;