Applications

Elements allows the creation of Applications in a multi-tenant format - a suite of applications that communicate with the database across a single shared instance.

Applications define each app that you run on your Elements instance. Elements supports the concept of multi-tenancy, which is the ability to host multiple separate and independent applications from a single shared database of users. For example, Users, Items, and Missions are shared across all applications on the instance.

This enables your enterprise to publish a suite of applications under one instance of Elements. Such use cases for multiple applications may include a series of episodic games, separation of production and testing environments, cross promotion and sharing of digital goods, or the ability to publish multiple similar related applications sharing the back end.

For your customers who opt to use user name and password login, multi-tenancy greatly reduce password fatigue and allows you to offer single-sign on to all of your apps.

Each Application is the nexus for all subordinate configurations. It is even possible to support multiple independent iOS/Google Play Application IDs under one Application within elements. This can be useful if your company implements a strategy of using alternative application IDs for testing or pre-release content.

For Applications, the following restrictions apply:

  1. There is one and only one repository of script code for executing cloud functions.

  2. There is one and only one endpoint for CDN support.

  3. A single Application may not host the same Google Play, iOS, or other unique application identifier.

Application Configurations

Application configurations add support for features such as Facebook SSO, Firebase push notifications, and Android and iOS In-App Products. Application configurations are created and configured from inside the Application editor in the console.

Each application has its own set of application configurations, which includes the data connecting it to various services such as push notifications, Facebook, and more.

Product bundles are connected to individual applications via corresponding application configurations. These are used to manage in-app purchases for platforms like iOS and Android.

Application Structure

  • _id: This is the unique id automatically assigned when the application is created.

  • name: This is the application's unique name.

  • description: This string is the application's description.

Managing Applications Using the Console

Applications are managed in the admin console by selecting Applications from the nav bar or the hamburger menu.

Add or Delete an Application

Use the "Add Application" button to add a new application.

Applications can be deleted by using the "Delete" button next to them.

Edit an Application

Applications can be edited by tapping the "Edit" button for each application.

In the edit panel, you'll also find the URL for the git script repo for the application, as well as links to the API documentation for the application.

Application configurations are also accessed here, but we will cover those in a separate section below.

JSON Structure of Applications

[{
    "_id" : ObjectId("5cdb1088e96c3c4f2bfe1da7"),
    "active" : true,
    "name" : "NAME",
    "description" : "This is a description"
}]

Adding an Application Configuration

In the Applications section of the admin console, after having added an application, you are able to add application configurations to that application.

  1. Edit the chosen Application

  2. In the Application Editor, tap the "Add..." button to open the drop down menu

  3. Select the desired application configuration type

Last updated