MongoDB.New
-----------

Creates a new MongoDB object.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [MongoDB](component_MongoDB.md) | [12.3](newinversion123.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "MongoDB.New" ) ### Parameters

none

### Result

Returns reference number or error.

### Description

Creates a new MongoDB object.  
For our plugin a Mongo DB object holds an URI, a client (the connection), a database, a collection (the table) and a cursor (the record set) all as one reference in FileMaker.  
### Examples

Create new MongoDB object:

 Set Variable \[ $Mongo ; Value: MBS ( "MongoDB.New" ) \]   
If \[ MBS ("IsError") \]   
 Show Custom Dialog \[ "Failed to create new MongoDB o…" ; $Mongo \]   
 Exit Script \[ Text Result: \]   
End If  
### See also

- [MongoDB.Find](MongoDBFind.md)
- [MongoDB.FindCollections](MongoDBFindCollections.md)
- [MongoDB.GetOptions](MongoDBGetOptions.md)
- [MongoDB.GetURI](MongoDBGetURI.md)
- [MongoDB.GetUserName](MongoDBGetUserName.md)
- [MongoDB.InsertOne](MongoDBInsertOne.md)
- [MongoDB.ReplaceOne](MongoDBReplaceOne.md)
- [MongoDB.SetAuthMechanism](MongoDBSetAuthMechanism.md)
- [MongoDB.SetSSLOptions](MongoDBSetSSLOptions.md)
- [SSH.Tunnel.Run](SSHTunnelRun.md)

### Release notes

- **Version 12.4**
    - Added [MongoDB.CursorErrorDocument](https://www.mbsplugins.eu/MongoDBCursorErrorDocument.shtml) and [MongoDB.NewCursorFromCommandReply](https://www.mbsplugins.eu/MongoDBNewCursorFromCommandReply.shtml) functions.

### Example Databases

- [MongoDB/MongoDB Audit](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/MongoDB/MongoDB%20Audit.shtml#1ScriptAnchor_)
- [MongoDB/MongoDB Blog](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/MongoDB/MongoDB%20Blog.shtml#6ScriptAnchor_)
- [MongoDB/MongoDB Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/MongoDB/MongoDB%20Test.shtml#8ScriptAnchor_)

### Blog Entries

- [MongoDB GridFS in the MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2026-06-17/MongoDB_GridFS_in_the_MBS_File/monkeybreadsoftware_blog_filemaker)
- [OnWindowTransaction and MongoDB](https://www.mbsplugins.de/archive/2023-05-16/OnWindowTransaction_and_MongoD/monkeybreadsoftware_blog_filemaker)
- [FileMaker and MongoDB](https://www.mbsplugins.de/archive/2023-03-20/FileMaker_and_MongoDB/monkeybreadsoftware_blog_filemaker)
- [New MongoDB Example](https://www.mbsplugins.de/archive/2022-07-25/New_MongoDB_Example/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 1/2025, Seite 23](https://filemaker-magazin.de/neuigkeit/4282-Appetithappen-FMM_202501)

This function checks for a license.

Created 22nd May 2022 , last changed 20th June 2022

  
[MongoDB.MaxMessageSize](MongoDBMaxMessageSize.md) - [MongoDB.NewCursorFromCommandReply](MongoDBNewCursorFromCommandReply.md)

[HTML Version](MongoDBNew.shtml)