> ## Documentation Index
> Fetch the complete documentation index at: https://hmis-docs.derrickmugabwa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# OIE channels

> The generic radiology channels and the Orthanc demo adapter.

## Channel inventory

| Channel                        | Type                             | Role                                                              |
| ------------------------------ | -------------------------------- | ----------------------------------------------------------------- |
| HMIS Radiology Worklist Lookup | Generic with Orthanc destination | Looks up an HMIS accession and publishes a PACS worklist item     |
| PACS Study Events Relay        | Generic                          | Accepts normalized study events and calls the HMIS study API      |
| Orthanc Stable Study Poller    | Orthanc adapter                  | Converts Orthanc `StableStudy` changes to normalized study events |

The **PACS Study Events Relay** is reusable. A different PACS needs its own adapter or webhook channel, but it should emit the same normalized JSON to the relay.

## OIE Configuration Map

Open **Settings → Configuration Map** and add:

| Key                             | Example value                       | Secret |
| ------------------------------- | ----------------------------------- | ------ |
| `hmis_radiology_worklist_token` | `{{RADIOLOGY_WORKLIST_READ_TOKEN}}` | Yes    |
| `hmis_radiology_study_token`    | `{{RADIOLOGY_STUDIES_WRITE_TOKEN}}` | Yes    |
| `orthanc_base_url`              | `http://orthanc:8042`               | No     |
| `orthanc_pacs_code`             | `HMIS-PACS`                         | No     |

Build the `Bearer ` prefix inside a transformer. Do not save the prefix and token in separate OIE header table cells because the Administrator can drop trailing spaces from table values.

## Listener ports

The local Compose override publishes these listener ports only on `127.0.0.1`:

| Port   | Context path           | Purpose                      |
| ------ | ---------------------- | ---------------------------- |
| `6670` | `/radiology/worklist/` | HMIS worklist publication    |
| `6671` | `/pacs/studies/`       | Normalized PACS study events |

<Note>
  Use the trailing slash on both HTTP listener paths. It avoids redirects that can change the method or remove the request body.
</Note>

## Export rule

After a successful change, export each affected channel from OIE Administrator. Before storing the XML in documentation or source control, replace all tokens, passwords, private addresses, patient values, and production identifiers with placeholders.