The General settings page presents an overview of your app project with the following details:
- A Description of the app
- The App Contact and Technical Contact for the app
Whether the app is enabled for Mendix Studio (for details, see the Mendix Studio section below)
The App ID
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.
Only users with the App Settings permission can change cloud platforms. For default roles, only the SCRUM Master has this permission. For more details, see the App Team Roles section of Company & App Roles.
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 App Users, who are end-users who can access the deployed app on specific environments to use it, test it, and provide feedback.
On the App User Management page, you will only see the environments for your app for which the following factors are true:
- Mendix Single Sign-On is implemented:
- Your user role allows you to manage other users (for more information, see the User Management Properties section of User Roles)
4.1 Inviting App Users
To invite a new App User on the App User Management page, follow these steps:
- Click Invite Users.
- Enter the email addresses of the end-users you want to invite.
Click Include your app team to include invitiations 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.
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.
Add a personal message to your invitiation, 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.
4.2 Editing App Users
You can remove and edit App Users on the App User Management page:
To remove an App User, click Remove from Environment by their name.
To edit an App User’s roles, click Edit by their name.
If an App User has been granted access to an app environment through a security group, only a Company Admin using the Security Groups page can remove them from that environment (by removing them from that security group) or edit the roles granted by that security group policy.
5 Editing App Info
Only users with the App Settings permission can edit the application information.
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.
Only Company Admins or users with the App Settings permission can manage webhooks.
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.
For details on the technical configuration of webhooks, see Webhooks in the API Documentation.
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.