Procédure : utilisation des profils d'agent de réplication (programmation RMO)
Les profils d'agent de réplication sont utilisés pour définir les valeurs par défaut lors de la création d'un travail d'agent. Chaque agent possède un profil par défaut, tandis que certains ont des profils prédéfinis supplémentaires. Vous pouvez créer des profils définis par l'utilisateur à l'aide des objets de gestion de réplication (RMO, Replication Management Objects). Pour plus d'informations sur les profils, consultez Profils de l'Agent de réplication.
Pour créer un profil d'agent
Créez une connexion avec le serveur de distribution en utilisant une instance de la classe ServerConnection.
Créez une instance de la classe AgentProfile.
Définissez les propriétés suivantes de l'objet :
Name - nom du profil.
AgentType- une valeur AgentType qui spécifie le type d'agent de réplication pour lequel le profil est créé.
ConnectionContext- le ServerConnection créé dans l'étape 1.
(Facultatif) Description - une description du profil.
(Facultatif) Default- définit cette propriété sur true si tous les nouveaux travaux d'agent pour ce AgentType utiliseront ce profil par défaut.
Appelez la méthode Create pour créer le profil sur le serveur.
Une fois que le profil existe sur le serveur, vous pouvez le personnaliser en ajoutant, en supprimant ou en modifiant les valeurs des paramètres de l'agent de réplication.
Pour assigner le profil à un travail d'agent de réplication existant, appelez la méthode AssignToAgent. Passez le nom de la base de données de distribution pour distributionDBName et l'ID du travail pour agentID.
Pour modifier un profil d'agent existant
Créez une connexion avec le serveur de distribution en utilisant une instance de la classe ServerConnection.
Créez une instance de la classe ReplicationServer. Passez l'objet ServerConnection créé dans l'étape 1.
Appelez la méthode LoadProperties. Si cette méthode retourne false, vérifiez que le serveur de distribution existe.
Appelez la méthode EnumAgentProfiles. Passez une valeur AgentType pour limiter les profils retournés à un type spécifique d'agent de réplication.
Obtenez l'objet AgentProfile souhaité à partir du ArrayListretourné, où la propriété Name de l'objet correspond au nom de profil.
Appelez l'une des méthodes suivantes de AgentProfile pour modifier le profil :
AddParameter- ajoute un paramètre pris en charge au profil, où name est le nom du paramètre d'agent de réplication et value la valeur spécifiée. Pour énumérer tous les paramètres d'agent pris en charge pour un type d'agent donné, appelez la méthode EnumParameterInfo. Cette méthode retourne un ArrayList des objets AgentProfileParameterInfo qui représentent tous les paramètres pris en charge.
RemoveParameter- supprime un paramètre existant du profil, où name est le nom du paramètre d'agent de réplication. Pour énumérer tous les paramètres d'agent actuels définis pour le profil, appelez la méthode EnumParameters. Cette méthode retourne un ArrayList des objets AgentProfileParameter qui représentent le paramètre existant de ce profil.
ChangeParameter- modifie le paramètre d'un paramètre existant du profil, où name est le nom du paramètre d'agent et newValue la nouvelle valeur du paramètre. Pour énumérer tous les paramètres d'agent actuels définis pour le profil, appelez la méthode EnumParameters. Cette méthode retourne un ArrayList des objets AgentProfileParameter qui représentent le paramètre existant de ce profil. Pour énumérer toutes les valeurs des paramètres d'agent pris en charge, appelez la méthode EnumParameterInfo. Cette méthode retourne un ArrayList des objets AgentProfileParameterInfo qui représentent les valeurs prises en charge pour tous les paramètres.
Pour supprimer un profil d'agent
Créez une connexion avec le serveur de distribution en utilisant une instance de la classe ServerConnection.
Créez une instance de la classe AgentProfile. Définissez le nom du profil pour Name et le ServerConnection à partir de l'étape 1 de ConnectionContext.
Appelez la méthode LoadProperties. Si cette méthode retourne false, le nom spécifié était incorrect ou le profil n'existe pas sur le serveur.
Vérifiez que la propriété Type a la valeur User, ce qui indique un profil de client. Vous ne devez pas supprimer un profil qui a une valeur de System pour Type.
Appelez la méthode Remove pour supprimer le profil défini par l'utilisateur représenté par cet objet du serveur.