ModuleConfiguration Table
La table ModuleConfiguration identifie les attributs configurables du module. Cette table n’est pas fusionnée dans la base de données.
La table ModuleConfiguration contient les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Nom | identificateur | Y | N |
| Format | entier | N | N |
| Type | texte | N | Y |
| ContextData | texte | N | Y |
| DefaultValue | texte | N | Y |
| Attributs | entier | N | Y |
| DisplayName | texte | N | Y |
| Description | texte | N | Y |
| HelpLocation | texte | N | Y |
| HelpKeyword | texte | N | Y |
Colonnes
-
nom de
-
Ce champ définit le nom de l’élément configurable. Ce nom est référencé dans le modèle de mise en forme dans la colonne Valeur de la table moduleSubstitution .
-
format de
-
Cette colonne spécifie le format des données en cours de modification.
Format Valeur texte 0 clé 1 entier 2 format de champ de bits 3 -
type de
-
Cette colonne spécifie le type des données en cours de modification. Ce type est utilisé pour fournir un contexte pour n’importe quelle interface utilisateur et n’est pas utilisé dans le processus de fusion. Les valeurs valides pour cette colonne dépendent de la valeur de la colonne Format.
-
ContextData
-
Cette colonne spécifie un contexte sémantique pour les données demandées. Le type est utilisé pour fournir un contexte pour n’importe quelle interface utilisateur et n’est pas utilisé dans le processus de fusion. Les valeurs valides pour cette colonne dépendent des valeurs des colonnes Format et Type.
-
DefaultValue
-
Cette colonne spécifie une valeur par défaut pour l’élément de cet enregistrement si l’outil de fusion refuse de fournir une valeur. Cette valeur doit avoir le format, le type et le contexte de l’élément. S’il s’agit d’un élément de format « Clé », la clé étrangère doit être une clé valide dans les tables du module. Null peut être une valeur valide pour cette colonne en fonction de l’élément. Pour les éléments de format « Key », cette valeur est au format CMSM spécial. Pour tous les autres types, la valeur est traitée littéralement.
Les auteurs de modules doivent s’assurer que le module est valide dans son état par défaut. Cela garantit que les versions de Mergemod.dll antérieures à la version 2.0 peuvent toujours utiliser le module dans son état par défaut.
-
attributs
-
Cette colonne est un champ de bits contenant des attributs pour cet élément configurable. Null équivaut à 0. Tous les autres bits de cette colonne sont réservés à une utilisation ultérieure et doivent être 0.
Nom Décimal Hexadécimal Description msmConfigurableOptionKeyNoOrphan 1 0x00000001 Cet attribut s’applique uniquement aux enregistrements qui répertorient une clé étrangère à une table de module dans leur champ DefaultValue. L’outil de fusion ignore l’attribut pour tous les formats autres que les types de format de clé . Les éléments non répertoriés dans la table ModuleSubstitution sont exclus de la vérification suivante. L’outil de fusion ne fusionne pas la ligne référencée par la colonne DefaultValue dans la base de données cible si les conditions suivantes sont satisfaites après avoir terminé toutes les options de configuration.
Chaque ligne de la table ModuleConfiguration avec le même DefaultValue a le msmConfigurationItemsKeyNoOrphan défini.
Aucune ligne n’utilise DefaultValue, car l’outil de création a refusé de fournir une valeur.
L’outil de fusion fusionne la ligne si l’une des conditions suivantes est remplie.
L’outil de fusion recherche une ligne qui n’a pas msmConfigItemsKeyNoOrphan définie.
Si l’outil de fusion trouve une ligne à l’aide de DefaultValue, car l’outil de création a refusé de fournir une valeur.msmConfigurableOptionNonNullable 2 0x00000002 Lorsque cet attribut est défini, null n’est pas une réponse valide pour cet élément. Cet attribut n’a aucun effet pour types de format entier ou types de format de champ de bits. -
DisplayName
-
Cette colonne fournit une brève description de cet élément que l’outil de création peut utiliser dans l’interface utilisateur. Cette colonne peut ne pas être localisée. Définissez cette colonne sur Null pour que le module soit demandé que l’outil de création n’expose pas cette propriété dans l’interface utilisateur. L’outil peut ignorer la valeur de ce champ.
-
Description
-
Cette colonne fournit une description de cet élément que l’outil de création peut utiliser dans les éléments de l’interface utilisateur. Cette chaîne peut être localisée par la transformation de langage du module. Cette colonne peut être null.
-
HelpLocation
-
Cette colonne fournit le nom d’un fichier d’aide (sans l’extension .chm) ou une liste délimitée par des points-virgules d’espaces de noms d’aide. Cette colonne peut être null si aucune aide n’est disponible. Cette colonne ne peut être null que si la colonne HelpKeyword a la valeur Null.
-
HelpKeyword
-
Cette colonne fournit un mot clé dans le fichier d’aide ou l’espace de noms à partir de la colonne HelpLocation. L’interprétation de ce mot clé dépend de la colonne HelpLocation. Cette colonne peut être null.
Remarques
La table ModuleConfiguration est utilisée par modules de fusion configurables. Mergemod.dll 2.0 ou version ultérieure est nécessaire pour créer un module de fusion configurable.
Pour garantir la compatibilité avec les versions antérieures de Mergemod.dll, la table ModuleConfiguration et table ModuleSubstitution doivent être ajoutées à la table ModuleIgnoreTable de chaque module.
Validation