エクスポートはそれほど危険ではありませんが、インポートについては既存のアプリケーションが上書きされる可能性があります。あくまで一括でエクスポートやインポートを行うPL/SQLコードのサンプルとして取り扱うようお願いします。
本記事は、Oracle Corporationの公式ブログにOracle APEXのアーキテクトのCarsten Czarskiさんが投稿した、以下の記事を参考にしています。
Building a REST API to Deploy APEX Apps
記事のタイトルの通り、APEXのアプリケーションのインポートとエクスポートを、ORDSのRESTサービスとして実装しています。Oracle APEXにはリモート・デプロイメントが機能として含まれていますが、この機能では、デプロイ先となるAPEXワークスペースでREST対応SQLが有効になっている必要があります。セキュリティ上の理由などでREST対応SQLを有効にできない場合、APEXアプリケーションのインポート/エクスポートを行うORDS RESTサービスを作成することでリモート・デプロイメントを実行できるようになります。
今回の記事で作成するアプリケーションのエクスポートを以下に置いてあります。
https://github.com/ujnak/apexapps/blob/master/exports/bulk-app-exporter.zip
以下、アプリケーションの作り方を紹介します。
アプリケーションの名前はBulk App Exporterとしました。
アプリケーションの作成をクリックし、アプリケーションを作成します。
アプリケーション定義の置換に、アプリケーションのエクスポート先となるオブジェクト・ストレージのリージョン、ネームスペース、バケット名とWeb資格証明を設定します。
置換文字列G_REGIONにリージョン（本記事ではus-ashburn-1）、G_NAMESPACEにネームスペース、G_BUCKETにバケット名（同app-exports）、G_CREDENTIALにOCIのAPI呼び出しに使用するWeb資格証明の静的ID（同OCI_API_ACCESS）を置換値として設定します。
Oracle Cloudのオブジェクト・ストレージの準備については、少し古いですがこちらの記事が参考になります。
エクスポートするアプリケーションを複数選択し、エクスポートを実行するページを作成します。アプリケーションの一覧表示と選択を行うために、対話グリッドを使用します。
ページの作成を開始し、対話グリッドを選択します。
ページの名前はExportとします。データ・ソースのソース・タイプとしてSQL問合せを選択し、SQL SELECT文を入力に以下を記述します。
編集が有効をオンにします。
次へ進みます。
主キー列1としてAPPLICATION_ID (Number)を選択します。
ページの作成を実行します。
編集可能な対話グリッドのリージョンが作成されますが、実際にはこの対話グリッドのデータ・ソースは更新できません。今回実装するエクスポートの処理が必要としていない、対話グリッドの操作を無効化します。
対話グリッドを選択し、プロパティ・エディタの属性を開きます。
編集の実行可能な操作の内、行の追加と行の削除のチェックを外します。行の更新のみを実行可能な操作にします。
ツールバーのコントロールから保存ボタンのチェックを外します。対話グリッドの保存ボタンの代わりに、エクスポートを実行するボタンを後ほど作成します。
この後に列自体をコメント・アウトするのですが、対話グリッドの列APEX$ROW_SELECTORを選択し、設定のコントロールの非表示をオンにし、機能を無効化しておきます。
列EXPORTとOVERWRITEの識別のタイプをチェックボックスに変更します。EXPORTにチェックが入っているアプリケーションが一括エクスポートの対象となります。また、OVERWRITEにチェックが入っていると、バケット内に同じ名前のファイルがあれば上書きします。今回の実装では、同じ名前のファイルがありOVERWRITEにチェックが入っていない場合は、エラーにせず単にエクスポートをスキップします。
列APPLICATION_ID、EXPORT、OVERWRITE、ALIAS以外はエクスポート処理には使わないため、ソースの問合わせのみをオンにします。列の値がサーバーへの送信対象から外されます。
Button Containerのリージョンに、アプリケーションの一括エクスポートを実行するボタンEXPORTを作成します。ラベルはExportとします。動作のアクションはデフォルトのページの送信です。
プロセス・ビューを開き、デフォルトで作成されている対話グリッドの行の自動処理を行うプロセスを選択します。
識別の名前をExport - アプリケーションのアップロードに変更します。設定のターゲット・タイプをPL/SQLコードに変更し、挿入/更新/削除するPL/SQLコードとして以下を記述します。
データベースへの操作ではないため、失われた更新の防止はオフ、行のロックはいいえを選択します。
サーバー側の条件のボタン押下時にEXPORTを設定します。
以上でエクスポート自体は実装できたのですが、実際にアプリケーションがエクスポートされると、以下のようにUnexpected end of JSON inputのエラーが発生します。
エクスポートの実行が対話グリッドのリフレッシュに何かの影響を与えているようなので、エクスポートが完了した後に明示的にページをリロードさせます。
プロセスの後にブランチを作成します。
識別の名前はページのリロードとします。動作のタイプとしてページまたはURL(リダイレクト)を選択し、ターゲットはタイプがこのアプリケーションのページ、ページ番号に２、つまり同じページを指定します。
サーバー側の条件のボタン押下時にEXPORTを指定します。
以上でAPEXアプリケーションをオブジェクト・ストレージにエクスポートする処理が実装できました。
今回のアプリケーションは、アプリケーションを一括でエクスポートすることを目的にしています。その操作を容易にするために、すべての行の列EXPORTにチェックを入れるボタンを作成します。
ページ・プロパティのJavaScriptのページ・ロード時に実行に以下を記述し、対話グリッドの指定した列のチェックボックスに、すべての行に同じ値を設定するAPEXアクションset-column-value-allを定義します。ただし、JavaScriptのコードからでも画面からでも同じですが、対話グリッドで操作できる行は画面に表示されている行に限られます。APEXアクションset-column-value-allで値が設定される行も、表示中の行に限定されます。
Button Containerのリージョンに、すべての行のEXPORTをチェックするボタンを作成します。
識別の名前はCHECK_ALL_EXPORT、ラベルはCheck All Exportとします。レイアウトの新規行の開始をオフにし、ボタンEXPORTの隣に配置します。
動作のアクションに動的アクションで定義を選択し、詳細のカスタム属性に以下を記述します。
data-action="#action$set-column-value-all?grid=export-grid&column=EXPORT&value=Y"
ボタンUNCKECK_ALL_EXPORT、ラベルはUncheck All Export、カスタム属性は以下。
data-action="#action$set-column-value-all?grid=export-grid&column=EXPORT&value=N"
ボタンCHECK_ALL_OVERWRITE、ラベルはCheck All Overwrite、カスタム属性は以下。
data-action="#action$set-column-value-all?grid=export-grid&column=OVERWRITE&value=Y"
ボタンUNCHECK_ALL_OVERWRITE、ラベルはUnheck All Overwrite、カスタム属性は以下。
data-action="#action$set-column-value-all?grid=export-grid&column=OVERWRITE&value=N"
オブジェクト・ストレージのバケットに含まれるZIPファイルを選択してインポートするページを作成します。
バケット内のファイル一覧を取得するRESTデータ・ソースを作成します。
RESTデータ・ソースのデータ・プロファイルを自動的に作成するため、一つ以上のアプリケーションのエクスポートを実行し、あらかじめバケット内にファイルを配置しておいてください。
共有コンポーネントのRESTデータ・ソースを開きます。
作成をクリックします。
RESTデータ・ソースの作成は最初から行います。
次へ進みます。
RESTデータ・ソース・タイプにOracle Cloud Infrastructure (OCI)を選択します。名前はList Exported Applicationsとします。
URLエンドポイントとして以下を指定します。<リージョン>の部分は環境に合わせて置き換えます（本記事はus-ashburn-1）。:namespaceおよび:bucketがパラメータとして認識されます。
https://objectstorage.<リージョン>.oraclecloud.com/n/:namespace/b/:bucket/o?fields=name,size,etag,timeCreated,md5,timeModified
URLパラメータ1がnamespaceとなるので、値にネームスペースを設定します。URLパラメータ2がbucketとなるので、値にバケット名を設定します。
次へ進みます。
次へ進みます。
認証が必要ですをオンにし、資格証明としてオブジェクト・ストレージのアクセスに使用するWeb資格証明を選択します。
検出をクリックします。
バケット内のファイルがデータとして表示されます。
RESTデータ・ソースの作成をクリックします。
RESTデータ・ソースList Exported Applicationsが作成されます。
このRESTデータ・ソースをデータ・ソースとした対話グリッドのページを作成します。バケット上のファイルの一覧よりインポートするファイルを複数選択するために、対話グリッドを使用します。
Exportのページと同様に、ページの作成を開始し対話グリッドを選択します。
ページ名はImportとします。データ・ソースとしてRESTデータ・ソースを選択し、RESTデータ・ソースとして先ほど作成したList Exported Applicationsを選びます。編集が有効はオンにします。
次へ進みます。
主キー列1は必ず指定が必要なので、列NAMEを除く列から一意であると思われる列を選択します。列NAMEは一意ですが、主キー列として選択するとデフォルトで非表示列になるため、他の列を選択します。今回は一意だと思われるMD5(Varchar2)を主キー列1として選択しています。
ページの作成をクリックします。
対話グリッドのページが作成されます。
対話グリッドのリージョンを選択し、ローカル後処理のタイプをSQL問合せに変更し、SQL問合せとして以下を記述します。インポート対象として選択するための列IMPORTを追加しています。
対話グリッドの属性を、Exportと同様に設定します。
行セレクタAPEX$ROW_SELECTORのコントロールの非表示をオンにします。
列APEX$ROW_SELECTORとAPEX$ROW_ACTIONをコメント・アウトします。
列IMPORTとOVERWRITEのタイプをチェックボックスに変更します。
列IMPORTとOVERWRITE以外の表示列は変更不可なので、詳細のカスタム属性にreadonlyを設定します。
インポートについては、アプリケーションを全て選択して一度にインポートすることはなさそうなので、Exportで行ったJavaScriptに関する設定は省略します。
対話グリッドの設定は以上になります。
Exportのページと同様に、ボタンを配置するButton Containerのリージョンを作成します。
そのリージョンにボタンIMPORTを作成します。
プロセス・ビューを開き、デフォルトで作成されている対話グリッドの行の自動処理を行うプロセスを選択します。
識別の名前をImport - アプリケーションのインポートに変更します。設定のターゲット・タイプをPL/SQLコードに変更し、挿入/更新/削除するPL/SQLコードとして以下を記述します。
データベースへの操作ではないため、失われた更新の防止はオフ、行のロックはいいえを選択します。
サーバー側の条件のボタン押下時にIMPORTを設定します。
以上でアプリケーションをインポートするページは完成です。
実際はアプリケーションをインポートする際に、アプリケーションIDとして未割り当てのIDを選んで割り当てているため、OVERWRITEにチェックが必要な状況は発生しないはずです。複数の人が同時にインポートを実行するといった場合に、同じアプリケーションIDでアプリケーションをインポートしようとする状況が発生する可能性はあります。
インポート処理については、実際の要件からもっと実装を調整する必要はあるでしょう。
APEXアプリケーションよりインポートを実行するには、アプリケーション定義のセキュリティの詳細のランタイムAPIの使用状況に含まれる他のアプリケーションを変更にチェックを入れる必要があります。
データベースにsqlplusやSQLclなどで直接接続してAPEXアプリケーションをインストールする場合は、接続ユーザーにロールAPEX_ADMINISTATOR_ROLEが割り当たっている必要があります。詳しくはOracle APEXの管理ガイドを参照してください。
以下より、アプリケーションを若干調整します。
作成したRESTデータ・ソースのパラメータbucketとnamespaceのデフォルト値を削除し、必須をはいに切り替えます。
Importの対話グリッドのパラメータbucketの値のタイプを静的値に変更し、静的値として&G_BUCKET.を指定します。
パラメータnamespaceの静的値に&G_NAMESPACE.を指定します。
以上でアプリケーション定義G_NAMESPACEとG_BUCKETの設定が、Import対象に一覧表示に反映されるようになります。
リージョンはホスト名に含まれるため、パラメータとしては定義できません。ホスト部分の切り替えは、RESTデータ・ソースのリモート・サーバーを変更することで対応します。リモート・サーバーによる切り替えは、こちらの記事「リモート・サーバーを入れ替えてRESTデータ・ソースの実行環境を切り替える」で紹介しています。
今回の記事は以上になります。
Oracle APEXのアプリケーション作成の参考になれば幸いです。
完
