Liaison avec un fichier Lisezmoi

Cette rubrique explique comment utiliser la console Administration de BizTalk Server ou la ligne de commande pour ajouter un fichier Readme.htm qui apparaîtra lorsque l'utilisateur cliquera sur un lien sous Ajouter ou supprimer des programmes dans le Panneau de configuration.

Lorsque vous installez une application BizTalk, un lien vers un fichier intitulé Readme.htm est automatiquement créé sous Ajouter ou supprimer des programmes dans le Panneau de configuration. Si un fichier Readme.htm existe dans le dossier d'installation de l'application, un utilisateur a la possibilité de l'ouvrir en cliquant sur le lien « Cliquez ici pour des informations de support » qui apparaît sous le nom de l'application, puis en cliquant sur « "%BTAD_InstallDir%\Readme.htm » (%BTAD_InstallDir% est une variable d'environnement représentant le dossier d'installation de l'application).

Pour que le lien vers le fichier Readme.htm fonctionne à partir de Ajouter ou Supprimer des programmes dans le Panneau de configuration, procédez comme suit :

  • Attribuez un nom au fichier Readme.htm.

  • Lorsque vous ajoutez Readme.htm à votre application, indiquez le dossier d'installation de l'application comme emplacement de destination du fichier (voir étape 6 ci-dessous). Le dossier par défaut d'installation de l'application est %ProgramFiles%\Generated by BizTalk\ApplicationName. Vous pouvez exprimer ce chemin d'accès sous la forme %BTAD_InstallDir%.

    Si vous souhaitez remplacer un fichier Readme.htm existant déjà dans l'application, précisez l'option de remplacement. Si vous ne spécifiez pas cette option et qu'un fichier existe déjà dans l'application, l'opération d'ajout échouera.

Notes

Si vous installez plusieurs fichiers .msi pour cette application, et sélectionnez un chemin d'installation différent pour chaque fichier .msi, le fichier Readme.htm inclus dans le dernier fichier .msi installé sera ouvert lorsque l'utilisateur cliquera sur le lien Readme dans Ajouter ou supprimer des programmes.

Important

Si vous ne créez pas de fichier Readme et ne l'ajoutez pas à votre application comme décrit dans cette rubrique, rien ne se passera lorsque l'utilisateur cliquera sur le lien Readme.

Prérequis

Pour exécuter la procédure décrite dans cette rubrique, vous devez être connecté avec un compte membre du groupe d'administrateurs BizTalk Server. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk.

Pour ajouter un fichier Readme à une application

Utilisation de la console Administration de BizTalk Server

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft BizTalk Server 20xxxx, puis cliquez sur BizTalk Server Administration.

  2. Dans l’arborescence de la console, développez BizTalk Server Administration et le groupe BizTalk contenant l’application à laquelle vous souhaitez ajouter un fichier Readme.htm.

  3. Développez Applications et l’application à laquelle vous souhaitez ajouter un fichier Readme.htm.

  4. Cliquez avec le bouton droit sur le dossier Ressources , pointez sur Ajouter, puis cliquez sur Ressources.

  5. Cliquez sur Ajouter, sélectionnez le fichier Readme.htm, puis cliquez sur Ouvrir.

  6. Dans Emplacement de destination, le chemin d’accès complet du dossier d’installation de l’application est spécifié par défaut, comme suit : %BTAD_InstallDir%\Readme.htm. Vous ne devez pas modifier ce chemin. Si le chemin correct vers le dossier d'installation de l'application n'est pas indiqué, le fichier n'y sera pas copié lors de l'installation, et le lien ne fonctionnera pas.

  7. Lorsque vous avez terminé, cliquez sur OK.

Utilisation de la ligne de commande

  1. Ouvrez une invite de commandes comme suit : cliquez sur Démarrer, sur Exécuter, tapez cmd, puis cliquez sur OK.

  2. Tapez la commande suivante en utilisant les valeurs appropriées, comme décrit dans le tableau suivant :

    BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :File [/Overwrite] /Source :value [/Destination :value] [/Server :value] [/Database :value]

    Exemple :

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:File /Overwrite /Source:"C:\Readme Files\MyApplication\Readme.htm" /Destination:%BTAD_InstallDir%\Readme.htm" /Server:MyServer /Database:BizTalkMgmtDB

    Paramètre Valeur
    /Applicationname Nom de l'application BizTalk à laquelle ajouter le fichier Readme. Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut. Si le nom inclut des espaces, vous devez le placer entre guillemets doubles (« ).
    /Type System.BizTalk:File (cette valeur ne tient pas compte de la casse.)
    /Écraser Option permettant de remplacer un fichier existant. Si cette option n'est pas spécifiée et qu'un fichier, dont le nom est le même que celui du fichier à ajouter, existe déjà dans l'application, l'opération AddResource échoue.
    /Source Chemin d'accès complet du fichier source, nom du fichier inclus. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles (").
    /Destination %BTAD_InstallDir%\Readme.htm.

    Chemin d'accès complet au dossier d'installation de l'application et au fichier Readme.htm, qui est également le dossier dans lequel sera copié le fichier Readme.htm lors de l'installation. En l'absence de ce chemin d'accès, le fichier n'est pas copié dans le dossier d'installation de l'application et le lien Readme.htm dans Ajouter ou supprimer des programmes ne fonctionnera pas.
    /Serveur Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk. Obligatoire si vous spécifiez le paramètre Database. S'il n'est pas indiqué, l'hôte local est utilisé. Si les paramètres Database et Server ne sont pas spécifiés, la base de données de gestion BizTalk du groupe par défaut est utilisée.
    /Base Nom de la base de données de gestion BizTalk. Obligatoire si vous spécifiez le paramètre Server. Si les paramètres Database et Server ne sont pas spécifiés, la base de données de gestion BizTalk du groupe par défaut est utilisée.

Voir aussi

Création et modification des applications BizTalk
Commande AddResource : fichier