User Documentation
Breadcrumbs

HIS Mock Agent

The Mock Agent is a dockerized emulation of the generic PACS with Agent, designed for platform development and debugging purposes. It enables the development of applications intended for PACS systems without requiring access to an actual system.

The Mock Agent includes a built-in database that maintains data persistence during a single execution context. It implements all API features currently available in the HIS platform.


Example: Mock agent startup

Step 1: Download

Download the pacs-agent-mock Docker image using the manual described in the SFTP section of the documentation.

Step 2: Create environment

Create a file named .env with the following content:

Agent__TenantId=example-tenant-id
Agent__PacsId=example-pacs-id
Auth__ClientId=your-client-id
Auth__ClientSecret=your-client-secret

In case you are connecting to a different environment than HID production, you need to set proper URLs:

Auth__AuthNProvider=https://auth.example.com
Agent__PlatformUrl=https://platform.example.com
  • Adjust all file parameters according to your setup.

  • It is recommended to store this configuration on an encrypted drive or delete the .env file as soon as the Docker image is executed.

Step 3: Run Docker image

docker run -d \
  --env-file .env \
  pacs-agent-mock:latest

Step 4: Check that the Docker image is running

docker ps

Please note that by default, data is persisted within the agent container and will be lost once the container is deleted.

If you wish to make data persistent, you must mount the container with a persistent local volume, as described in the Docker documentation.