Device setup command
Sets the environmental properties of the device. Available properties: Location, Orientation, Network and Background applications.
To use this command, you must specify a persona, either by defining a predefined persona or a repository key of a custom persona. Define the properties in the persona by using other parameters (Network profile, Location, Background applications, and Orientation). To set the device location, specify either the location address or latitude and longitude coordinates.
Parameters
| Name | Type | Possible values | Description |
|---|---|---|---|
|
Device ID* |
Device |
|
The device for this command. By default, this is the device under test (DUT). |
|
Persona |
String |
Georgia | Peter | Ross | Sam | Sara | Empty |
The name of a pre-defined persona. |
|
Persona repository file |
Media |
The repository key of a defined persona json file in the media repository. When using commands that utilize files from the repository, the paths to the files are specified as repository keys. A repository key consists of the subarea and the path to the file. For example, to specify a file called myImage.jpg stored in the images folder located in the PRIVATE subarea, specify the key as You can select a file that already resides in the Perfecto repository or select a file from your computer that is then uploaded to the Perfecto repository. To learn more about the Perfecto repository, see Manage the repository. Click the Select media link, browse to the file, and then click SELECT. |
|
|
Orientation |
String |
Portrait | Landscape | None |
The device screen rotation state. |
|
Network profile |
String |
2G GPRS Good | 2G GPRS Average | 2G GPRS Poor | 2G Edge Good | 2G Edge Average | 2G Edge Poor | 3G UMTS Good | 3G UMTS Average | 3G UMTS Poor | 3.5G HSPA Good | 3.5G HSPA Average | 3.5G HSPA Poor | 3.5G HSPA PLUS Good | 3.5G HSPA PLUS Average | 3.5G HSPA PLUS Poor | 4G LTE Good | 4G LTE Average | 4G LTE Poor | 4G LTE Advanced Good | 4G LTE Advanced Average | 4G LTE Advanced Poor) | Offline | Bandwidth Good | None |
The virtual network profile. Example: 4G LTE Advanced Good For more details on network conditions, see Network conditions for network virtualization. |
|
Location (Address) |
String |
The address location of the device to set. Format: Google Geocoding Example: 1600 Amphitheatre Parkway, Mountain View, CA |
|
|
Location (Lat, Long) |
String |
The latitude and longitude coordinates of the device location to set. Example: 43.642659,-79.387050 |
|
|
Background applications |
String |
The list of applications to run in the background. Example: American Airlines, Twitter, Outlook |
|
|
Comment |
String |
Adds a comment to the script |
|
|
On-fail Result* |
Condition |
Ignore | Break | Continue | Abort | Catch |
The behavior when the command fails. |
* Mandatory parameter