Skip to main content

Apps

An app is a small program designed to fulfill a very specific business task. In Vecticum, you can configure your own apps from the predefined building blocks (object types, forms, views, workflows, user roles, etc).

To create a new app, go to Administration > Metadata > Apps and select New App.

First, edit general settings of the app.

SettingDescription
NameName of the app.
IconYou can specify an icon that will be used for this app.To choose an icon, go to Font Awesome (https://fontawesome.com/icons?d=gallery&m=free) and search for the icon you want. Open the icon and copy here the icon class name, e.g., far fa-file-alt.
DescriptionDetails about the app.
Objects included into appHere you have the list of all object types - built-in and user-created - that are available to you. Select those that you want to include in the app.

Once the general settings are saved, sections for configuring navigation items for the app, app buttons, app stats and app roles will be displayed.

In this section, you'll configure how your app will be accessed from the main menu of your company's system. When you edit the general settings of the app and save them, the app is created but not yet visible in the menu. To make the app displayed in the menu and visible for users, you have to create navigation items and specify which user roles will have the access to them.

Please follow the below URL in order to navigate to Navigation Item setup description:

Navigation Items

App buttons

App buttons are displayed in the Home page for easy access of app features that you need most often. You can add several buttons of different apps in the Home page.

To create a new app button, select New App Button.

SettingDescription
LabelName of the button.
Object typeObject type that the button refers to.
ClassClass that the button refers to. When selected, the button will open a form that is specified in the class.
OrderSequence number of the button (1st, 2nd, etc). If there are several buttons, they are all positioned in one line. With sequence number you can edit their order.

App stats

App stats are small widgets that calculate statistical data. These widgets are displayed in the Home page for easy access of most commonly used statistical data. You can add several stat widgets of different apps in the Home page.

To configure new app stats, select New App Stats.

SettingDescription
NameName of the stats counter
TypeChoose one of available stats.
OrderSequence order of the stats counter (1st, 2nd, etc).
ParamsJSON object that will be calculated for app stats.If there are several stat widgets, they are all positioned in one line. With sequence number you can edit their order.

App roles

For each app you can create dedicated roles and use them to control who can see and access app features.

When a role is created here, you have to do two things: set this role for a navigation item and assign the role to users. When assigning a role to a navigation item, you control which group of users will be able to access this part of the system. When assigning a role to users, you create this control group.

To create a new role for the app, select New Role.

SettingDescription
NameName of the role.
AppApp for which you are creating a role. Current app is set by default.
DescriptionDetails about the role.