Home screen

From Resco's Wiki
Revision as of 15:38, 8 October 2019 by Jzambor (talk | contribs)
Jump to: navigation, search
Wikipedia logo
Wikipedia has an article on a similar subject:
User interface components

Home screen, or simply Home, is the main screen of mobile apps. It often serves as the menu that allows user to easily access the main functions of the app.

The home screen of Resco apps can be customized via Woodford. It is defined within app projects. Each app must have one home screen.

Editing home

To configure the home screen of your app, edit the app project and select Components > Home screen from the Project menu.

The Available Items pane on the right displays items that can be linked from your home. The list contains all entities, plus several additional elements, such as hubs or maps. Select any item and click Add to add it to the menu. Each item can be added multiple times, for example in case of entities, each entry can point to a different view.

Additional menu items are available from the toolbar:

  • Add IFrame
  • Special IFrame
  • Create New: Opens a form for creating a new entity record.
  • Open Existing: Displays a particular record.

The following toolbar buttons allow you to further customize the menu:

  • Use Move Up and Move Down to reorder menu items.
  • Click Rename to change the label for the menu item.
  • Click Remove to delete an item from the menu.
  • Click Design to modify the looks of the menu item (size, color, fonts, etc.).

Properties of items on home

Double-click an item on the Home screen to display its properties. The properties are organized into multiple tabs:

Public View tab
It displays the views that are enabled/available to users when they open the Home entity item. E.g. user can have more than one Home item of the same entity, each with different views.
Charts tab
If you define any chart for the entity, you can specify which charts will be enabled/available for users. You can specify which enabled chart, will be used to visualize data.
Calendar tab
If you have a Date field defined for at least one of the views that’s enabled on the Home item, you may flip the view to calendar view. If it is the case, you can specify the calendar properties on this tab.
Properties tab
Here you can define whether users will be able to create new records (option Create New), and what options to flip the view the users have, and how to visualize records. For example, if you allow only a Chart (option Show records as Chart), users will only see the defined chart. If there are more charts enabled on the Charts tab, you can switch between different charts, but not between different ways of visualizing records, only as Charts.
You can also define the initial control, a way of displaying records when you select the Home item.
Map tab
Since Woodford version 10.2. it is possible to set up initial map position and zoom when switching from list view of entity to map view. To set it up, select Home from the Project menu, double-click an entity to display its properties, go to the Map tab and enter initial coordinates or use ‘From Map’ option to manually choose initial map position and zoom directly from the map.
Note: Initial map position and zoom can be also defined for Associated Views (Tabs) of entities. To set it up repeat the process described above for Associated View which can be found on entity’s edit form.

Home groups

You can group home items (entities and other features) under custom groups. This effectively allows you to create nested menus.

To add a new group, click Add Group. This displays a new Groups pane on the left of the Home pane.

Root, as the name suggests, is the main level of the home items and groups (visible at the start of application). A sub-level for the groups can be created by clicking on a group in the Groups section and then clicking again on the Add Group button.

Note To rename or remove a group, you have to select the group in the Home pane (not in the Groups pane) and then you can select Rename or Remove from the toolbar.

Groups can also have their own images, just like any other entity. When adding image, use the same name as is the name of the group.