# Test Program Object

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

[![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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-60a2aa77a3952df1b5c5c72929479cc72fa73ae6%2FOMrunHelp_TestObjectProgr1.png?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://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%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://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-859729607e0805b8b524d6309fba5296cbb57de6%2FOMrunHelp_TestObjectProgr2.png?alt=media" 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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-b1ff09efdc12bf5f66706c589ab22a99da1cb7dd%2FIcon_TOB_program.gif?alt=media" alt="OMrun Program Object Icon" data-size="line"> `Copy`, <img src="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-b1ff09efdc12bf5f66706c589ab22a99da1cb7dd%2FIcon_TOB_program.gif?alt=media" alt="OMrun Program Object Icon" data-size="line"> `Rename` or <img src="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-b1ff09efdc12bf5f66706c589ab22a99da1cb7dd%2FIcon_TOB_program.gif?alt=media" alt="OMrun Program Object Icon" data-size="line"> `Delete`.

<figure><img src="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-4e50382ab742317f113b979a4533b2d93572ee08%2FOMrunHelp_TestObjectProgr3.png?alt=media" 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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-fb389a2d9c1a734486c83252ee7e77ab09c3527a%2FOMrunHelp_TestObjectProgr4.png?alt=media" 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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-aeb330edcb3c468e5fc5f5438e16943c2def7b34%2FOMrunHelp_TestObjectProgr5.png?alt=media" 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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-295deff43e971280d6d3f4bf8431a35384fd8d08%2FOMrunHelp_TestObjectProgr6.png?alt=media" 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="https://1143774439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1ooXfQ2qWGFRh6lihybt%2Fuploads%2Fgit-blob-3e4dc35c85042e3e9a5ca16c84a6f48ae00244de%2FOMrunHelp_TestObjectProgr7.png?alt=media" alt="OMrun test object program - parameter tooltip" width="50%"><figcaption><p>OMrun test object program - parameter tooltip</p></figcaption></figure>