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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://dbi-services.gitbook.io/omrun-help/version-4.x/element-overview/test-program-object.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.