ModuleConfiguration テーブル
ModuleConfiguration テーブルでは、モジュールの構成可能な属性が識別されます。 このテーブルはデータベースにマージされません。
ModuleConfiguration テーブルには次の列があります。
Column | 種類 | キー | Nullable |
---|---|---|---|
名前 | Identifier | Y | N |
フォーマット | 整数 | N | N |
型 | [テキスト] | N | Y |
ContextData | テキスト | N | Y |
DefaultValue | テキスト | N | Y |
属性 | 整数 | N | Y |
DisplayName | テキスト | N | Y |
説明 | [テキスト] | N | Y |
HelpLocation | テキスト | N | Y |
HelpKeyword | テキスト | N | Y |
[列]
-
Name
-
このフィールドでは、構成可能な項目の名前を定義します。 この名前は、ModuleSubstitution テーブルの [値] 列の書式設定テンプレートで参照されます。
-
Format
-
この列では、変更されるデータの形式を指定します。
フォーマット 値 [テキスト] 0 キー 1 整数 2 ビットフィールド形式 3 -
Type
-
この列では、変更されるデータの型を指定します。 この型は、任意のユーザー インターフェイスのコンテキストを提供するために使用され、マージ プロセスでは使用されません。 この列の有効な値は、Format 列の値によって異なります。
-
ContextData
-
この列では、要求されたデータのセマンティック コンテキストを指定します。 型は、任意のユーザー インターフェイスのコンテキストを提供するために使用され、マージ プロセスでは使用されません。 この列の有効な値は、Format と Type 列の値によって異なります。
-
DefaultValue
-
この列では、マージ ツールによって値の指定が拒否された場合に、このレコード内の項目の既定値を指定します。 この値には、項目の形式、型、およびコンテキストが必要です。 これが "キー" 形式の項目の場合、外部キーは、モジュールのテーブルに対する有効なキーである必要があります。 null は、項目に応じて、この列の有効な値である場合があります。 "キー" 形式の項目の場合、この値は CMSM 特殊形式です。 その他のすべての型では、値はリテラルで処理されます。
モジュール作成者は、モジュールが既定の状態で有効であることを確かめる必要があります。 これにより、バージョン 2.0 より前のバージョンの Mergemod.dll でも確実にモジュールを既定の状態で使用できます。
-
Attributes
-
この列は、この構成可能な項目の属性を含むビット フィールドです。 null は 0 に相当します。 この列の他のすべてのビットは、将来使用するために予約されており、0 である必要があります。
名前 Decimal 16 進数 説明 msmConfigurableOptionKeyNoOrphan 1 0x00000001 この属性は、DefaultValue フィールドのモジュール テーブルに外部キーを一覧表示するレコードにのみ適用されます。 マージ ツールにより、キー形式の型以外の形式の属性は無視されます。 ModuleSubstitution テーブルに一覧表示されていない項目は、次のチェックから除外されます。 すべての構成オプションの完了後に次の条件が満たされた場合、マージ ツールによって、DefaultValue 列で参照される行がターゲット データベースにマージされません。
同じ DefaultValue を持つ ModuleConfiguration テーブルのすべての行には、msmConfigurationItemsKeyNoOrphan が設定されています。
作成ツールによって値の指定が拒否されたため、DefaultValue が使用される行はありません。
次のいずれかの条件が満たされている場合、マージ ツールによって行がマージされます。
マージ ツールにより、msmConfigItemsKeyNoOrphan が設定されていない行が検索されます。
作成ツールによって値の提供が拒否されたために、マージ ツールにより、DefaultValue を使用して行が検索された場合。msmConfigurableOptionNonNullable 2 0x00000002 この属性が設定されている場合、null はこの項目に対する有効な応答ではありません。 この属性は、整数形式の型やビットフィールド形式の型には影響しません。 -
DisplayName
-
この列には、作成ツールにより、ユーザー インターフェイスで使用される可能性のあるこの項目の簡単な説明が示されます。 この列はローカライズされない場合があります。 この列を null に設定すると、作成ツールが UI でこのプロパティを公開しないようにモジュールに要求されます。 このツールでは、このフィールドの値が無視される場合があります。
-
Description
-
この列には、作成ツールによって UI 要素で使用される可能性のあるこの項目の説明が示されます。 この文字列は、モジュールの言語変換によってローカライズされる場合があります。 この列は null である可能性があります。
-
HelpLocation
-
この列には、ヘルプ ファイルの名前 (.chm 拡張子なし) またはヘルプ名前空間のセミコロン区切りのリストが示されます。 ヘルプが使用できない場合、この列は null にすることができます。 この列は、HelpKeyword 列が null の場合にのみ null にすることができます。
-
HelpKeyword
-
この列には、HelpLocation 列からヘルプ ファイルまたは名前空間へのキーワードが示されます。 このキーワードの解釈は、HelpLocation 列によって異なります。 この列は null である可能性があります。
解説
ModuleConfiguration テーブルは、構成可能なマージ モジュールによって使用されます。 構成可能なマージ モジュールを作成するには、Mergemod.dll 2.0 以降が必要です。
以前のバージョンの Mergemod.dll との互換性を確保するには、ModuleConfiguration テーブルと ModuleSubstitution テーブルを、すべてのモジュールの ModuleIgnoreTable テーブル に追加する必要があります。
検証