Utilizzo di componenti qualificati

I componenti qualificati sono un metodo di riferimento indiretto e possono essere usati per raggruppare i componenti con funzionalità parallele in categorie.

Per restituire il percorso completo e installare un componente completo, chiamare MsiProvideQualifiedComponent o MsiProvideQualifiedComponentEx.

Per enumerare tutti i qualificatori di componente qualificati e le stringhe descrittive, chiamare MsiEnumComponentQualifiers.

Raggruppare i componenti in una categoria di componenti qualificati

  1. Nella tabella Component deve essere presente un record per ogni componente incluso nella nuova categoria di componenti qualificati. Creare i campi nella tabella Componente come per i componenti ordinari. Si noti che ogni componente qualificato deve avere un GUID ID componente univoco immesso nella colonna ComponentId della tabella Component.
  2. Generare una stringa di testo qualificatore per ogni componente qualificato. Il qualificatore deve essere una stringa di testo univoca che può essere facilmente generata durante la ricerca di un componente qualificato. Ad esempio, se i componenti della categoria sono qualificati in base alla lingua, l'identificatore delle impostazioni locali numeriche (LCID) è una stringa di qualificatore ragionevole.
  3. Aggiungere un record nella tabella PublishComponent per ogni componente qualificato. Immettere gli identificatori di componente qualificato dalla colonna Component della tabella Component nella colonna Component_ della tabella PublishComponent. Immettere le stringhe di qualificatore per ogni componente qualificato nella colonna Qualificatore. Immettere una stringa localizzata da visualizzare all'utente e descrivere il componente qualificato nella colonna Facoltativa AppData. Nel campo AppData deve essere inserita una stringa esplicativa, ad esempio "Dizionario francese", anziché solo l'LCID numerico. Immettere il nome della funzionalità che usa questo componente nella colonna Feature_. L'identificatore di funzionalità in questo campo deve essere elencato anche nella colonna Funzionalità della tabella Feature.
  4. Generare un GUID di categoria per questa categoria di componenti qualificati. Deve essere un GUID valido. Se si usa un'utilità come GUIDGEN per generare il GUID, assicurarsi che contenga solo lettere maiuscole. Per ogni componente qualificato in questa categoria, immettere il GUID della categoria nel campo ComponentId della tabella PublishComponent.

Nell'esempio seguente viene illustrato come viene creata la categoria "Modelli FAX" dei componenti qualificati nelle tabelle Component, Feature e PublishComponent.

Tabella PublishComponent

Componentid Qualifier AppData Funzionalità_ Componente_
{GUID categoria modello FAX} 1033 Modello inglese (Stati Uniti) FAXTemplate FAXTemplateENU
  1041 Modello giapponese FAXTemplate FAXTemplateJPN
  1054 Modello thai FAXTemplate FAXTemplateTHA
  1031 Modello tedesco FAXTemplate FAXTemplateDEU

 

Tabella dei componenti (tabella parziale)

Componente Componentid
FAXTemplateENU GUID del componente {Modello FAX (Inglese DEGLI Stati Uniti) }
FAXTemplateJPN {GUID del componente modello FAX (giapponese) }
FAXTemplateTHA GUID del componente {MODELLO FAX (Thai) }
FAXTemplateDEU {GUID del componente modello FAX (tedesco) }

 

Tabella delle funzionalità (tabella parziale)

Funzionalità
FAXTemplate
FAXTemplate
FAXTemplate
FAXTemplate