XML ワイヤー形式メッセージ・セットのプロパティー

下記の表には、 メッセージ・セットの場合の XML ワイヤー形式のプロパティーが定義されています。

ネーム・スペースの設定

プロパティー タイプ 意味
ネーム・スペース URI ストリング 関連した接頭部のためにどのネーム・スペースを使用するかを示すネーム・スペース名を入力します。
接頭部 ストリング 接頭部を入力して、接頭部と共に使用するエレメント名と属性名をネーム・スペース名に関連付けます。

ネーム・スペースのスキーマ・ロケーション

プロパティー タイプ 意味
ネーム・スペース URI ストリング どのネーム・スペースを使用するかを示すネーム・スペース名を入力します。
スキーマ・ロケーション ストリング ネーム・スペース内でオブジェクトの妥当性検査をするために使用されるネーム・スペース名に関連付けられたスキーマの場所を入力します。

XML 宣言

プロパティー Type 意味
XML 宣言の抑制 チェック・ボックス XML 宣言を抑制するチェック・ボックスを選択します。 選択すると、宣言 (例えば、<?xml version='1.0'> など) が抑制されます。
XML バージョン 列挙タイプ これは、生成される XML 宣言内でバージョンの値を制御します。

デフォルトは、1.0 です。

「XML 宣言の抑制 」「はい」に設定すると、このプロパティーは無視されます。

XML エンコード 列挙タイプ これは、エンコード属性が、生成される XML 宣言に書き込まれるかどうかを制御します。

「ヌル」を選択すると、出力 XML 文書の XML 宣言内にエンコード属性が書き込まれません。

「文書テキストとして」を選択すると、XML 文書内のテキストと整合したエンコード属性が生成されます。

デフォルトは、「ヌル」です。

「XML 宣言の抑制 」「はい」に設定すると、このプロパティーは無視されます。

スタンドアロン文書 列挙タイプ ドロップダウン・リストから「はい」「いいえ」、または 「ヌル」を選択します。「ヌル」を選択した場合は、スタンドアロン宣言は XML 宣言には存在しなくなります。 「はい」または「いいえ」を選択すると、 出力メッセージが作成されるときに、 宣言 standalone = "yes" または standalone = "no" が XML 宣言に追加されます。

このプロパティーの設定が、外部 DTD サブセットがロードされるかどうかを決定することはありません。 このリリースでは、外部 DTD サブセットがロードされることはありません。

「XML 宣言の抑制」「はい」を設定すると、このプロパティーは無視されます。

出力ネーム・スペース宣言 (Output Namespace Declaration) 列挙タイプ 出力ネーム・スペース宣言」プロパティーは、出力 XML 文書内のどこにネーム・スペース宣言が配置されるかを制御します。以下から選択します。
  • 「文書の始め」。 上記のネーム・スペースのスキーマ・ロケーション 表にあるすべてのエントリーのための宣言は、メッセージの属性として出力 XML 文書に出力されます。 このオプションの欠点は、大抵の場合、不必要な宣言が出力されてしまうという点です。
  • 「必要に応じて任意」。 宣言は、ネーム・スペースにあるエレメントまたは属性が必要とするときだけ出力されます。 このオプションの欠点は、同じネーム・スペース宣言が出力 XML 文書に複数回出力されることがあるという点です。

デフォルト・オプションは、「文書の始め」です。

ネーム・スペースがこのメッセージ・セットの場合に使用可能である場合のみ、このプロパティーはアクティブになります。

XML 文書タイプの設定

プロパティー Type 意味
DOCTYPE の抑制 チェック・ボックス このチェック・ボックスを選択すると、DOCTYPE (DTD) 宣言が抑制されます。

デフォルト値は、チェック・マークが付きます。

DOCTYPE システム ID ストリング DOCTYPE 外部 DTD サブセットのシステム ID を指定します (DOCTYPE が既存の場合)。 これは通常、 メッセージ・セットのために生成 (またはインポート) された DTD の名前に設定されます。

「DOCTYPE の抑制」を設定すると、このプロパティーは無視されて、 変更できません (フィールドは使用不可になります)。デフォルト値は www.mrmnames.net/ で、その後にメッセージ・セット ID が続きます。

DOCTYPE 共通 ID ストリング DOCTYPE 外部 DTD サブセットの共通 ID を指定します (DOCTYPE が既存で、 システム ID を指定している場合)。

「DOCTYPE の抑制」を設定すると、このプロパティーは無視されて、 変更できません (フィールドは使用不可になります)。デフォルト値はメッセージ・セット ID です。

DOCTYPE テキスト ストリング 追加の DTD 宣言を組み込むには、このプロパティーを使用します。 このテキストは XML パーサーによって解析されないので、有効な XML でない場合もあります。 ENTITY 定義、または内部 DTD 宣言を含めることができます。 これはストリング (最大 32KB) で、改行およびタブ文字はそれぞれ ¥n¥t に 置き換えられます。

内容は解析されず、出力メッセージ中に表示されます。 インライン DTD がある場合は、このプロパティーの内容が優先します。

「DOCTYPE の抑制」を設定していると、このプロパティーは無視されて、 変更できません (フィールドは使用不可になります)。

詳しくは、インライン DTD および「DOCTYPE テキスト」プロパティーを参照してください。

デフォルト値は空 (設定しない) です。

ルート・タグ名

プロパティー タイプ 意味
ルート・タグ名 ストリング メッセージ・セットのルート・タグの名前を指定します。 このプロパティーをブランクにすることができます。 この場合は、メッセージにラッパー・タグが使用されません (つまり、 メッセージ・タグが文書のルートになります)。 この名前の後にはスペースと属性/値の対の追加テキストが続き、 ルート・タグと共に表示されます。

デフォルト値はブランクです。

タイム・スタンプ・コメントの抑制

プロパティー タイプ 意味
タイム・スタンプ・コメントの抑制 チェック・ボックス 選択すると、 XML 出力内のタイム・スタンプ・コメント・ストリングが抑制されます。

選択しないと、コメントは抑制されず、出力メッセージ内に以下の形式のコメントが含まれます。 <!--MRM Generated XML Output on: Tue Apr 23 09:34:42 2002>

デフォルトでは、このチェック・ボックスは選択されています。

バージョン・サポートを使用可能にする

プロパティー タイプ 意味
バージョン・サポートを使用可能にする チェック・ボックス これを選択すると、バージョン・サポートが使用可能になります。 このプロパティーは、メッセージ内のルート・タグの XML ネーム・スペース定義と共に、 デフォルトのネーム・スペースに属さないエレメントのネーム・スペース修飾子をコード化するかどうかを指定します。 これらのネーム・スペース定義は、メッセージ・セットの依存関係を表すために使用されます。 これは同じメッセージ・セットを異なる形式にカスタマイズするときに、 アプリケーション間でメッセージ交換ができるようにするために使用されます。

初期のリリースの MRM XML メッセージとの互換性を確保するため、 デフォルトでは、このチェック・ボックスは選択されています。 初期のリリースで MRM XML メッセージを使用しなかった 場合には、 このチェック・ボックスを選択しないでください。

ブール値の XML 表記

プロパティー タイプ 意味
ブールの True 値 ストリング ブールの True 値をエンコードして認識するために使用するストリングを指定します。 XML 文書を解析する時には、 ストリング 1 が常に BOOLEAN エレメントの True として受け入れられます。 254 文字までストリングを入力します。

デフォルトは true です。 1 も有効です。

ブールの False 値 ストリング ブールの False 値をエンコードして認識するために使用するストリングを指定します。 XML 文書を解析する時には、 ストリング 0 が常に BOOLEAN エレメントの False として受け入れられます。 254 文字までストリングを入力します。

デフォルトは false です。 0 も有効です。

ヌル値の XML 表記

プロパティー タイプ 意味
数値のヌルのエンコード方式 列挙タイプ 数値 XML エレメントのヌル・エンコード方式を指定します。 これは、論理ヌルの意味をそれらのエレメントに割り当てる方法を提供します。 ドロップダウン・リストから以下のいずれかの値を選択しなければなりません。
  • NULLEmpty。エレメント値が空ストリングの場合、エレメントはヌルです。 これはデフォルト値です。
  • NULLValue。エレメント値が、関連したプロパティー「ヌル数値の値のエンコード」で提供された値に一致する場合、エレメントはヌルです。
  • NULLXMLSchema。 エレメントに、true に評価される xsi:nil 属性が含まれる場合、エレメントはヌルです。
  • NULLValueAttribute。 このオプションは、XML ワイヤー・フォーマット・プロパティー「レンダー」が XMLElementAttrVal または XMLElementAttrIDVal に設定されているエレメントの場合に限り有効です。 詳細については、XML ヌルの処理に関するオプションを参照してください。
  • NULLAttribute (推奨されない)。 エレメント値に、関連したプロパティー「ヌル数値の値のエンコード」で提供されたものと一致する名前を持つ属性が含まれており、その属性が true に評価される場合、エレメントはヌルです。
  • NULLElement (推奨されない)。 エレメント値に、関連したプロパティー「ヌル数値の値のエンコード」で提供されたものと一致する名前を持つ子エレメントが含まれている場合、エレメントはヌルです。
詳細については、XML ヌルの処理に関するオプションを参照してください。
ヌル数値の値のエンコード ストリング ヌル数値のエンコード」プロパティーを NULLValueNULLAttribute、または NULLElement に設定している場合に、このプロパティーを修飾する値を指定します。 詳細については、XML ヌルの処理に関するオプションを参照してください。
非数値のヌルのエンコード方式 列挙タイプ 非数値 XML エレメントのヌル・エンコード方式を指定します。 これは、論理ヌルの意味をそれらのエレメントに割り当てる方法を提供します。 このオプションは、プロパティー「ヌル数値のエンコード」で使用できるオプションと同じです。
ヌル非数値の値のエンコード ストリング ヌル非数値のエンコード」プロパティーを修飾する値を指定します。 詳細については、XML ヌルの処理に関するオプションを参照してください。

DateTime の設定

プロパティー タイプ 意味
論理タイプからデフォルトの日時形式を導出します。 ボタン このオプションは、エレメントまたは属性の論理タイプによってデフォルトの日時形式が決定されるようにする場合に選択します。 デフォルトは、以下のとおりです。
dateTime
yyyy-MM-dd'T'HH:mm:ssZZZ
date
yyyy-MM-dd
time
HH:mm:ssZZZ
gYear
yyyy
gYearMonth
yyyy-MM
gMonth
--MM--
gMonthDay
--MM-dd
gDay
---dd

複合タイプ内のエレメントまたは属性用のこのプロパティーをオーバーライドすることができます。

デフォルトの日時形式を使用 ボタンおよび日時 このオプションは、論理タイプ dateTime、date、time、gYear、gYearMonth、gMonth、gMonthDay、および gDay のすべてのエレメントまたは属性に固定されたデフォルトの日付形式を指定する場合に選択します。

このプロパティーの初期値は yyyy-MM-dd'T'HH:mm:ssZZZ です。 上書きすることにより、この値を変更することができます。

複合タイプ内のエレメントまたは属性用のこのプロパティーをオーバーライドすることができます。

日時形式の詳細については、DateTime 形式を参照してください。

2 桁の年の世紀の開始 整数 このプロパティーは、2 桁の年の解釈方法を決定します。 現在の年を含む 100 年枠が開始する最初の 2 桁を指定します。 例えば、89 を指定し、現在の年が 2002 の場合、2 桁の日付すべてが 1989 から 2088 の範囲内にあると解釈されます。

初期値は 53 です。上書きすることにより、この値を変更することができます。

年間の最初の週の日数 列挙タイプ 新年の最初の週に含まれる日数を指定します。

通常、一年は週の途中から始まります。 その週の日数がここで指定されている値より小さい場合、その週は前の年の最終週と見なされ、したがって、第 1 週は新年の何日か後に開始します。 大きい場合、これは新年の最初の週と見なされ、したがって、第 1 週は新年の何日か前に開始します。

「ブローカーのロケールを使う」を選択すると、ブローカーが、基礎となっているプラットフォームから情報を入手します。 またはドロップダウン・リストから番号を選択することができます。 初期値は、4 です。

週の最初の曜日 列挙タイプ 各週の最初の曜日を指定します。

「ブローカーのロケールを使う」 を選択すると、ブローカーが、基礎となっているプラットフォームから情報を入手します。 またはドロップダウン・リストから値を選択することができます。 初期値は、「月曜日」です。

厳密な DateTime 検査 チェック・ボックス このオプションは、日時を有効な日時形式に制約する場合に選択します。 これにより、3 月 35 日が 4 月 4日として、また 10:79 が 11:19 として処理されることはなくなります。 「厳密な日時検査」が設定されている場合、誤った日時を受け取るとエラーが発生します。 デフォルトでは日時を制約するようになっています
厳密な dateTime 検査
厳密な日時検査の例を以下に示します。
  • 日時は有効な日時のみに制限されます。 これにより、例えば 3 月 35 日が 4 月 4 日として、また 10:79 が 11:19 として日付処理されることはなくなります。 これらの例のような規定外の日時を受け取ると、エラーが発生します。
  • 数値 dateTime コンポーネントの文字数は、対応するフォーマット・シンボルの範囲内でなければなりません。 必要な最小桁数を指定するには、シンボルを複数繰り返します。許容される最大桁数は、特定のシンボルの上限です。例えば、月の日付の上限は 31 であるため、d の書式制御ストリングでは値 2 または 21 を構文解析できますが、値 32 または 210 は使用できません。 出力時には、指定された長さになるまで数値にゼロが埋め込まれます。年は特別なケースであり、「2 桁の年の世紀の開始」プロパティーのメッセージ・プロパティー・セットを参照してください。 秒の端数の場合、長さは入力上のフォーマット・シンボルの数と暗黙に一致していなければなりません。 出力は指定された長さに丸められます。
  • 空白文字はスキップオーバーされません。入力ストリング内の空白文字は、書式制御ストリング内の空白文字と同じ数、同じ位置で対応していなければなりません。
  • 書式制御ストリング内のすべてのシンボルへの突き合わせが終わった後に、入力ストリング内にまだ解析していないデータがある場合には、エラーが発生します。
寛容な日時検査
寛容な日時検査の例を以下に示します。
  • パーサーは、規定外の日時値を適切な規定内の値に変換します。 例えば、2005-05-32 という日付は 2005-06-01 に変換されます。
  • 日時の出力は、常にシンボル・カウントに従います。 例えば、yyyy-MM-dd (ここで「-」はフィールド分離文字) の書式制御ストリングでは、MM と dd に対して 1 文字以上の文字の解析が可能になります。 これにより、2005-1-123 や 2005-011-12 のような無効な日付を入力することが可能になります。 最初の値 2005-1-123 は、日付 2005-05-03 として出力され、2 番目の値 2005-011-12 は、日付 2005-11-12 として出力されます。
  • タイム・ゾーン・フォーマット・シンボル Z の数は、出力日時フォーマットのみに適用されます。
  • 空白文字はスキップオーバーされます。
タイム・ゾーン 列挙タイプ このプロパティーに設定した値は、「デフォルトの DateTime 形式」プロパティーに指定した値に「タイム・ゾーン」情報が含まれていない場合に使用されます。

初期値は 「ブローカーのロケールを使う」で、ブローカーが基礎となっている プラットフォームから情報を取得します。

ドロップダウン・ボックスを使用してこの値を変更することができます。

夏時間 チェック・ボックス このオプションは、「タイム・ゾーン」プロパティーの地域で夏時間調整が行われている場合に選択します。夏時間調整時間を順守しない場合には、このオプションを選択しないでください。

例えば、「タイム・ゾーン」である地域が選択された場合で、このオプションが 選択されていない場合には、渡される値は夏時間調整を行わないタイム・ゾーンを表します。

デフォルトでは、夏時間調整時間を採用しません。

出力時に入力 UTC 形式を使用 チェック・ボックス このプロパティーは、I、IU、T、または TU の日時形式を持っているか、または ZZZ か ZZZU を含むかのいずれかである論理タイプ xsd:dateTime または xsd:time のエレメントおよび属性に適用されます。

そうしたエレメントおよび属性では、Z 文字またはタイム・ゾーン +00:00 のいずれかを値で使用することにより、統合世界時 (UTC) を指定できます。 入力時に MRM パーサーは、UTC がどのように指定されたかを記憶します。

このプロパティーにチェック・マークが付いていて、エレメントまたは属性が出力メッセージにコピーされる場合には、UTC 形式が出力メッセージに保存され、「日時形式」プロパティーにより暗黙的に示される形式をオーバーライドします。

このプロパティーにチェック・マークが付いていないか、エレメントまたは属性が入力メッセージからコピーされなかった場合には、出力メッセージの UTC 形式は「日時形式」プロパティーのみにより制御されます。

デフォルトでは、このプロパティーはチェック・マークが付いていません。

xsi:type 出力ポリシー

プロパティー タイプ 意味
xsi:type 属性の出力ポリシー 列挙タイプ

XML 文書を作成する際に、このプロパティーにより、エレメントの xsi:type 属性が出力される環境を指定できます。

しない
xsi:type 属性がメッセージ・ツリーに表示されていても、エレメントの xsi:type 属性を出力しません。
存在する時
xsi:type 属性がメッセージ・ツリーにある場合に限り、エレメントの xsi:type 属性を出力します。
常時 (単純エレメントのみ)
xsi:type 属性を持つすべての単純エレメントを出力するようにします。 単純エレメントがすでにメッセージ・ツリーに xsi:type 属性を持っている場合、それが使用されます。そうでない場合、以下の表の規則を使用して、xsi:type 属性が生成されます。
常時 (すべてのエレメント)
xsi:type 属性を持つすべてのエレメントを出力するようにします (それが可能な場合)。 エレメントがすでにメッセージ・ツリーに xsi:type 属性を持っている場合、それが使用されます。そうでない場合、以下の表の規則を使用して、xsi:type 属性が生成されます。
SOAP エンコード規則に従う
常時 (単純なエレメントのみ) と同じ動作に従います。 さらに、すべてのメッセージの root タグ内にある SOAP エンコード方式スタイルの属性を出力します。

xsi:type 属性を出力する必要があっても、それがメッセージ・ツリーにない場合は、以下のように、その値が生成されます。

エレメント・タイプ エレメントがモデルで定義されている場合に生成される値 エレメントが自己定義している場合に生成される値
単純タイプ

タイプがグローバルまたはビルトイン・タイプの場合は、それを使用します。

タイプがローカルの場合、その派生元のグローバルまたはビルトイン・タイプを使用します。

メッセージ・ツリー内のエレメントのデータ・タイプに最も一致するビルトイン・タイプを使用します。
単純内容を持つ複合タイプ

タイプがグローバルの場合、これを使用します。

タイプがローカルの場合、その派生元のグローバルまたはビルトイン・タイプを使用します。

メッセージ・ツリー内のエレメントのデータ・タイプに最も一致するビルトイン・タイプを使用します。
複合内容を持つ複合タイプ

タイプがグローバルの場合、これを使用します。

タイプがローカルの場合、xsi:type 属性は出力されません。

xsi:type 属性は出力されません。
関連概念
MRM ドメイン内の物理形式
XML ワイヤー形式
XML ワイヤー形式: xsi:type 属性の処理
XML ワイヤー形式: 論理モデルとの関係
関連タスク
物理プロパティーでの作業
関連資料
メッセージ・セットのプロパティー
カスタム・ワイヤー形式メッセージ・セットのプロパティー
インライン DTD および「DOCTYPE テキスト」プロパティー
TDS 形式メッセージ・セットのプロパティー
すべてのメッセージ・セット・オブジェクトの文書プロパティー
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ad09260_