Connexion à MongoDB Atlas avec des automatisations codées

Ce tutoriel montre comment vous connecter à une base de données MongoDB Atlas depuis vos automatisations codées UiPath. MongoDB Atlas est un service de base de données Cloud entièrement géré qui fournit une solution de base de données fiable et évolutive sans nécessiter d'installations locales.

Context

Voici comment mettre en œuvre le code de connexion MongoDB :

• Copiez-collez le code dans un fichier CS de votre projet cible.
• Utilisez un package d’activités personnalisé et l’exemple de fichier NUPKG

Lorsque vous choisissez d’utiliser l’exemple de fichier NUPKG , vous avez la possibilité d’ajouter l’authentification à deux facteurs en tant qu’activité dans vos fichiers XAML .

Astuce : que vous choisissiez d’intégrer le code de connexion MongoDB dans vos fichiers CS (pour les automatisations codées) ou dans les fichiers XAML (pour les automatisations low-code), n’oubliez pas que vous pouvez invoquer une automatisation codée den low-code et inversement . Pour plus d’informations sur les automatisations hybrides, consultez Création d’automatisations hybrides - Combinaison de workflows codés et low-code.

Prérequis

1. Assurez-vous d'avoir UiPath Studio.
2. Assurez-vous d'avoir un compte MongoDB Atlass.
3. Installez le paquet NuGet MongoDB.Driver dans votre projet.
   1. Ouvrez votre projet UiPath dans Studio.
   2. Dans le ruban Conception , accédez à Gérer les packages.
   3. Sélectionnez Tous les packages ou l'onglet .NET .
   4. Recherchez MongoDB.Driver .
   5. Sélectionnez MongoDB.Driver, puis sélectionnez Installer.
   6. Acceptez le contrat de licence et les dépendances.

Option 1 : copier et coller le code dans CS fichiers

Pour utiliser la connexion MongoDB Atlas dans votre automatisation codée, vous pouvez copier et coller l’exemple de code suivant dans un fichier CS à partir de votre projet cible. Assurez-vous que l'espace de noms du fichier correspond à celui du nom de votre projet.

Remarque : l'exemple de code se connecte à MongoDB Atlas à l'aide du format de chaîne de connexion spécifique aux déploiements cloud. Assurez-vous de remplacer les informations d'identification de l'espace réservé par vos informations d'identification MongoDB Atlas réelles.

using System;
using System.Collections.Generic;
using System.Data;
using UiPath.CodedWorkflows;
using UiPath.Core;
using UiPath.Core.Activities.Storage;
using MongoDB.Driver;

namespace MongoDBCodedWorkflowsSample
{
    public class TestConnection : CodedWorkflow
    {
        [Workflow]
        public string Execute(string username, string password, string cluster)
        {
            List<string> databaseNames = new List<string>();
        try
            {
                // Create MongoDB Atlas connection string
                string connectionString = $"mongodb+srv://{username}:{password}@{cluster}/?retryWrites=true&w=majority";
                Console.WriteLine("Connecting to MongoDB Atlas...");
                // Initialize MongoDB client
                var client = new MongoClient(connectionString);
                // List all databases to verify connection
                Console.WriteLine("\nAvailable databases:");
                databaseNames = client.ListDatabaseNames().ToList();
                foreach (var dbName in databaseNames)
                {
                    Console.WriteLine($"- {dbName}");
                }
                Console.WriteLine("\nConnection successful!");
            }
            catch (MongoAuthenticationException authEx)
            {
                Console.WriteLine($"Authentication error: {authEx.Message}");
                Console.WriteLine("Please verify your username and password.");
                throw;
            }
            catch (MongoConnectionException connEx)
            {
                Console.WriteLine($"Connection error: {connEx.Message}");
                Console.WriteLine("Please check your network access settings in MongoDB Atlas.");
                throw;
            }
            catch (Exception ex)
            {
                Console.WriteLine($"MongoDB connection error: {ex.Message}");
                throw;
            }
            return databaseNames;
        }
    }
}

Paramètres de connexion

• username: l'utilisateur de la base de données que vous avez créé dans MongoDB Atlas
• password: le mot de passe de votre utilisateur de la base de données
• cluster: le nom d'hôte de votre cluster à partir de la chaîne cluster0.abc123.mongodb.net connexion

L'exemple renvoie une liste de toutes les bases de données pour cet ensemble spécifique d'informations d'identification.

Format de chaîne de connexion - MongoDB Atlas utilise le protocole mongodb+srv:// , qui :

• Découvrez automatiquement tous les nœuds de votre cluster
• Prend en charge le basculement automatique
• Inclut une logique de nouvelle tentative pour les opérations d’écriture (retryWrites=true)
• Définit le problème d’écriture sur la majorité (w=majority)

Gestion des erreurs

• MongoAuthenticationException: se produit lorsque les informations d'identification sont incorrectes
• MongoConnectionException: se produit lorsque l'accès au réseau est bloqué ou que le cluster n'est pas disponible
• Exceptions générales: détecte toutes les autres erreurs liées à MongoDB

Option 2 : utilisez un package d'activités personnalisé et l'exemple de fichier NUPKG

L'utilisation d'un exemple de fichier NUPKG vous permet d'inclure le code à deux facteurs dans vos automatisations.

1. Téléchargez le fichier NUPKG .
2. Chargez le NUPKG fichier téléchargé dans votre flux d’ hôte ou de locataire Orchestrator , qui est accessible via votre instance de Studio. Pour plus d’informations sur le téléchargement du fichier NUPKG en tant que bibliothèque personnalisée vers Orchestrator, consultez Téléchargement manuel d’une bibliothèque dans Orchestrator.
3. Ouvrez votre projet Studio et ouvrez le menu Gérer les packages.
4. Recherchez le fichier MongoDB.Coded.Workflows.Sample NUPKG que vous avez précédemment enregistré dans votre flux Orchestrator Host ou Orchestrator Tenant et installez-le.
   Figure 1. Bibliothèque personnalisée dans le menu Gérer les packages
   

   

   
   
5. Après avoir installé le fichier, accédez au panneau Activités et localisez MongoDB.Coded.Workflows.Sample. Glissez-déposez l'activité GetDatabases dans vos fichiers XAML pour tester votre connexion MongoDB et récupérer une liste des bases de données disponibles.
   Image 2. Activité GetDatabases dans le panneau Activités