Editing a Configuration

Navigation:  Managing the Account > Applications > Configurations >

Editing a Configuration

Previous pageReturn to chapter overviewNext page

 

Overview

 

It is possible to edit the details of a configuration, as long as the configuration is not associated to a deployment. If the configuration is, already, part of a deployment plan, by editing it, you will be creating an incremented version of that configuration.

 

Step-by-step

1. In the Admin Dashboard's "Control Panel", click Applications button, and, in the resulting row, select Configurations Sub Module Button and view the list of configurations created within the account.

 

Account Configurations0

 

2. Click the name of the configuration you want to edit (displayed in light blue).

 

Account Configurations det0

 

3. The resulting "Configuration Details" page is in view mode. Click Edit button to set the page to edit mode.

The "Properties" tab is open, by default.

 

NoteIf the configuration being edited is associated to a deployment and the deployment has started, the following message is displayed:

Note for new config version

The editing will result in an incremented version of that configuration.

 

Account Configurations Edit1a

 

4. Edit the available options and make sure that the mandatory fields (marked with an asterisk) contain information:

 

Name

The configuration's name. This field is NOT editable.

Version *

Define a new version number. If you edit a configuration, already involved in deployments, and do not change it, when you save your modifications, the version number will automatically be incremented.

Device Model

The configuration's target device (manufacturer, model and OS version). This field is NOT editable.

Qualification

If required, change the configuration's qualification. See Qualification.

 

"Production" - for configurations that are used in the customer's working environment, for day-to-day tasks.

"Acceptance" - for configurations to be applied to sites (and its device groups) with an "Acceptance" qualification for specific testing purposes.

"Test" - for configurations that contain application/resources that will be used for general tests.

"Development" - for configurations to be used in a development environment.

 

TIPRemember that the selected qualification affects the configuration's usage:

A "Production" configuration is to be used in "Production", "Acceptance", "Test" and "Development" qualified site(s) with "Production" qualified application(s) .

An "Acceptance" configuration is to be used in "Acceptance", "Test" and "Development" qualified site(s) with "Production" and/or "Acceptance" qualified application(s) .

A "Test" configuration is to be used in "Test" and "Development" qualified site(s) with "Production", "Acceptance" and/or "Test" qualified application(s) .

A "Development" configuration is to be used in "Development" qualified site(s) with "Production", "Acceptance", "Test" and/or "Development" qualified application(s).

Site Restriction

If required, restrict access of this particular configuration to a site or available to all sites. This option is only available if, at the moment of editing, the configuration is not associated to a deployment.

Description

Maintain or edit the displayed information. These notes are displayed in the "Description" field of a "Configurations" page.

 

5. Go to the "Firmwares" tab.

 

6. The editable options available depend on the selected Firmware product.

Below are some examples:

 

hmtoggle_plus1Click for Details on the "Firmwares" Tab without Firmware Options:

 

Firmwares tab with firmware options:Click for Details on the "Firmwares" Tab with Firmware Options:

 

 

Note

When editing the TTS languages, do NOT select/add a standard and a compact TTS file for the same language/gender. The device will NOT run both files, it will ONLY use the more recently downloaded TTS language file.

 

7. Go to the "Applications "tab.

 

Account Configuration Details App Tab Edit

 

8. The "Applications" tab displays the applications included in the configuration.

Each application also displays its internal resources. You can click the corresponding "associated resources" option (which is displayed in light blue) to access those resources' details.

 

There are several operations available:

 

hmtoggle_plus1Click for Details on Adding Applications to the Configuration

 

hmtoggle_plus1Click for Details on Importing an Application into a Configuration

 

hmtoggle_plus1Click for Details on Removing Applications from the Configuration

 

hmtoggle_plus1Click for Details on Adding Resources to an Application

 

hmtoggle_plus1Click for Details on Removing Resources from an Application

 

9. Once you have completed all the necessary changes in the "Applications" tab, proceed to the "Others" tab.

 

Account Configuration Details Misc Tab Edit

 

10. The "Others" tab allows you to:

 

hmtoggle_plus1Click for Details on Adding Resources to a Configuration

 

hmtoggle_plus1Click for Details on Removing Resources from an Application in a Configuration

 

hmtoggle_plus1Click for Details on Downloading Resources from an Application in a Configuration

 

hmtoggle_plus1Click for Details on Changing Application's Resources Order in a Configuration

 

11. Once you have entered the required modifications, click Confirm button to apply them. The page returns to view mode and displays the modifications.

 

NoteTo have a configuration deployed into devices, you must create a deployment plan. For more detailed information, see Creating a Deployment.

 

 

See Configuration Examples.

 

 

Possible Error Message(s)

 

Error Message_Invalid Application File

 

Occurrence: When trying to upload an imported application.

Cause: The imported file does not have a .pdk extension.

Action: Repeat the import operation and select a file with the correct extension.

 

Error Message_No destination Path

 

Occurrence: When clicking Confirm button.

Cause: The added resource does not have a .pdk, an .apk or .cab extension and no path was provided. Without the path, the file cannot be located.

Action: Enter a path to locate the file.

 

Configuration Error Message02

 

Occurrence: In "Step 2: Firmwares" when clicking Button_Next to continue.

Cause: The selected firmware option has options but none was selected.

Action: Select at least one option of the available firmware options.