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


---

# 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/version-4.x/element-overview/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.