コード化されたオートメーションで MongoDB Atlas に接続する

C# のコード化されたワークフローで MongoDB ドライバーを使用して、Studio のコード化されたオートメーションから MongoDB Atlas クラウド データベースに接続します。

このチュートリアルでは、UiPath のコード化されたオートメーションから MongoDB Atlas データベースに接続する方法について説明します。MongoDB Atlas は、ローカルにインストールする必要なく信頼性と拡張性に優れたデータベース ソリューションを提供するフル マネージドのクラウド データベース サービスです。

Context

MongoDB 接続コードを実装するには次の方法があります。

• コードをコピーして、対象となるプロジェクトの CS ファイルに貼り付ける
• カスタム アクティビティ パッケージとサンプルの NUPKG ファイルを使用する

サンプルの NUPKG ファイルを使用する場合、2 要素認証を XAML ファイル内にアクティビティとして追加できます。

ヒント:

MongoDB 接続コードを CS ファイル (コード化されたオートメーションの場合) に組み込むか、それとも XAML ファイル (ローコード オートメーションの場合) に組み込むかにかかわらず、コード化されたオートメーションをローコード オートメーション内に呼び出すことができます。また、その逆も可能です。ハイブリッド オートメーションについて詳しくは、「 ハイブリッド オートメーションを作成する - コード化されたワークフローとローコード ワークフローを組み合わせる」をご覧ください。

前提条件

1. UiPath Studio (バージョン 2024.10 以降を推奨) がインストールされていることを確認します。
2. MongoDB Atlas アカウントを持っていることを確認します。
3. プロジェクトに MongoDB.Driver NuGet パッケージをインストールします。
   1. Studio で UiPath プロジェクトを開きます。
   2. [デザイン] リボンで、[パッケージを管理] に移動します。
   3. [すべてのパッケージ] または [.NET] タブを選択します。
   4. MongoDB.Driver を検索します。
   5. [MongoDB.Driver] を選択し、[インストール] を選択します。
   6. ライセンス契約と依存関係に同意します。

オプション 1: コードをコピーして CS ファイルに貼り付ける

コード化されたオートメーションで MongoDB Atlas コネクションを使用するには、次のサンプル コードをコピーして、対象となるプロジェクトの CS ファイルに貼り付けます。ファイルの名前空間がプロジェクト名と一致していることを確認してください。

注:

このサンプル コードは、クラウド デプロイに固有の接続文字列形式を使用して MongoDB Atlas に接続します。プレースホルダーの資格情報を実際の 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;
        }
    }
}

接続パラメーター

• username: MongoDB Atlas で作成したデータベース ユーザー
• password: データベース ユーザーのパスワード
• cluster: 接続文字列のクラスターのホスト名 (例: cluster0.abc123.mongodb.net)

このサンプルは、その特定の資格情報セットに対してすべてのデータベースのリストを返します。

接続文字列の形式 - MongoDB Atlas は、次の mongodb+srv:// プロトコルを使用します。

• クラスター内のすべてのノードを自動的に検出します
• 自動フェールオーバーのサポートを提供します
• 書き込み操作のリトライ ロジックを含みます (retryWrites=true)
• 書き込み保証 (write concern) を過半数 (majority) に設定します (w=majority)

エラー処理

• MongoAuthenticationException: 資格情報が正しくない場合に発生します
• MongoConnectionException: ネットワーク アクセスがブロックされている場合、またはクラスターが使用できない場合に発生します
• 一般的な例外: その他の MongoDB 関連のエラーをキャッチします

オプション 2: カスタム アクティビティ パッケージとサンプルの NUPKG ファイルを使用する

サンプルの NUPKG ファイルを使用すると、2 要素認証のコードをオートメーションに含めることができます。

1. NUPKG ファイルをダウンロードします。
2. ダウンロードした NUPKG ファイルを、Studio インスタンスからアクセス可能な Orchestrator ホスト または テナント フィードにアップロードします。NUPKG ファイルをカスタム ライブラリとして Orchestrator にアップロードする方法について詳しくは、「ライブラリを Orchestrator に手動でアップロードする」をご覧ください。
3. Studio プロジェクトを開き、[パッケージを管理] メニューを開きます。
4. Orchestrator ホスト フィードまたは Orchestrator テナント フィードに保存した MongoDB.Coded.Workflows.Sample NUPKG ファイルを検索してインストールします。

図 1. [パッケージを管理] メニュー内のカスタム ライブラリ

5. ファイルのインストール後、[ アクティビティ ] パネルに移動して MongoDB.Coded.Workflows.Sampleを見つけます。XAML ファイルに [データベースを取得] アクティビティをドラッグ アンド ドロップして MongoDB 接続をテストし、利用可能なデータベースのリストを取得します。

結果

MongoDB 接続は、コード化されたオートメーションで使用できます。[アクティビティ] パネルの [データベースを取得] アクティビティを使用して、接続をテストし、利用可能なデータベースのリストを取得できます。

図 2. [アクティビティ] パネルの [GetDatabases] アクティビティ