Conectar a MongoDB Atlas con automatizaciones codificadas

Conéctese a una base de datos en la nube de MongoDB Atlas desde automatizaciones codificadas de Studio utilizando el controlador MongoDB en un flujo de trabajo codificado en C#.

Este tutorial muestra cómo conectarse a una base de datos de MongoDB Atlas desde tus automatizaciones codificadas en UiPath. MongoDB Atlas es un servicio de base de datos en nube, completamente gestionado y que proporciona una solución de base de datos fiable y escalable que no precisa ser instalada de forma local.

Context

Estas son las formas de implementar el código de conexión de MongoDB:

• Copia y pega el código en un CS archivo de tu proyecto de destino.
• Usa un pack de actividades personalizado y el archivo NUPKG de ejemplo

Cuando optes por utilizar el archivo de NUPKG muestra, tienes la capacidad de añadir la autenticación de dos factores como actividad dentro de tus XAML archivos.

Consejo:

Independientemente de si eliges integrar el código de conexión de MongoDB en tus archivos CS (para automatizaciones codificadas) o en archivos XAML (para automatizaciones de código bajo), recuerda que puedes invocar una automatización codificada en una de código bajo y viceversa. Para obtener más información sobre las automatizaciones híbridas, consulta Creación de automatizaciones híbridas: combinación de flujos de trabajo codificados y de código bajo.

Requisitos previos

1. Asegúrate de que tengas instalado UiPath Studio (versión 2024.10 o posterior: se recomienda).
2. Asegúrate de tener una cuenta de MongoDB Atlas.
3. Instala el paquete MongoDB.DriverNuGet en tu proyecto.
   1. Abre tu proyecto de UiPath en Studio.
   2. En la cinta de opciones Diseño, ve a Gestionar paquetes.
   3. Selecciona Todos los paquetes o la pestaña .NET.
   4. Buscar MongoDB.Driver.
   5. Selecciona MongoDB.Driver y, luego, selecciona Instalar.
   6. Acepta el acuerdo de licencia y las dependencias.

Opción 1: copia y pega el código en archivos CS

Para utilizar la conexión de MongoDB Atlas en tu automatización codificada, puedes copiar y pegar el siguiente código de ejemplo en un archivo CS de tu proyecto de destino. Asegúrate de que el espacio de nombres del Archivo coincida con el del Nombre de proyecto.

Nota:

El código de ejemplo se conecta a MongoDB Atlas utilizando el formato de cadena de conexión específico para las implementaciones en cloud.Asegúrate de reemplazar las credenciales del marcador de posición con tus credenciales de MongoDB Atlas reales.

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

Parámetros de Conexión

• nombre de usuario: el usuario de la base de datos que creaste en MongoDB Atlas
• contraseña: la contraseña para el usuario de tu base de datos
• clúster: el nombre del host de tu clúster de la cadena de conexión (por ejemplo, cluster0.abc123.mongodb.net)

El ejemplo devuelve una lista de Todos las bases de datos para ese conjunto específico de credenciales.

Formato de cadena de conexión: MongoDB Atlas utiliza el protocolo mongodb+srv://, que:

• Descubre automáticamente todos los nodos de tu clúster
• Proporciona soporte automático para cambios por error
• Incluye la lógica de reintentar para operaciones de escritura (retryWrites=true)
• Establece el parámetro de escritura en mayoría (w=majority)

Administración de errores

• MongoAuthenticationException: se produce cuando las credenciales son incorrectas
• MongoConnectionException: se produce cuando el acceso a la red está bloqueado o el clúster no está disponible
• Excepciones generales: detecta cualquier otro error relacionado con MongoDB

Opción 2: utiliza un pack de actividades personalizado y el archivo de ejemplo NUPKG

El uso de un Archivo te permite incluir el código de dos factores en tus automatizaciones.

1. Descarga el NUPKG archivo .
2. Carga el archivo descargado NUPKG en tu fuente de Host de Orchestrator o tenant, a la que se puede acceder a través de tu instancia de Studio. Para obtener más información sobre cómo cargar el archivo NUPKG como biblioteca personalizada en Orchestrator, consulta Cargar manualmente una biblioteca en Orchestrator.
3. Abre tu proyecto de Studio y abre el menú Gestionar paquetes.
4. Busca el archivo MongoDB.Coded.Workflows.Sample NUPKG que guardaste previamente en tu fuente de Host de Orchestrator o tenant de Orchestrator e instálalo.

Figura 1. Biblioteca personalizada en el menú Gestionar paquetes

5. Después de instalar el archivo, ve al panel de Actividades y localiza MongoDB.Coded.Workflows.Sample. Arrastra y suelta la actividad GetDatabases en tus archivos XAML para probar tu conexión a MongoDB y busca una lista de las bases de datos disponibles.

Resultado

La conexión MongoDB está disponible en tu automatización codificada. Puedes utilizar la actividad ObtenerBasesDeDatos del panel Actividades para probar la conexión y obtener una lista de las bases de datos disponibles.

Figura 2. Actividad Obtener bases de datos en el panel de actividades