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 les façons de mettre en œuvre le code de connexion MongoDB :

• Copiez et collez le code dans un fichier de votre projet cible.
• Utilisez un module d’activités personnalisé et le fichier exemple

Lorsque vous choisissez d'utiliser le fichier exemple, NUPKGvous avez la possibilité d'ajouter l'authentification à deux facteurs comme activité dans vos XAML fichiers.

Astuce :

Que vous choisissiez d'intégrer le code de connexion MongoDB dans vos fichiers CS (pour les automatisations codées) ou dans vos fichiers XAML (pour les automatisations low-code), n'oubliez pas que vous pouvez invoquer une automatisation codée dans une automatisation low-code et vice versa. 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 de disposer d'UiPath Studio (version 2024.10 ou ultérieure - recommandée).
2. Assurez-vous que vous disposez d'un compte MongoDB Atlas.
3. Installez le package MongoDB.DriverNuGet 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 l'accord de licence et les dépendances.

Option 1 : copier et coller le code dans les CSfichiers

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

Remarque :

L'exemple de code se connecte à MongoDB Atlas à l'aide du format de string 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

• nom d'utilisateur : l'utilisateur de base de données que vous avez créé dans MongoDB Atlas
• mot de passe : le mot de passe de votre utilisateur de base de données
• cluster : votre nom d'hôte de cluster depuis la chaîne de connexion (par exemple, cluster0.abc123.mongodb.net)

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

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

• Découvre automatiquement tous les nœuds dans votre cluster
• Fournit une prise en charge automatique du basculement
• Inclut une logique de réessayer pour les opérations d'écriture ()
• Définit la préoccupation d'écriture sur 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 est indisponible
• Exceptions générales : détecte toutes les autres erreurs liées à MongoDB

Option 2 : utiliser un module d’activités personnalisé et l’exemple NUPKG de fichier

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

1. Téléchargez le NUPKGfichier.
2. Chargez le fichier téléchargé NUPKG dans votre flux d'hôte Orchestrator ou de locataire qui est accessible via votre instance de Studio.Pour de plus amples informations sur le téléchargement du NUPKG fichier en tant que bibliothèque personnalisée dans Orchestrator, reportez-vous à 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.SampleNUPKG que vous avez précédemment enregistré dans votre flux Hôte d'Orchestrator ou Locataire d'Orchestratr et installez-le.

Figure 1. Bibliothèque personnalisée dans le menu Gérer les Packages

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

Figure 2. Activité GetDatabases dans le panneau Activités