ModuleConfiguration-Tabelle

  • Artikel

Die ModuleConfiguration-Tabelle enthält die konfigurierbaren Attribute des Moduls. Diese Tabelle wird nicht mit der Datenbank zusammengeführt.

Die ModuleConfiguration-Tabelle umfasst die folgenden Spalten.

Spalte Typ Schlüssel Nullwerte zulässig
Name Identifier J N
Format Integer N N
type Text N J
ContextData Text N J
DefaultValue Text N J
Attribute Integer N J
DisplayName Text N J
BESCHREIBUNG Text N J
HelpLocation Text N J
HelpKeyword Text N J

 

Spalten

Name

Dieses Feld definiert den Namen des konfigurierbaren Elements. Auf diesen Namen wird in der Formatierungsvorlage in der Wertespalte der ModuleSubstitution-Tabelle verwiesen.

Format

Diese Spalte gibt das Format der zu ändernden Daten an.

Format Wert
Text 0
Schlüssel 1
Integer 2
Bitfeldformat 3

 

Type

Diese Spalte gibt den Typ der zu ändernden Daten an. Dieser Typ wird zur Bereitstellung eines Kontexts für eine Benutzerschnittstelle verwendet und kommt beim Mergeprozess nicht zum Einsatz. Die gültigen Werte für diese Spalte richten sich nach dem Wert in der Formatspalte.

ContextData

Diese Spalte gibt einen semantischen Kontext für die angeforderten Daten an. Der Typ wird zur Bereitstellung eines Kontexts für eine Benutzerschnittstelle verwendet und kommt beim Mergeprozess nicht zum Einsatz. Die gültigen Werte für diese Spalte richten sich nach den Werten in den Format- und Typspalten.

DefaultValue

Diese Spalte gibt einen Standardwert für das Element in diesem Datensatz an, wenn das Mergetool die Angabe eines Werts abgelehnt hat. Dieser Wert muss das Format, den Typ und den Kontext des Elements aufweisen. Wenn es sich um ein Element im Schlüsselformat handelt, muss es sich bei dem Fremdschlüssel um einen gültigen Schlüssel für die Tabellen des Moduls handeln. Je nach Element kann NULL ein gültiger Wert für diese Spalte sein. Für Elemente im Schlüsselformat ist dies ein Wert im CMSM-Spezialformat. Alle anderen Typen werden als Literalwert behandelt.

Modulautoren müssen sicherstellen, dass das Modul in seinem Standardzustand gültig ist. Dadurch wird sichergestellt, dass Mergemod.dll-Versionen vor Version 2.0 das Modul weiterhin im Standardzustand verwenden können.

Attributes

Diese Spalte ist ein Bitfeld, das Attribute für das konfigurierbare Element enthält. NULL ist gleichbedeutend mit 0. Alle weiteren Bits in dieser Spalte sind für die zukünftige Verwendung reserviert und müssen 0 sein.

Name Decimal Hexadezimal BESCHREIBUNG
msmConfigurableOptionKeyNoOrphan 1 0x00000001 Dieses Attribut gilt nur für Datensätze, die im zugehörigen DefaultValue-Feld einen Fremdschlüssel zu einer Modultabelle enthalten. Das Mergetool ignoriert das Attribut für alle Formate, die nicht den Schlüsselformattypen entsprechen. Elemente, die nicht in der ModuleSubstitution-Tabelle aufgeführt sind, werden von der folgenden Überprüfung ausgeschlossen. Das Mergetool führt die mit der DefaultValue-Spalte referenzierte Zeile nicht mit der Zieldatenbank zusammen, wenn nach Abschluss aller Konfigurationsoptionen die folgenden Bedingungen erfüllt sind.
Für jede Zeile in der ModuleConfiguration-Tabelle mit identischem „DefaultValue“ ist „msmConfigurationItemsKeyNoOrphan“ festgelegt.
„DefaultValue“ wird in keiner Zeile verwendet, weil das Erstellungstool die Angabe eines Werts abgelehnt hat.
Das Mergetool führt die Zeile zusammen, wenn eine der folgenden Bedingungen erfüllt ist.
Das Mergetool ermittelt Zeilen, für die „msmConfigItemsKeyNoOrphan“ nicht festgelegt ist.
Das Mergetool ermittelt eine Zeile mit einem „DefaultValue“, weil das Erstellungstool die Angabe eines Werts abgelehnt hat.
msmConfigurableOptionNonNullable 2 0x00000002 Wenn dieses Attribut festgelegt ist, ist NULL keine gültige Antwort für dieses Element. Dieses Attribut hat keine Auswirkungen auf ganzzahlige Formattypen oder Bitfeldformattypen.

 

DisplayName

Diese Spalte enthält eine kurze Beschreibung des Elements, die das Erstellungstool in der Benutzeroberfläche verwenden kann. Diese Spalte ist möglicherweise nicht lokalisiert. Legen Sie diese Spalte auf NULL fest, um über das Modul anzufordern, dass das Erstellungstool diese Eigenschaft nicht in der Benutzeroberfläche verfügbar macht. Das Tool kann den Wert in diesem Feld ignorieren.

Description

Diese Spalte enthält eine Beschreibung des Elements, die das Erstellungstool in Elementen der Benutzeroberfläche verwenden kann. Diese Zeichenfolge kann durch die Sprachtransformation des Moduls lokalisiert werden. Diese Spalte kann NULL lauten.

HelpLocation

Diese Spalte enthält entweder den Namen einer Hilfedatei (ohne die Erweiterung „.chm“) oder eine durch Semikolon getrennte Liste von Hilfenamespaces. Diese Spalte kann NULL lauten, wenn keine Hilfe verfügbar ist. Diese Spalte kann nur NULL sein, wenn die HelpKeyword-Spalte den Wert NULL aufweist.

HelpKeyword

Diese Spalte gibt ein Schlüsselwort für die Hilfedatei oder den Namespace aus der HelpLocation-Spalte an. Die Interpretation dieses Schlüsselworts richtet sich nach der HelpLocation-Spalte. Diese Spalte kann NULL lauten.

Bemerkungen

Die ModuleConfiguration-Tabelle wird von konfigurierbaren Mergemodulen verwendet. Zum Erstellen eines konfigurierbaren Mergemoduls wird Mergemod.dll 2.0 oder höher benötigt.

Um die Kompatibilität mit älteren Mergemod.dll-Versionen zu gewährleisten, sollten die ModuleConfiguration-Tabelle und die ModuleSubstitution-Tabelle zur ModuleIgnoreTable-Tabelle jedes Moduls hinzugefügt werden.

Validierung

ICE03
ICE06
ICE25
ICE45