Skip to main content
Version: 3.1.0-Beta 🚧

MongoDB

ToolJet can connect to MongoDB to read and write data.

Manual Connection​

To establish a manual connection with the MongoDB data source, click on the + Add new data source button located on the query panel or navigate to the Data Sources page from the ToolJet dashboard.

info

Please make sure the Host/IP of the database is accessible from your VPC if you have self-hosted ToolJet. If you are using ToolJet cloud, please whitelist our IP.

ToolJet requires the following to connect to your MongoDB.

  • Host
  • Port
  • Username
  • Password

Note: It is recommended to create a new MongoDB user so that you can control the access levels of ToolJet.

ToolJet - Mongo connection

Connect Using Connecting String​

You can also use a Connection String by switching the method from the dropdown. You will be prompted to enter the details of your MongoDB connection.

ToolJet requires the following to connect to your MongoDB using Connecting String:

  • Connection String
info

The connection string typically looks like this: mongodb+srv://${username}:${password}@${cluster}/{database}.

For example: mongodb+srv://tooljettest:[email protected]/hrms

ToolJet - Mongo connection

Note: Make sure to replace username, password, cluster, and database with your actual MongoDB details. If your MongoDB instance requires additional connection options, you can usually append these options to the connection string.

Querying MongoDB​

  1. Click on + Add button of the query manager at the bottom panel of the editor and select the database added in the previous step as the data source.
  2. Select the operation that you want to perform and click Save to save the query.
  3. Click on the Run button to run the query.
ToolJet - Mongo query
tip

Query results can be transformed using transformations. Read our transformations documentation to see how: link

Supported Operations​

List Collections​

Returns list of collections

ToolJet - Mongo DB List Collection

Find One​

Return a document which satisfy the given filter and options. Reference

Required Parameters:​

  • Collection

Optional Parameters:​

  • Filter
  • Option
ToolJet - Mongo DB Find One

Find Many​

Return list of documents which satisfy the given filter and options. Reference

Required Parameters:​

  • Collection

Optional Parameters:​

  • Filter
  • Option
ToolJet - Mongo DB Find Many

Total Count​

Returns an estimation of the number of documents in the collection based on collection metadata. Reference

Required Parameters:​

  • Collection

Optional Parameters:​

  • Option
ToolJet - Mongo DB Total Count

Count​

Returns the number of documents based on the filter. Reference

Required Parameters:​

  • Collection

Optional Parameters:​

  • Filter
  • Option
ToolJet - Mongo DB Count

Distinct​

Retrieve a list of distinct values for a field based on the filter. Reference

Required Parameters:​

  • Collection
  • Field

Optional Parameters:​

  • Filter
  • Option
ToolJet - Mongo DB Find One

Insert One​

Insert a document. Reference

Required Parameters:​

  • Collection
  • Document

Optional Parameters:​

  • Option
ToolJet - Mongo DB Insert One

Example:​

{
    "name": "John Doe",
    "age": 30
}

Insert Many​

Insert list of documents. Reference

Required Parameters:​

  • Collection
  • Document

Optional Parameters:​

  • Option
ToolJet - Mongo DB Insert Many

Example​

[
    {
        "name": "Product1",
        "price": 100
    }, 
    {
        "name": "Product2",
        "price": 150
    }
]

Update One​

Update a document based on the filter. Reference

Required Parameters:​

  • Collection
  • Filter
  • Update

Optional Parameters:​

  • Option
ToolJet - Mongo DB Update One

Example​

Filter​
{
    "name": "John Doe"
}
Update​
{
    "$set": {
        "age": 31
    }
}

Update Many​

Update many documents based on the filter. Reference

Required Parameters:​

  • Collection
  • Filter
  • Update

Optional Parameters:​

  • Option
ToolJet - Mongo DB Update Many

Example​

Filter​
{
    "status": "pending"
}
Update​
{
    "$set": {
        "status": "completed"
    }
}

Replace One​

Replace a document based on filter. Reference

Required Parameters:​

  • Collection
  • Filter
  • Replacement

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One

Example​

Filter​
{
    "product_id": 123
}
Replacement​
{
    "product_id": 123,
    "name": "New Product",
    "price": 200
}

Find One and Update​

If your application requires the document after updating, use this instead of Update One. Reference

Required Parameters:​

  • Collection
  • Filter
  • Update

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One and Update

Example​

Filter​
{
    "employee_id": 456
}
Update​
{
    "$inc": {
        "salary": 5000
    }
}

Find One and Replace​

If your application requires the document after updating, use this instead of Replace One. Reference

Required Parameters:​

  • Collection
  • Filter
  • Replacement

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One and Replace

Example​

Filter​
{
    "product_id": 789
}
Replacement​
{
    "product_id": 789,
    "name": "Updated Product",
    "price": 300
}

Find One and Delete​

If your application requires the document after deleting, use this instead of Delete One. Reference

Required Parameters:​

  • Collection
  • Filter

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One and Delete

Example​

{
    "order_id": 101
}

Aggregate​

Aggregation operations are expressions you can use to produce reduced and summarized results. Reference

Required Parameters:​

  • Collection
  • Pipeline

Optional Parameters:​

  • Option
ToolJet - Mongo DB Aggregate

Example​

[
    {
        "$match": {
            "status": "completed"
        }
    }, 
    {
        "$group": {
            "_id": "$product_id",
            "totalSales": {
                "$sum": "$amount"
            }
        }
    }
]

Delete One​

Delete a record based on the filter. Reference

Required Parameters:​

  • Collection
  • Filter

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One

Example​

{
    "user_id": 123
}

Delete Many​

Delete many records based on the filter. Reference

Required Parameters:​

  • Collection
  • Filter

Optional Parameters:​

  • Option
ToolJet - Mongo DB Find One

Example​

{
    "status": "cancelled"
}

Bulk Operations​

Perform bulk operations. Reference

Required Parameters:​

  • Collection
  • Operations

Optional Parameters:​

  • Option
ToolJet - Mongo DB Bulk Operations

Example​

[
    {
        "insertOne": {
            "document": {
                "item": "apple",
                "quantity": 50
            }
        }
    }, 
    {
        "updateOne": {
            "filter": {
                "item": "orange"
            }, 
            "update": {
                "$set": {
                    "quantity": 100
                }
            }
        }
    }, 
    {
        "deleteOne": {
            "filter": {
                "item": "banana"
            }
        }
    }
]

Dynamic Queries​

Dynamic queries in MongoDB can be used to create flexible and parameterized queries.

Example​

{ amount: { $lt: '{{ components.textinput1.value }}' }}

// Dates
// supported: Extended JSON syntax
{ createdAt: { $date: '{{ new Date('01/10/2020') }}'} }
// not supported: MongoDB classic syntax
{ createdAt: new Date('01/10/2020') }

Reference on mongodb extended JSON supported data types.

Secure Sockets Layer (SSL)​

  • SSL Certificate: SSL certificate to use with MongoDB. Supported Types:
    • None: No SSL certificate verification.
    • CA Certificate: Requires a CA certificate to verify the server certificate.
    • Client Certificate: Requires a client certificate, client key, and CA certificate to authenticate with the server.
MongoDB - SSL Certificate