XML カタログへの項目の追加

XML カタログ・エントリーは、外部エンティティー参照を、ローカルで定義されたリソースにマップする場合に使用します。 これらのエンティティーの解決方法を指定する規則を提供できます。

XML カタログの標準について詳しくは、http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html を参照してください。

例えば、コンピューター上で XML ファイルを編集していて、schemaLocation として、スキーマ c:¥MySchema.xsd を指定したとします。XML カタログを使用しない場合、XML ファイルの編集を終了して、Web 上で公開する準備ができたら、Web 上でアクセス可能なリソースを示すように schemaLocation を編集する必要があります。

XML 文書を頻繁に変更することを避けるために、XML カタログを使用できます。インターネット・リソースの参照 (例えば、"http://www.ibm.com/published-schemas/MySchema.xsd") をリダイレクトする規則を指定できます。 これにより、ローカル・マシン (例えば、"file:///C:/MySchema.xsd") 上のリソースを指定できます。 これで、URI またはロケーションを更新するために XML 文書を頻繁に編集せずに (特にプロジェクト内に多数の文書が存在する場合に)、XML カタログ内の単一の規則を更新するだけで済みます。

次の説明は「リソース」パースペクティブを対象にしていますが、他のさまざまなパースペクティブでも使用できます。

項目を XML カタログに追加するには、以下のステップを実行します。

  1. DTD または XML スキーマに関連付ける XML ファイルを開きます。
  2. 「ウィンドウ」 > 「設定」 とクリックし、「XML」 > 「XML カタログ」と選択します。 「XML カタログ・エントリー」セクションには、すべてのユーザー定義およびプラグイン定義のカタログ項目のリストが含まれています。任意の項目を 選択すると、「詳細」セクションでそれに関する情報を確認できます。
  3. 新しいカタログ項目を作成するには、「追加」をクリックします。
  4. 左側の列で、追加するカタログ・エントリーのタイプをクリックします。
    オプション 説明
    カタログ・エントリー XML プロセッサーによって、エンティティー参照を解決するときに使用されます。 どのようにエンティティーを解決するかを指定するために、 カタログに対して規則を与えることができます。
    XML カタログ・エントリーには、次の 2 つの部分が含まれています。
    • キー (DTD または XML スキーマを表す)
    • ロケーション (URI と同様に、DTD または XML スキーマのロケーションに関する情報を含む)
    キーは XML ファイルに入れることができます。XML プロセッサーは、そのキーを検出すると XML カタログ項目を使用して、キーに関連付けられた DTD または XML スキーマのロケーションを検索します。
    再書き込みエントリー エンティティーのセットをリダイレクトするために使用します。
    接尾部エントリー URI またはシステム ID の接尾部を一致させるために使用します。
    次のカタログ ワークベンチにインポートせず、別のカタログを参照するために使用します。
    カタログの委譲 代替カタログを ID に関連付けるために使用します。
  5. 選択したカタログ・エントリーのフィールドを完成させます。
    テーブル 1. カタログ・エントリー・タイプおよび関連フィールド
    カタログ・タイプ フィールド
    カタログ・エントリー
    • 「ロケーション」フィールドで、DTD または XML スキーマ・ファイルのロケーションまたは URI について、入力するかまたは参照して指定します。 この際、ご使用のコンピューターのパス・スタイルを使用して、ファイルのロケーションを指定します。
    • 「キー・タイプ」を選択します。
      • DTD を指定した場合:「パブリック ID」、「システム ID」、または「URI」を 「キー・タイプ」フィールドから選択します。 「パブリック ID」を選択した場合、「キー」フィールドに入力する値は、 XML ファイルの DOCTYPE 宣言のパブリック ID と同じでなければなりません。「システム ID」を選択した 場合、入力する値は、XML ファイルの DOCTYPE 宣言のシステム ID に対応していなければなりません。「URI」を選択した場合、入力する値は、 完全修飾 URI でなければなりません。
      • XML スキーマを指定した場合:「名前空間名」または「スキーマ・ロケーション」のいずれかを 「キー・タイプ」フィールドから選択します。 そのスキーマがターゲットの名前空間を定義する場合は、「キー」フィールドに自動的に表示されます。定義していない場合は、スキーマのロケーションを「キー」フィールドに入力することができます。
    • リソースの代替 Web アドレスを指定できるようにするには、「代替 Web アドレスの指定」チェック・ボックスを選択します。
      この Web アドレスは、このカタログ項目から XML インスタンスが生成される際に使用されます。
      注: このオプションは、「パブリック ID」(DTD の場合) または「名前空間名」(スキーマの場合) を「キー・タイプ」フィールドで選択した場合にのみ使用できます。
    再書き込みエントリー
    • 「一致するキー・タイプ」、URI またはシステム ID を選択します。
    • 一致する開始ストリング: 提供された ID から削除する、一致する接頭部。
    • 再書き込み接頭部: 削除する接頭部の代わりに使用する接頭部。
    接尾部エントリー
    • 「ロケーション」フィールドで、DTD または XML スキーマ・ファイルのロケーションまたは URI について、入力するかまたは参照して指定します。 この際、ご使用のコンピューターのパス・スタイルを使用して、ファイルのロケーションを指定します。
    • 一致する「キー・タイプ」(URI またはシステム ID) を選択します。
    • 一致する ID の「接尾部」を入力します。
    次のカタログ 「別の XML カタログ・ファイルのロケーション」フィールドで、参照する XML カタログを入力するか、またはブラウズします。
    カタログの委譲
    • 「一致するキー・タイプ」、URI またはシステム ID を選択します。
    • 一致する開始ストリング: 一致する提供された ID の接頭部。
    • この XML カタログ・ファイルに委譲: 関連付ける代替カタログ。
  6. カタログ項目の作成を終えたら、「OK」をクリックして、「XML カタログ・エントリーの追加」ダイアログを閉じます。「OK」をもう一度クリックして、設定を保存します。
  7. XML ファイルにフォーカスが当たっていることを確認して、「依存関係の再ロード」ツールバー・ボタンをクリックします。
これで XML ファイルは、XML スキーマまたは DTD の最新バージョンと関連付けられました。

また、以下のようにして XML カタログ情報をエクスポートおよびインポートすることもできます。

エクスポートするには、「ファイル」 > 「エクスポート」をクリックして、「XML」 > 「XML カタログ」を選択します。プロジェクトを選択し、 .xmlcatalog ファイルにカタログ項目を保管するためのファイル名を指定するようにプロンプトで指示されます。 このファイルは「ナビゲーター」ビューから開くことができます。 カタログ項目は .xmlcatalog ファイルに格納されるため、その他のプロジェクト・リソースと同様に、 チェックインおよびチェックアウトして共有することができます。

インポートするには、「ファイル」 > 「インポート」とクリックし、 「XML」 > 「XML カタログ」 と選択します。次に、XML カタログ設定のロードに使用されるファイルを指定します。 .xmlcatalog ファイルをインポートすると、 ファイル内のすべての項目が XML カタログにロードされます (すべての既存の項目が上書きされます)。

関連概念
DTD および XML スキーマと XML ファイルの関連付け
関連タスク
DTD または XML スキーマの制約がある場合の編集
DOCTYPE 宣言の編集
DTD およびスキーマの変更による XML ファイルの更新
名前空間情報の編集