Application Templates

An application template is a complete application configuration that simplifies application creation. You want to use application templates to create applications faster for new customers automating the configuration and minimizing manual tasks.

What is saved in an application template?

The template application contains the following configurations, which will be replicated in the new application.

Application Properties that are stored in the application template: 

• Email limit

• SMS limit

• Logout URL

• Live data refresh rate

• Notify if the limit is reached

Application users/assets are not saved into a template.

Warning: Please don't set the default device-mapper under the user type editor on the application template. The device mapper will be used on the newly created application instead of the device mapper of the newly created application. That could cause an issue with the trip and distance. 

Save an existing application into a template

Use this feature if you want to save a current application state into a template that you can later use to create new applications.

To save an application into a template, follow these steps:

1. Click on an application name to access its properties

2. In the upper right corner, click on Templates and select Save as Template

3. Wait until the template is created

Now your new template is ready to use when creating a new application!

Convert an application into a template

Warning: use this option carefully. It converts an existing application into a template. It doesn't remove the application and its data but keep in mind that you won't see the application listed as such in the applications list, but rather under the Templates option checkbox.

To convert an application into a template, follow these steps:

1. Click on an application name to access its properties

2. In the upper right corner, click on Templates and select Convert to Template

Now your application is converted into a template!

If you want to revert this situation read how to convert a template back into an application.

Accessing all your templates

If you want to configure your templates, you can do it by selecting the Templates option under Applications -> Manage Applications

How to edit the template properties

If you want to edit the template properties, follow these steps:

1. Click on the row of the template you want to edit/remove

2. After modifying any of its properties, Save it

Exporting templates list

To export the list of the templates, go into Applications -> Manage applications and click on Export in the upper right corner. 

Exporting templates

To export the template, go to Applications -> Manage Applications -> Templates. Click on the "export to xml" button for each template. The exported template could be imported on another GpsGate server. 

Assigning Templates to Newly Created Applications

There are 2 ways you can create a template from an existing application and use it for all other applications that you create later on.

Saving as a Template

You can save the existing application as a template and use this template for all other applications that you create late on. Even if you delete this existing application, the template remains in the list of templates.

Converting into a Template

1. Firstly, convert the existing application into a template.

2. Then, create a new application based on this template.

3. Now, edit the application as you wish so that all other applications created with this template from now on will have these changes.

4. Convert this application into a template.

5. Use this template to create all other applications.

Adding a Template’s Configurations to Another Application (Synchronisation)

To merge configurations from one application (App A) into another existing application (App B) using the Synchronize feature.

Steps

1. Convert App A into a Template
   • Navigate to Manage Applications > Select App A > Convert/Save as Template.
2. Apply App A’s Template to App B
   • Navigate to:
     Main Menu > Site Admin > Applications > Manage Applications > Select App B
   • Click the drop-down beside Templates (top-right corner) > Select Synchronize.
   • In the synchronization window:
     • Select App A’s template.
     • Click Save.

Behavior of Synchronization

• Objects Added:
  All objects from App A’s template (e.g., workspaces, event rules) are added to App B.
• Objects Not Removed:
  Existing objects in App B are not deleted or overwritten.
• No Duplicates:
  If both apps have objects with the same name (e.g., an event rule named “SOS”):
  • The existing object in App B remains unchanged except for updated properties like Email/SMS limits.
  • The object is not duplicated.
• One-by-One or Bulk Sync:
  Synchronization can be done per application or in bulk with the help of Batch Edit feature in Site Admin Legacy.

Note

• Safe Operation: No loss of existing data; only additions and partial updates (e.g., limits).
• Selective Overwrite: Configuration properties (like limits) may get updated if names match, but core content remains.