Propriété TRANSFORMS

La propriété TRANSFORMS est une liste des transformations que le programme d’installation applique lors de l’installation du package. Le programme d’installation applique les transformations dans le même ordre qu’ils sont répertoriés dans la propriété . Les transformations peuvent être spécifiées par leur nom de fichier ou leur chemin complet. Pour spécifier plusieurs transformations, séparez chaque nom de fichier ou chemin d’accès complet par un point-virgule (;). Par exemple, pour appliquer trois transformations à un package, définissez TRANSFORMS sur une liste de noms de fichiers ou sur une liste de chemins d’accès complets.

TRANSFORMS=transform1.mst;transform2.mst;transform3.mst
TRANSFORMS=\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst;\\server3\share3\path3\transform3.mst

Vous pouvez indiquer qu’un fichier de transformation est incorporé dans un stockage du fichier .msi, plutôt qu’en tant que fichier autonome, en préfixant le nom du fichier avec deux points (:)). Par exemple, l’exemple suivant indique que transform1.mst et transform2.mst sont incorporés dans le fichier .msi et que transform3.mst est un fichier autonome.

TRANSFORMS=:transform1.mst;:transform2.mst;transform3.mst

Le programme d’installation nécessite les transformations répertoriées dans TRANSFORMS à chaque installation, publication, installation à la demande ou installation de maintenance du package. La stratégie TransformsSecure , la propriété TRANSFORMS et le premier caractère de la chaîne TRANSFORMS indiquent au programme d’installation comment gérer la résilience source des fichiers de transformation autonomes. Windows Installer traite la définition de la stratégie TransformsAtSource ou TRANSFORMSATSOURCE de la même façon que la stratégie TransformsSecure et TRANSFORMSSECURE. Notez que les transformations incorporées dans le fichier .msi ne sont pas mises en cache et sont toujours obtenues à partir du package.

Propriété TRANSFORMS Transforms Secure Mise en cache et résilience
@[list of filenames] Exemple :
@transform1.mst;transform2.mst; transform3.mst
Aucun effet. Transformations sécurisées à la source. La source des transformations doit se trouver à la racine de la source pour le package. Lorsque le package est installé ou publié, le programme d’installation enregistre les transformations sur l’ordinateur de l’utilisateur dans un cache où l’utilisateur n’a pas accès en écriture. Si la copie locale de la transformation devient indisponible, le programme d’installation recherche une source pour restaurer le cache. La méthode est identique à la recherche d’un fichier .msi dans la liste source. Consultez Résilience des sources.
[liste des chemins] Exemple:
\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst
Aucun effet. Transformations du chemin d’accès complet sécurisé. La source de chaque transformation doit se trouver au niveau du chemin d’accès complet passé à TRANSFORMS. La source de transformation n’a pas besoin d’être située à la source du package. Lorsque le package est installé ou publié, le programme d’installation enregistre les transformations sur l’ordinateur de l’utilisateur dans un cache où l’utilisateur n’a pas accès en écriture. Si la copie locale de la transformation devient indisponible, le programme d’installation peut uniquement restaurer le cache à partir de la source au chemin spécifié.
[liste des noms de fichiers] Le premier caractère n’est pas @ ou |.
Exemple :
transform1.mst;transform2.mst;transform3.mst
TransformsSecure policy ou TRANSFORMSSECURE défini sur 1 OR
Stratégie TransformsAtSource ou TRANSFORMSATSOURCE définie sur 1.
Si TRANSFORMS est une liste de noms de fichiers, le programme d’installation les traite comme des transformations sécurisées à la source. Si TRANSFORMS est une liste de chemins d’accès complets, le programme d’installation les traite comme des transformations Secure-Full-Path.
[liste des noms de fichiers] Le premier caractère n’est pas @ ou |.
Exemple :
transform1.mst;transform2.mst;transform3.mst
TransformsSecure policy et TRANSFORMSSECURE ne sont pas définis ET
La stratégie TransformsAtSource et TRANSFORMSATSOURCE ne sont pas définies.
Transformations non sécurisées. La source des transformations doit se trouver à la racine de la source pour le package. Lorsque le package est installé ou publié par utilisateur, le programme d’installation enregistre les transformations dans le profil de l’utilisateur. Cela permet à un utilisateur de se déplacer entre des ordinateurs tout en conservant ses personnalisations. Pour une installation par ordinateur, la transformation est enregistrée dans le dossier %windir%\Installer. Si la copie locale de la transformation devient indisponible, le programme d’installation recherche une source pour restaurer le cache. La méthode est identique à la recherche d’un fichier .msi dans la liste source. Consultez Résilience des sources.
[liste des chemins] Le premier caractère n’est pas @ ou |.
Exemple :
\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst
La stratégie TransformsAtSource et TRANSFORMSSECURE ne sont pas définies ET
La stratégie TransformsAtSource et TRANSFORMSSECURE ne sont pas définies ET
Transformations non sécurisées. Lorsque le package est installé ou publié par utilisateur, le programme d’installation enregistre les transformations dans le profil de l’utilisateur. Cela permet à un utilisateur de se déplacer entre des ordinateurs tout en conservant ses personnalisations. Pour une installation par ordinateur, la transformation est enregistrée dans le dossier %windir%\Installer. Si la copie locale de la transformation devient indisponible, le programme d’installation recherche une source pour restaurer le cache. La méthode est identique à la recherche d’un fichier .msi dans la liste source. Consultez Résilience des sources.

 

Vous ne pouvez pas utiliser ensemble des noms de fichiers et des chemins d’accès dans la même liste TRANSFORMS . Vous ne pouvez pas spécifier les transformations sécurisées et de profil dans la même liste. Vous pouvez inclure des transformations incorporées dans le package dans une liste avec d’autres transformations.

@transform1.mst;:transform2.mst 
|\\server\share\path\transform1.mst;:transform2.mst

Notez que, étant donné que le délimiteur de liste pour les transformations est le caractère point-virgule, les points-virgules ne doivent pas être utilisés dans un nom de fichier ou chemin de transformation.

Notes

Dans les cas où la stratégie TransformsSecure ou la propriété TRANSFORMSSECURE a été définie avec Windows Installer, il n’est pas nécessaire de passer le @ ou | symbole lors de la définition de TRANSFORMS à l’aide de la ligne de commande. Le programme d’installation suppose secure-at-source ou Secure-Full-Path si la liste se compose entièrement de noms de fichiers situés au niveau de la source ou se compose entièrement de chemins d’accès complets. Vous ne pouvez toujours pas mélanger les deux types de sources de transformation.

Notez que le programme d’installation utilise un ordre de recherche différent pour les transformations non sécurisées appliquées lors des premières installations et de maintenance. Pour plus d'informations, consultez Application de formules.

Configuration requise

Condition requise Valeur
Version
Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.

Voir aussi

Propriétés

Transformations de base de données

Fusions et transformations

Résilience de la source