MongoCollectionfindone()

Performs a query against Mongo returning the first document

Usage

STRUCTURE = MongoCollectionfindone( datasource, collection, query, fields )
Argument Summary
datasource datasource name. Name previously created using MongoRegister
collection collection name
query the query to which to find the object to update
fields fields to which to bring back. If left blank or not specified, then all fields for the document will be returned [optional]

Calling

Supports named-parameter calling allowing you to use the function like:

MongoCollectionfindone(
   datasource=?, 
   collection=?, 
   query=?, 
   fields=?
);

Supports passing parameters as a structure using ArgumentCollection:

MongoCollectionfindone( ArgumentCollection={
   datasource : ?, 
   collection : ?, 
   query : ?, 
   fields : ?
} );

Extra

For more information on using MongoDB, visit the MongoCFML page

For functions that update data, you can pass in the writeconcern. The possible values are:

  • FSYNC_SAFE
    Exceptions are raised for network issues, and server errors; the write operation waits for the server to flush the data to disk
  • JOURNAL_SAFE
    Exceptions are raised for network issues, and server errors; the write operation waits for the server to group commit to the journal file on disk
  • MAJORITY
    Exceptions are raised for network issues, and server errors; waits on a majority of servers for the write operation
  • NONE
    No exceptions are raised, even for network issues
  • NORMAL
    Exceptions are raised for network issues, but not server errors
  • REPLICAS_SAFE
    Exceptions are raised for network issues, and server errors; waits for at least 2 servers for the write operation
  • SAFE
    Exceptions are raised for network issues, and server errors; waits on a server for the write operation