# HL7v2 Test Cases Instructions

{% file src="<https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FR8ylXml25OrMymR3BMHi%2Fhl7Tests.mp4?alt=media&token=efe0f058-2f7c-4294-8ab4-852f0047916d>" %}

## Pull santempi:

Pull santempi repository from github : <https://github.com/santedb/santempi.git>

## Install docker containers:

Having docker installed, run the following command inside santempi/instant directory where the docker-compose.yml file exists to spin up docker containers.

```
 docker compose -f docker-compose.yml up
```

{% hint style="info" %}
It also can be done by running the "docker-compose.ui.yml" file but the ui component is not necessary here
{% endhint %}

## Get sdbac(santedb admin console) from latest release

Get the latest sdbac release from github: <https://github.com/santedb/santedb-server/releases>

Download the sdbac.zip and extract the files.&#x20;

## Configure santempi instances for pre-conditions setup

1-Run the following commands inside sdbac directory where the sdbac.exe is located or run the sdbac.exe directly.

{% hint style="info" %}
The command prompt should be run in administrative mode
{% endhint %}

```
sdbac
```

2-Insert the credentials for Username and Password.

3-Wait for the system to get ready

![](https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F9Wh8kptDI2JWfKTYWqLa%2Fsdbac.jpg?alt=media\&token=abac4022-73e4-4c39-bb4d-5689d123775a)

4-Run the following commands:

**To create TEST\_HARNESS application run:**

```
application.add TEST_HARNESS -s TEST_HARNESS
```

**To create TEST\_HARNESS|TEST device run:**

```
device.add TEST_HARNESS|TEST -s TEST_HARNESS
```

**To create TEST identity domain and set the assigned authority to TEST\_HARNESS run:**

```
aa.add -n TEST -o 2.16.840.1.113883.3.72.5.9.1 -u http://ohie.org/test/test -d 'OpenHIE Test Domain' -a TEST_HARNESS
```

![](https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FFhrGG7rppBtBvva0QLdq%2Fsdbac.jpg?alt=media\&token=80ee052a-fbf8-4388-b453-0cad61981044)

## Pull hl7-testing-tool:

Pull hl7-testing-tool from github: <https://github.com/santedb/hl7-testing-tool.git>

## Run hl7-testing-tool:

Run hl7-testing-tool solution with visual studio.

They can be run as an entire test suite or an individual test case or test step.

For a test step to pass all  mandatory assertions and at least one of alternate assertions for the same terserstring must pass.

{% hint style="info" %}
For more information about how the tool works please visit The README section in hl7-testing-tool repository at github: <https://github.com/santedb/hl7-testing-tool/blob/main/README.md>
{% endhint %}