> 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/configuration/customize-own-adapter/customize-program-adapter.md).

# Own program adapter

### ![](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)

You can add your own adapter or copy an existing adapter and fit it to your needs by changing the connect string.

<figure><img src="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-2b4ce98b1cd8b99942036ad0cbc2db7ce6dae712%2FOMrunHelp_OwnDataAdapter1.gif?alt=media" alt="OMrun button configuration" width="80%"><figcaption><p>OMrun button configuration</p></figcaption></figure>

1. On OMrun Ribbon choose `Config`
2. Select tab `Program adapter`

<figure><img src="https://2873353689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfK1YJaTCqOiS0L22wVKG%2Fuploads%2Fgit-blob-2b7b0e5937a3e47c3fe48774375991b0d5c45ffa%2FOMrunHelp_OwnProgrAdapter2.gif?alt=media" alt="OMrun configuration - program adapter" width="80%"><figcaption><p>OMrun configuration - program adapter</p></figcaption></figure>

***

You can add your own adapter or copy an existing adapter and fit it to your needs by changing the connect string.\
Description of the table above:

In this table interfaces to external functions are maintained. These functions can be an external GUI Test Tool or a batch-script or any (self developed) application.

What's exactly called is defined either in the connect string or in Test Program Object.

| Column         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Program        | Type of adapter defined within this line.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Provider Group | Displays all the included Data Provider. This information is predefined and can't be changed. If you need an additional GUI adapter, please get in contact.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Connect String | <p>Describes the name of the external executable and its parameters:</p><ul><li>"myTestSuite" will be replaced by the linked or copied external executable defined in <a href="/omrun-help/version-4.x/element-overview/test-program-object.md">Test Program Object</a>.</li><li>"myTestApplication" allows to transfer the control to the application defined in the test environment and calls the application defined in "myTestSuite".</li><li>"@param1-4" will be replaced by values defined in <a href="/omrun-help/version-4.x/element-overview/parameter-list.md">Parameter List</a>.</li><li>"Connection Timeout=x" sets the maximum time range in seconds which an external function is allowed to run without response.<br>External function will be killed exceeding this dead line.</li></ul> |
| Remark         | Enter your comments or parameter description here.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |