Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Part Number
VRTM-T2-750-DOC Innovative Technologies, Inc.
ITI does not warrant that the Virtual Rack® software package will function
properly in every hardware/software environment. Virtual Rack® may not
work in combination with modified versions of the operating system, in
conjunction with certain memory-resident programs, with certain print-
spooling or file facility programs, or with certain printers supplied by
independent manufacturers.
Although ITI has tested the software and reviewed the documentation, ITI
MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR
IMPLIED, WITH RESPECT TO THIS SOFTWARE OR DOCUMENTATION,
THEIR QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS
FOR A PARTICULAR PURPOSE. AS A RESULT, THIS SOFTWARE AND
DOCUMENTATION ARE LICENSED "AS IS", AND YOU, THE LICENSEE,
ARE ASSUMING THE ENTIRE RISK AS TO THEIR QUALITY AND
PERFORMANCE.
The Virtual Rack® software has U.S. and International Patents Pending.
VR TestStand Hierarchy......................................................................................................................... 5
VR TestStand Tasks............................................................................................................................. 20
VR TestStand Views............................................................................................................................. 21
TestStand Sequence View................................................................................................................ 21
TestStand Sequence File View......................................................................................................... 23
TestStand Engine View..................................................................................................................... 27
List of Figures:
VR TestStand Tool
The Virtual Rack® TestStand Tool wraps the powerful sequencing capabilities
of the National Instrument’s TestStand sequencing software. TestStand is a
powerful, flexible test management software program, able to execute tests
created in a variety of test development environments. VR TestStand
converts and connects the TestStand API to the VR Matrix, making it
accessible to any VR component or client on the network. For example, the
user can configure a VR property out of bounds event to execute a TestStand
sequence, even from a remote computer.
VR TestStand Hierarchy
The National Instruments TestStand software is internally organized as a
hierarchy with a global engine per process, with as many sequence files
opened as desired, with each sequence file containing one or more
sequences. Sequences finally contain one or more steps.
VR TestStand Interfaces
The VR TestStand Tool exposes three interfaces, from each of the engine,
sequence file and sequence objects. These interfaces are fully available by
browsing the TestStand Tool in the VR Collective tree. Browsing to these
levels is not normally required by the operator because most of the TestStand
capability is also available via customized toolbars, context menus, and tools
& services entries through VR Explorer and the VR Macro Recorder.
The VR TestStand Engine Interface exposes properties and methods that are
involved with managing the set of Sequence Files loaded, and attributes of
how TestStand is to operate within the VR Process. This interface is located
under the TestStand Tool node in the VR Collective Tree:
The following table lists the capabilities of the TestStand Engine Interface:
computer.
The TestStand Sequence File Interface exposes properties and methods for
managing a single Sequence File that has been loaded into memory. Every
Sequence File loaded is added to the SequenceFiles collection of the
TestStand Tool:
If only one possible macro recorder target exists in the current process, then
this is auto-selected as the target recorder.
Begin Macro
To begin recording a Macro, the user selects the ‘Record …’ menu command
from the MORE toolbar:
If a Macro is not already active, then this will also ask the operator to either
create a new Macro, or open an existing Macro. The following dialog allows
the user to select:
After making the selection, an active recording sequence panel will popup
with the record light indicator flashing ( ) in the toolbar:
Interactive recording always records the default step of any given servlet.
Each servlet or server exposes varied additional step types as well. These
steps can be inserted by right clicking on the component, and picking from the
component’s list of available step types. These are listed under the \\Tools &
Services\TestStand context menu. This topic is covered under the VR
TestStand Context Menu section of this manual
End Macro
Users can start and stop the recording at any time by simply pressing the
record button, presses the toolbar stop button ( ) or closes the popup
sequence panel.
Edit Macro
Macros can be easily edited in place by using the Sequence View’s toolbar
and Context Menus. Editing allows you to modify the recorded steps as well
as add additional steps for control flow, logic, and branching.
The possible step modifications made through the editor are expansive and
covered in the National Instruments TestStand documentation.
Play Macro
If the Macro Sequence View is already open, then the Macro can be played
back by simply pressing the triangular play button ( ) on the Sequence View
toolbar.
Macros can also be played from the Sequence File View, the TestStand
Engine View, and as always, directly from the VR Collective Tree view.
Playing Macros from these locations is covered later in this manual.
Macro Shortcuts
It is quite often useful to create your own collection of helpful Macros for the
operations that you perform on a specific rack of equipment. As you conduct
daily operations, consider the ease of doing your operations normally once
after hitting the record button. From then on, conducting the same operations
can be done by playing the Macro. As time goes on and procedures change,
you can manually edit the Macro and/or record appended steps to the Macro.
After a while, you may have quite a few Macros recorded and would like a
way to quickly find and invoke any one of them. Collections of Macro
shortcuts are used to facilitate this capability.
Forms and/or Watches can be used as Shortcut Panels to host the array of
Macro shortcut buttons. To create a Macro Shortcuts Panel, follow these
steps:
The Form or Watch that you created will now have a button for each Macro as
a shortcut. You can add additional controls of course as well as helpful text
and graphics to the helper panel. Below are example Macro Shortcut Panels:
Selecting a VR TestStand record command will insert the step into the active
sequence.
VR TestStand Tasks
The VR TestStand Tool adds a ‘Record TestStand step’ task to all recordable
objects in the system: properties, actions, methods and collections.
VR TestStand Views
VR TestStand exposes three views: TestStand engine, TestStand sequence
file and TestStand sequence. The views are hierarchical with the TestStand
engine at the top. The engine then contains collections of sequence files, and
each sequence file then contains collections of sequences. It is easier to
cover these views from the bottom of the hierarchy and percolating up.
The sequence panel displays the TestStand steps contained within a single
sequence, as well as toolbar and menu commands for controlling the
sequence.
Execution Flow The execution behavior of the step. This can be modified
through the Menu->Run Mode menu command.
Use the toolbar and right-mouse-click context menu to control the sequence
steps.
The TestStand sequence file contains the list of sequences, and the
sequence file view reflects this in its configuration. The view toolbar has a
sequence selection combo box that sets the context on the contained
sequence view.
The VR TestStand sequence file execution toolbar is at the top of the view.
The sequence file execution toolbar play ( ) button is used to execute the
‘MainSequence’, single pass. The play button drop down menu contains
alternative execution options.
The ‘Single Pass’ command will execute the ‘MainSeq’ once. The ‘Test UUTs’
command will execute the sequence file ‘MainSequence’ in a loop.
The next section of the menu dynamically displays the sequences contained
within the current sequence file. Click a sequence name to execute a
contained sequence, single pass.
Use the toolbar stop button ( ) to terminate the active sequence file
execution.
Use the sequence selection combo box to set the context of the embedded
sequence view. The delete button ( ) will remove the selected sequence
from the sequence file. Note that ‘MainSequence’ is a required sequence and
cannot be deleted. The ‘New’ button ( ) will create a new sequence in the
sequence file. Note that sequence names must be unique.
TestStand execution reports are information rich and have a wide variety of
formatting options. Report options are configured using the ‘Report Options’
toolbar button on the VR TestStand engine toolbar – see the Engine view
section for more detail. Note that the VR TestStand sequence file report
viewer can only host HTML, and will fail to load when report are generated
with XML formatting.
The TestStand engine object contains the collection of sequence files, and
the engine view reflects this in its configuration. The VR TestStand engine
view is split into a sequence file view on the top and a sequence list on the
bottom. Select a sequence file from the list on the bottom to view it in the top
pane.
The VR TestStand engine view toolbar at the top of the bottom pane allows
the user to configure TestStand station options, as well as create\open\close
sequence files.