Configurer les connecteurs et les groupes

Les tâches suivantes sont présentées dans l'ordre dans lequel vous les exécuteriez pour configurer DB Connector pour votre organisation.

Créer des groupes de connecteurs

Vous pouvez créer plusieurs connecteurs et les regrouper pour assurer la redondance et la continuité en cas de défaillance de l'un des connecteurs. Vous pouvez également créer différents groupes de connecteurs pour des connecteurs qui servent à des fins différentes. Lorsque vous créez un DB Connector groupe, il apparaît également dans la DB Connector application sur le DB Connector serveur.

Si vous ne créez pas plusieurs connecteurs ou ne prévoyez pas d'utiliser plusieurs connecteurs pour le basculement, vous pouvez ignorer cette tâche en toute sécurité.

  1. Connectez-vous à CXone.
  2. Cliquez sur le sélecteur d'applications et sélectionnezACD.
  3. Accédez à ACD Configuration > DB Connectors.
  4. Cliquez sur New et sélectionnez DB Connector Groups.
  5. Entrez un Name et Description.
  6. Cliquez sur Create DB Group. Votre nouveau groupe apparaît dans l'arborescence de la liste du volet de gauche et apparaît également dans la liste déroulante Group lorsque vous créez des connecteurs. Vous avez également accès à d'autres onglets afin que vous puissiez configurer le groupe.
  7. Cliquez sur l'onglet Contacts.
  8. Cliquez sur Edit. Saisissez les coordonnées de la personne de votre entreprise qui devra être contactée en cas de faille d’un connecteur de base de données. Vous pouvez ajouter un Name, Email et Phone Number.
  9. Configurez le basculement et la priorité des connecteurs, si ce groupe nécessite ces options.
  10. Cliquez sur Done.

Créer des connecteurs

Lorsque vous créez un connecteur, il apparaît également dans la DB Connector application sur le DB Connector serveur.

  1. Connectez-vous à CXone.
  2. Cliquez sur le sélecteur d'applications et sélectionnezACD.
  3. Accédez à ACD Configuration > DB Connectors.
  4. Cliquez sur New et sélectionnez Database Connectors.
  5. Entrez un Name et Description.
  6. Pour Group , sélectionnez le groupe auquel ce connecteur doit être attribué à partir de la liste déroulante des groupes disponibles.
  7. Entrez une valeur numérique dans Thread Pool. Un groupe de fils est le nombre de tâches concurrentes (ou fils) qui s’exécutent en même temps. Ce paramètre peut être ajusté pour obtenir les meilleures performances. Un groupe de fils plus grand augmente l'utilisation des ressources mais peut engendrer des résultats plus rapides. La valeur par défaut est 50.
  8. Cliquez sur Create DB Connector.

Configuration du basculement du groupe de connecteurs et de la priorité des connecteurs

Une fois que plusieurs connecteurs ont été créés et affectés à un groupe de connecteurs, vous pouvez modifier le groupe pour configurer les propriétés de priorité et de basculement des connecteurs. Le basculement est une configuration facultative qui permet au système de basculer vers un connecteur différent en cas de défaillance du connecteur spécifié. La priorité des connecteurs indique au système quel connecteur doit recevoir les commandes par défaut et l'ordre dans lequel les connecteurs seront utilisés en cas de basculement.

Alors que les groupes de connecteurs sont le plus souvent utilisés pour plusieurs connecteurs qui fonctionnent ensemble pour la protection contre le basculement, vous pouvez utiliser des groupes pour organiser différents connecteurs qui sont utilisés à des fins similaires. Dans ce cas, vous ne devez pas configurer les propriétés de priorité des connecteurs ou de basculement pour le groupe de connecteurs.

Vous ne pouvez pas configurer de groupes si un ou plusieurs des connecteurs au sein de ce groupe est/sont enregistré(s). Vous devrez d'abord annuler l’enregistrement des connecteurs, configurer le groupe, puis ré-enregistrer les connecteurs.

  1. Connectez-vous à CXone.
  2. Cliquez sur le sélecteur d'applications et sélectionnezACD.
  3. Accédez à ACD Configuration > DB Connectors.
  4. Cliquer sur le groupe désiré dans la colonne Groups .
  5. Cliquez sur l'onglet Failover puis sur Edit.
  6. Cochez la case Allow Failover to next DB Connector in Group.
  7. Configurez le basculement :

    1. Sélectionnez l'option qui correspond à la manière dont vous souhaitez déclencher le comportement du relai. Vous pouvez choisir For all errors EXCEPT those listed below ou For only those errors listed below.
    2. Cliquez sur Nouveau pour ajouter une erreur.
    3. Saisissez le texte d'un Error depuis un fichier journal. Inclure le texte complet de l'erreur en commençant par le mot Exception, mais en excluant l'horodatage. Par exemple :

      Exception:Sql Action Failed - QueryType: SqlSelect - Query: SELECT Address1_line1 FROM ViewCustomerInfoUAT where phonenumber ='RESKILL' and rown = 1OleDbExceptionError converting data type varchar to bigint.System.Data.OleDb.OleDbException (0x80040E07): Error converting data type varchar to bigint

      Pour déclencher un basculement pour toute erreur de base de données, entrez Exception dans le champ Error . Toutes les erreurs de base de données commencent par ce mot.

    4. Cliquez sur Add.
    5. Lorsque vous avez terminé d’entrer les erreurs, cliquez sur Done.
  8. Configurez la priorité du connecteur : 
    1. Cliquez sur l'onglet Connector Priority puis sur Edit.
    2. Cliquez sur la flèche vers le haut Icône d'une flèche pointant vers le haut dans un cercle. ou vers le bas Icône d'une flèche pointant vers le bas dans un cercle. dans le champ Order pour modifier la position du connecteur dans la liste. Par défaut, les connecteurs d'un groupe sont utilisés dans l'ordre dans lequel ils ont été créés.
  9. Cliquez sur Done.

Configurez un Examen de santé du Connecteur

Vous pouvez éventuellement configurer des connecteurs pour tester leur connexion à la base de données toutes les 30 secondes. Cette «vérification de l'état» est une requête SQL que vous configurez (telle qu'une simple requête de sélection). Vous ne pouvez pas configurer une vérification de l'état d'un connecteur lorsqu'il est enregistré en tant que service Windows. Vous devrez soit configurer l’examen de santé avant d'enregistrer le connecteur, ou désenregistrer le connecteur puis le ré-enregistrer après que l’examen de santé de santé ait été configuré.

  1. Connectez-vous à CXone.
  2. Cliquez sur le sélecteur d'applications et sélectionnezACD.
  3. Accédez à ACD Configuration > DB Connectors.
  4. Cliquez sur le connecteur pour lequel vous voulez configurer un examen de santé et cliquez sur l’onglet Health Check.
  5. Cliquez sur Edit.
  6. Sélectionnez la case à cocher Enable 30 second interval Health Check .
  7. Dans le champ Query to run, entrez une requête SQL simple qui devra être exécutée à l'aide du DB connector.
  8. Cliquez sur Done.

Configurez la liaison de données du connecteur

Vous devez configurer les connecteurs et les groupes de connecteurs avant d'effectuer cette tâche dans la DB Connector application. Vous ne pouvez pas configurer les liaisons de données pour les connecteurs enregistrés. Si vous avez besoin de reconfigurer la liaison de données pour un connecteur en cours d'exécution, vous devez désactiver le connecteur, puis l'arrêter et enfin l'annuler dans la DB Connector application. Lorsque vous avez terminé votre configuration, inversez ces étapes pour remettre le connecteur en production: enregistrez-vous et démarrez le connecteur dans la DB Connector application, puis activez-la dans CXone.

  1. Exécutez l'application DBCCFG en tant qu'administrateur sur le DB Connector serveur.
  2. Cliquez sur le connecteur que vous souhaitez configurer.
  3. Dans la boîte de dialogue Reminder to Activate, cliquez sur OK.
  4. Cliquez sur Configure au-dessus du champ Connection String.
  5. Dans la boîte de dialogue Data Link Properties , cliquez sur l’onglet Provider puis et cliquez sur le type de fournisseur pour votre base de données.
  6. Cliquez sur OK.

Enregistrer ou désenregistrer des connecteurs

Les connecteurs doivent être enregistrés pour s'exécuter en tant que services Windows sur le serveur DB Connector . Vous ne pouvez configurer aucun aspect d'un connecteur si celui-ci est enregistré. Vous pouvez désenregistrer un connecteur lorsque vous avez besoin de reconfigurer la liaison de données, le groupe de connecteurs, et ainsi de suite.

  1. Exécutez l'application DBCCFG en tant qu'administrateur sur le DB Connector serveur.
  2. Sélectionnez le connecteur que vous souhaitez enregistrer ou désenregistrer.
  3. Cliquez sur Register ou sur Unregister si le connecteur a déjà été enregistré précédemment.
  4. Dans la boîte de dialogue Reminder to Activate, cliquez sur OK.

Démarrer ou arrêter un connecteur

Une fois qu’un connecteur a été configuré et enregistré, celui-ci doit être démarré pour transmettre des données. Vous pouvez également mettre le connecteur à l’arrêt le cas échéant pour apporter des modifications au niveau de la configuration ou le désinstaller.

Si vous souhaitez désinstaller DB Connector du DB Connector poste de travail, vous devez arrêter tous les connecteurs. Vous pouvez ensuite utiliser la fonctionnalité Programmes et fonctionnalités de Windows pour supprimer l'application.

  1. Exécutez l'application DBCCFG en tant qu'administrateur sur le DB Connector serveur.
  2. Cliquez sur le connecteur vous voulez démarrer ou arrêter.
  3. Cliquez sur Start ou sur Stop si le connecteur est déjà en cours d'exécution.

Activer ou désactiver un connecteur

Les connecteurs ne peuvent pas être utilisés dans Studio scripts jusqu'à ce qu'ils soient activés.

  1. Connectez-vous à CXone.
  2. Cliquez sur le sélecteur d'applications et sélectionnezACD.
  3. Accédez à ACD Configuration > DB Connectors.
  4. Cliquez sur le connecteur que vous souhaitez activer ou désactiver.
  5. Cliquez sur Activate, ou sur Deactivate si le connecteur a déjà été activé précédemment.