There are three ways to add data to a WorqDB Collection:

  • Set the Data of a Document within a Collection, with an automatically generated document identifier or docId.
  • Add a Document with a custom docId to identify your document within a Collection.
  • Create an empty document with an automatically generated identifier, and assign data to it later. You can do this by using the create method and then the update method later on.
In this we have focused on the API Endpoints but you can also use our NodeJS Packages to integrate with your Javascript and Typescript package.

​
Before you begin

See Get started with Create Collections to create a Collection before you add data to it.

​
Initialize Database Modules

const worqhat = require('worqhat');

var config = new worqhat.Configuration({
    apiKey: "your-api-key",
    debug: true,
    max_retries: 3,
});

worqhat.initializeApp(config);

let db = worqhat.database();

​
Set the Data of a Document within a Collection

You can read more about Data Object Documents in the Data Object Documents section and how we identify the data types of the fields in the Data Types section.

You can add data to a Collection by using the add method. This method will create a new document with an automatically generated document identifier or docId.

let data = {
    name: "John Doe",
    age: 30,
    isMarried: false,
    hobbies: ["Reading", "Coding", "Gaming"],
    address: {
        street: "123 Main St",
        city: "New York",
        state: "NY",
        zip: "10001"
    }
};

db.collection("users").add(data)
    .then((response) => {
        console.log(response);
        console.log("Document written with ID: ", response.data.documentId);
    })
    .catch((error) => {
        console.error("Error adding document: ", error);
    });

​
Add a Document with a custom docId

You can add data to a Collection by using the add method. This method will create a new document with a custom docId that you can use to identify your document within a Collection.

let data = {
    name: "John Doe",
    age: 30,
    isMarried: false,
    hobbies: ["Reading", "Coding", "Gaming"],
    address: {
        street: "123 Main St",
        city: "New York",
        state: "NY",
        zip: "10001"
    }
};

db.collection("users").doc("john-doe").add(data)
    .then((response) => {
        console.log(response);
        console.log("Document written with ID: ", response.data.documentId);
    })
    .catch((error) => {
        console.error("Error adding document: ", error);
    });

​
Create an empty document with an automatically generated identifier, and assign data to it later

You can create an empty document with an automatically generated identifier, and assign data to it later by using the update method. This method will create a new document with an automatically generated document identifier or docId and the Document Creation Timestamp.

let data = {};

db.collection("users").doc("documentId")add(data)
    .then((response) => {
        console.log(response);
        console.log("Document written with ID: ", response.data.documentId);
    })
    .catch((error) => {
        console.error("Error adding document: ", error);
    });

You can then update the data within the document later on to add data to it.

Was this page helpful?