Herstellen einer Verbindung zu MongoDB Atlas mit codierten Automatisierungen

Dieses Tutorial zeigt, wie Sie eine Verbindung zu einer MongoDB Atlas-Datenbank über Ihre für UiPath codierten Automatisierungen herstellen. MongoDB Atlas ist ein vollständig verwalteter Cloud-Datenbankdienst, der eine zuverlässige und skalierbare Datenbanklösung ohne lokale Installationen bietet.

Context

So können Sie den MongoDB-Verbindungscode implementieren:

• Kopieren Sie den Code und fügen Sie ihn in eine CS -Datei Ihres Zielprojekts ein.
• Verwenden Sie ein benutzerdefiniertes Aktivitätspaket und die Beispieldatei NUPKG

Wenn Sie sich für die Verwendung der Beispieldatei NUPKG entscheiden, können Sie die zweistufige Authentifizierung als Aktivität innerhalb Ihrer XAML -Dateien hinzufügen.

Tipp: Unabhängig davon, ob Sie den MongoDB-Verbindungscode in Ihre CS-Dateien (für codierte Automatisierungen) oder XAML-Dateien (für Low-Code-Automatisierungen integrieren) integrieren, denken Sie daran, dass Sie eine codierte Automatisierung in einer Low-Code-Automatisierung aufrufen können und umgekehrt . Weitere Informationen über hybride Automatisierungen finden Sie unter Erstellen hybrider Automatisierungen – Kombinieren von codierten und Low-Code-Workflows.

Voraussetzungen

1. Stellen Sie sicher, dass Sie über UiPath Studio (Version 2024.10 oder höher – empfohlen) verfügen.
2. Stellen Sie sicher, dass Sie über ein MongoDB Atlas-Konto verfügen.
3. Installieren Sie das MongoDB.Driver -NuGet-Paket in Ihrem Projekt.
   1. Öffnen Sie Ihr UiPath-Projekt in Studio.
   2. Wechseln Sie im Menüband Design zu Pakete verwalten.
   3. Wählen Sie Alle Pakete oder die Registerkarte .NET aus.
   4. Suchen Sie nach MongoDB.Driver .
   5. Wählen Sie MongoDB.Driver und dann Installieren aus.
   6. Akzeptieren Sie die Lizenzvereinbarung und Abhängigkeiten.

Option 1: Kopieren Sie den Code in CS -Dateien

Um die MongoDB Atlas-Verbindung in Ihrer codierten Automatisierung zu verwenden, können Sie den folgenden Beispielcode kopieren und in eine CS -Datei aus Ihrem Zielprojekt einfügen. Stellen Sie sicher, dass der Namespace der Datei mit dem Ihres Projektnamens übereinstimmt.

Hinweis: Der Beispielcode stellt eine Verbindung mit MongoDB Atlas über das für Cloud-Bereitstellungen spezifische Verbindungszeichenfolgenformat her. Ersetzen Sie die Platzhalter-Anmeldeinformationen durch Ihre tatsächlichen MongoDB Atlas-Anmeldeinformationen.

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;
        }
    }
}

Verbindungsparameter

• username: Der Datenbankbenutzer, den Sie in MongoDB Atlas erstellt haben
• password: Das Passwort für Ihren Datenbankbenutzer
• cluster: Ihr Cluster-Hostname aus der Verbindungszeichenfolge (z. B. cluster0.abc123.mongodb.net)

Das Beispiel gibt eine Liste aller Datenbanken für diesen spezifischen Satz von Anmeldeinformationen zurück.

Format der Verbindungszeichenfolge – MongoDB Atlas verwendet das mongodb+srv:// -Protokoll, das:

• Erkennt automatisch alle Knoten in Ihrem Cluster
• Bietet automatische Failover-Unterstützung
• Enthält Wiederholungslogik für Schreibvorgänge (retryWrites=true)
• Legt das Schreibanforderung auf meisten fest (w=majority)

Fehlerabwicklung

• MongoAuthenticationException: Tritt auf, wenn Anmeldeinformationen falsch sind
• MongoConnectionException: Tritt auf, wenn der Netzwerkzugriff blockiert ist oder der Cluster nicht verfügbar ist
• Allgemeine Ausnahmen: Fängt alle anderen MongoDB-bezogenen Fehler ab

Option 2: Verwenden eines benutzerdefinierten Aktivitätspakets und der Beispieldatei NUPKG

Mithilfe einer Beispieldatei vom Typ NUPKG können Sie den Code für die zweistufige Authentifizierung in Ihre Automatisierungen aufnehmen.

1. Laden Sie die NUPKG -Datei herunter.
2. Laden Sie die heruntergeladene NUPKG -Datei in Ihren Orchestrator-Host oder Mandanten -Feed hoch, auf die über Ihre Studio-Instanz zugegriffen werden kann. Weitere Informationen zum Hochladen der NUPKG -Datei als benutzerdefinierte Bibliothek in den Orchestrator finden Sie unter Manuelles Hochladen einer Bibliothek in Orchestrator.
3. Öffnen Sie Ihr Studio-Projekt und öffnen Sie das Menü Pakete verwalten.
4. Suchen Sie nach der Datei MongoDB.Coded.Workflows.Sample NUPKG, die Sie zuvor in Ihrem Orchestrator-Host- oder Orchestrator-Mandanten -Feed gespeichert haben, und installieren Sie sie.
   Abbildung 1. Benutzerdefinierte Bibliothek im Menü Pakete verwalten
   

   

   
   
5. Nachdem Sie die Datei installiert haben, navigieren Sie zum Bereich Aktivitäten und suchen Sie MongoDB.Coded.Workflows.Sample. Ziehen Sie die Aktivität GetDatabases in Ihre XAML -Dateien, um Ihre MongoDB-Verbindung zu testen und eine Liste der verfügbaren Datenbanken abzurufen.
   Abbildung 2. Aktivität GetDatabases im Bereich Aktivitäten