データ・アクションのplugin.xmlファイル・リソース・セクション

データ・アクションのplugin.xmlファイル・リソース・セクション - tns:resources

tns:resourcesセクションは、拡張に関与するすべてのファイルを登録します。

リソース


1 <tns:resources>
2    <tns:resource id="currencyconversion" path="scripts/currencyconversion.js" type="script" optimizedGroup="base"/>
3    <tns:resource-folder id="nls" path="resources/nls" optimizable="true">
4       <tns:extensions>
5          <tns:extension name="js" resource-type="script"/>
6       </tns:extensions>
7    </tns:resource-folder>
8 </tns:resources>

ここで、それぞれのJavaScript、CSS、イメージおよび翻訳リソース・ファイルを登録する必要があります。このセクションは<tns:resources>要素内にあり、次の要素がいくつか含まれています:

<tns:resource>
これらの要素は、単一のファイル(JavaScriptやCSSファイルなど)を登録するために使用されます。
<tns:resource-folder>
これらの要素は、指定されたフォルダにあるすべてのファイルを同時に登録するために使用します。たとえば、イメージのフォルダ、またはネイティブ言語サポートのリソース・ファイルを含むフォルダです。

各タイプのファイルを登録する方法の詳細は、次の項を参照してください。

JavaScriptファイル

拡張機能内の各JavaScriptファイルは、次に示すような行で登録する必要があります。

<tns:resource id="currencyconversion" path="scripts/currencyconversion.js" type="script" optimizedGroup="base"/>

説明:

idは、ファイルに指定されたIDです。
.js拡張子を使用せずにJavaScriptファイル名と一致するようにIDを設定します。
pathは、plugin.xmlファイルからのJavaScriptファイルへの相対パスです。 JavaScriptファイルは、拡張のscriptsディレクトリに格納する必要があります。
JavaScriptファイルで特殊文字(アンダースコア、ハイフンなど)のないすべての小文字を使用します。
typeは、登録されるファイルのタイプです。これは、JavaScriptファイルのscriptに設定する必要があります。
optimizedGroupでは、複数のJavaScriptファイルが1つの圧縮ファイルにまとめられます。サード・パーティの拡張機能では、この設定をbaseのままにする必要があります。

CSSファイル

拡張の各CSSファイルは、次に示すような行で登録する必要があります。

<tns:resource id="currencyconversionstyles" path="resources/currencyconversion.css" type="css"/>

説明:

idは、ファイルに指定されたIDです。
.css拡張子無しのCSSファイル名と一致するようにIDを設定します。
pathは、plugin.xmlファイルからのCSSファイルへの相対パスです。 CSSファイルは、拡張機能のresourcesディレクトリに格納する必要があります。
CSSファイルで特殊文字(アンダースコア、ハイフンなど)のないすべての小文字を使用します。
typeは、登録されるファイルのタイプです。 CSSファイルについては、常にcssに設定する必要があります。

イメージ・フォルダ

拡張に、JavaScriptコード内から参照する必要があるイメージがある場合は、拡張機能のディレクトリ構造内のresources/imagesディレクトリに配置し、<tns:resource-folder>要素を次のようにplugin.xmlに追加します:

<tns:resource-folder id="images" path="resources/images" optimizable="false"/>

イメージがCSSファイルでのみ参照される場合は、この<tns:resource-folder>要素をplugin.xmlファイルに追加する必要はありません。この場合でも、resources/imagesディレクトリに追加し、CSSファイルからの相対パスを使用してそれらを参照できるようにする必要があります。

ネイティブ言語サポート・リソース・フォルダ

Oracle Analyticsにはネイティブ言語サポートが実装されています。そのため、開発者は、ユーザー・インタフェースに表示される文字列を個別のJSONリソース・ファイルに外部化する必要があります。その後、異なるローカライズ済バージョンのファイルを規定のディレクトリ構造で提供でき、Oracle Analyticsでは、ユーザーが選択した言語に対して自動的に正しいファイルが使用されます。必要な数の翻訳済バージョンのリソース・ファイルを提供できます。ネイティブ言語サポート・リソース・フォルダは、拡張で使用される規定のネイティブ言語サポート・ディレクトリ構造のルートにOracle Analyticsをポイントします。ネイティブ言語サポート・リソース・ファイルを使用するすべての拡張には、次の例とまったく同じ<tns:resource-folder>エントリが必要です。


1 <tns:resource-folder id="nls" path="resources/nls" optimizable="true">
2    <tns:extensions>
3       <tns:extension name="js" resource-type="script"/>
4    </tns:extensions>
5 </tns:resource-folder>

ファイルの内容および実行する必要がある規定のディレクトリ構造の詳細は、「生成されたフォルダおよびファイル」を参照してください。