Using SDK, you can implement your own tools and features and add them to your Wialon as additional applications.
Applications can be managed only by top users. The Apps configurator item of the user menu allows you to do this. Click on this item to open the Apps configurator dialog. It contains two tabs: Installed and Library. On these tabs, you can have a look at all the available applications, as well as configure and add new ones.
Installed
The list of added apps is displayed on the Installed tab. To add a new application, click Add and indicate the information described below.
Name
Enter the name of the application (at least 4 characters). It is displayed in the lists of available applications, as well as in the heading of the application when it is open.
Description
Enter any description of your app (optional).
URL
Type the URL where the application is hosted. Name and URL are mandatory, other parameters are optional.
Advanced URL parameters
If necessary, select advanced URL parameters. It is required to enable the Active SID or Authorize hash option so that users can log in to the application.
Advanced parameter | Description |
Active SID | Enable this option to configure authorization by SID. With this authorization type, the user is not logged out of the application after a page refresh. |
Current user | Enable this option, so that the URL contains the username that was used to log in to the application. It might be helpful, if the user logs in to Wialon using the Log in as button. |
Base URL | This option doesn't affect the configuration of applications in Wialon Hosting. |
Host URL | This option doesn't affect the configuration of applications in Wialon Hosting. |
Language | Enable this option if you want the application interface to be in the same language that is selected in the user settings in Wialon. |
Authorize hash | Enable this option to configure authorization by hash. With this authorization type, the user is logged out of the application automatically after a page refresh. |
https://ecodriving.iot-platform.online/latest/?sid=026085dce21dcf6120bcfa1d922fda20&b=stable&authHash=0135c58bd6702db42c962e0126f00ebd&hostUrl=https%3A%2F%2Fcms.wialon.com&user=AliceNorris&v=1.51&baseUrl=https%3A%2F%2Fhst-api.wialon.com&lang=en
Some features are not implemented in some of the applications. If a feature is not implemented, its activation doesn't affect the application configuration.
Required services
Select services (features) which are required for the default activation of the application. If the list of features available to a user does not match this list (or if you leave this section empty), the application is disabled for the user.
If the application is activated in the account properties, but any of the required services is disabled, this application is not available to the user.
Billing plans
Select the billing plans for which this application should be available.
Compatible languages
You can restrict access to the application for various interface languages. For example, if the Russian language is selected, this means that the application is available only when the Russian language of the interface is selected. If nothing is selected, it is assumed that the application should be available to all languages.
After setting all the parameters, press Add and when closing the dialog click OK to save the changes.
Actions with applications
To edit an application, select it on the left, change the parameters, press Apply, and then, when closing the dialog, click OK.
To delete an application, select it on the left and press Delete. Then, when closing the dialog, click OK.
To create a new application by copying, select the sample application on the left and press Copy. Edit the parameters, click Apply, and then, when closing the dialog, click OK.
To ignore all the changes made, press Cancel.
After adding an application, its name is shown in the format Apps: Application name on the Services tab of the billing plan and account properties. For example, Apps: Hecterra. If you disable this service, the application is removed from the monitoring system menu, but the application itself remains available.
Adding an icon for your own application
If you add your own application and you want your icon to appear in the Apps list in the monitoring system, do the following:
- In the application folder on your server, create the app folder.
- Save the image for the icon under the name logo.png. For example, the storage address of an icon could be as follows: http://your-app/app/logo.png
- Make sure that the DNS monitoring site and the application have the same protocol, such as HTTP only or HTTPS only.
As a result, once your application is added, this image will be used as its icon.
Library
On the Library tab, you can select a suitable application and add it with a single mouse click. Adding an application from the library is a little bit easier because all the mandatory parameters and the advanced URL parameters are indicated by default.
The list of applications is on the left. To the right of the list is a field that displays the current information for the application selected in the list. This information includes the following: application icon, its name, short description, URL, and release date. To add an application from the library, you must select it from the list. Then, if this application is not already installed, the Add button is activated below the description. To complete the procedure click Apply and then OK.
See also Wialon apps review.
Starting applications
To start an application, click on the Apps item in the top panel. A menu opens that lists all available applications (in alphabetical order). The dynamic filter is used to quickly find the necessary one. Click on the app's name to open it in a new tab of the browser.
Download PDF file
Download Word document