> For the complete documentation index, see [llms.txt](https://dbi-services.gitbook.io/omrun-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dbi-services.gitbook.io/omrun-help/element-details/test-program-object.md).

# Test Program Object

### ![](/files/ZmGkX6hu7XyzkY2aPSnI)

[![OMrun Test Object Program Tutorial – Mastering Test Execution with Ease](https://img.youtube.com/vi/vNN5rS4s370/maxresdefault.jpg)](https://youtu.be/vNN5rS4s370)

### Abstract

Test **Object Type "Program"** executes any type of program, batch, built-in program or GUI test recorded by a GUI Test Tool like Ranorex®. With this test object the engineer usually develops the pre- and post-condition tests for a data comparison.\
The integrated **console** does show the communication between the plug-in or the externally invoked program. The results are shown as passed/failed to indicate whether or not the execution was successful.\
The **parameters** from the environment definition and from the **parameter list** are used to transfer data/information to the internal and external programs.

<figure><img src="/files/wbOwSgLuqXekdU8bwtjW" alt="OMrun test program object screen" width="80%"><figcaption><p>OMrun test program object screen</p></figcaption></figure>

***

### New

On Navigation Tree at Test Component level click on the right mouse button and select <img src="/files/ZmGkX6hu7XyzkY2aPSnI" alt="OMrun Program Object Icon" data-size="line"> `New`.

A new empty test object is created within the same component. After entering a new name you can begin with selecting a [#program-call](#program-call "mention") element and add the necessary parameters.

<figure><img src="/files/u5gt9VhFqxXYFwDEv0XL" alt="OMrun component - dropdown menue" width="50%"><figcaption><p>OMrun component - dropdown menue</p></figcaption></figure>

***

### Copy, Rename, Delete

On Navigation Tree at Test Object level click on the right mouse button and select <img src="/files/ZmGkX6hu7XyzkY2aPSnI" alt="OMrun Program Object Icon" data-size="line"> `Copy`, <img src="/files/ZmGkX6hu7XyzkY2aPSnI" alt="OMrun Program Object Icon" data-size="line"> `Rename` or <img src="/files/ZmGkX6hu7XyzkY2aPSnI" alt="OMrun Program Object Icon" data-size="line"> `Delete`.

<figure><img src="/files/712tJte8CtqM9uQQXK9j" alt="OMrun test program object - dropdown menue" width="50%"><figcaption><p>OMrun test program object - dropdown menue</p></figcaption></figure>

***

### Drag & Drop

On Navigation Tree you can move or copy a test object from one container (Component) to another by simply drag & drop the element.

| Action                                              | Outcome                                                              |
| --------------------------------------------------- | -------------------------------------------------------------------- |
| "left mouse button down" and drag object            | **Move** Test Object to another Component (stop over component name) |
| "left mouse button down" **+ Ctrl** and drag object | **Copy** Test Object to another Component (stop over component name) |

<figure><img src="/files/bctvKRiK1ZKKkRkhErif" alt="OMrun test program object - drag &#x26; drop" width="50%"><figcaption><p>OMrun test program object - drag &#x26; drop</p></figcaption></figure>

***

### Program Call

<figure><img src="/files/g3g2I1spBx1Ds7KcCd14" alt="OMrun test program object - program call" width="60%"><figcaption><p>OMrun test program object - program call</p></figcaption></figure>

Selection of pre-defined program calls.

The dropdown list contains of built-in tests as well as pre-configured program or batch call objects.

<figure><img src="/files/l8X4QWXDh37ynjXdat0L" alt="OMrun test program object - program call drop down menue" width="50%"><figcaption><p>OMrun test program object - program call drop down menue</p></figcaption></figure>

***

| Call         | Remark                                                                                          |
| ------------ | ----------------------------------------------------------------------------------------------- |
| Batch        | Starting a batch job while transfering the paramerters in double quotes "" separated by space.  |
| Batch native | Starting a batch job while transfering the paramerters as plain text separated by space.        |
| Program      | Starting a program and transfering the paramerters as arguments separated by space.             |
| PlugIn's     | Several internal OMrun adapters to convert csv, xml, fix length records, mdx and run time list. |
| GUI tools    | Settings for standard GUI tests like Ranorex or QF-Test                                         |

***

### Parameter String Previewer

There is a tooltip when hover over label `Program Call`.

The tooltip is activated after 1 second keeping the mouse cursor over the label. After this delay the tooltip shows a preview of all 4 parameter strings for about 10 seconds.

* Showing the preview of the parameter strings from parameter list with extracted (replaced) variables.
* Copies all the parameter strings to the clipboard automatically.

<figure><img src="/files/vy1GYkwkK8EbtRxAPlWu" alt="OMrun test object program - parameter tooltip" width="50%"><figcaption><p>OMrun test object program - parameter tooltip</p></figcaption></figure>