> 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

### ![](https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-b1ff09efdc12bf5f66706c589ab22a99da1cb7dd%2FIcon_TOB_program.gif?alt=media)

### 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-4b8988dc6f414bdb36a2cfdfb4cb223378db543d%2FOMrunHelp_TestObjectProgr1.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-b1ff09efdc12bf5f66706c589ab22a99da1cb7dd%2FIcon_TOB_program.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-224bb5736e38cc26efce8e85879e44c8d7231af9%2FOMrunHelp_TestObjectProgr2.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-537fe55c32d0f4cf3e72350a1c4c94730066d4f4%2FOMrunHelp_TestObjectProgr3.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-f456476800b2f4cc1b53d5da94fb1eb0a77f9396%2FOMrunHelp_TestObjectProgr4.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-21ce0d524825144550a9a60f86a40719ce380c6e%2FOMrunHelp_TestObjectProgr5.gif?alt=media" 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="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-475783ed929371c5b23537550c3ccfe21c85749d%2FOMrunHelp_TestObjectProgr6.gif?alt=media" 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                                        |