日日是Oracle APEX: 定期的にレポートをリフレッシュする

2023年10月5日木曜日

色々な人がデータベースを更新しているので、自動的に、定期的にレポートをリフレッシュするにはどのようにすれば良いか、との相談がありました。

以前に記事「対話グリッドの自動リフレッシュ」として、タイマーのプラグインを使った実装を紹介しています。今回はフォーム付き対話モード・レポートを対象とし、以前と違う実装を行なってみます。

以下のような動作を実装します。

サンプル・データセットのEMP/DEPTに含まれている表EMPをソースとした対話モード・レポートとフォームのページを含むアプリケーションを作成します。

これからの実装は、対話モード・レポートのページに実施します。

ページ・デザイナで、対話モード・レポートのページを開きます。

ページ・プロパティのJavaScriptのファンクションおよびグローバル変数の宣言として、以下を記述します。

	var intervalId;
	const TIMEOUT = 3000; // 3秒で繰り返し。
	const REGION = "emp"; // 対象とするリージョンはemp

	/*
	* 指定したリージョンの繰り返しリフレッシュを開始する。
	*/
	const startRepeatRefresh = (timeout, region) => {
	if (!intervalId) {
	// 繰り返しリフレッシュは開始されていない。
	intervalId = setInterval(() => {
	if (!document.querySelector(".ui-dialog")) {
	// ダイアログやドロワーが開いていないときだけリフレッシュする。
	apex.region(region).refresh();
	} else {
	console.log("ダイアログかドロワーが開いているのでリフレッシュしません。");
	}
	}, timeout);
	console.log(`リージョン${region}を${timeout}msごとにリフレッシュします。`);
	};
	};

	/*
	* リージョンの繰り返しリフレッシュを停止する。
	*/
	const stopRepeatRefresh = () => {
	if (intervalId) {
	clearInterval(intervalId);
	intervalId = null;
	console.log(`リージョンの繰り返しリフレッシュを停止しました。`);
	};
	};