Partager via

Utilisation de composants qualifiés

  • Article

Les composants qualifiés sont une méthode d’indirection et peuvent être utilisés pour regrouper des composants avec des fonctionnalités parallèles en catégories.

Pour renvoyer le chemin d’accès complet et installer un composant qualifié, appelez MsiProvideQualifiedComponent ou MsiProvideQualifiedComponentEx.

Pour énumérer tous les qualificateurs de composants qualifiés et les chaînes descriptives, appelez MsiEnumComponentQualifiers.

Pour regrouper des composants dans une catégorie de composants qualifiés

  1. Il doit y avoir un enregistrement dans la table Composant pour chaque composant inclus dans la nouvelle catégorie de composants qualifiés. Créez les champs de la table Composant de la même façon que pour les composants ordinaires. Notez que chaque composant qualifié doit avoir un GUID d’ID de composant unique entré dans la colonne ComponentId de la table Composant.
  2. Générez une chaîne de texte de qualificateur pour chaque composant qualifié. Le qualificateur doit être une chaîne de texte unique qui peut être facilement générée lors de la recherche d’un composant qualifié. Par exemple, si les composants de la catégorie sont qualifiés par la langue, l’identificateur de paramètres régionaux numériques (LCID) est une chaîne de qualificateur raisonnable.
  3. Ajoutez un enregistrement dans la table PublishComponent pour chaque composant qualifié. Entrez les identificateurs de composant qualifié de la colonne Composant de la table Component dans la colonne Component_ de la table PublishComponent. Entrez les chaînes de qualificateur pour chaque composant qualifié dans la colonne Qualificateur. Entrez une chaîne localisée à afficher pour l’utilisateur et décrivant le composant qualifié dans la colonne AppData facultative. Une chaîne d’explication doit être placée dans le champ AppData, par exemple « Dictionnaire français », plutôt que simplement dans le LCID numérique. Entrez le nom de la fonctionnalité qui utilise ce composant dans la colonne Feature_. L’identificateur de fonctionnalité dans ce champ doit également être répertorié dans la colonne Fonctionnalité de la table Fonctionnalité.
  4. Générez un GUID de catégorie pour cette catégorie de composants qualifiés. Il doit s’agir d’un GUID valide. Si vous utilisez un utilitaire tel que GUIDGEN pour générer le GUID, assurez-vous qu’il contient uniquement des lettres majuscules. Pour chaque composant qualifié de cette catégorie, entrez le GUID de catégorie dans le champ ComponentId de la table PublishComponent.

L’exemple suivant montre comment la catégorie « Modèles de FAX » des composants qualifiés est créée dans les tables Composant, Fonctionnalité et PublishComponent.

Table PublishComponent

ComponentId Qualificateur AppData Feature_ Component_
{GUID de catégorie de modèle FAX} 1033 Modèle anglais us FAXTemplate FAXTemplateENU
  1041 Modèle japonais FAXTemplate FAXTemplateJPN
  1054 Modèle thaïlandais FAXTemplate FAXTemplateTHA
  1031 Modèle allemand FAXTemplate FAXTemplateDEU

 

Table Composant (table partielle)

Composant ComponentId
FAXTemplateENU {GUID du composant de modèle FAX (anglais américain)}
FAXTemplateJPN {GUID du composant de modèle FAX (japonais)}
FAXTemplateTHA {GUID du composant de modèle FAX (thaïlandais)}
FAXTemplateDEU {GUID du composant de modèle FAX (allemand)}

 

Table Fonctionnalité (table partielle)

Fonctionnalité
FAXTemplate
FAXTemplate
FAXTemplate
FAXTemplate