Account Management

Get to know Heisenware accounts and their structure.

To use Heisenware, you must be a member of an account. An account typically represents an organization, such as a company.

Learn more about:

• Account structure: How an account is structured.

• Workspaces: A logical unit that can be used to group apps within one account.

Access an account

You can access a Heisenware account by either creating a new one or logging in to an existing one where you are already a member.

Create a new account

To create a new account:

1. Open the Heisenware sign-up page

2. Choose an available account name.

3. Sign up using email and password or Google social sign-in.

Log in to an existing account

To log in to an existing account:

1. Open the login page via your account's custom URL: <organization>.heisenware.cloud.

2. Log in using your email and password, or with Google

Account structure

Each account includes at least one member, known as the account owner. Members are individual users who typically belong to the organization.

Each account also has at least one Workspace. The first Workspace is always named "default Workspace." Each Workspace is equipped with its own InfluxDB, PostgreSQL database, and file server. Optionally, Workspaces can include Integrations, which are connections with external systems.

Within a Workspace, you can build an unlimited number of apps using the App Builder. All apps within a Workspace share access to the Workspace's databases, file server, and connections. Members have roles that define their permissions at the Workspace level.

The following image illustrates the account structure:

Workspaces

Workspaces ensure that you can separate apps, their data and resources in one account. This is useful, for example, if a software agency serves several customers with one account or a larger company wants to separate different departments or areas. In the first example, each customer would have their own workspace and in the second example, each department.

Members of an account can be assigned roles by the account owner at workspace level, which contain the corresponding permissions.

In the default state, an account has exactly one workspace, which is called Default Workspace. Further workspaces can currently only be added manually by us. Please contact us if you have a use case for this.

Apps

Any number of apps can be created in a workspace. All apps have access to the resources and data of the workspace.

Note: If one or more apps should not have access to the resources of a workspace, this is a use case for which you can contact us.

Resources

Each workspace contains its own resources for managing different types of data and integrations:

InfluxDB

The InfluxDB database can be used to record, store, and read time series data within the App Builder apps. For detailed guidance on using InfluxDB, refer to the article on internal InfluxDB.

PostgreSQL

The PostgreSQL database can be used to create, manipulate, and read relational data tables from the App Builder and apps. For more information on working with PostgreSQL, consult the article on internal PostgreSQL.

File Server

The file server stores any files you want to use in your apps, accessible from the App Builder. To learn how to use it, see the file server article.

Integrations

Integrations are established connections to and from external systems like local servers or web APIs. They allow apps to exchange data with these external systems.

Currently, integrations must be configured inside the App Builder. This will be moved to the App Manager soon.

For guidance on integrating external systems, refer to the articles on data integration.

Once created, integrations can be viewed, edited, and reused in other apps. To manage integrations, navigate to the Integrations panel in the App Manager's sidebar.