17.6 ショートカットの使用

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。

ショートカットとは
頻繁に使用されるコードを定義した後、多くの箇所でそのコードを参照するようにショートカットを使用することで、コードの重複を削減します。たとえば、ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。
サポートされるショートカット・タイプ
Oracle Application Expressでは、6種類のショートカットがサポートされています。
ショートカットを最初から定義
ショートカット・ページで、ショートカットを定義します。
既存のショートカットのコピー
ショートカット・リポジトリから既存のショートカットをコピーします。
既存のショートカットの編集
作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。
ショートカット・レポートへのアクセス
ショートカットのサブスクリプションと履歴レポートを表示します。

17.6.1 ショートカットとは

頻繁に使用されるコードを定義した後、多くの箇所でそのコードを参照するようにショートカットを使用することで、コードの重複を削減します。たとえば、ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。

次の位置でショートカットを使用できます。

「HTMLテキスト(ショートカットあり)」として定義されたリージョンのリージョン・ソース属性。
リージョンのヘッダーおよびフッターのテキスト属性。
アイテム・ラベル属性、要素の前のテキスト、要素の後のテキストおよびデフォルト値属性。
リージョン・テンプレート属性。

ショートカットの参照

ショートカットを定義すると、そのショートカットが使用される位置に固有な特定の構文を使用して起動できます。

ショートカットを参照するには、次の構文を使用します。

"MY_SHORTCUT"

ショートカットの名前は、大文字で指定し、引用符で囲む必要があります。

17.6.2 サポートされるショートカット・タイプ

Oracle Application Expressは、6つのショートカット・タイプをサポートしています。

ショートカットの作成時に、ショートカット・タイプを選択します。サポートされているショートカット・タイプは、次のとおりです。

PL/SQLファンクション本体
HTMLテキスト
エスケープされた特殊文字を持つHTMLテキスト
イメージ
エスケープされた一重引用符を持つJavaScriptのテキスト
Message
エスケープされた一重引用符を持つJavaScriptのメッセージ

エスケープされた一重引用符を持つJavaScriptのテキスト

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

Message

このタイプのショートカットを使用して、実行時に変換可能なメッセージを参照します。このショートカットにはショートカット・ボディがないため、ショートカット名と、対応するメッセージ名が一致する必要があります。実行時、ショートカット名は、現在の言語に翻訳可能なメッセージのテキストに展開されます。

エスケープされた一重引用符を持つJavaScriptのメッセージ

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に変換可能なメッセージを参照します。

17.6.3 ショートカットを最初から定義

ショートカット・ページで、ショートカットを定義します。

ショートカットを定義するには、次のステップを実行します。

共有コンポーネント・ページにナビゲートします。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
  共有コンポーネント・ページが表示されます。
「他のコンポーネント」で、「ショートカット」を選択します。
「作成」をクリックします。
「ショートカットの作成」で、「最初から」を選択して「次へ」をクリックします。
「ショートカットの属性」で、次のステップを実行します。
1. 名前 - ショートカットを参照する名前を入力します。
2. タイプ - ショートカット・タイプを選択します。オプションは次のとおりです。
  - PL/SQLファンクション本体
  - HTMLテキスト
  - エスケープされた特殊文字を持つHTMLテキスト
  - イメージ
  - エスケープされた一重引用符を持つJavaScriptのテキスト
  - メッセージ
  - エスケープされた一重引用符を持つJavaScriptのメッセージ
3. ショートカット - ショートカットのテキストを入力します。ショートカットは、30,000文字未満の長さにする必要があります。
4. エラー・テキスト - ショートカットの処理中にエラーが発生した場合に表示するテキストを入力します。
5. ビルド・オプション - このコンポーネントのビルド・オプションを選択します。
「作成」をクリックします。
新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

親トピック: ショートカットの使用

17.6.4 既存のショートカットのコピー

ショートカット・リポジトリから既存のショートカットをコピーします。

既存のショートカットをコピーするには、次のステップを実行します。

共有コンポーネント・ページにナビゲートします。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
  共有コンポーネント・ページが表示されます。
「他のコンポーネント」で、「ショートカット」を選択します。
「作成」をクリックします。
「ショートカットの作成」で、「既存のショートカットのコピーとして」を選択して「次へ」をクリックします。
「コピー元アプリケーション」で、ショートカットをコピーするアプリケーションを選択して「次へ」をクリックします。
「新規ショートカット」で「ショートカットのコピー」をクリックします。
1. コピー先 - コピーされるショートカットの新しい名前を入力します。
2. コピー - 「はい」、「いいえ」または「コピーおよびサブスクライブ」を選択します。
3. 「ショートカットのコピー」をクリックします。
新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

親トピック: ショートカットの使用

17.6.5 既存のショートカットの編集

作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。

既存のショートカットを編集するには、次のようにします。

共有コンポーネント・ページにナビゲートします。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
  共有コンポーネント・ページが表示されます。
「他のコンポーネント」で、「ショートカット」を選択します。
ショートカットを選択します。
ショートカットの編集ページが表示されます。
属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。
「変更の適用」をクリックします。

17.6.6 ショートカット・レポートへのアクセス

ショートカットのサブスクリプションと履歴レポートを表示します。

ショートカット・レポートにアクセスするには、次のステップを実行します。

共有コンポーネント・ページにナビゲートします。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
2. アプリケーションを選択します。
3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
  共有コンポーネント・ページが表示されます。
「他のコンポーネント」で、「ショートカット」を選択します。
次のいずれかのタブをクリックします。
- サブスクリプション - アプリケーションにすべてのサブスクライブされたショートカットを表示するサブスクライブされたショートカット・ページが表示されます。
- 履歴 - 最近変更されたショートカットの履歴を日付ごとに表示するショートカット履歴ページが表示されます。
注意:
「サブスクリプション」タブおよび「履歴」タブが表示されるのは、ショートカットを作成した後のみです。

親トピック: ショートカットの使用