- Enginio Manual
- Getting Started with Enginio using C++
- Enginio 1.0.6 Reference Documentation

Getting Started with Enginio using Qt Quick Checking Stored Objects in the Dashboard

# Getting Started with Enginio using C++

## Setup Qt application project

You need to link to Enginio. For qmake-based projects simply add

    QT += enginio

to your `.pro` file.

## Initialize Enginio Client

To use the Enginio Qt library in your code, you have to include relevant library headers.

     #include <Enginio/Enginio>

Before making any calls to the Enginio API, the EnginioClient needs to be instantiated. To do this, you will also need the `id` of the backend, which can be copied from the Dashboard. Go to the Enginio Dashboard and select a backend. Copy the `backend id` value.

    QByteArray backendId("YOUR_OWN_BACKEND_ID");
    EnginioClient *client = new EnginioClient;
    client->setBackendId(backendId);

For testing purposes, it is easiest to hardcode the `backend id` directly into application code. However, this might not be always the best choice, and sometimes it might be beneficial to put the backend configuration in a separate configuration file.

## Store your first Object

Create an object in JSON format and fill in the data:

        QJsonObject city;
        city.insert("objectType", QString("objects.city")); // an object type is required for all objects in Enginio
        city.insert("name", QString("Oslo")); // other properties can be chosen freely
        city.insert("population", 624000);

Create the object in the Enginio database by calling EnginioClient::create():

        client->create(city);
        connect(client, SIGNAL(finished(EnginioReply*)), this, SLOT(uploadFinished(EnginioReply*)));

Note that the `create()` method performs the actual asynchronous network communication. You need to wait for its completion by connecting to the finished and error signals.

Now you can check the Enginio dashboard for the newly created object.