Méthode Database.CreateTransformSummaryInfo

La méthode CreateTransformSummaryInfo de l’objet Database crée et remplit le flux d’informations récapitulatives d’un fichier de transformation existant. Cette méthode remplit les propriétés avec la base et la référence ProductCode et ProductVersion.

Syntaxe

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

Paramètres

reference

Base de données requise qui n’inclut pas les modifications.

storage

Le nom du fichier de transformation généré. Ce paramètre est facultatif.

errorConditions

Conditions d’erreur requises qui doivent être supprimées lorsque la transformation est appliquée. Combinez une ou plusieurs des valeurs de condition d’erreur suivantes.

Nom de la condition d’erreur	Signification
msiTransformErrorNone 0	Aucune des conditions suivantes.
msiTransformErrorAddExistingRow 1	Ajoute une ligne déjà existante.
msiTransformErrorDeleteNonExistingRow 2	Supprime une ligne inexistante.
msiTransformErrorAddExistingTable 4	Ajoute une table déjà existante.
msiTransformErrorDeleteNonExistingTable 8	Supprime une table inexistante.
msiTransformErrorUpdateNonExistingRow 16	Met à jour une ligne inexistante.
msiTransformErrorChangeCodepage 32	Les pages de code de transformation et de base de données ne correspondent pas et aucune des pages de code n’est neutre.

validation

Obligatoire lorsque la transformation est appliquée à une base de données. Cela indique les propriétés qui doivent être validées pour vérifier que cette transformation peut être appliquée à la base de données. Les propriétés sont toutes contenues dans l’Ensemble de propriétés du flux d’informations récapitulatives.

Combinez une ou plusieurs des valeurs suivantes.

Indicateur de validation	Signification
msiTransformValidationNone 0	Aucune validation effectuée.
msiTransformValidationLanguage 1	La langue par défaut doit correspondre à la base de données de base.
msiTransformValidationProduct 2	Le produit doit correspondre à la base de données de base.

Pour valider la version du produit, choisissez d’abord un ou plusieurs de ces trois indicateurs pour indiquer l’étendue de la version à vérifier.

Indicateur de validation	Signification
msiTransformValidationMajorVer 8	Vérifie la version principale uniquement.
msiTransformValidationMinorVer 16	Vérifie uniquement les versions principales et mineures.
msiTransformValidationUpdateVer 32	Vérifie les versions principales, mineures et de mise à jour.

Choisissez ensuite l’une des options suivantes pour indiquer la relation requise entre la version de produit de la base de données à laquelle la transformation est appliquée et celle de la base de données de base.

Indicateur de validation	Signification
msiTransformValidationLess 64	Version appliquée < version de base
msiTransformValidationLessOrEqual 128	Version appliquée <= version de base
msiTransformValidationEqual 256	Version appliquée = version de base
msiTransformValidationGreaterOrEqual 512	Version appliquée >= version de base
msiTransformValidationGreater 1 024	Version appliquée > version de base

Pour vérifier que la transformation est appliquée à un package ayant le UpgradeCode approprié, définissez l’indicateur suivant.

Indicateur de validation	Signification
msiTransformValidationUpgradeCode 2 048	Vérifie que la transformation est le UpgradeCode approprié.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Pour créer un flux d’informations récapitulatives pour une transformation, les propriétés ProductCode et ProductVersion doivent être définies dans les tables Property des bases de données de base et de référence. Si msiTransformValidationUpgradeCode est utilisé, la propriété UpgradeCode doit être définie dans les deux bases de données.

Configuration requise

Voir aussi

Transformations de base de données