Addressing Phones¶
In order to assign phones to a test case, they must first be installed and configured.
Note: Information on how to prepare phones for use with intaQt can be found in the Device Installation and the intaQt Mobile App section.
Phone Assignment¶
Phones should be assigned at the start, thus before running a test case. Specific phones can be addressed, or they can be chosen randomly. If a specific phone is not addressed, intaQt will randomly select a free phone from all available phones (both local and remote).
Note: Information about allocating multiple phones can be found in the Addressing Phones - Compound Step section.
Phone Assignment Type |
---|
Random Selection |
Addressing Specific Phones |
Addressing Phones with Profiles |
Random Selection ¶
Syntax
1 | a[n] <phoneType Identifier> phone as <name Identifier> |
-
phoneType - Can be one of
Android
,Snom
oriOS
- iOS Phones may only be used with Mac OS computers that have Xcode installed
- They can only be used for Apptests
-
name - The name assigned to the phone
Example
1 2 | Given an Android phone as A And a Snom phone as B |
Addressing Specific Phones ¶
Specific phones (local, remote or Snom) may be addressed by defining additional criteria after declaring the phone type.
Note:
If intaQt is running, a full list of available properties can be accessed by default at localhost:8080/phones
. Further information about the port configuration can be obtained in the HTTP section.
Syntax
1 2 | a[n] <phoneType Identifier> phone as <name Identifier> where <criterion Expression> <operator Operator> <value String> |
Parameters
-
phoneType - The device (such as Android, Snom or S5) that is being addressed
-
name - The name assigned to the phone
-
criterion - The criterion that the phone selection is based on, which is an expression
- For example, phone properties (such as phone number, MSISDN or serial number) or subscriber properties
-
operator - A Comparison Operator or Logical operator used to compare the criterion against its value
- For example
==
for equal or!=
for not equal
- For example
-
value - The selection criterion, such as the assigned phone's telephone number or network operator
Example
1 2 3 4 | Given an Android phone as A where number == "+431234567" And an Android phone as B where nop == "o2" And an Android phone as C where number == "+432222222" && nop == "tele2" And an Android phone as D where tariff == ${tariffUnderTest} |
-
number
,nop
andtariff
are criteria -
==
is a comparison operator -
&&
is a logical operator -
The number (assigned to
phone A
andC
) or network operator ( assigned tophones B
andC
) are the values
Addressing Phones with Profiles ¶
Profiles enable addressing a phone with multiple properties. Configuration details are available in the Profiles section.
Syntax
1 | <phoneType Identifier> with profile <profile Identifier> |
-
phoneType - Can be one of
Android
orSnom
-
profile The name of the profile, as defined in the the configuration file
The example below randomly selects a phone from the profiles configuration if more than one phone is available. Example
1 | Given an Android phone as A with profile ProfileA |
Addressing a Specific Phone with Profiles¶
Syntax
1 2 | <phoneType Identifier> with profile <profile Identifier> where <criterion Expression> <operator Operator> <value String> |
-
phoneType - The device (such as an Android, Snom or S5) being addressed
-
profile The name of profile, as defined in the configuration file
-
criterion - The criterion that the phone selection is based on, which is an Expression
- For example, phone properties (such as phone number, MSISDN or serial number) or subscriber properties
-
operator - A comparison operator or logical operator used to compare the criterion against its value
- For example
==
for equal or!=
for not equal - A list of operators can be found in the Operators chapter
- For example
-
value - The selection criterion* such as the assigned phone's telephone number or network operator
Example
1 | Given an Android phone with profile ProfileB where nop == "tmobile" |