XML スキーマからのインポート

始める前に:

このタスクを実行するには、以下のタスクを完了している必要があります。

また、このタスクを始める前に、以下の点に注意してください。

変更の始まりファイルの拡張は、小文字の .xsd でなければならないので注意してください。変更の終わり

以下のステップでは、完全に新規のメッセージ定義ファイルの作成方法、および既存ファイルの内容を上書きする方法についても説明します。

XML スキーマ・ファイルからメッセージ定義を作成するには、以下のようにします。

  1. 「ブローカー・アプリケーション開発 (Broker Application Development)」パースペクティブに切り替えます。
  2. ワークベンチ・メニューで、 「ファイル (File)」>「新規 (New)」>「メッセージ定義ファイル (Message Definition File)」の順にクリックして、「新規メッセージ定義ファイル (New Message Definition File)」ウィザードを開きます。 あるいは、以前にワークベンチにインポートされた *.xsd ファイルを右マウス・ボタン・クリックして、 メニューで「新規 (New)」>「メッセージ定義ファイル (Message Definition File)」 をクリックすることで、ウィザードを開きます。
  3. オプションの表示リストで、「XML スキーマ・ファイル」をクリックして選択し、それから「次へ (Next)」をクリックします。
  4. ワークベンチ・ファイルの表示リストで、インポートしたい XML スキーマ・ファイルをクリックし、 それから「次へ (Next)」をクリックします。 上記のステップ 3 で説明されているようにウィザードを開くと、 右マウス・ボタン・クリックした *.xsd ファイルは、 次のページが表示されるときにすでに選択済みとなります。
  5. 「メッセージ・セット (Message sets)」の下に示されるメッセージ・セットのリストで、作成するメッセージ定義ファイル用のターゲット・メッセージ・セットをクリックします。 「メッセージ定義ファイル名 (Message definition file name)」 フィールドに、インポート中のファイルの名前を基にしたデフォルトのファイル名が自動的に記入されます。 必要なら、表示されるデフォルト・ファイル名を、独自の新規名に変更することができます。
  6. オプション: 既存のメッセージ定義ファイルの内容を置換したい場合は次のようにします。
    1. 「メッセージ定義ファイル名 (Message definition file name)」フィールドに 既存ファイルの名前をタイプします。
    2. 「警告なしに既存ファイル内容を上書きする (Overwrite the existing file contents without warning)」チェック・ボックスを選択します。 警告が表示されずに、既存ファイルが上書きされます。
  7. 「次へ (Next)」をクリックします。 XML スキーマは妥当性検査されます。
  8. オプション:グローバル・エレメントの表示リストで、 メッセージの作成元となるグローバル・エレメント (グローバル複合タイプをベースにする) のチェック・ボックスを選択します。 「すべて選択 (Select All)」 および「選択をすべて解除 (Deselect All)」ボタンを使用して、 リスト内のすべてのグローバル・エレメントを選択したり、リスト内のグローバル・エレメントを 1 つも選択しないように指定します。
    ヒント: グローバル複合タイプを基にしたグローバル・エレメントのみが可視になります。 他のすべてのグローバル・エレメントは可視にはなりません。
  9. オプション: 作成するメッセージ定義ファイル用のターゲット・メッセージ・セットが ネームスペース・サポートを使用可能にしていない場合には、 「次へ (Next)」をクリックするというオプションがあります。 これで、追加のネームスペースを追加できるようにするウィンドウが表示されます。
  10. 「終了 (Finish)」をクリックします。 XML スキーマからメッセージ定義ファイルが作成され「メッセージ定義エディター (Message Definition editor)」で開きます。
  11. ウィザードを使用した XML スキーマ・インポートを完了したとき、 ファイルがインポートされた時に作成されたレポートにエラーがないかを注意深く調べます。 これは、作成しようとしたメッセージ定義を含むプロジェクト内の log ディレクトリーで見つけることができます。 レポートは、接頭部に新規メッセージ定義ファイル用に指定された名前を持つ *.xsd.report.txt ファイル拡張子を持ちます。

XML スキーマ・ファイルをインポートした後、 ワークベンチ・タスク・リストに示されているメッセージを検討して、 新規警告またはエラーが表示されているかどうかを調べます。 メッセージが表示される状態の例は、以下にリストされているとおりです。

関連概念
メッセージ定義の作成方法
メッセージ定義を作成するための他のモデル表現からのインポート
ネーム・スペースが使用不可になっているメッセージ・セット
ネーム・スペース
XML スキーマ
スキーマの制約

関連タスク
メッセージ・セット・プロジェクトの処理
コマンド行からのインポート
メッセージ・セットのプリファレンスの構成
オブジェクトの削除

関連資料
インポート形式
メッセージ・セットのプリファレンス
XML スキーマ・インポーター