Déboguer un gestionnaire de logique métier (programmation de réplication)

Utilisez un gestionnaire de logique métier pour appeler une logique métier personnalisée lorsqu’un abonnement de fusion est synchronisé. Pour plus d’informations, consultez Exécuter la logique métier pendant la synchronisation de fusion.

Le Merge Replication Reconciler (replrec.dll) appelle l’assembly de code géré contenant la logique métier. Dans la plupart des cas, replrec.dll et la logique métier personnalisée est exécutée sur l’ordinateur sur lequel l’Agent de fusion s’exécute (sur l’Abonné pour un abonnement par extraction ou sur le serveur de distribution pour un abonnement Push). Dans le cas de la synchronisation web, ou dans le cas d’un abonné SQL Server Compact, le rapprochement et la logique métier personnalisée sont exécutés sur le serveur Web.

Pour déboguer un gestionnaire de logique métier sur un ordinateur local

1. Configurez la publication et la distribution, créez une publication et créez un abonnement à la publication. Pour plus d’informations, consultez Configurer la publication et la distribution et créer une publication.

2. Créez et inscrivez un gestionnaire de logique métier. Pour plus d’informations, voir Implémenter un gestionnaire de logique métier pour un article de fusion.

3. Créez un projet RMO (Replication Management Objects) dans Microsoft Visual Studio qui démarre l’agent de fusion de manière synchrone. Pour plus d’informations, consultez Synchroniser un abonnement par extraction.

4. Définissez un point d’arrêt dans le code du gestionnaire de logique métier, soit dans la méthode déboguée, soit dans le constructeur de classe. Pour plus d’informations sur les méthodes qui peuvent être implémentées dans un gestionnaire de logique métier, consultez la BusinessLogicModule rubrique méthodes.

5. Générez le gestionnaire de logique métier en mode débogage et déployez l’assembly et le fichier de symboles de débogage (.pdb) à l’emplacement inscrit à l’étape 1.

   Remarque

   Pour simplifier le débogage, créez une seule solution Visual Studio .NET qui contient à la fois le projet de gestionnaire de logique métier et le projet qui synchronise l’abonnement. Dans ce cas, définissez le projet de synchronisation comme projet de démarrage et configurez l’environnement de génération pour déployer l’assembly logique métier sur l’emplacement inscrit à l’étape 1 pendant le débogage.

6. Exécutez des commandes d’insertion, de mise à jour ou de suppression sur la base de données d’abonnement ou de publication. L’emplacement de commande et d’exécution dépend de la méthode en cours de débogage.

7. Démarrez le projet à partir de l'étape 3 en mode débogage pour synchroniser l’abonnement.

8. En supposant qu’aucun autre point d’arrêt n’est défini et que les commandes appropriées sont répliquées, l’exécution s’arrête lorsqu’elle atteint le point d’arrêt dans le gestionnaire de logique métier.

Pour déboguer un gestionnaire de logique métier sur un serveur Web à l’aide de la synchronisation web ou pour un abonné SQL Server Compact

1. Configurez la publication et la distribution, créez une publication et créez un abonnement par extraction à la publication. La publication doit prendre en charge la synchronisation web ou les abonnés SQL Server Compact.

2. Créez et inscrivez un gestionnaire de logique métier. Pour plus d’informations, voir Implémenter un gestionnaire de logique métier pour un article de fusion.

3. Définissez un point d’arrêt dans le code du gestionnaire de logique métier, soit dans la méthode déboguée, soit dans le constructeur de classe. Pour plus d’informations sur les méthodes qui peuvent être implémentées dans un gestionnaire de logique métier, consultez la BusinessLogicModule rubrique méthodes.

4. Générez le gestionnaire de logique métier en mode débogage et déployez l’assembly et le fichier de symboles de débogage (.pdb) sur le serveur Web à l’emplacement inscrit à l’étape 1.

   Remarque

   Si le gestionnaire de logique métier ne parvient pas à générer, car l’assembly est en cours d’utilisation, tapez la commande iisreset sur le serveur Web à l’invite de commandes pour réinitialiser le serveur Web.

5. Synchronisez l’abonnement avec la synchronisation web activée. Pendant la synchronisation, le serveur Web charge l'assemblage inscrit.

6. À l’aide du débogueur Visual Studio .NET, attachez-vous à l’un des processus suivants sur le serveur Web :

   • w3wp.exe - Windows Server 2003.

   • inetinfo.exe - Windows 2000 et Windows XP.

7. Dans la fenêtre Sortie, vérifiez la sortie de débogage pour s'assurer que les symboles de l'assembly enregistré ont bien été chargés. Si les symboles n’ont pas été chargés, vérifiez que le fichier .pdb correct a été copié à l’étape 4 et répétez l’étape 5.

8. Exécutez des commandes d’insertion, de mise à jour ou de suppression sur la base de données d’abonnement ou de publication. L’emplacement de commande et d’exécution dépend de la méthode en cours de débogage.

9. À l’aide du débogueur Visual Studio, joignez-vous au processus de w3wp.exe.

10. Synchronisez à nouveau l’abonnement à l’aide de la synchronisation web.

11. En supposant qu’aucun autre point d’arrêt n’est défini et que les commandes appropriées sont répliquées, l’exécution s’arrête lorsqu’elle atteint le point d’arrêt dans le gestionnaire de logique métier.

Voir aussi

Implémenter un gestionnaire de logique métier pour un article de fusion