リソース記述子ファイルの使用

「リソース記述子ファイル」は、単純コンポーネントのリソースを構成するファイルとディレクトリに使用する、所有者、グループ、およびアクセス権の設定を指定します。リソース記述子ファイルは XML ファイルです。リソース記述子ファイルを使用することで、コンポーネントのチェックイン時に決定されるアクセス権をオーバーライドすることができます。

リソース記述子ファイルを使用しない場合、リソースはチェックイン時の所有者、グループ、およびアクセス権の設定を使用します。このような状態は、UNIX システム上でチェックインを行う場合のデフォルトです。Windows システム上でコンポーネントをチェックインする場合、デフォルト設定は、リソース記述子ファイルの各設定に :NONE: 値を使用したかのようになります。

リソース記述子ファイルを使用する場合、リソースは、リソース記述子により指定される所有者、グループ、およびアクセス権の設定を使用します。リソースに対して <entry> 要素が指定されている場合、設定はそのエントリから取得されます。エントリが設定の一部を指定していない場合、指定されていない設定値が <defaultEntry> から取得されます (存在する場合)。これらの設定値が <defaultEntry> で指定されていない場合、リソースはチェックイン時に取得した設定値を使用します。

リソースに <entry> 要素が指定されてない場合、リソースは <defaultEntry> で指定されている設定を使用します (存在する場合)。<defaultEntry> が存在しない場合、リソースはチェックイン時に取得した設定を使用します。

コンポーネントが配備されるファイルシステムのデフォルト設定を使用するようN1 SPSに通知するには、:NONE: 値を使用します。<defaultEntry> ブロック、またはリソースの <entry> で指定されている任意の設定に対しては、:NONE: 値を指定できます。

リソース記述子ファイルを使用するのは、UNIX システムにコンポーネントを配備する場合のみです。コンポーネントを Windows システムに配備する場合、リソース記述子ファイルは無視されます。そのため、コンポーネントが Windows システムのみに適用される場合は、リソース記述子ファイルを作成しないでください。

リソース記述子ファイルは、system#file および system#directory コンポーネント型を拡張する単純コンポーネントにより使用できます。また、リソース記述子ファイルは、Linux プラグインの一部である com.sun.linux#rpm コンポーネント型を拡張するコンポーネントで使用することもできます。

コンポーネントのチェックインと同時に、リソース記述子ファイルをチェックインします。最後のチェックインにリソース記述子ファイルを使用したコンポーネントに対し checkin-current を試みると、N1 SPSは元のチェックイン場所でリソース記述子が見つかると想定します。そのため、ファイルを別の場所に移動してコンポーネントに対し checkin-current を試みると、チェックイン操作が失敗します。

チェックインされた単純コンポーネント用にリソース記述子をダウンロードして、コンポーネントのリソースの一部である、あらゆるファイルの設定を確認することができます。

このダウンロード機能を使用すると、ファイルを更新して、更新バージョンのコンポーネントをチェックインできます。まず、リソース記述子ファイルをダウンロードしてから、関連付けられたコンポーネントのリソースをチェックアウトします。続いて、リソース記述子ファイルを変更し、それを使用して新しいバージョンのコンポーネントをチェックインします。

ダウンロードしたリソース記述子は、コンポーネントのチェックインに使用したリソース記述子とは異なる場合があります。違いが生じるのは、コンポーネントのチェックインに使用する記述子は、リソース内のあらゆるファイルに関する情報を持つ必要がないか、または、あらゆるエントリに関する完全な情報を持つ必要がないためです。ダウンロードされたリソース記述子ファイルには <defaultEntry> ブロックが出現しないことに注意してください。その代わりに、あらゆるファイルは独自の <entry> に記述されています。