Conectar a MongoDB Atlas con automatizaciones codificadas

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 MongoDB:

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

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

Consejo: independientemente de si eliges integrar el código de conexión de MongoDB en tus archivos CS (para automatizaciones codificadas) o 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 automatizaciones híbridas, consulta Crear automatizaciones híbridas: combinar flujos de trabajo codificados y de código bajo.

Requisitos previos

1. Asegúrate de tener UiPath Studio (versión 2024.10 o posterior: recomendada).
2. Asegúrate de tener una cuenta de MongoDB Atlas.
3. Instala el paquete NuGet MongoDB.Driver en tu proyecto.
   1. Abre tu proyecto de UiPath en Studio.
   2. En la cinta 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: copiar y pegar el código en los 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 coincide con el del nombre de tu proyecto.

Nota: el código de muestra se conecta a MongoDB Atlas utilizando el formato de cadena de conexión específico para las implementaciones en la nube. Asegúrate de reemplazar las credenciales de marcador de posición por tus credenciales reales de MongoDB Atlas.

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 la base de datos
• cluster: el nombre de host de tu clúster de la cadena de conexión (por ejemplo, cluster0.abc123.mongodb.net)

La muestra devuelve una lista de todas 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 su clúster
• Proporciona soporte de conmutación por error automático
• Incluye lógica de reintento para operaciones de escritura (retryWrites=true)
• Establece la preocupación de escritura como mayoritaria (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: utilizar un paquete de actividades personalizado y el archivo NUPKG de ejemplo

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

1. Descarga el archivo NUPKG .
2. Carga el NUPKG archivo descargado en tu fuente de host o tenant de Orchestrator , a los que se puede acceder a través de tu instancia de Studio. Para obtener más información sobre la carga del 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 Actividades y localiza MongoDB.Coded.Workflows.Sample. Arrastra y suelta la actividad ObtenerBasesDeDatos en tus archivos XAML para probar tu conexión MongoDB y obtener una lista de las bases de datos disponibles.
   Figura 2. Actividad ObtenerBasesDeDatos en el panel Actividades