Manage General App Settings

Last update: Edit

1 Introduction

The General settings page presents an overview of your app project with the following details:

The sections below describe the actions you can perform on this page.

2 Mendix Studio

In the Studio section, you can see whether Studio is enabled for the app. You can also do the following:

  • Enable Studio if it has not been enabled yet by clicking Enable Studio

  • Enable collaborative development with Studio for apps using Mendix version 7.23.3 and above by clicking Enable Now (for more information on the collaborative development process, see Collaborative Development)

3 Editing Cloud Settings

Click Cloud Settings to select the cloud platform on which to deploy your app. The selection of cloud platforms available will depend on the features of your Mendix account.

If you select a non-Mendix cloud platform like SAP, you will be redirected to a page to complete the setup. If you select Mendix Cloud, no additional setup is needed.

Specific steps for configuring different cloud platforms are provided here:

4 Managing App Users

Click Manage App Users to manage and invite App Users, who are end-users who can access the deployed app on specific environments to use it, test it, and provide feedback.

After clicking Manage App Users, you will see a list of environments for your app on the App User Management page. You will only be able to see environments that satisfy these requirements:

  • Mendix Single Sign-On is implemented:
    • In Studio, SSO is automatically implemented for your app project by enabling security for your app – for details, see the Enabling Security section of Security, Roles & Permissions
    • In Studio Pro, SSO can implemented via the AppCloudServices module – for details, see Mendix Single Sign-On
  • If you manage user roles from Studio, your app should be published (for more information see the Managing App Users section of Security, Roles & Permissions )
  • Your user role allows you to manage other users (for more information, see the User Management Properties section of User Roles)

4.1 Manage Users

When you click Manage Uses on for your environment, you will see a page with a list of the current App Users you can remove or edit:

To remove an App User from the environment, click Remove by their name.

To edit an App User’s roles, click Edit by their name. Permissions for these roles (for example, User or Administrator) correspond to what you have configured for your app project’s user roles in Project Security in Mendix Studio Pro or Roles and Permissions in Mendix Studio. If you have created a customized role, you need to publish the app before you are able to see and assign it here.

4.2 Invite Users

To invite new App Users to your app, click Invite Users on the App User Management page or on the page with a list of current App Users and follow these steps:

  1. Enter the email addresses of the end-users you want to invite.

  2. Click Include your app team to include invitations to all the members of your App Team. This may be useful, because people invited to join your App Team are not added as App Users automatically.

  3. Click Add to invitee list.

  4. Select the role for the App User (for example, User or Administrator). Permissions for these roles correspond to what you have configured for your app project’s user roles in Project Security in Mendix Studio Pro or Roles and Permissions in Mendix Studio. If you have created a customized role, you need to publish the app before you are able to see and assign it here.

  5. Click Next.

  6. Add a personal message to your invitation, and finally click Next then Send Invitations to send it.

The invitee will receive an email asking them to authorize access to their Mendix account on this screen:

After they provide authorization, they will be brought to your deployed app.

5 Editing App Info

Click Edit App Info to edit the following details:

  • The name and logo of the app
  • The Description of the app
  • The App Contact

6 Managing Webhooks

Click Manage Webhooks to manage your app’s webhooks. A webhook enables the Developer Portal to talk to another website and post updated Developer Portal content (for example, Sprint updates and new stories) to that website. For example, if Mansystems wants to follow the changes in their app project, they will create a service with a certain URL (see the required URL below) that keeps track of the data. Changes in the app project in the Developer Portal are then sent to that URL.

On the Webhooks settings page, you can add a new webhook and edit or delete existing webhooks:

After clicking New to create a new webhook, fill in the following details:

  • Name – the name of the webhook
  • URL – the URL to which the webhook will connect
  • Secret – the secret used by the Developer Portal to sign the data payload in order to identify the source of the data to the receiving URL (this appears when creating and editing a webhook, but it will not be displayed on the Webhooks settings page)
  • Version – the version of the webhooks feature to be used
  • Events – what types of data will be sent via the webhook (you must select at least one; this appears when creating and editing a webhook, but it will not be displayed on the Webhooks settings page)

To edit the above details for an existing webhook, click Edit.

To delete an existing webhook, click Delete.

7 Leaving the App

To leave the app, click Leave App. For details on leaving, deleting, and deactivating an app, see How to Leave & Delete an App.

8 Read More