Guide pratique pour installer un adaptateur de données de diagnostic personnaliséHow to: Install a custom diagnostic data adapter

Si vous avez créé un adaptateur de données de diagnostic personnalisé ou qu'un tel adaptateur vous a été fourni, vous pouvez installer votre assembly d'adaptateur de données de diagnostic en copiant le fichier d'assembly correspondant dans le répertoire approprié de votre ordinateur local.If you have created a custom diagnostic data adapter, or you have been provided with a custom diagnostic data adapter to use, you can install your diagnostic data adapter assembly by copying the assembly file for it into the correct directory on your local machine.

Si vous souhaitez employer votre adaptateur de données de diagnostic personnalisé pour un rôle dans un environnement, vous devez l'installer sur tous les ordinateurs exécutant des agents de test qui sont susceptibles d'être utilisés pour ce rôle.If you want to use your custom diagnostic data adapter for a role in an environment, you must install your diagnostic data adapter on all the machines that run test agents that can be used for this role.

Utilisez la procédure suivante pour installer votre adaptateur de diagnostic personnalisé dans les emplacements appropriés.Use the following procedure to install your custom diagnostic adapter in the appropriate locations. Vous devez disposer d'autorisations d'administration sur l'ordinateur où vous installez l'adaptateur de données de diagnostic.You will need administrative permissions on any machine where you install the diagnostic data adapter.

Installer un adaptateur de données de diagnostic personnaliséInstall a custom diagnostic data adapter

Pour installer un adaptateur de données de diagnostic personnaliséTo install a custom diagnostic data adapter

  1. Pour utiliser l’adaptateur de données de diagnostic lorsque vous exécutez des tests sur votre ordinateur client ou sur un ordinateur agent, copiez tous les fichiers de votre répertoire de build vers le répertoire suivant sur l’ordinateur cible en fonction du chemin d’accès d’installation :To use the diagnostic data adapter when you run tests on your client machine or on an agent machine, copy all files from your build directory to the following directory on the target machine based on the installation path:

    %ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\PrivateAssemblies\DataCollectors%ProgramFiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\PrivateAssemblies\DataCollectors

    Fichiers à copier :The files to copy are:

    • Assembly d’adaptateur de données de diagnostic (.dll) (obligatoire)The diagnostic data adapter assembly (.dll) (required).

    • Fichier de données de débogage (.pdb) pour votre adaptateur (facultatif)The debug data file (.pdb) for your adapter (optional).

    • Fichier de configuration pour votre adaptateur (<diagnostic data adapter name>.dll.config), si vous avez des paramètres de configuration par défaut (facultatif)The configuration file for your adapter (<diagnostic data adapter name>.dll.config), if you have default configuration settings (optional).

    • Assembly de l'éditeur de configuration, si vous l'avez créé, pour modifier les paramètres de configuration de l'adaptateur (facultatif)The configuration editor assembly if you have created one to edit configuration settings for the adapter (optional). Cela concerne uniquement les ordinateurs clients.This is only for client machines. Les ordinateurs agents n'utilisent pas l'éditeur.Agent machines do not use the editor.

    Note

    Bien que votre adaptateur de données de diagnostic et votre éditeur de configuration puissent être créés dans le même projet et générés dans le même assembly, vous pouvez utiliser des projets distincts et créer des assemblys séparés, si tel est votre choix.Although your diagnostic data adapter and your configuration editor can be created in the same project and built into the same assembly, you can use separate projects and create separate assemblies for them, if you prefer.

    Pour plus d’informations sur la configuration de vos paramètres de test pour l’utilisation d’un environnement durant l’exécution de vos tests, consultez Collecter les données de diagnostic dans les tests manuels (Azure Test Plans).For more information about how to configure your test settings to use an environment when you run your tests, see Collect diagnostic data in manual tests (Azure Test Plans).

  2. Pour sélectionner votre adaptateur de données de diagnostic pour un test, vous devez d’abord sélectionner les paramètres d’un test existant, ou en créer un à partir de Test Manager ou de Visual Studio, puis sélectionner votre adaptateur de données de diagnostic sous l’onglet Données et diagnostics des paramètres du test sélectionné.To select your diagnostic data adapter for a test, you must first select an existing test settings or create a new one from Microsoft Test Manager or Visual Studio and then select your diagnostic data adapter on the Data and Diagnostics tab of the selected test settings.

  3. Si vous avez créé et installé un éditeur de configuration d’adaptateur de données de diagnostic, choisissez Configurer en regard de votre adaptateur et apportez les éventuelles modifications nécessaires afin de configurer ce dernier pour vos paramètres de test.If you have created and installed a diagnostic data adapter configuration editor, to configure your diagnostic data adapter for your test settings, choose Configure next to your adapter and make any changes. Choisissez ensuite Enregistrer.Then choose Save. Pour plus d’informations sur la création d’un éditeur de configuration pour votre collecteur de données de diagnostic, consultez Guide pratique pour créer un éditeur personnalisé pour les données de votre adaptateur de données de diagnostic.For more information about how to create a configuration editor for your diagnostic data collector, see How to: Create a custom editor for data for your diagnostic data adapter.

  4. Si vous exécutez vos tests à partir de Microsoft Test Manager, vous pouvez affecter ces paramètres de test à votre plan de test avant d’exécuter vos tests, ou utiliser la commande Exécuter avec des options pour affecter et remplacer des paramètres de test.If you are running your tests from Microsoft Test Manager, you can assign these test settings to your test plan before you run your tests or use the Run with Options command to assign test settings and override test settings. Pour plus d’informations sur les paramètres de test, consultez Collecter des informations de diagnostic à l’aide des paramètres de test.For more information about test settings, see Collect diagnostic information using test settings.

    Si vous exécutez vos tests à partir de Visual Studio, vous devez définir ces paramètres de test comme étant actifs.If you are running your tests from Visual Studio, you must set these test settings to be active. Pour plus d’informations sur les paramètres de test, consultez Collecter des informations de diagnostic à l’aide des paramètres de test.For more information about test settings, see Collect diagnostic information using test settings.

  5. Exécutez vos tests à l'aide des paramètres de test, en sélectionnant l'adaptateur de données de diagnostic.Run your tests using the test settings with the diagnostic data adapter selected.

Voir aussiSee also