Building Your First App "Personal Budget"

The section will teach you how to build your first application. The guide takes a Personal Budget application as an example.

You are going to build the application that will be extended and improved during the course of the eLegere Documentation. You will learn how to create a basic application in eLegere and the Storage to record the data.

The tutorial presupposes that you are an enabled eLegere user who can access a Domain. Suppose that you are Mr. John Doe and you need to create an Application to manage your personal budget.

After your first login, you should see the following panel:

The above panel when the user logins is called Home.

In the Home you can find:

• Applications that you have built.
• Applications that other team members have built and granted you the access to collaborate.

What are Applications?

eLegere Applications enable the users to collect, manipulate, and organize data.

The user can build eLegere Applications using a special panel called Design Mode.

For example, John Doe requires an Application named Personal Budget to manage data about his expenses.

In the eLegere tutorial, you will build step-by-step Personal Budget to record and manage expenses and income.

What Do You Need?

Applications do not store data: they can only manipulate data.

The Applications require Storages to retrieve and save the data.

What is a Storage?

A Storage is a container of data. The Storage enables to store different information that applications can retrieve, modify, and save.

Each Application requires a Storage to retrive, manipulate, and store information.

What are Storage Fields?

Storages are organized in Storage Fields.

Each entry in a Storage that an Application retrieves is a set of fields containing information.

An example are the fields of a Storage for an address book:

• Name
• Surname
• Address
• Telephone
• Email

Each entry of a address book's Storage has the following field to fill. For instance, an entry would be:

Field	Value
Name	John
Surname	Doe
Address	St Jesup, Iowa(IA), 50648
Telephone	(319) 827-2862 304
Email	j.doe@vesenda.com

Users can create as many fields of different types as they want in a Storage.

Create your first Storage Transactions

The application Personal Budget requires a Storage to work.

You have to create a Storage called Transactions. Transactions will record all the credits and expenses that Personal Budget has to manipulate.

1. On the left taskbar, click on Storages to access to the Storages' management sub-panel.

   

2. On the top, click on the Add Storage button to create a new Storage.

   

3. A pop-up window to choose the type of Storage will appear. Most of the Applications require the Blank Storage type. Select from the pop-up window the Blank Storage type option.

   

   Info

   The majority of eLegere Storages are Blank type. Connection and Logical Storages are advanced and contextual types of storages. You can ignore them for the goal of the Get Started. From now on, when asked to create a Storage, choose the Blank type.

4. You will land on the editor for Storages. Type Transactions as Name for the Storage.

   

5. Click on Field Mapping on the taskbar to access the sub-panel to add Storage Fields.

   

6. In Field Mapping, identify the Field Type List on the left side and below the taskbar. Read through them to gain familiarity with the different types of fields. You don't have to memorize them: the most used are Identity, String, Numeric, Date, Time, and Date Time.

   

   A list of the available Storage Fields types:

   Type	Description
   Identity	Identity field record the ID number assigned to the entry. Applications assign to each entry of the Storage a number identifying them univocally. Each ID number is unique. There cannot be two entries with the same ID number. (Example: "1. David Foster", "44. Martha Lewis")
   String	The field records letters, symbols, and numbers. (Examples: "Danielle", "Road G. Collins 4/B", "g.kevin@vesenda.com".)
   Numeric	Numeric type fields record numbers. (Examples: "123", "0,555".)
   Boolean	The field records either a TRUE or FALSE value. (Examples: "Approved TRUE", "Dismissed FALSE")
   Date	The field records a date. (Examples: "09 September 2021", "23/10/15")
   Date Time	The field records a date and the related time. (Examples:"22nd October 2021 23:33", "01/03/2022 10:00 AM")
   Time	The field records a time. (Examples: "13:11", "09:30 PM")
   Timespan	The field records a span of time of seconds, minutes, hours, days or weeks in milliseconds. (Examples: The field records 5 minutes as "300.000 ms")
   Multiselection	The field records multiple choices from a list of options. (Examples: Food: "Burger, Pizza, Pasta, French Fries"; Countries: "Angola, Bolivia, Italy, UK, USA")
   File	The field stores a file. (Examples: "Medical Record.pdf", "107890 Dissertation.doc", "My Picture.jpg")
   Link	The field records the URL of a website. (Examples: "http://www.vesenda.com/")
   Latitude	The field records the latitude of a place. (Examples: "45° 11' 31.38" N", "45°27'51.37"N")
   Longitude	The field records the longitude of a place. (Examples: "139°41'30.16"E", "9° 09' 33.01" E")
   WKT Shape	The field records the formula of a WKT (Well-Known Text) Shape. WKT is a mark-up language that describes spatial representations. (Examples: "POLYGON((0.5 0.5,5 0,5 5,0 5,0.5 0.5)", "LINESTRING (30 10, 10 30, 40 40)")
   Image Uri	The field records the Uri pointing to an image. (Examples: "mywebsite.com/server/folder/mypicture.png")
   Color	The field let you assign a color.
   Icon	The field let you assign an icon to the entry.
   Rich text	The field can store text in Rich Text format. (Examples: "Reminder: call Mrs. Daniels", "Note Send an email")

7. Click on the icon next to a Field to add it to the Field list for the Storage. (As alternative, drag & drop the field type at the center of the panel to add it.) Add an Identity field to begin.

   

8. You can type the label for the field in the textbox. Type IdBudget as name for the Identity field.

9. Add the following fields to the Storage by repeating Step 7-8. Name them as follows:

   • IdBudget Identity
   • BudgetName String
   • BudgetValue Numeric
   • BudgetDate Date
   • BudgetTime Time
   • Notes String

   

   At any time, you can change the field type by clicking on the type icon next to the Name and choosing a different type from the drop-down list.

   

10. Uncheck the No Limit options. Leave the standard limit of 100 characters: in this case you cannot insert text longer than 100 characters in the field.

    

    Fields with No Limit are not searchable. If you want to make a field searchable, you must remove the No Limit option and set the characters' limit.

    Note

    The maximum characters' limit for String type fields depends on your eLegere installation and your administrator's configuration.

11. Click on the Tile Theme button on the left taskbar.

    

    Tile Theme enables to customize the appearance of the Storage's tile in the Home.

    

12. Customize the appearance of the application through the options as you prefer.

    

    • (1) Tile Color Changes the color of the bottom of the tile.
    • (2) Tile Icons Color Changes the colors of the actions' icons.
    • (3) Storage Icon Opens a menu to choose a icon for the Storage.

    Warning

    The editor enables the customization only when you have chosen a Storage name.

13. On the top corner on the right, click on Save and Exit button to complete the creation of the Transactions Storage.

    

    Note

    Ignore the notification to access application's creation for the time being. You are going to learn the standard way to create applications in Home. But next time, click Yes to access the panel for applications' creation from the Storage editor, if you like.

    

Transactions will appear in the Home in the Storages sub-panel.

Create the Application Personal Budget

The Storage Transactions for the Personal Budget application is ready.

Now, you must create the application Personal Budget that works with the data in Transactions.

1. Go back by clicking on Applications through the taskbar to the Applications.

   

2. Click on the Add Application button to create a new Application.

3. Click on Smart Explorer template to continue. Most of eLegere applications are Smart Explorer applications.

   

   The other templates Report and Logical App cover some particular cases beyond the goal of the Get Started. (The eLegere Documentation explains them in the Advanced Features section.)

4. You must choose from the list the Storage to retrive and record data. Choose the storage Transactions that you have created before.

   

   Note

   The other Storages are System Storages: eLegere creates them automatically to manage Users, Groups, and Applications' Statuses. They aren't employed in this tutorial.

5. You will arrive in the configuration settings for the application. Name the application Personal Budget by typing in the Name textbox.

   

6. Click on the taskbar on the left on Tile Theme. Customize like a Storage the appearance of the application in the Home Panel.

   

7. On the top-right corner, click on the Save and Open button to complete the creation and access Personal Budget.

Congratulations, you have built your first application Personal Budget!

Personal Budget records the expenses you have made.

You will learn how to record and save data in the next tutorial of eLegere. For the moment, click on the icon on the upper-right corner to exit the application.

Success

The next step is learning how to manipulate data in an eLegere application: Record Your Expenses in the Application