Setting Parameter Values
As you configure your Snippets and Workspaces you will encounter different ways of configuring values depending on the requirements set by the dsTest schema.
All configuration sections have a context menu icon that lists all the elements that can be configured in that section. Click on the icon to display a menu. When the menu is visible, clicking anywhere in the application window (except for the menu or icon) or pressing the Esc key will hide the menu. Keyboard up/down arrow keys can be used to select menu items with Enter acting as the mouse click. If the menu contains more than 10 items it will display up/down arrows as the first and tenth menu items. Hovering the mouse over either arrow or using an arrow key to select an item causes the menu to scroll in that direction one item at a time. The menu will disappear after a selection is made but if you had scrolled the menu it will open to the same position that was last visible. Place a check next to each of the desired elements and complete the configuration of each element. Checking an item may cause more configurable sections to be displayed. Be sure to complete the configuration of all elements in all sections.
Check boxes are used to include optional parameters or optional structures (i.e., elements defined with minimum occurrences equal to 0) and will enable or "turn on" the element's associated parameter field or parameter section respectively.
Selection lists are used when enumerated values are defined for an element, as shown in Elements with Multiple Occurrences below.
Text fields are used when a string, hexadecimal, or numeric value is required, as shown in the example to the right. Text fields support copy/paste functionality with standard control key combinations - Ctrl + c and Ctrl + v.
Multi-line text blocks are used when a text or XML value is required. When a user-supplied XML structure is required (e.g., Service Data in the IMS Profile) a Validate button is displayed above the text field. Clicking the button will validate the contents of the field against the standard XML schema to ensure that the field contains well-formed XML, and this step must be performed in order for the element to be considered valid.
All fields display help text when a mouse hovers over the field. The short description from the Online Help is displayed in the help text, and the help text for text fields includes any value restrictions defined in the schema as shown above.
The F1 key can be used to obtain more detailed help for a configuration element. In the figure below, with the element 'IMSI' highlighted on the schema tree, hitting F1 displays a panel at the bottom of the workspace that gives the online Help available for IMSI, including its usage in dsTest various applications. The Help panel can be closed by hitting the escape (Esc) key.
F1 for Help also works if a configuration element is highlighted in the configuration workspace.
The F3 key provides easy navigation between tree structure element and its corresponding configuration element in the workspace window. Just highlight an invalid entry in the tree to the left and hit F3. You will be taken to the area of the workspace that corresponds to that configuration element.
The fields used to define the attributes of an element are displayed on a shaded background; the fields used for element values are displayed on a white background.
Elements with Multiple Occurrences
When an element is defined with maximum occurrences greater than 1, you can manage those instances by clicking on the Manage Instances button. You will be given a dialog that allows you to Add, Move, or Remove instances of the element you are configuring. You should always give each instance of an element a unique name.
Complex Elements with Multiple Instances
Once the instances of a complex element are created/configured, you are shown the number of instances configured and a View Instance drop-down selection list that displays the available selection by name. Select the instance that you want to be displayed in the workspace by clicking on the instance name in the drop-down list.
Simple Elements with Multiple Instances
Multiple instances of a simple element are configured using a table as shown in the image below. Each instance is displayed in a table row and the table columns contain the element values and the values of any attributes.
Subscriber Group Profiles - Multiple Instances
When creating subscriber group profiles, you can manipulate instances with the Add/Move/Remove dialog, or create a new profile and assign it to a subscriber group with one action with the dialog shown on the right in the image below. After creating the new instance of the profile, you should check all the configuration of the profile to make sure it is configured the way you want and give it a unique name.
Subscriber Group - Multiple Instances
When working with Subscriber Groups, you can use the Add/Move/Append action, or use the option to create a new subscriber group and assign existing group profiles to the new subscriber group with one action, as shown below. After creating the new subscriber group, it should be inspected to insure that it is configured as desired, along with having a unique name and to insure that the correct subscribers are allocated to the group as needed.
Elements defined in the schema with unlimited occurrences (*) are limited to 50 instances in dsClient Desktop.
Choosing Between Elements
In some areas you can choose one parent element from a list of options. For example, in the OCS Node you can choose to support either the Diameter Credit Control Application or the 3GPP Credit Control Application. When you select an option from the Choice list, its attributes and child elements are displayed as shown in to the right.
In other areas you can configure multiple choices. In that case the choice list is displayed in a table as shown in Elements with Multiple Occurrences above, and the configuration of the element is displayed below the table when you select its row.
Searching the XML Tree
If you have trouble locating the element in which you are interested, you can use the XML Tree Search Feature. Refer to Searching the XML Tree.