Apps
Manage Apps
Create, share, and version apps, and install them from the App Store
Apps are managed under Settings → Integration with external systems → Apps. Alternatively, you can get there with the Manage apps button on the apps overview page.
Creating a new app
- Open Settings → Integration with external systems → Apps.
- Click Create App. The Specifications step opens.
- Enter a name and a slug, and optionally a description and a vendor.
- Click Create. The app is created, initially with an empty Python template.
- Switch to the Code step and write the app's code there.
- Click Run. The output appears in the Preview field.
- Click Save.
How to write an app's code is described in Develop Apps.
Structure of an app
Every app consists of:
| Component | Description |
|---|---|
| Name | Display name in the sidebar and in the settings |
| Slug | Required. Unique technical identifier (e.g. my-dashboard) used in the URL. Only letters, digits, hyphens, and underscores are allowed — no spaces, umlauts, or dots. If you change the slug later, the app's address changes too, and existing links and bookmarks stop working |
| Description | Optional description of the app's purpose |
| Vendor | Optional: who created the app |
| App Icon | Optional: the app's icon on the app cards. SVG files only |
| Access | Optional: restricts the app to selected teams (see Restricting access to teams) |
| Code | The code executed when the app is called (Python, Node.js, or PHP). Technically, this part is called the "executor" |
Steps in the editor
An existing app has four steps:
- Specifications — name, slug, description, vendor, and other properties of the app
- Code — the app's code, with a preview
- Data — the entries the app has stored in the App Storage
- Version History — earlier versions of the app, which can be restored
In the Specifications step, you upload an App Icon under Appearance with Upload SVG; Remove deletes it again.
Restricting access to teams
By default, an app is available to all users with the readApps permission. In the Specifications
step, you can restrict this under Access: turn on Restrict access to selected teams and select
the teams under Teams with access.
The following applies:
- Only members of the selected teams see and open the app.
- Users who don't belong to any team don't see a restricted app.
- Users who are allowed to create or manage apps (
appCreator,manageApps) always see all apps. - The team selection is not included in the export. After importing into another environment, set it again there.
Editing an app and version history
A Draft tag next to the affected step in the editor indicates unsaved changes. If you leave the page with unsaved changes, a warning appears.
Every save creates a new version of the app. The Version History step lists all saved versions with their author. Expand a version to see what changed compared to the previous version.
To return to an earlier version, click Restore for that version and confirm in the Restore confirmation dialog.
Warning
The restored version becomes active immediately and is shown to all users.
Deleting an app
- Open the app and click Delete in the Specifications step.
- Confirm the prompt "Do you really want to delete the app?".
Deleting requires the manageApps permission. Users who only have appCreator do see the button,
but get an error message when they try to delete.
Export and import
Export and import let you transfer an app, for example from a test environment to the production environment.
Exporting:
- Open the app and click Export in the Specifications step.
- The Export App dialog shows the app as JSON. Click Copy to Clipboard.
Importing:
- Under Settings → Integration with external systems → Apps, click Import.
- Paste the copied JSON into the Import App dialog and click Import.
An import always creates a new app that starts at version 1. The version history and the team selection of the original app are not carried over.
App Store
The App Store offers ready-made apps from Enneo that you can use without writing any code. It is located under Settings → Integration with external systems → Apps, below Installed Apps.
For each app, you see Vendor, Version, Price, Language, and Purpose. Use the buttons above the list to filter by purpose; All shows the full selection again.
Installing and uninstalling
- Install creates the app as a regular app in your workspace. It then appears under Installed Apps, and the App Store marks it as Installed.
- You edit an installed app like any other app — for example, to restrict access to teams.
- Uninstall removes the app from your workspace again.
Installing and uninstalling requires the manageApps permission.