Skip to main content

Adding and Managing Applications

Last updated 24/10/2024

This documentation will cover how to create and maintain your applications. A number of configurations are defaulted by Five enabling you to start building your application as soon as you have given your application a title.

All applications built in Five are built on a MySQL database and Five establishes the connection with MySQL's database management system (DBMS).

Who can Add and Manage Applications?​

Please refer to the chapter Default Users and Roles.

Add an Application​




info
When you first open Five and agree to our Terms of Service, you will find yourself on our landing page. To remove the landing page, click Applications in the menu.


Applications menu item
Figure 1 - Applications menu item

1. Click the Add Item button.


Add Item button
Figure 2 - Add Item button

2. Type a title for your application in the Title field.


Add an application
Figure 3 - Add an application

3. Click the Save button in the form app bar.


Save button
Figure 4 - Save button

info
When you click the Save button for a new application, Five creates and establishes the connection to your MySQL database.

Add a Multiuser Application​


info
You must save your application before you can turn it into a multiuser application as Five needs the database established to add the iUser table into your database. The iUser table is used to store the users of your application.

1. Either click the Edit button in the form app bar, or click directly on the Multiuser switch.


Edit button
Figure 5 - Edit button

2. Click the Multiuser switch.


Multiuser switch
Figure 6 - Multiuser switch

3. Click the Save button in the form app bar.


Save button
Figure 7 - Save button

Logging into Your Multiuser Application​

The following documentation will guide you through the initial steps to log into your multiuser application.

 1. Click the Deploy to Development button.

info
The Deploy to Development button becomes available when you save an application and enables you to deploy your application to the development environment. The first deployment may take up to five minutes to be available as the new DNS (Domain Name System) entry for the URL needs to propagate.

Deploy to Development button
Figure 8 - Deploy to Development button

2. Type admin in the Username field.

3. Type admin in the Password field.

4. Click the Sign In button.


Sign In window
Figure 9 - Sign In window

info
Five will enforce you to change your password. Your password must contain:
  • A letter
  • A number
  • A symbol
  • 8 to 32 characters

tip
You can change the default password strength for your application! Please refer to the Password Configuration chapter.

5. Type your new password in the Password field.

6. Confirm your password in the Confirm Password field.

7. Click the Update Password button.


Update Password window
Figure 10 - Update Password window

info

Five automatically creates the Users form in a multiuser application, as shown below. This enables you to add users to your application immediately. It is highly recommended that you create a menu structure and permissions to only have the Users form available to the right people.


Users form
Figure 11 - Users form

info
Future logins to your application, you will use username: admin and password: the password you just entered.

What Five Creates​

Five handles creating all your initial setup so you can begin to create your application. Five creates the following:

  • A unique URL based on the title.
  • A MySQL database and the connection to the external DBMS.
  • A default instance.
  • Version Control to provide a full set of history tables.
  • A multiuser application will have the iUser table, Users form, and Users menu item.

Managing Applications​

The following documentation will explain how to maintain your application records.

Edit an Application​

1. Select the application record in the list.

2. Either click the Edit button in the form app bar, or click in any field.


Edit button
Figure 12 - Edit button

3. Make your changes.

4. Click the Save button in the form app bar.


Save button
Figure 13 - Save button

Delete an Application​

1. Select the application record in the list.

info
You cannot delete an application while it is deployed.

2. Click the Remove from Development button.


Remove from Development button
Figure 14 - Remove from Development button

3. Click the Edit button in the form app bar.


Edit button
Figure 15 - Edit button

4. Click the Delete button in the form app bar.


Delete button
Figure 16 - Delete button

caution
Five will ask you 'Do you want to delete this record?' because once an application has been deleted, the schema and all data will be deleted and cannot be recovered. At this stage, you can opt not to delete your application by clicking the No button. Before deleting an application, it is highly recommended to backup your data first.

5. Click the Yes button.


Yes button
Figure 17 - Yes button