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

Hier finden Sie die Möglichkeiten zur Implementierung des MongoDB-Verbindungscodes:

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

Wenn Sie sich für die Verwendung der NUPKGBeispieldatei entscheiden, haben Sie die Möglichkeit, die Zwei-Faktor-Authentifizierung als Aktivität in Ihren XAMLDateien hinzuzufü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, denken Sie daran, dass Sie eine codierte Automatisierung in eine 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 UiPath Studio (Version 2024.10 oder höher – empfohlen) haben.
2. Stellen Sie sicher, dass Sie ein MongoDB-Atlas-Konto haben.
3. Installieren Sie das MongoDB.Driver NuGet-Paket in Ihrem Projekt.
   1. Öffnen Sie Ihr UiPath-Projekt in Studio.
   2. Gehen Sie im Design-Menüband 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 die Abhängigkeiten.

Option 1: Kopieren und Einfügen des Codes 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 Verbindungsformat her, das speziell für Cloud-Bereitstellungen ist.Stellen Sie sicher, dass Sie die Platzhalter-Anmeldeinformationen durch Ihre tatsächlichen MongoDB Atlas-Anmeldeinformationen ersetzen.

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

• Benutzername: Der Datenbankbenutzer, den Sie in MongoDB Atlas erstellt haben
• Kennwort: Das Kennwort für Ihren Datenbankbenutzer
• Cluster: Ihr Cluster-Hostname aus dem Verbindungsstring (z. B.cluster0.abc123.mongodb.net)

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

Verbindungsformat – 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 (wiederholen)
• Legt das Schreibkriterium auf Mehrheit fest (w=majority)

Fehlerabwicklung

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

Option 2: Verwenden Sie ein benutzerdefiniertes Aktivitätspaket und die BeispieldateiNUPKG

Mithilfe einer Beispieldatei können Sie den Zwei-Faktor-Code in Ihre Automatisierungen aufnehmenNUPKG.

1. Laden Sie die NUPKG Datei herunter.
2. Laden Sie die heruntergeladene NUPKG Datei in Ihren Orchestrator-Host- oder Mandantenfeed hoch, die über Ihre Studio-Instanz zugänglich sind. Weitere Informationen zum Hochladen der NUPKG Datei als benutzerdefinierte Bibliothek in 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 MongoDB.Coded.Workflows.Sample NUPKG Datei, die Sie zuvor in Ihrem Orchestrator-Host- oder Orchestrator-Mandantenfeed gespeichert haben, und installieren Sie sie.

Abbildung 1. Benutzerdefinierte Bibliothek im Menü Pakete verwalten

5. Nachdem Sie die Datei installiert haben, navigieren Sie zum Aktivitätenbereich 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 Aktivitätenbereich