WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

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

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

ネーム・スペースの設定

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

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

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

XML 宣言

プロパティー タイプ 意味
XML 宣言の抑制 チェック・ボックス XML 宣言を抑制するチェック・ボックスを選択します。 選択すると、宣言 (例えば、<?xml version='1.0'> など) が抑制されます。

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

XML バージョン 列挙タイプ これは、生成される XML 宣言内でバージョンの値を制御します。

デフォルトは 1.0 です。

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

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

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

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

デフォルトはヌルです。

「XML 宣言の抑制」チェック・ボックスが選択されていると、このプロパティーは無視されます。

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

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

「XML 宣言の抑制」チェック・ボックスが選択されていると、このプロパティーは無視されます。

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

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

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

XML 文書タイプの設定

プロパティー タイプ 意味
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 宣言を含めることができます。 これはストリング (最大 32 KB で、改行およびタブ文字はそれぞれ ¥n¥t に置き換えられます。

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

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

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

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

ブール値の 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、date、time、gYear、gYearMonth、gMonth、gMonthDay、および gDay のすべてのエレメントまたは属性に固定されたデフォルトの日時形式を指定する場合に選択します。

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

詳しくは、メッセージ・セット: DateTime 形式を参照してください。

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

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

「ブローカーのロケールを使う」を選択すると、ブローカーが、基礎となっているプラットフォームから情報を入手します。または表示されるリストから数を選択することができます。

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

「ブローカーのロケールを使う」を選択すると、ブローカーが、基礎となっているプラットフォームから情報を入手します。または表示されるリストから値を選択することができます。

厳密な日時検査 チェック・ボックス このオプションは、日時を有効な日時形式に制約する場合に選択します。 「厳密な日時検査」が選択されている場合、誤った日時を受け取るとエラーが発生します。
厳密な日時検査
厳密な日時検査の例を以下に示します。
  • 日時は有効な日時のみに制限されます。 このオプションを使用すると、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 出力内のタイム・スタンプ・コメント・ストリングが抑制されます。

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

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

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

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

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:46:32


参照トピック参照トピック | バージョン 8.0.0.5 | ad09260_