<mongoCollection variable>.Add (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<mongoCollection variable>.Add (Function)

In french: <Variable mongoCollection>.Ajoute

Adds one or more documents into a collection of MongoDB database.

Versions 24 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

New in version 24

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Example

cntMDB is mongoConnection
MyCollection is mongoCollection
MyCollection = cntMDB.Database["CRM"].Collection["MyCollection"]
MyCollection.Add("{ ""name"":""paul"", ""size"" : 182 }")

gclCollection is mongoCollection

// Variable containing the documents that will be added into the database
arrDocument is array of strings

// Temporary variables
stContact is STContactInfo
sJSONBuffer is string

// Build the array of documents
stContact = [ "MOORE", "Ellen", "+33.467032032", "e.moore@windev.com" ]
Serialize(stContact, sJSONBuffer, psdJSON)
Add(arrDocument, sJSONBuffer)

stContact = [ "SMITH", "Robert", "+33.467032032", "r.smith@windev.com" ]
Serialize(stContact, sJSONBuffer, psdJSON)
Add(arrDocument, sJSONBuffer)

stContact = [ "HUDSON", "Jade", "+33.467032032", "j.hudson@windev.com" ]
Serialize(stContact, sJSONBuffer, psdJSON)
Add(arrDocument, sJSONBuffer)

// Add the three contacts in a single call
gclCollection.Add(arrDocument)

Syntax

Adding a document into a collection Hide the details

<Result> = <Collection>.Add(<Document> [, <Option>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurred. ErrorInfo is used to identify the error.

<Collection>: mongoCollection variable

Name of the mongoCollection variable that represents the collection in which the document will be added.

<Document>: Type corresponding to the document

Document that will be added to the collection. This document can correspond to:
a document in JSON format. In this case, this parameter corresponds to a character string.
a document in BSON format. In this case, this parameter corresponds to a buffer.
a variant.

<Option>: Optional Integer constant

Option for adding the document:
mongoWithoutValidation Used to add the document without checking the document structure.

Adding a list of documents into a collection Hide the details

<Result> = <Collection>.Add(<List of documents> [, <Options>])

<Result>: Boolean

True if the operation was performed,
False if a problem occurred. ErrorInfo is used to identify the error.

<Collection>: mongoCollection variable

Name of the mongoCollection variable that represents the collection in which the documents will be added.

<List of documents>: Array

Array of documents that will be added to the collection. These documents can correspond to:
a document in JSON format. In this case, this parameter corresponds to a character string.
a document in BSON format. In this case, this parameter corresponds to a buffer.
a variant.

<Options>: Optional Integer constant

Options for adding documents:
mongoContinueIfError Used to add the next document even if the previous document triggered an error.
mongoWithoutValidation Used to add the document without checking the document structure.

Component: wd260big.dll