Tabulka ModuleConfiguration
Tabulka ModuleConfiguration identifikuje konfigurovatelné atributy modulu. Tato tabulka není sloučena do databáze.
Tabulka ModuleConfiguration obsahuje následující sloupce.
Sloupec | Typ | Klíč | Nullable |
---|---|---|---|
Jméno | identifikátor | Y | N |
Formát | celočíselná | N | N |
Typ | textové | N | Y |
ContextData | textové | N | Y |
DefaultValue | textové | N | Y |
Atributy | celočíselná | N | Y |
DisplayName | textové | N | Y |
Popis | textové | N | Y |
HelpLocation | textové | N | Y |
HelpKeyword | textové | N | Y |
Sloupce
-
název
-
Toto pole definuje název konfigurovatelné položky. Tento název se odkazuje v šabloně formátování ve sloupci Hodnota tabulky ModuleSubstitution.
-
Formát
-
Tento sloupec určuje formát změněných dat.
Formát Hodnota textové 0 klíč 1 celočíselná 2 formátu bitových polí 3 -
typ
-
Tento sloupec určuje typ změněných dat. Tento typ slouží k poskytnutí kontextu pro jakékoli uživatelské rozhraní a nepoužívá se v procesu sloučení. Platné hodnoty pro tento sloupec závisí na hodnotě ve sloupci Formát.
-
ContextData
-
Tento sloupec určuje sémantický kontext požadovaných dat. Tento typ slouží k poskytnutí kontextu pro jakékoli uživatelské rozhraní a nepoužívá se v procesu sloučení. Platné hodnoty pro tento sloupec závisí na hodnotách ve sloupcích Formát a Typ.
-
DefaultValue
-
Tento sloupec určuje výchozí hodnotu položky v tomto záznamu, pokud nástroj pro sloučení odmítne zadat hodnotu. Tato hodnota musí mít formát, typ a kontext položky. Pokud se jedná o položku formátu "Klíč", musí být cizí klíč platným klíčem do tabulek modulu. Hodnota Null může být platná hodnota pro tento sloupec v závislosti na položce. U položek formátu "Klíč" je tato hodnota ve speciálním formátu CMSM. U všech ostatních typů se hodnota zachází doslova.
Autoři modulů musí zajistit, aby modul byl platný ve výchozím stavu. Tím zajistíte, že verze Mergemod.dll starší než verze 2.0 budou moct modul dál používat ve výchozím stavu.
-
atributy
-
Tento sloupec je bitové pole obsahující atributy pro tuto konfigurovatelnou položku. Hodnota Null je ekvivalentní hodnotě 0. Všechny ostatní bity v tomto sloupci jsou vyhrazeny pro budoucí použití a musí být 0.
Jméno Desetinný Šestnáctkový Popis msmConfigurableOptionKeyNoOrphan 1 0x00000001 Tento atribut se vztahuje pouze na záznamy, které v poli DefaultValue vypisují cizí klíč do tabulky modulu. Nástroj pro sloučení ignoruje atribut pro jakékoli jiné formáty než typy klíčových formátů. Položky, které nejsou uvedené v tabulce ModuleSubstitution, jsou vyloučené z následující kontroly. Slučovací nástroj nesloučí řádek odkazovaný sloupcem DefaultValue do cílové databáze, pokud jsou po dokončení všech možností konfigurace splněny následující podmínky.
Každý řádek v tabulce ModuleConfiguration se stejnou hodnotou DefaultValue má sadu msmConfigurationItemsKeyNoOrphan.
Žádné řádky nepoužívají hodnotu DefaultValue, protože nástroj pro tvorbu odmítl zadat hodnotu.
Slučovací nástroj sloučí řádek, pokud jsou splněny některé z následujících podmínek.
Nástroj pro sloučení najde libovolný řádek, který nemá sadu msmConfigItemsKeyNoOrphan.
Pokud slučovací nástroj najde libovolný řádek pomocí defaultValue, protože nástroj pro tvorbu odmítl zadat hodnotu.msmConfigurableOptionNonNullable 2 0x00000002 Pokud je tento atribut nastaven, null není platná odpověď pro tuto položku. Tento atribut nemá žádný vliv na Celočíselné typy formátu nebo typy formátu bitových polí. -
DisplayName
-
Tento sloupec obsahuje krátký popis této položky, kterou může nástroj pro tvorbu používat v uživatelském rozhraní. Tento sloupec nemusí být lokalizovaný. Nastavte tento sloupec na hodnotu null, aby modul byl požadován, aby nástroj pro tvorbu nezpřístupnil tuto vlastnost v uživatelském rozhraní. Nástroj může ignorovat hodnotu v tomto poli.
-
Popis
-
Tento sloupec obsahuje popis této položky, kterou nástroj pro tvorbu může používat v prvech uživatelského rozhraní. Tento řetězec může být lokalizován transformací jazyka modulu. Tento sloupec může mít hodnotu null.
-
HelpLocation
-
Tento sloupec obsahuje buď název souboru nápovědy (bez přípony .chm), nebo středník oddělený seznam oborů názvů nápovědy. Pokud není k dispozici žádná nápověda, může mít tento sloupec hodnotu null. Tento sloupec může mít hodnotu null pouze v případě, že sloupec HelpKeyword má hodnotu null.
-
HelpKeyword
-
Tento sloupec poskytuje klíčové slovo do souboru nápovědy nebo oboru názvů ze sloupce HelpLocation. Interpretace tohoto klíčového slova závisí na sloupci HelpLocation. Tento sloupec může mít hodnotu null.
Poznámky
Tabulku ModuleConfiguration používá konfigurovatelné slučovací moduly. Mergemod.dll 2.0 nebo novější se vyžaduje k vytvoření konfigurovatelného modulu sloučení.
Aby byla zajištěna kompatibilita se staršími verzemi Mergemod.dll, měla by být do tabulky ModuleIgnoreTable každého modulu přidána tabulka ModuleConfiguration a tabulka ModuleSubstitution.
Validace