2024年6月20日木曜日

Oracle APEXのデータ・ディクショナリ・キャッシュを更新する方法をPerplexity.aiに聞いてみる

Oracle APEX 24.1に追加されたAI関連の新機能であるAPEXアシスタントは、 SQLを生成するにあたってデータベースのディクショナリを直接参照するのではなく、Oracle APEXのデータ・ディクショナリ・キャッシュを参照します。データ・ディクショナリ・キャッシュは毎日実行されるメンテナンス・タスクによって更新されますが、直近での表の作成や列の追加、削除をデータ・ディクショナリ・キャッシュに反映させるには、手動でリフレッシュする必要があります。

以下、データ・ディクショナリ・キャッシュを更新する方法を確認します。

まず、手順をPerplexity.ai(Pro - LLMはGPT-4 Omni)に聞いてみました。

「Oracle APEXのデータ・ディクショナリ・キャッシュをリフレッシュする方法を教えてください。」

それらしい回答が得られます。回答の元になったソースを確認します。


ソースをoracle.comに掲載されているドキュメントに限定します。


回答が更新されますが、端的に言うと回答通りの手順では作業できません。


英語で質問してみます。

「how to update the dictionary cache used by Oracle APEX?」


先ほどと同様に、ソースをoracle.comに掲載されている資料に限定します。以下、得られた回答です。

To update the Data Dictionary Cache used by Oracle APEX, you can follow these steps:

From Administration Services

  1. Sign in to Oracle APEX Administration Services.
  2. Click on "Manage Workspaces".
  3. Under "Workspace Reports", click "Data Dictionary Cache". This will open the Data Dictionary Cache page, listing the workspace, cached objects, schema count, last data definition, last dictionary cache, and workspace ID.
  4. To view the cache for a workspace, click the workspace name. The Workspace Cache report will appear.
  5. To refresh the cache manually, click either "Gather Statistics and Refresh Cache" or "Refresh Cache Only" [1].

From Workspace Administration

  1. Sign in to Oracle APEX.
  2. Navigate to the Workspace Administration page by clicking the Administration menu at the top of the Workspace home page and selecting "Administration".
  3. On the Workspace Administration home page, click "Manage Service".
  4. Under "Manage Meta Data" on the right side of the page, click "Data Dictionary Cache". The Data Dictionary Cache report will appear.
  5. To refresh the cache manually, click either "Gather Statistics and Refresh Cache" or "Refresh Cache Only" [2][4].

Additional Information

  • The Data Dictionary Cache is automatically refreshed by the Oracle APEX nightly job ORACLE_APEX_DICTIONARY_CACHE if the tables change due to DDL or DML modifications. However, if the cache is incorrect or out of date, you can manually update it using the steps mentioned above [1][2][4][5].
  • The Data Dictionary Cache report displays statistics and data analysis of schema tables and caches in a workspace. Both the Create Application Wizard and Create Page Wizard use this information when creating new applications and pages [5][6][8].

By following these steps, you can ensure that the Data Dictionary Cache is up-to-date, which is crucial for the proper functioning of the Create Application Wizard and Create Page Wizard in Oracle APEX.

Citations: [1] https://docs.oracle.com/en/database/oracle/apex/23.1/aeadm/accessing-data-dictionary-cache-from-administration-services.html [2] https://docs.oracle.com/en/database/oracle/apex/22.1/aeadm/accessing-data-dictionary-cache-from-workspace-administration.html [3] https://docs.oracle.com/en/database/oracle/apex/23.2/aeadm/managing-page-and-region-caching.html [4] https://docs.oracle.com/en/database/oracle/apex/23.2/aeadm/accessing-data-dictionary-cache-from-workspace-administration.html [5] https://docs.oracle.com/en/database/oracle/apex/23.1/htmdb/about-creating-smar-filters-pages.html [6] https://docs.oracle.com/en/database/oracle/apex/24.1/htmdb/about-creating-smart-filters-pages.html [7] https://docs.oracle.com/cd/F93580_01/aeadm/accessing-data-dictionary-cache-from-workspace-administration.html [8] https://docs.oracle.com/en/database/oracle/apex/22.2/htmdb/about-creating-facet-search-reports.html [9] https://docs.oracle.com/en/database/oracle/application-express/20.1/aeadm/managing-page-and-region-caching.html [10] https://docs.oracle.com/cd/F86785_01/aeadm/accessing-data-dictionary-cache-from-administration-services.html [11] https://docs.oracle.com/en/database/oracle/apex/23.2/aeadm/dbms_scheduler-jobs.html

Always FreeのAutonomous Databaseを使って、上記の手順を確認してみます。

管理サービスでの作業


管理サービスにサインインします。


ワークスペースの管理をクリックします。


ワークスペース・レポートに含まれるデータ・ディクショナリ・キャッシュをクリックします。


データ・ディクショナリ・キャッシュのレポート・ページが開きます。レポートにはワークスペース名、キャッシュされたオブジェクト、スキーマ数、最終データ定義、最終ディクショナリ・キャッシュ、ワークスペースIDが一覧されます。

ワークスペース毎のキャッシュを表示するには、ワークスペース名をクリックします。


ワークスペース・キャッシュのレポートが表示されます。

キャッシュを手動でリフレッシュするには、統計の収集とキャッシュのリフレッシュ、または、キャッシュのリフレッシュのみをクリックします。


ワークスペース管理での作業


Oracle APEXのワークスペースにサインインします。

管理メニューの管理を選択し、ワークスペースの管理ページを開きます。


サービスの管理をクリックします。


画面右端にあるメタデータの管理のデータ・ディクショナリ・キャッシュをクリックします。


データ・ディクショナリ・キャッシュのレポートが開きます。

キャッシュを手動でリフレッシュするには、統計の収集とキャッシュのリフレッシュ、または、キャッシュのリフレッシュのみをクリックします。


手順の確認は以上です。

Perplexity.aiに英語で聞いたときは、正しい手順、それも管理サービスとワークスーペース管理から実施する2通りの手順が提示されました。日本語で聞いたときは、双方の手順が混ざったような手順が提示されました。

日本語の質問でも、マニュアルの適切な箇所をソースとしていることは確認できます。回答の生成には(Perplexity.aiのProなので)GPT-4 Omniを使用しているので、現状でこれ以上の性能は求めるのは難しい気がします。


日本語での質問は残念な感じでしたが、公式なドキュメントの該当箇所を探すのは手間がかかるので、AIの支援は有効であると感じます。

完

2024年6月19日水曜日

動的アクションでサーバー側のコードの実行結果を条件としてJavaScriptを実行する

動的アクションでサーバー側のコードを実行した後に、その結果を条件としてクライアント側の処理(実際にはブラウザ上でのJavaScriptの実行)を切り替えるための設定を紹介します。

以下のGIF動画のような実装を行います。Countの値はデータベース側でセッション・ステートとして保持します。この値が0より大きいときはボタンINCをホットにして、ボタンDECは通常の状態にします。逆に0以下であるときはボタンDECをホットにして、ボタンINCは通常の状態にします。


以下に実装を紹介します。

空のAPEXアプリケーションを作成し、デフォルトで作成されるホーム・ページにすべてを実装します。

ボタンとアイテムを配置するリージョンを作成します。

このリージョンの識別のタイトルはItem、タイプは静的リージョンとします。リージョンの両端にボタン、中央にページ・アイテムを配置するために、外観のテンプレートとしてItem Containerを選択します。


ボタンをクリックした数を保持するページ・アイテムとしてP1_COUNTを作成します。

タイプは数値フィールド、ラベルはCountとします。リージョンItemに配置するため、レイアウトのリージョンにItem、位置にItemを選択します。デフォルトのタイプとして静的を選択し、静的値として1を指定します。

セッション・ステートのストレージとしてセッションごと(永続)を選択し、このページ・アイテムの値がサーバー側(つまりデータベース)で保存されるようにします。


ページ・アイテムP1_COUNTの値を1増やすボタンINCを作成します。

レイアウトのリージョンはItem、位置はButton Startを選びます。動作のアクションは動的アクションで定義します。


同様に、ページ・アイテムP1_COUNTの値を1減らすボタンDECを作成します。

レイアウトのリージョンはItem、位置はButton Endを選びます。動作のアクションは動的アクションで定義します。


以上で準備ができました。

これから本記事の本題である動的アクションを作成します。

ボタンINCに動的アクションを作成します。

識別の名前はonClick INCとします。タイミングはデフォルトでタイミングがクリック、選択タイプはボタン、ボタンとしてINCが設定されます。


ボタンINCをクリックしたときに、最初にサーバー側のコードを実行します。

識別のアクションとしてサーバー側のコードを実行を選択します。PL/SQLコードとして以下を記述します。

:P1_COUNT := :P1_COUNT + 1;

このコードはデータベース側で実行されますが、現在開いているページ上のページ・アイテムP1_COUNTの値とサーバー側でセッション・ステートとして保持しているP1_COUNTの値が一致しているとは限りません。

ページ・アイテムP1_COUNTの値はブラウザ上で手入力できます。そのような方法でブラウザ上で変更された値は、サーバー側の処理を行う前にサーバー側に送信する必要があります。そのために、送信するアイテムとしてP1_COUNTを指定します。送信するアイテムは複数指定することができます。

サーバー側のコードを実行した結果として、セッション・ステートのP1_COUNTに1が追加されますが、この値はサーバー側(つまりデータベース)で更新されただけで、そのままではブラウザ上のP1_COUNTの値(表示されている値)に反映されません。ブラウザ上の値も更新されるように、戻すアイテムとしてP1_COUNTを指定します。

実行の結果を待機をオンにしています。このサーバー側のコードの実行の後にブラウザ側の処理を行いますが、実行の結果を待機をオンにすることにより、このサーバー側のコードが実行された後(つまりサーバー側の実行結果であるP1_COUNTの値がブラウザに反映された後)に、ブラウザ側の処理が行われることを保証します。


ページ・アイテムP1_COUNTの値が0より大きいときに、ボタンINCをホットにするTRUEアクションを作成します。

識別の名前はINC: HOT if Count > 0とします。アクションとしてクラスの追加を選択します。宣言的に定義していますが、実際の処理は影響を受ける要素として指定した要素のclassList.addを呼び出して、設定のクラス(ここではu-hot)を追加するJavaScriptのコードが実行されます。

設定のクラスにu-hotを指定します。このCSSクラスu-hotはOracle APEXのUniversal ThemeのColor and Status Modifiersとして定義されています。

直接色を指定するのではなく、Universal Themeに定義されたクラスを使って色を指定することにより、アプリケーションを通した色使いの一貫性が保たれます。テーマ・ローラーを使ったり、CSS変数を変更することにより、u-hotとして定義されている色を変更することができます。

実行の初期化時に実行をオンにすることにより、ページを開いた時のP1_COUNTの値を元にボタンの色付けを行います。動的アクションは設定したタイミングで実行されますが、初期化時に実行をオンにすることにより、ページを開いた時の初期状態としてボタンの色を決めることができます。

クライアントの条件のタイプとしてアイテム > 値、アイテムとしてP1_COUNT、値は0を設定します。クライアント側の条件は、ブラウザ側で判断されます。そのため、アイテムとして指定されたP1_COUNTの値は、ブラウザ上で保持している値を参照します。

このクライアント側の条件とサーバー側の条件は名前は似ていますが、評価されるタイミングは全く異なります。サーバー側の条件はページが描画される際に(ページ生成を実行している)データベースで評価されます。サーバー側の条件としてtrueになった場合は、その動的アクションが生成されたページに(HTMLやJavaScriptとして)含まれます。逆にfalseの場合は、その動的アクションそのものがページに含まれません。


この他に作成する処理は、上記と同じ考え方に基づいて作成します。

ページ・アイテムP1_COUNTの値が0より大きいときに、ボタンDECを標準にするTRUEアクションを作成します。

識別の名前はDEC: CLEAR if Count > 0とします。アクションとしてクラスの削除を選択します。

設定のクラスはu-hot、影響を受ける要素の選択タイプはボタン、ボタンはDECです。この他は同じ設定になります。


ボタンDECに動的アクションを作成します。名前はonClick DECとします。タイミングはボタンのデフォルトです。


ボタンDECをクリックしたときに実行するサーバー側のコード以下になります。それ以外はボタンINCと同じです。

:P1_COUNT := :P1_COUNT - 1;


P1_COUNTの値が0以下になったときに、ボタンDECをホットにするTRUEアクションを作成します。

識別の名前はDEC: HOT if Count <= 0とします。

クライアント側の条件のタイプとしてアイテム <= 値を選択します。


P1_COUNTの値が0以下になったときに、ボタンINCを標準にするTRUEアクションを作成します。


今回の記事は以上です。

作成したAPEXアプリケーションのエクスポートを以下に置きました。https://github.com/ujnak/apexapps/blob/master/exports/exec-javascript-based-on-server-side-result.zip

Oracle APEXのアプリケーション作成の参考になれば幸いです。

完

2024年6月11日火曜日

MLEで動作するJavaScriptへ渡す文字列がVARCHAR2とCLOBで扱いが異なる

Oracle Database 23aiのMLEを使って、JavaScriptの整形を行うサンプル・アプリケーションを作ってみました。整形には、こちらの記事「NPMパッケージからOracle Datase 23aiのMLEモジュールを作成する」でMLEモジュールとして作成したpretty-jsを使っています。

以下のように動作します。


APEXアプリケーションのエクスポートを以下に置いています。
https://github.com/ujnak/apexapps/blob/master/exports/mle-javascript-pretty-print.zip

アプリケーションでは、ボタンMAKE_PRETTYのクリックで、ページ・アイテムP1_SOURCEに入力した文字列をMLEモジュールのprettyJsを呼び出して整形し、結果をページ・アイテムP1_PRETTYに設定しています。

セッション・ステートのデータ型にCLOBを指定しています。


ボタンMAKE_PRETTYをクリックしたときに実行するJavaScriptコードです。
const { default:prettyJs } = await import("/npm/pretty-js@0.2.2/+esm");
const source = apex.env.P1_SOURCE;
// console.log(source instanceof OracleClob);
apex.env.P1_PRETTY = prettyJs(source);
すでにMLEモジュールができていることもありますが、特に文字列を扱う処理は、JavaScriptの方がPL/SQLよりも容易に実装できるように思います。


JavaScriptを整形するアプリケーションは簡単にできあがりました。

これから本題ですが、JavaScriptのファンクションprettyJsは引数として文字列を受け取り、戻り値として文字列を返します。

APEXのプロセスとしてJavaScriptコードを実行する場合は、DBMS_MLE.EVALの呼び出しに必要なMLEコンテキストの準備、DB接続およびページ・アイテムへの値の受け渡しなどはAPEXが行います。

APEXのプロセスとして記述したJavaScriptコードをSQLコマンドで実行するためには、以下のようなコードを記述します。
declare
    l_ctx dbms_mle.context_handle_t;
    C_CODE constant clob := q'~
(async() => {
    const bindings = await import("mle-js-bindings");
    const { default:prettyJs } = await import("/npm/pretty-js@0.2.2/+esm");
    const source = bindings.importValue("source");
    const pretty = prettyJs(source);
    bindings.exportValue("pretty", pretty);
})();
~';
    l_source clob := '{ const a = b; var c = d; }';
    l_pretty clob;
    l_result clob;
begin
    l_ctx :=  dbms_mle.create_context(
        environment => 'JSAPEXDEV'
    );
    dbms_mle.export_to_mle(l_ctx, 'source', l_source);
    dbms_mle.eval(l_ctx, 'JAVASCRIPT', C_CODE, l_result);
    dbms_mle.import_from_mle(l_ctx, 'pretty', l_pretty);
    dbms_output.put_line(l_pretty);
    dbms_mle.drop_context(l_ctx);
end;
しかし、上記のコードではJavaScriptファンクションのprettyJsの戻り値は空文字になります。


以下のコードで変数l_sourceをMLEへエクスポートしています。

    dbms_mle.export_to_mle(l_ctx, 'source', l_source);

ここで、l_sourceはclobとして定義されています。

    l_source clob := '{ const a = b; var c = d; }';

この場合、MLE側でインポートした値はOracleClobのインスタンスとなります。

    const source = bindings.importValue("source");

上記のコードは、第2引数を省略せずに記述すると次のようになります。

    const source = bindings.importValue("source", bindings.JSTypes.ORACLE_CLOB);

OracleClobが持つプロパティやメソッドは、以下のページで紹介されています。


Oracle Database 23aiで使用できるMLEモジュールの説明は、以下のページにまとまっています。


PL/SQL側よりCLOBが渡されたときはMLE側ではOracleClobとして取り出されるため、getData()を呼び出して文字列を取り出す必要があります。

以上を考慮して最初のコードを書き直します。
declare
    l_ctx dbms_mle.context_handle_t;
    C_CODE constant clob := q'~
(async() => {
    const bindings = await import("mle-js-bindings");
    const { default:prettyJs } = await import("/npm/pretty-js@0.2.2/+esm");
    const source = bindings.importValue("source", bindings.JSTypes.ORACLE_CLOB);
    console.log("Is source instance of OracleClob?", (source instanceof OracleClob));
    const pretty = prettyJs(source.getData());
    bindings.exportValue("pretty", pretty);
})();
~';
    l_source clob := '{ const a = b; var c = d; }';
    l_pretty clob;
    l_result clob;
begin
    l_ctx :=  dbms_mle.create_context(
        environment => 'JSAPEXDEV'
    );
    dbms_mle.export_to_mle(l_ctx, 'source', l_source);
    dbms_mle.eval(l_ctx, 'JAVASCRIPT', C_CODE, l_result);
    dbms_mle.import_from_mle(l_ctx, 'pretty', l_pretty);
    dbms_output.put_line(l_pretty);
    dbms_mle.drop_context(l_ctx);
end;
今度は整形されたJavaScriptのコードが出力されます。


MLEモジュールmle-js-plsqltypesとして、OracleClob以外にもPL/SQLの型に対応したクラスが定義されています。


APEXのページ・アイテムは型がなく、基本的に文字列です。コード中でページ・アイテムを日付や数値として扱う際には、暗黙の型変換が行われます。それはapex.envから参照されるページ・アイテムについても同様で、値は文字列として保持されています。(恐らく)MLE JavaScriptでは型変換は自動的に行われないので、MLEとPL/SQLで値をやり取りする場合は、常に変数の型を意識する必要があるでしょう。

今回の記事は以上になります。

Oracle APEXのアプリケーション作成の参考になれば幸いです。

完

2024年6月10日月曜日

Oracle Database 23aiで動作するOracle APEXでウォレットとしてsystem:を設定する

Oracle Database 23aiより、データベースよりTLSでコールアウトする際に使用するウォレットとしてsystem:が指定できるようになりました。

UTL_HTTPでの指定は以下のようになります。Oracle Corporationに所属しているMartin BachさんのブログUsing the JavaScript fetch API in Oracle Database 23aiを参照しています。
begin
    utl_http.set_wallet('system:');
end;
/
Oracle Database 23ai FreeにインストールしたAPEXで、ウォレットのパスとしてsystem:を指定できるかどうか確認してみました。結果としては動作したので、Oracle Database 23aiからは、Oracle APEXの環境構築の際にOracle Walletを作成する必要が無くなっています。

2024年6月19日追記
Oracle APEX 24.1をOracle Database 23aiにインストールした場合は、ウォレット・パスが未指定であればsystem:を参照するようになりました。そのため、APEXでもウォレットに関する設定は不要になりました。
追記終わり

Oracle APEXの管理サービスにアクセスし、インスタンスの管理からインスタンスの設定を開きます。ウォレットのセクションのウォレット・パスはデフォルトで未指定です。

インスタンスの設定の電子メールのOracle APEXインスタンスのURLおよびOracle APEXのイメージURLはデフォルトで無指定ですが、必須項目です。変更を適用する際は値の指定が必須なので、デフォルトURLをクリックして設定しておきます。


この状態で、APEXのワークスペースよりAPEX_WEB_SERVICE.MAKE_HTTP_REQUESTを呼び出してみます。最初は引数p_wallet_pathをコメント・アウトします。
declare
    l_clob clob;
begin
    l_clob := apex_web_service.make_rest_request(
        p_url => 'https://oracle.com'
        ,p_http_method => 'GET'
        -- ,p_wallet_path => 'system:'
    );
    dbms_output.put_line(substr(l_clob, 1, 100));
end;
p_urlに指定しているプロトコルがhttpsであるため、ウォレットの指定が無いとORA-29024: 証明書の検証に失敗したが発生します。


p_wallet_pathのコメント・アウトを解除して、再度実行します。

ORA-29024は発生せず、コンテンツの取得ができています。ウォレット・パスに与えているsystem:は新しく追加された指定ですが、Oracle APEXのAPEX_WEB_SERVICEパッケージはp_wallet_pathへのsystem:の指定を、UTL_HTTP.SET_WALLETの引数として渡せています。


管理サービスを開き、インスタンスの設定のウォレット・パスとしてsystem:を設定します。この設定はAPEX_WEB_SERVICE.MAKE_REST_REQUESTの引数p_wallet_pathのデフォルト値になります。


APEXワークスペースより、再度同じ処理を実行します。引数p_wallet_pathをコメント・アウトしても、今度はエラーは発生しません。


APEX_WEB_SERVICE.MAKE_REST_REQUESTを呼び出すにあたって、ネットワークACLの追加が必要です。APEX 23.2の場合は、以下のようにprincipal_nameにAPEX_230200を指定します。
begin
  DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
    host => '*',
    ace => xs$ace_type(
        privilege_list => xs$name_list('connect'),
        principal_name => 'APEX_230200',
        principal_type => xs_acl.ptype_db));
  commit; 
end;
/
パッケージAPEX_WEB_SERVICEの所有者は(APEXのバージョンが23.2であれば)APEX_230200であり、MAKE_REST_REQUESTは定義者権限で動作します。APEX_WEB_SERVICEからHTTPのコールアウトを行う際にUTL_HTTPを呼び出されますが、定義者権限であるため、この呼び出しはパッケージAPEX_WEB_SERVICEの所有者であるAPEX_230200によって実行されることになります。そのためprincipal_nameをAPEX_230200としてネットワークACLを定義する必要があります。

今回参照した記事では、MLE JavaScriptよりHTTPのコールアウトを行なっています。これは接続しているスキーマで実行されるため、ネットワークACLはAPEXワークスペース・スキーマに対して許可する必要あります。また、APEXのインスタンス設定のウォレット・パスはあくまでAPEX_WEB_SERVICEからUTL_HTTPを呼び出す際に与えるウォレットのデフォルト値であるため、MLE JavaScriptではMartin Bachさんの記事にあるように、別途ウォレットを指定する必要があります。

今回の記事は以上になります。

完

2024年6月7日金曜日

Google NotebookLMにAPEXの日本語記事を読ませて質問してみる

Google NotebookLMが日本で利用できるようになったので、本ブログの記事を読ませて質問してみました。

GoogleのNotebookLMを開き、新しいノートブックを作成します。今回はAPEXとGeminiというノートブックを作成しました。


作成したノートブックにソースを追加します。ソースのプラス(+)アイコンをクリックし、アップロード元にウェブサイトを選びます。


記事「GoogleのGemini APIをOracle APEXから呼び出す」をソースに追加します。URLは以下です。URLの末尾に?m=1を追加し、モバイル向けの画面に切り替えます。この指定が無いと、画面の右にあるブログアーカイブ、関連サイト、ラベルといった情報もソースに取り込まれてしまいます。

https://apexugj.blogspot.com/2023/12/web-credential-for-google-gemini-api.html?m=1


取り込まれたソースをクリックし、実際にソースとして取り込まれた内容を確認します。

ソースガイドとして記事の概要が印刷されます。この他にも記事を取り込んでみましたが、驚くほど適切な概要になっています。ただし、記事にはGithub Gistのスニペットを埋め込んでいるのですが、それはソースとして取り込まれていません。


記事に貼り付けてあるスニペットもソースに取り込むために、モバイル向けのWebページをPDFに印刷し、PDFをソースとしてアップロードします。

PDFとしてアップロードすると、スニペットもソースに含まれます。

人間が読みやすいようにコードに行番号を表示していますが、AIに読ませることを考えると行番号は無い方がいい気がしています。


以下の6つの記事をソースとしてアップロードしました。


以下の質問をしました。

「Oracle APEXのアプリケーションからGoogle Geminiを呼び出す方法を教えてください。」

おおむね適切な回答になっています。

記事を探して読んで、該当する部分を自分で見つけるよりも、とにかくソースとしてPDFをアップロードして質問する方がはるかに効率が良い感じがします。


ソースコードを書いてください、という質問は、ソースにコードが含まれていても受け付けないか、記事の書き方か質問の仕方か、もしくはその双方の検討が必要そうです。

「Gogleのサービス・アカウントによる認証を行うPL/SQLコードを記述してください。」

それでも回答は、そのコードに近い部分を引用しています。


NotebookLMのSourcesのLimitationsとして「Each source can contain up to 500,000 words. We’ll review these limits periodically to help determine the best user experiences」とあり、1ソースあたり50万語(日本語ほぼ50万文字になるかもしれません)、数の上限は50(公式のドキュメントに該当する記載を見つけられなかったので、もしかしたらワード数のみが制限になった可能性はあります)とのことです。

ノートブックを作成し、記事をソースとしてアップロードするには相応の手間がかかります。相当に有用な印象を受けましたが、現時点ではGoogle NotebookLMは試験期間中で費用は発生しないので、費用対効果は分かりません。OpenAIのRetrievalで同じことができる、または、その他のフレームワークでも同じことはできる、というのはありますが、アプリケーションを作らず、単にファイルをアップロードするだけ、というのはアドバンテージがあります。

とにかく、本ブログの記事以外に、マニュアルやWebページをノートブックのソースとしてアップロードして、チャットで質問して問題を解決する、というのが現実的な手段になったと言えそうです。

完

2024年6月6日木曜日

対話グリッドのセルへのマウス・エンターとマウス・リーブを確認する

対話グリッドのセルに対して、マウス・エンターとマウス・リーブのイベントで呼び出される動的アクションを作成したところ、当初考えていたように動きませんでした。

動作を確認するためのAPEXアプリケーションを作成し、対話グリッドのセルをターゲットとしたマウス・エンターとマウス・リーブのイベントで呼び出される動的アクションを作成します。

動作の確認には、サンプル・データセットのEMP/DEPTに含まれる表EMPをソースとした、編集可能対話グリッドを使用します。動的アクションは列ENAMEに作成します。対話グリッドのリージョンに、静的IDとしてempを設定します。

最初は、素直に対話グリッドの列に動的アクションを作成します。

識別の名前はEnterとします。実行のイベント有効範囲は動的、静的コンテナ(jQueryセレクタ)は#empとします。対話グリッドのセルはページのリロードをせずに書き換わるため、イベント有効範囲を動的にしています。

タイミングのイベントはマウス・エンター、選択タイプは列、列はENAMEを指定します。マウス・エンターのイベントが発生したときに実行されるJavaScriptコードは以下です。
console.log(this.triggeringElement);
apex.items.P2_ENTER.setValue($v(this.triggeringElement));

マウス・リーブのイベントで呼び出される動的アクションも作成します。イベントがマウス・リーブになるのと、実行されるJavaScriptコードが異なります。
console.log(this.triggeringElement);
apex.items.P2_LEAVE.setValue($v(this.triggeringElement));

ページを実行してマウス・エンターおよびマウス・リーブのイベントの発生を確認すると、イベントのトリガー要素(this.triggeringElement)が、INPUT要素であることが確認できます。

<input type="text" id="C22499063937843927" name="22499063937843927" class="text_field apex-item-text js-ignoreChange" value="" maxlength="50" tabindex="0" aria-labelledby="C22499063937843927_HDR">


対話グリッドのセルがINPUT要素になるのは、セルをダブルクリックなどして編集する状態になったときです。セルが表示されているときはINPUT要素ではないため、その状態のセルにポインタを載せてもイベントは発生しません。

対話グリッドの列に動的アクションを作成する場合、タイミングの選択タイプ、対話グリッド、列の3つを指定します。この形式で指定すると、編集モードになったセルがトリガー要素になることがわかりました。

編集モードになったセルではなく、表示されているセルがトリガー要素になる設定を探してみます。

列ENAMEの詳細のCSSクラスに、擬似CSSクラスとしてonPointerを設定します。


マウス・エンター/リーブのタイミングの選択タイプをjQueryセレクタに変更し、jQueryセレクタとして.onPointerを指定します。

列ENAMEの一番内部の要素がトリガー要素になります。


ページを実行してマウス・エンターおよびマウス・リーブのイベントの発生を確認します。

先ほどの列ENAMEに動的アクションを作成したときと同じ動作が確認できます。対話グリッドの列の詳細のCSSクラスは、INPUT要素に設定されています。そのため、この設定では表示中のセルをターゲットとしたマウス・イベントは取れません。


列ENAMEの詳細のCSSクラスとして設定したonPointerを削除し、代わりに外観のCSSクラスとして設定します。


動的アクションのタイミングはCSSクラスonPointerに設定されているため変更は不要ですが、実行するJavaScriptは$v(this.triggeringElement)の代わりにthis.triggeringElement.textContentをページ・アイテムに設定するように変更します。
console.log(this.triggeringElement);
apex.items.P4_ENTER.setValue(this.triggeringElement.textContent);
ページを実行してマウス・エンターおよびマウス・リーブのイベントの発生を確認すると、イベントのトリガー要素(this.triggeringElement)が、TD要素であることが確認できます。

<td tabindex="-1" role="gridcell" class="a-GV-cell u-tS onPointer">MARTIN</td>

この場合はセルが編集モードになる必要はなく、セルの上にマウスが載ったらマウス・エンター、離れたらマウス・リーブのイベントが発生します。


外観のCSSクラスの代わりに列ENAMEにcellTemplateを設定します。
function(options) {
    options.defaultGridColumnOptions = {
        cellTemplate: '<div class="onPointer">&ENAME.</div>'
    }
    return options;
}
この場合、cellTemplateとして設定した要素がトリガー要素になります。セルが編集モードになる必要はありません。

<div class="onPointer">TURNER</div>


外観のCSSクラスとして擬似クラスonPointerを設定しても、cellTemplateのclass指定にonPointerを含めても、表示モードのセル上でマウス・エンター/リーブのイベントを取ることができます。

cellTemplateを使うとカスタム属性などを追加できるため、呼び出されるJavaScriptの記述が楽になるという利点があります。例えばcellTemplateにカスタム属性data-idとして従業員番号を渡します。
function(options) {
    options.defaultGridColumnOptions = {
        cellTemplate: '<div data-id=&EMPNO. class="onPointer">&ENAME.</div>'
    }
    return options;
}
動的アクションで呼び出されるJavaScriptでは、this.triggeringElement.dataset.idとして従業員番号を参照できます。
console.log(this.triggeringElement);
apex.items.P5_ENTER.setValue(this.triggeringElement.textContent);
apex.items.P5_EMPNO.setValue(this.triggeringElement.dataset.id);

今回の記事は以上です。

今回の作業で使用したAPEXアプリケーションのエクスポートを以下に置きました。
https://github.com/ujnak/apexapps/blob/master/exports/mouse-event-on-ig.zip

Oracle APEXのアプリケーション作成の参考になれば幸いです。

完