Desktop

So far, you have created the backbone of the application. Now it can register financial operations. At this point, the application is simple but not user-friendly.

Look at the main application window.  

Figure 6-1. Desktop 

The desktop is empty. To add a new document or catalog item, a user has to guess where to click. Of course, a user would not feel comfortable using this application. In this chapter, you are going to improve the workspace.

First, create a user workspace, which will be the starting point for user work with the application: the desktop form. Note, that before this time the platform generated all screen forms "on-the-fly" based on content and specifics of catalogs, documents, and registers we created.

According to the master class specification, the application should provide fast recording of incomes and expenses and efficient balance and turnover control. Those are the features that should be within the reach of the user's hand, they should be placed on the desktop.

Return to Designer mode, expand the Common metadata tree branch, right-click Common forms, and then click Add  (Ins). 

Figure 6-2. Adding a new common form 

Click Generic form, type the name Desktop, type the synonym My money. Then click Finish

Figure 6-3. Common form parameters 

Continue setting up the form in the form editor that is opened. 

Figure 6-4. My money common form 

By the project requirements, a user should see account balances and turnovers by categories. For this, add two tables with the required rates to the form.

First, the table with account balances. Add a new form item: Balance. Click Add attribute  (Ins). 

Figure 6-5. New form attribute 

In the form property palette, type the Balance name and select the ValueTable type. 

 

Figure 6-6. Balance form attribute 

Then add two columns to the Balance attribute. To add a column, click Add attribute column

 

Figure 6-7. New attribute column 

Name the first column Account. In the property palette, select CatalogRef.Accounts

Figure 6-8. Account attribute column 

Name the second column AmountType is Number, length is 10, Precision is 2. 

 Figure 6-9. Amount attribute column 

It is time to place the created attribute (the Balance table) to the form. Drag it to the form or to the Elements pane. 

Figure 6-10. Placing the attribute on the form 

The platform prompts you to add the table columns. Click Yes. 

 

Figure 6-11. Balance table on the form 

Now you can see the table on the form in the preview area in the lower part of the form editor (see figure 6-12). 

Figure 6-12. Form preview 

Now add the second table, which will show turnovers by categories.

Add a new attribute and name it Expenses. The type is ValueTable

Figure 6-13. New attribute 

 

Figure 6-14. Expenses attribute 

Add two columns: Category of the CatalogRef.Categories type and Amount of the Number type, Length is 10, Precision is 2. You can copy(Ctrl+C, Ctrl+V) the Amount column from the Balance table.   

Figure 6-15. Category attribute column 

 

Figure 6-16. Amount attribute column 

Now place the created attribute (the Expenses table) on the form. Drag it to the form, confirm to add columns, and check whether the Expenses table is placed under the Balance table. You can move form items by clicking Move up  (Ctrl+Shift+Up Arrow) and Move down  (Ctrl+Shift+Down Arrow), or by moving them in the preview pane. 

 

 Figure 6-17. Placing the Expenses table 

 

Figure 6-18. Moving buttons 

As a result, the desktop form contains two tables (Balance and Expenses), one under another. 

Figure 6-19. Desktop form 

It is time to declare our form as a desktop form. In the property palette, find the Home page work area and open it for editing.

  

Figure 6-20. Home page work area 

In the Home page template list, select One column.  

Figure 6-21.  Home page template 

To add the Desktop common form, click Add  (Ins), expand the Common node, then expand the Common forms node, click Desktop, and click OK.

Figure 6-22. Adding the common form to the desktop 

Run the application in 1C:Enterprise mode, confirm the changes. Take a look at the result. 

Figure 6-23. Desktop in 1C:Enterprise mode 

The desktop became more useful, the user can control the flow of funds and account balance, and rapidly get catalog and document data to register financial activities.

Note. The desktop content looks pretty poor. It is striking on the personal computer when you develop the application. However, remember that you are developing a cross-platform mobile application. You do not know on which device a user will run your application, would it be a tablet with a big screen or a smartphone with a small one. That is why in the current application you should expect the worst, develop the desktop for a mobile device with a small screen.

Try to register some activities. It will help you check whether the application is easy-to-use.

There is a list on the left:

  • Accounts
  • Categories
  • Expense
  • Income

 

Figure 6-24. Navigation panel list 

First, register a money receipt. On the navigation panel click Income, and then click Create (Ins) in the empty list of incomes. 

Figure 6-25. Creating a new Income document 

Register, for example, a part-time job salary of 100 received on a bank account. In the window of the new document fill the Amount field. Proceed to Account

Figure 6-26. Amount is filled, proceeding to Account 

Catalogs are empty for now and do not contain any data, it is necessary to fill them. In the 1C:Enterprise platform there are a lot of easy-to-use ways to do it:

  • On the navigation panel, click Accounts. In the list of accounts create a new item (click Create, see figure 6-27). Then select the created catalog item in the document.
  • In the document window, click Select  button of the Account field and then click Select (figure 6-28).
  • Select the Account field and then press F8 (figure 6-29).
  • Select the Account field and start typing a name. If the platform cannot find an item with this name in the catalog, it suggests you create a new one (figure 6-30).

Figure 6-27. Creating a new Accounts catalog item in the separate list

 

Figure 6-28. Creating a new Accounts catalog item with the Select button

 

Figure 6-29. Creating a new Accounts catalog item with F8

 

Figure 6-30. Creating a new Accounts catalog item by typing an item name

Try the last way. This way is the most comfortable because you do not know whether a user remembers, is there the item or it is a new one. The platform attempts to find the item by the typed characters, and if it doesn't, it suggests to create it.

Type Bank account in the Account field.   

Figure 6-31. Creating a new Accounts catalog item

The 1C:Enterprise platform didn't find the required item in the catalog and suggests to create it. Do it. 

Figure 6-32. New Accounts catalog item

You can see that Desctiption of the item we are creating is filled automatically. Click Save and close and check out whether the Account document field is filled with the created item.

Figure 6-33. Selected account

Proceed to Category. The platform has a similar behavior as in the Account field.

Figure 6-34. Selecting a category from a catalog

Create a Part-time job catalog item. Use any method you like. However, check that it is in the Income group. You can select a group of the item in the Parent field. 

Figure 6-35. New item of the Categories catalog

You can always change item parameters, just open it by clicking the Open  button in the document window. Also, you can find the item in the catalog list and double-click it.

Figure 6-36. Opening the catalog item

Your first document is almost filled. If you want, type a memo. Then click Post and close to save the document and make changes in the registers.

Figure 6-37. Saving and posting the document

Once the window is closed, you can check out lists of the catalogs and documents to see whether all data we provided is on its place.

Record one more financial event: withdrawing cash from an ATM. In fact, it is a transfer from one account to another.

In your application, the transfer is recorded with the Expense document. Create one. Let the amount be 30. The source account is Bank account and the target account is Cash.

Click Expense and then click Create.

Figure 6-38. Creating the Expense document

Type 30 in the Amount field and proceed to Account.

Figure 6-39. Amount is typed, proceeding to Account

In the Account field, select the Bank account, which already exists. You can start typing it and then click the found item in the list of matching values.

Figure 6-40. Selecting the account

In the Purpose field the platform prompts you to select the value type: Accounts or Categories. Select Accounts to record a transfer.

Figure 6-41. Selecting the target type

Add a new item: Cash. Save it and select it.

Figure 6-42. Target account

If you want, type a memo, then click Post and close to save the document and make changes in the registers.

Figure 6-43. Saving and posting the document

Check that all provided data is saved (the Expense document and Account catalog item). Now you can return to the desktop and check whether data is in the tables that must show financial indicators.

Figure 6-44. Desktop state after the documents have been posted

The tables are empty. Maybe the registers have been filled wrong? Check it out. Now it is not easy to get register records. The 1C:Enterprise platform normally hides these lists because they are not really useful for users. However, at the debugging stage, this data is useful for you.

Click Main Menu  and then click All functions.

Figure 6-45. All functions

Expand the Accumulation Registers branch of the metadata tree and then click Accounts. The Expenses register is not interesting for you now because you have not made any expense records yet.

 

Figure 6-46. Accounts register

Figure 6-47. List of Accounts register records

You can see that the documents made their records correctly. The first document (Income) created one register record, which contains information about a receipt of 100 to Bank account. The second document (Expense) created two register records, which contain information about an expense of 30 from Bank account and a receipt of 30 to Cash. The predefined category Transfer was used, as we designed.

What is the matter? Why are the desktop tables empty? The point is that the desktop tables know nothing about register records. For filling the desktop tables, you have to program logic of their filling in the 1C:Enterprise script.

Next page: Improving desktop functionality

Be the first to know tips & tricks on business application development!

A confirmation e-mail has been sent to the e-mail address you provided .

Click the link in the e-mail to confirm and activate the subscription.