# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dbi-services.gitbook.io/omrun-help/element-details/test-program-object.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.