Table ModuleConfiguration
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 présente les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Nom | Identificateur | O | N |
| Format | Integer | N | N |
| Type | Texte | N | O |
| ContextData | Texte | N | O |
| DefaultValue | Texte | N | O |
| Attributs | Integer | N | O |
| DisplayName | Texte | N | O |
| Description | Text | N | O |
| HelpLocation | Texte | N | O |
| HelpKeyword | Texte | N | O |
Colonnes
-
Nom
-
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 de la colonne Valeur de la table ModuleSubstitution.
-
Format
-
Cette colonne spécifie le format des données en cours de modification.
Format Valeur Text 0 Clé 1 Integer 2 Format de champ de bits 3 -
Type
-
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 de la valeur 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 au format « Clé », cette valeur est au format spécial CMSM. Pour tous les autres types, la valeur est traitée littéralement.
Les auteurs de module 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 bit 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 Decimal Valeur hexadécimale 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 remplies une fois toutes les options de configuration terminées.
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 toute 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 les types de format d’entier ou les 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 demande que l’outil de création n’expose pas cette propriété dans l’interface utilisateur. L’outil peut ignorer la valeur dans 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 langue du module. Il est possible que cette colonne soit vide.
-
HelpLocation
-
Cette colonne fournit le nom d’un fichier d’aide (sans l’extension .chm) ou une liste d’espaces de noms d’aide délimités par des points-virgules. 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 une mot clé dans le fichier d’aide ou l’espace de noms de la colonne HelpLocation. L’interprétation de ce mot clé dépend de la colonne HelpLocation. Il est possible que cette colonne soit vide.
Notes
La table ModuleConfiguration est utilisée par des 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, les tables ModuleConfiguration et ModuleSubstitution doivent être ajoutées à la table ModuleIgnoreTable de chaque module.
Validation