> 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/version-4.x/element-overview/test-program-object.md).

# Test Program Object

### ![](/files/4Gtd6nx0rI4EOuoZtSso)

### Abstract

Test Object Type "Prog" 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/kv1siuHNOwlUfDA5Dm4h" 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/4Gtd6nx0rI4EOuoZtSso" 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/Tls3YkTamVgzDBG8Y67h" alt="OMrun component - dropdown menue"><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 `Copy`, `Rename` or `Delete`.

<figure><img src="/files/xR2WxfEMRNJAG8MIIxM6" alt="OMrun test program object - dropdown menue"><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 an pressing the relevant keys.

* Ctrl + "left mouse button down" = Copy Test Object to another Component
* Shift+ "left mouse button down" = Move Test Object to another Component

<figure><img src="/files/0rViV86S2YYrH7CHzH4X" alt="OMrun test program object - drag &#x26; drop"><figcaption><p>OMrun test program object - drag &#x26; drop</p></figcaption></figure>

***

### Program Call

<figure><img src="/files/XEitGb8N24pXRy9fpPB7" alt="OMrun test program object - program call"><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/00IQNVACsGdFSgr5P4T2" alt="OMrun test program object - program call drop down menue"><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 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                                        |